diff options
author | John Terpstra <jht@samba.org> | 2005-06-28 01:50:18 +0000 |
---|---|---|
committer | John Terpstra <jht@samba.org> | 2005-06-28 01:50:18 +0000 |
commit | 5d281f5f235516b67ffc998ac430c163aba8769f (patch) | |
tree | b487624f91931f74761fe4733bf18571bf4e36bf | |
parent | 0f39edfd03f0ab45f791703a9743131711e98260 (diff) | |
download | samba-5d281f5f235516b67ffc998ac430c163aba8769f.tar.gz samba-5d281f5f235516b67ffc998ac430c163aba8769f.tar.xz samba-5d281f5f235516b67ffc998ac430c163aba8769f.zip |
r7976: Adding debugging info.
-rw-r--r-- | examples/debugging/README | 28 | ||||
-rw-r--r-- | examples/debugging/solaris-oops.sh | 52 |
2 files changed, 80 insertions, 0 deletions
diff --git a/examples/debugging/README b/examples/debugging/README new file mode 100644 index 00000000000..9e336805e50 --- /dev/null +++ b/examples/debugging/README @@ -0,0 +1,28 @@ +Last update: John H Terpstra - June 27, 2005 + +Subject: This directory will contain debugging tools and tips. + +Notes: Identification and confirmation of some bugs can be difficult. + When such bugs are encountered it is necessary to provide as + sufficient detailed debugging information to assist the developer + both by providing incontrivertable proof of the problem, but also + precise information regarding the values of variables being processed + at the time the problem strikes. + + This directory is the ideal place to locate useful hints, tips and + methods that will help Samba users to provide the information that + developers need. + +============================ Solaris Method A ============================== +File: solaris-oops.sh +Contributor: David Collier-Brown +Date: June 27, 2005 +Method and Use: +To the global stanza of smb.conf add: + panic action = /usr/local/bin/solaris-oops.sh %d + +When the panic action is initiated a voluntary core dump file will be placed +in /var/tmp. Use this method with "log level = 10" and an smbd binary that +has been built with the '-g' option. +============================================================================ + diff --git a/examples/debugging/solaris-oops.sh b/examples/debugging/solaris-oops.sh new file mode 100644 index 00000000000..78c72c95083 --- /dev/null +++ b/examples/debugging/solaris-oops.sh @@ -0,0 +1,52 @@ +#!/bin/sh +# +# oops -- capture supporting information after a failure +# +ProgName=`basename $0` + +main() { + pid=$1 + + if [ $# -lt 1 ]; then + say "$ProgName error: you must supply a pid" + say "Usage: $0 pid" + exit 1 + fi + cat <<! +State information and vountary core dump for process $pid + +Related processes were: +`/usr/bin/ptree $pid` + +Stack(s) were: +`/usr/bin/pstack $pid` + +Flags were: +`/usr/bin/pflags $pid` + +Credentials were: +`/usr/bin/pcred $pid` + +Libraries used were: +`/usr/bin/pldd $pid` + +Signal-handler settings were: +`/usr/bin/psig $pid` + +Files and devices in use were: +`/usr/bin/pfiles $pid` + +Directory in use was: +`/usr/bin/pwdx $pid` + + +A voluntary core dump was placed in /var/tmp/oops_gcore.$pid +`gcore -o /var/tmp/oops_gcore $pid`.. +! +} + +say() { + echo "$@" 1>&2 +} + +main "$@" |