Codebase list debian-goodies / 19527236-208a-452f-b6b7-2f2c2bf2d961/main find-dbgsym-packages.pod

Tree @19527236-208a-452f-b6b7-2f2c2bf2d961/main (Download .tar.gz)

find-dbgsym-packages.pod @19527236-208a-452f-b6b7-2f2c2bf2d961/mainraw · history · blame

=encoding UTF-8

=head1 NAME

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


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


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.


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

    deb unstable-debug main

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

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

=head1 OPTIONS

=over 4

=item C<--install>

Don't display the list of required dbgsym packages but directly use
L<apt(1)> to install them. (Shows the apt command being executed,
though.) If not being run as root and L<sudo(1)> is installed, call
C<sudo apt install ...>, else use C<su - -c 'apt install ...'>.

=item C<--ssh>

Use C<ssh root@localhost -t> instead of C<sudo> or C<su - -c>. to gain
administrative privileges.

This requires the package C<openssh-client> and an SSH daemon
(e.g. C<openssh-server>) to be installed (and running).

=item C<--deb>

Generate a metapackage which depends on all the still needed debug symbol packages.

This requires the package C<equivs> to be installed.

If C<--install> is also given, automatically install the package and
all its (missing) dependencies.

=item C<--all>

Show or include I<all> relevant debug symbol packages, not just those
still missing.



    $ 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/
    libpcre3-dbg libselinux1-dbgsym

=head1 AUTHOR

Stefan Fritch <L<>>

This manpage was written by Axel Beckert <L<>>.


Copyright (C) 2017 Stefan Fritch <L<>>

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