€•zaŒ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/admin-guide/abi”Œ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/admin-guide/abi”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒItalian”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ#/translations/it_IT/admin-guide/abi”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒJapanese”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ#/translations/ja_JP/admin-guide/abi”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒKorean”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ#/translations/ko_KR/admin-guide/abi”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒPortuguese (Brazilian)”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ#/translations/pt_BR/admin-guide/abi”Œ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/admin-guide/abi”Œ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³Œ=/var/lib/git/docbuild/linux/Documentation/admin-guide/abi.rst”h´KubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒLinux ABI description”h]”hŒLinux ABI description”…””}”(hhÏh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhhÊh²hh³hÇh´KubhŒtarget”“”)”}”(hŒA.. _abi_file_var_lib_git_docbuild_linux_Documentation_ABI_README:”h]”h}”(h]”h ]”h"]”h$]”h&]”Œrefid”ŒubjK)”}”(hhh]”(hý)”}”(hŒ…The fields should be use a simple notation, compatible with ReST markup. Also, the file **should not** have a top-level index, like::”h]”(hŒXThe fields should be use a simple notation, compatible with ReST markup. Also, the file ”…””}”(hjSh²hh³Nh´NubhŒstrong”“”)”}”(hŒ**should not**”h]”hŒ should not”…””}”(hj]h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j[hjSubhŒ have a top-level index, like:”…””}”(hjSh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hüh³j h´KhjPubhŒ literal_block”“”)”}”(hŒ === foo ===”h]”hŒ === foo ===”…””}”hjwsbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1juh³j h´KhjPubeh}”(h]”h ]”h"]”h$]”h&]”uh1jJhj>ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j4h³j h´Khj;ubah}”(h]”h ]”h"]”h$]”h&]”uh1j/hhëubhý)”}”(hŒHow things move between levels:”h]”hŒHow things move between levels:”…””}”(hj—h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hüh³j h´Khhëubhý)”}”(hŒWInterfaces in stable may move to obsolete, as long as the proper notification is given.”h]”hŒWInterfaces in stable may move to obsolete, as long as the proper notification is given.”…””}”(hj¥h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hüh³j h´Khhëubhý)”}”(hŒlInterfaces may be removed from obsolete and the kernel as long as the documented amount of time has gone by.”h]”hŒlInterfaces may be removed from obsolete and the kernel as long as the documented amount of time has gone by.”…””}”(hj³h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hüh³j h´Khhëubhý)”}”(hŒÅInterfaces in the testing state can move to the stable state when the developers feel they are finished. They cannot be removed from the kernel tree without going through the obsolete state first.”h]”hŒÅInterfaces in the testing state can move to the stable state when the developers feel they are finished. They cannot be removed from the kernel tree without going through the obsolete state first.”…””}”(hjÁh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hüh³j h´Khhëubhý)”}”(hŒdIt's up to the developer to place their interfaces in the category they wish for it to start out in.”h]”hŒfIt’s up to the developer to place their interfaces in the category they wish for it to start out in.”…””}”(hjÏh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hüh³j h´Khhëubhý)”}”(hŒWNotable bits of non-ABI, which should not under any circumstances be considered stable:”h]”hŒWNotable bits of non-ABI, which should not under any circumstances be considered stable:”…””}”(hjÝh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hüh³j h´KhhëubhŒ bullet_list”“”)”}”(hhh]”(hŒ list_item”“”)”}”(hŒÛKconfig. Userspace should not rely on the presence or absence of any particular Kconfig symbol, in /proc/config.gz, in the copy of .config commonly installed to /boot, or in any invocation of the kernel build process. ”h]”hý)”}”(hŒÚKconfig. Userspace should not rely on the presence or absence of any particular Kconfig symbol, in /proc/config.gz, in the copy of .config commonly installed to /boot, or in any invocation of the kernel build process.”h]”hŒÚKconfig. Userspace should not rely on the presence or absence of any particular Kconfig symbol, in /proc/config.gz, in the copy of .config commonly installed to /boot, or in any invocation of the kernel build process.”…””}”(hjöh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hüh³j h´Khjòubah}”(h]”h ]”h"]”h$]”h&]”uh1jðhjíubjñ)”}”(hŒËKernel-internal symbols. Do not rely on the presence, absence, location, or type of any kernel symbol, either in System.map files or the kernel binary itself. See :doc:`/process/stable-api-nonsense`. ”h]”hý)”}”(hŒÉKernel-internal symbols. Do not rely on the presence, absence, location, or type of any kernel symbol, either in System.map files or the kernel binary itself. See :doc:`/process/stable-api-nonsense`.”h]”(hŒ¥Kernel-internal symbols. Do not rely on the presence, absence, location, or type of any kernel symbol, either in System.map files or the kernel binary itself. See ”…””}”(hjh²hh³Nh´Nubh)”}”(hŒ#:doc:`/process/stable-api-nonsense`”h]”hŒinline”“”)”}”(hjh]”hŒ/process/stable-api-nonsense”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”(Œxref”Œstd”Œstd-doc”eh"]”h$]”h&]”uh1jhjubah}”(h]”h ]”h"]”h$]”h&]”Œrefdoc”Œadmin-guide/abi”Œ refdomain”j'Œreftype”Œdoc”Œ refexplicit”‰Œrefwarn”ˆŒ reftarget”Œ/process/stable-api-nonsense”uh1hh³j h´KhjubhŒ.”…””}”(hjh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hüh³j h´Khj ubah}”(h]”h ]”h"]”h$]”h&]”uh1jðhjíubeh}”(h]”h ]”h"]”h$]”h&]”Œbullet”Œ-”uh1jëh³j h´Khhëubeh}”(h]”(Œ introduction”hêeh ]”h"]”(Œ introduction”Œ