Codebase list debian-goodies / da9fc16
Add a man page for find-dbgsym-packages in POD format Gbp-Dch: Ignore Axel Beckert 6 years ago
4 changed file(s) with 62 addition(s) and 1 deletion(s). Raw diff Collapse all Expand all
00 check-enhancements.1
1 find-dbgsym-packages.1
8181
8282 Files: find-dbgsym-packages
8383 Copyright: 2017 Stefan Fritsch <sf@debian.org>
84 License: GPL-2+
85
86 Files: find-dbgsym-packages.pod
87 Copyright: 2017 Axel Beckert <abe@debian.org>
8488 License: GPL-2+
8589
8690 License: GPL
22 # Uncomment this to turn on verbose mode.
33 #export DH_VERBOSE=1
44
5 PODDOC=debget dglob dgrep dpigs
5 PODDOC=debget dglob dgrep dpigs find-dbgsym-packages
66
77 %:
88 dh $@
0 =encoding UTF-8
1
2 =head1 NAME
3
4 find-dbgsym-packages - gets list of dbgsym packages from core dump or PID
5
6 =head1 SYNOPSIS
7
8 B<find-dbgsym-packages> I<core file or PID> [I<core file or PID> …]
9
10 =head1 DESCRIPTION
11
12 B<find-dbgsym-packages> lists all I<*-dbgsym> packages required to
13 properly debug processes given by a list of core dump or PID numbers.
14
15 =head1 PREREQUISITES
16
17 You must already have the correct debug lines in your
18 I</etc/apt/sources.list> file, e.g.
19
20 deb http://debug.mirrors.debian.org/debian-debug/ unstable-debug main
21
22 Don't forget to run C<apt-get update> as root after adding such a
23 line.
24
25 Additionally, B<find-dbgsym-packages> requires the I<elfutils> and
26 I<dctrl-tools> packages to be installed.
27
28 =head1 EXAMPLES
29
30 $ find-dbgsym-packages 15865
31 libcap2-dbgsym libtinfo5-dbg zsh-dbgsym
32 $ find-dbgsym-packages /var/crash/1000/15865-1000-1000-11-1511059476-c6--bin-zsh.core
33 libcap2-dbgsym libtinfo5-dbg zsh-dbgsym
34
35 =head1 AUTHOR
36
37 Stefan Fritch <L<sf@debian.org>>
38
39 This manpage was written by Axel Beckert <L<abe@debian.org>>.
40
41 =head1 COPYRIGHT AND LICENCE
42
43 Copyright (C) 2017 Stefan Fritch <L<sf@debian.org>>
44
45 This program is free software; you can redistribute it and/or modify
46 it under the terms of the GNU General Public License as published by
47 the Free Software Foundation; either version 2, or (at your option)
48 any later version.
49
50 On Debian systems, a copy of the GNU General Public License version 2
51 can be found in F</usr/share/common-licenses/GPL-2>.
52
53 =head1 SEE ALSO
54
55 L<https://wiki.debian.org/AutomaticDebugPackages>