Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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
       Solaris 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 cur-
       rent state of the threads belonging to a	process, but this is not  rec-
       ommended	unless you are trying to debug a problem (see below).

NOTES
       In  order  to work properly, debugging symbols must be available	to the
       debugger	on the system, and gdb,	or dbx (on Solaris  systems)  must  be
       available in the	$PATH.

       If  the	Director or Storage daemon runs	under a	non-root uid, you will
       probably	need to	be modify the btraceback script	to elevate  privileges
       for the call to gdb/dbx,	to ensure it has the proper permissions	to de-
       bug 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.	Conse-
       quently we do not recommend manual use of btraceback in production  en-
       vironments unless it is required	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://www.freebsd.org/cgi/man.cgi?query=btraceback&sektion=8&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help