^sphinx.addnodesdocument)}( rawsourcechildren]( 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*}hjsbah}(h]h ]h"]astah$]h&]uh1hhhhK hhhhubh)}(h+.. |brvbar| unicode:: U+000A6 .. BROKEN BARh]h¦}hjsbah}(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¢}hj2sbah}(h]h ]h"]centah$]h&]uh1hhhhK hhhhubh)}(h&.. |colon| unicode:: U+0003A .. COLONh]h:}hjAsbah}(h]h ]h"]colonah$]h&]uh1hhhhK hhhhubh)}(h&.. |comma| unicode:: U+0002C .. COMMAh]h,}hjPsbah}(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©}hjnsbah}(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↓}hjsbah}(h]h ]h"]darrah$]h&]uh1hhhhKhhhhubh)}(h,.. |deg| unicode:: U+000B0 .. DEGREE SIGNh]h°}hjsbah}(h]h ]h"]degah$]h&]uh1hhhhKhhhhubh)}(h... |divide| unicode:: U+000F7 .. DIVISION SIGNh]h÷}hjsbah}(h]h ]h"]divideah$]h&]uh1hhhhKhhhhubh)}(h,.. |dollar| unicode:: U+00024 .. DOLLAR SIGNh]h$}hjsbah}(h]h ]h"]dollarah$]h&]uh1hhhhKhhhhubh)}(h,.. |equals| unicode:: U+0003D .. EQUALS SIGNh]h=}hjsbah}(h]h ]h"]equalsah$]h&]uh1hhhhKhhhhubh)}(h1.. |excl| unicode:: U+00021 .. EXCLAMATION MARKh]h!}hjsbah}(h]h ]h"]exclah$]h&]uh1hhhhKhhhhubh)}(h9.. |frac12| unicode:: U+000BD .. VULGAR FRACTION ONE HALFh]h½}hjsbah}(h]h ]h"]frac12ah$]h&]uh1hhhhKhhhhubh)}(h<.. |frac14| unicode:: U+000BC .. VULGAR FRACTION ONE QUARTERh]h¼}hjsbah}(h]h ]h"]frac14ah$]h&]uh1hhhhKhhhhubh)}(h;.. |frac18| unicode:: U+0215B .. VULGAR FRACTION ONE EIGHTHh]h⅛}hjsbah}(h]h ]h"]frac18ah$]h&]uh1hhhhKhhhhubh)}(h?.. |frac34| unicode:: U+000BE .. VULGAR FRACTION THREE QUARTERSh]h¾}hjsbah}(h]h ]h"]frac34ah$]h&]uh1hhhhKhhhhubh)}(h>.. |frac38| unicode:: U+0215C .. VULGAR FRACTION THREE EIGHTHSh]h⅜}hj"sbah}(h]h ]h"]frac38ah$]h&]uh1hhhhKhhhhubh)}(h=.. |frac58| unicode:: U+0215D .. VULGAR FRACTION FIVE EIGHTHSh]h⅝}hj1sbah}(h]h ]h"]frac58ah$]h&]uh1hhhhKhhhhubh)}(h>.. |frac78| unicode:: U+0215E .. VULGAR FRACTION SEVEN EIGHTHSh]h⅞}hj@sbah}(h]h ]h"]frac78ah$]h&]uh1hhhhKhhhhubh)}(h2.. |gt| unicode:: U+0003E .. GREATER-THAN SIGNh]h>}hjOsbah}(h]h ]h"]gtah$]h&]uh1hhhhKhhhhubh)}(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―}hjmsbah}(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¡}hjsbah}(h]h ]h"]iexclah$]h&]uh1hhhhK#hhhhubh)}(h7.. |iquest| unicode:: U+000BF .. INVERTED QUESTION MARKh]h¿}hjsbah}(h]h ]h"]iquestah$]h&]uh1hhhhK$hhhhubh)}(hJ.. |laquo| unicode:: U+000AB .. LEFT-POINTING DOUBLE ANGLE QUOTATION MARKh]h«}hjsbah}(h]h ]h"]laquoah$]h&]uh1hhhhK%hhhhubh)}(h0.. |larr| unicode:: U+02190 .. LEFTWARDS ARROWh]h←}hjsbah}(h]h ]h"]larrah$]h&]uh1hhhhK&hhhhubh)}(h3.. |lcub| unicode:: U+0007B .. LEFT CURLY BRACKETh]h{}hjsbah}(h]h ]h"]lcubah$]h&]uh1hhhhK'hhhhubh)}(h;.. |ldquo| unicode:: U+0201C .. LEFT DOUBLE QUOTATION MARKh]h“}hjsbah}(h]h ]h"]ldquoah$]h&]uh1hhhhK(hhhhubh)}(h).. |lowbar| unicode:: U+0005F .. LOW LINEh]h_}hjsbah}(h]h ]h"]lowbarah$]h&]uh1hhhhK)hhhhubh)}(h1.. |lpar| unicode:: U+00028 .. LEFT PARENTHESISh]h(}hjsbah}(h]h ]h"]lparah$]h&]uh1hhhhK*hhhhubh)}(h4.. |lsqb| unicode:: U+0005B .. LEFT SQUARE BRACKETh]h[}hjsbah}(h]h ]h"]lsqbah$]h&]uh1hhhhK+hhhhubh)}(h;.. |lsquo| unicode:: U+02018 .. LEFT SINGLE QUOTATION MARKh]h‘}hjsbah}(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µ}hj0sbah}(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 }hjNsbah}(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#}hjlsbah}(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ª}hjsbah}(h]h ]h"]ordfah$]h&]uh1hhhhK4hhhhubh)}(h<.. |ordm| unicode:: U+000BA .. MASCULINE ORDINAL INDICATORh]hº}hjsbah}(h]h ]h"]ordmah$]h&]uh1hhhhK5hhhhubh)}(h-.. |para| unicode:: U+000B6 .. PILCROW SIGNh]h¶}hjsbah}(h]h ]h"]paraah$]h&]uh1hhhhK6hhhhubh)}(h-.. |percnt| unicode:: U+00025 .. PERCENT SIGNh]h%}hjsbah}(h]h ]h"]percntah$]h&]uh1hhhhK7hhhhubh)}(h*.. |period| unicode:: U+0002E .. FULL STOPh]h.}hjsbah}(h]h ]h"]periodah$]h&]uh1hhhhK8hhhhubh)}(h*.. |plus| unicode:: U+0002B .. PLUS SIGNh]h+}hjsbah}(h]h ]h"]plusah$]h&]uh1hhhhK9hhhhubh)}(h0.. |plusmn| unicode:: U+000B1 .. PLUS-MINUS SIGNh]h±}hjsbah}(h]h ]h"]plusmnah$]h&]uh1hhhhK:hhhhubh)}(h+.. |pound| unicode:: U+000A3 .. POUND SIGNh]h£}hjsbah}(h]h ]h"]poundah$]h&]uh1hhhhK;hhhhubh)}(h... |quest| unicode:: U+0003F .. QUESTION MARKh]h?}hjsbah}(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”}hjMsbah}(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)}hjksbah}(h]h ]h"]rparah$]h&]uh1hhhhKChhhhubh)}(h5.. |rsqb| unicode:: U+0005D .. RIGHT SQUARE BRACKETh]h]}hjzsbah}(h]h ]h"]rsqbah$]h&]uh1hhhhKDhhhhubh)}(h<.. |rsquo| unicode:: U+02019 .. RIGHT SINGLE QUOTATION MARKh]h’}hjsbah}(h]h ]h"]rsquoah$]h&]uh1hhhhKEhhhhubh)}(h-.. |sect| unicode:: U+000A7 .. SECTION SIGNh]h§}hjsbah}(h]h ]h"]sectah$]h&]uh1hhhhKFhhhhubh)}(h*.. |semi| unicode:: U+0003B .. SEMICOLONh]h;}hjsbah}(h]h ]h"]semiah$]h&]uh1hhhhKGhhhhubh)}(h,.. |shy| unicode:: U+000AD .. SOFT HYPHENh]h­}hjsbah}(h]h ]h"]shyah$]h&]uh1hhhhKHhhhhubh)}(h(.. |sol| unicode:: U+0002F .. SOLIDUSh]h/}hjsbah}(h]h ]h"]solah$]h&]uh1hhhhKIhhhhubh)}(h,.. |sung| unicode:: U+0266A .. EIGHTH NOTEh]h♪}hjsbah}(h]h ]h"]sungah$]h&]uh1hhhhKJhhhhubh)}(h0.. |sup1| unicode:: U+000B9 .. SUPERSCRIPT ONEh]h¹}hjsbah}(h]h ]h"]sup1ah$]h&]uh1hhhhKKhhhhubh)}(h0.. |sup2| unicode:: U+000B2 .. SUPERSCRIPT TWOh]h²}hjsbah}(h]h ]h"]sup2ah$]h&]uh1hhhhKLhhhhubh)}(h2.. |sup3| unicode:: U+000B3 .. SUPERSCRIPT THREEh]h³}hjsbah}(h]h ]h"]sup3ah$]h&]uh1hhhhKMhhhhubh)}(h4.. |times| unicode:: U+000D7 .. MULTIPLICATION SIGNh]h×}hjsbah}(h]h ]h"]timesah$]h&]uh1hhhhKNhhhhubh)}(h0.. |trade| unicode:: U+02122 .. TRADE MARK SIGNh]h™}hjsbah}(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¥}hjLsbah}(h]h ]h"]yenah$]h&]uh1hhhhKRhhhhubhsection)}(hhh](htitle)}(hACPICA Trace Facilityh]hACPICA Trace Facility}(hjbhhhNhNubah}(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&]uh1jzhjwhhhKubh field_body)}(h|copy| 2015, Intel Corporationh]h paragraph)}(hjh](h©}(hjhhhNhNubh 2015, Intel Corporation}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjwubeh}(h]h ]h"]h$]h&]uh1juhhhKhjrhhubjv)}(hhh](j{)}(hAuthorh]hAuthor}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jzhjhhhKubj)}(hLv Zheng h]j)}(hLv Zheng h](h Lv Zheng <}(hjhhhNhNubh reference)}(hlv.zheng@intel.comh]hlv.zheng@intel.com}(hjhhhNhNubah}(h]h ]h"]h$]h&]refurimailto:lv.zheng@intel.comuh1jhjubh>}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jhhhK hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1juhhhK hjrhhubeh}(h]h ]h"]h$]h&]uh1jphj]hhhhhKubj\)}(hhh](ja)}(hAbstracth]hAbstract}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j`hjhhhhhK 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&]uh1jhhhKhjhhubeh}(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.}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jhhhKhj!hhubj\)}(hhh](ja)}(h Log reducerh]h Log reducer}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1j`hj@hhhhhKubj)}(hXxACPICA 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]hXxACPICA 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).}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jhhhKhj@hhubj)}(hXBut 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]hXBut 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&]uh1jhhhK!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:}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1jhhhK(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:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhhhK+hjubh 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}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhK.hjubeh}(h]h ]h"]h$]h&]uh1jhj}hhhhhNubj)}(hXRFilter 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:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhhhK3hjubj)}(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}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhK6hjubeh}(h]h ]h"]h$]h&]uh1jhj}hhhhhNubj)}(hXjFilter 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:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhhhK 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}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhK?hjubeh}(h]h ]h"]h$]h&]uh1jhj}hhhhhNubeh}(h]h ]h"]h$]h&]enumtype loweralphaprefixhsuffix.uh1j{hj@hhhhhK+ubhdefinition_list)}(hhh]hdefinition_list_item)}(hXWhere: 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:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j hhhKKhjubh 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.}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1jhhhKGhj6ubah}(h]h ]h"]h$]h&]uh1jhj$ubeh}(h]h ]h"]h$]h&]uh1jhhhKGhj!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]hPPPP.AAAA.TTTT.HHHH}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1j hhhKKhjSubj)}(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.}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1jhhhKJhjeubah}(h]h ]h"]h$]h&]uh1jhjSubeh}(h]h ]h"]h$]h&]uh1jhhhKKhj!ubeh}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhhhKKhjubah}(h]h ]h"]h$]h&]uh1jhj@hhhNhNubeh}(h] log-reducerah ]h"] log reducerah$]h&]uh1j[hj!hhhhhKubj\)}(hhh](ja)}(h AML tracerh]h AML tracer}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j`hjhhhhhKNubj)}(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:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhhhKPhjhhubj)}(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.}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhKUhjhhubj)}(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]hX1Developers 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.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhhhKdhjhhubj)}(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:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhhhKjhjhhubj|)}(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:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhhhKmhjubj)}(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}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhKphjubeh}(h]h ]h"]h$]h&]uh1jhjhhhhhNubj)}(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:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhhhKuhjubj)}(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&]hhuh1jhhhKxhjubeh}(h]h ]h"]h$]h&]uh1jhjhhhhhNubj)}(hXGFilter 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&]uh1jhhhK~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}hjLsbah}(h]h ]h"]h$]h&]hhuh1jhhhKhj:ubeh}(h]h ]h"]h$]h&]uh1jhjhhhhhNubj)}(hX1Filter 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:}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1jhhhKhj`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}hjrsbah}(h]h ]h"]h$]h&]hhuh1jhhhKhj`ubeh}(h]h ]h"]h$]h&]uh1jhjhhhhhNubj)}(hXKFilter 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:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhhhKhjubj)}(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}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhKhjubeh}(h]h ]h"]h$]h&]uh1jhjhhhhhNubeh}(h]h ]h"]h$]h&]jjjhjjuh1j{hjhhhhhKmubj)}(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:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhhhKhjhhubj)}(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}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhKhjhhubeh}(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}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j`hjhhhhhKubj)}(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/:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhhhKhjhhubj)}(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&]uh1jhhhKhj 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&]uh1jhhhKhj ubeh}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhhhKhjubj)}(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&]uh1jhhhKhjO 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&]uh1jhhhKhjO ubeh}(h]h ]h"]h$]h&]uh1jhj= ubeh}(h]h ]h"]h$]h&]uh1jhhhKhjhhubj)}(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&]uh1jhhhKhj 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&]uh1jhhhKhj ubeh}(h]h ]h"]h$]h&]uh1jhjz ubeh}(h]h ]h"]h$]h&]uh1jhhhKhjhhubj)}(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&]uh1jhhhKhj 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&]uh1jhhhKhj 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&]hhuh1jhhhKhj ubeh}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhhhKhjhhubeh}(h]h ]h"]h$]h&]uh1jhjhhhhhNubj)}(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&]uh1jhhhKhjhhubj)}(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&]uh1jhhhKhj+ ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhhhKhj 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&]uh1jhhhKhjZ 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&]uh1jhhhKhjZ ubeh}(h]h ]h"]h$]h&]uh1jhjH ubeh}(h]h ]h"]h$]h&]uh1jhhhKhj 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&]uh1jhhhKhj 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&]uh1jhhhKhj ubeh}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhhhKhj 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&]uh1jhhhKhj 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&]uh1jhhhKhj ubeh}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhhhKhj 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&]uh1jhhhKhj 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&]uh1jhhhKhj ubeh}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhhhKhj 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&]uh1jhhhKhjN 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&]uh1jhhhKhjN ubeh}(h]h ]h"]h$]h&]uh1jhj< ubeh}(h]h ]h"]h$]h&]uh1jhhhKhj hhubeh}(h]h ]h"]h$]h&]uh1jhjhhhhhNubj)}(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&]uh1jhhhKhjhhubj|)}(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&]uh1jhhhKhj ubah}(h]h ]h"]h$]h&]uh1jhj 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&]uh1jhhhKhj ubah}(h]h ]h"]h$]h&]uh1jhj hhhhhNubeh}(h]h ]h"]h$]h&]jarabicjhjjuh1j{hjhhhhhKubeh}(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-siginput_encoding_error_handlerstrictoutput_encodingutf-8output_encoding_error_handlerj error_encodingutf-8error_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_widthKtrim_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}(hhjhjjj jj/j#j>j2jMjAj\jPjkj_jzjnjj}jjjjjjjjjjjjjjjjjjjjj.j"j=j1jLj@j[jOjjj^jyjmjj|jjjjjjjjjjjjjjjjjjjjj-j!j<j0jKj?jZjNjij]jxjljj{jjjjjjjjjjjjjjjjjjjjj,j j;j/jJj>jYjMjhj\jwjkjjzjjjjjjjjjjjjjjjjj jjjj+jj:j.jIj=jXjLusubstitution_names}(amphaposjastjbrvbarj bsolj/centj>colonjMcommaj\commatjkcopyjzcurrenjdarrjdegjdividejdollarjequalsjexcljfrac12jfrac14jfrac18jfrac34jfrac38j.frac58j=frac78jLgtj[halfjjhorbarjyhyphenjiexcljiquestjlaquojlarrjlcubjldquojlowbarjlparjlsqbjlsquojltj-microj<middotjKnbspjZnotjinumjxohmjordfjordmjparajpercntjperiodjplusjplusmnjpoundjquestjquotjraquoj,rarrj;rcubjJrdquojYregjhrparjwrsqbjrsquojsectjsemijshyjsoljsungjsup1jsup2jsup3j timesjtradej+uarrj:verbarjIyenjXurefnames}refids}nameids}(j j jjjjjjjjj j u nametypes}(j jjjjj uh}(j j]jjjj!jj@jjj ju 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.