GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  BTRACEBACK (8)

NAME

btraceback - wrapper script around gdb and bsmtp

CONTENTS

Synopsis
Description
Usage
Notes
Environment
Files
Author
See Also

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 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 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 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 recommend manual use of btraceback in production environments 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)
Search for    or go to Top of page |  Section 8 |  Main Index


Kern Sibbald BTRACEBACK (8) 6 December 2009

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.