NAME

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

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