1DH_DWZ(1) Debhelper DH_DWZ(1)
2
3
4
6 dh_dwz - optimize DWARF debug information in ELF binaries via dwz
7
9 dh_dwz [debhelper options] [-Xitem] [-- params]
10
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
17 --dwz-multifile, --no-dwz-multifile
18 Whether dwz(1) should generate a multifile from the ELF binaries in
19 the same package. When enabled, if a package ships at least 2 ELF
20 binaries, dh_dwz will instruct dwz(1) to generate a multifile for
21 the package.
22
23 By default, dh_dwz will attempt to create a multifile but will
24 continue without if dwz(1) does create one (but succeeds anyway).
25 This commonly happens when the debug files do not contain debug
26 symbols (e.g. a missing -g to the compiler) or when the debug
27 symbols are compressed (see Debian bug #931891). If
28 --dwz-multifile is passed, then dh_dwz will abort with an error if
29 dwz(1) does not create a multifile.
30
31 Note this options may not work if a package contains more ELF
32 binaries than can fit on a single command line. If this becomes a
33 problem, please pass --no-dwz-multifile to work around the issue.
34
35 The generated multifile will be compressed with objcopy
36 --compress-debug-sections.
37
38 Note for udeb packages: dh_dwz will never generate multifiles for
39 udeb packages. It will still use dwz to reduce the file size of
40 debug files if it finds any.
41
42 -Xitem, --exclude=item
43 Exclude files that contain item anywhere in their filename from
44 being stripped. You may use this option multiple times to build up
45 a list of things to exclude.
46
47 -- params
48 Pass params to dwz(1) when it processes ELF binaries. This is
49 mostly useful for setting memory related parameters (e.g. -l and
50 -L).
51
53 If the DEB_BUILD_OPTIONS environment variable contains nostrip, nothing
54 will be stripped, in accordance with Debian policy (section 10.1
55 "Binaries").
56
57 While this tool technically does not remove debug information from
58 binaries, it is still skipped when the DEB_BUILD_OPTIONS environment
59 variable contains nostrip. This is because nostrip is often used to
60 optimize build times (e.g. for "build and test"-cycles) rather than
61 optimizing for size.
62
64 debhelper(7)
65
66 This program is a part of debhelper.
67
69 Niels Thykier <niels@thykier.net>
70
71
72
7312.6.1 2019-10-08 DH_DWZ(1)