€•–YŒ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/filesystems/iomap/porting”Œ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/filesystems/iomap/porting”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒItalian”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ-/translations/it_IT/filesystems/iomap/porting”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒJapanese”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ-/translations/ja_JP/filesystems/iomap/porting”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒKorean”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ-/translations/ko_KR/filesystems/iomap/porting”Œ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/filesystems/iomap/porting”Œ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/filesystems/iomap/porting”Œ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³ŒG/var/lib/git/docbuild/linux/Documentation/filesystems/iomap/porting.rst”h´KubhŒtarget”“”)”}”(hŒ.. _iomap_porting:”h]”h}”(h]”Œ iomap-porting”ah ]”h"]”Œ iomap_porting”ah$]”h&]”uh1hÈh´Khhh²hh³hÇubh¶)”}”(hŒÈDumb style notes to maintain the author's sanity: Please try to start sentences on separate lines so that sentence changes don't bleed colors in diff. Heading decorations are documented in sphinx.rst.”h]”hŒÈDumb style notes to maintain the author's sanity: Please try to start sentences on separate lines so that sentence changes don't bleed colors in diff. Heading decorations are documented in sphinx.rst.”…””}”hhÖsbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1hµhhh²hh³hÇh´K ubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒPorting Your Filesystem”h]”hŒPorting Your Filesystem”…””}”(hhëh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1héhhæh²hh³hÇh´K ubhŒtopic”“”)”}”(hŒTable of Contents ”h]”(hê)”}”(hŒTable of Contents”h]”hŒTable of Contents”…””}”(hhÿh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1héhhûh³hÇh´KubhŒ bullet_list”“”)”}”(hhh]”(hŒ list_item”“”)”}”(hhh]”hŒ paragraph”“”)”}”(hhh]”hŒ reference”“”)”}”(hhh]”hŒ Why Convert?”…””}”(hjh²hh³Nh´Nubah}”(h]”Œid1”ah ]”h"]”h$]”h&]”Œrefid”Œ why-convert”uh1jhjubah}”(h]”h ]”h"]”h$]”h&]”uh1jhjubah}”(h]”h ]”h"]”h$]”h&]”uh1jhjubj)”}”(hhh]”j)”}”(hhh]”j)”}”(hhh]”hŒHow Do I Convert a Filesystem?”…””}”(hj@h²hh³Nh´Nubah}”(h]”Œid2”ah ]”h"]”h$]”h&]”Œrefid”Œhow-do-i-convert-a-filesystem”uh1jhj=ubah}”(h]”h ]”h"]”h$]”h&]”uh1jhj:ubah}”(h]”h ]”h"]”h$]”h&]”uh1jhjubeh}”(h]”h ]”h"]”h$]”h&]”uh1j hhûh²hh³Nh´Nubeh}”(h]”Œtable-of-contents”ah ]”(Œcontents”Œlocal”eh"]”Œtable of contents”ah$]”h&]”uh1hùh³hÇh´Khhæh²hubhå)”}”(hhh]”(hê)”}”(hŒ Why Convert?”h]”hŒ Why Convert?”…””}”(hjoh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefid”j'uh1héhjlh²hh³hÇh´Kubj)”}”(hŒ;There are several reasons to convert a filesystem to iomap:”h]”hŒ;There are several reasons to convert a filesystem to iomap:”…””}”(hj~h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´Khjlh²hubhŒ block_quote”“”)”}”(hXÎ1. The classic Linux I/O path is not terribly efficient. Pagecache operations lock a single base page at a time and then call into the filesystem to return a mapping for only that page. Direct I/O operations build I/O requests a single file block at a time. This worked well enough for direct/indirect-mapped filesystems such as ext2, but is very inefficient for extent-based filesystems such as XFS. 2. Large folios are only supported via iomap; there are no plans to convert the old buffer_head path to use them. 3. Direct access to storage on memory-like devices (fsdax) is only supported via iomap. 4. Lower maintenance overhead for individual filesystem maintainers. iomap handles common pagecache related operations itself, such as allocating, instantiating, locking, and unlocking of folios. No ->write_begin(), ->write_end() or direct_IO address_space_operations are required to be implemented by filesystem using iomap. ”h]”hŒenumerated_list”“”)”}”(hhh]”(j)”}”(hXŽThe classic Linux I/O path is not terribly efficient. Pagecache operations lock a single base page at a time and then call into the filesystem to return a mapping for only that page. Direct I/O operations build I/O requests a single file block at a time. This worked well enough for direct/indirect-mapped filesystems such as ext2, but is very inefficient for extent-based filesystems such as XFS. ”h]”j)”}”(hXThe classic Linux I/O path is not terribly efficient. Pagecache operations lock a single base page at a time and then call into the filesystem to return a mapping for only that page. Direct I/O operations build I/O requests a single file block at a time. This worked well enough for direct/indirect-mapped filesystems such as ext2, but is very inefficient for extent-based filesystems such as XFS.”h]”hXThe classic Linux I/O path is not terribly efficient. Pagecache operations lock a single base page at a time and then call into the filesystem to return a mapping for only that page. Direct I/O operations build I/O requests a single file block at a time. This worked well enough for direct/indirect-mapped filesystems such as ext2, but is very inefficient for extent-based filesystems such as XFS.”…””}”(hj›h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´Khj—ubah}”(h]”h ]”h"]”h$]”h&]”uh1jhj”ubj)”}”(hŒoLarge folios are only supported via iomap; there are no plans to convert the old buffer_head path to use them. ”h]”j)”}”(hŒnLarge folios are only supported via iomap; there are no plans to convert the old buffer_head path to use them.”h]”hŒnLarge folios are only supported via iomap; there are no plans to convert the old buffer_head path to use them.”…””}”(hj³h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´Khj¯ubah}”(h]”h ]”h"]”h$]”h&]”uh1jhj”ubj)”}”(hŒUDirect access to storage on memory-like devices (fsdax) is only supported via iomap. ”h]”j)”}”(hŒTDirect access to storage on memory-like devices (fsdax) is only supported via iomap.”h]”hŒTDirect access to storage on memory-like devices (fsdax) is only supported via iomap.”…””}”(hjËh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´K"hjÇubah}”(h]”h ]”h"]”h$]”h&]”uh1jhj”ubj)”}”(hXCLower maintenance overhead for individual filesystem maintainers. iomap handles common pagecache related operations itself, such as allocating, instantiating, locking, and unlocking of folios. No ->write_begin(), ->write_end() or direct_IO address_space_operations are required to be implemented by filesystem using iomap. ”h]”j)”}”(hXBLower maintenance overhead for individual filesystem maintainers. iomap handles common pagecache related operations itself, such as allocating, instantiating, locking, and unlocking of folios. No ->write_begin(), ->write_end() or direct_IO address_space_operations are required to be implemented by filesystem using iomap.”h]”hXBLower maintenance overhead for individual filesystem maintainers. iomap handles common pagecache related operations itself, such as allocating, instantiating, locking, and unlocking of folios. No ->write_begin(), ->write_end() or direct_IO address_space_operations are required to be implemented by filesystem using iomap.”…””}”(hjãh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´K%hjßubah}”(h]”h ]”h"]”h$]”h&]”uh1jhj”ubeh}”(h]”h ]”h"]”h$]”h&]”Œenumtype”Œarabic”Œprefix”hŒsuffix”Œ.”uh1j’hjŽubah}”(h]”h ]”h"]”h$]”h&]”uh1jŒh³hÇh´Khjlh²hubeh}”(h]”j-ah ]”h"]”Œ why convert?”ah$]”h&]”uh1hähhæh²hh³hÇh´Kubhå)”}”(hhh]”(hê)”}”(hŒHow Do I Convert a Filesystem?”h]”hŒHow Do I Convert a Filesystem?”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”j}jIuh1héhjh²hh³hÇh´K-ubj)”}”(hX8First, add ``#include `` from your source code and add ``select FS_IOMAP`` to your filesystem's Kconfig option. Build the kernel, run fstests with the ``-g all`` option across a wide variety of your filesystem's supported configurations to build a baseline of which tests pass and which ones fail.”h]”(hŒ First, add ”…””}”(hj h²hh³Nh´NubhŒliteral”“”)”}”(hŒ``#include ``”h]”hŒ#include ”…””}”(hj*h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j(hj ubhŒ from your source code and add ”…””}”(hj h²hh³Nh´Nubj))”}”(hŒ``select FS_IOMAP``”h]”hŒselect FS_IOMAP”…””}”(hj<h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j(hj ubhŒO to your filesystem’s Kconfig option. Build the kernel, run fstests with the ”…””}”(hj h²hh³Nh´Nubj))”}”(hŒ ``-g all``”h]”hŒ-g all”…””}”(hjNh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j(hj ubhŒŠ option across a wide variety of your filesystem’s supported configurations to build a baseline of which tests pass and which ones fail.”…””}”(hj h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´K/hjh²hubj)”}”(hXEThe recommended approach is first to implement ``->iomap_begin`` (and ``->iomap_end`` if necessary) to allow iomap to obtain a read-only mapping of a file range. In most cases, this is a relatively trivial conversion of the existing ``get_block()`` function for read-only mappings. ``FS_IOC_FIEMAP`` is a good first target because it is trivial to implement support for it and then to determine that the extent map iteration is correct from userspace. If FIEMAP is returning the correct information, it's a good sign that other read-only mapping operations will do the right thing.”h]”(hŒ/The recommended approach is first to implement ”…””}”(hjfh²hh³Nh´Nubj))”}”(hŒ``->iomap_begin``”h]”hŒ ->iomap_begin”…””}”(hjnh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j(hjfubhŒ (and ”…””}”(hjfh²hh³Nh´Nubj))”}”(hŒ``->iomap_end``”h]”hŒ ->iomap_end”…””}”(hj€h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j(hjfubhŒ” if necessary) to allow iomap to obtain a read-only mapping of a file range. In most cases, this is a relatively trivial conversion of the existing ”…””}”(hjfh²hh³Nh´Nubj))”}”(hŒ``get_block()``”h]”hŒ get_block()”…””}”(hj’h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j(hjfubhŒ" function for read-only mappings. ”…””}”(hjfh²hh³Nh´Nubj))”}”(hŒ``FS_IOC_FIEMAP``”h]”hŒ FS_IOC_FIEMAP”…””}”(hj¤h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j(hjfubhX is a good first target because it is trivial to implement support for it and then to determine that the extent map iteration is correct from userspace. If FIEMAP is returning the correct information, it’s a good sign that other read-only mapping operations will do the right thing.”…””}”(hjfh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´K5hjh²hubj)”}”(hXÜNext, modify the filesystem's ``get_block(create = false)`` implementation to use the new ``->iomap_begin`` implementation to map file space for selected read operations. Hide behind a debugging knob the ability to switch on the iomap mapping functions for selected call paths. It is necessary to write some code to fill out the bufferhead-based mapping information from the ``iomap`` structure, but the new functions can be tested without needing to implement any iomap APIs.”h]”(hŒ Next, modify the filesystem’s ”…””}”(hj¼h²hh³Nh´Nubj))”}”(hŒ``get_block(create = false)``”h]”hŒget_block(create = false)”…””}”(hjÄh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j(hj¼ubhŒ implementation to use the new ”…””}”(hj¼h²hh³Nh´Nubj))”}”(hŒ``->iomap_begin``”h]”hŒ ->iomap_begin”…””}”(hjÖh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j(hj¼ubhX  implementation to map file space for selected read operations. Hide behind a debugging knob the ability to switch on the iomap mapping functions for selected call paths. It is necessary to write some code to fill out the bufferhead-based mapping information from the ”…””}”(hj¼h²hh³Nh´Nubj))”}”(hŒ ``iomap``”h]”hŒiomap”…””}”(hjèh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j(hj¼ubhŒ\ structure, but the new functions can be tested without needing to implement any iomap APIs.”…””}”(hj¼h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´K@hjh²hubj)”}”(hXwOnce the read-only functions are working like this, convert each high level file operation one by one to use iomap native APIs instead of going through ``get_block()``. Done one at a time, regressions should be self evident. You *do* have a regression test baseline for fstests, right? It is suggested to convert swap file activation, ``SEEK_DATA``, and ``SEEK_HOLE`` before tackling the I/O paths. A likely complexity at this point will be converting the buffered read I/O path because of bufferheads. The buffered read I/O paths doesn't need to be converted yet, though the direct I/O read path should be converted in this phase.”h]”(hŒ˜Once the read-only functions are working like this, convert each high level file operation one by one to use iomap native APIs instead of going through ”…””}”(hjh²hh³Nh´Nubj))”}”(hŒ``get_block()``”h]”hŒ get_block()”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j(hjubhŒ>. Done one at a time, regressions should be self evident. You ”…””}”(hjh²hh³Nh´NubhŒemphasis”“”)”}”(hŒ*do*”h]”hŒdo”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jhjubhŒf have a regression test baseline for fstests, right? It is suggested to convert swap file activation, ”…””}”(hjh²hh³Nh´Nubj))”}”(hŒ ``SEEK_DATA``”h]”hŒ SEEK_DATA”…””}”(hj.h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j(hjubhŒ, and ”…””}”(hjh²hh³Nh´Nubj))”}”(hŒ ``SEEK_HOLE``”h]”hŒ SEEK_HOLE”…””}”(hj@h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j(hjubhX  before tackling the I/O paths. A likely complexity at this point will be converting the buffered read I/O path because of bufferheads. The buffered read I/O paths doesn’t need to be converted yet, though the direct I/O read path should be converted in this phase.”…””}”(hjh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´KIhjh²hubj)”}”(hX&At this point, you should look over your ``->iomap_begin`` function. If it switches between large blocks of code based on dispatching of the ``flags`` argument, you should consider breaking it up into per-operation iomap ops with smaller, more cohesive functions. XFS is a good example of this.”h]”(hŒ)At this point, you should look over your ”…””}”(hjXh²hh³Nh´Nubj))”}”(hŒ``->iomap_begin``”h]”hŒ ->iomap_begin”…””}”(hj`h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j(hjXubhŒS function. If it switches between large blocks of code based on dispatching of the ”…””}”(hjXh²hh³Nh´Nubj))”}”(hŒ ``flags``”h]”hŒflags”…””}”(hjrh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j(hjXubhŒ argument, you should consider breaking it up into per-operation iomap ops with smaller, more cohesive functions. XFS is a good example of this.”…””}”(hjXh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´KUhjh²hubj)”}”(hXÆThe next thing to do is implement ``get_blocks(create == true)`` functionality in the ``->iomap_begin``/``->iomap_end`` methods. It is strongly recommended to create separate mapping functions and iomap ops for write operations. Then convert the direct I/O write path to iomap, and start running fsx w/ DIO enabled in earnest on filesystem. This will flush out lots of data integrity corner case bugs that the new write mapping implementation introduces.”h]”(hŒ"The next thing to do is implement ”…””}”(hjŠh²hh³Nh´Nubj))”}”(hŒ``get_blocks(create == true)``”h]”hŒget_blocks(create == true)”…””}”(hj’h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j(hjŠubhŒ functionality in the ”…””}”(hjŠh²hh³Nh´Nubj))”}”(hŒ``->iomap_begin``”h]”hŒ ->iomap_begin”…””}”(hj¤h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j(hjŠubhŒ/”…””}”(hjŠh²hh³Nh´Nubj))”}”(hŒ``->iomap_end``”h]”hŒ ->iomap_end”…””}”(hj¶h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j(hjŠubhXO methods. It is strongly recommended to create separate mapping functions and iomap ops for write operations. Then convert the direct I/O write path to iomap, and start running fsx w/ DIO enabled in earnest on filesystem. This will flush out lots of data integrity corner case bugs that the new write mapping implementation introduces.”…””}”(hjŠh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´K[hjh²hubj)”}”(hŒ×Now, convert any remaining file operations to call the iomap functions. This will get the entire filesystem using the new mapping functions, and they should largely be debugged and working correctly after this step.”h]”hŒ×Now, convert any remaining file operations to call the iomap functions. This will get the entire filesystem using the new mapping functions, and they should largely be debugged and working correctly after this step.”…””}”(hjÎh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´Kdhjh²hubj)”}”(hXŽMost likely at this point, the buffered read and write paths will still need to be converted. The mapping functions should all work correctly, so all that needs to be done is rewriting all the code that interfaces with bufferheads to interface with iomap and folios. It is much easier first to get regular file I/O (without any fancy features like fscrypt, fsverity, compression, or data=journaling) converted to use iomap. Some of those fancy features (fscrypt and compression) aren't implemented yet in iomap. For unjournalled filesystems that use the pagecache for symbolic links and directories, you might also try converting their handling to iomap.”h]”hXMost likely at this point, the buffered read and write paths will still need to be converted. The mapping functions should all work correctly, so all that needs to be done is rewriting all the code that interfaces with bufferheads to interface with iomap and folios. It is much easier first to get regular file I/O (without any fancy features like fscrypt, fsverity, compression, or data=journaling) converted to use iomap. Some of those fancy features (fscrypt and compression) aren’t implemented yet in iomap. For unjournalled filesystems that use the pagecache for symbolic links and directories, you might also try converting their handling to iomap.”…””}”(hjÜh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´Khhjh²hubj)”}”(hŒ·The rest is left as an exercise for the reader, as it will be different for every filesystem. If you encounter problems, email the people and lists in ``get_maintainers.pl`` for help.”h]”(hŒ—The rest is left as an exercise for the reader, as it will be different for every filesystem. If you encounter problems, email the people and lists in ”…””}”(hjêh²hh³Nh´Nubj))”}”(hŒ``get_maintainers.pl``”h]”hŒget_maintainers.pl”…””}”(hjòh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j(hjêubhŒ for help.”…””}”(hjêh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´Kuhjh²hubeh}”(h]”jOah ]”h"]”Œhow do i convert a filesystem?”ah$]”h&]”uh1hähhæh²hh³hÇh´K-ubeh}”(h]”Œporting-your-filesystem”ah ]”h"]”Œporting your filesystem”ah$]”h&]”uh1hähhh²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”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”}”Œnameids”}”(hÓhÐjjjijdj j-jjOuŒ nametypes”}”(hÓˆj‰ji‰j ‰j‰uh}”(hÐhÊjhæjdhûj-jljOjj'jjIj@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”“”}”jJKs…”R”Œparse_messages”]”Œtransform_messages”]”hŒsystem_message”“”)”}”(hhh]”j)”}”(hhh]”hŒ3Hyperlink target "iomap_porting" is not referenced.”…””}”hj¥sbah}”(h]”h ]”h"]”h$]”h&]”uh1jhj¢ubah}”(h]”h ]”h"]”h$]”h&]”Œlevel”KŒtype”ŒINFO”Œsource”hÇŒline”Kuh1j ubaŒ transformer”NŒ include_log”]”Œ decoration”Nh²hub.