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 …]

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)

perl v5.40.0                                       2024-12-12                            FIND-DBGSYM-PACKAGES(1)