find-debuginfo

FIND-DEBUGINFO(1)                User Commands               FIND-DEBUGINFO(1)

NAME
       find-debuginfo - finds debuginfo and processes it

SYNOPSIS
       find-debuginfo [OPTION]... [builddir]

DESCRIPTION
       automagically generates debug info and file lists

OPTIONS
       [--strict-build-id]  [-g]  [-r] [-m] [-i] [-n] [--keep-section SECTION]
       [--remove-section SECTION] [--g-libs] [-j  N]  [--jobs  N]  [-o  debug-
       files.list]        [-S        debugsourcefiles.list]        [--run-dwz]
       [--dwz-low-mem-die-limit   N]   [--dwz-max-die-limit   N]   [--dwz-sin-
       gle-file-mode]  [--build-id-seed  SEED]  [--unique-debug-suffix SUFFIX]
       [--unique-debug-src-base BASE] [[-l filelist]... [-p 'pattern'] -o  de-
       buginfo.list] [builddir]

       The -g flag says to use strip -g instead of full strip on DSOs or EXEs.
       The --g-libs flag says to use strip -g instead of full  strip  ONLY  on
       DSOs.  Options -g and --g-libs are mutually exclusive.

       The -r flag says to use eu-strip --reloc-debug-sections.

       Use  --keep-section  SECTION  or --remove-section SECTION to explicitly
       keep a (non-allocated) section in the main executable or explicitly re-
       move  it into the .debug file. SECTION is an extended wildcard pattern.
       Both options can be given more than once.

       The --strict-build-id flag says to exit with failure status if any  ELF
       binary processed fails to contain a build-id note.

       The  -m  flag  says to include a .gnu_debugdata section in the main bi-
       nary.

       The -i flag says to include a .gdb_index section in the .debug file.

       The -n flag says to not recompute the build-id.

       The -j, --jobs N option will spawn N processes to do the debuginfo  ex-
       traction in parallel.

       A single -o switch before any -l or -p switches simply renames the pri-
       mary output file from debugfiles.list to something else.  A  -o  switch
       that  follows  a  -p  switch or some -l switches produces an additional
       output file with the debuginfo for the files in the -l  filelist  file,
       or  whose  names  match  the -p pattern.  The -p argument is an grep -E
       -style regexp matching the a file name, and must not use anchors (^  or
       $).

       The  --run-dwz  flag instructs find-debuginfo to run the dwz utility if
       available, and --dwz-low-mem-die-limit and --dwz-max-die-limit  provide
       detailed  limits.   See  dwz(1)  -l  and  -L  option  for details.  Use
       --dwz-single-file-mode to disable multi-file mode, see  dwz(1)  -m  for
       more details.

       If --build-id-seed SEED is given then debugedit is called to update the
       build-ids it finds adding the SEED as seed to recalculate the  build-id
       hash.   This  makes  sure the build-ids in the ELF files are unique be-
       tween versions and releases of the same package.  (Use  --build-id-seed
       "%{VERSION}-%{RELEASE}".)

       If  --unique-debug-suffix  SUFFIX is given then the debug files created
       for <FILE> will be named <FILE>-<SUFFIX>.debug.  This makes sure .debug
       are  unique  between  package  version, release and architecture.  (Use
       --unique-debug-suffix "-%{VERSION}-%{RELEASE}.%{_arch}".)

       If --unique-debug-src-base BASE is given then the source directory will
       be called /usr/debug/src/<BASE>.  This makes sure the debug source dirs
       are unique  between  package  version,  release  and  achitecture  (Use
       --unique-debug-src-base "%{name}-%{VERSION}-%{RELEASE}.%{_arch}")

       All file names in switches are relative to builddir ('.' if not given).

find-debuginfo 5.0                March 2022                 FIND-DEBUGINFO(1)