Lines Matching +full:enable +full:- +full:method
1 .. SPDX-License-Identifier: GPL-2.0
15 method tracing facility.
20 ACPICA provides method tracing capability. And two functions are
24 -----------
28 ACPI_DEBUG_PRINT() macro can be reduced at 2 levels - per-component
30 /sys/module/acpi/parameters/debug_layer) and per-type level (known as
33 But when the particular layer/level is applied to the control method
36 to only enable the particular debug layer/level (normally more detailed)
37 logs when the control method evaluation is started, and disable the
38 detailed logging when the control method evaluation is stopped.
49 # echo "enable" > trace_state
52 control method is being evaluated::
58 # echo "method" > /sys/module/acpi/parameters/trace_state
61 control method is being evaluated for the first time::
67 # echo "method-once" > /sys/module/acpi/parameters/trace_state
71 Refer to Documentation/firmware-guide/acpi/debug.rst for possible debug layer/level
74 Full path of a control method that can be found in the ACPI namespace.
75 It needn't be an entry of a control method evaluation.
78 ----------
80 There are special log entries added by the method tracing facility at
82 method, or an AML opcode. Note that the format of the log entries are
85 …[ 0.186427] exdebug-0398 ex_trace_point : Method Begin [0xf58394d8:\_SB.PCI0.LPCB.ECOK…
86 [ 0.186630] exdebug-0398 ex_trace_point : Opcode Begin [0xf5905c88:If] execution.
87 [ 0.186820] exdebug-0398 ex_trace_point : Opcode Begin [0xf5905cc0:LEqual] execution.
88 …[ 0.187010] exdebug-0398 ex_trace_point : Opcode Begin [0xf5905a20:-NamePath-] executi…
89 …[ 0.187214] exdebug-0398 ex_trace_point : Opcode End [0xf5905a20:-NamePath-] execution.
90 [ 0.187407] exdebug-0398 ex_trace_point : Opcode Begin [0xf5905f60:One] execution.
91 [ 0.187594] exdebug-0398 ex_trace_point : Opcode End [0xf5905f60:One] execution.
92 [ 0.187789] exdebug-0398 ex_trace_point : Opcode End [0xf5905cc0:LEqual] execution.
93 [ 0.187980] exdebug-0398 ex_trace_point : Opcode Begin [0xf5905cc0:Return] execution.
94 [ 0.188146] exdebug-0398 ex_trace_point : Opcode Begin [0xf5905f60:One] execution.
95 [ 0.188334] exdebug-0398 ex_trace_point : Opcode End [0xf5905f60:One] execution.
96 [ 0.188524] exdebug-0398 ex_trace_point : Opcode End [0xf5905cc0:Return] execution.
97 [ 0.188712] exdebug-0398 ex_trace_point : Opcode End [0xf5905c88:If] execution.
98 …[ 0.188903] exdebug-0398 ex_trace_point : Method End [0xf58394d8:\_SB.PCI0.LPCB.ECOK] …
109 a. Filter out the method start/stop "AML tracer" logs when control
115 # echo "enable" > trace_state
117 b. Filter out the method start/stop "AML tracer" when the specified
118 control method is being evaluated::
124 # echo "method" > trace_state
126 c. Filter out the method start/stop "AML tracer" logs when the specified
127 control method is being evaluated for the first time::
133 # echo "method-once" > trace_state
135 d. Filter out the method/opcode start/stop "AML tracer" when the
136 specified control method is being evaluated::
144 e. Filter out the method/opcode start/stop "AML tracer" when the
145 specified control method is being evaluated for the first time::
151 # echo "opcode-opcode" > trace_state
153 Note that all above method tracing facility related module parameters can
157 acpi.trace_method_name=\_SB.LID0._LID acpi.trace_state=opcode-once
163 All method tracing functions can be configured via ACPI module
167 The full path of the AML method that the user wants to trace.
187 Users can enable/disable this debug tracing feature by executing
195 Disable the method tracing feature.
197 "enable"
198 Enable the method tracing feature.
201 during any method execution will be logged.
203 "method"
204 Enable the method tracing feature.
207 during method execution of "trace_method_name" will be logged.
209 "method-once"
210 Enable the method tracing feature.
213 during method execution of "trace_method_name" will be logged only once.
216 Enable the method tracing feature.
219 during method/opcode execution of "trace_method_name" will be logged.
221 "opcode-once"
222 Enable the method tracing feature.
225 during method/opcode execution of "trace_method_name" will be logged only
228 Note that, the difference between the "enable" and other feature
231 1. When "enable" is specified, since
233 method evaluations, after configuring "trace_state" to "enable",
235 2. When "method/opcode" is specified, if
238 apply to all control method evaluations.