NAME

       dh_dwz - optimize DWARF debug information in ELF binaries via dwz

SYNOPSIS

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

DESCRIPTION

       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

       --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).

NOTES

       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

       debhelper(7)

       This program is a part of debhelper.

AUTHOR

       Niels Thykier <niels@thykier.net>

13.14.1ubuntu5                                     2024-03-01                                          DH_DWZ(1)