linux-kernel.vger.kernel.org archive mirror
 help / color / mirror / Atom feed
From: Changbin Du <changbin.du@gmail.com>
To: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
Cc: Changbin Du <changbin.du@gmail.com>,
	Jonathan Corbet <corbet@lwn.net>,
	Bjorn Helgaas <bhelgaas@google.com>,
	rjw@rjwysocki.net, linux-pci@vger.kernel.org,
	linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org,
	tglx@linutronix.de, mingo@redhat.com, x86@kernel.org,
	fenghua.yu@intel.com, linuxppc-dev@lists.ozlabs.org,
	linux-acpi@vger.kernel.org, linux-gpio@vger.kernel.org
Subject: Re: [PATCH v4 17/63] Documentation: ACPI: move method-tracing.txt to firmware-guide/acpi and convert to rsST
Date: Thu, 25 Apr 2019 00:55:01 +0800	[thread overview]
Message-ID: <20190424165459.npdedjxrdart7wyk@mail.google.com> (raw)
In-Reply-To: <20190424112638.1b9f7cfb@coco.lan>

On Wed, Apr 24, 2019 at 11:26:38AM -0300, Mauro Carvalho Chehab wrote:
> Em Wed, 24 Apr 2019 00:28:46 +0800
> Changbin Du <changbin.du@gmail.com> escreveu:
> 
> > This converts the plain text documentation to reStructuredText format and
> > add it to Sphinx TOC tree. No essential content change.
> > 
> > Signed-off-by: Changbin Du <changbin.du@gmail.com>
> > ---
> >  Documentation/acpi/method-tracing.txt         | 192 ---------------
> >  Documentation/firmware-guide/acpi/index.rst   |   1 +
> >  .../firmware-guide/acpi/method-tracing.rst    | 225 ++++++++++++++++++
> >  3 files changed, 226 insertions(+), 192 deletions(-)
> >  delete mode 100644 Documentation/acpi/method-tracing.txt
> >  create mode 100644 Documentation/firmware-guide/acpi/method-tracing.rst
> > 
> > diff --git a/Documentation/acpi/method-tracing.txt b/Documentation/acpi/method-tracing.txt
> > deleted file mode 100644
> > index 0aba14c8f459..000000000000
> > --- a/Documentation/acpi/method-tracing.txt
> > +++ /dev/null
> > @@ -1,192 +0,0 @@
> > -ACPICA Trace Facility
> > -
> > -Copyright (C) 2015, Intel Corporation
> > -Author: Lv Zheng <lv.zheng@intel.com>
> > -
> > -
> > -Abstract:
> > -
> > -This document describes the functions and the interfaces of the method
> > -tracing facility.
> > -
> > -1. Functionalities and usage examples:
> > -
> > -   ACPICA provides method tracing capability. And two functions are
> > -   currently implemented using this capability.
> > -
> > -   A. Log reducer
> > -   ACPICA subsystem provides debugging outputs when CONFIG_ACPI_DEBUG is
> > -   enabled. The debugging messages which are deployed via
> > -   ACPI_DEBUG_PRINT() macro can be reduced at 2 levels - per-component
> > -   level (known as debug layer, configured via
> > -   /sys/module/acpi/parameters/debug_layer) and per-type level (known as
> > -   debug level, configured via /sys/module/acpi/parameters/debug_level).
> > -
> > -   But when the particular layer/level is applied to the control method
> > -   evaluations, the quantity of the debugging outputs may still be too
> > -   large to be put into the kernel log buffer. The idea thus is worked out
> > -   to only enable the particular debug layer/level (normally more detailed)
> > -   logs when the control method evaluation is started, and disable the
> > -   detailed logging when the control method evaluation is stopped.
> > -
> > -   The following command examples illustrate the usage of the "log reducer"
> > -   functionality:
> > -   a. Filter out the debug layer/level matched logs when control methods
> > -      are being evaluated:
> > -      # cd /sys/module/acpi/parameters
> > -      # echo "0xXXXXXXXX" > trace_debug_layer
> > -      # echo "0xYYYYYYYY" > trace_debug_level
> > -      # echo "enable" > trace_state
> > -   b. Filter out the debug layer/level matched logs when the specified
> > -      control method is being evaluated:
> > -      # cd /sys/module/acpi/parameters
> > -      # echo "0xXXXXXXXX" > trace_debug_layer
> > -      # echo "0xYYYYYYYY" > trace_debug_level
> > -      # echo "\PPPP.AAAA.TTTT.HHHH" > trace_method_name
> > -      # echo "method" > /sys/module/acpi/parameters/trace_state
> > -   c. Filter out the debug layer/level matched logs when the specified
> > -      control method is being evaluated for the first time:
> > -      # cd /sys/module/acpi/parameters
> > -      # echo "0xXXXXXXXX" > trace_debug_layer
> > -      # echo "0xYYYYYYYY" > trace_debug_level
> > -      # echo "\PPPP.AAAA.TTTT.HHHH" > trace_method_name
> > -      # echo "method-once" > /sys/module/acpi/parameters/trace_state
> > -   Where:
> > -      0xXXXXXXXX/0xYYYYYYYY: Refer to Documentation/acpi/debug.txt for
> > -			     possible debug layer/level masking values.
> > -      \PPPP.AAAA.TTTT.HHHH: Full path of a control method that can be found
> > -			    in the ACPI namespace. It needn't be an entry
> > -			    of a control method evaluation.
> > -
> > -   B. AML tracer
> > -
> > -   There are special log entries added by the method tracing facility at
> > -   the "trace points" the AML interpreter starts/stops to execute a control
> > -   method, or an AML opcode. Note that the format of the log entries are
> > -   subject to change:
> > -     [    0.186427]   exdebug-0398 ex_trace_point        : Method Begin [0xf58394d8:\_SB.PCI0.LPCB.ECOK] execution.
> > -     [    0.186630]   exdebug-0398 ex_trace_point        : Opcode Begin [0xf5905c88:If] execution.
> > -     [    0.186820]   exdebug-0398 ex_trace_point        : Opcode Begin [0xf5905cc0:LEqual] execution.
> > -     [    0.187010]   exdebug-0398 ex_trace_point        : Opcode Begin [0xf5905a20:-NamePath-] execution.
> > -     [    0.187214]   exdebug-0398 ex_trace_point        : Opcode End [0xf5905a20:-NamePath-] execution.
> > -     [    0.187407]   exdebug-0398 ex_trace_point        : Opcode Begin [0xf5905f60:One] execution.
> > -     [    0.187594]   exdebug-0398 ex_trace_point        : Opcode End [0xf5905f60:One] execution.
> > -     [    0.187789]   exdebug-0398 ex_trace_point        : Opcode End [0xf5905cc0:LEqual] execution.
> > -     [    0.187980]   exdebug-0398 ex_trace_point        : Opcode Begin [0xf5905cc0:Return] execution.
> > -     [    0.188146]   exdebug-0398 ex_trace_point        : Opcode Begin [0xf5905f60:One] execution.
> > -     [    0.188334]   exdebug-0398 ex_trace_point        : Opcode End [0xf5905f60:One] execution.
> > -     [    0.188524]   exdebug-0398 ex_trace_point        : Opcode End [0xf5905cc0:Return] execution.
> > -     [    0.188712]   exdebug-0398 ex_trace_point        : Opcode End [0xf5905c88:If] execution.
> > -     [    0.188903]   exdebug-0398 ex_trace_point        : Method End [0xf58394d8:\_SB.PCI0.LPCB.ECOK] execution.
> > -
> > -   Developers can utilize these special log entries to track the AML
> > -   interpretion, thus can aid issue debugging and performance tuning. Note
> > -   that, as the "AML tracer" logs are implemented via ACPI_DEBUG_PRINT()
> > -   macro, CONFIG_ACPI_DEBUG is also required to be enabled for enabling
> > -   "AML tracer" logs.
> > -
> > -   The following command examples illustrate the usage of the "AML tracer"
> > -   functionality:
> > -   a. Filter out the method start/stop "AML tracer" logs when control
> > -      methods are being evaluated:
> > -      # cd /sys/module/acpi/parameters
> > -      # echo "0x80" > trace_debug_layer
> > -      # echo "0x10" > trace_debug_level
> > -      # echo "enable" > trace_state
> > -   b. Filter out the method start/stop "AML tracer" when the specified
> > -      control method is being evaluated:
> > -      # cd /sys/module/acpi/parameters
> > -      # echo "0x80" > trace_debug_layer
> > -      # echo "0x10" > trace_debug_level
> > -      # echo "\PPPP.AAAA.TTTT.HHHH" > trace_method_name
> > -      # echo "method" > trace_state
> > -   c. Filter out the method start/stop "AML tracer" logs when the specified
> > -      control method is being evaluated for the first time:
> > -      # cd /sys/module/acpi/parameters
> > -      # echo "0x80" > trace_debug_layer
> > -      # echo "0x10" > trace_debug_level
> > -      # echo "\PPPP.AAAA.TTTT.HHHH" > trace_method_name
> > -      # echo "method-once" > trace_state
> > -   d. Filter out the method/opcode start/stop "AML tracer" when the
> > -      specified control method is being evaluated:
> > -      # cd /sys/module/acpi/parameters
> > -      # echo "0x80" > trace_debug_layer
> > -      # echo "0x10" > trace_debug_level
> > -      # echo "\PPPP.AAAA.TTTT.HHHH" > trace_method_name
> > -      # echo "opcode" > trace_state
> > -   e. Filter out the method/opcode start/stop "AML tracer" when the
> > -      specified control method is being evaluated for the first time:
> > -      # cd /sys/module/acpi/parameters
> > -      # echo "0x80" > trace_debug_layer
> > -      # echo "0x10" > trace_debug_level
> > -      # echo "\PPPP.AAAA.TTTT.HHHH" > trace_method_name
> > -      # echo "opcode-opcode" > trace_state
> > -
> > -  Note that all above method tracing facility related module parameters can
> > -  be used as the boot parameters, for example:
> > -      acpi.trace_debug_layer=0x80 acpi.trace_debug_level=0x10 \
> > -      acpi.trace_method_name=\_SB.LID0._LID acpi.trace_state=opcode-once
> > -
> > -2. Interface descriptions:
> > -
> > -   All method tracing functions can be configured via ACPI module
> > -   parameters that are accessible at /sys/module/acpi/parameters/:
> > -
> > -   trace_method_name
> > -	The full path of the AML method that the user wants to trace.
> > -	Note that the full path shouldn't contain the trailing "_"s in its
> > -	name segments but may contain "\" to form an absolute path.
> > -
> > -   trace_debug_layer
> > -	The temporary debug_layer used when the tracing feature is enabled.
> > -	Using ACPI_EXECUTER (0x80) by default, which is the debug_layer
> > -	used to match all "AML tracer" logs.
> > -
> > -   trace_debug_level
> > -	The temporary debug_level used when the tracing feature is enabled.
> > -	Using ACPI_LV_TRACE_POINT (0x10) by default, which is the
> > -	debug_level used to match all "AML tracer" logs.
> > -
> > -   trace_state
> > -	The status of the tracing feature.
> > -	Users can enable/disable this debug tracing feature by executing
> > -	the following command:
> > -	    # echo string > /sys/module/acpi/parameters/trace_state
> > -	Where "string" should be one of the following:
> > -	"disable"
> > -	    Disable the method tracing feature.
> > -	"enable"
> > -	    Enable the method tracing feature.
> > -	    ACPICA debugging messages matching
> > -	    "trace_debug_layer/trace_debug_level" during any method
> > -	    execution will be logged.
> > -	"method"
> > -	    Enable the method tracing feature.
> > -	    ACPICA debugging messages matching
> > -	    "trace_debug_layer/trace_debug_level" during method execution
> > -	    of "trace_method_name" will be logged.
> > -	"method-once"
> > -	    Enable the method tracing feature.
> > -	    ACPICA debugging messages matching
> > -	    "trace_debug_layer/trace_debug_level" during method execution
> > -	    of "trace_method_name" will be logged only once.
> > -	"opcode"
> > -	    Enable the method tracing feature.
> > -	    ACPICA debugging messages matching
> > -	    "trace_debug_layer/trace_debug_level" during method/opcode
> > -	    execution of "trace_method_name" will be logged.
> > -	"opcode-once"
> > -	    Enable the method tracing feature.
> > -	    ACPICA debugging messages matching
> > -	    "trace_debug_layer/trace_debug_level" during method/opcode
> > -	    execution of "trace_method_name" will be logged only once.
> > -	Note that, the difference between the "enable" and other feature
> > -        enabling options are:
> > -	1. When "enable" is specified, since
> > -	   "trace_debug_layer/trace_debug_level" shall apply to all control
> > -	   method evaluations, after configuring "trace_state" to "enable",
> > -	   "trace_method_name" will be reset to NULL.
> > -	2. When "method/opcode" is specified, if
> > -	   "trace_method_name" is NULL when "trace_state" is configured to
> > -	   these options, the "trace_debug_layer/trace_debug_level" will
> > -	   apply to all control method evaluations.
> > diff --git a/Documentation/firmware-guide/acpi/index.rst b/Documentation/firmware-guide/acpi/index.rst
> > index a45fea11f998..287a7cbd82ac 100644
> > --- a/Documentation/firmware-guide/acpi/index.rst
> > +++ b/Documentation/firmware-guide/acpi/index.rst
> > @@ -13,6 +13,7 @@ ACPI Support
> >     enumeration
> >     osi
> >     method-customizing
> > +   method-tracing
> >     DSD-properties-rules
> >     debug
> >     gpio-properties
> > diff --git a/Documentation/firmware-guide/acpi/method-tracing.rst b/Documentation/firmware-guide/acpi/method-tracing.rst
> > new file mode 100644
> > index 000000000000..7a997ba168d7
> > --- /dev/null
> > +++ b/Documentation/firmware-guide/acpi/method-tracing.rst
> > @@ -0,0 +1,225 @@
> > +.. SPDX-License-Identifier: GPL-2.0
> > +.. include:: <isonum.txt>
> > +
> > +=====================
> > +ACPICA Trace Facility
> > +=====================
> > +
> > +:Copyright: |copy| 2015, Intel Corporation
> > +:Author: Lv Zheng <lv.zheng@intel.com>
> > +
> > +
> > +:Abstract: This document describes the functions and the interfaces of the
> > +  method tracing facility.
> 
> Same comment as on other patches.
>
Fixed, thanks.

> > +
> > +1. Functionalities and usage examples
> > +=====================================
> > +
> > +ACPICA provides method tracing capability. And two functions are
> > +currently implemented using this capability.
> > +
> > +Log reducer
> > +--------------
> > +
> > +ACPICA subsystem provides debugging outputs when CONFIG_ACPI_DEBUG is
> > +enabled. The debugging messages which are deployed via
> > +ACPI_DEBUG_PRINT() macro can be reduced at 2 levels - per-component
> > +level (known as debug layer, configured via
> > +/sys/module/acpi/parameters/debug_layer) and per-type level (known as
> > +debug level, configured via /sys/module/acpi/parameters/debug_level).
> > +
> > +But when the particular layer/level is applied to the control method
> > +evaluations, the quantity of the debugging outputs may still be too
> > +large to be put into the kernel log buffer. The idea thus is worked out
> > +to only enable the particular debug layer/level (normally more detailed)
> > +logs when the control method evaluation is started, and disable the
> > +detailed logging when the control method evaluation is stopped.
> > +
> > +The following command examples illustrate the usage of the "log reducer"
> > +functionality:
> > +
> > +a. Filter out the debug layer/level matched logs when control methods
> > +   are being evaluated::
> > +
> > +      # cd /sys/module/acpi/parameters
> > +      # echo "0xXXXXXXXX" > trace_debug_layer
> > +      # echo "0xYYYYYYYY" > trace_debug_level
> > +      # echo "enable" > trace_state
> > +
> > +b. Filter out the debug layer/level matched logs when the specified
> > +   control method is being evaluated::
> > +
> > +      # cd /sys/module/acpi/parameters
> > +      # echo "0xXXXXXXXX" > trace_debug_layer
> > +      # echo "0xYYYYYYYY" > trace_debug_level
> > +      # echo "\PPPP.AAAA.TTTT.HHHH" > trace_method_name
> > +      # echo "method" > /sys/module/acpi/parameters/trace_state
> > +
> > +c. Filter out the debug layer/level matched logs when the specified
> > +   control method is being evaluated for the first time::
> > +
> > +      # cd /sys/module/acpi/parameters
> > +      # echo "0xXXXXXXXX" > trace_debug_layer
> > +      # echo "0xYYYYYYYY" > trace_debug_level
> > +      # echo "\PPPP.AAAA.TTTT.HHHH" > trace_method_name
> > +      # echo "method-once" > /sys/module/acpi/parameters/trace_state
> > +
> > +Where:
> > +   0xXXXXXXXX/0xYYYYYYYY
> > +     Refer to Documentation/acpi/debug.txt for possible debug layer/level
> > +     masking values.
> > +   \PPPP.AAAA.TTTT.HHHH
> > +     Full path of a control method that can be found in the ACPI namespace.
> > +     It needn't be an entry of a control method evaluation.
> > +
> > +AML tracer
> > +-------------
> 
> The markup is bigger than the line. You should have seen a Sphinx
> warning here.
> 
> > +
> > +There are special log entries added by the method tracing facility at
> > +the "trace points" the AML interpreter starts/stops to execute a control
> > +method, or an AML opcode. Note that the format of the log entries are
> > +subject to change::
> > +
> > +   [    0.186427]   exdebug-0398 ex_trace_point        : Method Begin [0xf58394d8:\_SB.PCI0.LPCB.ECOK] execution.
> > +   [    0.186630]   exdebug-0398 ex_trace_point        : Opcode Begin [0xf5905c88:If] execution.
> > +   [    0.186820]   exdebug-0398 ex_trace_point        : Opcode Begin [0xf5905cc0:LEqual] execution.
> > +   [    0.187010]   exdebug-0398 ex_trace_point        : Opcode Begin [0xf5905a20:-NamePath-] execution.
> > +   [    0.187214]   exdebug-0398 ex_trace_point        : Opcode End [0xf5905a20:-NamePath-] execution.
> > +   [    0.187407]   exdebug-0398 ex_trace_point        : Opcode Begin [0xf5905f60:One] execution.
> > +   [    0.187594]   exdebug-0398 ex_trace_point        : Opcode End [0xf5905f60:One] execution.
> > +   [    0.187789]   exdebug-0398 ex_trace_point        : Opcode End [0xf5905cc0:LEqual] execution.
> > +   [    0.187980]   exdebug-0398 ex_trace_point        : Opcode Begin [0xf5905cc0:Return] execution.
> > +   [    0.188146]   exdebug-0398 ex_trace_point        : Opcode Begin [0xf5905f60:One] execution.
> > +   [    0.188334]   exdebug-0398 ex_trace_point        : Opcode End [0xf5905f60:One] execution.
> > +   [    0.188524]   exdebug-0398 ex_trace_point        : Opcode End [0xf5905cc0:Return] execution.
> > +   [    0.188712]   exdebug-0398 ex_trace_point        : Opcode End [0xf5905c88:If] execution.
> > +   [    0.188903]   exdebug-0398 ex_trace_point        : Method End [0xf58394d8:\_SB.PCI0.LPCB.ECOK] execution.
> > +
> > +Developers can utilize these special log entries to track the AML
> > +interpretion, thus can aid issue debugging and performance tuning. Note
> > +that, as the "AML tracer" logs are implemented via ACPI_DEBUG_PRINT()
> > +macro, CONFIG_ACPI_DEBUG is also required to be enabled for enabling
> > +"AML tracer" logs.
> > +
> > +The following command examples illustrate the usage of the "AML tracer"
> > +functionality:
> > +
> > +a. Filter out the method start/stop "AML tracer" logs when control
> > +   methods are being evaluated::
> > +
> > +      # cd /sys/module/acpi/parameters
> > +      # echo "0x80" > trace_debug_layer
> > +      # echo "0x10" > trace_debug_level
> > +      # echo "enable" > trace_state
> > +
> > +b. Filter out the method start/stop "AML tracer" when the specified
> > +   control method is being evaluated::
> > +
> > +      # cd /sys/module/acpi/parameters
> > +      # echo "0x80" > trace_debug_layer
> > +      # echo "0x10" > trace_debug_level
> > +      # echo "\PPPP.AAAA.TTTT.HHHH" > trace_method_name
> > +      # echo "method" > trace_state
> > +
> > +c. Filter out the method start/stop "AML tracer" logs when the specified
> > +   control method is being evaluated for the first time::
> > +
> > +      # cd /sys/module/acpi/parameters
> > +      # echo "0x80" > trace_debug_layer
> > +      # echo "0x10" > trace_debug_level
> > +      # echo "\PPPP.AAAA.TTTT.HHHH" > trace_method_name
> > +      # echo "method-once" > trace_state
> > +
> > +d. Filter out the method/opcode start/stop "AML tracer" when the
> > +   specified control method is being evaluated::
> > +
> > +      # cd /sys/module/acpi/parameters
> > +      # echo "0x80" > trace_debug_layer
> > +      # echo "0x10" > trace_debug_level
> > +      # echo "\PPPP.AAAA.TTTT.HHHH" > trace_method_name
> > +      # echo "opcode" > trace_state
> > +
> > +e. Filter out the method/opcode start/stop "AML tracer" when the
> > +   specified control method is being evaluated for the first time::
> > +
> > +      # cd /sys/module/acpi/parameters
> > +      # echo "0x80" > trace_debug_layer
> > +      # echo "0x10" > trace_debug_level
> > +      # echo "\PPPP.AAAA.TTTT.HHHH" > trace_method_name
> > +      # echo "opcode-opcode" > trace_state
> > +
> > +Note that all above method tracing facility related module parameters can
> > +be used as the boot parameters, for example::
> > +
> > +   acpi.trace_debug_layer=0x80 acpi.trace_debug_level=0x10 \
> > +   acpi.trace_method_name=\_SB.LID0._LID acpi.trace_state=opcode-once
> > +
> > +2. Interface descriptions
> > +=========================
> > +
> > +All method tracing functions can be configured via ACPI module
> > +parameters that are accessible at /sys/module/acpi/parameters/:
> > +
> > +trace_method_name
> > +The full path of the AML method that the user wants to trace.
> > +Note that the full path shouldn't contain the trailing "_"s in its
> > +name segments but may contain "\" to form an absolute path.
> > +
> 
> 
> > +trace_debug_layer
> > +The temporary debug_layer used when the tracing feature is enabled.
> > +Using ACPI_EXECUTER (0x80) by default, which is the debug_layer
> > +used to match all "AML tracer" logs.
> > +
> > +trace_debug_level
> > +The temporary debug_level used when the tracing feature is enabled.
> > +Using ACPI_LV_TRACE_POINT (0x10) by default, which is the
> > +debug_level used to match all "AML tracer" logs.
> > +
> > +trace_state
> > +The status of the tracing feature.
> > +Users can enable/disable this debug tracing feature by executing
> > +the following command::
> 
> For the above, please indent, in order to properly change the
> sysfs node font to bold. Also, mark paragraphs with a \n, e. g:
> 
>    trace_method_name
> 	The full path of the AML method that the user wants to trace.
> 
> 	Note that the full path shouldn't contain the trailing "_"s in its
> 	name segments but may contain "\" to form an absolute path.
> 
>    trace_debug_layer
> 	The temporary debug_layer used when the tracing feature is enabled.
> 
> 	Using ACPI_EXECUTER (0x80) by default, which is the debug_layer
> 	used to match all "AML tracer" logs.
> 
>    trace_debug_level
> 	The temporary debug_level used when the tracing feature is enabled.
> 
> 	Using ACPI_LV_TRACE_POINT (0x10) by default, which is the
> 	debug_level used to match all "AML tracer" logs.
> 
>    trace_state
> 	The status of the tracing feature.
> 
> 	Users can enable/disable this debug tracing feature by executing
> 	the following command::
> 
Done, thanks.

> After doing such changes:
> 
> Reviewed-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
> 
> 
> > +
> > +   # echo string > /sys/module/acpi/parameters/trace_state
> > +
> > +Where "string" should be one of the following:
> > +
> > +"disable"
> > +      Disable the method tracing feature.
> > +"enable"
> > +      Enable the method tracing feature.
> > +      ACPICA debugging messages matching
> > +      "trace_debug_layer/trace_debug_level" during any method
> > +      execution will be logged.
> > +"method"
> > +      Enable the method tracing feature.
> > +      ACPICA debugging messages matching
> > +      "trace_debug_layer/trace_debug_level" during method execution
> > +      of "trace_method_name" will be logged.
> > +"method-once"
> > +      Enable the method tracing feature.
> > +      ACPICA debugging messages matching
> > +      "trace_debug_layer/trace_debug_level" during method execution
> > +      of "trace_method_name" will be logged only once.
> > +"opcode"
> > +      Enable the method tracing feature.
> > +      ACPICA debugging messages matching
> > +      "trace_debug_layer/trace_debug_level" during method/opcode
> > +      execution of "trace_method_name" will be logged.
> > +"opcode-once"
> > +      Enable the method tracing feature.
> > +      ACPICA debugging messages matching
> > +      "trace_debug_layer/trace_debug_level" during method/opcode
> > +      execution of "trace_method_name" will be logged only once.
> > +
> > +Note that, the difference between the "enable" and other feature
> > +enabling options are:
> > +
> > +1. When "enable" is specified, since
> > +   "trace_debug_layer/trace_debug_level" shall apply to all control
> > +   method evaluations, after configuring "trace_state" to "enable",
> > +   "trace_method_name" will be reset to NULL.
> > +2. When "method/opcode" is specified, if
> > +   "trace_method_name" is NULL when "trace_state" is configured to
> > +   these options, the "trace_debug_layer/trace_debug_level" will
> > +   apply to all control method evaluations.
> 
> 
> 
> Thanks,
> Mauro

-- 
Cheers,
Changbin Du

  reply	other threads:[~2019-04-24 16:55 UTC|newest]

Thread overview: 124+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2019-04-23 16:28 [PATCH v4 00/63] Include linux ACPI/PCI/X86 docs into Sphinx TOC tree Changbin Du
2019-04-23 16:28 ` [PATCH v4 01/63] Documentation: add Linux ACPI to " Changbin Du
2019-04-23 20:39   ` Mauro Carvalho Chehab
2019-04-23 16:28 ` [PATCH v4 02/63] Documentation: ACPI: move namespace.txt to firmware-guide/acpi and convert to reST Changbin Du
2019-04-23 20:38   ` Mauro Carvalho Chehab
2019-04-24 16:09     ` Changbin Du
2019-04-23 16:28 ` [PATCH v4 03/63] Documentation: ACPI: move enumeration.txt " Changbin Du
2019-04-23 20:42   ` Mauro Carvalho Chehab
2019-04-23 16:28 ` [PATCH v4 04/63] Documentation: ACPI: move osi.txt " Changbin Du
2019-04-23 20:44   ` Mauro Carvalho Chehab
2019-04-23 16:28 ` [PATCH v4 05/63] Documentation: ACPI: move linuxized-acpica.txt to driver-api/acpi " Changbin Du
2019-04-23 20:50   ` Mauro Carvalho Chehab
2019-04-24 16:15     ` Changbin Du
2019-04-23 16:28 ` [PATCH v4 06/63] Documentation: ACPI: move scan_handlers.txt " Changbin Du
2019-04-23 20:51   ` Mauro Carvalho Chehab
2019-04-23 16:28 ` [PATCH v4 07/63] Documentation: ACPI: move DSD-properties-rules.txt to firmware-guide/acpi and covert " Changbin Du
2019-04-23 20:52   ` Mauro Carvalho Chehab
2019-04-23 16:28 ` [PATCH v4 08/63] Documentation: ACPI: move gpio-properties.txt to firmware-guide/acpi and convert " Changbin Du
2019-04-23 20:55   ` Mauro Carvalho Chehab
2019-04-24 16:21     ` Changbin Du
2019-04-23 16:28 ` [PATCH v4 09/63] Documentation: ACPI: move method-customizing.txt " Changbin Du
2019-04-23 21:03   ` Mauro Carvalho Chehab
2019-04-24 16:28     ` Changbin Du
2019-04-24 17:53       ` Mauro Carvalho Chehab
2019-04-23 16:28 ` [PATCH v4 10/63] Documentation: ACPI: move initrd_table_override.txt to admin-guide/acpi " Changbin Du
2019-04-23 21:07   ` Mauro Carvalho Chehab
2019-04-24 16:33     ` Changbin Du
2019-04-23 16:28 ` [PATCH v4 11/63] Documentation: ACPI: move dsdt-override.txt " Changbin Du
2019-04-23 21:08   ` Mauro Carvalho Chehab
2019-04-23 16:28 ` [PATCH v4 12/63] Documentation: ACPI: move i2c-muxes.txt to firmware-guide/acpi " Changbin Du
2019-04-23 21:09   ` Mauro Carvalho Chehab
2019-04-23 16:28 ` [PATCH v4 13/63] Documentation: ACPI: move acpi-lid.txt " Changbin Du
2019-04-23 21:12   ` Mauro Carvalho Chehab
2019-04-23 16:28 ` [PATCH v4 14/63] Documentation: ACPI: move dsd/graph.txt " Changbin Du
2019-04-23 21:14   ` Mauro Carvalho Chehab
2019-04-23 16:28 ` [PATCH v4 15/63] Documentation: ACPI: move dsd/data-node-references.txt " Changbin Du
2019-04-23 21:17   ` Mauro Carvalho Chehab
2019-04-24 16:44     ` Changbin Du
2019-04-23 16:28 ` [PATCH v4 16/63] Documentation: ACPI: move debug.txt " Changbin Du
2019-04-23 21:21   ` Mauro Carvalho Chehab
2019-04-23 16:28 ` [PATCH v4 17/63] Documentation: ACPI: move method-tracing.txt to firmware-guide/acpi and convert to rsST Changbin Du
2019-04-24 14:26   ` Mauro Carvalho Chehab
2019-04-24 16:55     ` Changbin Du [this message]
2019-04-23 16:28 ` [PATCH v4 18/63] Documentation: ACPI: move aml-debugger.txt to firmware-guide/acpi and convert to reST Changbin Du
2019-04-24 14:28   ` Mauro Carvalho Chehab
2019-04-23 16:28 ` [PATCH v4 19/63] Documentation: ACPI: move apei/output_format.txt " Changbin Du
2019-04-24 14:29   ` Mauro Carvalho Chehab
2019-04-23 16:28 ` [PATCH v4 20/63] Documentation: ACPI: move apei/einj.txt " Changbin Du
2019-04-24 14:33   ` Mauro Carvalho Chehab
2019-04-24 17:12     ` Changbin Du
2019-04-23 16:28 ` [PATCH v4 21/63] Documentation: ACPI: move cppc_sysfs.txt to admin-guide/acpi " Changbin Du
2019-04-24 14:48   ` Mauro Carvalho Chehab
2019-04-24 17:22     ` Changbin Du
2019-04-24 18:04       ` Mauro Carvalho Chehab
2019-04-23 16:28 ` [PATCH v4 22/63] Documentation: ACPI: move lpit.txt to firmware-guide/acpi " Changbin Du
2019-04-24 14:49   ` Mauro Carvalho Chehab
2019-04-23 16:28 ` [PATCH v4 23/63] Documentation: ACPI: move ssdt-overlays.txt to admin-guide/acpi " Changbin Du
2019-04-24 14:51   ` Mauro Carvalho Chehab
2019-04-23 16:28 ` [PATCH v4 24/63] Documentation: ACPI: move video_extension.txt to firmware-guide/acpi " Changbin Du
2019-04-24 14:56   ` Mauro Carvalho Chehab
2019-04-24 17:31     ` Changbin Du
2019-04-23 16:28 ` [PATCH v4 25/63] Documentation: add Linux PCI to Sphinx TOC tree Changbin Du
2019-04-24 15:03   ` Mauro Carvalho Chehab
2019-04-25 15:42     ` Changbin Du
2019-04-23 16:28 ` [PATCH v4 26/63] Documentation: PCI: convert pci.txt to reST Changbin Du
2019-04-24 15:20   ` Mauro Carvalho Chehab
2019-04-23 16:28 ` [PATCH v4 27/63] Documentation: PCI: convert PCIEBUS-HOWTO.txt " Changbin Du
2019-04-24 15:23   ` Mauro Carvalho Chehab
2019-04-23 16:28 ` [PATCH v4 28/63] Documentation: PCI: convert pci-iov-howto.txt " Changbin Du
2019-04-24 15:25   ` Mauro Carvalho Chehab
2019-04-23 16:28 ` [PATCH v4 29/63] Documentation: PCI: convert MSI-HOWTO.txt " Changbin Du
2019-04-24 15:29   ` Mauro Carvalho Chehab
2019-04-23 16:28 ` [PATCH v4 30/63] Documentation: PCI: convert acpi-info.txt " Changbin Du
2019-04-24 15:34   ` Mauro Carvalho Chehab
2019-04-23 16:29 ` [PATCH v4 31/63] Documentation: PCI: convert pci-error-recovery.txt " Changbin Du
2019-04-24 15:45   ` Mauro Carvalho Chehab
2019-04-23 16:29 ` [PATCH v4 32/63] Documentation: PCI: convert pcieaer-howto.txt " Changbin Du
2019-04-24 15:49   ` Mauro Carvalho Chehab
2019-04-23 16:29 ` [PATCH v4 33/63] Documentation: PCI: convert endpoint/pci-endpoint.txt " Changbin Du
2019-04-24 15:55   ` Mauro Carvalho Chehab
2019-04-23 16:29 ` [PATCH v4 34/63] Documentation: PCI: convert endpoint/pci-endpoint-cfs.txt " Changbin Du
2019-04-24 16:26   ` Mauro Carvalho Chehab
2019-04-23 16:29 ` [PATCH v4 35/63] Documentation: PCI: convert endpoint/pci-test-function.txt " Changbin Du
2019-04-24 16:58   ` Mauro Carvalho Chehab
2019-04-23 16:29 ` [PATCH v4 36/63] Documentation: PCI: convert endpoint/pci-test-howto.txt " Changbin Du
2019-04-24 17:00   ` Mauro Carvalho Chehab
2019-04-23 16:29 ` [PATCH v4 37/63] Documentation: add Linux x86 docs to Sphinx TOC tree Changbin Du
2019-04-24 17:04   ` Mauro Carvalho Chehab
2019-04-23 16:29 ` [PATCH v4 38/63] Documentation: x86: convert boot.txt to reST Changbin Du
2019-04-24 17:36   ` Mauro Carvalho Chehab
2019-04-25 17:07     ` Changbin Du
2019-04-23 16:29 ` [PATCH v4 39/63] Documentation: x86: convert topology.txt " Changbin Du
2019-04-24 17:44   ` Mauro Carvalho Chehab
2019-04-26 14:23     ` Changbin Du
2019-04-23 16:29 ` [PATCH v4 40/63] Documentation: x86: convert exception-tables.txt " Changbin Du
2019-04-23 16:29 ` [PATCH v4 41/63] Documentation: x86: convert kernel-stacks " Changbin Du
2019-04-23 16:29 ` [PATCH v4 42/63] Documentation: x86: convert entry_64.txt " Changbin Du
2019-04-23 16:29 ` [PATCH v4 43/63] Documentation: x86: convert earlyprintk.txt " Changbin Du
2019-04-23 16:29 ` [PATCH v4 44/63] Documentation: x86: convert zero-page.txt " Changbin Du
2019-04-23 16:29 ` [PATCH v4 45/63] Documentation: x86: convert tlb.txt " Changbin Du
2019-04-23 16:29 ` [PATCH v4 46/63] Documentation: x86: convert mtrr.txt " Changbin Du
2019-04-23 16:29 ` [PATCH v4 47/63] Documentation: x86: convert pat.txt " Changbin Du
2019-04-23 16:29 ` [PATCH v4 48/63] Documentation: x86: convert protection-keys.txt " Changbin Du
2019-04-23 16:29 ` [PATCH v4 49/63] Documentation: x86: convert intel_mpx.txt " Changbin Du
2019-04-23 16:29 ` [PATCH v4 50/63] Documentation: x86: convert amd-memory-encryption.txt " Changbin Du
2019-04-23 16:29 ` [PATCH v4 51/63] Documentation: x86: convert pti.txt " Changbin Du
2019-04-23 16:29 ` [PATCH v4 52/63] Documentation: x86: convert microcode.txt " Changbin Du
2019-04-23 16:29 ` [PATCH v4 53/63] Documentation: x86: convert resctrl_ui.txt " Changbin Du
2019-04-23 16:29 ` [PATCH v4 54/63] Documentation: x86: convert orc-unwinder.txt " Changbin Du
2019-04-23 16:29 ` [PATCH v4 55/63] Documentation: x86: convert usb-legacy-support.txt " Changbin Du
2019-04-23 16:29 ` [PATCH v4 56/63] Documentation: x86: convert i386/IO-APIC.txt " Changbin Du
2019-04-23 16:29 ` [PATCH v4 57/63] Documentation: x86: convert x86_64/boot-options.txt " Changbin Du
2019-04-23 16:29 ` [PATCH v4 58/63] Documentation: x86: convert x86_64/uefi.txt " Changbin Du
2019-04-23 16:29 ` [PATCH v4 59/63] Documentation: x86: convert x86_64/mm.txt " Changbin Du
2019-04-23 16:29 ` [PATCH v4 60/63] Documentation: x86: convert x86_64/5level-paging.txt " Changbin Du
2019-04-23 16:29 ` [PATCH v4 61/63] Documentation: x86: convert x86_64/fake-numa-for-cpusets " Changbin Du
2019-04-23 16:29 ` [PATCH v4 62/63] Documentation: x86: convert x86_64/cpu-hotplug-spec " Changbin Du
2019-04-23 16:29 ` [PATCH v4 63/63] Documentation: x86: convert x86_64/machinecheck " Changbin Du
2019-04-23 16:39 ` [PATCH v4 00/63] Include linux ACPI/PCI/X86 docs into Sphinx TOC tree Rafael J. Wysocki
2019-04-23 17:36   ` Bjorn Helgaas
2019-04-24 15:46     ` Changbin Du
2019-04-24 17:48       ` Mauro Carvalho Chehab
2019-04-24 16:18 ` Jonathan Corbet
2019-04-24 16:52   ` Mauro Carvalho Chehab

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20190424165459.npdedjxrdart7wyk@mail.google.com \
    --to=changbin.du@gmail.com \
    --cc=bhelgaas@google.com \
    --cc=corbet@lwn.net \
    --cc=fenghua.yu@intel.com \
    --cc=linux-acpi@vger.kernel.org \
    --cc=linux-doc@vger.kernel.org \
    --cc=linux-gpio@vger.kernel.org \
    --cc=linux-kernel@vger.kernel.org \
    --cc=linux-pci@vger.kernel.org \
    --cc=linuxppc-dev@lists.ozlabs.org \
    --cc=mchehab+samsung@kernel.org \
    --cc=mingo@redhat.com \
    --cc=rjw@rjwysocki.net \
    --cc=tglx@linutronix.de \
    --cc=x86@kernel.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).