From 44a6f09a29e27202bdbd6cff5d5c9fc19aea88c3 Mon Sep 17 00:00:00 2001 From: GONG Jie Date: Sun, 31 Dec 2017 23:59:59 +0000 Subject: [PATCH] Remove trailing spaces in file docs/source/guides/admin-guides/references/man8/xcatdebug.8.rst --- .../references/man8/xcatdebug.8.rst | 108 +++++++++--------- 1 file changed, 54 insertions(+), 54 deletions(-) diff --git a/docs/source/guides/admin-guides/references/man8/xcatdebug.8.rst b/docs/source/guides/admin-guides/references/man8/xcatdebug.8.rst index 6a32f61e7..ce0dc1705 100644 --- a/docs/source/guides/admin-guides/references/man8/xcatdebug.8.rst +++ b/docs/source/guides/admin-guides/references/man8/xcatdebug.8.rst @@ -30,15 +30,15 @@ DESCRIPTION xCAT offers two trace facilities to debug the xCAT: -\ **Subroutine calling trace**\ +\ **Subroutine calling trace**\ Display the calling trace for subroutine when it is called. The trace message includes: The name of the called subroutine; The arguments which passed to the called subroutine; The calling stack of the subroutine. By default, the trace will be enabled to all the subroutines in the xcatd and plugin modules. The target subroutine can be configured by configuration file or through xcatdebug command line. The flag \ **-c**\ is used to specify the subroutine list for \ **subroutine calling trace**\ , it can only work with \ **-f**\ . The value of \ **-c**\ can be a configuration file or a subroutine list. - \ **configuration file**\ : a file contains multiple lines of \ **SUBROUTINE_DEFINITION**\ - \ **subroutine list**\ : \ **SUBROUTINE_DEFINITION | SUBROUTINE_DEFINITION|...**\ + \ **configuration file**\ : a file contains multiple lines of \ **SUBROUTINE_DEFINITION**\ + \ **subroutine list**\ : \ **SUBROUTINE_DEFINITION | SUBROUTINE_DEFINITION|...**\ \ **SUBROUTINE_DEFINITION**\ : is the element for the \ **-c**\ to specify the subroutine list. @@ -53,7 +53,7 @@ Otherwise, the package name of the plugin should be specified. The trace log will be written to /var/log/xcat/subcallingtrace. The log file subcallingtrace will be backed up for each running of the \ **xcatdebug -f enable**\ . -\ **Commented trace log**\ +\ **Commented trace log**\ The trace log code is presented as comments in the code of xCAT. In general mode, it will be kept as comments. But in debug mode, it will be commented back as common code to display the trace log. @@ -88,39 +88,39 @@ OPTIONS -\ **-f**\ - +\ **-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**\ - + +\ **-c**\ + Specify the configuration file or subroutine list. - - - \ **configuration file**\ : a file contains multiple lines of \ **SUBROUTINE_DEFINITION**\ + + + \ **configuration file**\ : a file contains multiple lines of \ **SUBROUTINE_DEFINITION**\ e.g. (plugin_command) xCAT_plugin::DBobjectdefs(defls,process_request) xCAT::DBobjUtils(getobjdefs) - - \ **subroutine list**\ : a string like \ **SUBROUTINE_DEFINITION | SUBROUTINE_DEFINITION|...**\ + + \ **subroutine list**\ : a string like \ **SUBROUTINE_DEFINITION | SUBROUTINE_DEFINITION|...**\ e.g. "(plugin_command)|xCAT_plugin::DBobjectdefs(defls,process_request)|xCAT::DBobjUtils(getobjdefs)" - -\ **-d**\ - + +\ **-d**\ + Enable or disable the \ **commented trace log**\ . - - Note: The xcatd will be restarted for the performing of \ **-d**\ - + + Note: The xcatd will be restarted for the performing of \ **-d**\ + @@ -131,62 +131,62 @@ EXAMPLES 1. Enable the \ **subroutine calling trace**\ for all the subroutines in the xcatd and plugin modules. - - + + .. code-block:: perl - + xcatdebug -f enable - - + + 2. Enable the \ **subroutine calling trace**\ for the subroutines configured in the /opt/xcat/share/xcat/samples/tracelevel0 - - + + .. code-block:: perl - + 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. - - + + .. code-block:: perl - + 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**\ . - - + + .. code-block:: perl - + xcatdebug -f disable - - -5. Enable the \ **commented trace log**\ - - + + +5. Enable the \ **commented trace log**\ + + .. code-block:: perl - + xcatdebug -d enable - - -6. Enable both the \ **subroutine calling trace**\ and \ **commented trace log**\ - - + + +6. Enable both the \ **subroutine calling trace**\ and \ **commented trace log**\ + + .. code-block:: perl - + xcatdebug -f enable -c /opt/xcat/share/xcat/samples/tracelevel0 -d enable - - + +