Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]

Groups > linux.kernel > #1190611

[PATCH 3/4] ACPI / Documentation: Update method tracing documentation.

Show all headers | View raw

This patch updates method tracing documentation.

Signed-off-by: Lv Zheng <lv.zheng@intel.com>
---
 Documentation/acpi/method-tracing.txt |   53 ++++++++++++++++++++++++---------
 1 file changed, 39 insertions(+), 14 deletions(-)

diff --git a/Documentation/acpi/method-tracing.txt b/Documentation/acpi/method-tracing.txt
index f6efb1e..c77f91c 100644
--- a/Documentation/acpi/method-tracing.txt
+++ b/Documentation/acpi/method-tracing.txt
@@ -1,26 +1,51 @@
 /sys/module/acpi/parameters/:
 
 trace_method_name
-	The AML method name that the user wants to trace
+	The full path of the AML method that the user wants to use with the
+	"method"/"method-once" tracing mode.
+	Note that the full path shouldn't contain the trailing "_"s in its
+	name segments but should contain "\" to form an absolute path.
 
 trace_debug_layer
-	The temporary debug_layer used when tracing the method.
-	Using 0xffffffff by default if it is 0.
+	The temporary debug_layer used when the tracing feature is enabled.
+	Using ACPI_EXECUTER (0x80) by default.
 
 trace_debug_level
-	The temporary debug_level used when tracing the method.
-	Using 0x00ffffff by default if it is 0.
+	The temporary debug_level used when the tracing feature is enabled.
+	Using ACPI_LV_TRACE_POINT (0x10) by default.
 
 trace_state
 	The status of the tracing feature.
 
-	"enabled" means this feature is enabled
-	and the AML method is traced every time it's executed.
+	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 followings:
+	"disable"
+	    Disable the tracing feature.
+	"enable"
+	    Enable the tracing feature.
+	    ACPICA debugging messages matching
+	    "trace_debug_layer/trace_debug_level" during any method
+	    execution will be logged.
+	"method"
+	    Enable the 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 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 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 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.
 
-	"1" means this feature is enabled and the AML method
-	will only be traced during the next execution.
-
-	"disabled" means this feature is disabled.
-	Users can enable/disable this debug tracing feature by
-	"echo string > /sys/module/acpi/parameters/trace_state".
-	"string" should be one of "enable", "disable" and "1".
-- 
1.7.10

--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Please read the FAQ at  http://www.tux.org/lkml/

Back to linux.kernel | Previous | Next — Previous in thread | Next in thread | Find similar | Unroll thread

Thread

[PATCH 00/22] ACPICA: 20150717 Release Lv Zheng <lv.zheng@intel.com> - 2015-07-23 07:00 +0200
  [PATCH 04/22] ACPICA: Dispatcher: Cleanup union acpi_operand_object's AML address assignments. Lv Zheng <lv.zheng@intel.com> - 2015-07-23 07:00 +0200
  [PATCH 05/22] ACPICA: Executer: Add back pointing reference of method operand. Lv Zheng <lv.zheng@intel.com> - 2015-07-23 07:00 +0200
  [PATCH 09/22] ACPICA: Executer: Add interpreter tracing mode for method tracing facility. Lv Zheng <lv.zheng@intel.com> - 2015-07-23 07:00 +0200
  [PATCH 3/4] ACPI / Documentation: Update method tracing documentation. Lv Zheng <lv.zheng@intel.com> - 2015-07-23 07:10 +0200
  [PATCH 2/4] ACPI / sysfs: Update method tracing facility. Lv Zheng <lv.zheng@intel.com> - 2015-07-23 07:10 +0200
  [PATCH 1/4] ACPI / sysfs: Add ACPI_LV_REPAIR debug level. Lv Zheng <lv.zheng@intel.com> - 2015-07-23 07:10 +0200
  [PATCH 4/4] ACPI / sysfs: Add support to allow leading "\" missing in trace_method_name. Lv Zheng <lv.zheng@intel.com> - 2015-07-23 07:10 +0200
  [PATCH 0/4] ACPI: Update method tracing facility. Lv Zheng <lv.zheng@intel.com> - 2015-07-23 07:10 +0200
    RE: [PATCH 0/4] ACPI: Update method tracing facility. "Zheng, Lv" <lv.zheng@intel.com> - 2015-07-24 04:10 +0200
      RE: [PATCH 0/4] ACPI: Update method tracing facility. "Zheng, Lv" <lv.zheng@intel.com> - 2015-07-27 02:50 +0200
  Re: [PATCH 00/22] ACPICA: 20150717 Release "Rafael J. Wysocki" <rjw@rjwysocki.net> - 2015-07-29 02:40 +0200
    RE: [PATCH 00/22] ACPICA: 20150717 Release "Zheng, Lv" <lv.zheng@intel.com> - 2015-07-29 03:50 +0200

csiph-web