File: find-dbgsym-packages.pod

package info (click to toggle)
debian-goodies 0.84
  • links: PTS, VCS
  • area: main
  • in suites: bullseye, buster, sid
  • size: 376 kB
  • sloc: sh: 875; python: 769; perl: 565; makefile: 14
file content (60 lines) | stat: -rw-r--r-- 1,834 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
=encoding UTF-8

=head1 NAME

find-dbgsym-packages - gets list of dbgsym packages from executable, library, core dump or process

=head1 SYNOPSIS

B<find-dbgsym-packages> I<executable, core file or PID> [I<executable, library, core file or PID> …]

=head1 DESCRIPTION

B<find-dbgsym-packages> lists all I<*-dbgsym> packages required to
properly debug processes given by a list of executables, libraries, core dumps or PID numbers.

=head1 PREREQUISITES

You must already have the correct debug lines in your
I</etc/apt/sources.list> file, e.g.

    deb http://debug.mirrors.debian.org/debian-debug/ unstable-debug main

Don't forget to run C<apt-get update> as root after adding such a
line.

Additionally, B<find-dbgsym-packages> requires the I<elfutils> and
I<dctrl-tools> packages to be installed.

=head1 EXAMPLES

    $ find-dbgsym-packages 15865
    libcap2-dbgsym libtinfo5-dbg zsh-dbgsym
    $ find-dbgsym-packages /var/crash/1000/15865-1000-1000-11-1511059476-c6--bin-zsh.core
    libcap2-dbgsym libtinfo5-dbg zsh-dbgsym
    $ find-dbgsym-packages /bin/ls
    coreutils-dbgsym libpcre3-dbg libselinux1-dbgsym
    $ find-dbgsym-packages /lib/x86_64-linux-gnu/libselinux.so.1
    libpcre3-dbg libselinux1-dbgsym

=head1 AUTHOR

Stefan Fritch <L<sf@debian.org>>

This manpage was written by Axel Beckert <L<abe@debian.org>>.

=head1 COPYRIGHT AND LICENCE

Copyright (C) 2017 Stefan Fritch <L<sf@debian.org>>

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2, or (at your option)
any later version.

On Debian systems, a copy of the GNU General Public License version 2
can be found in F</usr/share/common-licenses/GPL-2>.

=head1 SEE ALSO

L<https://wiki.debian.org/AutomaticDebugPackages>