€•5: Œsphinx.addnodes”Œdocument”“”)”}”(Œ rawsource”Œ ”Œchildren”]”(Œ translations”Œ
LanguagesNode”“”)”}”(hhh]”(h Œ pending_xref”“”)”}”(hhh]”Œdocutils.nodes”ŒText”“”ŒChinese (Simplified)”…””}”Œparent”hsbaŒ
attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”Œbackrefs”]”Œ refdomain”Œstd”Œreftype”Œdoc”Œ reftarget”Œ/translations/zh_CN/index”Œmodname”NŒ classname”NŒ refexplicit”ˆuŒtagname”hhh ubh)”}”(hhh]”hŒChinese (Traditional)”…””}”hh2sbah }”(h ]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ/translations/zh_TW/index”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒItalian”…””}”hhFsbah }”(h ]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ/translations/it_IT/index”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒJapanese”…””}”hhZsbah }”(h ]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ/translations/ja_JP/index”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒKorean”…””}”hhnsbah }”(h ]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ/translations/ko_KR/index”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒSpanish”…””}”hh‚sbah }”(h ]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ/translations/sp_SP/index”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubeh }”(h ]”h ]”h"]”h$]”h&]”Œcurrent_language”ŒEnglish”uh1h
hhŒ _document”hŒsource”NŒline”NubhŒcomment”“”)”}”(hŒ SPDX-License-Identifier: GPL-2.0”h]”hŒ SPDX-License-Identifier: GPL-2.0”…””}”hh£sbah }”(h ]”h ]”h"]”h$]”h&]”Œ xml:space”Œpreserve”uh1h¡hhhžhhŸŒ3/var/lib/git/docbuild/linux/Documentation/index.rst”h KubhŒtarget”“”)”}”(hŒ.. _linux_doc:”h]”h }”(h ]”h ]”h"]”h$]”h&]”Œrefid”Œ linux-doc”uh1h´h KhhhžhhŸh³ubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒ The Linux Kernel documentation”h]”hŒ The Linux Kernel documentation”…””}”(hhÉhžhhŸNh Nubah }”(h ]”h ]”h"]”h$]”h&]”uh1hÇhhÄhžhhŸh³h KubhŒ paragraph”“”)”}”(hXr This is the top level of the kernel's documentation tree. Kernel
documentation, like the kernel itself, is very much a work in progress;
that is especially true as we work to integrate our many scattered
documents into a coherent whole. Please note that improvements to the
documentation are welcome; join the linux-doc list at vger.kernel.org if
you want to help out.”h]”hXt This is the top level of the kernel’s documentation tree. Kernel
documentation, like the kernel itself, is very much a work in progress;
that is especially true as we work to integrate our many scattered
documents into a coherent whole. Please note that improvements to the
documentation are welcome; join the linux-doc list at vger.kernel.org if
you want to help out.”…””}”(hhÙhžhhŸNh Nubah }”(h ]”h ]”h"]”h$]”h&]”uh1h×hŸh³h K hhÄhžhubhÃ)”}”(hhh]”(hÈ)”}”(hŒ&Working with the development community”h]”hŒ&Working with the development community”…””}”(hhêhžhhŸNh Nubah }”(h ]”h ]”h"]”h$]”h&]”uh1hÇhhçhžhhŸh³h KubhØ)”}”(hŒlThe essential guides for interacting with the kernel's development
community and getting your work upstream.”h]”hŒnThe essential guides for interacting with the kernel’s development
community and getting your work upstream.”…””}”(hhøhžhhŸNh Nubah }”(h ]”h ]”h"]”h$]”h&]”uh1h×hŸh³h KhhçhžhubhŒcompound”“”)”}”(hhh]”h Œtoctree”“”)”}”(hhh]”h }”(h ]”h ]”h"]”h$]”h&]”hŒindex”Œentries”]”(ŒDevelopment process”Œprocess/development-process”†”ŒSubmitting patches”Œprocess/submitting-patches”†”ŒCode of conduct”Œprocess/code-of-conduct”†”ŒMaintainer handbook”Œmaintainer/index”†”Œ All development-process docs”Œ
process/index”†”eŒ includefiles”]”(j j j j# j& eŒmaxdepth”KŒcaption”NŒglob”‰Œhidden”‰Œ
includehidden”‰Œnumbered”K Œ
titlesonly”‰Œ
rawentries”]”(j j j j" j% euh1j hŸh³h Khj ubah }”(h ]”h ]”Œtoctree-wrapper”ah"]”h$]”h&]”uh1j hhçhžhhŸh³h Nubeh }”(h ]”Œ&working-with-the-development-community”ah ]”h"]”Œ&working with the development community”ah$]”h&]”uh1hÂhhÄhžhhŸh³h KubhÃ)”}”(hhh]”(hÈ)”}”(hŒInternal API manuals”h]”hŒInternal API manuals”…””}”(hjE hžhhŸNh Nubah }”(h ]”h ]”h"]”h$]”h&]”uh1hÇhjB hžhhŸh³h K!ubhØ)”}”(hŒOManuals for use by developers working to interface with the rest of the
kernel.”h]”hŒOManuals for use by developers working to interface with the rest of the
kernel.”…””}”(hjS hžhhŸNh Nubah }”(h ]”h ]”h"]”h$]”h&]”uh1h×hŸh³h K#hjB hžhubj )”}”(hhh]”j )”}”(hhh]”h }”(h ]”h ]”h"]”h$]”h&]”hj j ]”(ŒCore API”Œcore-api/index”†”Œ Driver APIs”Œdriver-api/index”†”Œ
Subsystems”Œsubsystem-apis”†”ŒLocking”Œ
locking/index”†”ej( ]”(jo jr ju jx ej* Kj+ Nj, ‰j- ‰j. ‰j/ K j0 ‰j1 ]”(jn jq jt jw euh1j hŸh³h K&hja ubah }”(h ]”h ]”j6 ah"]”h$]”h&]”uh1j hjB hžhhŸh³h Nubeh }”(h ]”Œinternal-api-manuals”ah ]”h"]”Œinternal api manuals”ah$]”h&]”uh1hÂhhÄhžhhŸh³h K!ubhÃ)”}”(hhh]”(hÈ)”}”(hŒ Development tools and processes”h]”hŒ Development tools and processes”…””}”(hj hžhhŸNh Nubah }”(h ]”h ]”h"]”h$]”h&]”uh1hÇhjŠ hžhhŸh³h K/ubhØ)”}”(hŒHVarious other manuals with useful information for all kernel developers.”h]”hŒHVarious other manuals with useful information for all kernel developers.”…””}”(hj› hžhhŸNh Nubah }”(h ]”h ]”h"]”h$]”h&]”uh1h×hŸh³h K1hjŠ hžhubj )”}”(hhh]”j )”}”(hhh]”h }”(h ]”h ]”h"]”h$]”h&]”hj j ]”(ŒLicensing rules”Œprocess/license-rules”†”ŒWriting documentation”Œdoc-guide/index”†”ŒDevelopment tools”Œdev-tools/index”†”Œ
Testing guide”Œdev-tools/testing-overview”†”Œ
Hacking guide”Œkernel-hacking/index”†”ŒTracing”Œ trace/index”†”ŒFault injection”Œfault-injection/index”†”Œ Livepatching”Œlivepatch/index”†”ŒRust”Œ
rust/index”†”ej( ]”(j· jº j½ jÀ jà jÆ jÉ jÌ jÏ ej* Kj+ Nj, ‰j- ‰j. ‰j/ K j0 ‰j1 ]”(j¶ j¹ j¼ j¿ j jÅ jÈ jË jÎ euh1j hŸh³h K3hj© ubah }”(h ]”h ]”j6 ah"]”h$]”h&]”uh1j hjŠ hžhhŸh³h Nubeh }”(h ]”Œ development-tools-and-processes”ah ]”h"]”Œ development tools and processes”ah$]”h&]”uh1hÂhhÄhžhhŸh³h K/ubhÃ)”}”(hhh]”(hÈ)”}”(hŒUser-oriented documentation”h]”hŒUser-oriented documentation”…””}”(hjä hžhhŸNh Nubah }”(h ]”h ]”h"]”h$]”h&]”uh1hÇhjá hžhhŸh³h KBubhØ)”}”(hŒÒThe following manuals are written for *users* of the kernel — those who are
trying to get it to work optimally on a given system and application
developers seeking information on the kernel's user-space APIs.”h]”(hŒ&The following manuals are written for ”…””}”(hjò hžhhŸNh NubhŒemphasis”“”)”}”(hŒ*users*”h]”hŒusers”…””}”(hjü hžhhŸNh Nubah }”(h ]”h ]”h"]”h$]”h&]”uh1jú hjò ubhŒ§ of the kernel — those who are
trying to get it to work optimally on a given system and application
developers seeking information on the kernel’s user-space APIs.”…””}”(hjò hžhhŸNh Nubeh }”(h ]”h ]”h"]”h$]”h&]”uh1h×hŸh³h KDhjá hžhubj )”}”(hhh]”j )”}”(hhh]”h }”(h ]”h ]”h"]”h$]”h&]”hj j ]”(ŒAdministration”Œadmin-guide/index”†”Œ Build system”Œ kbuild/index”†”ŒReporting issues”Œ admin-guide/reporting-issues”†”ŒUserspace tools”Œ tools/index”†”Œ
Userspace API”Œuserspace-api/index”†”ej( ]”(j" j% j( j+ j. ej* Kj+ Nj, ‰j- ‰j. ‰j/ K j0 ‰j1 ]”(j! j$ j' j* j- euh1j hŸh³h KHhj ubah }”(h ]”h ]”j6 ah"]”h$]”h&]”uh1j hjá hžhhŸh³h NubhØ)”}”(hŒˆSee also: the `Linux man pages `_,
which are kept separately from the kernel's own documentation.”h]”(hŒSee also: the ”…””}”(hj8 hžhhŸNh NubhŒ reference”“”)”}”(hŒ:`Linux man pages `_”h]”hŒLinux man pages”…””}”(hjB hžhhŸNh Nubah }”(h ]”h ]”h"]”h$]”h&]”Œname”ŒLinux man pages”Œrefuri”Œ%https://www.kernel.org/doc/man-pages/”uh1j@ hj8 ubhµ)”}”(hŒ( ”h]”h }”(h ]”Œlinux-man-pages”ah ]”h"]”Œlinux man pages”ah$]”h&]”Œrefuri”jS uh1h´Œ
referenced”Khj8 ubhŒB,
which are kept separately from the kernel’s own documentation.”…””}”(hj8 hžhhŸNh Nubeh }”(h ]”h ]”h"]”h$]”h&]”uh1h×hŸh³h KQhjá hžhubeh }”(h ]”Œuser-oriented-documentation”ah ]”h"]”Œuser-oriented documentation”ah$]”h&]”uh1hÂhhÄhžhhŸh³h KBubhÃ)”}”(hhh]”(hÈ)”}”(hŒ Firmware-related documentation”h]”hŒ Firmware-related documentation”…””}”(hjw hžhhŸNh Nubah }”(h ]”h ]”h"]”h$]”h&]”uh1hÇhjt hžhhŸh³h KUubhØ)”}”(hŒ^The following holds information on the kernel's expectations regarding the
platform firmwares.”h]”hŒ`The following holds information on the kernel’s expectations regarding the
platform firmwares.”…””}”(hj… hžhhŸNh Nubah }”(h ]”h ]”h"]”h$]”h&]”uh1h×hŸh³h KVhjt hžhubj )”}”(hhh]”j )”}”(hhh]”h }”(h ]”h ]”h"]”h$]”h&]”hj j ]”(ŒFirmware”Œfirmware-guide/index”†”ŒFirmware and Devicetree”Œdevicetree/index”†”ej( ]”(j¡ j¤ ej* Kj+ Nj, ‰j- ‰j. ‰j/ K j0 ‰j1 ]”(j j£ euh1j hŸh³h KYhj“ ubah }”(h ]”h ]”j6 ah"]”h$]”h&]”uh1j hjt hžhhŸh³h Nubeh }”(h ]”Œ firmware-related-documentation”ah ]”h"]”Œ firmware-related documentation”ah$]”h&]”uh1hÂhhÄhžhhŸh³h KUubhÃ)”}”(hhh]”(hÈ)”}”(hŒ#Architecture-specific documentation”h]”hŒ#Architecture-specific documentation”…””}”(hj¹ hžhhŸNh Nubah }”(h ]”h ]”h"]”h$]”h&]”uh1hÇhj¶ hžhhŸh³h Kaubj )”}”(hhh]”j )”}”(hhh]”h }”(h ]”h ]”h"]”h$]”h&]”hj j ]”ŒCPU architectures”Œ
arch/index”†”aj( ]”jÕ aj* Kj+ Nj, ‰j- ‰j. ‰j/ K j0 ‰j1 ]”jÔ auh1j hŸh³h KchjÇ ubah }”(h ]”h ]”j6 ah"]”h$]”h&]”uh1j hj¶ hžhhŸh³h Nubeh }”(h ]”Œ#architecture-specific-documentation”ah ]”h"]”Œ#architecture-specific documentation”ah$]”h&]”uh1hÂhhÄhžhhŸh³h KaubhÃ)”}”(hhh]”(hÈ)”}”(hŒOther documentation”h]”hŒOther documentation”…””}”(hjê hžhhŸNh Nubah }”(h ]”h ]”h"]”h$]”h&]”uh1hÇhjç hžhhŸh³h KjubhØ)”}”(hŒÊThere are several unsorted documents that don't seem to fit on other parts
of the documentation body, or may require some adjustments and/or conversion
to reStructuredText format, or are simply too old.”h]”hŒÌThere are several unsorted documents that don’t seem to fit on other parts
of the documentation body, or may require some adjustments and/or conversion
to reStructuredText format, or are simply too old.”…””}”(hjø hžhhŸNh Nubah }”(h ]”h ]”h"]”h$]”h&]”uh1h×hŸh³h Klhjç hžhubj )”}”(hhh]”j )”}”(hhh]”h }”(h ]”h ]”h"]”h$]”h&]”hj j ]”ŒUnsorted documentation”Œ
staging/index”†”aj( ]”j aj* Kj+ Nj, ‰j- ‰j. ‰j/ K j0 ‰j1 ]”j auh1j hŸh³h Kphj ubah }”(h ]”h ]”j6 ah"]”h$]”h&]”uh1j hjç hžhhŸh³h Nubeh }”(h ]”Œother-documentation”ah ]”h"]”Œother documentation”ah$]”h&]”uh1hÂhhÄhžhhŸh³h KjubhÃ)”}”(hhh]”(hÈ)”}”(hŒ Translations”h]”hŒ Translations”…””}”(hj) hžhhŸNh Nubah }”(h ]”h ]”h"]”h$]”h&]”uh1hÇhj& hžhhŸh³h Kwubj )”}”(hhh]”j )”}”(hhh]”h }”(h ]”h ]”h"]”h$]”h&]”hj j ]”Œ Translations”Œtranslations/index”†”aj( ]”jE aj* Kj+ Nj, ‰j- ‰j. ‰j/ K j0 ‰j1 ]”jD auh1j hŸh³h Kyhj7 ubah }”(h ]”h ]”j6 ah"]”h$]”h&]”uh1j hj& hžhhŸh³h Nubeh }”(h ]”Œ translations”ah ]”h"]”Œ translations”ah$]”h&]”uh1hÂhhÄhžhhŸh³h KwubhÃ)”}”(hhh]”(hÈ)”}”(hŒIndices and tables”h]”hŒIndices and tables”…””}”(hjZ hžhhŸNh Nubah }”(h ]”h ]”h"]”h$]”h&]”uh1hÇhjW hžhhŸh³h KubhŒ bullet_list”“”)”}”(hhh]”hŒ list_item”“”)”}”(hŒ:ref:`genindex`”h]”hØ)”}”(hjq h]”h)”}”(hjq h]”hŒinline”“”)”}”(hjq h]”hŒgenindex”…””}”(hj{ hžhhŸNh Nubah }”(h ]”h ]”(Œxref”Œstd”Œstd-ref”eh"]”h$]”h&]”uh1jy hjv ubah }”(h ]”h ]”h"]”h$]”h&]”Œrefdoc”j Œ refdomain”j† Œreftype”Œref”Œ refexplicit”‰Œrefwarn”ˆŒ reftarget”Œgenindex”uh1hhŸh³h Khjs ubah }”(h ]”h ]”h"]”h$]”h&]”uh1h×hŸh³h Khjo ubah }”(h ]”h ]”h"]”h$]”h&]”uh1jm hjj hžhhŸh³h Nubah }”(h ]”h ]”h"]”h$]”h&]”Œbullet”Œ*”uh1jh hŸh³h KhjW hžhubeh }”(h ]”Œindices-and-tables”ah ]”h"]”Œindices and tables”ah$]”h&]”uh1hÂhhÄhžhhŸh³h Kubeh }”(h ]”(Œ the-linux-kernel-documentation”hÁeh ]”h"]”(Œ the linux kernel documentation”Œ linux_doc”eh$]”h&]”uh1hÂhhhžhhŸh³h KŒexpect_referenced_by_name”}”j» h¶sŒexpect_referenced_by_id”}”hÁh¶subeh }”(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”jå Œ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”}”hÁ]”h¶asŒnameids”}”(j» hÁjº j· j? j< j‡ j„ jÞ jÛ jq jn j] jZ j³ j° jä já j# j jT jQ j² j¯ uŒ nametypes”}”(j» ˆjº ‰j? ‰j‡ ‰jÞ ‰jq ‰j] ˆj³ ‰jä ‰j# ‰jT ‰j² ‰uh }”(hÁhÄj· hÄj< hçj„ jB jÛ jŠ jn já jZ jT j° jt já j¶ j jç jQ j& j¯ jW 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”]”hŒsystem_message”“”)”}”(hhh]”hØ)”}”(hhh]”hŒ/Hyperlink target "linux-doc" is not referenced.”…””}”hjO sbah }”(h ]”h ]”h"]”h$]”h&]”uh1h×hjL ubah }”(h ]”h ]”h"]”h$]”h&]”Œlevel”KŒtype”ŒINFO”Œsource”h³Œline”Kuh1jJ ubaŒ transformer”NŒ include_log”]”Œ
decoration”Nhžhub.