OS Manuals

/usr/bin/eu-unstrip

Utilities and DSOs to handle ELF files and DWARF data

From elfutils 0.197-r0 (os), captured 2026-11-05 by running eu-unstrip --help (exit 0). permalink

Usage: eu-unstrip [OPTION...] STRIPPED-FILE DEBUG-FILE
  or:  eu-unstrip [OPTION...] [MODULE...]
Combine stripped files with separate symbols and debug information.

The first form puts the result in DEBUG-FILE if -o was not given.

MODULE arguments give file name patterns matching modules to process.
With -f these match the file name of the main (stripped) file (slashes are
never special), otherwise they match the simple module names.  With no
arguments, process all modules found.

Multiple modules are written to files under OUTPUT-DIRECTORY, creating
subdirectories as needed.  With -m these files have simple module names,
otherwise they have the name of the main file complete with directory
underneath OUTPUT-DIRECTORY.

With -n no files are written, but one line to standard output for each module:
	START+SIZE BUILDID FILE DEBUGFILE MODULENAME
START and SIZE are hexadecimal giving the address bounds of the module.
BUILDID is hexadecimal for the build ID bits, or - if no ID is known; the
hexadecimal may be followed by @0xADDR giving the address where the ID resides
if that is known.  FILE is the file name found for the module, or - if none was
found, or . if an ELF image is available but not from any named file.
DEBUGFILE is the separate debuginfo file name, or - if no debuginfo was found,
or . if FILE contains the debug information.

 Input selection options:
      --core=COREFILE        Find addresses from signatures found in COREFILE
      --debuginfo-path=PATH  Search path for separate debuginfo files
  -e, --executable=FILE      Find addresses in FILE
  -k, --kernel               Find addresses in the running kernel
  -K, --offline-kernel[=RELEASE]   Kernel with all modules
  -M, --linux-process-map=FILE   Find addresses in files mapped as read from
                             FILE in Linux /proc/PID/maps format
  -p, --pid=PID              Find addresses in files mapped into process PID

  -f, --match-file-names     Match MODULE against file names, not module names
  -i, --ignore-missing       Silently skip unfindable files

 Output options:
  -a, --all                  Create output for modules that have no separate
                             debug information
  -d, --output-directory=DIRECTORY
                             Create multiple output files under DIRECTORY
  -F, --force                Force combining files even if some ELF headers
                             don't seem to match
  -m, --module-names         Use module rather than file names
  -n, --list-only            Only list module and file names, build IDs
  -o, --output=FILE          Place output into FILE
  -R, --relocate             Apply relocations to section contents in ET_REL
                             files

  -?, --help                 Give this help list
      --usage                Give a short usage message
  -V, --version              Print program version

Mandatory or optional arguments to long options are also mandatory or optional
for any corresponding short options.

Report bugs to https://sourceware.org/bugzilla.
Options (19)
OptionDescriptionSource
--core COREFILEFind addresses from signatures found in COREFILEhelp
--debuginfo-path PATHSearch path for separate debuginfo fileshelp
-e, --executable FILEFind addresses in FILEhelp
-k, --kernelFind addresses in the running kernelhelp
-K, --offline-kernel RELEASEKernel with all moduleshelp
-M, --linux-process-map FILEFind addresses in files mapped as read from FILE in Linux /proc/PID/maps formathelp
-p, --pid PIDFind addresses in files mapped into process PIDhelp
-f, --match-file-namesMatch MODULE against file names, not module nameshelp
-i, --ignore-missingSilently skip unfindable fileshelp
-a, --allCreate output for modules that have no separate debug informationhelp
-d, --output-directory DIRECTORYCreate multiple output files under DIRECTORYhelp
-F, --forceForce combining files even if some ELF headers don't seem to matchhelp
-m, --module-namesUse module rather than file nameshelp
-n, --list-onlyOnly list module and file names, build IDshelp
-o, --output FILEPlace output into FILEhelp
-R, --relocateApply relocations to section contents in ET_REL fileshelp
-?, --helpGive this help listhelp
--usageGive a short usage messagehelp
-V, --versionPrint program versionhelp

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.