From 015a2799cbc9a18d0368d49ff04d5484f4ef092b Mon Sep 17 00:00:00 2001 From: lissav Date: Thu, 22 Sep 2011 19:13:00 +0000 Subject: [PATCH] xcatdebug man page git-svn-id: https://svn.code.sf.net/p/xcat/code/xcat-core/trunk@10613 8638fb3e-16cb-4fca-ae20-7b5d299a9bcd --- xCAT-client/pods/man8/xcatdebug.8.pod | 48 +++++++++++++++++++++++++++ 1 file changed, 48 insertions(+) create mode 100644 xCAT-client/pods/man8/xcatdebug.8.pod diff --git a/xCAT-client/pods/man8/xcatdebug.8.pod b/xCAT-client/pods/man8/xcatdebug.8.pod new file mode 100644 index 000000000..2ebb73bf6 --- /dev/null +++ b/xCAT-client/pods/man8/xcatdebug.8.pod @@ -0,0 +1,48 @@ +=head1 NAME + +B - Starts the xCAT daemon (xcatd) in trace mode. + +B {B} + +=head1 DESCRIPTION + +The xcatdebug command starts the xcatd daemon in Perl Debug Trace mode. It is to be used for diagnosing xCAT problems. The trace outputs the paramters passed into the xcatd subroutines, listed in the tracefiles. The tracefiles are located in /opt/xcat/share/xcat/tools/tracelevel. The amount of trace data collected varies with the levelnumber. levelnumber 0 being the least amount of trace and increasing with the number. + +You must have perl-Debug-Trace installed. + +Before running this command, you should stop xcatd on your system. +After running the command, you will have to kill all the xcatd processes and possibly the xcatdebug process. +Run ps -ef | grep xcatd and kill any processes +Run ps -ef | grep xcatdebug + + +=head1 OPTIONS + +=over 6 + +=item B + +The levelnumber that will be run. This determines the filename of trace input + from /opt/xcat/share/xcat/tools/tracelevel + +=back + +=head1 ENVIRONMENT VARIABLES + +=head1 EXAMPLES + +=over 2 + +=item * + +Run the xcatdebug routine with /opt/xcat/share/xcat/tools/tracelevel0 and output to the screen: + +B I<0> + +=item * + +Run the xcatdebug routine with /opt/xcat/share/xcat/tools/tracelevel1 and output to /tmp/traceoutput: + +B I<1> > /tmp/traceoutput 2>&1 + +=back