€•<Œsphinx.addnodes”Œdocument”“”)”}”(Œ rawsource”Œ”Œchildren”]”(Œ translations”Œ LanguagesNode”“”)”}”(hhh]”(hŒ pending_xref”“”)”}”(hhh]”Œdocutils.nodes”ŒText”“”ŒChinese (Simplified)”…””}”(hhŒparent”hubaŒ 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)”…””}”(hhhh2ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ/translations/zh_TW/index”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒItalian”…””}”(hhhhFubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ/translations/it_IT/index”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒJapanese”…””}”(hhhhZubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ/translations/ja_JP/index”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒKorean”…””}”(hhhhnubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ/translations/ko_KR/index”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒSpanish”…””}”(hhhh‚ubah}”(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”…””}”(hhhh£ubah}”(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ËhhÉhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhhÄhžhhŸh³h KubhŒ paragraph”“”)”}”(hXrThis 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]”hXtThis 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Û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ì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ú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”]”(jjj j#j&eŒmaxdepth”KŒcaption”NŒglob”‰Œhidden”‰Œ includehidden”‰Œnumbered”KŒ titlesonly”‰Œ rawentries”]”(jjjj"j%euh1j hŸh³h Khjubah}”(h]”h ]”Œtoctree-wrapper”ah"]”h$]”h&]”uh1jhhç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”…””}”(hjGhjEhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhjBhž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.”…””}”(hjUhjShžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh³h K#hjBhžhubj)”}”(hhh]”j )”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”hjj]”(ŒCore API”Œcore-api/index”†”Œ Driver APIs”Œdriver-api/index”†”Œ Subsystems”Œsubsystem-apis”†”ŒLocking”Œ locking/index”†”ej(]”(jojrjujxej*Kj+Nj,‰j-‰j.‰j/Kj0‰j1]”(jnjqjtjweuh1j hŸh³h K&hjaubah}”(h]”h ]”j6ah"]”h$]”h&]”uh1jhjBhž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”…””}”(hjhjhž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.”…””}”(hjhj›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&]”hjj]”(Œ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/Kj0‰j1]”(j¶j¹j¼j¿jÂjÅjÈjËjÎeuh1j hŸh³h K3hj©ubah}”(h]”h ]”j6ah"]”h$]”h&]”uh1jhjŠ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æ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 ”…””}”(hŒ&The following manuals are written for ”hjòhžhhŸNh NubhŒemphasis”“”)”}”(hŒ*users*”h]”hŒusers”…””}”(hhhjý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.”…””}”(hŒ¥ 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&]”hjj]”(Œ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-j0ej*Kj+Nj,‰j-‰j.‰j/Kj0‰j1]”(j#j&j)j,j/euh1j hŸh³h KHhjubah}”(h]”h ]”j6ah"]”h$]”h&]”uh1jhjá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 ”…””}”(hŒSee also: the ”hj:hžhhŸNh NubhŒ reference”“”)”}”(hŒ:`Linux man pages `_”h]”hŒLinux man pages”…””}”(hŒLinux man pages”hjEhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œname”ŒLinux man pages”Œrefuri”Œ%https://www.kernel.org/doc/man-pages/”uh1jChj:ubhµ)”}”(hŒ( ”h]”h}”(h]”Œlinux-man-pages”ah ]”h"]”Œlinux man pages”ah$]”h&]”Œrefuri”jWuh1h´Œ referenced”Khj:ubhŒB, which are kept separately from the kernel’s own documentation.”…””}”(hŒ@, which are kept separately from the kernel's own documentation.”hj: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”…””}”(hj~hj|hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhjyhž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ŒhjŠhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh³h KVhjyhžhubj)”}”(hhh]”j )”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”hjj]”(ŒFirmware”Œfirmware-guide/index”†”ŒFirmware and Devicetree”Œdevicetree/index”†”ej(]”(j¦j©ej*Kj+Nj,‰j-‰j.‰j/Kj0‰j1]”(j¥j¨euh1j hŸh³h KYhj˜ubah}”(h]”h ]”j6ah"]”h$]”h&]”uh1jhjyhž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À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&]”hjj]”ŒCPU architectures”Œ arch/index”†”aj(]”jÚaj*Kj+Nj,‰j-‰j.‰j/Kj0‰j1]”jÙauh1j hŸh³h KchjÌubah}”(h]”h ]”j6ah"]”h$]”h&]”uh1jhj»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ñ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ÿ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&]”hjj]”ŒUnsorted documentation”Œ staging/index”†”aj(]”jaj*Kj+Nj,‰j-‰j.‰j/Kj0‰j1]”jauh1j hŸh³h Kphj ubah}”(h]”h ]”j6ah"]”h$]”h&]”uh1jhjì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”…””}”(hj0hj.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&]”hjj]”Œ Translations”Œtranslations/index”†”aj(]”jJaj*Kj+Nj,‰j-‰j.‰j/Kj0‰j1]”jIauh1j hŸh³h Kyhj<ubah}”(h]”h ]”j6ah"]”h$]”h&]”uh1jhj+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”…””}”(hjahj_hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhj\hžhhŸh³h KubhŒ bullet_list”“”)”}”(hhh]”hŒ list_item”“”)”}”(hŒ:ref:`genindex`”h]”hØ)”}”(hjvh]”h)”}”(hjvh]”hŒinline”“”)”}”(hjvh]”hŒgenindex”…””}”(hhhj€hžhhŸNh Nubah}”(h]”h ]”(Œxref”Œstd”Œstd-ref”eh"]”h$]”h&]”uh1j~hj{ubah}”(h]”h ]”h"]”h$]”h&]”Œrefdoc”jŒ refdomain”j‹Œreftype”Œref”Œ refexplicit”‰Œrefwarn”ˆŒ reftarget”Œgenindex”uh1hhŸh³h Khjxubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh³h Khjtubah}”(h]”h ]”h"]”h$]”h&]”uh1jrhjohžhhŸh³h Nubah}”(h]”h ]”h"]”h$]”h&]”Œbullet”Œ*”uh1jmhŸh³h Khj\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Œ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”‰Œfile_insertion_enabled”ˆŒ raw_enabled”KŒline_length_limit”M'Œ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”‰Œ embed_images”‰Œ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Ûjvjsjaj^j¸jµjéjæj(j%jYjVj·j´uŒ nametypes”}”(jÀˆj¿Nj?Nj‡NjÞNjvNjaˆj¸NjéNj(NjYNj·Nuh}”(hÁhÄj¼hÄj<hçj„jBjÛjŠjsjáj^jXjµjyjæj»j%jìjVj+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”]”hŒsystem_message”“”)”}”(hhh]”hØ)”}”(hhh]”hŒ/Hyperlink target "linux-doc" is not referenced.”…””}”(hhhjUubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hjRubah}”(h]”h ]”h"]”h$]”h&]”Œlevel”KŒtype”ŒINFO”Œsource”h³Œline”Kuh1jPubaŒ transformer”NŒ include_log”]”Œ decoration”Nhžhub.