jsphinx.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]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*}hhsbah}(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\}hjsbah}(h]h ]h"]bsolah$]h&]uh1hhhhK hhhhubh)}(h*.. |cent| unicode:: U+000A2 .. CENT SIGNh]h¢}hjsbah}(h]h ]h"]centah$]h&]uh1hhhhK hhhhubh)}(h&.. |colon| unicode:: U+0003A .. COLONh]h:}hj-sbah}(h]h ]h"]colonah$]h&]uh1hhhhK hhhhubh)}(h&.. |comma| unicode:: U+0002C .. COMMAh]h,}hj<sbah}(h]h ]h"]commaah$]h&]uh1hhhhKhhhhubh)}(h... |commat| unicode:: U+00040 .. COMMERCIAL ATh]h@}hjKsbah}(h]h ]h"]commatah$]h&]uh1hhhhKhhhhubh)}(h/.. |copy| unicode:: U+000A9 .. COPYRIGHT SIGNh]h©}hjZsbah}(h]h ]h"]copyah$]h&]uh1hhhhKhhhhubh)}(h... |curren| unicode:: U+000A4 .. CURRENCY SIGNh]h¤}hjisbah}(h]h ]h"]currenah$]h&]uh1hhhhKhhhhubh)}(h0.. |darr| unicode:: U+02193 .. DOWNWARDS ARROWh]h↓}hjxsbah}(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⅜}hjsbah}(h]h ]h"]frac38ah$]h&]uh1hhhhKhhhhubh)}(h=.. |frac58| unicode:: U+0215D .. VULGAR FRACTION FIVE EIGHTHSh]h⅝}hjsbah}(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>}hj;sbah}(h]h ]h"]gtah$]h&]uh1hhhhKhhhhubh)}(h9.. |half| unicode:: U+000BD .. VULGAR FRACTION ONE HALFh]h½}hjJsbah}(h]h ]h"]halfah$]h&]uh1hhhhK hhhhubh)}(h/.. |horbar| unicode:: U+02015 .. HORIZONTAL BARh]h―}hjYsbah}(h]h ]h"]horbarah$]h&]uh1hhhhK!hhhhubh)}(h'.. |hyphen| unicode:: U+02010 .. HYPHENh]h‐}hjhsbah}(h]h ]h"]hyphenah$]h&]uh1hhhhK"hhhhubh)}(h:.. |iexcl| unicode:: U+000A1 .. INVERTED EXCLAMATION MARKh]h¡}hjwsbah}(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µ}hjsbah}(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 }hj:sbah}(h]h ]h"]nbspah$]h&]uh1hhhhK0hhhhubh)}(h).. |not| unicode:: U+000AC .. NOT SIGNh]h¬}hjIsbah}(h]h ]h"]notah$]h&]uh1hhhhK1hhhhubh)}(h,.. |num| unicode:: U+00023 .. NUMBER SIGNh]h#}hjXsbah}(h]h ]h"]numah$]h&]uh1hhhhK2hhhhubh)}(h).. |ohm| unicode:: U+02126 .. OHM SIGNh]hΩ}hjgsbah}(h]h ]h"]ohmah$]h&]uh1hhhhK3hhhhubh)}(h;.. |ordf| unicode:: U+000AA .. FEMININE ORDINAL INDICATORh]hª}hjvsbah}(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→}hjsbah}(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”}hj9sbah}(h]h ]h"]rdquoah$]h&]uh1hhhhKAhhhhubh)}(h0.. |reg| unicode:: U+000AE .. REGISTERED SIGNh]h®}hjHsbah}(h]h ]h"]regah$]h&]uh1hhhhKBhhhhubh)}(h2.. |rpar| unicode:: U+00029 .. RIGHT PARENTHESISh]h)}hjWsbah}(h]h ]h"]rparah$]h&]uh1hhhhKChhhhubh)}(h5.. |rsqb| unicode:: U+0005D .. RIGHT SQUARE BRACKETh]h]}hjfsbah}(h]h ]h"]rsqbah$]h&]uh1hhhhKDhhhhubh)}(h<.. |rsquo| unicode:: U+02019 .. RIGHT SINGLE QUOTATION MARKh]h’}hjusbah}(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™}hj sbah}(h]h ]h"]tradeah$]h&]uh1hhhhKOhhhhubh)}(h... |uarr| unicode:: U+02191 .. UPWARDS ARROWh]h↑}hjsbah}(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¥}hj8sbah}(h]h ]h"]yenah$]h&]uh1hhhhKRhhhhubhsection)}(hhh](htitle)}(hACPICA Trace Facilityh]hACPICA Trace Facility}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjIhhhhhKubh field_list)}(hhh](hfield)}(hhh](h field_name)}(h Copyrighth]h Copyright}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1jfhjchhhKubh field_body)}(h|copy| 2015, Intel Corporationh]h paragraph)}(hjzh](h©}(hj~hhhNhNubh 2015, Intel Corporation}(hj~hhhNhNubeh}(h]h ]h"]h$]h&]uh1j|hhhKhjxubah}(h]h ]h"]h$]h&]uh1jvhjcubeh}(h]h ]h"]h$]h&]uh1jahhhKhj^hhubjb)}(hhh](jg)}(hAuthorh]hAuthor}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jfhjhhhKubjw)}(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&]uh1j|hhhK hjubah}(h]h ]h"]h$]h&]uh1jvhjubeh}(h]h ]h"]h$]h&]uh1jahhhK hj^hhubeh}(h]h ]h"]h$]h&]uh1j\hjIhhhhhKubjH)}(hhh](jM)}(hAbstracth]hAbstract}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhhhhhK 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.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hhhKhjhhubeh}(h]abstractah ]h"]abstractah$]h&]uh1jGhjIhhhhhK ubjH)}(hhh](jM)}(h"Functionalities and usage examplesh]h"Functionalities and usage examples}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj 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.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hhhKhj hhubjH)}(hhh](jM)}(h Log reducerh]h Log reducer}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj,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).}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hhhKhj,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.}(hjKhhhNhNubah}(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:}(hjYhhhNhNubah}(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:}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hhhK+hjnubh 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.hjnubeh}(h]h ]h"]h$]h&]uh1jlhjihhhhhNubjm)}(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&]uh1j|hhhK3hjubj)}(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&]uh1jlhjihhhhhNubjm)}(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&]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}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhK?hjubeh}(h]h ]h"]h$]h&]uh1jlhjihhhhhNubeh}(h]h ]h"]h$]h&]enumtype loweralphaprefixhsuffix.uh1jghj,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&]uh1jhhhKKhjubh 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}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhhhKGhjubj )}(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.}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hhhKGhj"ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(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}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1jhhhKKhj?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.}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1j|hhhKJhjQubah}(h]h ]h"]h$]h&]uh1jhj?ubeh}(h]h ]h"]h$]h&]uh1jhhhKKhj ubeh}(h]h ]h"]h$]h&]uh1jhj ubah}(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&]uh1jGhj hhhhhKubjH)}(hhh](jM)}(h AML tracerh]h AML tracer}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhhhhhKNubj})}(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&]uh1j|hhhKPhjhhubj)}(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&]uh1j|hhhKdhjhhubj})}(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&]uh1j|hhhKjhjhhubjh)}(hhh](jm)}(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&]uh1j|hhhKmhjubj)}(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&]uh1jlhjhhhhhNubjm)}(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&]uh1j|hhhKuhjubj)}(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}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhKxhjubeh}(h]h ]h"]h$]h&]uh1jlhjhhhhhNubjm)}(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&]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}hj8sbah}(h]h ]h"]h$]h&]hhuh1jhhhKhj&ubeh}(h]h ]h"]h$]h&]uh1jlhjhhhhhNubjm)}(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:}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hhhKhjLubj)}(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}hj^sbah}(h]h ]h"]h$]h&]hhuh1jhhhKhjLubeh}(h]h ]h"]h$]h&]uh1jlhjhhhhhNubjm)}(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:}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hhhKhjrubj)}(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&]hhuh1jhhhKhjrubeh}(h]h ]h"]h$]h&]uh1jlhjhhhhhNubeh}(h]h ]h"]h$]h&]jjjhjjuh1jghjhhhhhKmubj})}(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&]uh1j|hhhKhjhhubj)}(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&]uh1jGhj hhhhhKNubeh}(h]"functionalities-and-usage-examplesah ]h"]"functionalities and usage examplesah$]h&]uh1jGhjIhhhhhKubjH)}(hhh](jM)}(hInterface descriptionsh]hInterface descriptions}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhhhhhKubj})}(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&]uh1j|hhhKhjhhubj)}(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}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhhhKhjubj )}(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|hhhKhjubj})}(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|hhhKhjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(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}(hj- hhhNhNubah}(h]h ]h"]h$]h&]uh1jhhhKhj) 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.}(hj> hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hhhKhj; 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.}(hjL hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hhhKhj; 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}(hjj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhhhKhjf 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|hhhKhjx 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|hhhKhjx ubeh}(h]h ]h"]h$]h&]uh1jhjf 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&]uh1jhhhKhj 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&]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&]uh1j|hhhKhjhhubj)}(hhh](j)}(h."disable" Disable the method tracing feature. h](j)}(h "disable"h]h “disable”}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhhhKhj 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&]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”}(hj8 hhhNhNubah}(h]h ]h"]h$]h&]uh1jhhhKhj4 ubj )}(hhh](j})}(h"Enable the method tracing feature.h]h"Enable the method tracing feature.}(hjI hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hhhKhjF 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.}(hjW hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hhhKhjF ubeh}(h]h ]h"]h$]h&]uh1jhj4 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”}(hju hhhNhNubah}(h]h ]h"]h$]h&]uh1jhhhKhjq 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&]uh1jhjq 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&]uh1jhhhKhj 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&]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&]uh1jhhhKhj 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&]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&]uh1jhhhKhj( 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 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.}(hjK hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hhhKhj: 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:}(hjk hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hhhKhjhhubjh)}(hhh](jm)}(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&]uh1jlhjy hhhhhNubjm)}(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&]uh1jlhjy hhhhhNubeh}(h]h ]h"]h$]h&]jarabicjhjjuh1jghjhhhhhKubeh}(h]interface-descriptionsah ]h"]interface descriptionsah$]h&]uh1jGhjIhhhhhKubeh}(h]acpica-trace-facilityah ]h"]acpica trace facilityah$]h&]uh1jGhhhhhhhKubeh}(h]h ]h"]h$]h&]sourcehuh1hcurrent_sourceN current_lineNsettingsdocutils.frontendValues)}(jLN 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_sourceh _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}(hhhhhhj jjjj*jj9j-jHj<jWjKjfjZjujijjxjjjjjjjjjjjjjjjjj jjjj)jj8j,jGj;jVjJjejYjtjhjjwjjjjjjjjjjjjjjjjj jjj j(jj7j+jFj:jUjIjdjXjsjgjjvjjjjjjjjjjjjjjjjj jjj j'jj6j*jEj9jTjHjcjWjrjfjjujjjjjjjjjjjjjjjjjjjj j&jj5j)jDj8usubstitution_names}(amphߌaposhasthbrvbarj bsoljcentj*colonj9commajHcommatjWcopyjfcurrenjudarrjdegjdividejdollarjequalsjexcljfrac12jfrac14jfrac18jfrac34j frac38jfrac58j)frac78j8gtjGhalfjVhorbarjehyphenjtiexcljiquestjlaquojlarrjlcubjldquojlowbarjlparjlsqbjlsquoj ltjmicroj(middotj7nbspjFnotjUnumjdohmjsordfjordmjparajpercntjperiodjplusjplusmnjpoundjquestjquotj raquojrarrj'rcubj6rdquojEregjTrparjcrsqbjrrsquojsectjsemijshyjsoljsungjsup1jsup2jsup3jtimesjtradejuarrj&verbarj5yenjDurefnames}refids}nameids}(j j j jjjjjjjj j u nametypes}(j j jjjj uh}(j jIjjjj 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.