sphinx.addnodesdocument)}( rawsourcechildren]( translations LanguagesNode)}(hhh](h pending_xref)}(hhh]docutils.nodesTextChinese (Simplified)}parenthsba attributes}(ids]classes]names]dupnames]backrefs] refdomainstdreftypedoc reftarget&/translations/zh_CN/filesystems/buffermodnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Traditional)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget&/translations/zh_TW/filesystems/buffermodnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget&/translations/it_IT/filesystems/buffermodnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget&/translations/ja_JP/filesystems/buffermodnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget&/translations/ko_KR/filesystems/buffermodnameN classnameN refexplicituh1hhh ubh)}(hhh]hPortuguese (Brazilian)}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget&/translations/pt_BR/filesystems/buffermodnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget&/translations/sp_SP/filesystems/buffermodnameN classnameN refexplicituh1hhh ubeh}(h]h ]h"]h$]h&]current_languageEnglishuh1h hh _documenthsourceNlineNubhsection)}(hhh](htitle)}(h Buffer Headsh]h Buffer Heads}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhh@/var/lib/git/docbuild/linux/Documentation/filesystems/buffer.rsthKubh paragraph)}(hLinux uses buffer heads to maintain state about individual filesystem blocks. Buffer heads are deprecated and new filesystems should use iomap instead.h]hLinux uses buffer heads to maintain state about individual filesystem blocks. Buffer heads are deprecated and new filesystems should use iomap instead.}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh)}(hhh](h)}(h Functionsh]h Functions}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhhhKubhindex)}(hhh]h}(h]h ]h"]h$]h&]entries](singlebrelse (C function)c.brelsehNtauh1hhhhhhNhNubhdesc)}(hhh](hdesc_signature)}(h$void brelse (struct buffer_head *bh)h]hdesc_signature_line)}(h#void brelse(struct buffer_head *bh)h](hdesc_sig_keyword_type)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]ktah"]h$]h&]uh1jhj hhh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhM0ubhdesc_sig_space)}(h h]h }(hj"hhhNhNubah}(h]h ]wah"]h$]h&]uh1j hj hhhjhM0ubh desc_name)}(hbrelseh]h desc_sig_name)}(hbrelseh]hbrelse}(hj9hhhNhNubah}(h]h ]nah"]h$]h&]uh1j7hj3ubah}(h]h ](sig-namedescnameeh"]h$]h&] xml:spacepreserveuh1j1hj hhhjhM0ubhdesc_parameterlist)}(h(struct buffer_head *bh)h]hdesc_parameter)}(hstruct buffer_head *bhh](hdesc_sig_keyword)}(hstructh]hstruct}(hj`hhhNhNubah}(h]h ]kah"]h$]h&]uh1j^hjZubj!)}(h h]h }(hjohhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjZubh)}(hhh]j8)}(h buffer_headh]h buffer_head}(hjhhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hj}ubah}(h]h ]h"]h$]h&] refdomaincreftype identifier reftargetjmodnameN classnameN c:parent_keysphinx.domains.c LookupKey)}data]j ASTIdentifier)}jj;sbc.brelseasbuh1hhjZubj!)}(h h]h }(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjZubhdesc_sig_punctuation)}(h*h]h*}(hjhhhNhNubah}(h]h ]pah"]h$]h&]uh1jhjZubj8)}(hbhh]hbh}(hjhhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hjZubeh}(h]h ]h"]h$]h&]noemphjPjQuh1jXhjTubah}(h]h ]h"]h$]h&]jPjQuh1jRhj hhhjhM0ubeh}(h]h ]h"]h$]h&]jPjQ add_permalinkuh1jsphinx_line_type declaratorhjhhhjhM0ubah}(h]hah ](sig sig-objecteh"]h$]h&] is_multiline _toc_parts) _toc_namehuh1jhjhM0hhhhubh desc_content)}(hhh]h)}(hRelease a buffer.h]hRelease a buffer.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhM0hjhhubah}(h]h ]h"]h$]h&]uh1jhhhhhjhM0ubeh}(h]h ](jfunctioneh"]h$]h&]domainjobjtypejdesctypejnoindex noindexentrynocontentsentryuh1hhhhhhNhNubh container)}(hX%**Parameters** ``struct buffer_head *bh`` The buffer to release. **Description** Decrement a buffer_head's reference count. If **bh** is NULL, this function is a no-op. If all buffers on a folio have zero reference count, are clean and unlocked, and if the folio is unlocked and not under writeback then try_to_free_buffers() may strip the buffers from the folio in preparation for freeing it (sometimes, rarely, buffers are removed from a folio but it ends up not being freed, and buffers may later be reattached). **Context** Any context.h](h)}(h**Parameters**h]hstrong)}(hj&h]h Parameters}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hj$ubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhM4hj ubhdefinition_list)}(hhh]hdefinition_list_item)}(h2``struct buffer_head *bh`` The buffer to release. h](hterm)}(h``struct buffer_head *bh``h]hliteral)}(hjMh]hstruct buffer_head *bh}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jOhjKubah}(h]h ]h"]h$]h&]uh1jIh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhM1hjEubh definition)}(hhh]h)}(hThe buffer to release.h]hThe buffer to release.}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjdhM1hjgubah}(h]h ]h"]h$]h&]uh1jehjEubeh}(h]h ]h"]h$]h&]uh1jChjdhM1hj@ubah}(h]h ]h"]h$]h&]uh1j>hj ubh)}(h**Description**h]j))}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhM3hj ubh)}(hXDecrement a buffer_head's reference count. If **bh** is NULL, this function is a no-op.h](h1Decrement a buffer_head’s reference count. If }(hjhhhNhNubj))}(h**bh**h]hbh}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubh# is NULL, this function is a no-op.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhM2hj ubh)}(hXZIf all buffers on a folio have zero reference count, are clean and unlocked, and if the folio is unlocked and not under writeback then try_to_free_buffers() may strip the buffers from the folio in preparation for freeing it (sometimes, rarely, buffers are removed from a folio but it ends up not being freed, and buffers may later be reattached).h]hXZIf all buffers on a folio have zero reference count, are clean and unlocked, and if the folio is unlocked and not under writeback then try_to_free_buffers() may strip the buffers from the folio in preparation for freeing it (sometimes, rarely, buffers are removed from a folio but it ends up not being freed, and buffers may later be reattached).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhM5hj ubh)}(h **Context**h]j))}(hjh]hContext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhM<hj ubh)}(h Any context.h]h Any context.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhM=hj ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hbforget (C function) c.bforgethNtauh1hhhhhhNhNubh)}(hhh](j)}(h%void bforget (struct buffer_head *bh)h]j )}(h$void bforget(struct buffer_head *bh)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMFubj!)}(h h]h }(hj(hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjhhhj'hMFubj2)}(hbforgeth]j8)}(hbforgeth]hbforget}(hj:hhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hj6ubah}(h]h ](jKjLeh"]h$]h&]jPjQuh1j1hjhhhj'hMFubjS)}(h(struct buffer_head *bh)h]jY)}(hstruct buffer_head *bhh](j_)}(hjbh]hstruct}(hjVhhhNhNubah}(h]h ]jkah"]h$]h&]uh1j^hjRubj!)}(h h]h }(hjchhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjRubh)}(hhh]j8)}(h buffer_headh]h buffer_head}(hjthhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hjqubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjvmodnameN classnameNjj)}j]j)}jj<sb c.bforgetasbuh1hhjRubj!)}(h h]h }(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjRubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRubj8)}(hbhh]hbh}(hjhhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hjRubeh}(h]h ]h"]h$]h&]noemphjPjQuh1jXhjNubah}(h]h ]h"]h$]h&]jPjQuh1jRhjhhhj'hMFubeh}(h]h ]h"]h$]h&]jPjQjuh1jjjhjhhhj'hMFubah}(h]j ah ](jjeh"]h$]h&]jj)jhuh1jhj'hMFhjhhubj)}(hhh]h)}(h#Discard any dirty data in a buffer.h]h#Discard any dirty data in a buffer.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMFhjhhubah}(h]h ]h"]h$]h&]uh1jhjhhhj'hMFubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1hhhhhhNhNubj)}(hX.**Parameters** ``struct buffer_head *bh`` The buffer to forget. **Description** Call this function instead of brelse() if the data written to a buffer no longer needs to be written back. It will clear the buffer's dirty flag so writeback of this buffer will be skipped. **Context** Any context.h](h)}(h**Parameters**h]j))}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMJhjubj?)}(hhh]jD)}(h1``struct buffer_head *bh`` The buffer to forget. h](jJ)}(h``struct buffer_head *bh``h]jP)}(hjh]hstruct buffer_head *bh}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jOhjubah}(h]h ]h"]h$]h&]uh1jIh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMGhjubjf)}(hhh]h)}(hThe buffer to forget.h]hThe buffer to forget.}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/hMGhj0ubah}(h]h ]h"]h$]h&]uh1jehjubeh}(h]h ]h"]h$]h&]uh1jChj/hMGhjubah}(h]h ]h"]h$]h&]uh1j>hjubh)}(h**Description**h]j))}(hjUh]h Description}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjSubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMIhjubh)}(hCall this function instead of brelse() if the data written to a buffer no longer needs to be written back. It will clear the buffer's dirty flag so writeback of this buffer will be skipped.h]hCall this function instead of brelse() if the data written to a buffer no longer needs to be written back. It will clear the buffer’s dirty flag so writeback of this buffer will be skipped.}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMHhjubh)}(h **Context**h]j))}(hj|h]hContext}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjzubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMLhjubh)}(h Any context.h]h Any context.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h__bread (C function) c.__breadhNtauh1hhhhhhNhNubh)}(hhh](j)}(hWstruct buffer_head * __bread (struct block_device *bdev, sector_t block, unsigned size)h]j )}(hUstruct buffer_head *__bread(struct block_device *bdev, sector_t block, unsigned size)h](j_)}(hjbh]hstruct}(hjhhhNhNubah}(h]h ]jkah"]h$]h&]uh1j^hjhhh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMubj!)}(h h]h }(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjhhhjhMubh)}(hhh]j8)}(h buffer_headh]h buffer_head}(hjhhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj)}j]j)}j__breadsb c.__breadasbuh1hhjhhhjhMubj!)}(h h]h }(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjhhhjhMubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubj2)}(h__breadh]j8)}(hjh]h__bread}(hj hhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hjubah}(h]h ](jKjLeh"]h$]h&]jPjQuh1j1hjhhhjhMubjS)}(h:(struct block_device *bdev, sector_t block, unsigned size)h](jY)}(hstruct block_device *bdevh](j_)}(hjbh]hstruct}(hj;hhhNhNubah}(h]h ]jkah"]h$]h&]uh1j^hj7ubj!)}(h h]h }(hjHhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj7ubh)}(hhh]j8)}(h block_deviceh]h block_device}(hjYhhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hjVubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj[modnameN classnameNjj)}j]j c.__breadasbuh1hhj7ubj!)}(h h]h }(hjwhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj7ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7ubj8)}(hbdevh]hbdev}(hjhhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hj7ubeh}(h]h ]h"]h$]h&]noemphjPjQuh1jXhj3ubjY)}(hsector_t blockh](h)}(hhh]j8)}(hsector_th]hsector_t}(hjhhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj)}j]j c.__breadasbuh1hhjubj!)}(h h]h }(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjubj8)}(hblockh]hblock}(hjhhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hjubeh}(h]h ]h"]h$]h&]noemphjPjQuh1jXhj3ubjY)}(h unsigned sizeh](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj!)}(h h]h }(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjubj8)}(hsizeh]hsize}(hjhhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hjubeh}(h]h ]h"]h$]h&]noemphjPjQuh1jXhj3ubeh}(h]h ]h"]h$]h&]jPjQuh1jRhjhhhjhMubeh}(h]h ]h"]h$]h&]jPjQjuh1jjjhjhhhjhMubah}(h]jah ](jjeh"]h$]h&]jj)jhuh1jhjhMhjhhubj)}(hhh]h)}(h Read a block.h]h Read a block.}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMhj6hhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjQjjQjjjuh1hhhhhhNhNubj)}(hX=**Parameters** ``struct block_device *bdev`` The block device to read from. ``sector_t block`` Block number in units of block size. ``unsigned size`` The block size of this device in bytes. **Description** Read a specified block, and return the buffer head that refers to it. The memory is allocated from the movable area so that it can be migrated. The returned buffer head has its refcount increased. The caller should call brelse() when it has finished with the buffer. **Context** May sleep waiting for I/O. **Return** NULL if the block was unreadable.h](h)}(h**Parameters**h]j))}(hj[h]h Parameters}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjYubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMhjUubj?)}(hhh](jD)}(h=``struct block_device *bdev`` The block device to read from. h](jJ)}(h``struct block_device *bdev``h]jP)}(hjzh]hstruct block_device *bdev}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1jOhjxubah}(h]h ]h"]h$]h&]uh1jIh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMhjtubjf)}(hhh]h)}(hThe block device to read from.h]hThe block device to read from.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jehjtubeh}(h]h ]h"]h$]h&]uh1jChjhMhjqubjD)}(h8``sector_t block`` Block number in units of block size. h](jJ)}(h``sector_t block``h]jP)}(hjh]hsector_t block}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jOhjubah}(h]h ]h"]h$]h&]uh1jIh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMhjubjf)}(hhh]h)}(h$Block number in units of block size.h]h$Block number in units of block size.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jehjubeh}(h]h ]h"]h$]h&]uh1jChjhMhjqubjD)}(h:``unsigned size`` The block size of this device in bytes. h](jJ)}(h``unsigned size``h]jP)}(hjh]h unsigned size}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jOhjubah}(h]h ]h"]h$]h&]uh1jIh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMhjubjf)}(hhh]h)}(h'The block size of this device in bytes.h]h'The block size of this device in bytes.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jehjubeh}(h]h ]h"]h$]h&]uh1jChjhMhjqubeh}(h]h ]h"]h$]h&]uh1j>hjUubh)}(h**Description**h]j))}(hj'h]h Description}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hj%ubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMhjUubh)}(hX Read a specified block, and return the buffer head that refers to it. The memory is allocated from the movable area so that it can be migrated. The returned buffer head has its refcount increased. The caller should call brelse() when it has finished with the buffer.h]hX Read a specified block, and return the buffer head that refers to it. The memory is allocated from the movable area so that it can be migrated. The returned buffer head has its refcount increased. The caller should call brelse() when it has finished with the buffer.}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMhjUubh)}(h **Context**h]j))}(hjNh]hContext}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjLubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMhjUubh)}(hMay sleep waiting for I/O.h]hMay sleep waiting for I/O.}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMhjUubh)}(h **Return**h]j))}(hjuh]hReturn}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjsubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMhjUubh)}(h!NULL if the block was unreadable.h]h!NULL if the block was unreadable.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMhjUubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hget_nth_bh (C function) c.get_nth_bhhNtauh1hhhhhhNhNubh)}(hhh](j)}(hLstruct buffer_head * get_nth_bh (struct buffer_head *bh, unsigned int count)h]j )}(hJstruct buffer_head *get_nth_bh(struct buffer_head *bh, unsigned int count)h](j_)}(hjbh]hstruct}(hjhhhNhNubah}(h]h ]jkah"]h$]h&]uh1j^hjhhh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMubj!)}(h h]h }(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjhhhjhMubh)}(hhh]j8)}(h buffer_headh]h buffer_head}(hjhhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj)}j]j)}j get_nth_bhsb c.get_nth_bhasbuh1hhjhhhjhMubj!)}(h h]h }(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjhhhjhMubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubj2)}(h get_nth_bhh]j8)}(hjh]h get_nth_bh}(hjhhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hjubah}(h]h ](jKjLeh"]h$]h&]jPjQuh1j1hjhhhjhMubjS)}(h,(struct buffer_head *bh, unsigned int count)h](jY)}(hstruct buffer_head *bhh](j_)}(hjbh]hstruct}(hj4hhhNhNubah}(h]h ]jkah"]h$]h&]uh1j^hj0ubj!)}(h h]h }(hjAhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj0ubh)}(hhh]j8)}(h buffer_headh]h buffer_head}(hjRhhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hjOubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjTmodnameN classnameNjj)}j]j c.get_nth_bhasbuh1hhj0ubj!)}(h h]h }(hjphhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj0ubj)}(hjh]h*}(hj~hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubj8)}(hbhh]hbh}(hjhhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hj0ubeh}(h]h ]h"]h$]h&]noemphjPjQuh1jXhj,ubjY)}(hunsigned int counth](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj!)}(h h]h }(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjubj)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj!)}(h h]h }(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjubj8)}(hcounth]hcount}(hjhhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hjubeh}(h]h ]h"]h$]h&]noemphjPjQuh1jXhj,ubeh}(h]h ]h"]h$]h&]jPjQuh1jRhjhhhjhMubeh}(h]h ]h"]h$]h&]jPjQjuh1jjjhjhhhjhMubah}(h]jah ](jjeh"]h$]h&]jj)jhuh1jhjhMhjhhubj)}(hhh]h)}(h2Get a reference on the n'th buffer after this one.h]h4Get a reference on the n’th buffer after this one.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMhj hhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjj jj jjjuh1hhhhhhNhNubj)}(hX**Parameters** ``struct buffer_head *bh`` The buffer to start counting from. ``unsigned int count`` How many buffers to skip. **Description** This is primarily useful for finding the nth buffer in a folio; in that case you pass the head buffer and the byte offset in the folio divided by the block size. It can be used for other purposes, but it will wrap at the end of the folio rather than returning NULL or proceeding to the next folio for you. **Return** The requested buffer with an elevated refcount.h](h)}(h**Parameters**h]j))}(hj( h]h Parameters}(hj* hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hj& ubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMhj" ubj?)}(hhh](jD)}(h>``struct buffer_head *bh`` The buffer to start counting from. h](jJ)}(h``struct buffer_head *bh``h]jP)}(hjG h]hstruct buffer_head *bh}(hjI hhhNhNubah}(h]h ]h"]h$]h&]uh1jOhjE ubah}(h]h ]h"]h$]h&]uh1jIh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMhjA ubjf)}(hhh]h)}(h"The buffer to start counting from.h]h"The buffer to start counting from.}(hj` hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj\ hMhj] ubah}(h]h ]h"]h$]h&]uh1jehjA ubeh}(h]h ]h"]h$]h&]uh1jChj\ hMhj> ubjD)}(h1``unsigned int count`` How many buffers to skip. h](jJ)}(h``unsigned int count``h]jP)}(hj h]hunsigned int count}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jOhj~ ubah}(h]h ]h"]h$]h&]uh1jIh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMhjz ubjf)}(hhh]h)}(hHow many buffers to skip.h]hHow many buffers to skip.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMhj ubah}(h]h ]h"]h$]h&]uh1jehjz ubeh}(h]h ]h"]h$]h&]uh1jChj hMhj> ubeh}(h]h ]h"]h$]h&]uh1j>hj" ubh)}(h**Description**h]j))}(hj h]h Description}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hj ubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMhj" ubh)}(hX2This is primarily useful for finding the nth buffer in a folio; in that case you pass the head buffer and the byte offset in the folio divided by the block size. It can be used for other purposes, but it will wrap at the end of the folio rather than returning NULL or proceeding to the next folio for you.h]hX2This is primarily useful for finding the nth buffer in a folio; in that case you pass the head buffer and the byte offset in the folio divided by the block size. It can be used for other purposes, but it will wrap at the end of the folio rather than returning NULL or proceeding to the next folio for you.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMhj" ubh)}(h **Return**h]j))}(hj h]hReturn}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hj ubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMhj" ubh)}(h/The requested buffer with an elevated refcount.h]h/The requested buffer with an elevated refcount.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMhj" ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hbio_endio_bh (C function)c.bio_endio_bhhNtauh1hhhhhhNhNubh)}(hhh](j)}(h=bool bio_endio_bh (struct bio *bio, struct buffer_head **bhp)h]j )}(h``struct buffer_head **bhp`` Where to return the buffer_head. h](jJ)}(h``struct buffer_head **bhp``h]jP)}(hj h]hstruct buffer_head **bhp}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jOhj ubah}(h]h ]h"]h$]h&]uh1jIhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chKhj ubjf)}(hhh]h)}(h Where to return the buffer_head.h]h Where to return the buffer_head.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hKhj ubah}(h]h ]h"]h$]h&]uh1jehj ubeh}(h]h ]h"]h$]h&]uh1jChj hKhj ubeh}(h]h ]h"]h$]h&]uh1j>hj ubh)}(h**Description**h]j))}(hj h]h Description}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hj ubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chKhj ubh)}(hCall this in your bio_end_io handler to retrieve the buffer_head submitted in bh_submit(). If you did not call bh_submit(), do not call this function; it will return garbage.h]hCall this in your bio_end_io handler to retrieve the buffer_head submitted in bh_submit(). If you did not call bh_submit(), do not call this function; it will return garbage.}(hj/ hhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chKhj ubh)}(hIThis function consumes the bio refcount which will probably free the bio.h]hIThis function consumes the bio refcount which will probably free the bio.}(hj> hhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chKhj ubh)}(h **Return**h]j))}(hjO h]hReturn}(hjQ hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjM ubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chKhj ubh)}(hTrue if the I/O succeeded.h]hTrue if the I/O succeeded.}(hje hhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chKhj ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h!end_buffer_read_sync (C function)c.end_buffer_read_synchNtauh1hhhhhhNhNubh)}(hhh](j)}(h@void end_buffer_read_sync (struct buffer_head *bh, int uptodate)h]j )}(h?void end_buffer_read_sync(struct buffer_head *bh, int uptodate)h](j)}(hvoidh]hvoid}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chKubj!)}(h h]h }(hj hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj hhhj hKubj2)}(hend_buffer_read_synch]j8)}(hend_buffer_read_synch]hend_buffer_read_sync}(hj hhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hj ubah}(h]h ](jKjLeh"]h$]h&]jPjQuh1j1hj hhhj hKubjS)}(h&(struct buffer_head *bh, int uptodate)h](jY)}(hstruct buffer_head *bhh](j_)}(hjbh]hstruct}(hj hhhNhNubah}(h]h ]jkah"]h$]h&]uh1j^hj ubj!)}(h h]h }(hj hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj ubh)}(hhh]j8)}(h buffer_headh]h buffer_head}(hj hhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hj ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj modnameN classnameNjj)}j]j)}jj sbc.end_buffer_read_syncasbuh1hhj ubj!)}(h h]h }(hj hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj ubj)}(hjh]h*}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj8)}(hbhh]hbh}(hj* hhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hj ubeh}(h]h ]h"]h$]h&]noemphjPjQuh1jXhj ubjY)}(h int uptodateh](j)}(hinth]hint}(hjC hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj? ubj!)}(h h]h }(hjQ hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj? ubj8)}(huptodateh]huptodate}(hj_ hhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hj? ubeh}(h]h ]h"]h$]h&]noemphjPjQuh1jXhj ubeh}(h]h ]h"]h$]h&]jPjQuh1jRhj hhhj hKubeh}(h]h ]h"]h$]h&]jPjQjuh1jjjhj hhhj hKubah}(h]j ah ](jjeh"]h$]h&]jj)jhuh1jhj hKhj hhubj)}(hhh]h)}(hHandle buffer reads finishingh]hHandle buffer reads finishing}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chKhj hhubah}(h]h ]h"]h$]h&]uh1jhj hhhj hKubeh}(h]h ](jfunctioneh"]h$]h&]jjjj jj jjjuh1hhhhhhNhNubj)}(h**Parameters** ``struct buffer_head *bh`` The buffer. ``int uptodate`` True if the read was successful. **Description** If a buffer is read through a mechanism that isn't bh_submit(), you can call this function to finish the read.h](h)}(h**Parameters**h]j))}(hj h]h Parameters}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hj ubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chKhj ubj?)}(hhh](jD)}(h'``struct buffer_head *bh`` The buffer. h](jJ)}(h``struct buffer_head *bh``h]jP)}(hj h]hstruct buffer_head *bh}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jOhj ubah}(h]h ]h"]h$]h&]uh1jIhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chKhj ubjf)}(hhh]h)}(h The buffer.h]h The buffer.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hKhj ubah}(h]h ]h"]h$]h&]uh1jehj ubeh}(h]h ]h"]h$]h&]uh1jChj hKhj ubjD)}(h2``int uptodate`` True if the read was successful. h](jJ)}(h``int uptodate``h]jP)}(hjh]h int uptodate}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jOhjubah}(h]h ]h"]h$]h&]uh1jIhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chKhj ubjf)}(hhh]h)}(h True if the read was successful.h]h True if the read was successful.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jehj ubeh}(h]h ]h"]h$]h&]uh1jChjhKhj ubeh}(h]h ]h"]h$]h&]uh1j>hj ubh)}(h**Description**h]j))}(hj>h]h Description}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hj<ubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chKhj ubh)}(hnIf a buffer is read through a mechanism that isn't bh_submit(), you can call this function to finish the read.h]hpIf a buffer is read through a mechanism that isn’t bh_submit(), you can call this function to finish the read.}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chKhj ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hbh_end_read (C function) c.bh_end_readhNtauh1hhhhhhNhNubh)}(hhh](j)}(h"void bh_end_read (struct bio *bio)h]j )}(h!void bh_end_read(struct bio *bio)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chKubj!)}(h h]h }(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjhhhjhKubj2)}(h bh_end_readh]j8)}(h bh_end_readh]h bh_end_read}(hjhhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hjubah}(h]h ](jKjLeh"]h$]h&]jPjQuh1j1hjhhhjhKubjS)}(h(struct bio *bio)h]jY)}(hstruct bio *bioh](j_)}(hjbh]hstruct}(hjhhhNhNubah}(h]h ]jkah"]h$]h&]uh1j^hjubj!)}(h h]h }(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjubh)}(hhh]j8)}(hbioh]hbio}(hjhhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsb c.bh_end_readasbuh1hhjubj!)}(h h]h }(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjubj)}(hjh]h*}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj8)}(hbioh]hbio}(hjhhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hjubeh}(h]h ]h"]h$]h&]noemphjPjQuh1jXhjubah}(h]h ]h"]h$]h&]jPjQuh1jRhjhhhjhKubeh}(h]h ]h"]h$]h&]jPjQjuh1jjjhj{hhhjhKubah}(h]jvah ](jjeh"]h$]h&]jj)jhuh1jhjhKhjxhhubj)}(hhh]h)}(hI/O end handler for readsh]hI/O end handler for reads}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chKhj@hhubah}(h]h ]h"]h$]h&]uh1jhjxhhhjhKubeh}(h]h ](jfunctioneh"]h$]h&]jjjj[jj[jjjuh1hhhhhhNhNubj)}(h**Parameters** ``struct bio *bio`` The bio being completed. **Description** Pass this function to bh_submit() if you're reading into the buffer, unless you need your own special I/O end handler.h](h)}(h**Parameters**h]j))}(hjeh]h Parameters}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjcubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chKhj_ubj?)}(hhh]jD)}(h-``struct bio *bio`` The bio being completed. h](jJ)}(h``struct bio *bio``h]jP)}(hjh]hstruct bio *bio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jOhjubah}(h]h ]h"]h$]h&]uh1jIhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chKhj~ubjf)}(hhh]h)}(hThe bio being completed.h]hThe bio being completed.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jehj~ubeh}(h]h ]h"]h$]h&]uh1jChjhKhj{ubah}(h]h ]h"]h$]h&]uh1j>hj_ubh)}(h**Description**h]j))}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chKhj_ubh)}(hvPass this function to bh_submit() if you're reading into the buffer, unless you need your own special I/O end handler.h]hxPass this function to bh_submit() if you’re reading into the buffer, unless you need your own special I/O end handler.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chKhj_ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hbh_end_write (C function)c.bh_end_writehNtauh1hhhhhhNhNubh)}(hhh](j)}(h#void bh_end_write (struct bio *bio)h]j )}(h"void bh_end_write(struct bio *bio)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chKubj!)}(h h]h }(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjhhhjhKubj2)}(h bh_end_writeh]j8)}(h bh_end_writeh]h bh_end_write}(hj%hhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hj!ubah}(h]h ](jKjLeh"]h$]h&]jPjQuh1j1hjhhhjhKubjS)}(h(struct bio *bio)h]jY)}(hstruct bio *bioh](j_)}(hjbh]hstruct}(hjAhhhNhNubah}(h]h ]jkah"]h$]h&]uh1j^hj=ubj!)}(h h]h }(hjNhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj=ubh)}(hhh]j8)}(hbioh]hbio}(hj_hhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hj\ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjamodnameN classnameNjj)}j]j)}jj'sbc.bh_end_writeasbuh1hhj=ubj!)}(h h]h }(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj=ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=ubj8)}(hbioh]hbio}(hjhhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hj=ubeh}(h]h ]h"]h$]h&]noemphjPjQuh1jXhj9ubah}(h]h ]h"]h$]h&]jPjQuh1jRhjhhhjhKubeh}(h]h ]h"]h$]h&]jPjQjuh1jjjhjhhhjhKubah}(h]jah ](jjeh"]h$]h&]jj)jhuh1jhjhKhjhhubj)}(hhh]h)}(hI/O end handler for writesh]hI/O end handler for writes}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chKhjhhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhKubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1hhhhhhNhNubj)}(h**Parameters** ``struct bio *bio`` The bio being completed. **Description** Pass this function to bh_submit() if you're writing from the buffer, unless you need your own special I/O end handler.h](h)}(h**Parameters**h]j))}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chKhjubj?)}(hhh]jD)}(h-``struct bio *bio`` The bio being completed. h](jJ)}(h``struct bio *bio``h]jP)}(hjh]hstruct bio *bio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jOhjubah}(h]h ]h"]h$]h&]uh1jIhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chKhjubjf)}(hhh]h)}(hThe bio being completed.h]hThe bio being completed.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jehjubeh}(h]h ]h"]h$]h&]uh1jChjhKhjubah}(h]h ]h"]h$]h&]uh1j>hjubh)}(h**Description**h]j))}(hj@h]h Description}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hj>ubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chKhjubh)}(hvPass this function to bh_submit() if you're writing from the buffer, unless you need your own special I/O end handler.h]hxPass this function to bh_submit() if you’re writing from the buffer, unless you need your own special I/O end handler.}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chKhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hbh_end_async_write (C function)c.bh_end_async_writehNtauh1hhhhhhNhNubh)}(hhh](j)}(h)void bh_end_async_write (struct bio *bio)h]j )}(h(void bh_end_async_write(struct bio *bio)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMubj!)}(h h]h }(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjhhhjhMubj2)}(hbh_end_async_writeh]j8)}(hbh_end_async_writeh]hbh_end_async_write}(hjhhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hjubah}(h]h ](jKjLeh"]h$]h&]jPjQuh1j1hjhhhjhMubjS)}(h(struct bio *bio)h]jY)}(hstruct bio *bioh](j_)}(hjbh]hstruct}(hjhhhNhNubah}(h]h ]jkah"]h$]h&]uh1j^hjubj!)}(h h]h }(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjubh)}(hhh]j8)}(hbioh]hbio}(hjhhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsbc.bh_end_async_writeasbuh1hhjubj!)}(h h]h }(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj8)}(hbioh]hbio}(hjhhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hjubeh}(h]h ]h"]h$]h&]noemphjPjQuh1jXhjubah}(h]h ]h"]h$]h&]jPjQuh1jRhjhhhjhMubeh}(h]h ]h"]h$]h&]jPjQjuh1jjjhj}hhhjhMubah}(h]jxah ](jjeh"]h$]h&]jj)jhuh1jhjhMhjzhhubj)}(hhh]h)}(h&I/O end handler for async folio writesh]h&I/O end handler for async folio writes}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhjBhhubah}(h]h ]h"]h$]h&]uh1jhjzhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjj]jj]jjjuh1hhhhhhNhNubj)}(hX%**Parameters** ``struct bio *bio`` The bio being completed. **Description** Pass this function to bh_submit() if you're doing the equivalent of block_write_full_folio(). That is, the folio is unlocked, and will have its writeback flag cleared once all async write buffers have completed.h](h)}(h**Parameters**h]j))}(hjgh]h Parameters}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjeubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhjaubj?)}(hhh]jD)}(h-``struct bio *bio`` The bio being completed. h](jJ)}(h``struct bio *bio``h]jP)}(hjh]hstruct bio *bio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jOhjubah}(h]h ]h"]h$]h&]uh1jIhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhjubjf)}(hhh]h)}(hThe bio being completed.h]hThe bio being completed.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jehjubeh}(h]h ]h"]h$]h&]uh1jChjhMhj}ubah}(h]h ]h"]h$]h&]uh1j>hjaubh)}(h**Description**h]j))}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhjaubh)}(hPass this function to bh_submit() if you're doing the equivalent of block_write_full_folio(). That is, the folio is unlocked, and will have its writeback flag cleared once all async write buffers have completed.h]hPass this function to bh_submit() if you’re doing the equivalent of block_write_full_folio(). That is, the folio is unlocked, and will have its writeback flag cleared once all async write buffers have completed.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhjaubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hmmb_sync (C function) c.mmb_synchNtauh1hhhhhhNhNubh)}(hhh](j)}(h/int mmb_sync (struct mapping_metadata_bhs *mmb)h]j )}(h.int mmb_sync(struct mapping_metadata_bhs *mmb)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMubj!)}(h h]h }(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjhhhjhMubj2)}(hmmb_synch]j8)}(hmmb_synch]hmmb_sync}(hj'hhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hj#ubah}(h]h ](jKjLeh"]h$]h&]jPjQuh1j1hjhhhjhMubjS)}(h"(struct mapping_metadata_bhs *mmb)h]jY)}(h struct mapping_metadata_bhs *mmbh](j_)}(hjbh]hstruct}(hjChhhNhNubah}(h]h ]jkah"]h$]h&]uh1j^hj?ubj!)}(h h]h }(hjPhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj?ubh)}(hhh]j8)}(hmapping_metadata_bhsh]hmapping_metadata_bhs}(hjahhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hj^ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjcmodnameN classnameNjj)}j]j)}jj)sb c.mmb_syncasbuh1hhj?ubj!)}(h h]h }(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj?ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?ubj8)}(hmmbh]hmmb}(hjhhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hj?ubeh}(h]h ]h"]h$]h&]noemphjPjQuh1jXhj;ubah}(h]h ]h"]h$]h&]jPjQuh1jRhjhhhjhMubeh}(h]h ]h"]h$]h&]jPjQjuh1jjjhjhhhjhMubah}(h]jah ](jjeh"]h$]h&]jj)jhuh1jhjhMhjhhubj)}(hhh]h)}(h+write out & wait upon all buffers in a listh]h+write out & wait upon all buffers in a list}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhjhhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1hhhhhhNhNubj)}(hX**Parameters** ``struct mapping_metadata_bhs *mmb`` the list of buffers to write **Description** Starts I/O against the buffers in the given list and waits upon that I/O. Basically, this is a convenience function for fsync(). **mmb** is for a file or directory which needs those buffers to be written for a successful fsync(). We have conflicting pressures: we want to make sure that all initially dirty buffers get waited on, but that any subsequently dirtied buffers don't. After all, we don't want fsync to last forever if somebody is actively writing to the file. Do this in two main stages: first we copy dirty buffers to a temporary inode list, queueing the writes as we go. Then we clean up, waiting for those writes to complete. mark_buffer_dirty_inode() doesn't touch b_assoc_buffers list if b_mmb is not NULL so we are sure the buffer stays on our list until IO completes (at which point it can be reaped).h](h)}(h**Parameters**h]j))}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhjubj?)}(hhh]jD)}(hB``struct mapping_metadata_bhs *mmb`` the list of buffers to write h](jJ)}(h$``struct mapping_metadata_bhs *mmb``h]jP)}(hjh]h struct mapping_metadata_bhs *mmb}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jOhjubah}(h]h ]h"]h$]h&]uh1jIhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhjubjf)}(hhh]h)}(hthe list of buffers to writeh]hthe list of buffers to write}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jehjubeh}(h]h ]h"]h$]h&]uh1jChjhMhjubah}(h]h ]h"]h$]h&]uh1j>hjubh)}(h**Description**h]j))}(hjBh]h Description}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hj@ubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhjubh)}(hStarts I/O against the buffers in the given list and waits upon that I/O. Basically, this is a convenience function for fsync(). **mmb** is for a file or directory which needs those buffers to be written for a successful fsync().h](hStarts I/O against the buffers in the given list and waits upon that I/O. Basically, this is a convenience function for fsync(). }(hjXhhhNhNubj))}(h**mmb**h]hmmb}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjXubh] is for a file or directory which needs those buffers to be written for a successful fsync().}(hjXhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhjubh)}(hWe have conflicting pressures: we want to make sure that all initially dirty buffers get waited on, but that any subsequently dirtied buffers don't. After all, we don't want fsync to last forever if somebody is actively writing to the file.h]hWe have conflicting pressures: we want to make sure that all initially dirty buffers get waited on, but that any subsequently dirtied buffers don’t. After all, we don’t want fsync to last forever if somebody is actively writing to the file.}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhjubh)}(hX\Do this in two main stages: first we copy dirty buffers to a temporary inode list, queueing the writes as we go. Then we clean up, waiting for those writes to complete. mark_buffer_dirty_inode() doesn't touch b_assoc_buffers list if b_mmb is not NULL so we are sure the buffer stays on our list until IO completes (at which point it can be reaped).h]hX^Do this in two main stages: first we copy dirty buffers to a temporary inode list, queueing the writes as we go. Then we clean up, waiting for those writes to complete. mark_buffer_dirty_inode() doesn’t touch b_assoc_buffers list if b_mmb is not NULL so we are sure the buffer stays on our list until IO completes (at which point it can be reaped).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hblock_dirty_folio (C function)c.block_dirty_foliohNtauh1hhhhhhNhNubh)}(hhh](j)}(hKbool block_dirty_folio (struct address_space *mapping, struct folio *folio)h]j )}(hJbool block_dirty_folio(struct address_space *mapping, struct folio *folio)h](j)}(hj) h]hbool}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMubj!)}(h h]h }(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjhhhjhMubj2)}(hblock_dirty_folioh]j8)}(hblock_dirty_folioh]hblock_dirty_folio}(hjhhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hjubah}(h]h ](jKjLe h"]h$]h&]jPjQuh1j1hjhhhjhMubjS)}(h4(struct address_space *mapping, struct folio *folio)h](jY)}(hstruct address_space *mappingh](j_)}(hjbh]hstruct}(hjhhhNhNubah}(h]h ]jkah"]h$]h&]uh1j^hjubj!)}(h h]h }(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjubh)}(hhh]j8)}(h address_spaceh]h address_space}(hjhhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsbc.block_dirty_folioasbuh1hhjubj!)}(h h]h }(hj1hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjubj)}(hjh]h*}(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj8)}(hmappingh]hmapping}(hjLhhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hjubeh}(h]h ]h"]h$]h&]noemphjPjQuh1jXhjubjY)}(hstruct folio *folioh](j_)}(hjbh]hstruct}(hjehhhNhNubah}(h]h ]jkah"]h$]h&]uh1j^hjaubj!)}(h h]h }(hjrhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjaubh)}(hhh]j8)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj)}j]j-c.block_dirty_folioasbuh1hhjaubj!)}(h h]h }(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjaubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubj8)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hjaubeh}(h]h ]h"]h$]h&]noemphjPjQuh1jXhjubeh}(h]h ]h"]h$]h&]jPjQuh1jRhjhhhjhMubeh}(h]h ]h"]h$]h&]jPjQjuh1jjjhjhhhjhMubah}(h]jah ](jjeh"]h$]h&]jj)jhuh1jhjhMhjhhubj)}(hhh]h)}(hMark a folio as dirty.h]hMark a folio as dirty.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhjhhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1hhhhhhNhNubj)}(hX**Parameters** ``struct address_space *mapping`` The address space containing this folio. ``struct folio *folio`` The folio to mark dirty. **Description** Filesystems which use buffer_heads can use this function as their ->dirty_folio implementation. Some filesystems need to do a little work before calling this function. Filesystems which do not use buffer_heads should call filemap_dirty_folio() instead. If the folio has buffers, the uptodate buffers are set dirty, to preserve dirty-state coherency between the folio and the buffers. Buffers added to a dirty folio are created dirty. The buffers are dirtied before the folio is dirtied. There's a small race window in which writeback may see the folio cleanness but not the buffer dirtiness. That's fine. If this code were to set the folio dirty before the buffers, writeback could clear the folio dirty flag, see a bunch of clean buffers and we'd end up with dirty buffers/clean folio on the dirty folio list. We use i_private_lock to lock against try_to_free_buffers() while using the folio's buffer list. This also prevents clean buffers being added to the folio after it was set dirty. **Context** May only be called from process context. Does not sleep. Caller must ensure that **folio** cannot be truncated during this call, typically by holding the folio lock or having a page in the folio mapped and holding the page table lock. **Return** True if the folio was dirtied; false if it was already dirtied.h](h)}(h**Parameters**h]j))}(hjh]h Parameters}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhjubj?)}(hhh](jD)}(hK``struct address_space *mapping`` The address space containing this folio. h](jJ)}(h!``struct address_space *mapping``h]jP)}(hj'h]hstruct address_space *mapping}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1jOhj%ubah}(h]h ]h"]h$]h&]uh1jIhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhj!ubjf)}(hhh]h)}(h(The address space containing this folio.h]h(The address space containing this folio.}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj<hMhj=ubah}(h]h ]h"]h$]h&]uh1jehj!ubeh}(h]h ]h"]h$]h&]uh1jChj<hMhjubjD)}(h1``struct folio *folio`` The folio to mark dirty. h](jJ)}(h``struct folio *folio``h]jP)}(hj`h]hstruct folio *folio}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1jOhj^ubah}(h]h ]h"]h$]h&]uh1jIhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhjZubjf)}(hhh]h)}(hThe folio to mark dirty.h]hThe folio to mark dirty.}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjuhMhjvubah}(h]h ]h"]h$]h&]uh1jehjZubeh}(h]h ]h"]h$]h&]uh1jChjuhMhjubeh}(h]h ]h"]h$]h&]uh1j>hjubh)}(h**Description**h]j))}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhjubh)}(hFilesystems which use buffer_heads can use this function as their ->dirty_folio implementation. Some filesystems need to do a little work before calling this function. Filesystems which do not use buffer_heads should call filemap_dirty_folio() instead.h]hFilesystems which use buffer_heads can use this function as their ->dirty_folio implementation. Some filesystems need to do a little work before calling this function. Filesystems which do not use buffer_heads should call filemap_dirty_folio() instead.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhjubh)}(hIf the folio has buffers, the uptodate buffers are set dirty, to preserve dirty-state coherency between the folio and the buffers. Buffers added to a dirty folio are created dirty.h]hIf the folio has buffers, the uptodate buffers are set dirty, to preserve dirty-state coherency between the folio and the buffers. Buffers added to a dirty folio are created dirty.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhjubh)}(hX{The buffers are dirtied before the folio is dirtied. There's a small race window in which writeback may see the folio cleanness but not the buffer dirtiness. That's fine. If this code were to set the folio dirty before the buffers, writeback could clear the folio dirty flag, see a bunch of clean buffers and we'd end up with dirty buffers/clean folio on the dirty folio list.h]hXThe buffers are dirtied before the folio is dirtied. There’s a small race window in which writeback may see the folio cleanness but not the buffer dirtiness. That’s fine. If this code were to set the folio dirty before the buffers, writeback could clear the folio dirty flag, see a bunch of clean buffers and we’d end up with dirty buffers/clean folio on the dirty folio list.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhjubh)}(hWe use i_private_lock to lock against try_to_free_buffers() while using the folio's buffer list. This also prevents clean buffers being added to the folio after it was set dirty.h]hWe use i_private_lock to lock against try_to_free_buffers() while using the folio’s buffer list. This also prevents clean buffers being added to the folio after it was set dirty.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhjubh)}(h **Context**h]j))}(hjh]hContext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhjubh)}(hMay only be called from process context. Does not sleep. Caller must ensure that **folio** cannot be truncated during this call, typically by holding the folio lock or having a page in the folio mapped and holding the page table lock.h](hRMay only be called from process context. Does not sleep. Caller must ensure that }(hjhhhNhNubj))}(h **folio**h]hfolio}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubh cannot be truncated during this call, typically by holding the folio lock or having a page in the folio mapped and holding the page table lock.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhjubh)}(h **Return**h]j))}(hj(h]hReturn}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hj&ubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhjubh)}(h?True if the folio was dirtied; false if it was already dirtied.h]h?True if the folio was dirtied; false if it was already dirtied.}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hmark_buffer_dirty (C function)c.mark_buffer_dirtyhNtauh1hhhhhhNhNubh)}(hhh](j)}(h/void mark_buffer_dirty (struct buffer_head *bh)h]j )}(h.void mark_buffer_dirty(struct buffer_head *bh)h](j)}(hvoidh]hvoid}(hjmhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjihhhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMubj!)}(h h]h }(hj|hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjihhhj{hMubj2)}(hmark_buffer_dirtyh]j8)}(hmark_buffer_dirtyh]hmark_buffer_dirty}(hjhhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hjubah}(h]h ](jKjLeh"]h$]h&]jPjQuh1j1hjihhhj{hMubjS)}(h(struct buffer_head *bh)h]jY)}(hstruct buffer_head *bhh](j_)}(hjbh]hstruct}(hjhhhNhNubah}(h]h ]jkah"]h$]h&]uh1j^hjubj!)}(h h]h }(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjubh)}(hhh]j8)}(h buffer_headh]h buffer_head}(hjhhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsbc.mark_buffer_dirtyasbuh1hhjubj!)}(h h]h }(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj8)}(hbhh]hbh}(hjhhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hjubeh}(h]h ]h"]h$]h&]noemphjPjQuh1jXhjubah}(h]h ]h"]h$]h&]jPjQuh1jRhjihhhj{hMubeh}(h]h ]h"]h$]h&]jPjQjuh1jjjhjehhhj{hMubah}(h]j`ah ](jjeh"]h$]h&]jj)jhuh1jhj{hMhjbhhubj)}(hhh]h)}(h&mark a buffer_head as needing writeouth]h&mark a buffer_head as needing writeout}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhj*hhubah}(h]h ]h"]h$]h&]uh1jhjbhhhj{hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjEjjEjjjuh1hhhhhhNhNubj)}(hX**Parameters** ``struct buffer_head *bh`` the buffer_head to mark dirty **Description** mark_buffer_dirty() will set the dirty bit against the buffer, then set its backing page dirty, then tag the page as dirty in the page cache and then attach the address_space's inode to its superblock's dirty inode list. mark_buffer_dirty() is atomic. It takes bh->b_folio->mapping->i_private_lock, i_pages lock and mapping->host->i_lock.h](h)}(h**Parameters**h]j))}(hjOh]h Parameters}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjMubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhjIubj?)}(hhh]jD)}(h9``struct buffer_head *bh`` the buffer_head to mark dirty h](jJ)}(h``struct buffer_head *bh``h]jP)}(hjnh]hstruct buffer_head *bh}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1jOhjlubah}(h]h ]h"]h$]h&]uh1jIhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhjhubjf)}(hhh]h)}(hthe buffer_head to mark dirtyh]hthe buffer_head to mark dirty}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jehjhubeh}(h]h ]h"]h$]h&]uh1jChjhMhjeubah}(h]h ]h"]h$]h&]uh1j>hjIubh)}(h**Description**h]j))}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhjIubh)}(hmark_buffer_dirty() will set the dirty bit against the buffer, then set its backing page dirty, then tag the page as dirty in the page cache and then attach the address_space's inode to its superblock's dirty inode list.h]hmark_buffer_dirty() will set the dirty bit against the buffer, then set its backing page dirty, then tag the page as dirty in the page cache and then attach the address_space’s inode to its superblock’s dirty inode list.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhjIubh)}(hvmark_buffer_dirty() is atomic. It takes bh->b_folio->mapping->i_private_lock, i_pages lock and mapping->host->i_lock.h]hvmark_buffer_dirty() is atomic. It takes bh->b_folio->mapping->i_private_lock, i_pages lock and mapping->host->i_lock.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhjIubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h__brelse (C function) c.__brelsehNtauh1hhhhhhNhNubh)}(hhh](j)}(h&void __brelse (struct buffer_head *bh)h]j )}(h%void __brelse(struct buffer_head *bh)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMubj!)}(h h]h }(hj hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjhhhj hMubj2)}(h__brelseh]j8)}(h__brelseh]h__brelse}(hjhhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hjubah}(h]h ](jKjLeh"]h$]h&]jPjQuh1j1hjhhhj hMubjS)}(h(struct buffer_head *bh)h]jY)}(hstruct buffer_head *bhh](j_)}(hjbh]hstruct}(hj:hhhNhNubah}(h]h ]jkah"]h$]h&]uh1j^hj6ubj!)}(h h]h }(hjGhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj6ubh)}(hhh]j8)}(h buffer_headh]h buffer_head}(hjXhhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hjUubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjZmodnameN classnameNjj)}j]j)}jj sb c.__brelseasbuh1hhj6ubj!)}(h h]h }(hjxhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj6ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj6ubj8)}(hbhh]hbh}(hjhhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hj6ubeh}(h]h ]h"]h$]h&]noemphjPjQuh1jXhj2ubah}(h]h ]h"]h$]h&]jPjQuh1jRhjhhhj hMubeh}(h]h ]h"]h$]h&]jPjQjuh1jjjhjhhhj hMubah}(h]jah ](jjeh"]h$]h&]jj)jhuh1jhj hMhjhhubj)}(hhh]h)}(hRelease a buffer.h]hRelease a buffer.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhjhhubah}(h]h ]h"]h$]h&]uh1jhjhhhj hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1hhhhhhNhNubj)}(h**Parameters** ``struct buffer_head *bh`` The buffer to release. **Description** This variant of brelse() can be called if **bh** is guaranteed to not be NULL.h](h)}(h**Parameters**h]j))}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhjubj?)}(hhh]jD)}(h2``struct buffer_head *bh`` The buffer to release. h](jJ)}(h``struct buffer_head *bh``h]jP)}(hjh]hstruct buffer_head *bh}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jOhjubah}(h]h ]h"]h$]h&]uh1jIhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhjubjf)}(hhh]h)}(hThe buffer to release.h]hThe buffer to release.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jehjubeh}(h]h ]h"]h$]h&]uh1jChjhMhjubah}(h]h ]h"]h$]h&]uh1j>hjubh)}(h**Description**h]j))}(hj9h]h Description}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hj7ubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhjubh)}(hNThis variant of brelse() can be called if **bh** is guaranteed to not be NULL.h](h*This variant of brelse() can be called if }(hjOhhhNhNubj))}(h**bh**h]hbh}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjOubh is guaranteed to not be NULL.}(hjOhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h__bforget (C function) c.__bforgethNtauh1hhhhhhNhNubh)}(hhh](j)}(h'void __bforget (struct buffer_head *bh)h]j )}(h&void __bforget(struct buffer_head *bh)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM ubj!)}(h h]h }(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjhhhjhM ubj2)}(h __bforgeth]j8)}(h __bforgeth]h __bforget}(hjhhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hjubah}(h]h ](jKjLeh"]h$]h&]jPjQuh1j1hjhhhjhM ubjS)}(h(struct buffer_head *bh)h]jY)}(hstruct buffer_head *bhh](j_)}(hjbh]hstruct}(hjhhhNhNubah}(h]h ]jkah"]h$]h&]uh1j^hjubj!)}(h h]h }(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjubh)}(hhh]j8)}(h buffer_headh]h buffer_head}(hjhhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsb c.__bforgetasbuh1hhjubj!)}(h h]h }(hj hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj8)}(hbhh]hbh}(hj&hhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hjubeh}(h]h ]h"]h$]h&]noemphjPjQuh1jXhjubah}(h]h ]h"]h$]h&]jPjQuh1jRhjhhhjhM ubeh}(h]h ]h"]h$]h&]jPjQjuh1jjjhjhhhjhM ubah}(h]jah ](jjeh"]h$]h&]jj)jhuh1jhjhM hjhhubj)}(hhh]h)}(h#Discard any dirty data in a buffer.h]h#Discard any dirty data in a buffer.}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM hjMhhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhM ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjhjjhjjjuh1hhhhhhNhNubj)}(h**Parameters** ``struct buffer_head *bh`` The buffer to forget. **Description** This variant of bforget() can be called if **bh** is guaranteed to not be NULL.h](h)}(h**Parameters**h]j))}(hjrh]h Parameters}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjpubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM$hjlubj?)}(hhh]jD)}(h1``struct buffer_head *bh`` The buffer to forget. h](jJ)}(h``struct buffer_head *bh``h]jP)}(hjh]hstruct buffer_head *bh}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jOhjubah}(h]h ]h"]h$]h&]uh1jIhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM!hjubjf)}(hhh]h)}(hThe buffer to forget.h]hThe buffer to forget.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM!hjubah}(h]h ]h"]h$]h&]uh1jehjubeh}(h]h ]h"]h$]h&]uh1jChjhM!hjubah}(h]h ]h"]h$]h&]uh1j>hjlubh)}(h**Description**h]j))}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM#hjlubh)}(hOThis variant of bforget() can be called if **bh** is guaranteed to not be NULL.h](h+This variant of bforget() can be called if }(hjhhhNhNubj))}(h**bh**h]hbh}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubh is guaranteed to not be NULL.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM"hjlubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hbh_submit (C function) c.bh_submithNtauh1hhhhhhNhNubh)}(hhh](j)}(hKvoid bh_submit (struct buffer_head *bh, blk_opf_t opf, bio_end_io_t end_io)h]j )}(hJvoid bh_submit(struct buffer_head *bh, blk_opf_t opf, bio_end_io_t end_io)h](j)}(hvoidh]hvoid}(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMpubj!)}(h h]h }(hj2hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjhhhj1hMpubj2)}(h bh_submith]j8)}(h bh_submith]h bh_submit}(hjDhhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hj@ubah}(h]h ](jKjLeh"]h$]h&]jPjQuh1j1hjhhhj1hMpubjS)}(h<(struct buffer_head *bh, blk_opf_t opf, bio_end_io_t end_io)h](jY)}(hstruct buffer_head *bhh](j_)}(hjbh]hstruct}(hj`hhhNhNubah}(h]h ]jkah"]h$]h&]uh1j^hj\ubj!)}(h h]h }(hjmhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj\ubh)}(hhh]j8)}(h buffer_headh]h buffer_head}(hj~hhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hj{ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj)}j]j)}jjFsb c.bh_submitasbuh1hhj\ubj!)}(h h]h }(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj\ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\ubj8)}(hbhh]hbh}(hjhhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hj\ubeh}(h]h ]h"]h$]h&]noemphjPjQuh1jXhjXubjY)}(h blk_opf_t opfh](h)}(hhh]j8)}(h blk_opf_th]h blk_opf_t}(hjhhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj)}j]j c.bh_submitasbuh1hhjubj!)}(h h]h }(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjubj8)}(hopfh]hopf}(hjhhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hjubeh}(h]h ]h"]h$]h&]noemphjPjQuh1jXhjXubjY)}(hbio_end_io_t end_ioh](h)}(hhh]j8)}(h bio_end_io_th]h bio_end_io_t}(hjhhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj)}j]j c.bh_submitasbuh1hhjubj!)}(h h]h }(hj;hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjubj8)}(hend_ioh]hend_io}(hjIhhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hjubeh}(h]h ]h"]h$]h&]noemphjPjQuh1jXhjXubeh}(h]h ]h"]h$]h&]jPjQuh1jRhjhhhj1hMpubeh}(h]h ]h"]h$]h&]jPjQjuh1jjjhjhhhj1hMpubah}(h]jah ](jjeh"]h$]h&]jj)jhuh1jhj1hMphjhhubj)}(hhh]h)}(hStart I/O against a buffer headh]hStart I/O against a buffer head}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMphjphhubah}(h]h ]h"]h$]h&]uh1jhjhhhj1hMpubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1hhhhhhNhNubj)}(hXc**Parameters** ``struct buffer_head *bh`` The buffer head to perform I/O on. ``blk_opf_t opf`` Operation and flags for bio. ``bio_end_io_t end_io`` The routine to call when I/O has completed. **Description** If you need to do I/O on an individual bh (instead of allowing the page cache to do I/O on the folio that it is in), call this function.h](h)}(h**Parameters**h]j))}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMthjubj?)}(hhh](jD)}(h>``struct buffer_head *bh`` The buffer head to perform I/O on. h](jJ)}(h``struct buffer_head *bh``h]jP)}(hjh]hstruct buffer_head *bh}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jOhjubah}(h]h ]h"]h$]h&]uh1jIhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMqhjubjf)}(hhh]h)}(h"The buffer head to perform I/O on.h]h"The buffer head to perform I/O on.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMqhjubah}(h]h ]h"]h$]h&]uh1jehjubeh}(h]h ]h"]h$]h&]uh1jChjhMqhjubjD)}(h/``blk_opf_t opf`` Operation and flags for bio. h](jJ)}(h``blk_opf_t opf``h]jP)}(hjh]h blk_opf_t opf}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jOhjubah}(h]h ]h"]h$]h&]uh1jIhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMrhjubjf)}(hhh]h)}(hOperation and flags for bio.h]hOperation and flags for bio.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMrhjubah}(h]h ]h"]h$]h&]uh1jehjubeh}(h]h ]h"]h$]h&]uh1jChjhMrhjubjD)}(hD``bio_end_io_t end_io`` The routine to call when I/O has completed. h](jJ)}(h``bio_end_io_t end_io``h]jP)}(hj&h]hbio_end_io_t end_io}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jOhj$ubah}(h]h ]h"]h$]h&]uh1jIhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMshj ubjf)}(hhh]h)}(h+The routine to call when I/O has completed.h]h+The routine to call when I/O has completed.}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj;hMshj<ubah}(h]h ]h"]h$]h&]uh1jehj ubeh}(h]h ]h"]h$]h&]uh1jChj;hMshjubeh}(h]h ]h"]h$]h&]uh1j>hjubh)}(h**Description**h]j))}(hjah]h Description}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1j(hj_ubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMuhjubh)}(hIf you need to do I/O on an individual bh (instead of allowing the page cache to do I/O on the folio that it is in), call this function.h]hIf you need to do I/O on an individual bh (instead of allowing the page cache to do I/O on the folio that it is in), call this function.}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMthjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hbdev_getblk (C function) c.bdev_getblkhNtauh1hhhhhhNhNubh)}(hhh](j)}(hfstruct buffer_head * bdev_getblk (struct block_device *bdev, sector_t block, unsigned size, gfp_t gfp)h]j )}(hdstruct buffer_head *bdev_getblk(struct block_device *bdev, sector_t block, unsigned size, gfp_t gfp)h](j_)}(hjbh]hstruct}(hjhhhNhNubah}(h]h ]jkah"]h$]h&]uh1j^hjhhhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM'ubj!)}(h h]h }(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjhhhjhM'ubh)}(hhh]j8)}(h buffer_headh]h buffer_head}(hjhhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj)}j]j)}j bdev_getblksb c.bdev_getblkasbuh1hhjhhhjhM'ubj!)}(h h]h }(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjhhhjhM'ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM'ubj2)}(h bdev_getblkh]j8)}(hjh]h bdev_getblk}(hjhhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hjubah}(h]h ](jKjLeh"]h$]h&]jPjQuh1j1hjhhhjhM'ubjS)}(hE(struct block_device *bdev, sector_t block, unsigned size, gfp_t gfp)h](jY)}(hstruct block_device *bdevh](j_)}(hjbh]hstruct}(hj hhhNhNubah}(h]h ]jkah"]h$]h&]uh1j^hjubj!)}(h h]h }(hj-hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjubh)}(hhh]j8)}(h block_deviceh]h block_device}(hj>hhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hj;ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj@modnameN classnameNjj)}j]j c.bdev_getblkasbuh1hhjubj!)}(h h]h }(hj\hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjubj)}(hjh]h*}(hjjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj8)}(hbdevh]hbdev}(hjwhhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hjubeh}(h]h ]h"]h$]h&]noemphjPjQuh1jXhjubjY)}(hsector_t blockh](h)}(hhh]j8)}(hsector_th]hsector_t}(hjhhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj)}j]j c.bdev_getblkasbuh1hhjubj!)}(h h]h }(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjubj8)}(hblockh]hblock}(hjhhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hjubeh}(h]h ]h"]h$]h&]noemphjPjQuh1jXhjubjY)}(h unsigned sizeh](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj!)}(h h]h }(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjubj8)}(hsizeh]hsize}(hjhhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hjubeh}(h]h ]h"]h$]h&]noemphjPjQuh1jXhjubjY)}(h gfp_t gfph](h)}(hhh]j8)}(hgfp_th]hgfp_t}(hj hhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hj ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj modnameN classnameNjj)}j]j c.bdev_getblkasbuh1hhj ubj!)}(h h]h }(hj. hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj ubj8)}(hgfph]hgfp}(hj< hhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hj ubeh}(h]h ]h"]h$]h&]noemphjPjQuh1jXhjubeh}(h]h ]h"]h$]h&]jPjQuh1jRhjhhhjhM'ubeh}(h]h ]h"]h$]h&]jPjQjuh1jjjhjhhhjhM'ubah}(h]jah ](jjeh"]h$]h&]jj)jhuh1jhjhM'hjhhubj)}(hhh]h)}(h3Get a buffer_head in a block device's buffer cache.h]h5Get a buffer_head in a block device’s buffer cache.}(hjf hhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM'hjc hhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhM'ubeh}(h]h ](jfunctioneh"]h$]h&]jjjj~ jj~ jjjuh1hhhhhhNhNubj)}(hXG**Parameters** ``struct block_device *bdev`` The block device. ``sector_t block`` The block number. ``unsigned size`` The size of buffer_heads for this **bdev**. ``gfp_t gfp`` The memory allocation flags to use. **Description** The returned buffer head has its reference count incremented, but is not locked. The caller should call brelse() when it has finished with the buffer. The buffer may not be uptodate. If needed, the caller can bring it uptodate either by reading it or overwriting it. **Return** The buffer head, or NULL if memory could not be allocated.h](h)}(h**Parameters**h]j))}(hj h]h Parameters}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hj ubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM+hj ubj?)}(hhh](jD)}(h0``struct block_device *bdev`` The block device. h](jJ)}(h``struct block_device *bdev``h]jP)}(hj h]hstruct block_device *bdev}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jOhj ubah}(h]h ]h"]h$]h&]uh1jIhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM(hj ubjf)}(hhh]h)}(hThe block device.h]hThe block device.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hM(hj ubah}(h]h ]h"]h$]h&]uh1jehj ubeh}(h]h ]h"]h$]h&]uh1jChj hM(hj ubjD)}(h%``sector_t block`` The block number. h](jJ)}(h``sector_t block``h]jP)}(hj h]hsector_t block}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jOhj ubah}(h]h ]h"]h$]h&]uh1jIhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM)hj ubjf)}(hhh]h)}(hThe block number.h]hThe block number.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hM)hj ubah}(h]h ]h"]h$]h&]uh1jehj ubeh}(h]h ]h"]h$]h&]uh1jChj hM)hj ubjD)}(h>``unsigned size`` The size of buffer_heads for this **bdev**. h](jJ)}(h``unsigned size``h]jP)}(hj!h]h unsigned size}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jOhj!ubah}(h]h ]h"]h$]h&]uh1jIhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM*hj!ubjf)}(hhh]h)}(h+The size of buffer_heads for this **bdev**.h](h"The size of buffer_heads for this }(hj2!hhhNhNubj))}(h**bdev**h]hbdev}(hj:!hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hj2!ubh.}(hj2!hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj.!hM*hj/!ubah}(h]h ]h"]h$]h&]uh1jehj!ubeh}(h]h ]h"]h$]h&]uh1jChj.!hM*hj ubjD)}(h2``gfp_t gfp`` The memory allocation flags to use. h](jJ)}(h ``gfp_t gfp``h]jP)}(hjd!h]h gfp_t gfp}(hjf!hhhNhNubah}(h]h ]h"]h$]h&]uh1jOhjb!ubah}(h]h ]h"]h$]h&]uh1jIhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM+hj^!ubjf)}(hhh]h)}(h#The memory allocation flags to use.h]h#The memory allocation flags to use.}(hj}!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjy!hM+hjz!ubah}(h]h ]h"]h$]h&]uh1jehj^!ubeh}(h]h ]h"]h$]h&]uh1jChjy!hM+hj ubeh}(h]h ]h"]h$]h&]uh1j>hj ubh)}(h**Description**h]j))}(hj!h]h Description}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hj!ubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM-hj ubh)}(hX The returned buffer head has its reference count incremented, but is not locked. The caller should call brelse() when it has finished with the buffer. The buffer may not be uptodate. If needed, the caller can bring it uptodate either by reading it or overwriting it.h]hX The returned buffer head has its reference count incremented, but is not locked. The caller should call brelse() when it has finished with the buffer. The buffer may not be uptodate. If needed, the caller can bring it uptodate either by reading it or overwriting it.}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM,hj ubh)}(h **Return**h]j))}(hj!h]hReturn}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hj!ubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM1hj ubh)}(h:The buffer head, or NULL if memory could not be allocated.h]h:The buffer head, or NULL if memory could not be allocated.}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM2hj ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h__bread_gfp (C function) c.__bread_gfphNtauh1hhhhhhNhNubh)}(hhh](j)}(hfstruct buffer_head * __bread_gfp (struct block_device *bdev, sector_t block, unsigned size, gfp_t gfp)h]j )}(hdstruct buffer_head *__bread_gfp(struct block_device *bdev, sector_t block, unsigned size, gfp_t gfp)h](j_)}(hjbh]hstruct}(hj "hhhNhNubah}(h]h ]jkah"]h$]h&]uh1j^hj"hhhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMVubj!)}(h h]h }(hj"hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj"hhhj"hMVubh)}(hhh]j8)}(h buffer_headh]h buffer_head}(hj*"hhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hj'"ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj,"modnameN classnameNjj)}j]j)}j __bread_gfpsb c.__bread_gfpasbuh1hhj"hhhj"hMVubj!)}(h h]h }(hjK"hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj"hhhj"hMVubj)}(hjh]h*}(hjY"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"hhhj"hMVubj2)}(h __bread_gfph]j8)}(hjH"h]h __bread_gfp}(hjj"hhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hjf"ubah}(h]h ](jKjLeh"]h$]h&]jPjQuh1j1hj"hhhj"hMVubjS)}(hE(struct block_device *bdev, sector_t block, unsigned size, gfp_t gfp)h](jY)}(hstruct block_device *bdevh](j_)}(hjbh]hstruct}(hj"hhhNhNubah}(h]h ]jkah"]h$]h&]uh1j^hj"ubj!)}(h h]h }(hj"hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj"ubh)}(hhh]j8)}(h block_deviceh]h block_device}(hj"hhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hj"ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj"modnameN classnameNjj)}j]jF" c.__bread_gfpasbuh1hhj"ubj!)}(h h]h }(hj"hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj"ubj)}(hjh]h*}(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"ubj8)}(hbdevh]hbdev}(hj"hhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hj"ubeh}(h]h ]h"]h$]h&]noemphjPjQuh1jXhj}"ubjY)}(hsector_t blockh](h)}(hhh]j8)}(hsector_th]hsector_t}(hj"hhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hj"ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj"modnameN classnameNjj)}j]jF" c.__bread_gfpasbuh1hhj"ubj!)}(h h]h }(hj#hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj"ubj8)}(hblockh]hblock}(hj$#hhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hj"ubeh}(h]h ]h"]h$]h&]noemphjPjQuh1jXhj}"ubjY)}(h unsigned sizeh](j)}(hunsignedh]hunsigned}(hj=#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9#ubj!)}(h h]h }(hjK#hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj9#ubj8)}(hsizeh]hsize}(hjY#hhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hj9#ubeh}(h]h ]h"]h$]h&]noemphjPjQuh1jXhj}"ubjY)}(h gfp_t gfph](h)}(hhh]j8)}(hgfp_th]hgfp_t}(hju#hhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hjr#ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjw#modnameN classnameNjj)}j]jF" c.__bread_gfpasbuh1hhjn#ubj!)}(h h]h }(hj#hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjn#ubj8)}(hgfph]hgfp}(hj#hhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hjn#ubeh}(h]h ]h"]h$]h&]noemphjPjQuh1jXhj}"ubeh}(h]h ]h"]h$]h&]jPjQuh1jRhj"hhhj"hMVubeh}(h]h ]h"]h$]h&]jPjQjuh1jjjhj"hhhj"hMVubah}(h]j!ah ](jjeh"]h$]h&]jj)jhuh1jhj"hMVhj"hhubj)}(hhh]h)}(h Read a block.h]h Read a block.}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMVhj#hhubah}(h]h ]h"]h$]h&]uh1jhj"hhhj"hMVubeh}(h]h ](jfunctioneh"]h$]h&]jjjj#jj#jjjuh1hhhhhhNhNubj)}(hXs**Parameters** ``struct block_device *bdev`` The block device to read from. ``sector_t block`` Block number in units of block size. ``unsigned size`` The block size of this device in bytes. ``gfp_t gfp`` Not page allocation flags; see below. **Description** You are not expected to call this function. You should use one of sb_bread(), sb_bread_unmovable() or __bread(). Read a specified block, and return the buffer head that refers to it. If **gfp** is 0, the memory will be allocated using the block device's default GFP flags. If **gfp** is __GFP_MOVABLE, the memory may be allocated from a movable area. Do not pass in a complete set of GFP flags. The returned buffer head has its refcount increased. The caller should call brelse() when it has finished with the buffer. **Context** May sleep waiting for I/O. **Return** NULL if the block was unreadable.h](h)}(h**Parameters**h]j))}(hj#h]h Parameters}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hj#ubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMZhj#ubj?)}(hhh](jD)}(h=``struct block_device *bdev`` The block device to read from. h](jJ)}(h``struct block_device *bdev``h]jP)}(hj $h]hstruct block_device *bdev}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jOhj $ubah}(h]h ]h"]h$]h&]uh1jIhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMWhj$ubjf)}(hhh]h)}(hThe block device to read from.h]hThe block device to read from.}(hj%$hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj!$hMWhj"$ubah}(h]h ]h"]h$]h&]uh1jehj$ubeh}(h]h ]h"]h$]h&]uh1jChj!$hMWhj$ubjD)}(h8``sector_t block`` Block number in units of block size. h](jJ)}(h``sector_t block``h]jP)}(hjE$h]hsector_t block}(hjG$hhhNhNubah}(h]h ]h"]h$]h&]uh1jOhjC$ubah}(h]h ]h"]h$]h&]uh1jIhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMXhj?$ubjf)}(hhh]h)}(h$Block number in units of block size.h]h$Block number in units of block size.}(hj^$hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjZ$hMXhj[$ubah}(h]h ]h"]h$]h&]uh1jehj?$ubeh}(h]h ]h"]h$]h&]uh1jChjZ$hMXhj$ubjD)}(h:``unsigned size`` The block size of this device in bytes. h](jJ)}(h``unsigned size``h]jP)}(hj~$h]h unsigned size}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jOhj|$ubah}(h]h ]h"]h$]h&]uh1jIhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMYhjx$ubjf)}(hhh]h)}(h'The block size of this device in bytes.h]h'The block size of this device in bytes.}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj$hMYhj$ubah}(h]h ]h"]h$]h&]uh1jehjx$ubeh}(h]h ]h"]h$]h&]uh1jChj$hMYhj$ubjD)}(h4``gfp_t gfp`` Not page allocation flags; see below. h](jJ)}(h ``gfp_t gfp``h]jP)}(hj$h]h gfp_t gfp}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jOhj$ubah}(h]h ]h"]h$]h&]uh1jIhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMZhj$ubjf)}(hhh]h)}(h%Not page allocation flags; see below.h]h%Not page allocation flags; see below.}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj$hMZhj$ubah}(h]h ]h"]h$]h&]uh1jehj$ubeh}(h]h ]h"]h$]h&]uh1jChj$hMZhj$ubeh}(h]h ]h"]h$]h&]uh1j>hj#ubh)}(h**Description**h]j))}(hj$h]h Description}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hj$ubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM\hj#ubh)}(hqYou are not expected to call this function. You should use one of sb_bread(), sb_bread_unmovable() or __bread().h]hqYou are not expected to call this function. You should use one of sb_bread(), sb_bread_unmovable() or __bread().}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM[hj#ubh)}(hXRead a specified block, and return the buffer head that refers to it. If **gfp** is 0, the memory will be allocated using the block device's default GFP flags. If **gfp** is __GFP_MOVABLE, the memory may be allocated from a movable area. Do not pass in a complete set of GFP flags.h](hIRead a specified block, and return the buffer head that refers to it. If }(hj%hhhNhNubj))}(h**gfp**h]hgfp}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hj%ubhV is 0, the memory will be allocated using the block device’s default GFP flags. If }(hj%hhhNhNubj))}(h**gfp**h]hgfp}(hj1%hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hj%ubhp is __GFP_MOVABLE, the memory may be allocated from a movable area. Do not pass in a complete set of GFP flags.}(hj%hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM^hj#ubh)}(h{The returned buffer head has its refcount increased. The caller should call brelse() when it has finished with the buffer.h]h{The returned buffer head has its refcount increased. The caller should call brelse() when it has finished with the buffer.}(hjJ%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMdhj#ubh)}(h **Context**h]j))}(hj[%h]hContext}(hj]%hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjY%ubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMghj#ubh)}(hMay sleep waiting for I/O.h]hMay sleep waiting for I/O.}(hjq%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhhj#ubh)}(h **Return**h]j))}(hj%h]hReturn}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hj%ubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMjhj#ubh)}(h!NULL if the block was unreadable.h]h!NULL if the block was unreadable.}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMihj#ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h#block_invalidate_folio (C function)c.block_invalidate_foliohNtauh1hhhhhhNhNubh)}(hhh](j)}(hOvoid block_invalidate_folio (struct folio *folio, size_t offset, size_t length)h]j )}(hNvoid block_invalidate_folio(struct folio *folio, size_t offset, size_t length)h](j)}(hvoidh]hvoid}(hj%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%hhhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMubj!)}(h h]h }(hj%hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj%hhhj%hMubj2)}(hblock_invalidate_folioh]j8)}(hblock_invalidate_folioh]hblock_invalidate_folio}(hj%hhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hj%ubah}(h]h ](jKjLeh"]h$]h&]jPjQuh1j1hj%hhhj%hMubjS)}(h3(struct folio *folio, size_t offset, size_t length)h](jY)}(hstruct folio *folioh](j_)}(hjbh]hstruct}(hj&hhhNhNubah}(h]h ]jkah"]h$]h&]uh1j^hj&ubj!)}(h h]h }(hj&hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj&ubh)}(hhh]j8)}(hfolioh]hfolio}(hj"&hhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hj&ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj$&modnameN classnameNjj)}j]j)}jj%sbc.block_invalidate_folioasbuh1hhj&ubj!)}(h h]h }(hjB&hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj&ubj)}(hjh]h*}(hjP&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubj8)}(hfolioh]hfolio}(hj]&hhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hj&ubeh}(h]h ]h"]h$]h&]noemphjPjQuh1jXhj%ubjY)}(h size_t offseth](h)}(hhh]j8)}(hsize_th]hsize_t}(hjy&hhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hjv&ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj{&modnameN classnameNjj)}j]j>&c.block_invalidate_folioasbuh1hhjr&ubj!)}(h h]h }(hj&hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjr&ubj8)}(hoffseth]hoffset}(hj&hhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hjr&ubeh}(h]h ]h"]h$]h&]noemphjPjQuh1jXhj%ubjY)}(h size_t lengthh](h)}(hhh]j8)}(hsize_th]hsize_t}(hj&hhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hj&ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj&modnameN classnameNjj)}j]j>&c.block_invalidate_folioasbuh1hhj&ubj!)}(h h]h }(hj&hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj&ubj8)}(hlengthh]hlength}(hj&hhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hj&ubeh}(h]h ]h"]h$]h&]noemphjPjQuh1jXhj%ubeh}(h]h ]h"]h$]h&]jPjQuh1jRhj%hhhj%hMubeh}(h]h ]h"]h$]h&]jPjQjuh1jjjhj%hhhj%hMubah}(h]j%ah ](jjeh"]h$]h&]jj)jhuh1jhj%hMhj%hhubj)}(hhh]h)}(h0Invalidate part or all of a buffer-backed folio.h]h0Invalidate part or all of a buffer-backed folio.}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhj'hhubah}(h]h ]h"]h$]h&]uh1jhj%hhhj%hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjj/'jj/'jjjuh1hhhhhhNhNubj)}(hXe**Parameters** ``struct folio *folio`` The folio which is affected. ``size_t offset`` start of the range to invalidate ``size_t length`` length of the range to invalidate **Description** block_invalidate_folio() is called when all or part of the folio has been invalidated by a truncate operation. block_invalidate_folio() does not have to release all buffers, but it must ensure that no dirty buffer is left outside **offset** and that no I/O is underway against any of the blocks which are outside the truncation point. Because the caller is about to free (and possibly reuse) those blocks on-disk.h](h)}(h**Parameters**h]j))}(hj9'h]h Parameters}(hj;'hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hj7'ubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhj3'ubj?)}(hhh](jD)}(h5``struct folio *folio`` The folio which is affected. h](jJ)}(h``struct folio *folio``h]jP)}(hjX'h]hstruct folio *folio}(hjZ'hhhNhNubah}(h]h ]h"]h$]h&]uh1jOhjV'ubah}(h]h ]h"]h$]h&]uh1jIhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhjR'ubjf)}(hhh]h)}(hThe folio which is affected.h]hThe folio which is affected.}(hjq'hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjm'hMhjn'ubah}(h]h ]h"]h$]h&]uh1jehjR'ubeh}(h]h ]h"]h$]h&]uh1jChjm'hMhjO'ubjD)}(h3``size_t offset`` start of the range to invalidate h](jJ)}(h``size_t offset``h]jP)}(hj'h]h size_t offset}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jOhj'ubah}(h]h ]h"]h$]h&]uh1jIhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhj'ubjf)}(hhh]h)}(h start of the range to invalidateh]h start of the range to invalidate}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj'hMhj'ubah}(h]h ]h"]h$]h&]uh1jehj'ubeh}(h]h ]h"]h$]h&]uh1jChj'hMhjO'ubjD)}(h4``size_t length`` length of the range to invalidate h](jJ)}(h``size_t length``h]jP)}(hj'h]h size_t length}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jOhj'ubah}(h]h ]h"]h$]h&]uh1jIhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhj'ubjf)}(hhh]h)}(h!length of the range to invalidateh]h!length of the range to invalidate}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj'hMhj'ubah}(h]h ]h"]h$]h&]uh1jehj'ubeh}(h]h ]h"]h$]h&]uh1jChj'hMhjO'ubeh}(h]h ]h"]h$]h&]uh1j>hj3'ubh)}(h**Description**h]j))}(hj(h]h Description}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hj(ubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhj3'ubh)}(hnblock_invalidate_folio() is called when all or part of the folio has been invalidated by a truncate operation.h]hnblock_invalidate_folio() is called when all or part of the folio has been invalidated by a truncate operation.}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhj3'ubh)}(hX/block_invalidate_folio() does not have to release all buffers, but it must ensure that no dirty buffer is left outside **offset** and that no I/O is underway against any of the blocks which are outside the truncation point. Because the caller is about to free (and possibly reuse) those blocks on-disk.h](hwblock_invalidate_folio() does not have to release all buffers, but it must ensure that no dirty buffer is left outside }(hj*(hhhNhNubj))}(h **offset**h]hoffset}(hj2(hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hj*(ubh and that no I/O is underway against any of the blocks which are outside the truncation point. Because the caller is about to free (and possibly reuse) those blocks on-disk.}(hj*(hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhj3'ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hclean_bdev_aliases (C function)c.clean_bdev_aliaseshNtauh1hhhhhhNhNubh)}(hhh](j)}(hQvoid clean_bdev_aliases (struct block_device *bdev, sector_t block, sector_t len)h]j )}(hPvoid clean_bdev_aliases(struct block_device *bdev, sector_t block, sector_t len)h](j)}(hvoidh]hvoid}(hjk(hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjg(hhhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMDubj!)}(h h]h }(hjz(hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjg(hhhjy(hMDubj2)}(hclean_bdev_aliasesh]j8)}(hclean_bdev_aliasesh]hclean_bdev_aliases}(hj(hhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hj(ubah}(h]h ](jKjLeh"]h$]h&]jPjQuh1j1hjg(hhhjy(hMDubjS)}(h9(struct block_device *bdev, sector_t block, sector_t len)h](jY)}(hstruct block_device *bdevh](j_)}(hjbh]hstruct}(hj(hhhNhNubah}(h]h ]jkah"]h$]h&]uh1j^hj(ubj!)}(h h]h }(hj(hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj(ubh)}(hhh]j8)}(h block_deviceh]h block_device}(hj(hhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hj(ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj(modnameN classnameNjj)}j]j)}jj(sbc.clean_bdev_aliasesasbuh1hhj(ubj!)}(h h]h }(hj(hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj(ubj)}(hjh]h*}(hj(hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(ubj8)}(hbdevh]hbdev}(hj)hhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hj(ubeh}(h]h ]h"]h$]h&]noemphjPjQuh1jXhj(ubjY)}(hsector_t blockh](h)}(hhh]j8)}(hsector_th]hsector_t}(hj)hhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hj)ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj)modnameN classnameNjj)}j]j(c.clean_bdev_aliasesasbuh1hhj)ubj!)}(h h]h }(hj;)hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj)ubj8)}(hblockh]hblock}(hjI)hhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hj)ubeh}(h]h ]h"]h$]h&]noemphjPjQuh1jXhj(ubjY)}(h sector_t lenh](h)}(hhh]j8)}(hsector_th]hsector_t}(hje)hhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hjb)ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjg)modnameN classnameNjj)}j]j(c.clean_bdev_aliasesasbuh1hhj^)ubj!)}(h h]h }(hj)hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj^)ubj8)}(hlenh]hlen}(hj)hhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hj^)ubeh}(h]h ]h"]h$]h&]noemphjPjQuh1jXhj(ubeh}(h]h ]h"]h$]h&]jPjQuh1jRhjg(hhhjy(hMDubeh}(h]h ]h"]h$]h&]jPjQjuh1jjjhjc(hhhjy(hMDubah}(h]j^(ah ](jjeh"]h$]h&]jj)jhuh1jhjy(hMDhj`(hhubj)}(hhh]h)}(h(clean a range of buffers in block device2h]h(clean a range of buffers in block device}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMDhj)hhubah}(h]h ]h"]h$]h&]uh1jhj`(hhhjy(hMDubeh}(h]h ](jfunctioneh"]h$]h&]jjjj)jj)jjjuh1hhhhhhNhNubj)}(hX**Parameters** ``struct block_device *bdev`` Block device to clean buffers in ``sector_t block`` Start of a range of blocks to clean ``sector_t len`` Number of blocks to clean **Description** We are taking a range of blocks for data and we don't want writeback of any buffer-cache aliases starting from return from this function and until the moment when something will explicitly mark the buffer dirty (hopefully that will not happen until we will free that block ;-) We don't even need to mark it not-uptodate - nobody can expect anything from a newly allocated buffer anyway. We used to use unmap_buffer() for such invalidation, but that was wrong. We definitely don't want to mark the alias unmapped, for example - it would confuse anyone who might pick it with bread() afterwards... Also.. Note that bforget() doesn't lock the buffer. So there can be writeout I/O going on against recently-freed buffers. We don't wait on that I/O in bforget() - it's more efficient to wait on the I/O only if we really need to. That happens here.h](h)}(h**Parameters**h]j))}(hj)h]h Parameters}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hj)ubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMHhj)ubj?)}(hhh](jD)}(h?``struct block_device *bdev`` Block device to clean buffers in h](jJ)}(h``struct block_device *bdev``h]jP)}(hj)h]hstruct block_device *bdev}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1jOhj)ubah}(h]h ]h"]h$]h&]uh1jIhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMEhj)ubjf)}(hhh]h)}(h Block device to clean buffers inh]h Block device to clean buffers in}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj*hMEhj*ubah}(h]h ]h"]h$]h&]uh1jehj)ubeh}(h]h ]h"]h$]h&]uh1jChj*hMEhj)ubjD)}(h7``sector_t block`` Start of a range of blocks to clean h](jJ)}(h``sector_t block``h]jP)}(hj5*h]hsector_t block}(hj7*hhhNhNubah}(h]h ]h"]h$]h&]uh1jOhj3*ubah}(h]h ]h"]h$]h&]uh1jIhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMFhj/*ubjf)}(hhh]h)}(h#Start of a range of blocks to cleanh]h#Start of a range of blocks to clean}(hjN*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjJ*hMFhjK*ubah}(h]h ]h"]h$]h&]uh1jehj/*ubeh}(h]h ]h"]h$]h&]uh1jChjJ*hMFhj)ubjD)}(h+``sector_t len`` Number of blocks to clean h](jJ)}(h``sector_t len``h]jP)}(hjn*h]h sector_t len}(hjp*hhhNhNubah}(h]h ]h"]h$]h&]uh1jOhjl*ubah}(h]h ]h"]h$]h&]uh1jIhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMGhjh*ubjf)}(hhh]h)}(hNumber of blocks to cleanh]hNumber of blocks to clean}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj*hMGhj*ubah}(h]h ]h"]h$]h&]uh1jehjh*ubeh}(h]h ]h"]h$]h&]uh1jChj*hMGhj)ubeh}(h]h ]h"]h$]h&]uh1j>hj)ubh)}(h**Description**h]j))}(hj*h]h Description}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hj*ubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMIhj)ubh)}(hXSWe are taking a range of blocks for data and we don't want writeback of any buffer-cache aliases starting from return from this function and until the moment when something will explicitly mark the buffer dirty (hopefully that will not happen until we will free that block ;-) We don't even need to mark it not-uptodate - nobody can expect anything from a newly allocated buffer anyway. We used to use unmap_buffer() for such invalidation, but that was wrong. We definitely don't want to mark the alias unmapped, for example - it would confuse anyone who might pick it with bread() afterwards...h]hXYWe are taking a range of blocks for data and we don’t want writeback of any buffer-cache aliases starting from return from this function and until the moment when something will explicitly mark the buffer dirty (hopefully that will not happen until we will free that block ;-) We don’t even need to mark it not-uptodate - nobody can expect anything from a newly allocated buffer anyway. We used to use unmap_buffer() for such invalidation, but that was wrong. We definitely don’t want to mark the alias unmapped, for example - it would confuse anyone who might pick it with bread() afterwards...}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMHhj)ubh)}(hAlso.. Note that bforget() doesn't lock the buffer. So there can be writeout I/O going on against recently-freed buffers. We don't wait on that I/O in bforget() - it's more efficient to wait on the I/O only if we really need to. That happens here.h]hXAlso.. Note that bforget() doesn’t lock the buffer. So there can be writeout I/O going on against recently-freed buffers. We don’t wait on that I/O in bforget() - it’s more efficient to wait on the I/O only if we really need to. That happens here.}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMQhj)ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h try_to_free_buffers (C function)c.try_to_free_buffershNtauh1hhhhhhNhNubh)}(hhh](j)}(h.bool try_to_free_buffers (struct folio *folio)h]j )}(h-bool try_to_free_buffers(struct folio *folio)h](j)}(hj) h]hbool}(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*hhhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM ubj!)}(h h]h }(hj +hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj*hhhj +hM ubj2)}(htry_to_free_buffersh]j8)}(htry_to_free_buffersh]htry_to_free_buffers}(hj+hhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hj+ubah}(h]h ](jKjLeh"]h$]h&]jPjQuh1j1hj*hhhj +hM ubjS)}(h(struct folio *folio)h]jY)}(hstruct folio *folioh](j_)}(hjbh]hstruct}(hj9+hhhNhNubah}(h]h ]jkah"]h$]h&]uh1j^hj5+ubj!)}(h h]h }(hjF+hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj5+ubh)}(hhh]j8)}(hfolioh]hfolio}(hjW+hhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hjT+ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjY+modnameN classnameNjj)}j]j)}jj+sbc.try_to_free_buffersasbuh1hhj5+ubj!)}(h h]h }(hjw+hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj5+ubj)}(hjh]h*}(hj+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5+ubj8)}(hfolioh]hfolio}(hj+hhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hj5+ubeh}(h]h ]h"]h$]h&]noemphjPjQuh1jXhj1+ubah}(h]h ]h"]h$]h&]jPjQuh1jRhj*hhhj +hM ubeh}(h]h ]h"]h$]h&]jPjQjuh1jjjhj*hhhj +hM ubah}(h]j*ah ](jjeh"]h$]h&]jj)jhuh1jhj +hM hj*hhubj)}(hhh]h)}(h'Release buffers attached to this folio.h]h'Release buffers attached to this folio.}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM hj+hhubah}(h]h ]h"]h$]h&]uh1jhj*hhhj +hM ubeh}(h]h ](jfunctioneh"]h$]h&]jjjj+jj+jjjuh1hhhhhhNhNubj)}(hX**Parameters** ``struct folio *folio`` The folio. **Description** If any buffers are in use (dirty, under writeback, elevated refcount), no buffers will be freed. If the folio is dirty but all the buffers are clean then we need to be sure to mark the folio clean as well. This is because the folio may be against a block device, and a later reattachment of buffers to a dirty folio will set *all* buffers dirty. Which would corrupt filesystem data on the same device. The same applies to regular filesystem folios: if all the buffers are clean then we set the folio clean and proceed. To do that, we require total exclusion from block_dirty_folio(). That is obtained with i_private_lock. Exclusion against try_to_free_buffers may be obtained by either locking the folio or by holding its mapping's i_private_lock. **Context** Process context. **folio** must be locked. Will not sleep. **Return** true if all buffers attached to this folio were freed.h](h)}(h**Parameters**h]j))}(hj+h]h Parameters}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hj+ubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM hj+ubj?)}(hhh]jD)}(h#``struct folio *folio`` The folio. h](jJ)}(h``struct folio *folio``h]jP)}(hj+h]hstruct folio *folio}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1jOhj+ubah}(h]h ]h"]h$]h&]uh1jIhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM hj+ubjf)}(hhh]h)}(h The folio.h]h The folio.}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj,hM hj,ubah}(h]h ]h"]h$]h&]uh1jehj+ubeh}(h]h ]h"]h$]h&]uh1jChj,hM hj+ubah}(h]h ]h"]h$]h&]uh1j>hj+ubh)}(h**Description**h]j))}(hj8,h]h Description}(hj:,hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hj6,ubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM hj+ubh)}(h`If any buffers are in use (dirty, under writeback, elevated refcount), no buffers will be freed.h]h`If any buffers are in use (dirty, under writeback, elevated refcount), no buffers will be freed.}(hjN,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM hj+ubh)}(hX2If the folio is dirty but all the buffers are clean then we need to be sure to mark the folio clean as well. This is because the folio may be against a block device, and a later reattachment of buffers to a dirty folio will set *all* buffers dirty. Which would corrupt filesystem data on the same device.h](hIf the folio is dirty but all the buffers are clean then we need to be sure to mark the folio clean as well. This is because the folio may be against a block device, and a later reattachment of buffers to a dirty folio will set }(hj],hhhNhNubhemphasis)}(h*all*h]hall}(hjg,hhhNhNubah}(h]h ]h"]h$]h&]uh1je,hj],ubhH buffers dirty. Which would corrupt filesystem data on the same device.}(hj],hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM hj+ubh)}(hThe same applies to regular filesystem folios: if all the buffers are clean then we set the folio clean and proceed. To do that, we require total exclusion from block_dirty_folio(). That is obtained with i_private_lock.h]hThe same applies to regular filesystem folios: if all the buffers are clean then we set the folio clean and proceed. To do that, we require total exclusion from block_dirty_folio(). That is obtained with i_private_lock.}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM hj+ubh)}(h}Exclusion against try_to_free_buffers may be obtained by either locking the folio or by holding its mapping's i_private_lock.h]hExclusion against try_to_free_buffers may be obtained by either locking the folio or by holding its mapping’s i_private_lock.}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM hj+ubh)}(h **Context**h]j))}(hj,h]hContext}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hj,ubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM hj+ubh)}(hhj-ubh)}(h**Description**h]j))}(hjZ.h]h Description}(hj\.hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjX.ubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMb hj-ubh)}(hRReturn true if the buffer is up-to-date and false, with the buffer locked, if not.h]hRReturn true if the buffer is up-to-date and false, with the buffer locked, if not.}(hjp.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMa hj-ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h__bh_read (C function) c.__bh_readhNtauh1hhhhhhNhNubh)}(hhh](j)}(hEint __bh_read (struct buffer_head *bh, blk_opf_t op_flags, bool wait)h]j )}(hDint __bh_read(struct buffer_head *bh, blk_opf_t op_flags, bool wait)h](j)}(hinth]hint}(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj.hhhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMr ubj!)}(h h]h }(hj.hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj.hhhj.hMr ubj2)}(h __bh_readh]j8)}(h __bh_readh]h __bh_read}(hj.hhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hj.ubah}(h]h ](jKjLeh"]h$]h&]jPjQuh1j1hj.hhhj.hMr ubjS)}(h7(struct buffer_head *bh, blk_opf_t op_flags, bool wait)h](jY)}(hstruct buffer_head *bhh](j_)}(hjbh]hstruct}(hj.hhhNhNubah}(h]h ]jkah"]h$]h&]uh1j^hj.ubj!)}(h h]h }(hj.hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj.ubh)}(hhh]j8)}(h buffer_headh]h buffer_head}(hj.hhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hj.ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj.modnameN classnameNjj)}j]j)}jj.sb c.__bh_readasbuh1hhj.ubj!)}(h h]h }(hj/hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj.ubj)}(hjh]h*}(hj(/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj.ubj8)}(hbhh]hbh}(hj5/hhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hj.ubeh}(h]h ]h"]h$]h&]noemphjPjQuh1jXhj.ubjY)}(hblk_opf_t op_flagsh](h)}(hhh]j8)}(h blk_opf_th]h blk_opf_t}(hjQ/hhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hjN/ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjS/modnameN classnameNjj)}j]j/ c.__bh_readasbuh1hhjJ/ubj!)}(h h]h }(hjo/hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjJ/ubj8)}(hop_flagsh]hop_flags}(hj}/hhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hjJ/ubeh}(h]h ]h"]h$]h&]noemphjPjQuh1jXhj.ubjY)}(h bool waith](j)}(hj) h]hbool}(hj/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/ubj!)}(h h]h }(hj/hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj/ubj8)}(hwaith]hwait}(hj/hhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hj/ubeh}(h]h ]h"]h$]h&]noemphjPjQuh1jXhj.ubeh}(h]h ]h"]h$]h&]jPjQuh1jRhj.hhhj.hMr ubeh}(h]h ]h"]h$]h&]jPjQjuh1jjjhj.hhhj.hMr ubah}(h]j.ah ](jjeh"]h$]h&]jj)jhuh1jhj.hMr hj.hhubj)}(hhh]h)}(hSubmit read for a locked bufferh]hSubmit read for a locked buffer}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMr hj/hhubah}(h]h ]h"]h$]h&]uh1jhj.hhhj.hMr ubeh}(h]h ](jfunctioneh"]h$]h&]jjjj/jj/jjjuh1hhhhhhNhNubj)}(h**Parameters** ``struct buffer_head *bh`` struct buffer_head ``blk_opf_t op_flags`` appending REQ_OP_* flags besides REQ_OP_READ ``bool wait`` wait until reading finish **Description** Returns zero on success or don't wait, and -EIO on error.h](h)}(h**Parameters**h]j))}(hj/h]h Parameters}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hj/ubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMv hj/ubj?)}(hhh](jD)}(h.``struct buffer_head *bh`` struct buffer_head h](jJ)}(h``struct buffer_head *bh``h]jP)}(hj0h]hstruct buffer_head *bh}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jOhj0ubah}(h]h ]h"]h$]h&]uh1jIhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMs hj0ubjf)}(hhh]h)}(hstruct buffer_headh]hstruct buffer_head}(hj50hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj10hMs hj20ubah}(h]h ]h"]h$]h&]uh1jehj0ubeh}(h]h ]h"]h$]h&]uh1jChj10hMs hj0ubjD)}(hD``blk_opf_t op_flags`` appending REQ_OP_* flags besides REQ_OP_READ h](jJ)}(h``blk_opf_t op_flags``h]jP)}(hjU0h]hblk_opf_t op_flags}(hjW0hhhNhNubah}(h]h ]h"]h$]h&]uh1jOhjS0ubah}(h]h ]h"]h$]h&]uh1jIhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMt hjO0ubjf)}(hhh]h)}(h,appending REQ_OP_* flags besides REQ_OP_READh]h,appending REQ_OP_* flags besides REQ_OP_READ}(hjn0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjj0hMt hjk0ubah}(h]h ]h"]h$]h&]uh1jehjO0ubeh}(h]h ]h"]h$]h&]uh1jChjj0hMt hj0ubjD)}(h(``bool wait`` wait until reading finish h](jJ)}(h ``bool wait``h]jP)}(hj0h]h bool wait}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jOhj0ubah}(h]h ]h"]h$]h&]uh1jIhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMu hj0ubjf)}(hhh]h)}(hwait until reading finishh]hwait until reading finish}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj0hMu hj0ubah}(h]h ]h"]h$]h&]uh1jehj0ubeh}(h]h ]h"]h$]h&]uh1jChj0hMu hj0ubeh}(h]h ]h"]h$]h&]uh1j>hj/ubh)}(h**Description**h]j))}(hj0h]h Description}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hj0ubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMw hj/ubh)}(h9Returns zero on success or don't wait, and -EIO on error.h]h;Returns zero on success or don’t wait, and -EIO on error.}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMv hj/ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h__bh_read_batch (C function)c.__bh_read_batchhNtauh1hhhhhhNhNubh)}(hhh](j)}(h]void __bh_read_batch (int nr, struct buffer_head *bhs[], blk_opf_t op_flags, bool force_lock)h]j )}(h\void __bh_read_batch(int nr, struct buffer_head *bhs[], blk_opf_t op_flags, bool force_lock)h](j)}(hvoidh]hvoid}(hj1hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj 1hhhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM ubj!)}(h h]h }(hj1hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj 1hhhj1hM ubj2)}(h__bh_read_batchh]j8)}(h__bh_read_batchh]h__bh_read_batch}(hj/1hhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hj+1ubah}(h]h ](jKjLeh"]h$]h&]jPjQuh1j1hj 1hhhj1hM ubjS)}(hH(int nr, struct buffer_head *bhs[], blk_opf_t op_flags, bool force_lock)h](jY)}(hint nrh](j)}(hinth]hint}(hjK1hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjG1ubj!)}(h h]h }(hjY1hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjG1ubj8)}(hnrh]hnr}(hjg1hhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hjG1ubeh}(h]h ]h"]h$]h&]noemphjPjQuh1jXhjC1ubjY)}(hstruct buffer_head *bhs[]h](j_)}(hjbh]hstruct}(hj1hhhNhNubah}(h]h ]jkah"]h$]h&]uh1j^hj|1ubj!)}(h h]h }(hj1hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj|1ubh)}(hhh]j8)}(h buffer_headh]h buffer_head}(hj1hhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hj1ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj1modnameN classnameNjj)}j]j)}jj11sbc.__bh_read_batchasbuh1hhj|1ubj!)}(h h]h }(hj1hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj|1ubj)}(hjh]h*}(hj1hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|1ubj8)}(hbhsh]hbhs}(hj1hhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hj|1ubj)}(h[h]h[}(hj1hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|1ubj)}(h]h]h]}(hj1hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|1ubeh}(h]h ]h"]h$]h&]noemphjPjQuh1jXhjC1ubjY)}(hblk_opf_t op_flagsh](h)}(hhh]j8)}(h blk_opf_th]h blk_opf_t}(hj2hhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hj2ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj2modnameN classnameNjj)}j]j1c.__bh_read_batchasbuh1hhj 2ubj!)}(h h]h }(hj/2hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj 2ubj8)}(hop_flagsh]hop_flags}(hj=2hhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hj 2ubeh}(h]h ]h"]h$]h&]noemphjPjQuh1jXhjC1ubjY)}(hbool force_lockh](j)}(hj) h]hbool}(hjV2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjR2ubj!)}(h h]h }(hjc2hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjR2ubj8)}(h force_lockh]h force_lock}(hjq2hhhNhNubah}(h]h ]jDah"]h$]h&]uh1j7hjR2ubeh}(h]h ]h"]h$]h&]noemphjPjQuh1jXhjC1ubeh}(h]h ]h"]h$]h&]jPjQuh1jRhj 1hhhj1hM ubeh}(h]h ]h"]h$]h&]jPjQjuh1jjjhj1hhhj1hM ubah}(h]j1ah ](jjeh"]h$]h&]jj)jhuh1jhj1hM hj1hhubj)}(hhh]h)}(h+Submit read for a batch of unlocked buffersh]h+Submit read for a batch of unlocked buffers}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM hj2hhubah}(h]h ]h"]h$]h&]uh1jhj1hhhj1hM ubeh}(h]h ](jfunctioneh"]h$]h&]jjjj2jj2jjjuh1hhhhhhNhNubj)}(hX**Parameters** ``int nr`` entry number of the buffer batch ``struct buffer_head *bhs[]`` a batch of struct buffer_head ``blk_opf_t op_flags`` appending REQ_OP_* flags besides REQ_OP_READ ``bool force_lock`` force to get a lock on the buffer if set, otherwise drops any buffer that cannot lock. **Description** Returns zero on success or don't wait, and -EIO on error.h](h)}(h**Parameters**h]j))}(hj2h]h Parameters}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hj2ubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM hj2ubj?)}(hhh](jD)}(h,``int nr`` entry number of the buffer batch h](jJ)}(h ``int nr``h]jP)}(hj2h]hint nr}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jOhj2ubah}(h]h ]h"]h$]h&]uh1jIhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM hj2ubjf)}(hhh]h)}(h entry number of the buffer batchh]h entry number of the buffer batch}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj2hM hj2ubah}(h]h ]h"]h$]h&]uh1jehj2ubeh}(h]h ]h"]h$]h&]uh1jChj2hM hj2ubjD)}(h<``struct buffer_head *bhs[]`` a batch of struct buffer_head h](jJ)}(h``struct buffer_head *bhs[]``h]jP)}(hj3h]hstruct buffer_head *bhs[]}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jOhj3ubah}(h]h ]h"]h$]h&]uh1jIhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM hj3ubjf)}(hhh]h)}(ha batch of struct buffer_headh]ha batch of struct buffer_head}(hj.3hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj*3hM hj+3ubah}(h]h ]h"]h$]h&]uh1jehj3ubeh}(h]h ]h"]h$]h&]uh1jChj*3hM hj2ubjD)}(hD``blk_opf_t op_flags`` appending REQ_OP_* flags besides REQ_OP_READ h](jJ)}(h``blk_opf_t op_flags``h]jP)}(hjN3h]hblk_opf_t op_flags}(hjP3hhhNhNubah}(h]h ]h"]h$]h&]uh1jOhjL3ubah}(h]h ]h"]h$]h&]uh1jIhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM hjH3ubjf)}(hhh]h)}(h,appending REQ_OP_* flags besides REQ_OP_READh]h,appending REQ_OP_* flags besides REQ_OP_READ}(hjg3hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjc3hM hjd3ubah}(h]h ]h"]h$]h&]uh1jehjH3ubeh}(h]h ]h"]h$]h&]uh1jChjc3hM hj2ubjD)}(hk``bool force_lock`` force to get a lock on the buffer if set, otherwise drops any buffer that cannot lock. h](jJ)}(h``bool force_lock``h]jP)}(hj3h]hbool force_lock}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jOhj3ubah}(h]h ]h"]h$]h&]uh1jIhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM hj3ubjf)}(hhh]h)}(hVforce to get a lock on the buffer if set, otherwise drops any buffer that cannot lock.h]hVforce to get a lock on the buffer if set, otherwise drops any buffer that cannot lock.}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM hj3ubah}(h]h ]h"]h$]h&]uh1jehj3ubeh}(h]h ]h"]h$]h&]uh1jChj3hM hj2ubeh}(h]h ]h"]h$]h&]uh1j>hj2ubh)}(h**Description**h]j))}(hj3h]h Description}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hj3ubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM hj2ubh)}(h9Returns zero on success or don't wait, and -EIO on error.h]h;Returns zero on success or don’t wait, and -EIO on error.}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM hj2ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubeh}(h] functionsah ]h"] functionsah$]h&]uh1hhhhhhhhKubeh}(h] buffer-headsah ]h"] buffer headsah$]h&]uh1hhhhhhhhKubeh}(h]h ]h"]h$]h&]sourcehuh1hcurrent_sourceN current_lineNsettingsdocutils.frontendValues)}(hN generatorN datestampN source_linkN source_urlN toc_backlinksentryfootnote_backlinksK sectnum_xformKstrip_commentsNstrip_elements_with_classesN strip_classesN report_levelK halt_levelKexit_status_levelKdebugNwarning_streamN tracebackinput_encoding utf-8-siginput_encoding_error_handlerstrictoutput_encodingutf-8output_encoding_error_handlerj"4error_encodingutf-8error_encoding_error_handlerbackslashreplace language_codeenrecord_dependenciesNconfigN id_prefixhauto_id_prefixid dump_settingsNdump_internalsNdump_transformsNdump_pseudo_xmlNexpose_internalsNstrict_visitorN_disable_configN_sourcehʌ _destinationN _config_files]7/var/lib/git/docbuild/linux/Documentation/docutils.confafile_insertion_enabled raw_enabledKline_length_limitM'pep_referencesN pep_base_urlhttps://peps.python.org/pep_file_url_templatepep-%04drfc_referencesN rfc_base_url&https://datatracker.ietf.org/doc/html/ tab_widthKtrim_footnote_reference_spacesyntax_highlightlong smart_quotessmartquotes_locales]character_level_inline_markupdoctitle_xform docinfo_xformKsectsubtitle_xform image_loadinglinkembed_stylesheetcloak_email_addressessection_self_linkenvNubreporterNindirect_targets]substitution_defs}substitution_names}refnames}refids}nameids}(j3j3j3j3u nametypes}(j3j3uh}(j3hj3hhjj jjjjjj j j j jvj{jjjxj}jjjjj`jejjjjjjjjj!j"j%j%j^(jc(j*j*j-j-j.j.j1j1u footnote_refs} citation_refs} autofootnotes]autofootnote_refs]symbol_footnotes]symbol_footnote_refs] footnotes] citations]autofootnote_startKsymbol_footnote_startK id_counter collectionsCounter}Rparse_messages]transform_messages] transformerN include_log] decorationNhhub.