€•ÏT      Œsphinx.addnodes”Œdocument”“”)”}”(Œ	rawsource”Œ ”Œchildren”]”(Œtranslations”ŒLanguagesNode”“”)”}”(hhh]”(h Œpending_xref”“”)”}”(hhh]”Œdocutils.nodes”ŒText”“”ŒChinese (Simplified)”…””}”Œparent”hsbaŒ
attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”Œbackrefs”]”Œ	refdomain”Œstd”Œreftype”Œdoc”Œ	reftarget”Œ)/translations/zh_CN/core-api/printk-index”Œmodname”NŒ	classname”NŒrefexplicit”ˆuŒtagname”hhhubh)”}”(hhh]”hŒChinese (Traditional)”…””}”hh2sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ)/translations/zh_TW/core-api/printk-index”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒItalian”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ)/translations/it_IT/core-api/printk-index”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒJapanese”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ)/translations/ja_JP/core-api/printk-index”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒKorean”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ)/translations/ko_KR/core-api/printk-index”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒSpanish”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ)/translations/sp_SP/core-api/printk-index”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubeh}”(h]”h ]”h"]”h$]”h&]”Œcurrent_language”ŒEnglish”uh1h
hhŒ	_document”hŒsource”NŒline”NubhŒcomment”“”)”}”(hŒ SPDX-License-Identifier: GPL-2.0”h]”hŒ SPDX-License-Identifier: GPL-2.0”…””}”hh£sbah}”(h]”h ]”h"]”h$]”h&]”Œ	xml:space”Œpreserve”uh1h¡hhhžhhŸŒC/var/lib/git/docbuild/linux/Documentation/core-api/printk-index.rst”h KubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒPrintk Index”h]”hŒPrintk Index”…””}”(hh»hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hh¶hžhhŸh³h KubhŒ	paragraph”“”)”}”(hŒÎThere are many ways to monitor the state of the system. One important
source of information is the system log. It provides a lot of information,
including more or less important warnings and error messages.”h]”hŒÎThere are many ways to monitor the state of the system. One important
source of information is the system log. It provides a lot of information,
including more or less important warnings and error messages.”…””}”(hhËhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khh¶hžhubhÊ)”}”(hŒPThere are monitoring tools that filter and take action based on messages
logged.”h]”hŒPThere are monitoring tools that filter and take action based on messages
logged.”…””}”(hhÙhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khh¶hžhubhÊ)”}”(hŒ€The kernel messages are evolving together with the code. As a result,
particular kernel messages are not KABI and never will be!”h]”hŒ€The kernel messages are evolving together with the code. As a result,
particular kernel messages are not KABI and never will be!”…””}”(hhçhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khh¶hžhubhÊ)”}”(hX¨  It is a huge challenge for maintaining the system log monitors. It requires
knowing what messages were updated in a particular kernel version and why.
Finding these changes in the sources would require non-trivial parsers.
Also it would require matching the sources with the binary kernel which
is not always trivial. Various changes might be backported. Various kernel
versions might be used on different monitored systems.”h]”hX¨  It is a huge challenge for maintaining the system log monitors. It requires
knowing what messages were updated in a particular kernel version and why.
Finding these changes in the sources would require non-trivial parsers.
Also it would require matching the sources with the binary kernel which
is not always trivial. Various changes might be backported. Various kernel
versions might be used on different monitored systems.”…””}”(hhõhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khh¶hžhubhÊ)”}”(hŒÞThis is where the printk index feature might become useful. It provides
a dump of printk formats used all over the source code used for the kernel
and modules on the running system. It is accessible at runtime via debugfs.”h]”hŒÞThis is where the printk index feature might become useful. It provides
a dump of printk formats used all over the source code used for the kernel
and modules on the running system. It is accessible at runtime via debugfs.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khh¶hžhubhÊ)”}”(hŒ”The printk index helps to find changes in the message formats. Also it helps
to track the strings back to the kernel sources and the related commit.”h]”hŒ”The printk index helps to find changes in the message formats. Also it helps
to track the strings back to the kernel sources and the related commit.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khh¶hžhubhµ)”}”(hhh]”(hº)”}”(hŒUser Interface”h]”hŒUser Interface”…””}”(hj"  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hj  hžhhŸh³h K!ubhÊ)”}”(hŒ×The index of printk formats are split in into separate files. The files are
named according to the binaries where the printk formats are built-in. There
is always "vmlinux" and optionally also modules, for example::”h]”hŒÚThe index of printk formats are split in into separate files. The files are
named according to the binaries where the printk formats are built-in. There
is always â€œvmlinuxâ€ and optionally also modules, for example:”…””}”(hj0  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K#hj  hžhubhŒliteral_block”“”)”}”(hŒr/sys/kernel/debug/printk/index/vmlinux
/sys/kernel/debug/printk/index/ext4
/sys/kernel/debug/printk/index/scsi_mod”h]”hŒr/sys/kernel/debug/printk/index/vmlinux
/sys/kernel/debug/printk/index/ext4
/sys/kernel/debug/printk/index/scsi_mod”…””}”hj@  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1j>  hŸh³h K'hj  hžhubhÊ)”}”(hŒNote that only loaded modules are shown. Also printk formats from a module
might appear in "vmlinux" when the module is built-in.”h]”hŒ…Note that only loaded modules are shown. Also printk formats from a module
might appear in â€œvmlinuxâ€ when the module is built-in.”…””}”(hjN  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K+hj  hžhubhÊ)”}”(hŒGThe content is inspired by the dynamic debug interface and looks like::”h]”hŒFThe content is inspired by the dynamic debug interface and looks like:”…””}”(hj\  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K.hj  hžhubj?  )”}”(hX  $> head -1 /sys/kernel/debug/printk/index/vmlinux; shuf -n 5 vmlinux
# <level[,flags]> filename:line function "format"
<5> block/blk-settings.c:661 disk_stack_limits "%s: Warning: Device %s is misaligned\n"
<4> kernel/trace/trace.c:8296 trace_create_file "Could not create tracefs '%s' entry\n"
<6> arch/x86/kernel/hpet.c:144 _hpet_print_config "hpet: %s(%d):\n"
<6> init/do_mounts.c:605 prepare_namespace "Waiting for root device %s...\n"
<6> drivers/acpi/osl.c:1410 acpi_no_auto_serialize_setup "ACPI: auto-serialization disabled\n"”h]”hX  $> head -1 /sys/kernel/debug/printk/index/vmlinux; shuf -n 5 vmlinux
# <level[,flags]> filename:line function "format"
<5> block/blk-settings.c:661 disk_stack_limits "%s: Warning: Device %s is misaligned\n"
<4> kernel/trace/trace.c:8296 trace_create_file "Could not create tracefs '%s' entry\n"
<6> arch/x86/kernel/hpet.c:144 _hpet_print_config "hpet: %s(%d):\n"
<6> init/do_mounts.c:605 prepare_namespace "Waiting for root device %s...\n"
<6> drivers/acpi/osl.c:1410 acpi_no_auto_serialize_setup "ACPI: auto-serialization disabled\n"”…””}”hjj  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1j>  hŸh³h K0hj  hžhubhÊ)”}”(hŒ, where the meaning is:”h]”hŒ, where the meaning is:”…””}”(hjx  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K8hj  hžhubhŒblock_quote”“”)”}”(hXÃ  - :level: log level value: 0-7 for particular severity, -1 as default,
     'c' as continuous line without an explicit log level
- :flags: optional flags: currently only 'c' for KERN_CONT
- :filename\:line: source filename and line number of the related
     printk() call. Note that there are many wrappers, for example,
     pr_warn(), pr_warn_once(), dev_warn().
- :function: function name where the printk() call is used.
- :format: format string
”h]”hŒbullet_list”“”)”}”(hhh]”(hŒ	list_item”“”)”}”(hŒ|:level: log level value: 0-7 for particular severity, -1 as default,
   'c' as continuous line without an explicit log level”h]”hŒ
field_list”“”)”}”(hhh]”hŒfield”“”)”}”(hhh]”(hŒ
field_name”“”)”}”(hŒlevel”h]”hŒlevel”…””}”(hj£  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j¡  hjž  hŸh³h K ubhŒ
field_body”“”)”}”(hŒqlog level value: 0-7 for particular severity, -1 as default,
'c' as continuous line without an explicit log level”h]”hÊ)”}”(hŒqlog level value: 0-7 for particular severity, -1 as default,
'c' as continuous line without an explicit log level”h]”hŒulog level value: 0-7 for particular severity, -1 as default,
â€˜câ€™ as continuous line without an explicit log level”…””}”(hj·  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K:hj³  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j±  hjž  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jœ  hŸh³h K:hj™  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j—  hj“  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j‘  hjŽ  ubj’  )”}”(hŒ8:flags: optional flags: currently only 'c' for KERN_CONT”h]”j˜  )”}”(hhh]”j  )”}”(hhh]”(j¢  )”}”(hŒflags”h]”hŒflags”…””}”(hjç  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j¡  hjä  hŸh³h K ubj²  )”}”(hŒ0optional flags: currently only 'c' for KERN_CONT”h]”hÊ)”}”(hj÷  h]”hŒ4optional flags: currently only â€˜câ€™ for KERN_CONT”…””}”(hjù  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K<hjõ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j±  hjä  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jœ  hŸh³h K<hjá  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j—  hjÝ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j‘  hjŽ  ubj’  )”}”(hŒ«:filename\:line: source filename and line number of the related
   printk() call. Note that there are many wrappers, for example,
   pr_warn(), pr_warn_once(), dev_warn().”h]”j˜  )”}”(hhh]”j  )”}”(hhh]”(j¢  )”}”(hŒfilename\:line”h]”hŒfilename :line”…””}”(hj(  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j¡  hj%  hŸh³h K ubj²  )”}”(hŒ”source filename and line number of the related
printk() call. Note that there are many wrappers, for example,
pr_warn(), pr_warn_once(), dev_warn().”h]”hÊ)”}”(hŒ”source filename and line number of the related
printk() call. Note that there are many wrappers, for example,
pr_warn(), pr_warn_once(), dev_warn().”h]”hŒ”source filename and line number of the related
printk() call. Note that there are many wrappers, for example,
pr_warn(), pr_warn_once(), dev_warn().”…””}”(hj:  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K=hj6  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j±  hj%  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jœ  hŸh³h K=hj"  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j—  hj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j‘  hjŽ  ubj’  )”}”(hŒ9:function: function name where the printk() call is used.”h]”j˜  )”}”(hhh]”j  )”}”(hhh]”(j¢  )”}”(hŒfunction”h]”hŒfunction”…””}”(hjj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j¡  hjg  hŸh³h K ubj²  )”}”(hŒ.function name where the printk() call is used.”h]”hÊ)”}”(hjz  h]”hŒ.function name where the printk() call is used.”…””}”(hj|  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K@hjx  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j±  hjg  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jœ  hŸh³h K@hjd  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j—  hj`  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j‘  hjŽ  ubj’  )”}”(hŒ:format: format string
”h]”j˜  )”}”(hhh]”j  )”}”(hhh]”(j¢  )”}”(hŒformat”h]”hŒformat”…””}”(hj«  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j¡  hj¨  hŸh³h K ubj²  )”}”(hŒformat string
”h]”hÊ)”}”(hŒformat string”h]”hŒformat string”…””}”(hj½  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KAhj¹  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j±  hj¨  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jœ  hŸh³h KAhj¥  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j—  hj¡  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j‘  hjŽ  ubeh}”(h]”h ]”h"]”h$]”h&]”Œbullet”Œ-”uh1jŒ  hŸh³h K:hjˆ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j†  hŸh³h K:hj  hžhubhÊ)”}”(hX  The extra information makes it a bit harder to find differences
between various kernels. Especially the line number might change
very often. On the other hand, it helps a lot to confirm that
it is the same string or find the commit that is responsible
for eventual changes.”h]”hX  The extra information makes it a bit harder to find differences
between various kernels. Especially the line number might change
very often. On the other hand, it helps a lot to confirm that
it is the same string or find the commit that is responsible
for eventual changes.”…””}”(hjñ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KChj  hžhubeh}”(h]”Œuser-interface”ah ]”h"]”Œuser interface”ah$]”h&]”uh1h´hh¶hžhhŸh³h K!ubhµ)”}”(hhh]”(hº)”}”(hŒprintk() Is Not a Stable KABI”h]”hŒprintk() Is Not a Stable KABI”…””}”(hj
  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hj  hžhhŸh³h KKubhÊ)”}”(hŒ•Several developers are afraid that exporting all these implementation
details into the user space will transform particular printk() calls
into KABI.”h]”hŒ•Several developers are afraid that exporting all these implementation
details into the user space will transform particular printk() calls
into KABI.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KMhj  hžhubhÊ)”}”(hŒBut it is exactly the opposite. printk() calls must _not_ be KABI.
And the printk index helps user space tools to deal with this.”h]”hŒBut it is exactly the opposite. printk() calls must _not_ be KABI.
And the printk index helps user space tools to deal with this.”…””}”(hj&  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KQhj  hžhubeh}”(h]”Œprintk-is-not-a-stable-kabi”ah ]”h"]”Œprintk() is not a stable kabi”ah$]”h&]”uh1h´hh¶hžhhŸh³h KKubhµ)”}”(hhh]”(hº)”}”(hŒ"Subsystem specific printk wrappers”h]”hŒ"Subsystem specific printk wrappers”…””}”(hj?  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hj<  hžhhŸh³h KVubhÊ)”}”(hX)  The printk index is generated using extra metadata that are stored in
a dedicated .elf section ".printk_index". It is achieved using macro
wrappers doing __printk_index_emit() together with the real printk()
call. The same technique is used also for the metadata used by
the dynamic debug feature.”h]”hX-  The printk index is generated using extra metadata that are stored in
a dedicated .elf section â€œ.printk_indexâ€. It is achieved using macro
wrappers doing __printk_index_emit() together with the real printk()
call. The same technique is used also for the metadata used by
the dynamic debug feature.”…””}”(hjM  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KXhj<  hžhubhÊ)”}”(hŒÏThe metadata are stored for a particular message only when it is printed
using these special wrappers. It is implemented for the commonly
used printk() calls, including, for example, pr_warn(), or pr_once().”h]”hŒÏThe metadata are stored for a particular message only when it is printed
using these special wrappers. It is implemented for the commonly
used printk() calls, including, for example, pr_warn(), or pr_once().”…””}”(hj[  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K^hj<  hžhubhÊ)”}”(hŒÃAdditional changes are necessary for various subsystem specific wrappers
that call the original printk() via a common helper function. These needs
their own wrappers adding __printk_index_emit().”h]”hŒÃAdditional changes are necessary for various subsystem specific wrappers
that call the original printk() via a common helper function. These needs
their own wrappers adding __printk_index_emit().”…””}”(hji  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Kbhj<  hžhubhÊ)”}”(hŒ²Only few subsystem specific wrappers have been updated so far,
for example, dev_printk(). As a result, the printk formats from
some subsystems can be missing in the printk index.”h]”hŒ²Only few subsystem specific wrappers have been updated so far,
for example, dev_printk(). As a result, the printk formats from
some subsystems can be missing in the printk index.”…””}”(hjw  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Kfhj<  hžhubeh}”(h]”Œ"subsystem-specific-printk-wrappers”ah ]”h"]”Œ"subsystem specific printk wrappers”ah$]”h&]”uh1h´hh¶hžhhŸh³h KVubhµ)”}”(hhh]”(hº)”}”(hŒSubsystem specific prefix”h]”hŒSubsystem specific prefix”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hj  hžhhŸh³h KlubhÊ)”}”(hŒ}The macro pr_fmt() macro allows to define a prefix that is printed
before the string generated by the related printk() calls.”h]”hŒ}The macro pr_fmt() macro allows to define a prefix that is printed
before the string generated by the related printk() calls.”…””}”(hjž  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Knhj  hžhubhÊ)”}”(hŒGSubsystem specific wrappers usually add even more complicated
prefixes.”h]”hŒGSubsystem specific wrappers usually add even more complicated
prefixes.”…””}”(hj¬  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Kqhj  hžhubhÊ)”}”(hŒìThese prefixes can be stored into the printk index metadata
by an optional parameter of __printk_index_emit(). The debugfs
interface might then show the printk formats including these prefixes.
For example, drivers/acpi/osl.c contains::”h]”hŒëThese prefixes can be stored into the printk index metadata
by an optional parameter of __printk_index_emit(). The debugfs
interface might then show the printk formats including these prefixes.
For example, drivers/acpi/osl.c contains:”…””}”(hjº  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Kthj  hžhubj?  )”}”(hŒÔ#define pr_fmt(fmt) "ACPI: OSL: " fmt

static int __init acpi_no_auto_serialize_setup(char *str)
{
      acpi_gbl_auto_serialize_methods = FALSE;
      pr_info("Auto-serialization disabled\n");

      return 1;
}”h]”hŒÔ#define pr_fmt(fmt) "ACPI: OSL: " fmt

static int __init acpi_no_auto_serialize_setup(char *str)
{
      acpi_gbl_auto_serialize_methods = FALSE;
      pr_info("Auto-serialization disabled\n");

      return 1;
}”…””}”hjÈ  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1j>  hŸh³h Kyhj  hžhubhÊ)”}”(hŒ2This results in the following printk index entry::”h]”hŒ1This results in the following printk index entry:”…””}”(hjÖ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Kƒhj  hžhubj?  )”}”(hŒ^<6> drivers/acpi/osl.c:1410 acpi_no_auto_serialize_setup "ACPI: auto-serialization disabled\n"”h]”hŒ^<6> drivers/acpi/osl.c:1410 acpi_no_auto_serialize_setup "ACPI: auto-serialization disabled\n"”…””}”hjä  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1j>  hŸh³h K…hj  hžhubhÊ)”}”(hŒ¯It helps matching messages from the real log with printk index.
Then the source file name, line number, and function name can
be used to match the string with the source code.”h]”hŒ¯It helps matching messages from the real log with printk index.
Then the source file name, line number, and function name can
be used to match the string with the source code.”…””}”(hjò  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K‡hj  hžhubeh}”(h]”Œsubsystem-specific-prefix”ah ]”h"]”Œsubsystem specific prefix”ah$]”h&]”uh1h´hh¶hžhhŸh³h Klubeh}”(h]”Œprintk-index”ah ]”h"]”Œprintk index”ah$]”h&]”uh1h´hhhžhhŸh³h Kubeh}”(h]”h ]”h"]”h$]”h&]”Œsource”h³uh1hŒcurrent_source”NŒcurrent_line”NŒsettings”Œdocutils.frontend”ŒValues”“”)”}”(h¹NŒ	generator”NŒ	datestamp”NŒsource_link”NŒ
source_url”NŒtoc_backlinks”Œentry”Œfootnote_backlinks”KŒsectnum_xform”KŒstrip_comments”NŒstrip_elements_with_classes”NŒstrip_classes”NŒreport_level”KŒ
halt_level”KŒexit_status_level”KŒdebug”NŒwarning_stream”NŒ	traceback”ˆŒinput_encoding”Œ	utf-8-sig”Œinput_encoding_error_handler”Œstrict”Œoutput_encoding”Œutf-8”Œoutput_encoding_error_handler”j3  Œerror_encoding”Œutf-8”Œerror_encoding_error_handler”Œbackslashreplace”Œlanguage_code”Œen”Œrecord_dependencies”NŒconfig”NŒ	id_prefix”hŒauto_id_prefix”Œid”Œdump_settings”NŒdump_internals”NŒdump_transforms”NŒdump_pseudo_xml”NŒexpose_internals”NŒstrict_visitor”NŒ_disable_config”NŒ_source”h³Œ_destination”NŒ_config_files”]”Œ7/var/lib/git/docbuild/linux/Documentation/docutils.conf”aŒfile_insertion_enabled”ˆŒraw_enabled”KŒline_length_limit”M'Œpep_references”NŒpep_base_url”Œhttps://peps.python.org/”Œpep_file_url_template”Œpep-%04d”Œrfc_references”NŒrfc_base_url”Œ&https://datatracker.ietf.org/doc/html/”Œ	tab_width”KŒtrim_footnote_reference_space”‰Œsyntax_highlight”Œlong”Œsmart_quotes”ˆŒsmartquotes_locales”]”Œcharacter_level_inline_markup”‰Œdoctitle_xform”‰Œdocinfo_xform”KŒsectsubtitle_xform”‰Œimage_loading”Œlink”Œembed_stylesheet”‰Œcloak_email_addresses”ˆŒsection_self_link”‰Œenv”NubŒreporter”NŒindirect_targets”]”Œsubstitution_defs”}”Œsubstitution_names”}”Œrefnames”}”Œrefids”}”Œnameids”}”(j  j
  j  j  j9  j6  jŠ  j‡  j  j  uŒ	nametypes”}”(j  ‰j  ‰j9  ‰jŠ  ‰j  ‰uh}”(j
  h¶j  j  j6  j  j‡  j<  j  j  uŒfootnote_refs”}”Œcitation_refs”}”Œautofootnotes”]”Œautofootnote_refs”]”Œsymbol_footnotes”]”Œsymbol_footnote_refs”]”Œ	footnotes”]”Œ	citations”]”Œautofootnote_start”KŒsymbol_footnote_start”K Œ
id_counter”Œcollections”ŒCounter”“”}”…”R”Œparse_messages”]”Œtransform_messages”]”Œtransformer”NŒinclude_log”]”Œ
decoration”Nhžhub.