DH_DWZ(1)                         Debhelper                        DH_DWZ(1)

NAME         top

       dh_dwz - optimize DWARF debug information in ELF binaries via dwz

SYNOPSIS         top

       dh_dwz [debhelper options] [-Xitem] [-- params]

DESCRIPTION         top

       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.

OPTIONS         top

       --dwz-multifile, --no-dwz-multifile
           Whether dwz(1) should generate a multifile from the ELF binaries
           in the same package (it does by default).  When enabled, if a
           package ships at least 2 ELF binaries, dh_dwz will instruct
           dwz(1) to generate a multifile for the package.

           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

           The generated multifile will be compressed with objcopy

       -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

NOTES         top

       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.

SEE ALSO         top


       This program is a part of debhelper.

AUTHOR         top

       Niels Thykier <>

COLOPHON         top

       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] If you have a bug
       report for this manual page, send it to  This
       page was obtained from the project's upstream Git repository
       ⟨⟩ on 2018-10-29.  (At
       that time, the date of the most recent commit that was found in the
       repository was 2018-10-28.)  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

11.5                             2018-10-28                        DH_DWZ(1)