1DH_DWZ(1)                          Debhelper                         DH_DWZ(1)
2
3
4

NAME

6       dh_dwz - optimize DWARF debug information in ELF binaries via dwz
7

SYNOPSIS

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

DESCRIPTION

12       dh_dwz is a debhelper program that will optimize the (uncompressed)
13       size of the DWARF debug information in ELF binaries.  It does so by
14       running dwz(1) on all the ELF binaries in the package.
15

OPTIONS

17       --dwz-multifile, --no-dwz-multifile
18           Whether dwz(1) should generate a multifile from the ELF binaries in
19           the same package (it does by default).  When enabled, if a package
20           ships at least 2 ELF binaries, dh_dwz will instruct dwz(1) to
21           generate a multifile for the package.
22
23           Note this options may not work if a package contains more ELF
24           binaries than can fit on a single command line.  If this becomes a
25           problem, please pass --no-dwz-multifile to work around the issue.
26
27           The generated multifile will be compressed with objcopy
28           --compress-debug-sections.
29
30       -Xitem, --exclude=item
31           Exclude files that contain item anywhere in their filename from
32           being stripped. You may use this option multiple times to build up
33           a list of things to exclude.
34
35       -- params
36           Pass params to dwz(1) when it processes ELF binaries.  This is
37           mostly useful for setting memory related parameters (e.g. -l and
38           -L).
39

NOTES

41       If the DEB_BUILD_OPTIONS environment variable contains nostrip, nothing
42       will be stripped, in accordance with Debian policy (section 10.1
43       "Binaries").
44
45       While this tool technically does not remove debug information from
46       binaries, it is still skipped when the DEB_BUILD_OPTIONS environment
47       variable contains nostrip.  This is because nostrip is often used to
48       optimize build times (e.g. for "build and test"-cycles) rather than
49       optimizing for size.
50

SEE ALSO

52       debhelper(7)
53
54       This program is a part of debhelper.
55

AUTHOR

57       Niels Thykier <niels@thykier.net>
58
59
60
6111.4                              2018-09-02                         DH_DWZ(1)
Impressum