^ sphinx.addnodesdocument)}( rawsource children]( translations
LanguagesNode)}(hhh](h pending_xref)}(hhh]docutils.nodesTextChinese (Simplified)}parenthsba
attributes}(ids]classes]names]dupnames]backrefs] refdomainstdreftypedoc reftarget6/translations/zh_CN/firmware-guide/acpi/method-tracingmodnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Traditional)}hh2sbah }(h ]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget6/translations/zh_TW/firmware-guide/acpi/method-tracingmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah }(h ]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget6/translations/it_IT/firmware-guide/acpi/method-tracingmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah }(h ]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget6/translations/ja_JP/firmware-guide/acpi/method-tracingmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah }(h ]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget6/translations/ko_KR/firmware-guide/acpi/method-tracingmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hPortuguese (Brazilian)}hhsbah }(h ]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget6/translations/pt_BR/firmware-guide/acpi/method-tracingmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah }(h ]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget6/translations/sp_SP/firmware-guide/acpi/method-tracingmodnameN classnameN refexplicituh1hhh ubeh }(h ]h ]h"]h$]h&]current_languageEnglishuh1h
hh _documenthsourceNlineNubhcomment)}(h SPDX-License-Identifier: GPL-2.0h]h SPDX-License-Identifier: GPL-2.0}hhsbah }(h ]h ]h"]h$]h&] xml:spacepreserveuh1hhhhhhP/var/lib/git/docbuild/linux/Documentation/firmware-guide/acpi/method-tracing.rsthKubh)}(h4This data file has been placed in the public domain.h]h4This data file has been placed in the public domain.}hhsbah }(h ]h ]h"]h$]h&]hhuh1hhhhhho/srv/docbuild/lib/venvs/build-kernel-docs/lib64/python3.9/site-packages/docutils/parsers/rst/include/isonum.txthKubh)}(hDerived from the Unicode character mappings available from
.
Processed by unicode2rstsubs.py, part of Docutils:
.h]hDerived from the Unicode character mappings available from
.
Processed by unicode2rstsubs.py, part of Docutils:
.}hhsbah }(h ]h ]h"]h$]h&]hhuh1hhhhhhhhKubhsubstitution_definition)}(h*.. |amp| unicode:: U+00026 .. AMPERSANDh]h&}hhsbah }(h ]h ]h"]ampah$]h&]uh1hhhhKhhhhubh)}(h+.. |apos| unicode:: U+00027 .. APOSTROPHEh]h'}hhsbah }(h ]h ]h"]aposah$]h&]uh1hhhhKhhhhubh)}(h).. |ast| unicode:: U+0002A .. ASTERISKh]h*}hj sbah }(h ]h ]h"]astah$]h&]uh1hhhhK hhhhubh)}(h+.. |brvbar| unicode:: U+000A6 .. BROKEN BARh]h¦}hj sbah }(h ]h ]h"]brvbarah$]h&]uh1hhhhK
hhhhubh)}(h0.. |bsol| unicode:: U+0005C .. REVERSE SOLIDUSh]h\}hj# sbah }(h ]h ]h"]bsolah$]h&]uh1hhhhK hhhhubh)}(h*.. |cent| unicode:: U+000A2 .. CENT SIGNh]h¢}hj2 sbah }(h ]h ]h"]centah$]h&]uh1hhhhK hhhhubh)}(h&.. |colon| unicode:: U+0003A .. COLONh]h:}hjA sbah }(h ]h ]h"]colonah$]h&]uh1hhhhK
hhhhubh)}(h&.. |comma| unicode:: U+0002C .. COMMAh]h,}hjP sbah }(h ]h ]h"]commaah$]h&]uh1hhhhKhhhhubh)}(h... |commat| unicode:: U+00040 .. COMMERCIAL ATh]h@}hj_ sbah }(h ]h ]h"]commatah$]h&]uh1hhhhKhhhhubh)}(h/.. |copy| unicode:: U+000A9 .. COPYRIGHT SIGNh]h©}hjn sbah }(h ]h ]h"]copyah$]h&]uh1hhhhKhhhhubh)}(h... |curren| unicode:: U+000A4 .. CURRENCY SIGNh]h¤}hj} sbah }(h ]h ]h"]currenah$]h&]uh1hhhhKhhhhubh)}(h0.. |darr| unicode:: U+02193 .. DOWNWARDS ARROWh]h↓}hj sbah }(h ]h ]h"]darrah$]h&]uh1hhhhKhhhhubh)}(h,.. |deg| unicode:: U+000B0 .. DEGREE SIGNh]h°}hj sbah }(h ]h ]h"]degah$]h&]uh1hhhhKhhhhubh)}(h... |divide| unicode:: U+000F7 .. DIVISION SIGNh]h÷}hj sbah }(h ]h ]h"]divideah$]h&]uh1hhhhKhhhhubh)}(h,.. |dollar| unicode:: U+00024 .. DOLLAR SIGNh]h$}hj sbah }(h ]h ]h"]dollarah$]h&]uh1hhhhKhhhhubh)}(h,.. |equals| unicode:: U+0003D .. EQUALS SIGNh]h=}hj sbah }(h ]h ]h"]equalsah$]h&]uh1hhhhKhhhhubh)}(h1.. |excl| unicode:: U+00021 .. EXCLAMATION MARKh]h!}hj sbah }(h ]h ]h"]exclah$]h&]uh1hhhhKhhhhubh)}(h9.. |frac12| unicode:: U+000BD .. VULGAR FRACTION ONE HALFh]h½}hj sbah }(h ]h ]h"]frac12ah$]h&]uh1hhhhKhhhhubh)}(h<.. |frac14| unicode:: U+000BC .. VULGAR FRACTION ONE QUARTERh]h¼}hj sbah }(h ]h ]h"]frac14ah$]h&]uh1hhhhKhhhhubh)}(h;.. |frac18| unicode:: U+0215B .. VULGAR FRACTION ONE EIGHTHh]h⅛}hj sbah }(h ]h ]h"]frac18ah$]h&]uh1hhhhKhhhhubh)}(h?.. |frac34| unicode:: U+000BE .. VULGAR FRACTION THREE QUARTERSh]h¾}hj sbah }(h ]h ]h"]frac34ah$]h&]uh1hhhhKhhhhubh)}(h>.. |frac38| unicode:: U+0215C .. VULGAR FRACTION THREE EIGHTHSh]h⅜}hj" sbah }(h ]h ]h"]frac38ah$]h&]uh1hhhhK hhhhubh)}(h=.. |frac58| unicode:: U+0215D .. VULGAR FRACTION FIVE EIGHTHSh]h⅝}hj1 sbah }(h ]h ]h"]frac58ah$]h&]uh1hhhhK hhhhubh)}(h>.. |frac78| unicode:: U+0215E .. VULGAR FRACTION SEVEN EIGHTHSh]h⅞}hj@ sbah }(h ]h ]h"]frac78ah$]h&]uh1hhhhK hhhhubh)}(h2.. |gt| unicode:: U+0003E .. GREATER-THAN SIGNh]h>}hjO sbah }(h ]h ]h"]gtah$]h&]uh1hhhhK hhhhubh)}(h9.. |half| unicode:: U+000BD .. VULGAR FRACTION ONE HALFh]h½}hj^ sbah }(h ]h ]h"]halfah$]h&]uh1hhhhK hhhhubh)}(h/.. |horbar| unicode:: U+02015 .. HORIZONTAL BARh]h―}hjm sbah }(h ]h ]h"]horbarah$]h&]uh1hhhhK!hhhhubh)}(h'.. |hyphen| unicode:: U+02010 .. HYPHENh]h‐}hj| sbah }(h ]h ]h"]hyphenah$]h&]uh1hhhhK"hhhhubh)}(h:.. |iexcl| unicode:: U+000A1 .. INVERTED EXCLAMATION MARKh]h¡}hj sbah }(h ]h ]h"]iexclah$]h&]uh1hhhhK#hhhhubh)}(h7.. |iquest| unicode:: U+000BF .. INVERTED QUESTION MARKh]h¿}hj sbah }(h ]h ]h"]iquestah$]h&]uh1hhhhK$hhhhubh)}(hJ.. |laquo| unicode:: U+000AB .. LEFT-POINTING DOUBLE ANGLE QUOTATION MARKh]h«}hj sbah }(h ]h ]h"]laquoah$]h&]uh1hhhhK%hhhhubh)}(h0.. |larr| unicode:: U+02190 .. LEFTWARDS ARROWh]h←}hj sbah }(h ]h ]h"]larrah$]h&]uh1hhhhK&hhhhubh)}(h3.. |lcub| unicode:: U+0007B .. LEFT CURLY BRACKETh]h{}hj sbah }(h ]h ]h"]lcubah$]h&]uh1hhhhK'hhhhubh)}(h;.. |ldquo| unicode:: U+0201C .. LEFT DOUBLE QUOTATION MARKh]h“}hj sbah }(h ]h ]h"]ldquoah$]h&]uh1hhhhK(hhhhubh)}(h).. |lowbar| unicode:: U+0005F .. LOW LINEh]h_}hj sbah }(h ]h ]h"]lowbarah$]h&]uh1hhhhK)hhhhubh)}(h1.. |lpar| unicode:: U+00028 .. LEFT PARENTHESISh]h(}hj sbah }(h ]h ]h"]lparah$]h&]uh1hhhhK*hhhhubh)}(h4.. |lsqb| unicode:: U+0005B .. LEFT SQUARE BRACKETh]h[}hj sbah }(h ]h ]h"]lsqbah$]h&]uh1hhhhK+hhhhubh)}(h;.. |lsquo| unicode:: U+02018 .. LEFT SINGLE QUOTATION MARKh]h‘}hj sbah }(h ]h ]h"]lsquoah$]h&]uh1hhhhK,hhhhubh)}(h/.. |lt| unicode:: U+0003C .. LESS-THAN SIGNh]h<}hj! sbah }(h ]h ]h"]ltah$]h&]uh1hhhhK-hhhhubh)}(h+.. |micro| unicode:: U+000B5 .. MICRO SIGNh]hµ}hj0 sbah }(h ]h ]h"]microah$]h&]uh1hhhhK.hhhhubh)}(h+.. |middot| unicode:: U+000B7 .. MIDDLE DOTh]h·}hj? sbah }(h ]h ]h"]middotah$]h&]uh1hhhhK/hhhhubh)}(h/.. |nbsp| unicode:: U+000A0 .. NO-BREAK SPACEh]h }hjN sbah }(h ]h ]h"]nbspah$]h&]uh1hhhhK0hhhhubh)}(h).. |not| unicode:: U+000AC .. NOT SIGNh]h¬}hj] sbah }(h ]h ]h"]notah$]h&]uh1hhhhK1hhhhubh)}(h,.. |num| unicode:: U+00023 .. NUMBER SIGNh]h#}hjl sbah }(h ]h ]h"]numah$]h&]uh1hhhhK2hhhhubh)}(h).. |ohm| unicode:: U+02126 .. OHM SIGNh]hΩ}hj{ sbah }(h ]h ]h"]ohmah$]h&]uh1hhhhK3hhhhubh)}(h;.. |ordf| unicode:: U+000AA .. FEMININE ORDINAL INDICATORh]hª}hj sbah }(h ]h ]h"]ordfah$]h&]uh1hhhhK4hhhhubh)}(h<.. |ordm| unicode:: U+000BA .. MASCULINE ORDINAL INDICATORh]hº}hj sbah }(h ]h ]h"]ordmah$]h&]uh1hhhhK5hhhhubh)}(h-.. |para| unicode:: U+000B6 .. PILCROW SIGNh]h¶}hj sbah }(h ]h ]h"]paraah$]h&]uh1hhhhK6hhhhubh)}(h-.. |percnt| unicode:: U+00025 .. PERCENT SIGNh]h%}hj sbah }(h ]h ]h"]percntah$]h&]uh1hhhhK7hhhhubh)}(h*.. |period| unicode:: U+0002E .. FULL STOPh]h.}hj sbah }(h ]h ]h"]periodah$]h&]uh1hhhhK8hhhhubh)}(h*.. |plus| unicode:: U+0002B .. PLUS SIGNh]h+}hj sbah }(h ]h ]h"]plusah$]h&]uh1hhhhK9hhhhubh)}(h0.. |plusmn| unicode:: U+000B1 .. PLUS-MINUS SIGNh]h±}hj sbah }(h ]h ]h"]plusmnah$]h&]uh1hhhhK:hhhhubh)}(h+.. |pound| unicode:: U+000A3 .. POUND SIGNh]h£}hj sbah }(h ]h ]h"]poundah$]h&]uh1hhhhK;hhhhubh)}(h... |quest| unicode:: U+0003F .. QUESTION MARKh]h?}hj sbah }(h ]h ]h"]questah$]h&]uh1hhhhKhhhhubh)}(h1.. |rarr| unicode:: U+02192 .. RIGHTWARDS ARROWh]h→}hj/ sbah }(h ]h ]h"]rarrah$]h&]uh1hhhhK?hhhhubh)}(h4.. |rcub| unicode:: U+0007D .. RIGHT CURLY BRACKETh]h}}hj> sbah }(h ]h ]h"]rcubah$]h&]uh1hhhhK@hhhhubh)}(h<.. |rdquo| unicode:: U+0201D .. RIGHT DOUBLE QUOTATION MARKh]h”}hjM sbah }(h ]h ]h"]rdquoah$]h&]uh1hhhhKAhhhhubh)}(h0.. |reg| unicode:: U+000AE .. REGISTERED SIGNh]h®}hj\ sbah }(h ]h ]h"]regah$]h&]uh1hhhhKBhhhhubh)}(h2.. |rpar| unicode:: U+00029 .. RIGHT PARENTHESISh]h)}hjk sbah }(h ]h ]h"]rparah$]h&]uh1hhhhKChhhhubh)}(h5.. |rsqb| unicode:: U+0005D .. RIGHT SQUARE BRACKETh]h]}hjz sbah }(h ]h ]h"]rsqbah$]h&]uh1hhhhKDhhhhubh)}(h<.. |rsquo| unicode:: U+02019 .. RIGHT SINGLE QUOTATION MARKh]h’}hj sbah }(h ]h ]h"]rsquoah$]h&]uh1hhhhKEhhhhubh)}(h-.. |sect| unicode:: U+000A7 .. SECTION SIGNh]h§}hj sbah }(h ]h ]h"]sectah$]h&]uh1hhhhKFhhhhubh)}(h*.. |semi| unicode:: U+0003B .. SEMICOLONh]h;}hj sbah }(h ]h ]h"]semiah$]h&]uh1hhhhKGhhhhubh)}(h,.. |shy| unicode:: U+000AD .. SOFT HYPHENh]h}hj sbah }(h ]h ]h"]shyah$]h&]uh1hhhhKHhhhhubh)}(h(.. |sol| unicode:: U+0002F .. SOLIDUSh]h/}hj sbah }(h ]h ]h"]solah$]h&]uh1hhhhKIhhhhubh)}(h,.. |sung| unicode:: U+0266A .. EIGHTH NOTEh]h♪}hj sbah }(h ]h ]h"]sungah$]h&]uh1hhhhKJhhhhubh)}(h0.. |sup1| unicode:: U+000B9 .. SUPERSCRIPT ONEh]h¹}hj sbah }(h ]h ]h"]sup1ah$]h&]uh1hhhhKKhhhhubh)}(h0.. |sup2| unicode:: U+000B2 .. SUPERSCRIPT TWOh]h²}hj sbah }(h ]h ]h"]sup2ah$]h&]uh1hhhhKLhhhhubh)}(h2.. |sup3| unicode:: U+000B3 .. SUPERSCRIPT THREEh]h³}hj sbah }(h ]h ]h"]sup3ah$]h&]uh1hhhhKMhhhhubh)}(h4.. |times| unicode:: U+000D7 .. MULTIPLICATION SIGNh]h×}hj sbah }(h ]h ]h"]timesah$]h&]uh1hhhhKNhhhhubh)}(h0.. |trade| unicode:: U+02122 .. TRADE MARK SIGNh]h™}hj sbah }(h ]h ]h"]tradeah$]h&]uh1hhhhKOhhhhubh)}(h... |uarr| unicode:: U+02191 .. UPWARDS ARROWh]h↑}hj. sbah }(h ]h ]h"]uarrah$]h&]uh1hhhhKPhhhhubh)}(h... |verbar| unicode:: U+0007C .. VERTICAL LINEh]h|}hj= sbah }(h ]h ]h"]verbarah$]h&]uh1hhhhKQhhhhubh)}(h*.. |yen| unicode:: U+000A5 .. YEN SIGN
h]h¥}hjL sbah }(h ]h ]h"]yenah$]h&]uh1hhhhKRhhhhubhsection)}(hhh](htitle)}(hACPICA Trace Facilityh]hACPICA Trace Facility}(hjb hhhNhNubah }(h ]h ]h"]h$]h&]uh1j` hj] hhhhhKubh
field_list)}(hhh](hfield)}(hhh](h
field_name)}(h Copyrighth]h Copyright}(hj| hhhNhNubah }(h ]h ]h"]h$]h&]uh1jz hjw hhhK ubh
field_body)}(h |copy| 2015, Intel Corporationh]h paragraph)}(hj h](h©}(hj hhhNhNubh 2015, Intel Corporation}(hj hhhNhNubeh }(h ]h ]h"]h$]h&]uh1j hhhKhj ubah }(h ]h ]h"]h$]h&]uh1j hjw ubeh }(h ]h ]h"]h$]h&]uh1ju hhhKhjr hhubjv )}(hhh](j{ )}(hAuthorh]hAuthor}(hj hhhNhNubah }(h ]h ]h"]h$]h&]uh1jz hj hhhK ubj )}(h Lv Zheng
h]j )}(h Lv Zheng h](h
Lv Zheng <}(hj hhhNhNubh reference)}(hlv.zheng@intel.comh]hlv.zheng@intel.com}(hj hhhNhNubah }(h ]h ]h"]h$]h&]refurimailto:lv.zheng@intel.comuh1j hj ubh>}(hj hhhNhNubeh }(h ]h ]h"]h$]h&]uh1j hhhK hj ubah }(h ]h ]h"]h$]h&]uh1j hj ubeh }(h ]h ]h"]h$]h&]uh1ju hhhK hjr hhubeh }(h ]h ]h"]h$]h&]uh1jp hj] hhhhhKubj\ )}(hhh](ja )}(hAbstracth]hAbstract}(hj hhhNhNubah }(h ]h ]h"]h$]h&]uh1j` hj hhhhhK
ubj )}(hXThis document describes the functions and the interfaces of the
method tracing facility.h]hXThis document describes the functions and the interfaces of the
method tracing facility.}(hj hhhNhNubah }(h ]h ]h"]h$]h&]uh1j hhhKhj hhubeh }(h ]abstractah ]h"]abstractah$]h&]uh1j[ hj] hhhhhK
ubj\ )}(hhh](ja )}(h"Functionalities and usage examplesh]h"Functionalities and usage examples}(hj$ hhhNhNubah }(h ]h ]h"]h$]h&]uh1j` hj! hhhhhKubj )}(hmACPICA provides method tracing capability. And two functions are
currently implemented using this capability.h]hmACPICA provides method tracing capability. And two functions are
currently implemented using this capability.}(hj2 hhhNhNubah }(h ]h ]h"]h$]h&]uh1j hhhKhj! hhubj\ )}(hhh](ja )}(h Log reducerh]h Log reducer}(hjC hhhNhNubah }(h ]h ]h"]h$]h&]uh1j` hj@ hhhhhKubj )}(hXx 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).h]hXx 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).}(hjQ hhhNhNubah }(h ]h ]h"]h$]h&]uh1j hhhKhj@ hhubj )}(hX 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.h]hX 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.}(hj_ hhhNhNubah }(h ]h ]h"]h$]h&]uh1j hhhK!hj@ hhubj )}(hWThe following command examples illustrate the usage of the "log reducer"
functionality:h]h[The following command examples illustrate the usage of the “log reducer”
functionality:}(hjm hhhNhNubah }(h ]h ]h"]h$]h&]uh1j hhhK(hj@ hhubhenumerated_list)}(hhh](h list_item)}(hFilter 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
h](j )}(hXFilter out the debug layer/level matched logs when control methods
are being evaluated::h]hWFilter out the debug layer/level matched logs when control methods
are being evaluated:}(hj hhhNhNubah }(h ]h ]h"]h$]h&]uh1j hhhK+hj ubh
literal_block)}(h# cd /sys/module/acpi/parameters
# echo "0xXXXXXXXX" > trace_debug_layer
# echo "0xYYYYYYYY" > trace_debug_level
# echo "enable" > trace_stateh]h# cd /sys/module/acpi/parameters
# echo "0xXXXXXXXX" > trace_debug_layer
# echo "0xYYYYYYYY" > trace_debug_level
# echo "enable" > trace_state}hj sbah }(h ]h ]h"]h$]h&]hhuh1j hhhK.hj ubeh }(h ]h ]h"]h$]h&]uh1j hj} hhhhhNubj )}(hXR 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
h](j )}(hdFilter out the debug layer/level matched logs when the specified
control method is being evaluated::h]hcFilter out the debug layer/level matched logs when the specified
control method is being evaluated:}(hj hhhNhNubah }(h ]h ]h"]h$]h&]uh1j hhhK3hj ubj )}(h# 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_stateh]h# 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}hj sbah }(h ]h ]h"]h$]h&]hhuh1j hhhK6hj ubeh }(h ]h ]h"]h$]h&]uh1j hj} hhhhhNubj )}(hXj 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
h](j )}(hwFilter out the debug layer/level matched logs when the specified
control method is being evaluated for the first time::h]hvFilter out the debug layer/level matched logs when the specified
control method is being evaluated for the first time:}(hj hhhNhNubah }(h ]h ]h"]h$]h&]uh1j hhhK trace_debug_layer
# echo "0xYYYYYYYY" > trace_debug_level
# echo "\PPPP.AAAA.TTTT.HHHH" > trace_method_name
# echo "method-once" > /sys/module/acpi/parameters/trace_stateh]h# 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}hj sbah }(h ]h ]h"]h$]h&]hhuh1j hhhK?hj ubeh }(h ]h ]h"]h$]h&]uh1j hj} hhhhhNubeh }(h ]h ]h"]h$]h&]enumtype
loweralphaprefixhsuffix.uh1j{ hj@ hhhhhK+ubhdefinition_list)}(hhh]hdefinition_list_item)}(hX Where:
0xXXXXXXXX/0xYYYYYYYY
Refer to Documentation/firmware-guide/acpi/debug.rst 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.
h](hterm)}(hWhere:h]hWhere:}(hj hhhNhNubah }(h ]h ]h"]h$]h&]uh1j hhhKKhj ubh
definition)}(hhh]j )}(hhh](j )}(hy0xXXXXXXXX/0xYYYYYYYY
Refer to Documentation/firmware-guide/acpi/debug.rst for possible debug layer/level
masking values.h](j
)}(h0xXXXXXXXX/0xYYYYYYYYh]h0xXXXXXXXX/0xYYYYYYYY}(hj( hhhNhNubah }(h ]h ]h"]h$]h&]uh1j hhhKGhj$ ubj )}(hhh]j )}(hcRefer to Documentation/firmware-guide/acpi/debug.rst for possible debug layer/level
masking values.h]hcRefer to Documentation/firmware-guide/acpi/debug.rst for possible debug layer/level
masking values.}(hj9 hhhNhNubah }(h ]h ]h"]h$]h&]uh1j hhhKGhj6 ubah }(h ]h ]h"]h$]h&]uh1j hj$ ubeh }(h ]h ]h"]h$]h&]uh1j hhhKGhj! ubj )}(h\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.
h](j
)}(h\PPPP.AAAA.TTTT.HHHHh]h PPPP.AAAA.TTTT.HHHH}(hjW hhhNhNubah }(h ]h ]h"]h$]h&]uh1j hhhKKhjS ubj )}(hhh]j )}(h}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.h]hFull path of a control method that can be found in the ACPI namespace.
It needn’t be an entry of a control method evaluation.}(hjh hhhNhNubah }(h ]h ]h"]h$]h&]uh1j hhhKJhje ubah }(h ]h ]h"]h$]h&]uh1j hjS ubeh }(h ]h ]h"]h$]h&]uh1j hhhKKhj! ubeh }(h ]h ]h"]h$]h&]uh1j hj ubah }(h ]h ]h"]h$]h&]uh1j hj ubeh }(h ]h ]h"]h$]h&]uh1j hhhKKhj ubah }(h ]h ]h"]h$]h&]uh1j hj@ hhhNhNubeh }(h ] log-reducerah ]h"] log reducerah$]h&]uh1j[ hj! hhhhhKubj\ )}(hhh](ja )}(h
AML tracerh]h
AML tracer}(hj hhhNhNubah }(h ]h ]h"]h$]h&]uh1j` hj hhhhhKNubj )}(hThere 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::h]hThere 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:}(hj hhhNhNubah }(h ]h ]h"]h$]h&]uh1j hhhKPhj hhubj )}(hX[ [ 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.h]hX[ [ 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.}hj sbah }(h ]h ]h"]h$]h&]hhuh1j hhhKUhj hhubj )}(hX) Developers can utilize these special log entries to track the AML
interpretation, 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.h]hX1 Developers can utilize these special log entries to track the AML
interpretation, 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.}(hj hhhNhNubah }(h ]h ]h"]h$]h&]uh1j hhhKdhj hhubj )}(hVThe following command examples illustrate the usage of the "AML tracer"
functionality:h]hZThe following command examples illustrate the usage of the “AML tracer”
functionality:}(hj hhhNhNubah }(h ]h ]h"]h$]h&]uh1j hhhKjhj hhubj| )}(hhh](j )}(hFilter 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
h](j )}(h]Filter out the method start/stop "AML tracer" logs when control
methods are being evaluated::h]h`Filter out the method start/stop “AML tracer” logs when control
methods are being evaluated:}(hj hhhNhNubah }(h ]h ]h"]h$]h&]uh1j hhhKmhj ubj )}(h# cd /sys/module/acpi/parameters
# echo "0x80" > trace_debug_layer
# echo "0x10" > trace_debug_level
# echo "enable" > trace_stateh]h# cd /sys/module/acpi/parameters
# echo "0x80" > trace_debug_layer
# echo "0x10" > trace_debug_level
# echo "enable" > trace_state}hj sbah }(h ]h ]h"]h$]h&]hhuh1j hhhKphj ubeh }(h ]h ]h"]h$]h&]uh1j hj hhhhhNubj )}(hX* 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
h](j )}(hdFilter out the method start/stop "AML tracer" when the specified
control method is being evaluated::h]hgFilter out the method start/stop “AML tracer” when the specified
control method is being evaluated:}(hj hhhNhNubah }(h ]h ]h"]h$]h&]uh1j hhhKuhj ubj )}(h# 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_stateh]h# 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}hj& sbah }(h ]h ]h"]h$]h&]hhuh1j hhhKxhj ubeh }(h ]h ]h"]h$]h&]uh1j hj hhhhhNubj )}(hXG 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
h](j )}(h|Filter out the method start/stop "AML tracer" logs when the specified
control method is being evaluated for the first time::h]hFilter out the method start/stop “AML tracer” logs when the specified
control method is being evaluated for the first time:}(hj> hhhNhNubah }(h ]h ]h"]h$]h&]uh1j hhhK~hj: ubj )}(h# 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_stateh]h# 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}hjL sbah }(h ]h ]h"]h$]h&]hhuh1j hhhKhj: ubeh }(h ]h ]h"]h$]h&]uh1j hj hhhhhNubj )}(hX1 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
h](j )}(hkFilter out the method/opcode start/stop "AML tracer" when the
specified control method is being evaluated::h]hnFilter out the method/opcode start/stop “AML tracer” when the
specified control method is being evaluated:}(hjd hhhNhNubah }(h ]h ]h"]h$]h&]uh1j hhhKhj` ubj )}(h# 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_stateh]h# 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}hjr sbah }(h ]h ]h"]h$]h&]hhuh1j hhhKhj` ubeh }(h ]h ]h"]h$]h&]uh1j hj hhhhhNubj )}(hXK 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
h](j )}(h~Filter out the method/opcode start/stop "AML tracer" when the
specified control method is being evaluated for the first time::h]hFilter out the method/opcode start/stop “AML tracer” when the
specified control method is being evaluated for the first time:}(hj hhhNhNubah }(h ]h ]h"]h$]h&]uh1j hhhKhj ubj )}(h# 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_stateh]h# 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}hj sbah }(h ]h ]h"]h$]h&]hhuh1j hhhKhj ubeh }(h ]h ]h"]h$]h&]uh1j hj hhhhhNubeh }(h ]h ]h"]h$]h&]j j j hj j uh1j{ hj hhhhhKmubj )}(hwNote that all above method tracing facility related module parameters can
be used as the boot parameters, for example::h]hvNote that all above method tracing facility related module parameters can
be used as the boot parameters, for example:}(hj hhhNhNubah }(h ]h ]h"]h$]h&]uh1j hhhKhj hhubj )}(h|acpi.trace_debug_layer=0x80 acpi.trace_debug_level=0x10 \
acpi.trace_method_name=\_SB.LID0._LID acpi.trace_state=opcode-onceh]h|acpi.trace_debug_layer=0x80 acpi.trace_debug_level=0x10 \
acpi.trace_method_name=\_SB.LID0._LID acpi.trace_state=opcode-once}hj sbah }(h ]h ]h"]h$]h&]hhuh1j hhhKhj hhubeh }(h ]
aml-tracerah ]h"]
aml tracerah$]h&]uh1j[ hj! hhhhhKNubeh }(h ]"functionalities-and-usage-examplesah ]h"]"functionalities and usage examplesah$]h&]uh1j[ hj] hhhhhKubj\ )}(hhh](ja )}(hInterface descriptionsh]hInterface descriptions}(hj hhhNhNubah }(h ]h ]h"]h$]h&]uh1j` hj hhhhhKubj )}(h~All method tracing functions can be configured via ACPI module
parameters that are accessible at /sys/module/acpi/parameters/:h]h~All method tracing functions can be configured via ACPI module
parameters that are accessible at /sys/module/acpi/parameters/:}(hj hhhNhNubah }(h ]h ]h"]h$]h&]uh1j hhhKhj hhubj )}(hhh](j )}(htrace_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.
h](j
)}(htrace_method_nameh]htrace_method_name}(hj hhhNhNubah }(h ]h ]h"]h$]h&]uh1j hhhKhj ubj )}(hhh](j )}(h=The full path of the AML method that the user wants to trace.h]h=The full path of the AML method that the user wants to trace.}(hj hhhNhNubah }(h ]h ]h"]h$]h&]uh1j hhhKhj ubj )}(h~Note that the full path shouldn't contain the trailing "_"s in its
name segments but may contain "\" to form an absolute path.h]hNote that the full path shouldn’t contain the trailing “_”s in its
name segments but may contain “ " to form an absolute path.}(hj# hhhNhNubah }(h ]h ]h"]h$]h&]uh1j hhhKhj ubeh }(h ]h ]h"]h$]h&]uh1j hj ubeh }(h ]h ]h"]h$]h&]uh1j hhhKhj ubj )}(htrace_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.
h](j
)}(htrace_debug_layerh]htrace_debug_layer}(hjA hhhNhNubah }(h ]h ]h"]h$]h&]uh1j hhhKhj= ubj )}(hhh](j )}(hCThe temporary debug_layer used when the tracing feature is enabled.h]hCThe temporary debug_layer used when the tracing feature is enabled.}(hjR hhhNhNubah }(h ]h ]h"]h$]h&]uh1j hhhKhjO ubj )}(hdUsing ACPI_EXECUTER (0x80) by default, which is the debug_layer
used to match all "AML tracer" logs.h]hhUsing ACPI_EXECUTER (0x80) by default, which is the debug_layer
used to match all “AML tracer” logs.}(hj` hhhNhNubah }(h ]h ]h"]h$]h&]uh1j hhhKhjO ubeh }(h ]h ]h"]h$]h&]uh1j hj= ubeh }(h ]h ]h"]h$]h&]uh1j hhhKhj hhubj )}(htrace_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.
h](j
)}(htrace_debug_levelh]htrace_debug_level}(hj~ hhhNhNubah }(h ]h ]h"]h$]h&]uh1j hhhKhjz ubj )}(hhh](j )}(hCThe temporary debug_level used when the tracing feature is enabled.h]hCThe temporary debug_level used when the tracing feature is enabled.}(hj hhhNhNubah }(h ]h ]h"]h$]h&]uh1j hhhKhj ubj )}(hjUsing ACPI_LV_TRACE_POINT (0x10) by default, which is the
debug_level used to match all "AML tracer" logs.h]hnUsing ACPI_LV_TRACE_POINT (0x10) by default, which is the
debug_level used to match all “AML tracer” logs.}(hj hhhNhNubah }(h ]h ]h"]h$]h&]uh1j hhhKhj ubeh }(h ]h ]h"]h$]h&]uh1j hjz ubeh }(h ]h ]h"]h$]h&]uh1j hhhKhj hhubj )}(htrace_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
h](j
)}(h trace_stateh]h trace_state}(hj hhhNhNubah }(h ]h ]h"]h$]h&]uh1j hhhKhj ubj )}(hhh](j )}(h"The status of the tracing feature.h]h"The status of the tracing feature.}(hj hhhNhNubah }(h ]h ]h"]h$]h&]uh1j hhhKhj ubj )}(hXUsers can enable/disable this debug tracing feature by executing
the following command::h]hWUsers can enable/disable this debug tracing feature by executing
the following command:}(hj hhhNhNubah }(h ]h ]h"]h$]h&]uh1j hhhKhj ubj )}(h7# echo string > /sys/module/acpi/parameters/trace_stateh]h7# echo string > /sys/module/acpi/parameters/trace_state}hj sbah }(h ]h ]h"]h$]h&]hhuh1j hhhKhj ubeh }(h ]h ]h"]h$]h&]uh1j hj ubeh }(h ]h ]h"]h$]h&]uh1j hhhKhj hhubeh }(h ]h ]h"]h$]h&]uh1j hj hhhhhNubj )}(h.Where "string" should be one of the following:h]h2Where “string” should be one of the following:}(hj
hhhNhNubah }(h ]h ]h"]h$]h&]uh1j hhhKhj hhubj )}(hhh](j )}(h."disable"
Disable the method tracing feature.
h](j
)}(h "disable"h]h
“disable”}(hj
hhhNhNubah }(h ]h ]h"]h$]h&]uh1j hhhKhj
ubj )}(hhh]j )}(h#Disable the method tracing feature.h]h#Disable the method tracing feature.}(hj.
hhhNhNubah }(h ]h ]h"]h$]h&]uh1j hhhKhj+
ubah }(h ]h ]h"]h$]h&]uh1j hj
ubeh }(h ]h ]h"]h$]h&]uh1j hhhKhj
ubj )}(h"enable"
Enable the method tracing feature.
ACPICA debugging messages matching "trace_debug_layer/trace_debug_level"
during any method execution will be logged.
h](j
)}(h"enable"h]h “enable”}(hjL
hhhNhNubah }(h ]h ]h"]h$]h&]uh1j hhhKhjH
ubj )}(hhh](j )}(h"Enable the method tracing feature.h]h"Enable the method tracing feature.}(hj]
hhhNhNubah }(h ]h ]h"]h$]h&]uh1j hhhKhjZ
ubj )}(htACPICA debugging messages matching "trace_debug_layer/trace_debug_level"
during any method execution will be logged.h]hxACPICA debugging messages matching “trace_debug_layer/trace_debug_level”
during any method execution will be logged.}(hjk
hhhNhNubah }(h ]h ]h"]h$]h&]uh1j hhhKhjZ
ubeh }(h ]h ]h"]h$]h&]uh1j hjH
ubeh }(h ]h ]h"]h$]h&]uh1j hhhKhj
hhubj )}(h"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.
h](j
)}(h"method"h]h “method”}(hj
hhhNhNubah }(h ]h ]h"]h$]h&]uh1j hhhKhj
ubj )}(hhh](j )}(h"Enable the method tracing feature.h]h"Enable the method tracing feature.}(hj
hhhNhNubah }(h ]h ]h"]h$]h&]uh1j hhhKhj
ubj )}(hACPICA debugging messages matching "trace_debug_layer/trace_debug_level"
during method execution of "trace_method_name" will be logged.h]hACPICA debugging messages matching “trace_debug_layer/trace_debug_level”
during method execution of “trace_method_name” will be logged.}(hj
hhhNhNubah }(h ]h ]h"]h$]h&]uh1j hhhKhj
ubeh }(h ]h ]h"]h$]h&]uh1j hj
ubeh }(h ]h ]h"]h$]h&]uh1j hhhKhj
hhubj )}(h"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.
h](j
)}(h
"method-once"h]h“method-once”}(hj
hhhNhNubah }(h ]h ]h"]h$]h&]uh1j hhhKhj
ubj )}(hhh](j )}(h"Enable the method tracing feature.h]h"Enable the method tracing feature.}(hj
hhhNhNubah }(h ]h ]h"]h$]h&]uh1j hhhKhj
ubj )}(hACPICA debugging messages matching "trace_debug_layer/trace_debug_level"
during method execution of "trace_method_name" will be logged only once.h]hACPICA debugging messages matching “trace_debug_layer/trace_debug_level”
during method execution of “trace_method_name” will be logged only once.}(hj
hhhNhNubah }(h ]h ]h"]h$]h&]uh1j hhhKhj
ubeh }(h ]h ]h"]h$]h&]uh1j hj
ubeh }(h ]h ]h"]h$]h&]uh1j hhhKhj
hhubj )}(h"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.
h](j
)}(h"opcode"h]h “opcode”}(hj hhhNhNubah }(h ]h ]h"]h$]h&]uh1j hhhKhj
ubj )}(hhh](j )}(h"Enable the method tracing feature.h]h"Enable the method tracing feature.}(hj hhhNhNubah }(h ]h ]h"]h$]h&]uh1j hhhKhj ubj )}(hACPICA debugging messages matching "trace_debug_layer/trace_debug_level"
during method/opcode execution of "trace_method_name" will be logged.h]hACPICA debugging messages matching “trace_debug_layer/trace_debug_level”
during method/opcode execution of “trace_method_name” will be logged.}(hj" hhhNhNubah }(h ]h ]h"]h$]h&]uh1j hhhKhj ubeh }(h ]h ]h"]h$]h&]uh1j hj
ubeh }(h ]h ]h"]h$]h&]uh1j hhhKhj
hhubj )}(h"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.
h](j
)}(h
"opcode-once"h]h“opcode-once”}(hj@ hhhNhNubah }(h ]h ]h"]h$]h&]uh1j hhhKhj< ubj )}(hhh](j )}(h"Enable the method tracing feature.h]h"Enable the method tracing feature.}(hjQ hhhNhNubah }(h ]h ]h"]h$]h&]uh1j hhhKhjN ubj )}(hACPICA debugging messages matching "trace_debug_layer/trace_debug_level"
during method/opcode execution of "trace_method_name" will be logged only
once.h]hACPICA debugging messages matching “trace_debug_layer/trace_debug_level”
during method/opcode execution of “trace_method_name” will be logged only
once.}(hj_ hhhNhNubah }(h ]h ]h"]h$]h&]uh1j hhhKhjN ubeh }(h ]h ]h"]h$]h&]uh1j hj< ubeh }(h ]h ]h"]h$]h&]uh1j hhhKhj
hhubeh }(h ]h ]h"]h$]h&]uh1j hj hhhhhNubj )}(hVNote that, the difference between the "enable" and other feature
enabling options are:h]hZNote that, the difference between the “enable” and other feature
enabling options are:}(hj hhhNhNubah }(h ]h ]h"]h$]h&]uh1j hhhKhj hhubj| )}(hhh](j )}(hWhen "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.h]j )}(hWhen "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.h]hWhen “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.}(hj hhhNhNubah }(h ]h ]h"]h$]h&]uh1j hhhKhj ubah }(h ]h ]h"]h$]h&]uh1j hj hhhhhNubj )}(hWhen "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.h]j )}(hWhen "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.h]hWhen “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.}(hj hhhNhNubah }(h ]h ]h"]h$]h&]uh1j hhhKhj ubah }(h ]h ]h"]h$]h&]uh1j hj hhhhhNubeh }(h ]h ]h"]h$]h&]j arabicj hj j uh1j{ hj hhhhhKubeh }(h ]interface-descriptionsah ]h"]interface descriptionsah$]h&]uh1j[ hj] hhhhhKubeh }(h ]acpica-trace-facilityah ]h"]acpica trace facilityah$]h&]uh1j[ hhhhhhhKubeh }(h ]h ]h"]h$]h&]sourcehuh1hcurrent_sourceN current_lineNsettingsdocutils.frontendValues)}(j` N generatorN datestampN source_linkN
source_urlN
toc_backlinksentryfootnote_backlinksK
sectnum_xformKstrip_commentsNstrip_elements_with_classesN
strip_classesN report_levelK
halt_levelKexit_status_levelKdebugNwarning_streamN tracebackinput_encoding utf-8-sig input_encoding_error_handlerstrictoutput_encodingutf-8 output_encoding_error_handlerj error_encodingutf-8 error_encoding_error_handlerbackslashreplace
language_codeenrecord_dependenciesNconfigN id_prefixhauto_id_prefixid
dump_settingsNdump_internalsNdump_transformsNdump_pseudo_xmlNexpose_internalsNstrict_visitorN_disable_configN_sourcehnj _destinationN
_config_files]7/var/lib/git/docbuild/linux/Documentation/docutils.confafile_insertion_enabled raw_enabledKline_length_limitM'pep_referencesN pep_base_urlhttps://peps.python.org/pep_file_url_templatepep-%04drfc_referencesN rfc_base_url&https://datatracker.ietf.org/doc/html/ tab_widthK trim_footnote_reference_spacesyntax_highlightlong smart_quotessmartquotes_locales] character_level_inline_markupdoctitle_xform
docinfo_xformKsectsubtitle_xform
image_loadinglinkembed_stylesheetcloak_email_addressessection_self_linkenvNubreporterNindirect_targets]substitution_defs}(hhj hj j j j j/ j# j> j2 jM jA j\ jP jk j_ jz jn j j} j j j j j j j j j j j j j j j j j j j j j. j" j= j1 jL j@ j[ jO jj j^ jy jm j j| j j j j j j j j j j j j j j j j j j j j j- j! j< j0 jK j? jZ jN ji j] jx jl j j{ j j j j j j j j j j j j j j j j j j j j j, j j; j/ jJ j> jY jM jh j\ jw jk j jz j j j j j j j j j j j j j j j j j
j j j j+ j j: j. jI j= jX jL usubstitution_names}(amphaposj astj brvbarj bsolj/ centj> colonjM commaj\ commatjk copyjz currenj darrj degj dividej dollarj equalsj exclj frac12j frac14j frac18j frac34j frac38j. frac58j= frac78jL gtj[ halfjj horbarjy hyphenj iexclj iquestj laquoj larrj lcubj ldquoj lowbarj lparj lsqbj lsquoj ltj- microj< middotjK nbspjZ notji numjx ohmj ordfj ordmj paraj percntj periodj plusj plusmnj poundj questj quotj raquoj, rarrj; rcubjJ rdquojY regjh rparjw rsqbj rsquoj sectj semij shyj solj sungj sup1j sup2j sup3j
timesj tradej+ uarrj: verbarjI yenjX urefnames}refids}nameids}(j j j j j j j j j j j j u nametypes}(j j j j j j uh }(j j] j j j j! j j@ j j j j u
footnote_refs}
citation_refs}
autofootnotes]autofootnote_refs]symbol_footnotes]symbol_footnote_refs] footnotes] citations]autofootnote_startKsymbol_footnote_startK
id_counter collectionsCounter}Rparse_messages]transform_messages] transformerN include_log]4Documentation/firmware-guide/acpi/method-tracing.rst(NNNNta
decorationNhhub.