NAME

xcatdebug - Enable or disable the trace facilities for xCAT. (Only supports Linux Operating System)

SYNOPSIS

xcatdebug { [-f enable | disable [-c {configuration file | subroutine list}]] | [ -d enable | disable]}

DESCRIPTION

xCAT offers two trace facilities to debug the xCAT:

OPTIONS

-f

Enable or disable the subroutine calling trace.

For enable, if ignoring the -c flag, all the subroutines in the xcatd and plugin modules will be enabled.

For disable, all the subroutines which has been enabled by -f enable will be disabled. -c will be ignored.

-c

Specify the configuration file or subroutine list.

-d

Enable or disable the commented trace log.

Note: The xcatd will be restarted for the performing of -d

EXAMPLES

1. Enable the subroutine calling trace for all the subroutines in the xcatd and plugin modules.
 xcatdebug -f enable
2. Enable the subroutine calling trace for the subroutines configured in the /opt/xcat/share/xcat/samples/tracelevel0
 xcatdebug -f enable -c /opt/xcat/share/xcat/samples/tracelevel0
3. Enable the subroutine calling trace for the plugin_command in xcatd and defls,process_request in the xCAT_plugin::DBobjectdefs module.
 xcatdebug -f enable -c "xCAT_plugin::DBobjectdefs(defls,process_request)|(plugin_command)"
4. Disable the subroutine calling trace for all the subroutines which have been enabled by xcatdebug -f enable.
 xcatdebug -f disable
5. Enable the commented trace log
 xcatdebug -d enable
6. Enable both the subroutine calling trace and commented trace log
  xcatdebug -f enable -c /opt/xcat/share/xcat/samples/tracelevel0 -d enable