|
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | NOTES | SEE ALSO | AUTHOR | COLOPHON |
DH_DWZ(1) Debhelper DH_DWZ(1)
dh_dwz - optimize DWARF debug information in ELF binaries via dwz
dh_dwz [debhelper options] [-Xitem] [-- params]
dh_dwz is a debhelper program that will optimize the (uncompressed)
size of the DWARF debug information in ELF binaries. It does so by
running dwz(1) on all the ELF binaries in the package.
--dwz-multifile, --no-dwz-multifile
Whether dwz(1) should generate a multifile from the ELF binaries
in the same package. When enabled, if a package ships at least 2
ELF binaries, dh_dwz will instruct dwz(1) to generate a multifile
for the package.
By default, dh_dwz will attempt to create a multifile but will
continue without if dwz(1) does not create one (but succeeds
anyway). This commonly happens when the debug files do not
contain debug symbols (e.g. a missing -g to the compiler) or when
the debug symbols are compressed (see Debian bug #931891). If
--dwz-multifile is passed, then dh_dwz will abort with an error
if dwz(1) does not create a multifile.
Note this options may not work if a package contains more ELF
binaries than can fit on a single command line. If this becomes
a problem, please pass --no-dwz-multifile to work around the
issue.
The generated multifile will be compressed with objcopy
--compress-debug-sections.
Note for udeb packages: dh_dwz will never generate multifiles for
udeb packages. It will still use dwz to reduce the file size of
debug files if it finds any.
-Xitem, --exclude=item
Exclude files that contain item anywhere in their filename from
being stripped. You may use this option multiple times to build
up a list of things to exclude.
-- params
Pass params to dwz(1) when it processes ELF binaries. This is
mostly useful for setting memory related parameters (e.g. -l and
-L).
If the DEB_BUILD_OPTIONS environment variable contains nostrip,
nothing will be stripped, in accordance with Debian policy (section
10.1 "Binaries").
While this tool technically does not remove debug information from
binaries, it is still skipped when the DEB_BUILD_OPTIONS environment
variable contains nostrip. This is because nostrip is often used to
optimize build times (e.g. for "build and test"-cycles) rather than
optimizing for size.
debhelper(7)
This program is a part of debhelper.
Niels Thykier <niels@thykier.net>
This page is part of the debhelper (helper programs for debian/rules)
project. Information about the project can be found at [unknown --
if you know, please contact man-pages@man7.org] If you have a bug
report for this manual page, send it to submit@bugs.debian.org. This
page was obtained from the project's upstream Git repository
⟨https://salsa.debian.org/debian/debhelper.git⟩ on 2020-08-13. (At
that time, the date of the most recent commit that was found in the
repository was 2020-07-26.) If you discover any rendering problems
in this HTML version of the page, or you believe there is a better or
more up-to-date source for the page, or you have corrections or
improvements to the information in this COLOPHON (which is not part
of the original manual page), send a mail to man-pages@man7.org
13.0.1 2020-05-16 DH_DWZ(1)
Pages that refer to this page: debhelper(7)