FreeBSD Manual Pages
BTRACEBACK(8) Backup Archiving REcovery Open Sourced BTRACEBACK(8) NAME btraceback - wrapper script around gdb and bsmtp SYNOPSIS btraceback /path/to/binary pid DESCRIPTION btraceback is a wrapper shell script around the gdb debugger (or dbx on So- laris systems) and bsmtp, provided for debugging purposes. USAGE btraceback is called by the exception handlers of the Bareos daemons during a crash. It can also be called interactively to view the current state of the threads belonging to a process, but this is not recommended unless you are trying to debug a problem (see below). NOTES In order to work properly, debugging symbols must be available to the de- bugger on the system, and gdb, or dbx (on Solaris systems) must be avail- able in the $PATH. If the Director or Storage daemon runs under a non-root uid, you will prob- ably need to be modify the btraceback script to elevate privileges for the call to gdb/dbx, to ensure it has the proper permissions to debug when called by the daemon. Although Bareos's use of btraceback within its exception handlers is always safe, manual or interactive use of btraceback is subject to the same risks than live debugging of any program, which means it could cause Bareos to crash under rare and abnormal circumstances. Consequently we do not recom- mend manual use of btraceback in production environments unless it is re- quired for debugging a problem. ENVIRONMENT btracback relies on $PATH to find the debugger. FILES /usr/lib/bareos/btraceback The script itself. /usr/sbin/btraceback symbolic link to /usr/lib/bareos/btraceback /etc/bareos/scripts/btraceback.gdb the GDB command batch used to output a stack trace AUTHOR This manual page was written by Lucas B. Cohen <lbc@members.fsf.org> SEE ALSO bsmtp(1) Kern Sibbald 6 December 2009 BTRACEBACK(8)
NAME | SYNOPSIS | DESCRIPTION | USAGE | NOTES | ENVIRONMENT | FILES | AUTHOR | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=btraceback&sektion=8&manpath=FreeBSD+Ports+15.1.quarterly>