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)