NAME

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

SYNOPSIS

       find-dbgsym-packages [--install] [--ssh] [--deb] [--all] executable, core file or PID
       [executable, library, core file or PID X]

DESCRIPTION

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

PREREQUISITES

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

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

       Don't forget to run "apt update" as root after adding such a line.

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

OPTIONS

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

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

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

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

           This requires the package "equivs" to be installed.

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

       "--all"
           Show or include all relevant debug symbol packages, not just those still missing.

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

AUTHOR

       Stefan Fritch <sf@debian.org>

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

COPYRIGHT AND LICENCE

       Copyright (C) 2017 Stefan Fritch <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
       /usr/share/common-licenses/GPL-2.

SEE ALSO

       <https://wiki.debian.org/AutomaticDebugPackages>, debuginfod(8), debuginfod-find(1)