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](singlekmap_local_bh (C function)c.kmap_local_bhhNtauh1hhhhhhNhNubhdesc)}(hhh](hdesc_signature)}(h3void * kmap_local_bh (const struct buffer_head *bh)h]hdesc_signature_line)}(h1void *kmap_local_bh(const 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.hhKubhdesc_sig_space)}(h h]h }(hj"hhhNhNubah}(h]h ]wah"]h$]h&]uh1j hj hhhjhKubhdesc_sig_punctuation)}(h*h]h*}(hj3hhhNhNubah}(h]h ]pah"]h$]h&]uh1j1hj hhhjhKubh desc_name)}(h kmap_local_bhh]h desc_sig_name)}(h kmap_local_bhh]h kmap_local_bh}(hjJhhhNhNubah}(h]h ]nah"]h$]h&]uh1jHhjDubah}(h]h ](sig-namedescnameeh"]h$]h&] xml:spacepreserveuh1jBhj hhhjhKubhdesc_parameterlist)}(h(const struct buffer_head *bh)h]hdesc_parameter)}(hconst struct buffer_head *bhh](hdesc_sig_keyword)}(hconsth]hconst}(hjqhhhNhNubah}(h]h ]kah"]h$]h&]uh1johjkubj!)}(h h]h }(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjkubjp)}(hstructh]hstruct}(hjhhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johjkubj!)}(h h]h }(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjkubh)}(hhh]jI)}(h buffer_headh]h buffer_head}(hjhhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomaincreftype identifier reftargetjmodnameN classnameN c:parent_keysphinx.domains.c LookupKey)}data]j ASTIdentifier)}jjLsbc.kmap_local_bhasbuh1hhjkubj!)}(h h]h }(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjkubj2)}(hj5h]h*}(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjkubjI)}(hbhh]hbh}(hjhhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhjkubeh}(h]h ]h"]h$]h&]noemphjajbuh1jihjeubah}(h]h ]h"]h$]h&]jajbuh1jchj hhhjhKubeh}(h]h ]h"]h$]h&]jajb add_permalinkuh1jsphinx_line_type declaratorhjhhhjhKubah}(h]hah ](sig sig-objecteh"]h$]h&] is_multiline _toc_parts) _toc_namehuh1jhjhKhhhhubh desc_content)}(hhh]h)}(hMap the data of a buffer.h]hMap the data of a buffer.}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhKhj"hhubah}(h]h ]h"]h$]h&]uh1j hhhhhjhKubeh}(h]h ](jfunctioneh"]h$]h&]domainjobjtypej=desctypej=noindex noindexentrynocontentsentryuh1hhhhhhNhNubh container)}(hXj**Parameters** ``const struct buffer_head *bh`` The buffer. **Description** Buffers usually live in the page cache, but a few are built over memory which is not. Those carry no folio and b_data is already a kernel address which is always mapped, so there is nothing to do for them. Pair with kunmap_local_bh(). **Return** A pointer to the buffer's data.h](h)}(h**Parameters**h]hstrong)}(hjOh]h Parameters}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1jQhjMubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhKhjIubhdefinition_list)}(hhh]hdefinition_list_item)}(h-``const struct buffer_head *bh`` The buffer. h](hterm)}(h ``const struct buffer_head *bh``h]hliteral)}(hjvh]hconst struct buffer_head *bh}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1jxhjtubah}(h]h ]h"]h$]h&]uh1jrh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhKhjnubh definition)}(hhh]h)}(h The buffer.h]h The buffer.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjnubeh}(h]h ]h"]h$]h&]uh1jlhjhKhjiubah}(h]h ]h"]h$]h&]uh1jghjIubh)}(h**Description**h]jR)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jQhjubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhKhjIubh)}(hBuffers usually live in the page cache, but a few are built over memory which is not. Those carry no folio and b_data is already a kernel address which is always mapped, so there is nothing to do for them. Pair with kunmap_local_bh().h]hBuffers usually live in the page cache, but a few are built over memory which is not. Those carry no folio and b_data is already a kernel address which is always mapped, so there is nothing to do for them. Pair with kunmap_local_bh().}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhKhjIubh)}(h **Return**h]jR)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jQhjubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhKhjIubh)}(hA pointer to the buffer's data.h]h!A pointer to the buffer’s data.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhKhjIubeh}(h]h ] kernelindentah"]h$]h&]uh1jGhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hkunmap_local_bh (C function)c.kunmap_local_bhhNtauh1hhhhhhNhNubh)}(hhh](j)}(h?void kunmap_local_bh (const struct buffer_head *bh, void *addr)h]j )}(h>void kunmap_local_bh(const struct buffer_head *bh, void *addr)h](j)}(hvoidh]hvoid}(hj!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhKubj!)}(h h]h }(hj0hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjhhhj/hKubjC)}(hkunmap_local_bhh]jI)}(hkunmap_local_bhh]hkunmap_local_bh}(hjBhhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj>ubah}(h]h ](j\j]eh"]h$]h&]jajbuh1jBhjhhhj/hKubjd)}(h*(const struct buffer_head *bh, void *addr)h](jj)}(hconst struct buffer_head *bhh](jp)}(hjsh]hconst}(hj^hhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johjZubj!)}(h h]h }(hjkhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjZubjp)}(hjh]hstruct}(hjyhhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johjZubj!)}(h h]h }(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjZubh)}(hhh]jI)}(h buffer_headh]h buffer_head}(hjhhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj)}j]j)}jjDsbc.kunmap_local_bhasbuh1hhjZubj!)}(h h]h }(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjZubj2)}(hj5h]h*}(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjZubjI)}(hbhh]hbh}(hjhhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhjZubeh}(h]h ]h"]h$]h&]noemphjajbuh1jihjVubjj)}(h void *addrh](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj!)}(h h]h }(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjubj2)}(hj5h]h*}(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(haddrh]haddr}(hjhhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphjajbuh1jihjVubeh}(h]h ]h"]h$]h&]jajbuh1jchjhhhj/hKubeh}(h]h ]h"]h$]h&]jajbjuh1jjjhjhhhj/hKubah}(h]jah ](jjeh"]h$]h&]jj)jhuh1jhj/hKhjhhubj!)}(hhh]h)}(hUnmap the data of a buffer.h]hUnmap the data of a buffer.}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhKhj;hhubah}(h]h ]h"]h$]h&]uh1j hjhhhj/hKubeh}(h]h ](jfunctioneh"]h$]h&]jAjjBjVjCjVjDjEjFuh1hhhhhhNhNubjH)}(hy**Parameters** ``const struct buffer_head *bh`` The buffer. ``void *addr`` The address returned by kmap_local_bh().h](h)}(h**Parameters**h]jR)}(hj`h]h Parameters}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1jQhj^ubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhKhjZubjh)}(hhh](jm)}(h-``const struct buffer_head *bh`` The buffer. h](js)}(h ``const struct buffer_head *bh``h]jy)}(hjh]hconst struct buffer_head *bh}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jxhj}ubah}(h]h ]h"]h$]h&]uh1jrh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhKhjyubj)}(hhh]h)}(h The buffer.h]h The buffer.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjyubeh}(h]h ]h"]h$]h&]uh1jlhjhKhjvubjm)}(h7``void *addr`` The address returned by kmap_local_bh().h](js)}(h``void *addr``h]jy)}(hjh]h void *addr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jxhjubah}(h]h ]h"]h$]h&]uh1jrh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhKhjubj)}(hhh]h)}(h(The address returned by kmap_local_bh().h]h(The address returned by kmap_local_bh().}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jlhjhKhjvubeh}(h]h ]h"]h$]h&]uh1jghjZubeh}(h]h ] kernelindentah"]h$]h&]uh1jGhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hbrelse (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&]uh1jhjhhh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMDubj!)}(h h]h }(hj!hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjhhhj hMDubjC)}(hbrelseh]jI)}(hbrelseh]hbrelse}(hj3hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj/ubah}(h]h ](j\j]eh"]h$]h&]jajbuh1jBhjhhhj hMDubjd)}(h(struct buffer_head *bh)h]jj)}(hstruct buffer_head *bhh](jp)}(hjh]hstruct}(hjOhhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johjKubj!)}(h h]h }(hj\hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjKubh)}(hhh]jI)}(h buffer_headh]h buffer_head}(hjmhhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhjjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjomodnameN classnameNjj)}j]j)}jj5sbc.brelseasbuh1hhjKubj!)}(h h]h }(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjKubj2)}(hj5h]h*}(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjKubjI)}(hbhh]hbh}(hjhhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhjKubeh}(h]h ]h"]h$]h&]noemphjajbuh1jihjGubah}(h]h ]h"]h$]h&]jajbuh1jchjhhhj hMDubeh}(h]h ]h"]h$]h&]jajbjuh1jjjhj hhhj hMDubah}(h]jah ](jjeh"]h$]h&]jj)jhuh1jhj hMDhjhhubj!)}(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.hhMDhjhhubah}(h]h ]h"]h$]h&]uh1j hjhhhj hMDubeh}(h]h ](jfunctioneh"]h$]h&]jAjjBjjCjjDjEjFuh1hhhhhhNhNubjH)}(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]jR)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jQhjubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMHhjubjh)}(hhh]jm)}(h2``struct buffer_head *bh`` The buffer to release. h](js)}(h``struct buffer_head *bh``h]jy)}(hjh]hstruct buffer_head *bh}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jxhjubah}(h]h ]h"]h$]h&]uh1jrh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMEhj ubj)}(hhh]h)}(hThe buffer to release.h]hThe buffer to release.}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj(hMEhj)ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jlhj(hMEhj ubah}(h]h ]h"]h$]h&]uh1jghjubh)}(h**Description**h]jR)}(hjNh]h Description}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jQhjLubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMGhjubh)}(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 }(hjdhhhNhNubjR)}(h**bh**h]hbh}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1jQhjdubh# is NULL, this function is a no-op.}(hjdhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMFhjubh)}(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.hhMIhjubh)}(h **Context**h]jR)}(hjh]hContext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jQhjubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMPhjubh)}(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.hhMQhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jGhhhhhNhNubh)}(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.hhMZubj!)}(h h]h }(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjhhhjhMZubjC)}(hbforgeth]jI)}(hbforgeth]hbforget}(hjhhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhjubah}(h]h ](j\j]eh"]h$]h&]jajbuh1jBhjhhhjhMZubjd)}(h(struct buffer_head *bh)h]jj)}(hstruct buffer_head *bhh](jp)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johjubj!)}(h h]h }(hj%hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjubh)}(hhh]jI)}(h buffer_headh]h buffer_head}(hj6hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj3ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj8modnameN classnameNjj)}j]j)}jjsb c.bforgetasbuh1hhjubj!)}(h h]h }(hjVhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjubj2)}(hj5h]h*}(hjdhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hbhh]hbh}(hjqhhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphjajbuh1jihjubah}(h]h ]h"]h$]h&]jajbuh1jchjhhhjhMZubeh}(h]h ]h"]h$]h&]jajbjuh1jjjhjhhhjhMZubah}(h]jah ](jjeh"]h$]h&]jj)jhuh1jhjhMZhjhhubj!)}(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.hhMZhjhhubah}(h]h ]h"]h$]h&]uh1j hjhhhjhMZubeh}(h]h ](jfunctioneh"]h$]h&]jAjjBjjCjjDjEjFuh1hhhhhhNhNubjH)}(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]jR)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jQhjubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhM^hjubjh)}(hhh]jm)}(h1``struct buffer_head *bh`` The buffer to forget. h](js)}(h``struct buffer_head *bh``h]jy)}(hjh]hstruct buffer_head *bh}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jxhjubah}(h]h ]h"]h$]h&]uh1jrh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhM[hjubj)}(hhh]h)}(hThe buffer to forget.h]hThe buffer to forget.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM[hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jlhjhM[hjubah}(h]h ]h"]h$]h&]uh1jghjubh)}(h**Description**h]jR)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jQhjubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhM]hjubh)}(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.}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhM\hjubh)}(h **Context**h]jR)}(hj>h]hContext}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jQhj<ubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhM`hjubh)}(h Any context.h]h Any context.}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMahjubeh}(h]h ] kernelindentah"]h$]h&]uh1jGhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hsb_bread (C function) c.sb_breadhNtauh1hhhhhhNhNubh)}(hhh](j)}(hFstruct buffer_head * sb_bread (struct super_block *sb, sector_t block)h]j )}(hDstruct buffer_head *sb_bread(struct super_block *sb, sector_t block)h](jp)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johjhhh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMjubj!)}(h h]h }(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjhhhjhMjubh)}(hhh]jI)}(h buffer_headh]h buffer_head}(hjhhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj)}j]j)}jsb_breadsb c.sb_breadasbuh1hhjhhhjhMjubj!)}(h h]h }(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjhhhjhMjubj2)}(hj5h]h*}(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMjubjC)}(hsb_breadh]jI)}(hjh]hsb_bread}(hjhhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhjubah}(h]h ](j\j]eh"]h$]h&]jajbuh1jBhjhhhjhMjubjd)}(h((struct super_block *sb, sector_t block)h](jj)}(hstruct super_block *sbh](jp)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johjubj!)}(h h]h }(hj hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjubh)}(hhh]jI)}(h super_blockh]h super_block}(hj hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj modnameN classnameNjj)}j]j c.sb_breadasbuh1hhjubj!)}(h h]h }(hj9 hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjubj2)}(hj5h]h*}(hjG hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hsbh]hsb}(hjT hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphjajbuh1jihjubjj)}(hsector_t blockh](h)}(hhh]jI)}(hsector_th]hsector_t}(hjp hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhjm ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjr modnameN classnameNjj)}j]j c.sb_breadasbuh1hhji ubj!)}(h h]h }(hj hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hji ubjI)}(hblockh]hblock}(hj hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhji ubeh}(h]h ]h"]h$]h&]noemphjajbuh1jihjubeh}(h]h ]h"]h$]h&]jajbuh1jchjhhhjhMjubeh}(h]h ]h"]h$]h&]jajbjuh1jjjhj{hhhjhMjubah}(h]jvah ](jjeh"]h$]h&]jj)jhuh1jhjhMjhjxhhubj!)}(hhh]h)}(h Read a block.h]h Read a block.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMjhj hhubah}(h]h ]h"]h$]h&]uh1j hjxhhhjhMjubeh}(h]h ](jfunctioneh"]h$]h&]jAjjBj jCj jDjEjFuh1hhhhhhNhNubjH)}(hX**Parameters** ``struct super_block *sb`` The superblock to read from. ``sector_t block`` Block number in units of block size. **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]jR)}(hj h]h Parameters}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jQhj ubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMnhj ubjh)}(hhh](jm)}(h8``struct super_block *sb`` The superblock to read from. h](js)}(h``struct super_block *sb``h]jy)}(hj h]hstruct super_block *sb}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jxhj ubah}(h]h ]h"]h$]h&]uh1jrh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMkhj ubj)}(hhh]h)}(hThe superblock to read from.h]hThe superblock to read from.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMkhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jlhj hMkhj ubjm)}(h8``sector_t block`` Block number in units of block size. h](js)}(h``sector_t block``h]jy)}(hj@ h]hsector_t block}(hjB hhhNhNubah}(h]h ]h"]h$]h&]uh1jxhj> ubah}(h]h ]h"]h$]h&]uh1jrh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMlhj: ubj)}(hhh]h)}(h$Block number in units of block size.h]h$Block number in units of block size.}(hjY hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjU hMlhjV ubah}(h]h ]h"]h$]h&]uh1jhj: ubeh}(h]h ]h"]h$]h&]uh1jlhjU hMlhj ubeh}(h]h ]h"]h$]h&]uh1jghj ubh)}(h**Description**h]jR)}(hj{ h]h Description}(hj} hhhNhNubah}(h]h ]h"]h$]h&]uh1jQhjy ubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMnhj ubh)}(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.hhMmhj ubh)}(h **Context**h]jR)}(hj h]hContext}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jQhj ubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMrhj ubh)}(hMay sleep waiting for I/O.h]hMay sleep waiting for I/O.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMshj ubh)}(h **Return**h]jR)}(hj h]hReturn}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jQhj ubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMuhj ubh)}(h!NULL if the block was unreadable.h]h!NULL if the block was unreadable.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMthj ubeh}(h]h ] kernelindentah"]h$]h&]uh1jGhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hsb_bread_unmovable (C function)c.sb_bread_unmovablehNtauh1hhhhhhNhNubh)}(hhh](j)}(hPstruct buffer_head * sb_bread_unmovable (struct super_block *sb, sector_t block)h]j )}(hNstruct buffer_head *sb_bread_unmovable(struct super_block *sb, sector_t block)h](jp)}(hjh]hstruct}(hj hhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johj hhh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhM}ubj!)}(h h]h }(hj hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj hhhj hM}ubh)}(hhh]jI)}(h buffer_headh]h buffer_head}(hj- hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj* ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj/ modnameN classnameNjj)}j]j)}jsb_bread_unmovablesbc.sb_bread_unmovableasbuh1hhj hhhj hM}ubj!)}(h h]h }(hjN hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj hhhj hM}ubj2)}(hj5h]h*}(hj\ hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj hhhj hM}ubjC)}(hsb_bread_unmovableh]jI)}(hjK h]hsb_bread_unmovable}(hjm hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhji ubah}(h]h ](j\j]eh"]h$]h&]jajbuh1jBhj hhhj hM}ubjd)}(h((struct super_block *sb, sector_t block)h](jj)}(hstruct super_block *sbh](jp)}(hjh]hstruct}(hj hhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johj ubj!)}(h h]h }(hj hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj ubh)}(hhh]jI)}(h super_blockh]h super_block}(hj hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj modnameN classnameNjj)}j]jI c.sb_bread_unmovableasbuh1hhj ubj!)}(h h]h }(hj hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj ubj2)}(hj5h]h*}(hj hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj ubjI)}(hsbh]hsb}(hj hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj ubeh}(h]h ]h"]h$]h&]noemphjajbuh1jihj ubjj)}(hsector_t blockh](h)}(hhh]jI)}(hsector_th]hsector_t}(hj hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj modnameN classnameNjj)}j]jI c.sb_bread_unmovableasbuh1hhj ubj!)}(h h]h }(hj hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj ubjI)}(hblockh]hblock}(hj' hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj ubeh}(h]h ]h"]h$]h&]noemphjajbuh1jihj ubeh}(h]h ]h"]h$]h&]jajbuh1jchj hhhj hM}ubeh}(h]h ]h"]h$]h&]jajbjuh1jjjhj hhhj hM}ubah}(h]j ah ](jjeh"]h$]h&]jj)jhuh1jhj hM}hj hhubj!)}(hhh]h)}(h Read a block.h]h Read a block.}(hjQ hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhM}hjN hhubah}(h]h ]h"]h$]h&]uh1j hj hhhj hM}ubeh}(h]h ](jfunctioneh"]h$]h&]jAjjBji jCji jDjEjFuh1hhhhhhNhNubjH)}(hX**Parameters** ``struct super_block *sb`` The superblock to read from. ``sector_t block`` Block number in units of block size. **Description** Read a specified block, and return the buffer head that refers to it. The memory is allocated from the unmovable area so that pointers into it remain valid after compaction runs. 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]jR)}(hjs h]h Parameters}(hju hhhNhNubah}(h]h ]h"]h$]h&]uh1jQhjq ubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMhjm ubjh)}(hhh](jm)}(h8``struct super_block *sb`` The superblock to read from. h](js)}(h``struct super_block *sb``h]jy)}(hj h]hstruct super_block *sb}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jxhj ubah}(h]h ]h"]h$]h&]uh1jrh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhM~hj ubj)}(hhh]h)}(hThe superblock to read from.h]hThe superblock to read from.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hM~hj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jlhj hM~hj ubjm)}(h8``sector_t block`` Block number in units of block size. h](js)}(h``sector_t block``h]jy)}(hj h]hsector_t block}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jxhj ubah}(h]h ]h"]h$]h&]uh1jrh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMhj ubj)}(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&]uh1hhj hMhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jlhj hMhj ubeh}(h]h ]h"]h$]h&]uh1jghjm ubh)}(h**Description**h]jR)}(hj h]h Description}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jQhj ubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMhjm ubh)}(hX/Read a specified block, and return the buffer head that refers to it. The memory is allocated from the unmovable area so that pointers into it remain valid after compaction runs. 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 unmovable area so that pointers into it remain valid after compaction runs. 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.hhMhjm ubh)}(h **Context**h]jR)}(hj- h]hContext}(hj/ hhhNhNubah}(h]h ]h"]h$]h&]uh1jQhj+ ubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMhjm ubh)}(hMay sleep waiting for I/O.h]hMay sleep waiting for I/O.}(hjC hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMhjm ubh)}(h **Return**h]jR)}(hjT h]hReturn}(hjV hhhNhNubah}(h]h ]h"]h$]h&]uh1jQhjR ubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMhjm ubh)}(h!NULL if the block was unreadable.h]h!NULL if the block was unreadable.}(hjj hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMhjm ubeh}(h]h ] kernelindentah"]h$]h&]uh1jGhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hsb_breadahead (C function)c.sb_breadaheadhNtauh1hhhhhhNhNubh)}(hhh](j)}(h;void sb_breadahead (struct super_block *sb, sector_t block)h]j )}(h:void sb_breadahead(struct super_block *sb, sector_t block)h](j)}(hvoidh]hvoid}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMubj!)}(h h]h }(hj hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj hhhj hMubjC)}(h sb_breadaheadh]jI)}(h sb_breadaheadh]h sb_breadahead}(hj hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj ubah}(h]h ](j\j]eh"]h$]h&]jajbuh1jBhj hhhj hMubjd)}(h((struct super_block *sb, sector_t block)h](jj)}(hstruct super_block *sbh](jp)}(hjh]hstruct}(hj hhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johj ubj!)}(h h]h }(hj hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj ubh)}(hhh]jI)}(h super_blockh]h super_block}(hj hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj modnameN classnameNjj)}j]j)}jj sbc.sb_breadaheadasbuh1hhj ubj!)}(h h]h }(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj ubj2)}(hj5h]h*}(hj"hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj ubjI)}(hsbh]hsb}(hj/hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj ubeh}(h]h ]h"]h$]h&]noemphjajbuh1jihj ubjj)}(hsector_t blockh](h)}(hhh]jI)}(hsector_th]hsector_t}(hjKhhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhjHubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjMmodnameN classnameNjj)}j]jc.sb_breadaheadasbuh1hhjDubj!)}(h h]h }(hjihhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjDubjI)}(hblockh]hblock}(hjwhhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhjDubeh}(h]h ]h"]h$]h&]noemphjajbuh1jihj ubeh}(h]h ]h"]h$]h&]jajbuh1jchj hhhj hMubeh}(h]h ]h"]h$]h&]jajbjuh1jjjhj hhhj hMubah}(h]j ah ](jjeh"]h$]h&]jj)jhuh1jhj hMhj hhubj!)}(hhh]h)}(hStart readahead.h]hStart readahead.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMhjhhubah}(h]h ]h"]h$]h&]uh1j hj hhhj hMubeh}(h]h ](jfunctioneh"]h$]h&]jAjjBjjCjjDjEjFuh1hhhhhhNhNubjH)}(hX`**Parameters** ``struct super_block *sb`` Superblock identifying the block device. ``sector_t block`` The block to read. **Description** Read this block. The I/O will be flagged as being readahead rather than immediate read, but (unlike the page cache), surrounding blocks will not be read. **Context** May sleep in order to allocate memory.h](h)}(h**Parameters**h]jR)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jQhjubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMhjubjh)}(hhh](jm)}(hD``struct super_block *sb`` Superblock identifying the block device. h](js)}(h``struct super_block *sb``h]jy)}(hjh]hstruct super_block *sb}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jxhjubah}(h]h ]h"]h$]h&]uh1jrh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMhjubj)}(hhh]h)}(h(Superblock identifying the block device.h]h(Superblock identifying the block device.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jlhjhMhjubjm)}(h&``sector_t block`` The block to read. h](js)}(h``sector_t block``h]jy)}(hjh]hsector_t block}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jxhjubah}(h]h ]h"]h$]h&]uh1jrh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMhjubj)}(hhh]h)}(hThe block to read.h]hThe block to read.}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj0hMhj1ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jlhj0hMhjubeh}(h]h ]h"]h$]h&]uh1jghjubh)}(h**Description**h]jR)}(hjVh]h Description}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1jQhjTubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMhjubh)}(hRead this block. The I/O will be flagged as being readahead rather than immediate read, but (unlike the page cache), surrounding blocks will not be read.h]hRead this block. The I/O will be flagged as being readahead rather than immediate read, but (unlike the page cache), surrounding blocks will not be read.}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMhjubh)}(h **Context**h]jR)}(hj}h]hContext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jQhj{ubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMhjubh)}(h&May sleep in order to allocate memory.h]h&May sleep in order to allocate memory.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jGhhhhhNhNubh)}(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](jp)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johjhhh^/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]jI)}(h buffer_headh]h buffer_head}(hjhhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhjubah}(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 hjhhhjhMubj2)}(hj5h]h*}(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMubjC)}(h__breadh]jI)}(hjh]h__bread}(hj!hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhjubah}(h]h ](j\j]eh"]h$]h&]jajbuh1jBhjhhhjhMubjd)}(h:(struct block_device *bdev, sector_t block, unsigned size)h](jj)}(hstruct block_device *bdevh](jp)}(hjh]hstruct}(hj<hhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johj8ubj!)}(h h]h }(hjIhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj8ubh)}(hhh]jI)}(h block_deviceh]h block_device}(hjZhhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhjWubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj\modnameN classnameNjj)}j]j c.__breadasbuh1hhj8ubj!)}(h h]h }(hjxhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj8ubj2)}(hj5h]h*}(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj8ubjI)}(hbdevh]hbdev}(hjhhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj8ubeh}(h]h ]h"]h$]h&]noemphjajbuh1jihj4ubjj)}(hsector_t blockh](h)}(hhh]jI)}(hsector_th]hsector_t}(hjhhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj)}j]j c.__breadasbuh1hhjubj!)}(h h]h }(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjubjI)}(hblockh]hblock}(hjhhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphjajbuh1jihj4ubjj)}(h unsigned sizeh](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj!)}(h h]h }(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjubjI)}(hsizeh]hsize}(hjhhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphjajbuh1jihj4ubeh}(h]h ]h"]h$]h&]jajbuh1jchjhhhjhMubeh}(h]h ]h"]h$]h&]jajbjuh1jjjhjhhhjhMubah}(h]jah ](jjeh"]h$]h&]jj)jhuh1jhjhMhjhhubj!)}(hhh]h)}(h Read a block.h]h Read a block.}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMhj7hhubah}(h]h ]h"]h$]h&]uh1j hjhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jAjjBjRjCjRjDjEjFuh1hhhhhhNhNubjH)}(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]jR)}(hj\h]h Parameters}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1jQhjZubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMhjVubjh)}(hhh](jm)}(h=``struct block_device *bdev`` The block device to read from. h](js)}(h``struct block_device *bdev``h]jy)}(hj{h]hstruct block_device *bdev}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1jxhjyubah}(h]h ]h"]h$]h&]uh1jrh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMhjuubj)}(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&]uh1jhjuubeh}(h]h ]h"]h$]h&]uh1jlhjhMhjrubjm)}(h8``sector_t block`` Block number in units of block size. h](js)}(h``sector_t block``h]jy)}(hjh]hsector_t block}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jxhjubah}(h]h ]h"]h$]h&]uh1jrh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMhjubj)}(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&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jlhjhMhjrubjm)}(h:``unsigned size`` The block size of this device in bytes. h](js)}(h``unsigned size``h]jy)}(hjh]h unsigned size}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jxhjubah}(h]h ]h"]h$]h&]uh1jrh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMhjubj)}(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&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jlhjhMhjrubeh}(h]h ]h"]h$]h&]uh1jghjVubh)}(h**Description**h]jR)}(hj(h]h Description}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1jQhj&ubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMhjVubh)}(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.hhMhjVubh)}(h **Context**h]jR)}(hjOh]hContext}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jQhjMubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMhjVubh)}(hMay sleep waiting for I/O.h]hMay sleep waiting for I/O.}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMhjVubh)}(h **Return**h]jR)}(hjvh]hReturn}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1jQhjtubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhMhjVubh)}(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.hhMhjVubeh}(h]h ] kernelindentah"]h$]h&]uh1jGhhhhhNhNubh)}(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](jp)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johjhhh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhM#ubj!)}(h h]h }(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjhhhjhM#ubh)}(hhh]jI)}(h buffer_headh]h buffer_head}(hjhhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj)}j]j)}j get_nth_bhsb c.get_nth_bhasbuh1hhjhhhjhM#ubj!)}(h h]h }(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjhhhjhM#ubj2)}(hj5h]h*}(hj hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhM#ubjC)}(h get_nth_bhh]jI)}(hjh]h get_nth_bh}(hjhhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhjubah}(h]h ](j\j]eh"]h$]h&]jajbuh1jBhjhhhjhM#ubjd)}(h,(struct buffer_head *bh, unsigned int count)h](jj)}(hstruct buffer_head *bhh](jp)}(hjh]hstruct}(hj5hhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johj1ubj!)}(h h]h }(hjBhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj1ubh)}(hhh]jI)}(h buffer_headh]h buffer_head}(hjShhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhjPubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjUmodnameN classnameNjj)}j]j c.get_nth_bhasbuh1hhj1ubj!)}(h h]h }(hjqhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj1ubj2)}(hj5h]h*}(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj1ubjI)}(hbhh]hbh}(hjhhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj1ubeh}(h]h ]h"]h$]h&]noemphjajbuh1jihj-ubjj)}(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 hjubjI)}(hcounth]hcount}(hjhhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphjajbuh1jihj-ubeh}(h]h ]h"]h$]h&]jajbuh1jchjhhhjhM#ubeh}(h]h ]h"]h$]h&]jajbjuh1jjjhjhhhjhM#ubah}(h]jah ](jjeh"]h$]h&]jj)jhuh1jhjhM#hjhhubj!)}(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.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhM#hjhhubah}(h]h ]h"]h$]h&]uh1j hjhhhjhM#ubeh}(h]h ](jfunctioneh"]h$]h&]jAjjBjjCjjDjEjFuh1hhhhhhNhNubjH)}(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]jR)}(hj)h]h Parameters}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1jQhj'ubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhM'hj#ubjh)}(hhh](jm)}(h>``struct buffer_head *bh`` The buffer to start counting from. h](js)}(h``struct buffer_head *bh``h]jy)}(hjHh]hstruct buffer_head *bh}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1jxhjFubah}(h]h ]h"]h$]h&]uh1jrh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhM$hjBubj)}(hhh]h)}(h"The buffer to start counting from.h]h"The buffer to start counting from.}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1hhj]hM$hj^ubah}(h]h ]h"]h$]h&]uh1jhjBubeh}(h]h ]h"]h$]h&]uh1jlhj]hM$hj?ubjm)}(h1``unsigned int count`` How many buffers to skip. h](js)}(h``unsigned int count``h]jy)}(hjh]hunsigned int count}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jxhjubah}(h]h ]h"]h$]h&]uh1jrh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhM%hj{ubj)}(hhh]h)}(hHow many buffers to skip.h]hHow many buffers to skip.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM%hjubah}(h]h ]h"]h$]h&]uh1jhj{ubeh}(h]h ]h"]h$]h&]uh1jlhjhM%hj?ubeh}(h]h ]h"]h$]h&]uh1jghj#ubh)}(h**Description**h]jR)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jQhjubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhM'hj#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.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhM&hj#ubh)}(h **Return**h]jR)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jQhjubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:10: ./include/linux/buffer_head.hhM,hj#ubh)}(h/The requested buffer with an elevated refcount.h]h/The requested buffer with an elevated refcount.}(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&]uh1jGhhhhhNhNubh)}(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 )}(hah"]h$]h&]uh1j1hjaubjI)}(hbioh]hbio}(hjhhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhjaubeh}(h]h ]h"]h$]h&]noemphjajbuh1jihj]ubjj)}(hstruct buffer_head **bhph](jp)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johjubj!)}(h h]h }(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjubh)}(hhh]jI)}(h buffer_headh]h buffer_head}(hjhhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj)}j]jc.bio_endio_bhasbuh1hhjubj!)}(h h]h }(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjubj2)}(hj5h]h*}(hj!hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj2)}(hj5h]h*}(hj.hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hbhph]hbhp}(hj;hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphjajbuh1jihj]ubeh}(h]h ]h"]h$]h&]jajbuh1jchj$hhhj6hKubeh}(h]h ]h"]h$]h&]jajbjuh1jjjhj hhhj6hKubah}(h]jah ](jjeh"]h$]h&]jj)jhuh1jhj6hKhjhhubj!)}(hhh]h)}(h(Discard the bio used to submit a buffer.h]h(Discard the bio used to submit a buffer.}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chKhjbhhubah}(h]h ]h"]h$]h&]uh1j hjhhhj6hKubeh}(h]h ](jfunctioneh"]h$]h&]jAjjBj}jCj}jDjEjFuh1hhhhhhNhNubjH)}(hX**Parameters** ``struct bio *bio`` The bio. ``struct buffer_head **bhp`` Where to return the buffer_head. **Description** Call 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. This function consumes the bio refcount which will probably free the bio. **Return** True if the I/O succeeded.h](h)}(h**Parameters**h]jR)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jQhjubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chKhjubjh)}(hhh](jm)}(h``struct bio *bio`` The bio. h](js)}(h``struct bio *bio``h]jy)}(hjh]hstruct bio *bio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jxhjubah}(h]h ]h"]h$]h&]uh1jrhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chKhjubj)}(hhh]h)}(hThe bio.h]hThe bio.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jlhjhKhjubjm)}(h>``struct buffer_head **bhp`` Where to return the buffer_head. h](js)}(h``struct buffer_head **bhp``h]jy)}(hjh]hstruct buffer_head **bhp}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jxhjubah}(h]h ]h"]h$]h&]uh1jrhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chKhjubj)}(hhh]h)}(h Where to return the buffer_head.h]h Where to return the buffer_head.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jlhjhKhjubeh}(h]h ]h"]h$]h&]uh1jghjubh)}(h**Description**h]jR)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jQhjubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chKhjubh)}(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.}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chKhjubh)}(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.chKhjubh)}(h **Return**h]jR)}(hjPh]hReturn}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1jQhjNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chKhjubh)}(hTrue if the I/O succeeded.h]hTrue if the I/O succeeded.}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chKhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jGhhhhhNhNubh)}(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}(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 hjhhhjhKubjC)}(hend_buffer_read_synch]jI)}(hend_buffer_read_synch]hend_buffer_read_sync}(hjhhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhjubah}(h]h ](j\j]eh"]h$]h&]jajbuh1jBhjhhhjhKubjd)}(h&(struct buffer_head *bh, int uptodate)h](jj)}(hstruct buffer_head *bhh](jp)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johjubj!)}(h h]h }(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjubh)}(hhh]jI)}(h buffer_headh]h buffer_head}(hjhhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsbc.end_buffer_read_syncasbuh1hhjubj!)}(h h]h }(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjubj2)}(hj5h]h*}(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hbhh]hbh}(hj+hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphjajbuh1jihjubjj)}(h int uptodateh](j)}(hinth]hint}(hjDhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@ubj!)}(h h]h }(hjRhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj@ubjI)}(huptodateh]huptodate}(hj`hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj@ubeh}(h]h ]h"]h$]h&]noemphjajbuh1jihjubeh}(h]h ]h"]h$]h&]jajbuh1jchjhhhjhKubeh}(h]h ]h"]h$]h&]jajbjuh1jjjhjhhhjhKubah}(h]jah ](jjeh"]h$]h&]jj)jhuh1jhjhKhjhhubj!)}(hhh]h)}(hHandle buffer reads finishingh]hHandle buffer reads finishing}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chKhjhhubah}(h]h ]h"]h$]h&]uh1j hjhhhjhKubeh}(h]h ](jfunctioneh"]h$]h&]jAjjBjjCjjDjEjFuh1hhhhhhNhNubjH)}(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]jR)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jQhjubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chKhjubjh)}(hhh](jm)}(h'``struct buffer_head *bh`` The buffer. h](js)}(h``struct buffer_head *bh``h]jy)}(hjh]hstruct buffer_head *bh}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jxhjubah}(h]h ]h"]h$]h&]uh1jrhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chKhjubj)}(hhh]h)}(h The buffer.h]h The buffer.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jlhjhKhjubjm)}(h2``int uptodate`` True if the read was successful. h](js)}(h``int uptodate``h]jy)}(hjh]h int uptodate}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jxhjubah}(h]h ]h"]h$]h&]uh1jrhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chKhjubj)}(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&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jlhjhKhjubeh}(h]h ]h"]h$]h&]uh1jghjubh)}(h**Description**h]jR)}(hj?h]h Description}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jQhj=ubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chKhjubh)}(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.}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chKhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jGhhhhhNhNubh)}(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 hjhhhjhKubjC)}(h bh_end_readh]jI)}(h bh_end_readh]h bh_end_read}(hjhhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhjubah}(h]h ](j\j]eh"]h$]h&]jajbuh1jBhjhhhjhKubjd)}(h(struct bio *bio)h]jj)}(hstruct bio *bioh](jp)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johjubj!)}(h h]h }(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjubh)}(hhh]jI)}(hbioh]hbio}(hjhhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhjubah}(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 hjubj2)}(hj5h]h*}(hj hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hbioh]hbio}(hjhhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphjajbuh1jihjubah}(h]h ]h"]h$]h&]jajbuh1jchjhhhjhKubeh}(h]h ]h"]h$]h&]jajbjuh1jjjhj|hhhjhKubah}(h]jwah ](jjeh"]h$]h&]jj)jhuh1jhjhKhjyhhubj!)}(hhh]h)}(hI/O end handler for readsh]hI/O end handler for reads}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chKhjAhhubah}(h]h ]h"]h$]h&]uh1j hjyhhhjhKubeh}(h]h ](jfunctioneh"]h$]h&]jAjjBj\jCj\jDjEjFuh1hhhhhhNhNubjH)}(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]jR)}(hjfh]h Parameters}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1jQhjdubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chKhj`ubjh)}(hhh]jm)}(h-``struct bio *bio`` The bio being completed. h](js)}(h``struct bio *bio``h]jy)}(hjh]hstruct bio *bio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jxhjubah}(h]h ]h"]h$]h&]uh1jrhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chKhjubj)}(hhh]h)}(hThe bio being completed.h]hThe bio being completed.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jlhjhKhj|ubah}(h]h ]h"]h$]h&]uh1jghj`ubh)}(h**Description**h]jR)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jQhjubah}(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&]uh1jGhhhhhNhNubh)}(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 hjhhhjhKubjC)}(h bh_end_writeh]jI)}(h bh_end_writeh]h bh_end_write}(hj&hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj"ubah}(h]h ](j\j]eh"]h$]h&]jajbuh1jBhjhhhjhKubjd)}(h(struct bio *bio)h]jj)}(hstruct bio *bioh](jp)}(hjh]hstruct}(hjBhhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johj>ubj!)}(h h]h }(hjOhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj>ubh)}(hhh]jI)}(hbioh]hbio}(hj`hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj]ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjbmodnameN classnameNjj)}j]j)}jj(sbc.bh_end_writeasbuh1hhj>ubj!)}(h h]h }(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj>ubj2)}(hj5h]h*}(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj>ubjI)}(hbioh]hbio}(hjhhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj>ubeh}(h]h ]h"]h$]h&]noemphjajbuh1jihj:ubah}(h]h ]h"]h$]h&]jajbuh1jchjhhhjhKubeh}(h]h ]h"]h$]h&]jajbjuh1jjjhjhhhjhKubah}(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&]uh1j hjhhhjhKubeh}(h]h ](jfunctioneh"]h$]h&]jAjjBjjCjjDjEjFuh1hhhhhhNhNubjH)}(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]jR)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jQhjubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chKhjubjh)}(hhh]jm)}(h-``struct bio *bio`` The bio being completed. h](js)}(h``struct bio *bio``h]jy)}(hjh]hstruct bio *bio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jxhjubah}(h]h ]h"]h$]h&]uh1jrhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chKhjubj)}(hhh]h)}(hThe bio being completed.h]hThe bio being completed.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jlhjhKhjubah}(h]h ]h"]h$]h&]uh1jghjubh)}(h**Description**h]jR)}(hjAh]h Description}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1jQhj?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.}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chKhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jGhhhhhNhNubh)}(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 hjhhhjhMubjC)}(hbh_end_async_writeh]jI)}(hbh_end_async_writeh]hbh_end_async_write}(hjhhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhjubah}(h]h ](j\j]eh"]h$]h&]jajbuh1jBhjhhhjhMubjd)}(h(struct bio *bio)h]jj)}(hstruct bio *bioh](jp)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johjubj!)}(h h]h }(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjubh)}(hhh]jI)}(hbioh]hbio}(hjhhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhjubah}(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 hjubj2)}(hj5h]h*}(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hbioh]hbio}(hjhhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphjajbuh1jihjubah}(h]h ]h"]h$]h&]jajbuh1jchjhhhjhMubeh}(h]h ]h"]h$]h&]jajbjuh1jjjhj~hhhjhMubah}(h]jyah ](jjeh"]h$]h&]jj)jhuh1jhjhMhj{hhubj!)}(hhh]h)}(h&I/O end handler for async folio writesh]h&I/O end handler for async folio writes}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhjChhubah}(h]h ]h"]h$]h&]uh1j hj{hhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jAjjBj^jCj^jDjEjFuh1hhhhhhNhNubjH)}(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]jR)}(hjhh]h Parameters}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1jQhjfubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhjbubjh)}(hhh]jm)}(h-``struct bio *bio`` The bio being completed. h](js)}(h``struct bio *bio``h]jy)}(hjh]hstruct bio *bio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jxhjubah}(h]h ]h"]h$]h&]uh1jrhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhjubj)}(hhh]h)}(hThe bio being completed.h]hThe bio being completed.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jlhjhMhj~ubah}(h]h ]h"]h$]h&]uh1jghjbubh)}(h**Description**h]jR)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jQhjubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhjbubh)}(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.chMhjbubeh}(h]h ] kernelindentah"]h$]h&]uh1jGhhhhhNhNubh)}(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 hjhhhjhMubjC)}(hmmb_synch]jI)}(hmmb_synch]hmmb_sync}(hj(hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj$ubah}(h]h ](j\j]eh"]h$]h&]jajbuh1jBhjhhhjhMubjd)}(h"(struct mapping_metadata_bhs *mmb)h]jj)}(h struct mapping_metadata_bhs *mmbh](jp)}(hjh]hstruct}(hjDhhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johj@ubj!)}(h h]h }(hjQhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj@ubh)}(hhh]jI)}(hmapping_metadata_bhsh]hmapping_metadata_bhs}(hjbhhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj_ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjdmodnameN classnameNjj)}j]j)}jj*sb c.mmb_syncasbuh1hhj@ubj!)}(h h]h }(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj@ubj2)}(hj5h]h*}(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj@ubjI)}(hmmbh]hmmb}(hjhhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj@ubeh}(h]h ]h"]h$]h&]noemphjajbuh1jihj<ubah}(h]h ]h"]h$]h&]jajbuh1jchjhhhjhMubeh}(h]h ]h"]h$]h&]jajbjuh1jjjhjhhhjhMubah}(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&]uh1j hjhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jAjjBjjCjjDjEjFuh1hhhhhhNhNubjH)}(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. mmb_mark_buffer_dirty() doesn't touch b_assoc_buffers list if b_mmb is set 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]jR)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jQhjubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhjubjh)}(hhh]jm)}(hB``struct mapping_metadata_bhs *mmb`` the list of buffers to write h](js)}(h$``struct mapping_metadata_bhs *mmb``h]jy)}(hjh]h struct mapping_metadata_bhs *mmb}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jxhjubah}(h]h ]h"]h$]h&]uh1jrhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhjubj)}(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&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jlhjhMhjubah}(h]h ]h"]h$]h&]uh1jghjubh)}(h**Description**h]jR)}(hjCh]h Description}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jQhjAubah}(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(). }(hjYhhhNhNubjR)}(h**mmb**h]hmmb}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1jQhjYubh] is for a file or directory which needs those buffers to be written for a successful fsync().}(hjYhhhNhNubeh}(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.}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhjubh)}(hXUDo 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. mmb_mark_buffer_dirty() doesn't touch b_assoc_buffers list if b_mmb is set so we are sure the buffer stays on our list until IO completes (at which point it can be reaped).h]hXWDo 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. mmb_mark_buffer_dirty() doesn’t touch b_assoc_buffers list if b_mmb is set 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&]uh1jGhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h"mmb_mark_buffer_dirty (C function)c.mmb_mark_buffer_dirtyhNtauh1hhhhhhNhNubh)}(hhh](j)}(hUvoid mmb_mark_buffer_dirty (struct buffer_head *bh, struct mapping_metadata_bhs *mmb)h]j )}(hTvoid mmb_mark_buffer_dirty(struct buffer_head *bh, struct mapping_metadata_bhs *mmb)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMlubj!)}(h h]h }(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjhhhjhMlubjC)}(hmmb_mark_buffer_dirtyh]jI)}(hmmb_mark_buffer_dirtyh]hmmb_mark_buffer_dirty}(hjhhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhjubah}(h]h ](j\j]eh"]h$]h&]jajbuh1jBhjhhhjhMlubjd)}(h:(struct buffer_head *bh, struct mapping_metadata_bhs *mmb)h](jj)}(hstruct buffer_head *bhh](jp)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johjubj!)}(h h]h }(hj hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjubh)}(hhh]jI)}(h buffer_headh]h buffer_head}(hj hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj modnameN classnameNjj)}j]j)}jjsbc.mmb_mark_buffer_dirtyasbuh1hhjubj!)}(h h]h }(hj3 hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjubj2)}(hj5h]h*}(hjA hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hbhh]hbh}(hjN hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphjajbuh1jihjubjj)}(h struct mapping_metadata_bhs *mmbh](jp)}(hjh]hstruct}(hjg hhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johjc ubj!)}(h h]h }(hjt hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjc ubh)}(hhh]jI)}(hmapping_metadata_bhsh]hmapping_metadata_bhs}(hj hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj modnameN classnameNjj)}j]j/ c.mmb_mark_buffer_dirtyasbuh1hhjc ubj!)}(h h]h }(hj hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjc ubj2)}(hj5h]h*}(hj hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjc ubjI)}(hmmbh]hmmb}(hj hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhjc ubeh}(h]h ]h"]h$]h&]noemphjajbuh1jihjubeh}(h]h ]h"]h$]h&]jajbuh1jchjhhhjhMlubeh}(h]h ]h"]h$]h&]jajbjuh1jjjhjhhhjhMlubah}(h]jah ](jjeh"]h$]h&]jj)jhuh1jhjhMlhjhhubj!)}(hhh]h)}(hMark a metadata buffer dirty.h]hMark a metadata buffer dirty.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMlhj hhubah}(h]h ]h"]h$]h&]uh1j hjhhhjhMlubeh}(h]h ](jfunctioneh"]h$]h&]jAjjBj!jCj!jDjEjFuh1hhhhhhNhNubjH)}(h**Parameters** ``struct buffer_head *bh`` The buffer to mark dirty. ``struct mapping_metadata_bhs *mmb`` The list of buffers to add the buffer to. **Description** Mark the buffer dirty and add it to the list if it is not already on a list.h](h)}(h**Parameters**h]jR)}(hj !h]h Parameters}(hj !hhhNhNubah}(h]h ]h"]h$]h&]uh1jQhj!ubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMphj!ubjh)}(hhh](jm)}(h5``struct buffer_head *bh`` The buffer to mark dirty. h](js)}(h``struct buffer_head *bh``h]jy)}(hj)!h]hstruct buffer_head *bh}(hj+!hhhNhNubah}(h]h ]h"]h$]h&]uh1jxhj'!ubah}(h]h ]h"]h$]h&]uh1jrhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMmhj#!ubj)}(hhh]h)}(hThe buffer to mark dirty.h]hThe buffer to mark dirty.}(hjB!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj>!hMmhj?!ubah}(h]h ]h"]h$]h&]uh1jhj#!ubeh}(h]h ]h"]h$]h&]uh1jlhj>!hMmhj !ubjm)}(hO``struct mapping_metadata_bhs *mmb`` The list of buffers to add the buffer to. h](js)}(h$``struct mapping_metadata_bhs *mmb``h]jy)}(hjb!h]h struct mapping_metadata_bhs *mmb}(hjd!hhhNhNubah}(h]h ]h"]h$]h&]uh1jxhj`!ubah}(h]h ]h"]h$]h&]uh1jrhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMnhj\!ubj)}(hhh]h)}(h)The list of buffers to add the buffer to.h]h)The list of buffers to add the buffer to.}(hj{!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjw!hMnhjx!ubah}(h]h ]h"]h$]h&]uh1jhj\!ubeh}(h]h ]h"]h$]h&]uh1jlhjw!hMnhj !ubeh}(h]h ]h"]h$]h&]uh1jghj!ubh)}(h**Description**h]jR)}(hj!h]h Description}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jQhj!ubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMphj!ubh)}(hLMark the buffer dirty and add it to the list if it is not already on a list.h]hLMark the buffer dirty and add it to the list if it is not already on a list.}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMohj!ubeh}(h]h ] kernelindentah"]h$]h&]uh1jGhhhhhNhNubh)}(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}(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!hMubjC)}(hblock_dirty_folioh]jI)}(hblock_dirty_folioh]hblock_dirty_folio}(hj"hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj!ubah}(h]h ](j\j]eh"]h$]h&]jajbuh1jBhj!hhhj!hMubjd)}(h4(struct address_space *mapping, struct folio *folio)h](jj)}(hstruct address_space *mappingh](jp)}(hjh]hstruct}(hj"hhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johj"ubj!)}(h h]h }(hj+"hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj"ubh)}(hhh]jI)}(h address_spaceh]h address_space}(hj<"hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj9"ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj>"modnameN classnameNjj)}j]j)}jj"sbc.block_dirty_folioasbuh1hhj"ubj!)}(h h]h }(hj\"hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj"ubj2)}(hj5h]h*}(hjj"hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj"ubjI)}(hmappingh]hmapping}(hjw"hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj"ubeh}(h]h ]h"]h$]h&]noemphjajbuh1jihj"ubjj)}(hstruct folio *folioh](jp)}(hjh]hstruct}(hj"hhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johj"ubj!)}(h h]h }(hj"hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj"ubh)}(hhh]jI)}(hfolioh]hfolio}(hj"hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj"ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj"modnameN classnameNjj)}j]jX"c.block_dirty_folioasbuh1hhj"ubj!)}(h h]h }(hj"hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj"ubj2)}(hj5h]h*}(hj"hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj"ubjI)}(hfolioh]hfolio}(hj"hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj"ubeh}(h]h ]h"]h$]h&]noemphjajbuh1jihj"ubeh}(h]h ]h"]h$]h&]jajbuh1jchj!hhhj!hMubeh}(h]h ]h"]h$]h&]jajbjuh1jjjhj!hhhj!hMubah}(h]j!ah ](jjeh"]h$]h&]jj)jhuh1jhj!hMhj!hhubj!)}(hhh]h)}(hMark a folio as dirty.h]hMark a folio as dirty.}(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&]uh1j hj!hhhj!hMubeh}(h]h ](jfunctioneh"]h$]h&]jAjjBj)#jCj)#jDjEjFuh1hhhhhhNhNubjH)}(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]jR)}(hj3#h]h Parameters}(hj5#hhhNhNubah}(h]h ]h"]h$]h&]uh1jQhj1#ubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhj-#ubjh)}(hhh](jm)}(hK``struct address_space *mapping`` The address space containing this folio. h](js)}(h!``struct address_space *mapping``h]jy)}(hjR#h]hstruct address_space *mapping}(hjT#hhhNhNubah}(h]h ]h"]h$]h&]uh1jxhjP#ubah}(h]h ]h"]h$]h&]uh1jrhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhjL#ubj)}(hhh]h)}(h(The address space containing this folio.h]h(The address space containing this folio.}(hjk#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjg#hMhjh#ubah}(h]h ]h"]h$]h&]uh1jhjL#ubeh}(h]h ]h"]h$]h&]uh1jlhjg#hMhjI#ubjm)}(h1``struct folio *folio`` The folio to mark dirty. h](js)}(h``struct folio *folio``h]jy)}(hj#h]hstruct folio *folio}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jxhj#ubah}(h]h ]h"]h$]h&]uh1jrhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhj#ubj)}(hhh]h)}(hThe folio to mark dirty.h]hThe folio to mark dirty.}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj#hMhj#ubah}(h]h ]h"]h$]h&]uh1jhj#ubeh}(h]h ]h"]h$]h&]uh1jlhj#hMhjI#ubeh}(h]h ]h"]h$]h&]uh1jghj-#ubh)}(h**Description**h]jR)}(hj#h]h Description}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jQhj#ubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhj-#ubh)}(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.}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhj-#ubh)}(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.}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhj-#ubh)}(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.}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhj-#ubh)}(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.}(hj $hhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhj-#ubh)}(h **Context**h]jR)}(hj$h]hContext}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jQhj$ubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhj-#ubh)}(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 }(hj0$hhhNhNubjR)}(h **folio**h]hfolio}(hj8$hhhNhNubah}(h]h ]h"]h$]h&]uh1jQhj0$ubh 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.}(hj0$hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhj-#ubh)}(h **Return**h]jR)}(hjS$h]hReturn}(hjU$hhhNhNubah}(h]h ]h"]h$]h&]uh1jQhjQ$ubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhj-#ubh)}(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.}(hji$hhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhj-#ubeh}(h]h ] kernelindentah"]h$]h&]uh1jGhhhhhNhNubh)}(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}(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$hMubjC)}(hmark_buffer_dirtyh]jI)}(hmark_buffer_dirtyh]hmark_buffer_dirty}(hj$hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj$ubah}(h]h ](j\j]eh"]h$]h&]jajbuh1jBhj$hhhj$hMubjd)}(h(struct buffer_head *bh)h]jj)}(hstruct buffer_head *bhh](jp)}(hjh]hstruct}(hj$hhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johj$ubj!)}(h h]h }(hj$hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj$ubh)}(hhh]jI)}(h buffer_headh]h buffer_head}(hj$hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj$ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj$modnameN classnameNjj)}j]j)}jj$sbc.mark_buffer_dirtyasbuh1hhj$ubj!)}(h h]h }(hj%hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj$ubj2)}(hj5h]h*}(hj!%hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj$ubjI)}(hbhh]hbh}(hj.%hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj$ubeh}(h]h ]h"]h$]h&]noemphjajbuh1jihj$ubah}(h]h ]h"]h$]h&]jajbuh1jchj$hhhj$hMubeh}(h]h ]h"]h$]h&]jajbjuh1jjjhj$hhhj$hMubah}(h]j$ah ](jjeh"]h$]h&]jj)jhuh1jhj$hMhj$hhubj!)}(hhh]h)}(h&mark a buffer_head as needing writeouth]h&mark a buffer_head as needing writeout}(hjX%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhjU%hhubah}(h]h ]h"]h$]h&]uh1j hj$hhhj$hMubeh}(h]h ](jfunctioneh"]h$]h&]jAjjBjp%jCjp%jDjEjFuh1hhhhhhNhNubjH)}(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 folio dirty, then tag the folio 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]jR)}(hjz%h]h Parameters}(hj|%hhhNhNubah}(h]h ]h"]h$]h&]uh1jQhjx%ubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhjt%ubjh)}(hhh]jm)}(h9``struct buffer_head *bh`` the buffer_head to mark dirty h](js)}(h``struct buffer_head *bh``h]jy)}(hj%h]hstruct buffer_head *bh}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jxhj%ubah}(h]h ]h"]h$]h&]uh1jrhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhj%ubj)}(hhh]h)}(hthe buffer_head to mark dirtyh]hthe buffer_head to mark dirty}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj%hMhj%ubah}(h]h ]h"]h$]h&]uh1jhj%ubeh}(h]h ]h"]h$]h&]uh1jlhj%hMhj%ubah}(h]h ]h"]h$]h&]uh1jghjt%ubh)}(h**Description**h]jR)}(hj%h]h Description}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jQhj%ubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhjt%ubh)}(hmark_buffer_dirty() will set the dirty bit against the buffer, then set its backing folio dirty, then tag the folio 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 folio dirty, then tag the folio as dirty in the page cache and then attach the address_space’s inode to its superblock’s dirty inode list.}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhjt%ubh)}(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.}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhjt%ubeh}(h]h ] kernelindentah"]h$]h&]uh1jGhhhhhNhNubh)}(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}(hj(&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$&hhhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMubj!)}(h h]h }(hj7&hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj$&hhhj6&hMubjC)}(h__brelseh]jI)}(h__brelseh]h__brelse}(hjI&hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhjE&ubah}(h]h ](j\j]eh"]h$]h&]jajbuh1jBhj$&hhhj6&hMubjd)}(h(struct buffer_head *bh)h]jj)}(hstruct buffer_head *bhh](jp)}(hjh]hstruct}(hje&hhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johja&ubj!)}(h h]h }(hjr&hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hja&ubh)}(hhh]jI)}(h buffer_headh]h buffer_head}(hj&hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj&ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj&modnameN classnameNjj)}j]j)}jjK&sb c.__brelseasbuh1hhja&ubj!)}(h h]h }(hj&hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hja&ubj2)}(hj5h]h*}(hj&hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hja&ubjI)}(hbhh]hbh}(hj&hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhja&ubeh}(h]h ]h"]h$]h&]noemphjajbuh1jihj]&ubah}(h]h ]h"]h$]h&]jajbuh1jchj$&hhhj6&hMubeh}(h]h ]h"]h$]h&]jajbjuh1jjjhj &hhhj6&hMubah}(h]j&ah ](jjeh"]h$]h&]jj)jhuh1jhj6&hMhj&hhubj!)}(hhh]h)}(hRelease a buffer.h]hRelease a buffer.}(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&]uh1j hj&hhhj6&hMubeh}(h]h ](jfunctioneh"]h$]h&]jAjjBj'jCj'jDjEjFuh1hhhhhhNhNubjH)}(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]jR)}(hj 'h]h Parameters}(hj 'hhhNhNubah}(h]h ]h"]h$]h&]uh1jQhj'ubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhj'ubjh)}(hhh]jm)}(h2``struct buffer_head *bh`` The buffer to release. h](js)}(h``struct buffer_head *bh``h]jy)}(hj)'h]hstruct buffer_head *bh}(hj+'hhhNhNubah}(h]h ]h"]h$]h&]uh1jxhj''ubah}(h]h ]h"]h$]h&]uh1jrhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhj#'ubj)}(hhh]h)}(hThe buffer to release.h]hThe buffer to release.}(hjB'hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj>'hMhj?'ubah}(h]h ]h"]h$]h&]uh1jhj#'ubeh}(h]h ]h"]h$]h&]uh1jlhj>'hMhj 'ubah}(h]h ]h"]h$]h&]uh1jghj'ubh)}(h**Description**h]jR)}(hjd'h]h Description}(hjf'hhhNhNubah}(h]h ]h"]h$]h&]uh1jQhjb'ubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhj'ubh)}(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 }(hjz'hhhNhNubjR)}(h**bh**h]hbh}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jQhjz'ubh is guaranteed to not be NULL.}(hjz'hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhj'ubeh}(h]h ] kernelindentah"]h$]h&]uh1jGhhhhhNhNubh)}(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}(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'hMubjC)}(h __bforgeth]jI)}(h __bforgeth]h __bforget}(hj'hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj'ubah}(h]h ](j\j]eh"]h$]h&]jajbuh1jBhj'hhhj'hMubjd)}(h(struct buffer_head *bh)h]jj)}(hstruct buffer_head *bhh](jp)}(hjh]hstruct}(hj'hhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johj'ubj!)}(h h]h }(hj(hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj'ubh)}(hhh]jI)}(h buffer_headh]h buffer_head}(hj(hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj(ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj(modnameN classnameNjj)}j]j)}jj'sb c.__bforgetasbuh1hhj'ubj!)}(h h]h }(hj6(hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj'ubj2)}(hj5h]h*}(hjD(hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj'ubjI)}(hbhh]hbh}(hjQ(hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj'ubeh}(h]h ]h"]h$]h&]noemphjajbuh1jihj'ubah}(h]h ]h"]h$]h&]jajbuh1jchj'hhhj'hMubeh}(h]h ]h"]h$]h&]jajbjuh1jjjhj'hhhj'hMubah}(h]j'ah ](jjeh"]h$]h&]jj)jhuh1jhj'hMhj'hhubj!)}(hhh]h)}(h#Discard any dirty data in a buffer.h]h#Discard any dirty data in a buffer.}(hj{(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhjx(hhubah}(h]h ]h"]h$]h&]uh1j hj'hhhj'hMubeh}(h]h ](jfunctioneh"]h$]h&]jAjjBj(jCj(jDjEjFuh1hhhhhhNhNubjH)}(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]jR)}(hj(h]h Parameters}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jQhj(ubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM"hj(ubjh)}(hhh]jm)}(h1``struct buffer_head *bh`` The buffer to forget. h](js)}(h``struct buffer_head *bh``h]jy)}(hj(h]hstruct buffer_head *bh}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jxhj(ubah}(h]h ]h"]h$]h&]uh1jrhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhj(ubj)}(hhh]h)}(hThe buffer to forget.h]hThe buffer to forget.}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj(hMhj(ubah}(h]h ]h"]h$]h&]uh1jhj(ubeh}(h]h ]h"]h$]h&]uh1jlhj(hMhj(ubah}(h]h ]h"]h$]h&]uh1jghj(ubh)}(h**Description**h]jR)}(hj(h]h Description}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jQhj(ubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM!hj(ubh)}(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 }(hj )hhhNhNubjR)}(h**bh**h]hbh}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1jQhj )ubh is guaranteed to not be NULL.}(hj )hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM hj(ubeh}(h]h ] kernelindentah"]h$]h&]uh1jGhhhhhNhNubh)}(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}(hjN)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJ)hhhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMtubj!)}(h h]h }(hj])hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjJ)hhhj\)hMtubjC)}(h bh_submith]jI)}(h bh_submith]h bh_submit}(hjo)hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhjk)ubah}(h]h ](j\j]eh"]h$]h&]jajbuh1jBhjJ)hhhj\)hMtubjd)}(h<(struct buffer_head *bh, blk_opf_t opf, bio_end_io_t end_io)h](jj)}(hstruct buffer_head *bhh](jp)}(hjh]hstruct}(hj)hhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johj)ubj!)}(h h]h }(hj)hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj)ubh)}(hhh]jI)}(h buffer_headh]h buffer_head}(hj)hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj)ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj)modnameN classnameNjj)}j]j)}jjq)sb c.bh_submitasbuh1hhj)ubj!)}(h h]h }(hj)hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj)ubj2)}(hj5h]h*}(hj)hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj)ubjI)}(hbhh]hbh}(hj)hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj)ubeh}(h]h ]h"]h$]h&]noemphjajbuh1jihj)ubjj)}(h blk_opf_t opfh](h)}(hhh]jI)}(h blk_opf_th]h blk_opf_t}(hj*hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj)ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj*modnameN classnameNjj)}j]j) c.bh_submitasbuh1hhj)ubj!)}(h h]h }(hj*hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj)ubjI)}(hopfh]hopf}(hj,*hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj)ubeh}(h]h ]h"]h$]h&]noemphjajbuh1jihj)ubjj)}(hbio_end_io_t end_ioh](h)}(hhh]jI)}(h bio_end_io_th]h bio_end_io_t}(hjH*hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhjE*ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjJ*modnameN classnameNjj)}j]j) c.bh_submitasbuh1hhjA*ubj!)}(h h]h }(hjf*hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjA*ubjI)}(hend_ioh]hend_io}(hjt*hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhjA*ubeh}(h]h ]h"]h$]h&]noemphjajbuh1jihj)ubeh}(h]h ]h"]h$]h&]jajbuh1jchjJ)hhhj\)hMtubeh}(h]h ]h"]h$]h&]jajbjuh1jjjhjF)hhhj\)hMtubah}(h]jA)ah ](jjeh"]h$]h&]jj)jhuh1jhj\)hMthjC)hhubj!)}(hhh]h)}(hStart I/O against a buffer headh]hStart I/O against a buffer head}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMthj*hhubah}(h]h ]h"]h$]h&]uh1j hjC)hhhj\)hMtubeh}(h]h ](jfunctioneh"]h$]h&]jAjjBj*jCj*jDjEjFuh1hhhhhhNhNubjH)}(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]jR)}(hj*h]h Parameters}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1jQhj*ubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMxhj*ubjh)}(hhh](jm)}(h>``struct buffer_head *bh`` The buffer head to perform I/O on. h](js)}(h``struct buffer_head *bh``h]jy)}(hj*h]hstruct buffer_head *bh}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1jxhj*ubah}(h]h ]h"]h$]h&]uh1jrhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMuhj*ubj)}(hhh]h)}(h"The buffer head to perform I/O on.h]h"The buffer head to perform I/O on.}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj*hMuhj*ubah}(h]h ]h"]h$]h&]uh1jhj*ubeh}(h]h ]h"]h$]h&]uh1jlhj*hMuhj*ubjm)}(h/``blk_opf_t opf`` Operation and flags for bio. h](js)}(h``blk_opf_t opf``h]jy)}(hj+h]h blk_opf_t opf}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1jxhj+ubah}(h]h ]h"]h$]h&]uh1jrhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMvhj+ubj)}(hhh]h)}(hOperation and flags for bio.h]hOperation and flags for bio.}(hj1+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj-+hMvhj.+ubah}(h]h ]h"]h$]h&]uh1jhj+ubeh}(h]h ]h"]h$]h&]uh1jlhj-+hMvhj*ubjm)}(hD``bio_end_io_t end_io`` The routine to call when I/O has completed. h](js)}(h``bio_end_io_t end_io``h]jy)}(hjQ+h]hbio_end_io_t end_io}(hjS+hhhNhNubah}(h]h ]h"]h$]h&]uh1jxhjO+ubah}(h]h ]h"]h$]h&]uh1jrhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMwhjK+ubj)}(hhh]h)}(h+The routine to call when I/O has completed.h]h+The routine to call when I/O has completed.}(hjj+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjf+hMwhjg+ubah}(h]h ]h"]h$]h&]uh1jhjK+ubeh}(h]h ]h"]h$]h&]uh1jlhjf+hMwhj*ubeh}(h]h ]h"]h$]h&]uh1jghj*ubh)}(h**Description**h]jR)}(hj+h]h Description}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1jQhj+ubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMyhj*ubh)}(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.}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMxhj*ubeh}(h]h ] kernelindentah"]h$]h&]uh1jGhhhhhNhNubh)}(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](jp)}(hjh]hstruct}(hj+hhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johj+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+ubh)}(hhh]jI)}(h buffer_headh]h buffer_head}(hj+hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj+ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj+modnameN classnameNjj)}j]j)}j bdev_getblksb c.bdev_getblkasbuh1hhj+hhhj+hM+ubj!)}(h h]h }(hj,hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj+hhhj+hM+ubj2)}(hj5h]h*}(hj,hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj+hhhj+hM+ubjC)}(h bdev_getblkh]jI)}(hj,h]h bdev_getblk}(hj0,hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj,,ubah}(h]h ](j\j]eh"]h$]h&]jajbuh1jBhj+hhhj+hM+ubjd)}(hE(struct block_device *bdev, sector_t block, unsigned size, gfp_t gfp)h](jj)}(hstruct block_device *bdevh](jp)}(hjh]hstruct}(hjK,hhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johjG,ubj!)}(h h]h }(hjX,hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjG,ubh)}(hhh]jI)}(h block_deviceh]h block_device}(hji,hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhjf,ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjk,modnameN classnameNjj)}j]j , c.bdev_getblkasbuh1hhjG,ubj!)}(h h]h }(hj,hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjG,ubj2)}(hj5h]h*}(hj,hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjG,ubjI)}(hbdevh]hbdev}(hj,hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhjG,ubeh}(h]h ]h"]h$]h&]noemphjajbuh1jihjC,ubjj)}(hsector_t blockh](h)}(hhh]jI)}(hsector_th]hsector_t}(hj,hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj,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,ubjI)}(hblockh]hblock}(hj,hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj,ubeh}(h]h ]h"]h$]h&]noemphjajbuh1jihjC,ubjj)}(h unsigned sizeh](j)}(hunsignedh]hunsigned}(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,ubj!)}(h h]h }(hj-hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj,ubjI)}(hsizeh]hsize}(hj-hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj,ubeh}(h]h ]h"]h$]h&]noemphjajbuh1jihjC,ubjj)}(h gfp_t gfph](h)}(hhh]jI)}(hgfp_th]hgfp_t}(hj;-hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj8-ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj=-modnameN classnameNjj)}j]j , c.bdev_getblkasbuh1hhj4-ubj!)}(h h]h }(hjY-hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj4-ubjI)}(hgfph]hgfp}(hjg-hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj4-ubeh}(h]h ]h"]h$]h&]noemphjajbuh1jihjC,ubeh}(h]h ]h"]h$]h&]jajbuh1jchj+hhhj+hM+ubeh}(h]h ]h"]h$]h&]jajbjuh1jjjhj+hhhj+hM+ubah}(h]j+ah ](jjeh"]h$]h&]jj)jhuh1jhj+hM+hj+hhubj!)}(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.}(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&]uh1j hj+hhhj+hM+ubeh}(h]h ](jfunctioneh"]h$]h&]jAjjBj-jCj-jDjEjFuh1hhhhhhNhNubjH)}(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]jR)}(hj-h]h Parameters}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1jQhj-ubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM/hj-ubjh)}(hhh](jm)}(h0``struct block_device *bdev`` The block device. h](js)}(h``struct block_device *bdev``h]jy)}(hj-h]hstruct block_device *bdev}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1jxhj-ubah}(h]h ]h"]h$]h&]uh1jrhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM,hj-ubj)}(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&]uh1jhj-ubeh}(h]h ]h"]h$]h&]uh1jlhj-hM,hj-ubjm)}(h%``sector_t block`` The block number. h](js)}(h``sector_t block``h]jy)}(hj .h]hsector_t block}(hj .hhhNhNubah}(h]h ]h"]h$]h&]uh1jxhj .ubah}(h]h ]h"]h$]h&]uh1jrhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM-hj.ubj)}(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&]uh1jhj.ubeh}(h]h ]h"]h$]h&]uh1jlhj .hM-hj-ubjm)}(h>``unsigned size`` The size of buffer_heads for this **bdev**. h](js)}(h``unsigned size``h]jy)}(hjD.h]h unsigned size}(hjF.hhhNhNubah}(h]h ]h"]h$]h&]uh1jxhjB.ubah}(h]h ]h"]h$]h&]uh1jrhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM.hj>.ubj)}(hhh]h)}(h+The size of buffer_heads for this **bdev**.h](h"The size of buffer_heads for this }(hj].hhhNhNubjR)}(h**bdev**h]hbdev}(hje.hhhNhNubah}(h]h ]h"]h$]h&]uh1jQhj].ubh.}(hj].hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjY.hM.hjZ.ubah}(h]h ]h"]h$]h&]uh1jhj>.ubeh}(h]h ]h"]h$]h&]uh1jlhjY.hM.hj-ubjm)}(h2``gfp_t gfp`` The memory allocation flags to use. h](js)}(h ``gfp_t gfp``h]jy)}(hj.h]h gfp_t gfp}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jxhj.ubah}(h]h ]h"]h$]h&]uh1jrhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM/hj.ubj)}(hhh]h)}(h#The memory allocation flags to use.h]h#The memory allocation flags to use.}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj.hM/hj.ubah}(h]h ]h"]h$]h&]uh1jhj.ubeh}(h]h ]h"]h$]h&]uh1jlhj.hM/hj-ubeh}(h]h ]h"]h$]h&]uh1jghj-ubh)}(h**Description**h]jR)}(hj.h]h Description}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jQhj.ubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM1hj-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.chM0hj-ubh)}(h **Return**h]jR)}(hj.h]hReturn}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jQhj.ubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM5hj-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.chM6hj-ubeh}(h]h ] kernelindentah"]h$]h&]uh1jGhhhhhNhNubh)}(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](jp)}(hjh]hstruct}(hj6/hhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johj2/hhhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMZubj!)}(h h]h }(hjD/hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj2/hhhjC/hMZubh)}(hhh]jI)}(h buffer_headh]h buffer_head}(hjU/hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhjR/ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjW/modnameN classnameNjj)}j]j)}j __bread_gfpsb c.__bread_gfpasbuh1hhj2/hhhjC/hMZubj!)}(h h]h }(hjv/hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj2/hhhjC/hMZubj2)}(hj5h]h*}(hj/hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj2/hhhjC/hMZubjC)}(h __bread_gfph]jI)}(hjs/h]h __bread_gfp}(hj/hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj/ubah}(h]h ](j\j]eh"]h$]h&]jajbuh1jBhj2/hhhjC/hMZubjd)}(hE(struct block_device *bdev, sector_t block, unsigned size, gfp_t gfp)h](jj)}(hstruct block_device *bdevh](jp)}(hjh]hstruct}(hj/hhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johj/ubj!)}(h h]h }(hj/hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj/ubh)}(hhh]jI)}(h block_deviceh]h block_device}(hj/hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj/ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj/modnameN classnameNjj)}j]jq/ c.__bread_gfpasbuh1hhj/ubj!)}(h h]h }(hj/hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj/ubj2)}(hj5h]h*}(hj/hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj/ubjI)}(hbdevh]hbdev}(hj0hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj/ubeh}(h]h ]h"]h$]h&]noemphjajbuh1jihj/ubjj)}(hsector_t blockh](h)}(hhh]jI)}(hsector_th]hsector_t}(hj#0hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj 0ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj%0modnameN classnameNjj)}j]jq/ c.__bread_gfpasbuh1hhj0ubj!)}(h h]h }(hjA0hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj0ubjI)}(hblockh]hblock}(hjO0hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj0ubeh}(h]h ]h"]h$]h&]noemphjajbuh1jihj/ubjj)}(h unsigned sizeh](j)}(hunsignedh]hunsigned}(hjh0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjd0ubj!)}(h h]h }(hjv0hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjd0ubjI)}(hsizeh]hsize}(hj0hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhjd0ubeh}(h]h ]h"]h$]h&]noemphjajbuh1jihj/ubjj)}(h gfp_t gfph](h)}(hhh]jI)}(hgfp_th]hgfp_t}(hj0hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj0ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj0modnameN classnameNjj)}j]jq/ c.__bread_gfpasbuh1hhj0ubj!)}(h h]h }(hj0hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj0ubjI)}(hgfph]hgfp}(hj0hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj0ubeh}(h]h ]h"]h$]h&]noemphjajbuh1jihj/ubeh}(h]h ]h"]h$]h&]jajbuh1jchj2/hhhjC/hMZubeh}(h]h ]h"]h$]h&]jajbjuh1jjjhj./hhhjC/hMZubah}(h]j)/ah ](jjeh"]h$]h&]jj)jhuh1jhjC/hMZhj+/hhubj!)}(hhh]h)}(h Read a block.h]h Read a block.}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMZhj0hhubah}(h]h ]h"]h$]h&]uh1j hj+/hhhjC/hMZubeh}(h]h ](jfunctioneh"]h$]h&]jAjjBj1jCj1jDjEjFuh1hhhhhhNhNubjH)}(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]jR)}(hj1h]h Parameters}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jQhj1ubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM^hj1ubjh)}(hhh](jm)}(h=``struct block_device *bdev`` The block device to read from. h](js)}(h``struct block_device *bdev``h]jy)}(hj71h]hstruct block_device *bdev}(hj91hhhNhNubah}(h]h ]h"]h$]h&]uh1jxhj51ubah}(h]h ]h"]h$]h&]uh1jrhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM[hj11ubj)}(hhh]h)}(hThe block device to read from.h]hThe block device to read from.}(hjP1hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjL1hM[hjM1ubah}(h]h ]h"]h$]h&]uh1jhj11ubeh}(h]h ]h"]h$]h&]uh1jlhjL1hM[hj.1ubjm)}(h8``sector_t block`` Block number in units of block size. h](js)}(h``sector_t block``h]jy)}(hjp1h]hsector_t block}(hjr1hhhNhNubah}(h]h ]h"]h$]h&]uh1jxhjn1ubah}(h]h ]h"]h$]h&]uh1jrhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM\hjj1ubj)}(hhh]h)}(h$Block number in units of block size.h]h$Block number in units of block size.}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj1hM\hj1ubah}(h]h ]h"]h$]h&]uh1jhjj1ubeh}(h]h ]h"]h$]h&]uh1jlhj1hM\hj.1ubjm)}(h:``unsigned size`` The block size of this device in bytes. h](js)}(h``unsigned size``h]jy)}(hj1h]h unsigned size}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jxhj1ubah}(h]h ]h"]h$]h&]uh1jrhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM]hj1ubj)}(hhh]h)}(h'The block size of this device in bytes.h]h'The block size of this device in bytes.}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj1hM]hj1ubah}(h]h ]h"]h$]h&]uh1jhj1ubeh}(h]h ]h"]h$]h&]uh1jlhj1hM]hj.1ubjm)}(h4``gfp_t gfp`` Not page allocation flags; see below. h](js)}(h ``gfp_t gfp``h]jy)}(hj1h]h gfp_t gfp}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jxhj1ubah}(h]h ]h"]h$]h&]uh1jrhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM^hj1ubj)}(hhh]h)}(h%Not page allocation flags; see below.h]h%Not page allocation flags; see below.}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj1hM^hj1ubah}(h]h ]h"]h$]h&]uh1jhj1ubeh}(h]h ]h"]h$]h&]uh1jlhj1hM^hj.1ubeh}(h]h ]h"]h$]h&]uh1jghj1ubh)}(h**Description**h]jR)}(hj2h]h Description}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jQhj2ubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM`hj1ubh)}(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().}(hj32hhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM_hj1ubh)}(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 }(hjB2hhhNhNubjR)}(h**gfp**h]hgfp}(hjJ2hhhNhNubah}(h]h ]h"]h$]h&]uh1jQhjB2ubhV is 0, the memory will be allocated using the block device’s default GFP flags. If }(hjB2hhhNhNubjR)}(h**gfp**h]hgfp}(hj\2hhhNhNubah}(h]h ]h"]h$]h&]uh1jQhjB2ubhp is __GFP_MOVABLE, the memory may be allocated from a movable area. Do not pass in a complete set of GFP flags.}(hjB2hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMbhj1ubh)}(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.}(hju2hhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhhj1ubh)}(h **Context**h]jR)}(hj2h]hContext}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jQhj2ubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMkhj1ubh)}(hMay sleep waiting for I/O.h]hMay sleep waiting for I/O.}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMlhj1ubh)}(h **Return**h]jR)}(hj2h]hReturn}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jQhj2ubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMnhj1ubh)}(h!NULL if the block was unreadable.h]h!NULL if the block was unreadable.}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMmhj1ubeh}(h]h ] kernelindentah"]h$]h&]uh1jGhhhhhNhNubh)}(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}(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2hhhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMubj!)}(h h]h }(hj3hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj2hhhj3hMubjC)}(hblock_invalidate_folioh]jI)}(hblock_invalidate_folioh]hblock_invalidate_folio}(hj3hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj3ubah}(h]h ](j\j]eh"]h$]h&]jajbuh1jBhj2hhhj3hMubjd)}(h3(struct folio *folio, size_t offset, size_t length)h](jj)}(hstruct folio *folioh](jp)}(hjh]hstruct}(hj/3hhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johj+3ubj!)}(h h]h }(hj<3hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj+3ubh)}(hhh]jI)}(hfolioh]hfolio}(hjM3hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhjJ3ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjO3modnameN classnameNjj)}j]j)}jj3sbc.block_invalidate_folioasbuh1hhj+3ubj!)}(h h]h }(hjm3hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj+3ubj2)}(hj5h]h*}(hj{3hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj+3ubjI)}(hfolioh]hfolio}(hj3hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj+3ubeh}(h]h ]h"]h$]h&]noemphjajbuh1jihj'3ubjj)}(h size_t offseth](h)}(hhh]jI)}(hsize_th]hsize_t}(hj3hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj3ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj3modnameN classnameNjj)}j]ji3c.block_invalidate_folioasbuh1hhj3ubj!)}(h h]h }(hj3hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj3ubjI)}(hoffseth]hoffset}(hj3hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj3ubeh}(h]h ]h"]h$]h&]noemphjajbuh1jihj'3ubjj)}(h size_t lengthh](h)}(hhh]jI)}(hsize_th]hsize_t}(hj3hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj3ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj3modnameN classnameNjj)}j]ji3c.block_invalidate_folioasbuh1hhj3ubj!)}(h h]h }(hj 4hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj3ubjI)}(hlengthh]hlength}(hj4hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj3ubeh}(h]h ]h"]h$]h&]noemphjajbuh1jihj'3ubeh}(h]h ]h"]h$]h&]jajbuh1jchj2hhhj3hMubeh}(h]h ]h"]h$]h&]jajbjuh1jjjhj2hhhj3hMubah}(h]j2ah ](jjeh"]h$]h&]jj)jhuh1jhj3hMhj2hhubj!)}(hhh]h)}(h0Invalidate part or all of a buffer-backed folio.h]h0Invalidate part or all of a buffer-backed folio.}(hjB4hhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhj?4hhubah}(h]h ]h"]h$]h&]uh1j hj2hhhj3hMubeh}(h]h ](jfunctioneh"]h$]h&]jAjjBjZ4jCjZ4jDjEjFuh1hhhhhhNhNubjH)}(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]jR)}(hjd4h]h Parameters}(hjf4hhhNhNubah}(h]h ]h"]h$]h&]uh1jQhjb4ubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhj^4ubjh)}(hhh](jm)}(h5``struct folio *folio`` The folio which is affected. h](js)}(h``struct folio *folio``h]jy)}(hj4h]hstruct folio *folio}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jxhj4ubah}(h]h ]h"]h$]h&]uh1jrhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhj}4ubj)}(hhh]h)}(hThe folio which is affected.h]hThe folio which is affected.}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj4hMhj4ubah}(h]h ]h"]h$]h&]uh1jhj}4ubeh}(h]h ]h"]h$]h&]uh1jlhj4hMhjz4ubjm)}(h3``size_t offset`` start of the range to invalidate h](js)}(h``size_t offset``h]jy)}(hj4h]h size_t offset}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jxhj4ubah}(h]h ]h"]h$]h&]uh1jrhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhj4ubj)}(hhh]h)}(h start of the range to invalidateh]h start of the range to invalidate}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj4hMhj4ubah}(h]h ]h"]h$]h&]uh1jhj4ubeh}(h]h ]h"]h$]h&]uh1jlhj4hMhjz4ubjm)}(h4``size_t length`` length of the range to invalidate h](js)}(h``size_t length``h]jy)}(hj4h]h size_t length}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jxhj4ubah}(h]h ]h"]h$]h&]uh1jrhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhj4ubj)}(hhh]h)}(h!length of the range to invalidateh]h!length of the range to invalidate}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj 5hMhj 5ubah}(h]h ]h"]h$]h&]uh1jhj4ubeh}(h]h ]h"]h$]h&]uh1jlhj 5hMhjz4ubeh}(h]h ]h"]h$]h&]uh1jghj^4ubh)}(h**Description**h]jR)}(hj05h]h Description}(hj25hhhNhNubah}(h]h ]h"]h$]h&]uh1jQhj.5ubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhj^4ubh)}(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.}(hjF5hhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhj^4ubh)}(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 }(hjU5hhhNhNubjR)}(h **offset**h]hoffset}(hj]5hhhNhNubah}(h]h ]h"]h$]h&]uh1jQhjU5ubh 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.}(hjU5hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMhj^4ubeh}(h]h ] kernelindentah"]h$]h&]uh1jGhhhhhNhNubh)}(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}(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5hhhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMGubj!)}(h h]h }(hj5hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj5hhhj5hMGubjC)}(hclean_bdev_aliasesh]jI)}(hclean_bdev_aliasesh]hclean_bdev_aliases}(hj5hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj5ubah}(h]h ](j\j]eh"]h$]h&]jajbuh1jBhj5hhhj5hMGubjd)}(h9(struct block_device *bdev, sector_t block, sector_t len)h](jj)}(hstruct block_device *bdevh](jp)}(hjh]hstruct}(hj5hhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johj5ubj!)}(h h]h }(hj5hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj5ubh)}(hhh]jI)}(h block_deviceh]h block_device}(hj5hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj5ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj5modnameN classnameNjj)}j]j)}jj5sbc.clean_bdev_aliasesasbuh1hhj5ubj!)}(h h]h }(hj6hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj5ubj2)}(hj5h]h*}(hj6hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj5ubjI)}(hbdevh]hbdev}(hj,6hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj5ubeh}(h]h ]h"]h$]h&]noemphjajbuh1jihj5ubjj)}(hsector_t blockh](h)}(hhh]jI)}(hsector_th]hsector_t}(hjH6hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhjE6ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjJ6modnameN classnameNjj)}j]j 6c.clean_bdev_aliasesasbuh1hhjA6ubj!)}(h h]h }(hjf6hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjA6ubjI)}(hblockh]hblock}(hjt6hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhjA6ubeh}(h]h ]h"]h$]h&]noemphjajbuh1jihj5ubjj)}(h sector_t lenh](h)}(hhh]jI)}(hsector_th]hsector_t}(hj6hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj6ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj6modnameN classnameNjj)}j]j 6c.clean_bdev_aliasesasbuh1hhj6ubj!)}(h h]h }(hj6hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj6ubjI)}(hlenh]hlen}(hj6hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj6ubeh}(h]h ]h"]h$]h&]noemphjajbuh1jihj5ubeh}(h]h ]h"]h$]h&]jajbuh1jchj5hhhj5hMGubeh}(h]h ]h"]h$]h&]jajbjuh1jjjhj5hhhj5hMGubah}(h]j5ah ](jjeh"]h$]h&]jj)jhuh1jhj5hMGhj5hhubj!)}(hhh]h)}(h(clean a range of buffers in block deviceh]h(clean a range of buffers in block device}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMGhj6hhubah}(h]h ]h"]h$]h&]uh1j hj5hhhj5hMGubeh}(h]h ](jfunctioneh"]h$]h&]jAjjBj6jCj6jDjEjFuh1hhhhhhNhNubjH)}(hXJ**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. 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]jR)}(hj7h]h Parameters}(hj 7hhhNhNubah}(h]h ]h"]h$]h&]uh1jQhj7ubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMKhj7ubjh)}(hhh](jm)}(h?``struct block_device *bdev`` Block device to clean buffers in h](js)}(h``struct block_device *bdev``h]jy)}(hj'7h]hstruct block_device *bdev}(hj)7hhhNhNubah}(h]h ]h"]h$]h&]uh1jxhj%7ubah}(h]h ]h"]h$]h&]uh1jrhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMHhj!7ubj)}(hhh]h)}(h Block device to clean buffers inh]h Block device to clean buffers in}(hj@7hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj<7hMHhj=7ubah}(h]h ]h"]h$]h&]uh1jhj!7ubeh}(h]h ]h"]h$]h&]uh1jlhj<7hMHhj7ubjm)}(h7``sector_t block`` Start of a range of blocks to clean h](js)}(h``sector_t block``h]jy)}(hj`7h]hsector_t block}(hjb7hhhNhNubah}(h]h ]h"]h$]h&]uh1jxhj^7ubah}(h]h ]h"]h$]h&]uh1jrhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMIhjZ7ubj)}(hhh]h)}(h#Start of a range of blocks to cleanh]h#Start of a range of blocks to clean}(hjy7hhhNhNubah}(h]h ]h"]h$]h&]uh1hhju7hMIhjv7ubah}(h]h ]h"]h$]h&]uh1jhjZ7ubeh}(h]h ]h"]h$]h&]uh1jlhju7hMIhj7ubjm)}(h+``sector_t len`` Number of blocks to clean h](js)}(h``sector_t len``h]jy)}(hj7h]h sector_t len}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1jxhj7ubah}(h]h ]h"]h$]h&]uh1jrhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMJhj7ubj)}(hhh]h)}(hNumber of blocks to cleanh]hNumber of blocks to clean}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj7hMJhj7ubah}(h]h ]h"]h$]h&]uh1jhj7ubeh}(h]h ]h"]h$]h&]uh1jlhj7hMJhj7ubeh}(h]h ]h"]h$]h&]uh1jghj7ubh)}(h**Description**h]jR)}(hj7h]h Description}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1jQhj7ubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMLhj7ubh)}(hXWe 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.h]hXWe 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.}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMKhj7ubh)}(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.}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMRhj7ubeh}(h]h ] kernelindentah"]h$]h&]uh1jGhhhhhNhNubh)}(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(8hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$8hhhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM ubj!)}(h h]h }(hj68hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj$8hhhj58hM ubjC)}(htry_to_free_buffersh]jI)}(htry_to_free_buffersh]htry_to_free_buffers}(hjH8hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhjD8ubah}(h]h ](j\j]eh"]h$]h&]jajbuh1jBhj$8hhhj58hM ubjd)}(h(struct folio *folio)h]jj)}(hstruct folio *folioh](jp)}(hjh]hstruct}(hjd8hhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johj`8ubj!)}(h h]h }(hjq8hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj`8ubh)}(hhh]jI)}(hfolioh]hfolio}(hj8hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj8ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj8modnameN classnameNjj)}j]j)}jjJ8sbc.try_to_free_buffersasbuh1hhj`8ubj!)}(h h]h }(hj8hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj`8ubj2)}(hj5h]h*}(hj8hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj`8ubjI)}(hfolioh]hfolio}(hj8hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj`8ubeh}(h]h ]h"]h$]h&]noemphjajbuh1jihj\8ubah}(h]h ]h"]h$]h&]jajbuh1jchj$8hhhj58hM ubeh}(h]h ]h"]h$]h&]jajbjuh1jjjhj 8hhhj58hM ubah}(h]j8ah ](jjeh"]h$]h&]jj)jhuh1jhj58hM hj8hhubj!)}(hhh]h)}(h'Release buffers attached to this folio.h]h'Release buffers attached to this folio.}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM hj8hhubah}(h]h ]h"]h$]h&]uh1j hj8hhhj58hM ubeh}(h]h ](jfunctioneh"]h$]h&]jAjjBj8jCj8jDjEjFuh1hhhhhhNhNubjH)}(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]jR)}(hj 9h]h Parameters}(hj 9hhhNhNubah}(h]h ]h"]h$]h&]uh1jQhj9ubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM hj9ubjh)}(hhh]jm)}(h#``struct folio *folio`` The folio. h](js)}(h``struct folio *folio``h]jy)}(hj(9h]hstruct folio *folio}(hj*9hhhNhNubah}(h]h ]h"]h$]h&]uh1jxhj&9ubah}(h]h ]h"]h$]h&]uh1jrhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM hj"9ubj)}(hhh]h)}(h The folio.h]h The folio.}(hjA9hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj=9hM hj>9ubah}(h]h ]h"]h$]h&]uh1jhj"9ubeh}(h]h ]h"]h$]h&]uh1jlhj=9hM hj9ubah}(h]h ]h"]h$]h&]uh1jghj9ubh)}(h**Description**h]jR)}(hjc9h]h Description}(hje9hhhNhNubah}(h]h ]h"]h$]h&]uh1jQhja9ubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM hj9ubh)}(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.}(hjy9hhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM hj9ubh)}(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 }(hj9hhhNhNubhemphasis)}(h*all*h]hall}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1j9hj9ubhH buffers dirty. Which would corrupt filesystem data on the same device.}(hj9hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM hj9ubh)}(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.}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM hj9ubh)}(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.}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM hj9ubh)}(h **Context**h]jR)}(hj9h]hContext}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1jQhj9ubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM hj9ubh)}(hah"]h$]h&]uh1j1hj:ubjI)}(hbhh]hbh}(hj:hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj:ubeh}(h]h ]h"]h$]h&]noemphjajbuh1jihj~:ubah}(h]h ]h"]h$]h&]jajbuh1jchjE:hhhjW:hM` ubeh}(h]h ]h"]h$]h&]jajbjuh1jjjhjA:hhhjW:hM` ubah}(h]j<:ah ](jjeh"]h$]h&]jj)jhuh1jhjW:hM` hj>:hhubj!)}(hhh]h)}(h#Test whether the buffer is uptodateh]h#Test whether the buffer is uptodate}(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&]uh1j hj>:hhhjW:hM` ubeh}(h]h ](jfunctioneh"]h$]h&]jAjjBj!;jCj!;jDjEjFuh1hhhhhhNhNubjH)}(h**Parameters** ``struct buffer_head *bh`` struct buffer_head **Description** Return true if the buffer is up-to-date and false, with the buffer locked, if not.h](h)}(h**Parameters**h]jR)}(hj+;h]h Parameters}(hj-;hhhNhNubah}(h]h ]h"]h$]h&]uh1jQhj);ubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMd hj%;ubjh)}(hhh]jm)}(h.``struct buffer_head *bh`` struct buffer_head h](js)}(h``struct buffer_head *bh``h]jy)}(hjJ;h]hstruct buffer_head *bh}(hjL;hhhNhNubah}(h]h ]h"]h$]h&]uh1jxhjH;ubah}(h]h ]h"]h$]h&]uh1jrhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMa hjD;ubj)}(hhh]h)}(hstruct buffer_headh]hstruct buffer_head}(hjc;hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj_;hMa hj`;ubah}(h]h ]h"]h$]h&]uh1jhjD;ubeh}(h]h ]h"]h$]h&]uh1jlhj_;hMa hjA;ubah}(h]h ]h"]h$]h&]uh1jghj%;ubh)}(h**Description**h]jR)}(hj;h]h Description}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1jQhj;ubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMc 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.}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMb hj%;ubeh}(h]h ] kernelindentah"]h$]h&]uh1jGhhhhhNhNubh)}(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.chMs ubj!)}(h h]h }(hj;hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj;hhhj;hMs ubjC)}(h __bh_readh]jI)}(h __bh_readh]h __bh_read}(hj;hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj;ubah}(h]h ](j\j]eh"]h$]h&]jajbuh1jBhj;hhhj;hMs ubjd)}(h7(struct buffer_head *bh, blk_opf_t op_flags, bool wait)h](jj)}(hstruct buffer_head *bhh](jp)}(hjh]hstruct}(hj<hhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johj<ubj!)}(h h]h }(hj<hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj<ubh)}(hhh]jI)}(h buffer_headh]h buffer_head}(hj%<hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj"<ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj'<modnameN classnameNjj)}j]j)}jj;sb c.__bh_readasbuh1hhj<ubj!)}(h h]h }(hjE<hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj<ubj2)}(hj5h]h*}(hjS<hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj<ubjI)}(hbhh]hbh}(hj`<hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj<ubeh}(h]h ]h"]h$]h&]noemphjajbuh1jihj;ubjj)}(hblk_opf_t op_flagsh](h)}(hhh]jI)}(h blk_opf_th]h blk_opf_t}(hj|<hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhjy<ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj~<modnameN classnameNjj)}j]jA< c.__bh_readasbuh1hhju<ubj!)}(h h]h }(hj<hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hju<ubjI)}(hop_flagsh]hop_flags}(hj<hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhju<ubeh}(h]h ]h"]h$]h&]noemphjajbuh1jihj;ubjj)}(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<ubjI)}(hwaith]hwait}(hj<hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj<ubeh}(h]h ]h"]h$]h&]noemphjajbuh1jihj;ubeh}(h]h ]h"]h$]h&]jajbuh1jchj;hhhj;hMs ubeh}(h]h ]h"]h$]h&]jajbjuh1jjjhj;hhhj;hMs ubah}(h]j;ah ](jjeh"]h$]h&]jj)jhuh1jhj;hMs 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.chMs hj=hhubah}(h]h ]h"]h$]h&]uh1j hj;hhhj;hMs ubeh}(h]h ](jfunctioneh"]h$]h&]jAjjBj=jCj=jDjEjFuh1hhhhhhNhNubjH)}(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]jR)}(hj(=h]h Parameters}(hj*=hhhNhNubah}(h]h ]h"]h$]h&]uh1jQhj&=ubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMw hj"=ubjh)}(hhh](jm)}(h.``struct buffer_head *bh`` struct buffer_head h](js)}(h``struct buffer_head *bh``h]jy)}(hjG=h]hstruct buffer_head *bh}(hjI=hhhNhNubah}(h]h ]h"]h$]h&]uh1jxhjE=ubah}(h]h ]h"]h$]h&]uh1jrhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMt hjA=ubj)}(hhh]h)}(hstruct buffer_headh]hstruct buffer_head}(hj`=hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj\=hMt hj]=ubah}(h]h ]h"]h$]h&]uh1jhjA=ubeh}(h]h ]h"]h$]h&]uh1jlhj\=hMt hj>=ubjm)}(hD``blk_opf_t op_flags`` appending REQ_OP_* flags besides REQ_OP_READ h](js)}(h``blk_opf_t op_flags``h]jy)}(hj=h]hblk_opf_t op_flags}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1jxhj~=ubah}(h]h ]h"]h$]h&]uh1jrhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMu hjz=ubj)}(hhh]h)}(h,appending REQ_OP_* flags besides REQ_OP_READh]h,appending REQ_OP_* flags besides REQ_OP_READ}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj=hMu hj=ubah}(h]h ]h"]h$]h&]uh1jhjz=ubeh}(h]h ]h"]h$]h&]uh1jlhj=hMu hj>=ubjm)}(h(``bool wait`` wait until reading finish h](js)}(h ``bool wait``h]jy)}(hj=h]h bool wait}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1jxhj=ubah}(h]h ]h"]h$]h&]uh1jrhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMv hj=ubj)}(hhh]h)}(hwait until reading finishh]hwait until reading finish}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj=hMv hj=ubah}(h]h ]h"]h$]h&]uh1jhj=ubeh}(h]h ]h"]h$]h&]uh1jlhj=hMv hj>=ubeh}(h]h ]h"]h$]h&]uh1jghj"=ubh)}(h**Description**h]jR)}(hj=h]h Description}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1jQhj=ubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMx 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.}(hj >hhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chMw hj"=ubeh}(h]h ] kernelindentah"]h$]h&]uh1jGhhhhhNhNubh)}(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}(hj9>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5>hhhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM ubj!)}(h h]h }(hjH>hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1;(j hj5>hhhjG>hM ubjC)}(h__bh_read_batchh]jI)}(h__bh_read_batchh]h__bh_read_batch}(hjZ>hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhjV>ubah}(h]h ](j\j]eh"]h$]h&]jajbuh1jBhj5>hhhjG>hM ubjd)}(hH(int nr, struct buffer_head *bhs[], blk_opf_t op_flags, bool force_lock)h](jj)}(hint nrh](j)}(hinth]hint}(hjv>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjr>ubj!)}(h h]h }(hj>hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hjr>ubjI)}(hnrh]hnr}(hj>hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhjr>ubeh}(h]h ]h"]h$]h&]noemphjajbuh1jihjn>ubjj)}(hstruct buffer_head *bhs[]h](jp)}(hjh]hstruct}(hj>hhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johj>ubj!)}(h h]h }(hj>hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj>ubh)}(hhh]jI)}(h buffer_headh]h buffer_head}(hj>hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj>ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj>modnameN classnameNjj)}j]j)}jj\>sbc.__bh_read_batchasbuh1hhj>ubj!)}(h h]h }(hj>hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj>ubj2)}(hj5h]h*}(hj>hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj>ubjI)}(hbhsh]hbhs}(hj?hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj>ubj2)}(h[h]h[}(hj?hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj>ubj2)}(h]h]h]}(hj ?hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj>ubeh}(h]h ]h"]h$]h&]noemphjajbuh1jihjn>ubjj)}(hblk_opf_t op_flagsh](h)}(hhh]jI)}(h blk_opf_th]h blk_opf_t}(hj?modnameN classnameNjj)}j]j>c.__bh_read_batchasbuh1hhj5?ubj!)}(h h]h }(hjZ?hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j hj5?ubjI)}(hop_flagsh]hop_flags}(hjh?hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj5?ubeh}(h]h ]h"]h$]h&]noemphjajbuh1jihjn>ubjj)}(hbool force_lockh](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}?ubjI)}(h force_lockh]h force_lock}(hj?hhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhj}?ubeh}(h]h ]h"]h$]h&]noemphjajbuh1jihjn>ubeh}(h]h ]h"]h$]h&]jajbuh1jchj5>hhhjG>hM ubeh}(h]h ]h"]h$]h&]jajbjuh1jjjhj1>hhhjG>hM ubah}(h]j,>ah ](jjeh"]h$]h&]jj)jhuh1jhjG>hM hj.>hhubj!)}(hhh]h)}(h+Submit read for a batch of unlocked buffersh]h+Submit read for a batch of unlocked buffers}(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&]uh1j hj.>hhhjG>hM ubeh}(h]h ](jfunctioneh"]h$]h&]jAjjBj?jCj?jDjEjFuh1hhhhhhNhNubjH)}(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]jR)}(hj?h]h Parameters}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1jQhj?ubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM hj?ubjh)}(hhh](jm)}(h,``int nr`` entry number of the buffer batch h](js)}(h ``int nr``h]jy)}(hj@h]hint nr}(hj @hhhNhNubah}(h]h ]h"]h$]h&]uh1jxhj@ubah}(h]h ]h"]h$]h&]uh1jrhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM hj@ubj)}(hhh]h)}(h entry number of the buffer batchh]h entry number of the buffer batch}(hj @hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj@hM hj@ubah}(h]h ]h"]h$]h&]uh1jhj@ubeh}(h]h ]h"]h$]h&]uh1jlhj@hM hj?ubjm)}(h<``struct buffer_head *bhs[]`` a batch of struct buffer_head h](js)}(h``struct buffer_head *bhs[]``h]jy)}(hj@@h]hstruct buffer_head *bhs[]}(hjB@hhhNhNubah}(h]h ]h"]h$]h&]uh1jxhj>@ubah}(h]h ]h"]h$]h&]uh1jrhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM hj:@ubj)}(hhh]h)}(ha batch of struct buffer_headh]ha batch of struct buffer_head}(hjY@hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjU@hM hjV@ubah}(h]h ]h"]h$]h&]uh1jhj:@ubeh}(h]h ]h"]h$]h&]uh1jlhjU@hM hj?ubjm)}(hD``blk_opf_t op_flags`` appending REQ_OP_* flags besides REQ_OP_READ h](js)}(h``blk_opf_t op_flags``h]jy)}(hjy@h]hblk_opf_t op_flags}(hj{@hhhNhNubah}(h]h ]h"]h$]h&]uh1jxhjw@ubah}(h]h ]h"]h$]h&]uh1jrhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM hjs@ubj)}(hhh]h)}(h,appending REQ_OP_* flags besides REQ_OP_READh]h,appending REQ_OP_* flags besides REQ_OP_READ}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj@hM hj@ubah}(h]h ]h"]h$]h&]uh1jhjs@ubeh}(h]h ]h"]h$]h&]uh1jlhj@hM hj?ubjm)}(hk``bool force_lock`` force to get a lock on the buffer if set, otherwise drops any buffer that cannot lock. h](js)}(h``bool force_lock``h]jy)}(hj@h]hbool force_lock}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jxhj@ubah}(h]h ]h"]h$]h&]uh1jrhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM hj@ubj)}(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.}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM hj@ubah}(h]h ]h"]h$]h&]uh1jhj@ubeh}(h]h ]h"]h$]h&]uh1jlhj@hM hj?ubeh}(h]h ]h"]h$]h&]uh1jghj?ubh)}(h**Description**h]jR)}(hj@h]h Description}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jQhj@ubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM 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.}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1hhN/var/lib/git/docbuild/linux/Documentation/filesystems/buffer:11: ./fs/buffer.chM hj?ubeh}(h]h ] kernelindentah"]h$]h&]uh1jGhhhhhNhNubeh}(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_handlerjMAerror_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}(j'Aj$AjAjAu nametypes}(j'AjAuh}(j$AhjAhhjjjjj jjjvj{j j j j jjjjjj jjjwj|jjjyj~jjjjj!j!j$j$j&j &j'j'jA)jF)j+j+j)/j./j2j2j5j5j8j 8j<:jA:j;j;j,>j1>u 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.