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/api-summarymodnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Traditional)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget+/translations/zh_TW/filesystems/api-summarymodnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget+/translations/it_IT/filesystems/api-summarymodnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget+/translations/ja_JP/filesystems/api-summarymodnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget+/translations/ko_KR/filesystems/api-summarymodnameN classnameN refexplicituh1hhh ubh)}(hhh]hPortuguese (Brazilian)}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget+/translations/pt_BR/filesystems/api-summarymodnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget+/translations/sp_SP/filesystems/api-summarymodnameN classnameN refexplicituh1hhh ubeh}(h]h ]h"]h$]h&]current_languageEnglishuh1h hh _documenthsourceNlineNubhsection)}(hhh](htitle)}(hLinux Filesystems API summaryh]hLinux Filesystems API summary}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhE/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary.rsthKubh paragraph)}(hXThis section contains API-level documentation, mostly taken from the source code itself.h]hXThis section contains API-level documentation, mostly taken from the source code itself.}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh)}(hhh](h)}(h The Linux VFSh]h The Linux VFS}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhhhK ubh)}(hhh](h)}(hThe Filesystem typesh]hThe Filesystem types}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhhhK ubhindex)}(hhh]h}(h]h ]h"]h$]h&]entries](singlepositive_aop_returns (C enum)c.positive_aop_returnshNtauh1hhhhhhNhNubhdesc)}(hhh](hdesc_signature)}(hpositive_aop_returnsh]hdesc_signature_line)}(henum positive_aop_returnsh](hdesc_sig_keyword)}(henumh]henum}(hj!hhhNhNubah}(h]h ]kah"]h$]h&]uh1jhjhhhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhKubhdesc_sig_space)}(h h]h }(hj3hhhNhNubah}(h]h ]wah"]h$]h&]uh1j1hjhhhj0hKubh desc_name)}(hpositive_aop_returnsh]h desc_sig_name)}(hjh]hpositive_aop_returns}(hjJhhhNhNubah}(h]h ]nah"]h$]h&]uh1jHhjDubah}(h]h ](sig-namedescnameeh"]h$]h&] xml:spacepreserveuh1jBhjhhhj0hKubeh}(h]h ]h"]h$]h&]j`ja add_permalinkuh1jsphinx_line_type declaratorhjhhhj0hKubah}(h]j ah ](sig sig-objecteh"]h$]h&] is_multiline _toc_parts) _toc_namehuh1jhj0hKhjhhubh desc_content)}(hhh]h)}(h(aop return codes with specific semanticsh]h(aop return codes with specific semantics}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM,hjxhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhj0hKubeh}(h]h ](cenumeh"]h$]h&]domainjobjtypejdesctypejnoindex noindexentrynocontentsentryuh1jhhhhhNhNubh container)}(hX**Constants** ``AOP_WRITEPAGE_ACTIVATE`` Informs the caller that page writeback has completed, that the page is still locked, and should be considered active. The VM uses this hint to return the page to the active list -- it won't be a candidate for writeback again in the near future. Other callers must be careful to unlock the page if they get this return. Returned by writepage(); ``AOP_TRUNCATED_PAGE`` The AOP method that was handed a locked page has unlocked it and the page might have been truncated. The caller should back up to acquiring a new page and trying again. The aop will be taking reasonable precautions not to livelock. If the caller held a page reference, it should drop it before retrying. Returned by read_folio().h](h)}(h **Constants**h]hstrong)}(hjh]h Constants}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM0hjubhdefinition_list)}(hhh](hdefinition_list_item)}(hXv``AOP_WRITEPAGE_ACTIVATE`` Informs the caller that page writeback has completed, that the page is still locked, and should be considered active. The VM uses this hint to return the page to the active list -- it won't be a candidate for writeback again in the near future. Other callers must be careful to unlock the page if they get this return. Returned by writepage(); h](hterm)}(h``AOP_WRITEPAGE_ACTIVATE``h]hliteral)}(hjh]hAOP_WRITEPAGE_ACTIVATE}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM:hjubh definition)}(hhh]h)}(hXZInforms the caller that page writeback has completed, that the page is still locked, and should be considered active. The VM uses this hint to return the page to the active list -- it won't be a candidate for writeback again in the near future. Other callers must be careful to unlock the page if they get this return. Returned by writepage();h]hX\Informs the caller that page writeback has completed, that the page is still locked, and should be considered active. The VM uses this hint to return the page to the active list -- it won’t be a candidate for writeback again in the near future. Other callers must be careful to unlock the page if they get this return. Returned by writepage();}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM3hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM:hjubj)}(hXc``AOP_TRUNCATED_PAGE`` The AOP method that was handed a locked page has unlocked it and the page might have been truncated. The caller should back up to acquiring a new page and trying again. The aop will be taking reasonable precautions not to livelock. If the caller held a page reference, it should drop it before retrying. Returned by read_folio().h](j)}(h``AOP_TRUNCATED_PAGE``h]j)}(hj h]hAOP_TRUNCATED_PAGE}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMBhjubj)}(hhh]h)}(hXLThe AOP method that was handed a locked page has unlocked it and the page might have been truncated. The caller should back up to acquiring a new page and trying again. The aop will be taking reasonable precautions not to livelock. If the caller held a page reference, it should drop it before retrying. Returned by read_folio().h]hXLThe AOP method that was handed a locked page has unlocked it and the page might have been truncated. The caller should back up to acquiring a new page and trying again. The aop will be taking reasonable precautions not to livelock. If the caller held a page reference, it should drop it before retrying. Returned by read_folio().}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM=hj!ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj hMBhjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(h**Description**h]j)}(hjNh]h Description}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjLubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMEhhhhubh)}(haddress_space_operation functions return these large constants to indicate special semantics to the caller. These are much larger than the bytes in a page to allow for functions that return the number of bytes operated on in a given page.h]haddress_space_operation functions return these large constants to indicate special semantics to the caller. These are much larger than the bytes in a page to allow for functions that return the number of bytes operated on in a given page.}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM>hhhhubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j address_space (C struct)c.address_spacehNtauh1hhhhhhNhNubj)}(hhh](j)}(h address_spaceh]j)}(hstruct address_spaceh](j )}(hstructh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjhhhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMFubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMFubjC)}(h address_spaceh]jI)}(hjh]h address_space}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhMFubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhMFubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMFhjhhubjw)}(hhh]h)}(h)Contents of a cacheable, mappable object.h]h)Contents of a cacheable, mappable object.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhMFubeh}(h]h ](jstructeh"]h$]h&]jjjjjjjjjuh1jhhhhhNhNubj)}(hX**Definition**:: struct address_space { struct inode *host; struct xarray i_pages; struct rw_semaphore invalidate_lock; gfp_t gfp_mask; atomic_t i_mmap_writable; struct rb_root_cached i_mmap; unsigned long nrpages; pgoff_t writeback_index; const struct address_space_operations *a_ops; unsigned long flags; errseq_t wb_err; spinlock_t i_private_lock; struct rw_semaphore i_mmap_rwsem; }; **Members** ``host`` Owner, either the inode or the block_device. ``i_pages`` Cached pages. ``invalidate_lock`` Guards coherency between page cache contents and file offset->disk block mappings in the filesystem during invalidates. It is also used to block modification of page cache contents through memory mappings. ``gfp_mask`` Memory allocation flags to use for allocating pages. ``i_mmap_writable`` Number of VM_SHARED, VM_MAYWRITE mappings. ``i_mmap`` Tree of private and shared mappings. ``nrpages`` Number of page entries, protected by the i_pages lock. ``writeback_index`` Writeback starts here. ``a_ops`` Methods. ``flags`` Error bits and flags (AS_*). ``wb_err`` The most recent error which has occurred. ``i_private_lock`` For use by the owner of the address_space. ``i_mmap_rwsem`` Protects **i_mmap** and **i_mmap_writable**.h](h)}(h**Definition**::h](j)}(h**Definition**h]h Definition}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh:}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjubh literal_block)}(hXstruct address_space { struct inode *host; struct xarray i_pages; struct rw_semaphore invalidate_lock; gfp_t gfp_mask; atomic_t i_mmap_writable; struct rb_root_cached i_mmap; unsigned long nrpages; pgoff_t writeback_index; const struct address_space_operations *a_ops; unsigned long flags; errseq_t wb_err; spinlock_t i_private_lock; struct rw_semaphore i_mmap_rwsem; };h]hXstruct address_space { struct inode *host; struct xarray i_pages; struct rw_semaphore invalidate_lock; gfp_t gfp_mask; atomic_t i_mmap_writable; struct rb_root_cached i_mmap; unsigned long nrpages; pgoff_t writeback_index; const struct address_space_operations *a_ops; unsigned long flags; errseq_t wb_err; spinlock_t i_private_lock; struct rw_semaphore i_mmap_rwsem; };}hjsbah}(h]h ]h"]h$]h&]j`jauh1j hZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjubh)}(h **Members**h]j)}(hjh]hMembers}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjubj)}(hhh](j)}(h6``host`` Owner, either the inode or the block_device. h](j)}(h``host``h]j)}(hj>h]hhost}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj<ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhj8ubj)}(hhh]h)}(h,Owner, either the inode or the block_device.h]h,Owner, either the inode or the block_device.}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjShMhjTubah}(h]h ]h"]h$]h&]uh1jhj8ubeh}(h]h ]h"]h$]h&]uh1jhjShMhj5ubj)}(h``i_pages`` Cached pages. h](j)}(h ``i_pages``h]j)}(hjwh]hi_pages}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjuubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjqubj)}(hhh]h)}(h Cached pages.h]h Cached pages.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjqubeh}(h]h ]h"]h$]h&]uh1jhjhMhj5ubj)}(h``invalidate_lock`` Guards coherency between page cache contents and file offset->disk block mappings in the filesystem during invalidates. It is also used to block modification of page cache contents through memory mappings. h](j)}(h``invalidate_lock``h]j)}(hjh]hinvalidate_lock}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjubj)}(hhh]h)}(hGuards coherency between page cache contents and file offset->disk block mappings in the filesystem during invalidates. It is also used to block modification of page cache contents through memory mappings.h]hGuards coherency between page cache contents and file offset->disk block mappings in the filesystem during invalidates. It is also used to block modification of page cache contents through memory mappings.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhj5ubj)}(hB``gfp_mask`` Memory allocation flags to use for allocating pages. h](j)}(h ``gfp_mask``h]j)}(hjh]hgfp_mask}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjubj)}(hhh]h)}(h4Memory allocation flags to use for allocating pages.h]h4Memory allocation flags to use for allocating pages.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhj5ubj)}(h?``i_mmap_writable`` Number of VM_SHARED, VM_MAYWRITE mappings. h](j)}(h``i_mmap_writable``h]j)}(hj#h]hi_mmap_writable}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj!ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjubj)}(hhh]h)}(h*Number of VM_SHARED, VM_MAYWRITE mappings.h]h*Number of VM_SHARED, VM_MAYWRITE mappings.}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj8hMhj9ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj8hMhj5ubj)}(h0``i_mmap`` Tree of private and shared mappings. h](j)}(h ``i_mmap``h]j)}(hj\h]hi_mmap}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjZubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjVubj)}(hhh]h)}(h$Tree of private and shared mappings.h]h$Tree of private and shared mappings.}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjqhMhjrubah}(h]h ]h"]h$]h&]uh1jhjVubeh}(h]h ]h"]h$]h&]uh1jhjqhMhj5ubj)}(hC``nrpages`` Number of page entries, protected by the i_pages lock. h](j)}(h ``nrpages``h]j)}(hjh]hnrpages}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjubj)}(hhh]h)}(h6Number of page entries, protected by the i_pages lock.h]h6Number of page entries, protected by the i_pages lock.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhj5ubj)}(h+``writeback_index`` Writeback starts here. h](j)}(h``writeback_index``h]j)}(hjh]hwriteback_index}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjubj)}(hhh]h)}(hWriteback starts here.h]hWriteback starts here.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhj5ubj)}(h``a_ops`` Methods. h](j)}(h ``a_ops``h]j)}(hjh]ha_ops}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjubj)}(hhh]h)}(hMethods.h]hMethods.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhj5ubj)}(h'``flags`` Error bits and flags (AS_*). h](j)}(h ``flags``h]j)}(hj@h]hflags}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj>ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhj:ubj)}(hhh]h)}(hError bits and flags (AS_*).h]hError bits and flags (AS_*).}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjUhMhjVubah}(h]h ]h"]h$]h&]uh1jhj:ubeh}(h]h ]h"]h$]h&]uh1jhjUhMhj5ubj)}(h5``wb_err`` The most recent error which has occurred. h](j)}(h ``wb_err``h]j)}(hjyh]hwb_err}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjwubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjsubj)}(hhh]h)}(h)The most recent error which has occurred.h]h)The most recent error which has occurred.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjsubeh}(h]h ]h"]h$]h&]uh1jhjhMhj5ubj)}(h>``i_private_lock`` For use by the owner of the address_space. h](j)}(h``i_private_lock``h]j)}(hjh]hi_private_lock}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjubj)}(hhh]h)}(h*For use by the owner of the address_space.h]h*For use by the owner of the address_space.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhj5ubj)}(h=``i_mmap_rwsem`` Protects **i_mmap** and **i_mmap_writable**.h](j)}(h``i_mmap_rwsem``h]j)}(hjh]h i_mmap_rwsem}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjubj)}(hhh]h)}(h,Protects **i_mmap** and **i_mmap_writable**.h](h Protects }(hjhhhNhNubj)}(h **i_mmap**h]hi_mmap}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh and }(hjhhhNhNubj)}(h**i_mmap_writable**h]hi_mmap_writable}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhj5ubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j file_ra_state (C struct)c.file_ra_statehNtauh1hhhhhhNhNubj)}(hhh](j)}(h file_ra_stateh]j)}(hstruct file_ra_stateh](j )}(hjh]hstruct}(hjihhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjehhhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMubj2)}(h h]h }(hjwhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjehhhjvhMubjC)}(h file_ra_stateh]jI)}(hjch]h file_ra_state}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjehhhjvhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjahhhjvhMubah}(h]j\ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjvhMhj^hhubjw)}(hhh]h)}(hTrack a file's readahead state.h]h!Track a file’s readahead state.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjhhubah}(h]h ]h"]h$]h&]uh1jvhj^hhhjvhMubeh}(h]h ](jstructeh"]h$]h&]jjjjjjjjjuh1jhhhhhNhNubj)}(hX***Definition**:: struct file_ra_state { pgoff_t start; unsigned int size; unsigned int async_size; unsigned int ra_pages; unsigned short order; unsigned short mmap_miss; loff_t prev_pos; }; **Members** ``start`` Where the most recent readahead started. ``size`` Number of pages read in the most recent readahead. ``async_size`` Numer of pages that were/are not needed immediately and so were/are genuinely "ahead". Start next readahead when the first of these pages is accessed. ``ra_pages`` Maximum size of a readahead request, copied from the bdi. ``order`` Preferred folio order used for most recent readahead. ``mmap_miss`` How many mmap accesses missed in the page cache. ``prev_pos`` The last byte in the most recent read request.h](h)}(h**Definition**::h](j)}(h**Definition**h]h Definition}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh:}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjubj )}(hstruct file_ra_state { pgoff_t start; unsigned int size; unsigned int async_size; unsigned int ra_pages; unsigned short order; unsigned short mmap_miss; loff_t prev_pos; };h]hstruct file_ra_state { pgoff_t start; unsigned int size; unsigned int async_size; unsigned int ra_pages; unsigned short order; unsigned short mmap_miss; loff_t prev_pos; };}hjsbah}(h]h ]h"]h$]h&]j`jauh1j hZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjubh)}(h **Members**h]j)}(hjh]hMembers}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjubj)}(hhh](j)}(h3``start`` Where the most recent readahead started. h](j)}(h ``start``h]j)}(hjh]hstart}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjubj)}(hhh]h)}(h(Where the most recent readahead started.h]h(Where the most recent readahead started.}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj-hMhj.ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj-hMhjubj)}(h<``size`` Number of pages read in the most recent readahead. h](j)}(h``size``h]j)}(hjQh]hsize}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1jhjOubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjKubj)}(hhh]h)}(h2Number of pages read in the most recent readahead.h]h2Number of pages read in the most recent readahead.}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjfhMhjgubah}(h]h ]h"]h$]h&]uh1jhjKubeh}(h]h ]h"]h$]h&]uh1jhjfhMhjubj)}(h``async_size`` Numer of pages that were/are not needed immediately and so were/are genuinely "ahead". Start next readahead when the first of these pages is accessed. h](j)}(h``async_size``h]j)}(hjh]h async_size}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjubj)}(hhh]h)}(hNumer of pages that were/are not needed immediately and so were/are genuinely "ahead". Start next readahead when the first of these pages is accessed.h]hNumer of pages that were/are not needed immediately and so were/are genuinely “ahead”. Start next readahead when the first of these pages is accessed.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(hG``ra_pages`` Maximum size of a readahead request, copied from the bdi. h](j)}(h ``ra_pages``h]j)}(hjh]hra_pages}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjubj)}(hhh]h)}(h9Maximum size of a readahead request, copied from the bdi.h]h9Maximum size of a readahead request, copied from the bdi.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h@``order`` Preferred folio order used for most recent readahead. h](j)}(h ``order``h]j)}(hjh]horder}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjubj)}(hhh]h)}(h5Preferred folio order used for most recent readahead.h]h5Preferred folio order used for most recent readahead.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h?``mmap_miss`` How many mmap accesses missed in the page cache. h](j)}(h ``mmap_miss``h]j)}(hj6h]h mmap_miss}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj4ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhj0ubj)}(hhh]h)}(h0How many mmap accesses missed in the page cache.h]h0How many mmap accesses missed in the page cache.}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjKhMhjLubah}(h]h ]h"]h$]h&]uh1jhj0ubeh}(h]h ]h"]h$]h&]uh1jhjKhMhjubj)}(h;``prev_pos`` The last byte in the most recent read request.h](j)}(h ``prev_pos``h]j)}(hjoh]hprev_pos}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjmubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjiubj)}(hhh]h)}(h.The last byte in the most recent read request.h]h.The last byte in the most recent read request.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjubah}(h]h ]h"]h$]h&]uh1jhjiubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhhhhubh)}(hhWhen this structure is passed to ->readahead(), the "most recent" readahead means the current readahead.h]hlWhen this structure is passed to ->readahead(), the “most recent” readahead means the current readahead.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhhhhubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j file (C struct)c.filehNtauh1hhhhhhNhNubj)}(hhh](j)}(hfileh]j)}(h struct fileh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjhhhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMubjC)}(hfileh]jI)}(hjh]hfile}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhMubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMhjhhubjw)}(hhh]h)}(hRepresents a fileh]hRepresents a file}(hj2 hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhj/ hhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhMubeh}(h]h ](jstructeh"]h$]h&]jjjjJ jjJ jjjuh1jhhhhhNhNubj)}(hX**Definition**:: struct file { spinlock_t f_lock; fmode_t f_mode; const struct file_operations *f_op; struct address_space *f_mapping; void *private_data; struct inode *f_inode; unsigned int f_flags; unsigned int f_iocb_flags; const struct cred *f_cred; struct fown_struct *f_owner; union { const struct path f_path; struct path __f_path; }; union { struct mutex f_pos_lock; u64 f_pipe; }; loff_t f_pos; #ifdef CONFIG_SECURITY; void *f_security; #endif; errseq_t f_wb_err; errseq_t f_sb_err; #ifdef CONFIG_EPOLL; struct hlist_head *f_ep; #endif; union { struct callback_head f_task_work; struct llist_node f_llist; struct file_ra_state f_ra; freeptr_t f_freeptr; }; file_ref_t f_ref; }; **Members** ``f_lock`` Protects f_ep, f_flags. Must not be taken from IRQ context. ``f_mode`` FMODE_* flags often used in hotpaths ``f_op`` file operations ``f_mapping`` Contents of a cacheable, mappable object. ``private_data`` filesystem or driver specific data ``f_inode`` cached inode ``f_flags`` file flags ``f_iocb_flags`` iocb flags ``f_cred`` stashed credentials of creator/opener ``f_owner`` file owner ``{unnamed_union}`` anonymous ``f_path`` path of the file ``__f_path`` writable alias for **f_path**; *ONLY* for core VFS and only before the file gets open ``{unnamed_union}`` anonymous ``f_pos_lock`` lock protecting file position ``f_pipe`` specific to pipes ``f_pos`` file position ``f_security`` LSM security context of this file ``f_wb_err`` writeback error ``f_sb_err`` per sb writeback errors ``f_ep`` link of all epoll hooks for this file ``{unnamed_union}`` anonymous ``f_task_work`` task work entry point ``f_llist`` work queue entrypoint ``f_ra`` file's readahead state ``f_freeptr`` Pointer used by SLAB_TYPESAFE_BY_RCU file cache (don't touch.) ``f_ref`` reference counth](h)}(h**Definition**::h](j)}(h**Definition**h]h Definition}(hjV hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjR ubh:}(hjR hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjN ubj )}(hXstruct file { spinlock_t f_lock; fmode_t f_mode; const struct file_operations *f_op; struct address_space *f_mapping; void *private_data; struct inode *f_inode; unsigned int f_flags; unsigned int f_iocb_flags; const struct cred *f_cred; struct fown_struct *f_owner; union { const struct path f_path; struct path __f_path; }; union { struct mutex f_pos_lock; u64 f_pipe; }; loff_t f_pos; #ifdef CONFIG_SECURITY; void *f_security; #endif; errseq_t f_wb_err; errseq_t f_sb_err; #ifdef CONFIG_EPOLL; struct hlist_head *f_ep; #endif; union { struct callback_head f_task_work; struct llist_node f_llist; struct file_ra_state f_ra; freeptr_t f_freeptr; }; file_ref_t f_ref; };h]hXstruct file { spinlock_t f_lock; fmode_t f_mode; const struct file_operations *f_op; struct address_space *f_mapping; void *private_data; struct inode *f_inode; unsigned int f_flags; unsigned int f_iocb_flags; const struct cred *f_cred; struct fown_struct *f_owner; union { const struct path f_path; struct path __f_path; }; union { struct mutex f_pos_lock; u64 f_pipe; }; loff_t f_pos; #ifdef CONFIG_SECURITY; void *f_security; #endif; errseq_t f_wb_err; errseq_t f_sb_err; #ifdef CONFIG_EPOLL; struct hlist_head *f_ep; #endif; union { struct callback_head f_task_work; struct llist_node f_llist; struct file_ra_state f_ra; freeptr_t f_freeptr; }; file_ref_t f_ref; };}hjo sbah}(h]h ]h"]h$]h&]j`jauh1j hZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjN ubh)}(h **Members**h]j)}(hj h]hMembers}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj~ ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjN ubj)}(hhh](j)}(hG``f_lock`` Protects f_ep, f_flags. Must not be taken from IRQ context. h](j)}(h ``f_lock``h]j)}(hj h]hf_lock}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhj ubj)}(hhh]h)}(h;Protects f_ep, f_flags. Must not be taken from IRQ context.h]h;Protects f_ep, f_flags. Must not be taken from IRQ context.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hMhj ubj)}(h0``f_mode`` FMODE_* flags often used in hotpaths h](j)}(h ``f_mode``h]j)}(hj h]hf_mode}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhj ubj)}(hhh]h)}(h$FMODE_* flags often used in hotpathsh]h$FMODE_* flags often used in hotpaths}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hMhj ubj)}(h``f_op`` file operations h](j)}(h``f_op``h]j)}(hj h]hf_op}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhj ubj)}(hhh]h)}(hfile operationsh]hfile operations}(hj* hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj& hMhj' ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj& hMhj ubj)}(h8``f_mapping`` Contents of a cacheable, mappable object. h](j)}(h ``f_mapping``h]j)}(hjJ h]h f_mapping}(hjL hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjH ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjD ubj)}(hhh]h)}(h)Contents of a cacheable, mappable object.h]h)Contents of a cacheable, mappable object.}(hjc hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj_ hMhj` ubah}(h]h ]h"]h$]h&]uh1jhjD ubeh}(h]h ]h"]h$]h&]uh1jhj_ hMhj ubj)}(h4``private_data`` filesystem or driver specific data h](j)}(h``private_data``h]j)}(hj h]h private_data}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhj} ubj)}(hhh]h)}(h"filesystem or driver specific datah]h"filesystem or driver specific data}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMhj ubah}(h]h ]h"]h$]h&]uh1jhj} ubeh}(h]h ]h"]h$]h&]uh1jhj hMhj ubj)}(h``f_inode`` cached inode h](j)}(h ``f_inode``h]j)}(hj h]hf_inode}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhj ubj)}(hhh]h)}(h cached inodeh]h cached inode}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hMhj ubj)}(h``f_flags`` file flags h](j)}(h ``f_flags``h]j)}(hj h]hf_flags}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhj ubj)}(hhh]h)}(h file flagsh]h file flags}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hMhj ubj)}(h``f_iocb_flags`` iocb flags h](j)}(h``f_iocb_flags``h]j)}(hj. h]h f_iocb_flags}(hj0 hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj, ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhj( ubj)}(hhh]h)}(h iocb flagsh]h iocb flags}(hjG hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjC hMhjD ubah}(h]h ]h"]h$]h&]uh1jhj( ubeh}(h]h ]h"]h$]h&]uh1jhjC hMhj ubj)}(h1``f_cred`` stashed credentials of creator/opener h](j)}(h ``f_cred``h]j)}(hjg h]hf_cred}(hji hhhNhNubah}(h]h ]h"]h$]h&]uh1jhje ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhja ubj)}(hhh]h)}(h%stashed credentials of creator/openerh]h%stashed credentials of creator/opener}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj| hMhj} ubah}(h]h ]h"]h$]h&]uh1jhja ubeh}(h]h ]h"]h$]h&]uh1jhj| hMhj ubj)}(h``f_owner`` file owner h](j)}(h ``f_owner``h]j)}(hj h]hf_owner}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhj ubj)}(hhh]h)}(h file ownerh]h file owner}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hMhj ubj)}(h``{unnamed_union}`` anonymous h](j)}(h``{unnamed_union}``h]j)}(hj h]h{unnamed_union}}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhKhj ubj)}(hhh]h)}(h anonymoush]h anonymous}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hKhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hKhj ubj)}(h``f_path`` path of the file h](j)}(h ``f_path``h]j)}(hj h]hf_path}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhj ubj)}(hhh]h)}(hpath of the fileh]hpath of the file}(hj+ hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj' hMhj( ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj' hMhj ubj)}(hc``__f_path`` writable alias for **f_path**; *ONLY* for core VFS and only before the file gets open h](j)}(h ``__f_path``h]j)}(hjK h]h__f_path}(hjM hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjI ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjE ubj)}(hhh]h)}(hUwritable alias for **f_path**; *ONLY* for core VFS and only before the file gets openh](hwritable alias for }(hjd hhhNhNubj)}(h **f_path**h]hf_path}(hjl hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjd ubh; }(hjd hhhNhNubhemphasis)}(h*ONLY*h]hONLY}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j~ hjd ubh0 for core VFS and only before the file gets open}(hjd hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhja ubah}(h]h ]h"]h$]h&]uh1jhjE ubeh}(h]h ]h"]h$]h&]uh1jhj` hMhj ubj)}(h``{unnamed_union}`` anonymous h](j)}(h``{unnamed_union}``h]j)}(hj h]h{unnamed_union}}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhKhj ubj)}(hhh]h)}(h anonymoush]h anonymous}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hKhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hKhj ubj)}(h-``f_pos_lock`` lock protecting file position h](j)}(h``f_pos_lock``h]j)}(hj h]h f_pos_lock}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhj ubj)}(hhh]h)}(hlock protecting file positionh]hlock protecting file position}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hMhj ubj)}(h``f_pipe`` specific to pipes h](j)}(h ``f_pipe``h]j)}(hj h]hf_pipe}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhj ubj)}(hhh]h)}(hspecific to pipesh]hspecific to pipes}(hj6 hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj2 hMhj3 ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj2 hMhj ubj)}(h``f_pos`` file position h](j)}(h ``f_pos``h]j)}(hjV h]hf_pos}(hjX hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjT ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjP ubj)}(hhh]h)}(h file positionh]h file position}(hjo hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjk hMhjl ubah}(h]h ]h"]h$]h&]uh1jhjP ubeh}(h]h ]h"]h$]h&]uh1jhjk hMhj ubj)}(h1``f_security`` LSM security context of this file h](j)}(h``f_security``h]j)}(hj h]h f_security}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhj ubj)}(hhh]h)}(h!LSM security context of this fileh]h!LSM security context of this file}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hMhj ubj)}(h``f_wb_err`` writeback error h](j)}(h ``f_wb_err``h]j)}(hj h]hf_wb_err}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhj ubj)}(hhh]h)}(hwriteback errorh]hwriteback error}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hMhj ubj)}(h%``f_sb_err`` per sb writeback errors h](j)}(h ``f_sb_err``h]j)}(hjh]hf_sb_err}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhj ubj)}(hhh]h)}(hper sb writeback errorsh]hper sb writeback errors}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhjhMhj ubj)}(h/``f_ep`` link of all epoll hooks for this file h](j)}(h``f_ep``h]j)}(hj:h]hf_ep}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj8ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhj4ubj)}(hhh]h)}(h%link of all epoll hooks for this fileh]h%link of all epoll hooks for this file}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1hhjOhMhjPubah}(h]h ]h"]h$]h&]uh1jhj4ubeh}(h]h ]h"]h$]h&]uh1jhjOhMhj ubj)}(h``{unnamed_union}`` anonymous h](j)}(h``{unnamed_union}``h]j)}(hjsh]h{unnamed_union}}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjqubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhKhjmubj)}(hhh]h)}(h anonymoush]h anonymous}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjmubeh}(h]h ]h"]h$]h&]uh1jhjhKhj ubj)}(h&``f_task_work`` task work entry point h](j)}(h``f_task_work``h]j)}(hjh]h f_task_work}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjubj)}(hhh]h)}(htask work entry pointh]htask work entry point}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhj ubj)}(h"``f_llist`` work queue entrypoint h](j)}(h ``f_llist``h]j)}(hjh]hf_llist}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjubj)}(hhh]h)}(hwork queue entrypointh]hwork queue entrypoint}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhj ubj)}(h ``f_ra`` file's readahead state h](j)}(h``f_ra``h]j)}(hjh]hf_ra}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjubj)}(hhh]h)}(hfile's readahead stateh]hfile’s readahead state}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj3hMhj4ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj3hMhj ubj)}(hM``f_freeptr`` Pointer used by SLAB_TYPESAFE_BY_RCU file cache (don't touch.) h](j)}(h ``f_freeptr``h]j)}(hjWh]h f_freeptr}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjUubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjQubj)}(hhh]h)}(h>Pointer used by SLAB_TYPESAFE_BY_RCU file cache (don't touch.)h]h@Pointer used by SLAB_TYPESAFE_BY_RCU file cache (don’t touch.)}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1hhjlhMhjmubah}(h]h ]h"]h$]h&]uh1jhjQubeh}(h]h ]h"]h$]h&]uh1jhjlhMhj ubj)}(h``f_ref`` reference counth](j)}(h ``f_ref``h]j)}(hjh]hf_ref}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjubj)}(hhh]h)}(hreference counth]hreference count}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhj ubeh}(h]h ]h"]h$]h&]uh1jhjN ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j i_uid_into_vfsuid (C function)c.i_uid_into_vfsuidhNtauh1hhhhhhNhNubj)}(hhh](j)}(hUvfsuid_t i_uid_into_vfsuid (const struct mnt_idmap *idmap, const struct inode *inode)h]j)}(hTvfsuid_t i_uid_into_vfsuid(const struct mnt_idmap *idmap, const struct inode *inode)h](h)}(hhh]jI)}(hvfsuid_th]hvfsuid_t}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftype identifier reftargetjmodnameN classnameN c:parent_keysphinx.domains.c LookupKey)}data]j ASTIdentifier)}ji_uid_into_vfsuidsbc.i_uid_into_vfsuidasbuh1hhjhhhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMubjC)}(hi_uid_into_vfsuidh]jI)}(hjh]hi_uid_into_vfsuid}(hj)hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj%ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhMubhdesc_parameterlist)}(h:(const struct mnt_idmap *idmap, const struct inode *inode)h](hdesc_parameter)}(hconst struct mnt_idmap *idmaph](j )}(hconsth]hconst}(hjHhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjDubj2)}(h h]h }(hjVhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjDubj )}(hjh]hstruct}(hjdhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjDubj2)}(h h]h }(hjqhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjDubh)}(hhh]jI)}(h mnt_idmaph]h mnt_idmap}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.i_uid_into_vfsuidasbuh1hhjDubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjDubhdesc_sig_punctuation)}(h*h]h*}(hjhhhNhNubah}(h]h ]pah"]h$]h&]uh1jhjDubjI)}(hidmaph]hidmap}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjDubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj>ubjC)}(hconst struct inode *inodeh](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.i_uid_into_vfsuidasbuh1hhjubj2)}(h h]h }(hj/hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hinodeh]hinode}(hjJhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj>ubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhMubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMhjhhubjw)}(hhh]h)}(h3map an inode's i_uid down according to an idmappingh]h5map an inode’s i_uid down according to an idmapping}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjqhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhhhNhNubj)}(hX**Parameters** ``const struct mnt_idmap *idmap`` idmap of the mount the inode was found from ``const struct inode *inode`` inode to map **Return** the inode's i_uid mapped down according to **idmap**. If the inode's i_uid has no mapping INVALID_VFSUID is returned.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjubj)}(hhh](j)}(hN``const struct mnt_idmap *idmap`` idmap of the mount the inode was found from h](j)}(h!``const struct mnt_idmap *idmap``h]j)}(hjh]hconst struct mnt_idmap *idmap}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjubj)}(hhh]h)}(h+idmap of the mount the inode was found fromh]h+idmap of the mount the inode was found from}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h+``const struct inode *inode`` inode to map h](j)}(h``const struct inode *inode``h]j)}(hjh]hconst struct inode *inode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjubj)}(hhh]h)}(h inode to maph]h inode to map}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h **Return**h]j)}(hj)h]hReturn}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj'ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjubh)}(huthe inode's i_uid mapped down according to **idmap**. If the inode's i_uid has no mapping INVALID_VFSUID is returned.h](h-the inode’s i_uid mapped down according to }(hj?hhhNhNubj)}(h **idmap**h]hidmap}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj?ubhC. If the inode’s i_uid has no mapping INVALID_VFSUID is returned.}(hj?hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j i_uid_needs_update (C function)c.i_uid_needs_updatehNtauh1hhhhhhNhNubj)}(hhh](j)}(hlbool i_uid_needs_update (const struct mnt_idmap *idmap, const struct iattr *attr, const struct inode *inode)h]j)}(hkbool i_uid_needs_update(const struct mnt_idmap *idmap, const struct iattr *attr, const struct inode *inode)h](hdesc_sig_keyword_type)}(hboolh]hbool}(hjhhhNhNubah}(h]h ]ktah"]h$]h&]uh1jhj|hhhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj|hhhjhMubjC)}(hi_uid_needs_updateh]jI)}(hi_uid_needs_updateh]hi_uid_needs_update}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj|hhhjhMubj=)}(hT(const struct mnt_idmap *idmap, const struct iattr *attr, const struct inode *inode)h](jC)}(hconst struct mnt_idmap *idmaph](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(h mnt_idmaph]h mnt_idmap}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jjsbc.i_uid_needs_updateasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hidmaph]hidmap}(hj4hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hconst struct iattr *attrh](j )}(hjJh]hconst}(hjMhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjIubj2)}(h h]h }(hjZhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjIubj )}(hjh]hstruct}(hjhhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjIubj2)}(h h]h }(hjuhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjIubh)}(hhh]jI)}(hiattrh]hiattr}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.i_uid_needs_updateasbuh1hhjIubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjIubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIubjI)}(hattrh]hattr}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjIubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hconst struct inode *inodeh](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.i_uid_needs_updateasbuh1hhjubj2)}(h h]h }(hj/hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hinodeh]hinode}(hjJhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hj|hhhjhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjxhhhjhMubah}(h]jsah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMhjuhhubjw)}(hhh]h)}(h/check whether inode's i_uid needs to be updatedh]h1check whether inode’s i_uid needs to be updated}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjqhhubah}(h]h ]h"]h$]h&]uh1jvhjuhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhhhNhNubj)}(hX**Parameters** ``const struct mnt_idmap *idmap`` idmap of the mount the inode was found from ``const struct iattr *attr`` the new attributes of **inode** ``const struct inode *inode`` the inode to update **Description** Check whether the $inode's i_uid field needs to be updated taking idmapped mounts into account if the filesystem supports it. **Return** true if **inode**'s i_uid field needs to be updated, false if not.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjubj)}(hhh](j)}(hN``const struct mnt_idmap *idmap`` idmap of the mount the inode was found from h](j)}(h!``const struct mnt_idmap *idmap``h]j)}(hjh]hconst struct mnt_idmap *idmap}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjubj)}(hhh]h)}(h+idmap of the mount the inode was found fromh]h+idmap of the mount the inode was found from}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h=``const struct iattr *attr`` the new attributes of **inode** h](j)}(h``const struct iattr *attr``h]j)}(hjh]hconst struct iattr *attr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjubj)}(hhh]h)}(hthe new attributes of **inode**h](hthe new attributes of }(hjhhhNhNubj)}(h **inode**h]hinode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h2``const struct inode *inode`` the inode to update h](j)}(h``const struct inode *inode``h]j)}(hj5h]hconst struct inode *inode}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj3ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhj/ubj)}(hhh]h)}(hthe inode to updateh]hthe inode to update}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjJhMhjKubah}(h]h ]h"]h$]h&]uh1jhj/ubeh}(h]h ]h"]h$]h&]uh1jhjJhMhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjph]h Description}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjnubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjubh)}(h}Check whether the $inode's i_uid field needs to be updated taking idmapped mounts into account if the filesystem supports it.h]hCheck whether the $inode’s i_uid field needs to be updated taking idmapped mounts into account if the filesystem supports it.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjubh)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjubh)}(hBtrue if **inode**'s i_uid field needs to be updated, false if not.h](htrue if }(hjhhhNhNubj)}(h **inode**h]hinode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh3’s i_uid field needs to be updated, false if not.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j i_uid_update (C function)c.i_uid_updatehNtauh1hhhhhhNhNubj)}(hhh](j)}(h`void i_uid_update (const struct mnt_idmap *idmap, const struct iattr *attr, struct inode *inode)h]j)}(h_void i_uid_update(const struct mnt_idmap *idmap, const struct iattr *attr, struct inode *inode)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMubjC)}(h i_uid_updateh]jI)}(h i_uid_updateh]h i_uid_update}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhMubj=)}(hN(const struct mnt_idmap *idmap, const struct iattr *attr, struct inode *inode)h](jC)}(hconst struct mnt_idmap *idmaph](j )}(hjJh]hconst}(hj+hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj'ubj2)}(h h]h }(hj8hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj'ubj )}(hjh]hstruct}(hjFhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj'ubj2)}(h h]h }(hjShhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj'ubh)}(hhh]jI)}(h mnt_idmaph]h mnt_idmap}(hjdhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjaubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjfmodnameN classnameNjj )}j ]j)}jjsbc.i_uid_updateasbuh1hhj'ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj'ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj'ubjI)}(hidmaph]hidmap}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj'ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj#ubjC)}(hconst struct iattr *attrh](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hiattrh]hiattr}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.i_uid_updateasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hattrh]hattr}(hj*hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj#ubjC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hjChhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj?ubj2)}(h h]h }(hjPhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj?ubh)}(hhh]jI)}(hinodeh]hinode}(hjahhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj^ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjcmodnameN classnameNjj )}j ]jc.i_uid_updateasbuh1hhj?ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj?ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?ubjI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj?ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj#ubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhMubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMhjhhubjw)}(hhh]h)}(hupdate **inode**'s i_uid fieldh](hupdate }(hjhhhNhNubj)}(h **inode**h]hinode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh’s i_uid field}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhhhNhNubj)}(hXM**Parameters** ``const struct mnt_idmap *idmap`` idmap of the mount the inode was found from ``const struct iattr *attr`` the new attributes of **inode** ``struct inode *inode`` the inode to update **Description** Safely update **inode**'s i_uid field translating the vfsuid of any idmapped mount into the filesystem kuid.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjubj)}(hhh](j)}(hN``const struct mnt_idmap *idmap`` idmap of the mount the inode was found from h](j)}(h!``const struct mnt_idmap *idmap``h]j)}(hjh]hconst struct mnt_idmap *idmap}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjubj)}(hhh]h)}(h+idmap of the mount the inode was found fromh]h+idmap of the mount the inode was found from}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj,hMhj-ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj,hMhjubj)}(h=``const struct iattr *attr`` the new attributes of **inode** h](j)}(h``const struct iattr *attr``h]j)}(hjPh]hconst struct iattr *attr}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjNubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjJubj)}(hhh]h)}(hthe new attributes of **inode**h](hthe new attributes of }(hjihhhNhNubj)}(h **inode**h]hinode}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjiubeh}(h]h ]h"]h$]h&]uh1hhjehMhjfubah}(h]h ]h"]h$]h&]uh1jhjJubeh}(h]h ]h"]h$]h&]uh1jhjehMhjubj)}(h,``struct inode *inode`` the inode to update h](j)}(h``struct inode *inode``h]j)}(hjh]hstruct inode *inode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjubj)}(hhh]h)}(hthe inode to updateh]hthe inode to update}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjubh)}(hlSafely update **inode**'s i_uid field translating the vfsuid of any idmapped mount into the filesystem kuid.h](hSafely update }(hjhhhNhNubj)}(h **inode**h]hinode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhW’s i_uid field translating the vfsuid of any idmapped mount into the filesystem kuid.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j i_gid_into_vfsgid (C function)c.i_gid_into_vfsgidhNtauh1hhhhhhNhNubj)}(hhh](j)}(hUvfsgid_t i_gid_into_vfsgid (const struct mnt_idmap *idmap, const struct inode *inode)h]j)}(hTvfsgid_t i_gid_into_vfsgid(const struct mnt_idmap *idmap, const struct inode *inode)h](h)}(hhh]jI)}(hvfsgid_th]hvfsgid_t}(hj,hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj)ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj.modnameN classnameNjj )}j ]j)}ji_gid_into_vfsgidsbc.i_gid_into_vfsgidasbuh1hhj%hhhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMubj2)}(h h]h }(hjNhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj%hhhjMhMubjC)}(hi_gid_into_vfsgidh]jI)}(hjJh]hi_gid_into_vfsgid}(hj`hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj\ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj%hhhjMhMubj=)}(h:(const struct mnt_idmap *idmap, const struct inode *inode)h](jC)}(hconst struct mnt_idmap *idmaph](j )}(hjJh]hconst}(hj{hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjwubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjwubj )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjwubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjwubh)}(hhh]jI)}(h mnt_idmaph]h mnt_idmap}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jHc.i_gid_into_vfsgidasbuh1hhjwubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjwubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjwubjI)}(hidmaph]hidmap}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjwubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjsubjC)}(hconst struct inode *inodeh](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj )}(hjh]hstruct}(hj!hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hj.hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hinodeh]hinode}(hj?hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj<ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjAmodnameN classnameNjj )}j ]jHc.i_gid_into_vfsgidasbuh1hhjubj2)}(h h]h }(hj]hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hinodeh]hinode}(hjxhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjsubeh}(h]h ]h"]h$]h&]j`jauh1j<hj%hhhjMhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj!hhhjMhMubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjMhMhjhhubjw)}(hhh]h)}(h3map an inode's i_gid down according to an idmappingh]h5map an inode’s i_gid down according to an idmapping}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjMhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhhhNhNubj)}(hX**Parameters** ``const struct mnt_idmap *idmap`` idmap of the mount the inode was found from ``const struct inode *inode`` inode to map **Return** the inode's i_gid mapped down according to **idmap**. If the inode's i_gid has no mapping INVALID_VFSGID is returned.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjubj)}(hhh](j)}(hN``const struct mnt_idmap *idmap`` idmap of the mount the inode was found from h](j)}(h!``const struct mnt_idmap *idmap``h]j)}(hjh]hconst struct mnt_idmap *idmap}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjubj)}(hhh]h)}(h+idmap of the mount the inode was found fromh]h+idmap of the mount the inode was found from}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h+``const struct inode *inode`` inode to map h](j)}(h``const struct inode *inode``h]j)}(hjh]hconst struct inode *inode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjubj)}(hhh]h)}(h inode to maph]h inode to map}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj1hMhj2ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj1hMhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h **Return**h]j)}(hjWh]hReturn}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjUubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjubh)}(huthe inode's i_gid mapped down according to **idmap**. If the inode's i_gid has no mapping INVALID_VFSGID is returned.h](h-the inode’s i_gid mapped down according to }(hjmhhhNhNubj)}(h **idmap**h]hidmap}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjmubhC. If the inode’s i_gid has no mapping INVALID_VFSGID is returned.}(hjmhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j i_gid_needs_update (C function)c.i_gid_needs_updatehNtauh1hhhhhhNhNubj)}(hhh](j)}(hlbool i_gid_needs_update (const struct mnt_idmap *idmap, const struct iattr *attr, const struct inode *inode)h]j)}(hkbool i_gid_needs_update(const struct mnt_idmap *idmap, const struct iattr *attr, const struct inode *inode)h](j)}(hjh]hbool}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMubjC)}(hi_gid_needs_updateh]jI)}(hi_gid_needs_updateh]hi_gid_needs_update}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhMubj=)}(hT(const struct mnt_idmap *idmap, const struct iattr *attr, const struct inode *inode)h](jC)}(hconst struct mnt_idmap *idmaph](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(h mnt_idmaph]h mnt_idmap}(hj#hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj%modnameN classnameNjj )}j ]j)}jjsbc.i_gid_needs_updateasbuh1hhjubj2)}(h h]h }(hjChhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjQhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hidmaph]hidmap}(hj^hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hconst struct iattr *attrh](j )}(hjJh]hconst}(hjwhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjsubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjsubj )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjsubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjsubh)}(hhh]jI)}(hiattrh]hiattr}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j?c.i_gid_needs_updateasbuh1hhjsubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjsubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjsubjI)}(hattrh]hattr}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjsubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hconst struct inode *inodeh](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hj*hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hinodeh]hinode}(hj;hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj8ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj=modnameN classnameNjj )}j ]j?c.i_gid_needs_updateasbuh1hhjubj2)}(h h]h }(hjYhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hinodeh]hinode}(hjthhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhMubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMhjhhubjw)}(hhh]h)}(h/check whether inode's i_gid needs to be updatedh]h1check whether inode’s i_gid needs to be updated}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhhhNhNubj)}(hX**Parameters** ``const struct mnt_idmap *idmap`` idmap of the mount the inode was found from ``const struct iattr *attr`` the new attributes of **inode** ``const struct inode *inode`` the inode to update **Description** Check whether the $inode's i_gid field needs to be updated taking idmapped mounts into account if the filesystem supports it. **Return** true if **inode**'s i_gid field needs to be updated, false if not.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjubj)}(hhh](j)}(hN``const struct mnt_idmap *idmap`` idmap of the mount the inode was found from h](j)}(h!``const struct mnt_idmap *idmap``h]j)}(hjh]hconst struct mnt_idmap *idmap}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjubj)}(hhh]h)}(h+idmap of the mount the inode was found fromh]h+idmap of the mount the inode was found from}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h=``const struct iattr *attr`` the new attributes of **inode** h](j)}(h``const struct iattr *attr``h]j)}(hjh]hconst struct iattr *attr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjubj)}(hhh]h)}(hthe new attributes of **inode**h](hthe new attributes of }(hj1hhhNhNubj)}(h **inode**h]hinode}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj1ubeh}(h]h ]h"]h$]h&]uh1hhj-hMhj.ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj-hMhjubj)}(h2``const struct inode *inode`` the inode to update h](j)}(h``const struct inode *inode``h]j)}(hj_h]hconst struct inode *inode}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1jhj]ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjYubj)}(hhh]h)}(hthe inode to updateh]hthe inode to update}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjthMhjuubah}(h]h ]h"]h$]h&]uh1jhjYubeh}(h]h ]h"]h$]h&]uh1jhjthMhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjubh)}(h}Check whether the $inode's i_gid field needs to be updated taking idmapped mounts into account if the filesystem supports it.h]hCheck whether the $inode’s i_gid field needs to be updated taking idmapped mounts into account if the filesystem supports it.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjubh)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjubh)}(hBtrue if **inode**'s i_gid field needs to be updated, false if not.h](htrue if }(hjhhhNhNubj)}(h **inode**h]hinode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh3’s i_gid field needs to be updated, false if not.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j i_gid_update (C function)c.i_gid_updatehNtauh1hhhhhhNhNubj)}(hhh](j)}(h`void i_gid_update (const struct mnt_idmap *idmap, const struct iattr *attr, struct inode *inode)h]j)}(h_void i_gid_update(const struct mnt_idmap *idmap, const struct iattr *attr, struct inode *inode)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMubj2)}(h h]h }(hj'hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhj&hMubjC)}(h i_gid_updateh]jI)}(h i_gid_updateh]h i_gid_update}(hj9hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj5ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhj&hMubj=)}(hN(const struct mnt_idmap *idmap, const struct iattr *attr, struct inode *inode)h](jC)}(hconst struct mnt_idmap *idmaph](j )}(hjJh]hconst}(hjUhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjQubj2)}(h h]h }(hjbhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjQubj )}(hjh]hstruct}(hjphhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjQubj2)}(h h]h }(hj}hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjQubh)}(hhh]jI)}(h mnt_idmaph]h mnt_idmap}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jj;sbc.i_gid_updateasbuh1hhjQubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjQubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjQubjI)}(hidmaph]hidmap}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjQubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjMubjC)}(hconst struct iattr *attrh](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hj hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hiattrh]hiattr}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj modnameN classnameNjj )}j ]jc.i_gid_updateasbuh1hhjubj2)}(h h]h }(hj9 hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjG hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hattrh]hattr}(hjT hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjMubjC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hjm hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhji ubj2)}(h h]h }(hjz hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hji ubh)}(hhh]jI)}(hinodeh]hinode}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj modnameN classnameNjj )}j ]jc.i_gid_updateasbuh1hhji ubj2)}(h h]h }(hj hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hji ubj)}(hjh]h*}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhji ubjI)}(hinodeh]hinode}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhji ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjMubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhj&hMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhj&hMubah}(h]j ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj&hMhj hhubjw)}(hhh]h)}(hupdate **inode**'s i_gid fieldh](hupdate }(hj hhhNhNubj)}(h **inode**h]hinode}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubh’s i_gid field}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhj hhubah}(h]h ]h"]h$]h&]uh1jvhj hhhj&hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjj!jj!jjjuh1jhhhhhNhNubj)}(hXM**Parameters** ``const struct mnt_idmap *idmap`` idmap of the mount the inode was found from ``const struct iattr *attr`` the new attributes of **inode** ``struct inode *inode`` the inode to update **Description** Safely update **inode**'s i_gid field translating the vfsgid of any idmapped mount into the filesystem kgid.h](h)}(h**Parameters**h]j)}(hj"!h]h Parameters}(hj$!hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj !ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhj!ubj)}(hhh](j)}(hN``const struct mnt_idmap *idmap`` idmap of the mount the inode was found from h](j)}(h!``const struct mnt_idmap *idmap``h]j)}(hjA!h]hconst struct mnt_idmap *idmap}(hjC!hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj?!ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhj;!ubj)}(hhh]h)}(h+idmap of the mount the inode was found fromh]h+idmap of the mount the inode was found from}(hjZ!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjV!hMhjW!ubah}(h]h ]h"]h$]h&]uh1jhj;!ubeh}(h]h ]h"]h$]h&]uh1jhjV!hMhj8!ubj)}(h=``const struct iattr *attr`` the new attributes of **inode** h](j)}(h``const struct iattr *attr``h]j)}(hjz!h]hconst struct iattr *attr}(hj|!hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjx!ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjt!ubj)}(hhh]h)}(hthe new attributes of **inode**h](hthe new attributes of }(hj!hhhNhNubj)}(h **inode**h]hinode}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj!ubeh}(h]h ]h"]h$]h&]uh1hhj!hMhj!ubah}(h]h ]h"]h$]h&]uh1jhjt!ubeh}(h]h ]h"]h$]h&]uh1jhj!hMhj8!ubj)}(h,``struct inode *inode`` the inode to update h](j)}(h``struct inode *inode``h]j)}(hj!h]hstruct inode *inode}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj!ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhj!ubj)}(hhh]h)}(hthe inode to updateh]hthe inode to update}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj!hMhj!ubah}(h]h ]h"]h$]h&]uh1jhj!ubeh}(h]h ]h"]h$]h&]uh1jhj!hMhj8!ubeh}(h]h ]h"]h$]h&]uh1jhj!ubh)}(h**Description**h]j)}(hj!h]h Description}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj!ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhj!ubh)}(hlSafely update **inode**'s i_gid field translating the vfsgid of any idmapped mount into the filesystem kgid.h](hSafely update }(hj"hhhNhNubj)}(h **inode**h]hinode}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj"ubhW’s i_gid field translating the vfsgid of any idmapped mount into the filesystem kgid.}(hj"hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhj!ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j inode_fsuid_set (C function)c.inode_fsuid_sethNtauh1hhhhhhNhNubj)}(hhh](j)}(hIvoid inode_fsuid_set (struct inode *inode, const struct mnt_idmap *idmap)h]j)}(hHvoid inode_fsuid_set(struct inode *inode, const struct mnt_idmap *idmap)h](j)}(hvoidh]hvoid}(hjS"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjO"hhhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMubj2)}(h h]h }(hjb"hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjO"hhhja"hMubjC)}(hinode_fsuid_seth]jI)}(hinode_fsuid_seth]hinode_fsuid_set}(hjt"hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjp"ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjO"hhhja"hMubj=)}(h4(struct inode *inode, const struct mnt_idmap *idmap)h](jC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hj"hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj"ubj2)}(h h]h }(hj"hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj"ubh)}(hhh]jI)}(hinodeh]hinode}(hj"hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj"ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj"modnameN classnameNjj )}j ]j)}jjv"sbc.inode_fsuid_setasbuh1hhj"ubj2)}(h h]h }(hj"hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj"ubj)}(hjh]h*}(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"ubjI)}(hinodeh]hinode}(hj"hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj"ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj"ubjC)}(hconst struct mnt_idmap *idmaph](j )}(hjJh]hconst}(hj#hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj"ubj2)}(h h]h }(hj#hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj"ubj )}(hjh]hstruct}(hj#hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj"ubj2)}(h h]h }(hj*#hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj"ubh)}(hhh]jI)}(h mnt_idmaph]h mnt_idmap}(hj;#hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj8#ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj=#modnameN classnameNjj )}j ]j"c.inode_fsuid_setasbuh1hhj"ubj2)}(h h]h }(hjY#hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj"ubj)}(hjh]h*}(hjg#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"ubjI)}(hidmaph]hidmap}(hjt#hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj"ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj"ubeh}(h]h ]h"]h$]h&]j`jauh1j<hjO"hhhja"hMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjK"hhhja"hMubah}(h]jF"ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhja"hMhjH"hhubjw)}(hhh]h)}(h1initialize inode's i_uid field with callers fsuidh]h3initialize inode’s i_uid field with callers fsuid}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhj#hhubah}(h]h ]h"]h$]h&]uh1jvhjH"hhhja"hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjj#jj#jjjuh1jhhhhhNhNubj)}(hX-**Parameters** ``struct inode *inode`` inode to initialize ``const struct mnt_idmap *idmap`` idmap of the mount the inode was found from **Description** Initialize the i_uid field of **inode**. If the inode was found/created via an idmapped mount map the caller's fsuid according to **idmap**.h](h)}(h**Parameters**h]j)}(hj#h]h Parameters}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj#ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM hj#ubj)}(hhh](j)}(h,``struct inode *inode`` inode to initialize h](j)}(h``struct inode *inode``h]j)}(hj#h]hstruct inode *inode}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj#ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhj#ubj)}(hhh]h)}(hinode to initializeh]hinode to initialize}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj#hMhj#ubah}(h]h ]h"]h$]h&]uh1jhj#ubeh}(h]h ]h"]h$]h&]uh1jhj#hMhj#ubj)}(hN``const struct mnt_idmap *idmap`` idmap of the mount the inode was found from h](j)}(h!``const struct mnt_idmap *idmap``h]j)}(hj$h]hconst struct mnt_idmap *idmap}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj$ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhj$ubj)}(hhh]h)}(h+idmap of the mount the inode was found fromh]h+idmap of the mount the inode was found from}(hj1$hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj-$hMhj.$ubah}(h]h ]h"]h$]h&]uh1jhj$ubeh}(h]h ]h"]h$]h&]uh1jhj-$hMhj#ubeh}(h]h ]h"]h$]h&]uh1jhj#ubh)}(h**Description**h]j)}(hjS$h]h Description}(hjU$hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjQ$ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM hj#ubh)}(hInitialize the i_uid field of **inode**. If the inode was found/created via an idmapped mount map the caller's fsuid according to **idmap**.h](hInitialize the i_uid field of }(hji$hhhNhNubj)}(h **inode**h]hinode}(hjq$hhhNhNubah}(h]h ]h"]h$]h&]uh1jhji$ubh]. If the inode was found/created via an idmapped mount map the caller’s fsuid according to }(hji$hhhNhNubj)}(h **idmap**h]hidmap}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jhji$ubh.}(hji$hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhj#ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j inode_fsgid_set (C function)c.inode_fsgid_sethNtauh1hhhhhhNhNubj)}(hhh](j)}(hIvoid inode_fsgid_set (struct inode *inode, const struct mnt_idmap *idmap)h]j)}(hHvoid inode_fsgid_set(struct inode *inode, const struct mnt_idmap *idmap)h](j)}(hvoidh]hvoid}(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$hhhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMubj2)}(h h]h }(hj$hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj$hhhj$hMubjC)}(hinode_fsgid_seth]jI)}(hinode_fsgid_seth]hinode_fsgid_set}(hj$hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj$ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj$hhhj$hMubj=)}(h4(struct inode *inode, const struct mnt_idmap *idmap)h](jC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hj$hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj$ubj2)}(h h]h }(hj%hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj$ubh)}(hhh]jI)}(hinodeh]hinode}(hj%hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj%ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj%modnameN classnameNjj )}j ]j)}jj$sbc.inode_fsgid_setasbuh1hhj$ubj2)}(h h]h }(hj7%hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj$ubj)}(hjh]h*}(hjE%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$ubjI)}(hinodeh]hinode}(hjR%hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj$ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj$ubjC)}(hconst struct mnt_idmap *idmaph](j )}(hjJh]hconst}(hjk%hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjg%ubj2)}(h h]h }(hjx%hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjg%ubj )}(hjh]hstruct}(hj%hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjg%ubj2)}(h h]h }(hj%hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjg%ubh)}(hhh]jI)}(h mnt_idmaph]h mnt_idmap}(hj%hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj%ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj%modnameN classnameNjj )}j ]j3%c.inode_fsgid_setasbuh1hhjg%ubj2)}(h h]h }(hj%hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjg%ubj)}(hjh]h*}(hj%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjg%ubjI)}(hidmaph]hidmap}(hj%hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjg%ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj$ubeh}(h]h ]h"]h$]h&]j`jauh1j<hj$hhhj$hMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj$hhhj$hMubah}(h]j$ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj$hMhj$hhubjw)}(hhh]h)}(h1initialize inode's i_gid field with callers fsgidh]h3initialize inode’s i_gid field with callers fsgid}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhj&hhubah}(h]h ]h"]h$]h&]uh1jvhj$hhhj$hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjj&jj&jjjuh1jhhhhhNhNubj)}(hX-**Parameters** ``struct inode *inode`` inode to initialize ``const struct mnt_idmap *idmap`` idmap of the mount the inode was found from **Description** Initialize the i_gid field of **inode**. If the inode was found/created via an idmapped mount map the caller's fsgid according to **idmap**.h](h)}(h**Parameters**h]j)}(hj)&h]h Parameters}(hj+&hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj'&ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhj#&ubj)}(hhh](j)}(h,``struct inode *inode`` inode to initialize h](j)}(h``struct inode *inode``h]j)}(hjH&h]hstruct inode *inode}(hjJ&hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjF&ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjB&ubj)}(hhh]h)}(hinode to initializeh]hinode to initialize}(hja&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj]&hMhj^&ubah}(h]h ]h"]h$]h&]uh1jhjB&ubeh}(h]h ]h"]h$]h&]uh1jhj]&hMhj?&ubj)}(hN``const struct mnt_idmap *idmap`` idmap of the mount the inode was found from h](j)}(h!``const struct mnt_idmap *idmap``h]j)}(hj&h]hconst struct mnt_idmap *idmap}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj&ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhj{&ubj)}(hhh]h)}(h+idmap of the mount the inode was found fromh]h+idmap of the mount the inode was found from}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj&hMhj&ubah}(h]h ]h"]h$]h&]uh1jhj{&ubeh}(h]h ]h"]h$]h&]uh1jhj&hMhj?&ubeh}(h]h ]h"]h$]h&]uh1jhj#&ubh)}(h**Description**h]j)}(hj&h]h Description}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj&ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhj#&ubh)}(hInitialize the i_gid field of **inode**. If the inode was found/created via an idmapped mount map the caller's fsgid according to **idmap**.h](hInitialize the i_gid field of }(hj&hhhNhNubj)}(h **inode**h]hinode}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj&ubh]. If the inode was found/created via an idmapped mount map the caller’s fsgid according to }(hj&hhhNhNubj)}(h **idmap**h]hidmap}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj&ubh.}(hj&hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhj#&ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j !fsuidgid_has_mapping (C function)c.fsuidgid_has_mappinghNtauh1hhhhhhNhNubj)}(hhh](j)}(hQbool fsuidgid_has_mapping (struct super_block *sb, const struct mnt_idmap *idmap)h]j)}(hPbool fsuidgid_has_mapping(struct super_block *sb, const struct mnt_idmap *idmap)h](j)}(hjh]hbool}(hj%'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!'hhhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM!ubj2)}(h h]h }(hj3'hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj!'hhhj2'hM!ubjC)}(hfsuidgid_has_mappingh]jI)}(hfsuidgid_has_mappingh]hfsuidgid_has_mapping}(hjE'hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjA'ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj!'hhhj2'hM!ubj=)}(h7(struct super_block *sb, const struct mnt_idmap *idmap)h](jC)}(hstruct super_block *sbh](j )}(hjh]hstruct}(hja'hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj]'ubj2)}(h h]h }(hjn'hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj]'ubh)}(hhh]jI)}(h super_blockh]h super_block}(hj'hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj|'ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj'modnameN classnameNjj )}j ]j)}jjG'sbc.fsuidgid_has_mappingasbuh1hhj]'ubj2)}(h h]h }(hj'hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj]'ubj)}(hjh]h*}(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj]'ubjI)}(hsbh]hsb}(hj'hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj]'ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjY'ubjC)}(hconst struct mnt_idmap *idmaph](j )}(hjJh]hconst}(hj'hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj'ubj2)}(h h]h }(hj'hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj'ubj )}(hjh]hstruct}(hj'hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj'ubj2)}(h h]h }(hj'hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj'ubh)}(hhh]jI)}(h mnt_idmaph]h mnt_idmap}(hj (hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj (ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj(modnameN classnameNjj )}j ]j'c.fsuidgid_has_mappingasbuh1hhj'ubj2)}(h h]h }(hj*(hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj'ubj)}(hjh]h*}(hj8(hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj'ubjI)}(hidmaph]hidmap}(hjE(hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj'ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjY'ubeh}(h]h ]h"]h$]h&]j`jauh1j<hj!'hhhj2'hM!ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj'hhhj2'hM!ubah}(h]j'ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj2'hM!hj'hhubjw)}(hhh]h)}(h,check whether caller's fsuid/fsgid is mappedh]h.check whether caller’s fsuid/fsgid is mapped}(hjo(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM!hjl(hhubah}(h]h ]h"]h$]h&]uh1jvhj'hhhj2'hM!ubeh}(h]h ](jfunctioneh"]h$]h&]jjjj(jj(jjjuh1jhhhhhNhNubj)}(hX**Parameters** ``struct super_block *sb`` the superblock we want a mapping in ``const struct mnt_idmap *idmap`` idmap of the relevant mount **Description** Check whether the caller's fsuid and fsgid have a valid mapping in the s_user_ns of the superblock **sb**. If the caller is on an idmapped mount map the caller's fsuid and fsgid according to the **idmap** first. **Return** true if fsuid and fsgid is mapped, false if not.h](h)}(h**Parameters**h]j)}(hj(h]h Parameters}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj(ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM%hj(ubj)}(hhh](j)}(h?``struct super_block *sb`` the superblock we want a mapping in h](j)}(h``struct super_block *sb``h]j)}(hj(h]hstruct super_block *sb}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj(ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM"hj(ubj)}(hhh]h)}(h#the superblock we want a mapping inh]h#the superblock we want a mapping in}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj(hM"hj(ubah}(h]h ]h"]h$]h&]uh1jhj(ubeh}(h]h ]h"]h$]h&]uh1jhj(hM"hj(ubj)}(h>``const struct mnt_idmap *idmap`` idmap of the relevant mount h](j)}(h!``const struct mnt_idmap *idmap``h]j)}(hj(h]hconst struct mnt_idmap *idmap}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj(ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM#hj(ubj)}(hhh]h)}(hidmap of the relevant mounth]hidmap of the relevant mount}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj(hM#hj(ubah}(h]h ]h"]h$]h&]uh1jhj(ubeh}(h]h ]h"]h$]h&]uh1jhj(hM#hj(ubeh}(h]h ]h"]h$]h&]uh1jhj(ubh)}(h**Description**h]j)}(hj$)h]h Description}(hj&)hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj")ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM%hj(ubh)}(hCheck whether the caller's fsuid and fsgid have a valid mapping in the s_user_ns of the superblock **sb**. If the caller is on an idmapped mount map the caller's fsuid and fsgid according to the **idmap** first.h](heCheck whether the caller’s fsuid and fsgid have a valid mapping in the s_user_ns of the superblock }(hj:)hhhNhNubj)}(h**sb**h]hsb}(hjB)hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj:)ubh\. If the caller is on an idmapped mount map the caller’s fsuid and fsgid according to the }(hj:)hhhNhNubj)}(h **idmap**h]hidmap}(hjT)hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj:)ubh first.}(hj:)hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM$hj(ubh)}(h **Return**h]j)}(hjo)h]hReturn}(hjq)hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjm)ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM(hj(ubh)}(h0true if fsuid and fsgid is mapped, false if not.h]h0true if fsuid and fsgid is mapped, false if not.}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM)hj(ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j inode_set_ctime (C function)c.inode_set_ctimehNtauh1hhhhhhNhNubj)}(hhh](j)}(hPstruct timespec64 inode_set_ctime (struct inode *inode, time64_t sec, long nsec)h]j)}(hOstruct timespec64 inode_set_ctime(struct inode *inode, time64_t sec, long nsec)h](j )}(hjh]hstruct}(hj)hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj)hhhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMubj2)}(h h]h }(hj)hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj)hhhj)hMubh)}(hhh]jI)}(h timespec64h]h timespec64}(hj)hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj)ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj)modnameN classnameNjj )}j ]j)}jinode_set_ctimesbc.inode_set_ctimeasbuh1hhj)hhhj)hMubj2)}(h h]h }(hj)hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj)hhhj)hMubjC)}(hinode_set_ctimeh]jI)}(hj)h]hinode_set_ctime}(hj*hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj*ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj)hhhj)hMubj=)}(h.(struct inode *inode, time64_t sec, long nsec)h](jC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hj!*hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj*ubj2)}(h h]h }(hj.*hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj*ubh)}(hhh]jI)}(hinodeh]hinode}(hj?*hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj<*ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjA*modnameN classnameNjj )}j ]j)c.inode_set_ctimeasbuh1hhj*ubj2)}(h h]h }(hj]*hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj*ubj)}(hjh]h*}(hjk*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*ubjI)}(hinodeh]hinode}(hjx*hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj*ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj*ubjC)}(h time64_t sech](h)}(hhh]jI)}(htime64_th]htime64_t}(hj*hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj*ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj*modnameN classnameNjj )}j ]j)c.inode_set_ctimeasbuh1hhj*ubj2)}(h h]h }(hj*hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj*ubjI)}(hsech]hsec}(hj*hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj*ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj*ubjC)}(h long nsech](j)}(hlongh]hlong}(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*ubj2)}(h h]h }(hj*hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj*ubjI)}(hnsech]hnsec}(hj*hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj*ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj*ubeh}(h]h ]h"]h$]h&]j`jauh1j<hj)hhhj)hMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj)hhhj)hMubah}(h]j)ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj)hMhj)hhubjw)}(hhh]h)}(hset the ctime in the inodeh]hset the ctime in the inode}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhj+hhubah}(h]h ]h"]h$]h&]uh1jvhj)hhhj)hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjj7+jj7+jjjuh1jhhhhhNhNubj)}(h**Parameters** ``struct inode *inode`` inode in which to set the ctime ``time64_t sec`` tv_sec value to set ``long nsec`` tv_nsec value to set **Description** Set the ctime in **inode** to { **sec**, **nsec** }h](h)}(h**Parameters**h]j)}(hjA+h]h Parameters}(hjC+hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj?+ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhj;+ubj)}(hhh](j)}(h8``struct inode *inode`` inode in which to set the ctime h](j)}(h``struct inode *inode``h]j)}(hj`+h]hstruct inode *inode}(hjb+hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj^+ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjZ+ubj)}(hhh]h)}(hinode in which to set the ctimeh]hinode in which to set the ctime}(hjy+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhju+hMhjv+ubah}(h]h ]h"]h$]h&]uh1jhjZ+ubeh}(h]h ]h"]h$]h&]uh1jhju+hMhjW+ubj)}(h%``time64_t sec`` tv_sec value to set h](j)}(h``time64_t sec``h]j)}(hj+h]h time64_t sec}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj+ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhj+ubj)}(hhh]h)}(htv_sec value to seth]htv_sec value to set}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj+hMhj+ubah}(h]h ]h"]h$]h&]uh1jhj+ubeh}(h]h ]h"]h$]h&]uh1jhj+hMhjW+ubj)}(h#``long nsec`` tv_nsec value to set h](j)}(h ``long nsec``h]j)}(hj+h]h long nsec}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj+ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhj+ubj)}(hhh]h)}(htv_nsec value to seth]htv_nsec value to set}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj+hMhj+ubah}(h]h ]h"]h$]h&]uh1jhj+ubeh}(h]h ]h"]h$]h&]uh1jhj+hMhjW+ubeh}(h]h ]h"]h$]h&]uh1jhj;+ubh)}(h**Description**h]j)}(hj ,h]h Description}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ,ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhj;+ubh)}(h3Set the ctime in **inode** to { **sec**, **nsec** }h](hSet the ctime in }(hj#,hhhNhNubj)}(h **inode**h]hinode}(hj+,hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj#,ubh to { }(hj#,hhhNhNubj)}(h**sec**h]hsec}(hj=,hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj#,ubh, }(hj#,hhhNhNubj)}(h**nsec**h]hnsec}(hjO,hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj#,ubh }}(hj#,hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhj;+ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j file_write_started (C function)c.file_write_startedhNtauh1hhhhhhNhNubj)}(hhh](j)}(h1bool file_write_started (const struct file *file)h]j)}(h0bool file_write_started(const struct file *file)h](j)}(hjh]hbool}(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,hhhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMubj2)}(h h]h }(hj,hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj,hhhj,hMubjC)}(hfile_write_startedh]jI)}(hfile_write_startedh]hfile_write_started}(hj,hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj,ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj,hhhj,hMubj=)}(h(const struct file *file)h]jC)}(hconst struct file *fileh](j )}(hjJh]hconst}(hj,hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj,ubj2)}(h h]h }(hj,hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj,ubj )}(hjh]hstruct}(hj,hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj,ubj2)}(h h]h }(hj,hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj,ubh)}(hhh]jI)}(hfileh]hfile}(hj,hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj,ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj,modnameN classnameNjj )}j ]j)}jj,sbc.file_write_startedasbuh1hhj,ubj2)}(h h]h }(hj-hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj,ubj)}(hjh]h*}(hj+-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,ubjI)}(hfileh]hfile}(hj8-hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj,ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj,ubah}(h]h ]h"]h$]h&]j`jauh1j<hj,hhhj,hMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj,hhhj,hMubah}(h]j{,ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj,hMhj},hhubjw)}(hhh]h)}(h check if SB_FREEZE_WRITE is heldh]h check if SB_FREEZE_WRITE is held}(hjb-hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhj_-hhubah}(h]h ]h"]h$]h&]uh1jvhj},hhhj,hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjz-jjz-jjjuh1jhhhhhNhNubj)}(h**Parameters** ``const struct file *file`` the file we write to **Description** May be false positive with !CONFIG_LOCKDEP/LOCK_STATE_UNKNOWN. May be false positive with !S_ISREG, because file_start_write() has no effect on !S_ISREG.h](h)}(h**Parameters**h]j)}(hj-h]h Parameters}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj-ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhj~-ubj)}(hhh]j)}(h1``const struct file *file`` the file we write to h](j)}(h``const struct file *file``h]j)}(hj-h]hconst struct file *file}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj-ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhj-ubj)}(hhh]h)}(hthe file we write toh]hthe file we write to}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj-hMhj-ubah}(h]h ]h"]h$]h&]uh1jhj-ubeh}(h]h ]h"]h$]h&]uh1jhj-hMhj-ubah}(h]h ]h"]h$]h&]uh1jhj~-ubh)}(h**Description**h]j)}(hj-h]h Description}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj-ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhj~-ubh)}(hMay be false positive with !CONFIG_LOCKDEP/LOCK_STATE_UNKNOWN. May be false positive with !S_ISREG, because file_start_write() has no effect on !S_ISREG.h]hMay be false positive with !CONFIG_LOCKDEP/LOCK_STATE_UNKNOWN. May be false positive with !S_ISREG, because file_start_write() has no effect on !S_ISREG.}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhj~-ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j #file_write_not_started (C function)c.file_write_not_startedhNtauh1hhhhhhNhNubj)}(hhh](j)}(h5bool file_write_not_started (const struct file *file)h]j)}(h4bool file_write_not_started(const struct file *file)h](j)}(hjh]hbool}(hj#.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj.hhhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMubj2)}(h h]h }(hj1.hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj.hhhj0.hMubjC)}(hfile_write_not_startedh]jI)}(hfile_write_not_startedh]hfile_write_not_started}(hjC.hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj?.ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj.hhhj0.hMubj=)}(h(const struct file *file)h]jC)}(hconst struct file *fileh](j )}(hjJh]hconst}(hj_.hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj[.ubj2)}(h h]h }(hjl.hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj[.ubj )}(hjh]hstruct}(hjz.hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj[.ubj2)}(h h]h }(hj.hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj[.ubh)}(hhh]jI)}(hfileh]hfile}(hj.hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj.ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj.modnameN classnameNjj )}j ]j)}jjE.sbc.file_write_not_startedasbuh1hhj[.ubj2)}(h h]h }(hj.hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj[.ubj)}(hjh]h*}(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj[.ubjI)}(hfileh]hfile}(hj.hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj[.ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjW.ubah}(h]h ]h"]h$]h&]j`jauh1j<hj.hhhj0.hMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj.hhhj0.hMubah}(h]j.ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj0.hMhj.hhubjw)}(hhh]h)}(h$check if SB_FREEZE_WRITE is not heldh]h$check if SB_FREEZE_WRITE is not held}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhj.hhubah}(h]h ]h"]h$]h&]uh1jvhj.hhhj0.hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjj/jj/jjjuh1jhhhhhNhNubj)}(h**Parameters** ``const struct file *file`` the file we write to **Description** May be false positive with !CONFIG_LOCKDEP/LOCK_STATE_UNKNOWN. May be false positive with !S_ISREG, because file_start_write() has no effect on !S_ISREG.h](h)}(h**Parameters**h]j)}(hj/h]h Parameters}(hj!/hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj/ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhj/ubj)}(hhh]j)}(h1``const struct file *file`` the file we write to h](j)}(h``const struct file *file``h]j)}(hj>/h]hconst struct file *file}(hj@/hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjah"]h$]h&]uh1j1hj/hhhj/hMubjC)}(h renamedatah]jI)}(hj/h]h renamedata}(hj/hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj/ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj/hhhj/hMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj/hhhj/hMubah}(h]j/ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj/hMhj/hhubjw)}(hhh]h)}(h.contains all information required for renamingh]h.contains all information required for renaming}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhj/hhubah}(h]h ]h"]h$]h&]uh1jvhj/hhhj/hMubeh}(h]h ](jstructeh"]h$]h&]jjjj0jj0jjjuh1jhhhhhNhNubj)}(hXT**Definition**:: struct renamedata { const struct mnt_idmap *mnt_idmap; struct dentry *old_parent; struct dentry *old_dentry; struct dentry *new_parent; struct dentry *new_dentry; struct delegated_inode *delegated_inode; unsigned int flags; }; **Members** ``mnt_idmap`` idmap of the mount in which the rename is happening. ``old_parent`` parent of source ``old_dentry`` source ``new_parent`` parent of destination ``new_dentry`` destination ``delegated_inode`` returns an inode needing a delegation break ``flags`` rename flagsh](h)}(h**Definition**::h](j)}(h**Definition**h]h Definition}(hj$0hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj 0ubh:}(hj 0hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhj0ubj )}(hstruct renamedata { const struct mnt_idmap *mnt_idmap; struct dentry *old_parent; struct dentry *old_dentry; struct dentry *new_parent; struct dentry *new_dentry; struct delegated_inode *delegated_inode; unsigned int flags; };h]hstruct renamedata { const struct mnt_idmap *mnt_idmap; struct dentry *old_parent; struct dentry *old_dentry; struct dentry *new_parent; struct dentry *new_dentry; struct delegated_inode *delegated_inode; unsigned int flags; };}hj=0sbah}(h]h ]h"]h$]h&]j`jauh1j hZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhj0ubh)}(h **Members**h]j)}(hjN0h]hMembers}(hjP0hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjL0ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhj0ubj)}(hhh](j)}(hC``mnt_idmap`` idmap of the mount in which the rename is happening. h](j)}(h ``mnt_idmap``h]j)}(hjm0h]h mnt_idmap}(hjo0hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjk0ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjg0ubj)}(hhh]h)}(h4idmap of the mount in which the rename is happening.h]h4idmap of the mount in which the rename is happening.}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj0hMhj0ubah}(h]h ]h"]h$]h&]uh1jhjg0ubeh}(h]h ]h"]h$]h&]uh1jhj0hMhjd0ubj)}(h ``old_parent`` parent of source h](j)}(h``old_parent``h]j)}(hj0h]h old_parent}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj0ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhj0ubj)}(hhh]h)}(hparent of sourceh]hparent of source}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj0hMhj0ubah}(h]h ]h"]h$]h&]uh1jhj0ubeh}(h]h ]h"]h$]h&]uh1jhj0hMhjd0ubj)}(h``old_dentry`` source h](j)}(h``old_dentry``h]j)}(hj0h]h old_dentry}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj0ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhj0ubj)}(hhh]h)}(hsourceh]hsource}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj0hMhj0ubah}(h]h ]h"]h$]h&]uh1jhj0ubeh}(h]h ]h"]h$]h&]uh1jhj0hMhjd0ubj)}(h%``new_parent`` parent of destination h](j)}(h``new_parent``h]j)}(hj1h]h new_parent}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj1ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhj1ubj)}(hhh]h)}(hparent of destinationh]hparent of destination}(hj11hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj-1hMhj.1ubah}(h]h ]h"]h$]h&]uh1jhj1ubeh}(h]h ]h"]h$]h&]uh1jhj-1hMhjd0ubj)}(h``new_dentry`` destination h](j)}(h``new_dentry``h]j)}(hjQ1h]h new_dentry}(hjS1hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjO1ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhjK1ubj)}(hhh]h)}(h destinationh]h destination}(hjj1hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjf1hMhjg1ubah}(h]h ]h"]h$]h&]uh1jhjK1ubeh}(h]h ]h"]h$]h&]uh1jhjf1hMhjd0ubj)}(h@``delegated_inode`` returns an inode needing a delegation break h](j)}(h``delegated_inode``h]j)}(hj1h]hdelegated_inode}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj1ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhj1ubj)}(hhh]h)}(h+returns an inode needing a delegation breakh]h+returns an inode needing a delegation break}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj1hMhj1ubah}(h]h ]h"]h$]h&]uh1jhj1ubeh}(h]h ]h"]h$]h&]uh1jhj1hMhjd0ubj)}(h``flags`` rename flagsh](j)}(h ``flags``h]j)}(hj1h]hflags}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj1ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhj1ubj)}(hhh]h)}(h rename flagsh]h rename flags}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMhj1ubah}(h]h ]h"]h$]h&]uh1jhj1ubeh}(h]h ]h"]h$]h&]uh1jhj1hMhjd0ubeh}(h]h ]h"]h$]h&]uh1jhj0ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j is_mgtime (C function) c.is_mgtimehNtauh1hhhhhhNhNubj)}(hhh](j)}(h*bool is_mgtime (const struct inode *inode)h]j)}(h)bool is_mgtime(const struct inode *inode)h](j)}(hjh]hbool}(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2hhhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM ubj2)}(h h]h }(hj+2hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj2hhhj*2hM ubjC)}(h is_mgtimeh]jI)}(h is_mgtimeh]h is_mgtime}(hj=2hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj92ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj2hhhj*2hM ubj=)}(h(const struct inode *inode)h]jC)}(hconst struct inode *inodeh](j )}(hjJh]hconst}(hjY2hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjU2ubj2)}(h h]h }(hjf2hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjU2ubj )}(hjh]hstruct}(hjt2hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjU2ubj2)}(h h]h }(hj2hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjU2ubh)}(hhh]jI)}(hinodeh]hinode}(hj2hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj2ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj2modnameN classnameNjj )}j ]j)}jj?2sb c.is_mgtimeasbuh1hhjU2ubj2)}(h h]h }(hj2hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjU2ubj)}(hjh]h*}(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjU2ubjI)}(hinodeh]hinode}(hj2hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjU2ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjQ2ubah}(h]h ]h"]h$]h&]j`jauh1j<hj2hhhj*2hM ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj2hhhj*2hM ubah}(h]j2ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj*2hM hj2hhubjw)}(hhh]h)}(h)is this inode using multigrain timestampsh]h)is this inode using multigrain timestamps}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM hj2hhubah}(h]h ]h"]h$]h&]uh1jvhj2hhhj*2hM ubeh}(h]h ](jfunctioneh"]h$]h&]jjjj3jj3jjjuh1jhhhhhNhNubj)}(h**Parameters** ``const struct inode *inode`` inode to test for multigrain timestamps **Description** Return true if the inode uses multigrain timestamps, false otherwise.h](h)}(h**Parameters**h]j)}(hj3h]h Parameters}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj3ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM hj3ubj)}(hhh]j)}(hF``const struct inode *inode`` inode to test for multigrain timestamps h](j)}(h``const struct inode *inode``h]j)}(hj83h]hconst struct inode *inode}(hj:3hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj63ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM hj23ubj)}(hhh]h)}(h'inode to test for multigrain timestampsh]h'inode to test for multigrain timestamps}(hjQ3hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjM3hM hjN3ubah}(h]h ]h"]h$]h&]uh1jhj23ubeh}(h]h ]h"]h$]h&]uh1jhjM3hM hj/3ubah}(h]h ]h"]h$]h&]uh1jhj3ubh)}(h**Description**h]j)}(hjs3h]h Description}(hju3hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjq3ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM hj3ubh)}(hEReturn true if the inode uses multigrain timestamps, false otherwise.h]hEReturn true if the inode uses multigrain timestamps, false otherwise.}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM hj3ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j iput_if_not_last (C function)c.iput_if_not_lasthNtauh1hhhhhhNhNubj)}(hhh](j)}(h+bool iput_if_not_last (struct inode *inode)h]j)}(h*bool iput_if_not_last(struct inode *inode)h](j)}(hjh]hbool}(hj3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3hhhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM ubj2)}(h h]h }(hj3hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj3hhhj3hM ubjC)}(hiput_if_not_lasth]jI)}(hiput_if_not_lasth]hiput_if_not_last}(hj3hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj3ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj3hhhj3hM ubj=)}(h(struct inode *inode)h]jC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hj3hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj3ubj2)}(h h]h }(hj4hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj3ubh)}(hhh]jI)}(hinodeh]hinode}(hj4hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj4ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj4modnameN classnameNjj )}j ]j)}jj3sbc.iput_if_not_lastasbuh1hhj3ubj2)}(h h]h }(hj24hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj3ubj)}(hjh]h*}(hj@4hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3ubjI)}(hinodeh]hinode}(hjM4hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj3ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj3ubah}(h]h ]h"]h$]h&]j`jauh1j<hj3hhhj3hM ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj3hhhj3hM ubah}(h]j3ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj3hM hj3hhubjw)}(hhh]h)}(h6drop an inode reference only if it is not the last oneh]h6drop an inode reference only if it is not the last one}(hjw4hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM hjt4hhubah}(h]h ]h"]h$]h&]uh1jvhj3hhhj3hM ubeh}(h]h ](jfunctioneh"]h$]h&]jjjj4jj4jjjuh1jhhhhhNhNubj)}(h**Parameters** ``struct inode *inode`` inode to put **Description** Returns true if the reference was dropped, false if this was the last reference and the caller must arrange for final iput() in a safe context.h](h)}(h**Parameters**h]j)}(hj4h]h Parameters}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj4ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM hj4ubj)}(hhh]j)}(h%``struct inode *inode`` inode to put h](j)}(h``struct inode *inode``h]j)}(hj4h]hstruct inode *inode}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj4ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM hj4ubj)}(hhh]h)}(h inode to puth]h inode to put}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj4hM hj4ubah}(h]h ]h"]h$]h&]uh1jhj4ubeh}(h]h ]h"]h$]h&]uh1jhj4hM hj4ubah}(h]h ]h"]h$]h&]uh1jhj4ubh)}(h**Description**h]j)}(hj4h]h Description}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj4ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM hj4ubh)}(hReturns true if the reference was dropped, false if this was the last reference and the caller must arrange for final iput() in a safe context.h]hReturns true if the reference was dropped, false if this was the last reference and the caller must arrange for final iput() in a safe context.}(hj 5hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM hj4ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j is_idmapped_mnt (C function)c.is_idmapped_mnthNtauh1hhhhhhNhNubj)}(hhh](j)}(h1bool is_idmapped_mnt (const struct vfsmount *mnt)h]j)}(h0bool is_idmapped_mnt(const struct vfsmount *mnt)h](j)}(hjh]hbool}(hj85hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj45hhhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM ubj2)}(h h]h }(hjF5hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj45hhhjE5hM ubjC)}(his_idmapped_mnth]jI)}(his_idmapped_mnth]his_idmapped_mnt}(hjX5hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjT5ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj45hhhjE5hM ubj=)}(h(const struct vfsmount *mnt)h]jC)}(hconst struct vfsmount *mnth](j )}(hjJh]hconst}(hjt5hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjp5ubj2)}(h h]h }(hj5hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjp5ubj )}(hjh]hstruct}(hj5hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjp5ubj2)}(h h]h }(hj5hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjp5ubh)}(hhh]jI)}(hvfsmounth]hvfsmount}(hj5hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj5ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj5modnameN classnameNjj )}j ]j)}jjZ5sbc.is_idmapped_mntasbuh1hhjp5ubj2)}(h h]h }(hj5hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjp5ubj)}(hjh]h*}(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjp5ubjI)}(hmnth]hmnt}(hj5hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjp5ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjl5ubah}(h]h ]h"]h$]h&]j`jauh1j<hj45hhhjE5hM ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj05hhhjE5hM ubah}(h]j+5ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjE5hM hj-5hhubjw)}(hhh]h)}(hcheck whether a mount is mappedh]hcheck whether a mount is mapped}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM hj6hhubah}(h]h ]h"]h$]h&]uh1jvhj-5hhhjE5hM ubeh}(h]h ](jfunctioneh"]h$]h&]jjjj*6jj*6jjjuh1jhhhhhNhNubj)}(h**Parameters** ``const struct vfsmount *mnt`` the mount to check **Description** If **mnt** has an non **nop_mnt_idmap** attached to it then **mnt** is mapped. **Return** true if mount is mapped, false if not.h](h)}(h**Parameters**h]j)}(hj46h]h Parameters}(hj66hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj26ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM hj.6ubj)}(hhh]j)}(h2``const struct vfsmount *mnt`` the mount to check h](j)}(h``const struct vfsmount *mnt``h]j)}(hjS6h]hconst struct vfsmount *mnt}(hjU6hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjQ6ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM hjM6ubj)}(hhh]h)}(hthe mount to checkh]hthe mount to check}(hjl6hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjh6hM hji6ubah}(h]h ]h"]h$]h&]uh1jhjM6ubeh}(h]h ]h"]h$]h&]uh1jhjh6hM hjJ6ubah}(h]h ]h"]h$]h&]uh1jhj.6ubh)}(h**Description**h]j)}(hj6h]h Description}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj6ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM hj.6ubh)}(hNIf **mnt** has an non **nop_mnt_idmap** attached to it then **mnt** is mapped.h](hIf }(hj6hhhNhNubj)}(h**mnt**h]hmnt}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj6ubh has an non }(hj6hhhNhNubj)}(h**nop_mnt_idmap**h]h nop_mnt_idmap}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj6ubh attached to it then }(hj6hhhNhNubj)}(h**mnt**h]hmnt}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj6ubh is mapped.}(hj6hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM hj.6ubh)}(h **Return**h]j)}(hj6h]hReturn}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj6ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM hj.6ubh)}(h&true if mount is mapped, false if not.h]h&true if mount is mapped, false if not.}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM hj.6ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j file_start_write (C function)c.file_start_writehNtauh1hhhhhhNhNubj)}(hhh](j)}(h)void file_start_write (struct file *file)h]j)}(h(void file_start_write(struct file *file)h](j)}(hvoidh]hvoid}(hj07hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,7hhhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM ubj2)}(h h]h }(hj?7hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj,7hhhj>7hM ubjC)}(hfile_start_writeh]jI)}(hfile_start_writeh]hfile_start_write}(hjQ7hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjM7ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj,7hhhj>7hM ubj=)}(h(struct file *file)h]jC)}(hstruct file *fileh](j )}(hjh]hstruct}(hjm7hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhji7ubj2)}(h h]h }(hjz7hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hji7ubh)}(hhh]jI)}(hfileh]hfile}(hj7hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj7ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj7modnameN classnameNjj )}j ]j)}jjS7sbc.file_start_writeasbuh1hhji7ubj2)}(h h]h }(hj7hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hji7ubj)}(hjh]h*}(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhji7ubjI)}(hfileh]hfile}(hj7hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhji7ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhje7ubah}(h]h ]h"]h$]h&]j`jauh1j<hj,7hhhj>7hM ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj(7hhhj>7hM ubah}(h]j#7ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj>7hM hj%7hhubjw)}(hhh]h)}(h4get write access to a superblock for regular file ioh]h4get write access to a superblock for regular file io}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM hj7hhubah}(h]h ]h"]h$]h&]uh1jvhj%7hhhj>7hM ubeh}(h]h ](jfunctioneh"]h$]h&]jjjj8jj8jjjuh1jhhhhhNhNubj)}(h**Parameters** ``struct file *file`` the file we want to write to **Description** This is a variant of sb_start_write() which is a noop on non-regular file. Should be matched with a call to file_end_write().h](h)}(h**Parameters**h]j)}(hj8h]h Parameters}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj8ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM hj 8ubj)}(hhh]j)}(h3``struct file *file`` the file we want to write to h](j)}(h``struct file *file``h]j)}(hj18h]hstruct file *file}(hj38hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj/8ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM hj+8ubj)}(hhh]h)}(hthe file we want to write toh]hthe file we want to write to}(hjJ8hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjF8hM hjG8ubah}(h]h ]h"]h$]h&]uh1jhj+8ubeh}(h]h ]h"]h$]h&]uh1jhjF8hM hj(8ubah}(h]h ]h"]h$]h&]uh1jhj 8ubh)}(h**Description**h]j)}(hjl8h]h Description}(hjn8hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjj8ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM hj 8ubh)}(h}This is a variant of sb_start_write() which is a noop on non-regular file. Should be matched with a call to file_end_write().h]h}This is a variant of sb_start_write() which is a noop on non-regular file. Should be matched with a call to file_end_write().}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM hj 8ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j file_end_write (C function)c.file_end_writehNtauh1hhhhhhNhNubj)}(hhh](j)}(h'void file_end_write (struct file *file)h]j)}(h&void file_end_write(struct file *file)h](j)}(hvoidh]hvoid}(hj8hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj8hhhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM ubj2)}(h h]h }(hj8hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj8hhhj8hM ubjC)}(hfile_end_writeh]jI)}(hfile_end_writeh]hfile_end_write}(hj8hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj8ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj8hhhj8hM ubj=)}(h(struct file *file)h]jC)}(hstruct file *fileh](j )}(hjh]hstruct}(hj8hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj8ubj2)}(h h]h }(hj8hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj8ubh)}(hhh]jI)}(hfileh]hfile}(hj 9hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj 9ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj9modnameN classnameNjj )}j ]j)}jj8sbc.file_end_writeasbuh1hhj8ubj2)}(h h]h }(hj,9hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj8ubj)}(hjh]h*}(hj:9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj8ubjI)}(hfileh]hfile}(hjG9hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj8ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj8ubah}(h]h ]h"]h$]h&]j`jauh1j<hj8hhhj8hM ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj8hhhj8hM ubah}(h]j8ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj8hM hj8hhubjw)}(hhh]h)}(h3drop write access to a superblock of a regular fileh]h3drop write access to a superblock of a regular file}(hjq9hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM hjn9hhubah}(h]h ]h"]h$]h&]uh1jvhj8hhhj8hM ubeh}(h]h ](jfunctioneh"]h$]h&]jjjj9jj9jjjuh1jhhhhhNhNubj)}(h**Parameters** ``struct file *file`` the file we wrote to **Description** Should be matched with a call to file_start_write().h](h)}(h**Parameters**h]j)}(hj9h]h Parameters}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj9ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM hj9ubj)}(hhh]j)}(h+``struct file *file`` the file we wrote to h](j)}(h``struct file *file``h]j)}(hj9h]hstruct file *file}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj9ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM hj9ubj)}(hhh]h)}(hthe file we wrote toh]hthe file we wrote to}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj9hM hj9ubah}(h]h ]h"]h$]h&]uh1jhj9ubeh}(h]h ]h"]h$]h&]uh1jhj9hM hj9ubah}(h]h ]h"]h$]h&]uh1jhj9ubh)}(h**Description**h]j)}(hj9h]h Description}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj9ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM hj9ubh)}(h4Should be matched with a call to file_start_write().h]h4Should be matched with a call to file_start_write().}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM hj9ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j kiocb_start_write (C function)c.kiocb_start_writehNtauh1hhhhhhNhNubj)}(hhh](j)}(h+void kiocb_start_write (struct kiocb *iocb)h]j)}(h*void kiocb_start_write(struct kiocb *iocb)h](j)}(hvoidh]hvoid}(hj2:hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj.:hhhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM ubj2)}(h h]h }(hjA:hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj.:hhhj@:hM ubjC)}(hkiocb_start_writeh]jI)}(hkiocb_start_writeh]hkiocb_start_write}(hjS:hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjO:ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj.:hhhj@:hM ubj=)}(h(struct kiocb *iocb)h]jC)}(hstruct kiocb *iocbh](j )}(hjh]hstruct}(hjo:hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjk:ubj2)}(h h]h }(hj|:hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjk:ubh)}(hhh]jI)}(hkiocbh]hkiocb}(hj:hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj:ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj:modnameN classnameNjj )}j ]j)}jjU:sbc.kiocb_start_writeasbuh1hhjk:ubj2)}(h h]h }(hj:hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjk:ubj)}(hjh]h*}(hj:hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjk:ubjI)}(hiocbh]hiocb}(hj:hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjk:ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjg:ubah}(h]h ]h"]h$]h&]j`jauh1j<hj.:hhhj@:hM ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj*:hhhj@:hM ubah}(h]j%:ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj@:hM hj':hhubjw)}(hhh]h)}(h2get write access to a superblock for async file ioh]h2get write access to a superblock for async file io}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM hj:hhubah}(h]h ]h"]h$]h&]uh1jvhj':hhhj@:hM ubeh}(h]h ](jfunctioneh"]h$]h&]jjjj ;jj ;jjjuh1jhhhhhNhNubj)}(h**Parameters** ``struct kiocb *iocb`` the io context we want to submit the write with **Description** This is a variant of sb_start_write() for async io submission. Should be matched with a call to kiocb_end_write().h](h)}(h**Parameters**h]j)}(hj;h]h Parameters}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj;ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM hj;ubj)}(hhh]j)}(hG``struct kiocb *iocb`` the io context we want to submit the write with h](j)}(h``struct kiocb *iocb``h]j)}(hj3;h]hstruct kiocb *iocb}(hj5;hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj1;ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM hj-;ubj)}(hhh]h)}(h/the io context we want to submit the write withh]h/the io context we want to submit the write with}(hjL;hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjH;hM hjI;ubah}(h]h ]h"]h$]h&]uh1jhj-;ubeh}(h]h ]h"]h$]h&]uh1jhjH;hM hj*;ubah}(h]h ]h"]h$]h&]uh1jhj;ubh)}(h**Description**h]j)}(hjn;h]h Description}(hjp;hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjl;ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM hj;ubh)}(hrThis is a variant of sb_start_write() for async io submission. Should be matched with a call to kiocb_end_write().h]hrThis is a variant of sb_start_write() for async io submission. Should be matched with a call to kiocb_end_write().}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM hj;ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j kiocb_end_write (C function)c.kiocb_end_writehNtauh1hhhhhhNhNubj)}(hhh](j)}(h)void kiocb_end_write (struct kiocb *iocb)h]j)}(h(void kiocb_end_write(struct kiocb *iocb)h](j)}(hvoidh]hvoid}(hj;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;hhhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM ubj2)}(h h]h }(hj;hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj;hhhj;hM ubjC)}(hkiocb_end_writeh]jI)}(hkiocb_end_writeh]hkiocb_end_write}(hj;hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj;ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj;hhhj;hM ubj=)}(h(struct kiocb *iocb)h]jC)}(hstruct kiocb *iocbh](j )}(hjh]hstruct}(hj;hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj;ubj2)}(h h]h }(hj;hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj;ubh)}(hhh]jI)}(hkiocbh]hkiocb}(hj<hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj <ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj<modnameN classnameNjj )}j ]j)}jj;sbc.kiocb_end_writeasbuh1hhj;ubj2)}(h h]h }(hj.<hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj;ubj)}(hjh]h*}(hj<<hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;ubjI)}(hiocbh]hiocb}(hjI<hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj;ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj;ubah}(h]h ]h"]h$]h&]j`jauh1j<hj;hhhj;hM ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj;hhhj;hM ubah}(h]j;ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj;hM hj;hhubjw)}(hhh]h)}(h5drop write access to a superblock after async file ioh]h5drop write access to a superblock after async file io}(hjs<hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM hjp<hhubah}(h]h ]h"]h$]h&]uh1jvhj;hhhj;hM ubeh}(h]h ](jfunctioneh"]h$]h&]jjjj<jj<jjjuh1jhhhhhNhNubj)}(h**Parameters** ``struct kiocb *iocb`` the io context we sumbitted the write with **Description** Should be matched with a call to kiocb_start_write().h](h)}(h**Parameters**h]j)}(hj<h]h Parameters}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj<ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM hj<ubj)}(hhh]j)}(hB``struct kiocb *iocb`` the io context we sumbitted the write with h](j)}(h``struct kiocb *iocb``h]j)}(hj<h]hstruct kiocb *iocb}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj<ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM hj<ubj)}(hhh]h)}(h*the io context we sumbitted the write withh]h*the io context we sumbitted the write with}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj<hM hj<ubah}(h]h ]h"]h$]h&]uh1jhj<ubeh}(h]h ]h"]h$]h&]uh1jhj<hM hj<ubah}(h]h ]h"]h$]h&]uh1jhj<ubh)}(h**Description**h]j)}(hj<h]h Description}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj<ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM hj<ubh)}(h5Should be matched with a call to kiocb_start_write().h]h5Should be matched with a call to kiocb_start_write().}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM hj<ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j name_is_dot_dotdot (C function)c.name_is_dot_dotdothNtauh1hhhhhhNhNubj)}(hhh](j)}(h6bool name_is_dot_dotdot (const char *name, size_t len)h]j)}(h5bool name_is_dot_dotdot(const char *name, size_t len)h](j)}(hjh]hbool}(hj4=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0=hhhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMz ubj2)}(h h]h }(hjB=hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj0=hhhjA=hMz ubjC)}(hname_is_dot_dotdoth]jI)}(hname_is_dot_dotdoth]hname_is_dot_dotdot}(hjT=hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjP=ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj0=hhhjA=hMz ubj=)}(h(const char *name, size_t len)h](jC)}(hconst char *nameh](j )}(hjJh]hconst}(hjp=hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjl=ubj2)}(h h]h }(hj}=hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjl=ubj)}(hcharh]hchar}(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjl=ubj2)}(h h]h }(hj=hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjl=ubj)}(hjh]h*}(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjl=ubjI)}(hnameh]hname}(hj=hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjl=ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjh=ubjC)}(h size_t lenh](h)}(hhh]jI)}(hsize_th]hsize_t}(hj=hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj=ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj=modnameN classnameNjj )}j ]j)}jjV=sbc.name_is_dot_dotdotasbuh1hhj=ubj2)}(h h]h }(hj=hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj=ubjI)}(hlenh]hlen}(hj=hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj=ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjh=ubeh}(h]h ]h"]h$]h&]j`jauh1j<hj0=hhhjA=hMz ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj,=hhhjA=hMz ubah}(h]j'=ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjA=hMz hj)=hhubjw)}(hhh]h)}(h,returns true only if **name** is "." or ".."h](hreturns true only if }(hj(>hhhNhNubj)}(h**name**h]hname}(hj0>hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj(>ubh is “.” or “..”}(hj(>hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMz hj%>hhubah}(h]h ]h"]h$]h&]uh1jvhj)=hhhjA=hMz ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjR>jjR>jjjuh1jhhhhhNhNubj)}(hi**Parameters** ``const char *name`` file name to check ``size_t len`` length of file name, in bytesh](h)}(h**Parameters**h]j)}(hj\>h]h Parameters}(hj^>hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjZ>ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM~ hjV>ubj)}(hhh](j)}(h(``const char *name`` file name to check h](j)}(h``const char *name``h]j)}(hj{>h]hconst char *name}(hj}>hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjy>ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM{ hju>ubj)}(hhh]h)}(hfile name to checkh]hfile name to check}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj>hM{ hj>ubah}(h]h ]h"]h$]h&]uh1jhju>ubeh}(h]h ]h"]h$]h&]uh1jhj>hM{ hjr>ubj)}(h,``size_t len`` length of file name, in bytesh](j)}(h``size_t len``h]j)}(hj>h]h size_t len}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj>ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM} hj>ubj)}(hhh]h)}(hlength of file name, in bytesh]hlength of file name, in bytes}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM| hj>ubah}(h]h ]h"]h$]h&]uh1jhj>ubeh}(h]h ]h"]h$]h&]uh1jhj>hM} hjr>ubeh}(h]h ]h"]h$]h&]uh1jhjV>ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j !name_contains_dotdot (C function)c.name_contains_dotdothNtauh1hhhhhhNhNubj)}(hhh](j)}(h,bool name_contains_dotdot (const char *name)h]j)}(h+bool name_contains_dotdot(const char *name)h](j)}(hjh]hbool}(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ?hhhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM ubj2)}(h h]h }(hj?hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj ?hhhj?hM ubjC)}(hname_contains_dotdoth]jI)}(hname_contains_dotdoth]hname_contains_dotdot}(hj.?hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj*?ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj ?hhhj?hM ubj=)}(h(const char *name)h]jC)}(hconst char *nameh](j )}(hjJh]hconst}(hjJ?hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjF?ubj2)}(h h]h }(hjW?hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjF?ubj)}(hcharh]hchar}(hje?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjF?ubj2)}(h h]h }(hjs?hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjF?ubj)}(hjh]h*}(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjF?ubjI)}(hnameh]hname}(hj?hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjF?ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjB?ubah}(h]h ]h"]h$]h&]j`jauh1j<hj ?hhhj?hM ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj?hhhj?hM ubah}(h]j?ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj?hM hj?hhubjw)}(hhh]h)}(h2check if a file name contains ".." path componentsh]h6check if a file name contains “..” path components}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM hj?hhubah}(h]h ]h"]h$]h&]uh1jvhj?hhhj?hM ubeh}(h]h ](jfunctioneh"]h$]h&]jjjj?jj?jjjuh1jhhhhhNhNubj)}(h**Parameters** ``const char *name`` File path string to check Search for ".." surrounded by either '/' or start/end of string.h](h)}(h**Parameters**h]j)}(hj?h]h Parameters}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj?ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM hj?ubj)}(hhh]j)}(ho``const char *name`` File path string to check Search for ".." surrounded by either '/' or start/end of string.h](j)}(h``const char *name``h]j)}(hj?h]hconst char *name}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj?ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM hj?ubj)}(hhh]h)}(hZFile path string to check Search for ".." surrounded by either '/' or start/end of string.h]hbFile path string to check Search for “..” surrounded by either ‘/’ or start/end of string.}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj@hM hj@ubah}(h]h ]h"]h$]h&]uh1jhj?ubeh}(h]h ]h"]h$]h&]uh1jhj@hM hj?ubah}(h]h ]h"]h$]h&]uh1jhj?ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j inode_dio_begin (C function)c.inode_dio_beginhNtauh1hhhhhhNhNubj)}(hhh](j)}(h*void inode_dio_begin (struct inode *inode)h]j)}(h)void inode_dio_begin(struct inode *inode)h](j)}(hvoidh]hvoid}(hjR@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjN@hhhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMf ubj2)}(h h]h }(hja@hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjN@hhhj`@hMf ubjC)}(hinode_dio_beginh]jI)}(hinode_dio_beginh]hinode_dio_begin}(hjs@hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjo@ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjN@hhhj`@hMf ubj=)}(h(struct inode *inode)h]jC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hj@hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj@ubj2)}(h h]h }(hj@hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj@ubh)}(hhh]jI)}(hinodeh]hinode}(hj@hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj@ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj@modnameN classnameNjj )}j ]j)}jju@sbc.inode_dio_beginasbuh1hhj@ubj2)}(h h]h }(hj@hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj@ubj)}(hjh]h*}(hj@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@ubjI)}(hinodeh]hinode}(hj@hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj@ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj@ubah}(h]h ]h"]h$]h&]j`jauh1j<hjN@hhhj`@hMf ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjJ@hhhj`@hMf ubah}(h]jE@ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj`@hMf hjG@hhubjw)}(hhh]h)}(h%signal start of a direct I/O requestsh]h%signal start of a direct I/O requests}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMf hjAhhubah}(h]h ]h"]h$]h&]uh1jvhjG@hhhj`@hMf ubeh}(h]h ](jfunctioneh"]h$]h&]jjjj*Ajj*Ajjjuh1jhhhhhNhNubj)}(h**Parameters** ``struct inode *inode`` inode the direct I/O happens on **Description** This is called once we've finished processing a direct I/O request, and is used to wake up callers waiting for direct I/O to be quiesced.h](h)}(h**Parameters**h]j)}(hj4Ah]h Parameters}(hj6AhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj2Aubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMj hj.Aubj)}(hhh]j)}(h8``struct inode *inode`` inode the direct I/O happens on h](j)}(h``struct inode *inode``h]j)}(hjSAh]hstruct inode *inode}(hjUAhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjQAubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMg hjMAubj)}(hhh]h)}(hinode the direct I/O happens onh]hinode the direct I/O happens on}(hjlAhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhAhMg hjiAubah}(h]h ]h"]h$]h&]uh1jhjMAubeh}(h]h ]h"]h$]h&]uh1jhjhAhMg hjJAubah}(h]h ]h"]h$]h&]uh1jhj.Aubh)}(h**Description**h]j)}(hjAh]h Description}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjAubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMi hj.Aubh)}(hThis is called once we've finished processing a direct I/O request, and is used to wake up callers waiting for direct I/O to be quiesced.h]hThis is called once we’ve finished processing a direct I/O request, and is used to wake up callers waiting for direct I/O to be quiesced.}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMh hj.Aubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j inode_dio_end (C function)c.inode_dio_endhNtauh1hhhhhhNhNubj)}(hhh](j)}(h(void inode_dio_end (struct inode *inode)h]j)}(h'void inode_dio_end(struct inode *inode)h](j)}(hvoidh]hvoid}(hjAhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjAhhhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMr ubj2)}(h h]h }(hjAhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjAhhhjAhMr ubjC)}(h inode_dio_endh]jI)}(h inode_dio_endh]h inode_dio_end}(hjAhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjAubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjAhhhjAhMr ubj=)}(h(struct inode *inode)h]jC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hjBhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj Bubj2)}(h h]h }(hjBhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj Bubh)}(hhh]jI)}(hinodeh]hinode}(hj.BhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj+Bubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj0BmodnameN classnameNjj )}j ]j)}jjAsbc.inode_dio_endasbuh1hhj Bubj2)}(h h]h }(hjNBhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj Bubj)}(hjh]h*}(hj\BhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj BubjI)}(hinodeh]hinode}(hjiBhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj Bubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjBubah}(h]h ]h"]h$]h&]j`jauh1j<hjAhhhjAhMr ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjAhhhjAhMr ubah}(h]jAah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjAhMr hjAhhubjw)}(hhh]h)}(h&signal finish of a direct I/O requestsh]h&signal finish of a direct I/O requests}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMr hjBhhubah}(h]h ]h"]h$]h&]uh1jvhjAhhhjAhMr ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjBjjBjjjuh1jhhhhhNhNubj)}(h**Parameters** ``struct inode *inode`` inode the direct I/O happens on **Description** This is called once we've finished processing a direct I/O request, and is used to wake up callers waiting for direct I/O to be quiesced.h](h)}(h**Parameters**h]j)}(hjBh]h Parameters}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjBubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMv hjBubj)}(hhh]j)}(h8``struct inode *inode`` inode the direct I/O happens on h](j)}(h``struct inode *inode``h]j)}(hjBh]hstruct inode *inode}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjBubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMs hjBubj)}(hhh]h)}(hinode the direct I/O happens onh]hinode the direct I/O happens on}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjBhMs hjBubah}(h]h ]h"]h$]h&]uh1jhjBubeh}(h]h ]h"]h$]h&]uh1jhjBhMs hjBubah}(h]h ]h"]h$]h&]uh1jhjBubh)}(h**Description**h]j)}(hjCh]h Description}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1jhj Cubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMu hjBubh)}(hThis is called once we've finished processing a direct I/O request, and is used to wake up callers waiting for direct I/O to be quiesced.h]hThis is called once we’ve finished processing a direct I/O request, and is used to wake up callers waiting for direct I/O to be quiesced.}(hj%ChhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhMt hjBubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j ,generic_ci_validate_strict_name (C function)!c.generic_ci_validate_strict_namehNtauh1hhhhhhNhNubj)}(hhh](j)}(hQbool generic_ci_validate_strict_name (struct inode *dir, const struct qstr *name)h]j)}(hPbool generic_ci_validate_strict_name(struct inode *dir, const struct qstr *name)h](j)}(hjh]hbool}(hjTChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjPChhhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM% ubj2)}(h h]h }(hjbChhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjPChhhjaChM% ubjC)}(hgeneric_ci_validate_strict_nameh]jI)}(hgeneric_ci_validate_strict_nameh]hgeneric_ci_validate_strict_name}(hjtChhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjpCubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjPChhhjaChM% ubj=)}(h,(struct inode *dir, const struct qstr *name)h](jC)}(hstruct inode *dirh](j )}(hjh]hstruct}(hjChhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjCubj2)}(h h]h }(hjChhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjCubh)}(hhh]jI)}(hinodeh]hinode}(hjChhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjCubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjCmodnameN classnameNjj )}j ]j)}jjvCsb!c.generic_ci_validate_strict_nameasbuh1hhjCubj2)}(h h]h }(hjChhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjCubj)}(hjh]h*}(hjChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCubjI)}(hdirh]hdir}(hjChhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjCubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjCubjC)}(hconst struct qstr *nameh](j )}(hjJh]hconst}(hjDhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjCubj2)}(h h]h }(hjDhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjCubj )}(hjh]hstruct}(hjDhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjCubj2)}(h h]h }(hj*DhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjCubh)}(hhh]jI)}(hqstrh]hqstr}(hj;DhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj8Dubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj=DmodnameN classnameNjj )}j ]jC!c.generic_ci_validate_strict_nameasbuh1hhjCubj2)}(h h]h }(hjYDhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjCubj)}(hjh]h*}(hjgDhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCubjI)}(hnameh]hname}(hjtDhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjCubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjCubeh}(h]h ]h"]h$]h&]j`jauh1j<hjPChhhjaChM% ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjLChhhjaChM% ubah}(h]jGCah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjaChM% hjIChhubjw)}(hhh]h)}(h1Check if a given name is suitable for a directoryh]h1Check if a given name is suitable for a directory}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM% hjDhhubah}(h]h ]h"]h$]h&]uh1jvhjIChhhjaChM% ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjDjjDjjjuh1jhhhhhNhNubj)}(hXx**Parameters** ``struct inode *dir`` inode of the directory where the new file will be created ``const struct qstr *name`` name of the new file **Description** This functions checks if the proposed filename is valid for the parent directory. That means that only valid UTF-8 filenames will be accepted for casefold directories from filesystems created with the strict encoding flag. That also means that any name will be accepted for directories that doesn't have casefold enabled, or aren't being strict with the encoding. **Return** * True: if the filename is suitable for this directory. It can be true if a given name is not suitable for a strict encoding directory, but the directory being used isn't strict * False if the filename isn't suitable for this directory. This only happens when a directory is casefolded and the filesystem is strict about its encoding.h](h)}(h**Parameters**h]j)}(hjDh]h Parameters}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjDubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM) hjDubj)}(hhh](j)}(hP``struct inode *dir`` inode of the directory where the new file will be created h](j)}(h``struct inode *dir``h]j)}(hjDh]hstruct inode *dir}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjDubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM/ hjDubj)}(hhh]h)}(h9inode of the directory where the new file will be createdh]h9inode of the directory where the new file will be created}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjDhM/ hjDubah}(h]h ]h"]h$]h&]uh1jhjDubeh}(h]h ]h"]h$]h&]uh1jhjDhM/ hjDubj)}(h1``const struct qstr *name`` name of the new file h](j)}(h``const struct qstr *name``h]j)}(hjEh]hconst struct qstr *name}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjEubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM0 hjEubj)}(hhh]h)}(hname of the new fileh]hname of the new file}(hj1EhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj-EhM0 hj.Eubah}(h]h ]h"]h$]h&]uh1jhjEubeh}(h]h ]h"]h$]h&]uh1jhj-EhM0 hjDubeh}(h]h ]h"]h$]h&]uh1jhjDubh)}(h**Description**h]j)}(hjSEh]h Description}(hjUEhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjQEubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM2 hjDubh)}(hXlThis functions checks if the proposed filename is valid for the parent directory. That means that only valid UTF-8 filenames will be accepted for casefold directories from filesystems created with the strict encoding flag. That also means that any name will be accepted for directories that doesn't have casefold enabled, or aren't being strict with the encoding.h]hXpThis functions checks if the proposed filename is valid for the parent directory. That means that only valid UTF-8 filenames will be accepted for casefold directories from filesystems created with the strict encoding flag. That also means that any name will be accepted for directories that doesn’t have casefold enabled, or aren’t being strict with the encoding.}(hjiEhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM& hjDubh)}(h **Return**h]j)}(hjzEh]hReturn}(hj|EhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjxEubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM- hjDubh bullet_list)}(hhh](h list_item)}(hTrue: if the filename is suitable for this directory. It can be true if a given name is not suitable for a strict encoding directory, but the directory being used isn't stricth]h)}(hTrue: if the filename is suitable for this directory. It can be true if a given name is not suitable for a strict encoding directory, but the directory being used isn't stricth]hTrue: if the filename is suitable for this directory. It can be true if a given name is not suitable for a strict encoding directory, but the directory being used isn’t strict}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM2 hjEubah}(h]h ]h"]h$]h&]uh1jEhjEubjE)}(hFalse if the filename isn't suitable for this directory. This only happens when a directory is casefolded and the filesystem is strict about its encoding.h]h)}(hFalse if the filename isn't suitable for this directory. This only happens when a directory is casefolded and the filesystem is strict about its encoding.h]hFalse if the filename isn’t suitable for this directory. This only happens when a directory is casefolded and the filesystem is strict about its encoding.}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:14: ./include/linux/fs.hhM5 hjEubah}(h]h ]h"]h$]h&]uh1jEhjEubeh}(h]h ]h"]h$]h&]bulletjuh1jEhjEhM2 hjDubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubeh}(h]the-filesystem-typesah ]h"]the filesystem typesah$]h&]uh1hhhhhhhhK ubh)}(hhh](h)}(hThe Directory Cacheh]hThe Directory Cache}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjEhhhhhKubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j d_drop (C function)c.d_drophNtauh1hhjEhhhNhNubj)}(hhh](j)}(h#void d_drop (struct dentry *dentry)h]j)}(h"void d_drop(struct dentry *dentry)h](j)}(hvoidh]hvoid}(hj FhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFhhhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMmubj2)}(h h]h }(hjFhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjFhhhjFhMmubjC)}(hd_droph]jI)}(hd_droph]hd_drop}(hj*FhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj&Fubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjFhhhjFhMmubj=)}(h(struct dentry *dentry)h]jC)}(hstruct dentry *dentryh](j )}(hjh]hstruct}(hjFFhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjBFubj2)}(h h]h }(hjSFhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjBFubh)}(hhh]jI)}(hdentryh]hdentry}(hjdFhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjaFubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjfFmodnameN classnameNjj )}j ]j)}jj,Fsbc.d_dropasbuh1hhjBFubj2)}(h h]h }(hjFhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjBFubj)}(hjh]h*}(hjFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBFubjI)}(hdentryh]hdentry}(hjFhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjBFubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj>Fubah}(h]h ]h"]h$]h&]j`jauh1j<hjFhhhjFhMmubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjFhhhjFhMmubah}(h]jEah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjFhMmhjEhhubjw)}(hhh]h)}(h drop a dentryh]h drop a dentry}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMmhjFhhubah}(h]h ]h"]h$]h&]uh1jvhjEhhhjFhMmubeh}(h]h ](jfunctioneh"]h$]h&]jjjjFjjFjjjuh1jhhhjEhNhNubj)}(hX**Parameters** ``struct dentry *dentry`` dentry to drop **Description** d_drop() unhashes the entry from the parent dentry hashes, so that it won't be found through a VFS lookup any more. Note that this is different from deleting the dentry - d_delete will try to mark the dentry negative if possible, giving a successful _negative_ lookup, while d_drop will just make the cache lookup fail. d_drop() is used mainly for stuff that wants to invalidate a dentry for some reason (NFS timeouts or autofs deletes). __d_drop requires dentry->d_lock ___d_drop doesn't mark dentry as "unhashed" (dentry->d_hash.pprev will be LIST_POISON2, not NULL).h](h)}(h**Parameters**h]j)}(hjFh]h Parameters}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjFubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMqhjFubj)}(hhh]j)}(h)``struct dentry *dentry`` dentry to drop h](j)}(h``struct dentry *dentry``h]j)}(hj Gh]hstruct dentry *dentry}(hj GhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjGubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMnhjGubj)}(hhh]h)}(hdentry to droph]hdentry to drop}(hj#GhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjGhMnhj Gubah}(h]h ]h"]h$]h&]uh1jhjGubeh}(h]h ]h"]h$]h&]uh1jhjGhMnhjGubah}(h]h ]h"]h$]h&]uh1jhjFubh)}(h**Description**h]j)}(hjEGh]h Description}(hjGGhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjCGubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMphjFubh)}(hX?d_drop() unhashes the entry from the parent dentry hashes, so that it won't be found through a VFS lookup any more. Note that this is different from deleting the dentry - d_delete will try to mark the dentry negative if possible, giving a successful _negative_ lookup, while d_drop will just make the cache lookup fail.h]hXAd_drop() unhashes the entry from the parent dentry hashes, so that it won’t be found through a VFS lookup any more. Note that this is different from deleting the dentry - d_delete will try to mark the dentry negative if possible, giving a successful _negative_ lookup, while d_drop will just make the cache lookup fail.}(hj[GhhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMohjFubh)}(hud_drop() is used mainly for stuff that wants to invalidate a dentry for some reason (NFS timeouts or autofs deletes).h]hud_drop() is used mainly for stuff that wants to invalidate a dentry for some reason (NFS timeouts or autofs deletes).}(hjjGhhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMuhjFubh)}(h __d_drop requires dentry->d_lockh]h __d_drop requires dentry->d_lock}(hjyGhhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMxhjFubh)}(hb___d_drop doesn't mark dentry as "unhashed" (dentry->d_hash.pprev will be LIST_POISON2, not NULL).h]hh___d_drop doesn’t mark dentry as “unhashed” (dentry->d_hash.pprev will be LIST_POISON2, not NULL).}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMzhjFubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjEhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j "__move_to_shrink_list (C function)c.__move_to_shrink_listhNtauh1hhjEhhhNhNubj)}(hhh](j)}(hJbool __move_to_shrink_list (struct dentry *dentry, struct list_head *list)h]j)}(hIbool __move_to_shrink_list(struct dentry *dentry, struct list_head *list)h](j)}(hjh]hbool}(hjGhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGhhhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMEubj2)}(h h]h }(hjGhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjGhhhjGhMEubjC)}(h__move_to_shrink_listh]jI)}(h__move_to_shrink_listh]h__move_to_shrink_list}(hjGhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjGubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjGhhhjGhMEubj=)}(h/(struct dentry *dentry, struct list_head *list)h](jC)}(hstruct dentry *dentryh](j )}(hjh]hstruct}(hjGhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjGubj2)}(h h]h }(hjHhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjGubh)}(hhh]jI)}(hdentryh]hdentry}(hjHhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjHubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjHmodnameN classnameNjj )}j ]j)}jjGsbc.__move_to_shrink_listasbuh1hhjGubj2)}(h h]h }(hj1HhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjGubj)}(hjh]h*}(hj?HhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGubjI)}(hdentryh]hdentry}(hjLHhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjGubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjGubjC)}(hstruct list_head *listh](j )}(hjh]hstruct}(hjeHhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjaHubj2)}(h h]h }(hjrHhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjaHubh)}(hhh]jI)}(h list_headh]h list_head}(hjHhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjHubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjHmodnameN classnameNjj )}j ]j-Hc.__move_to_shrink_listasbuh1hhjaHubj2)}(h h]h }(hjHhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjaHubj)}(hjh]h*}(hjHhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaHubjI)}(hlisth]hlist}(hjHhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjaHubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjGubeh}(h]h ]h"]h$]h&]j`jauh1j<hjGhhhjGhMEubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjGhhhjGhMEubah}(h]jGah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjGhMEhjGhhubjw)}(hhh]h)}(h(try to place a dentry into a shrink listh]h(try to place a dentry into a shrink list}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMEhjHhhubah}(h]h ]h"]h$]h&]uh1jvhjGhhhjGhMEubeh}(h]h ](jfunctioneh"]h$]h&]jjjjHjjHjjjuh1jhhhjEhNhNubj)}(hX**Parameters** ``struct dentry *dentry`` dentry to try putting into shrink list ``struct list_head *list`` the list to put **dentry** into. **Return** true **dentry** had been placed into **list**, false otherwise **Description** If **dentry** is idle and not already include into a shrink list, move it into **list** and return ``true``; otherwise do nothing and return ``false``. Caller must be holding **dentry->d_lock**. There must have been no calls of dentry_free(**dentry**) prior to the beginning of the RCU read-side critical area in which __move_to_shrink_list(**dentry**, **list**) is called. **list** should be thread-private and eventually emptied by passing it to shrink_dentry_list().h](h)}(h**Parameters**h]j)}(hjIh]h Parameters}(hj IhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjIubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMIhjIubj)}(hhh](j)}(hA``struct dentry *dentry`` dentry to try putting into shrink list h](j)}(h``struct dentry *dentry``h]j)}(hj'Ih]hstruct dentry *dentry}(hj)IhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj%Iubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMFhj!Iubj)}(hhh]h)}(h&dentry to try putting into shrink listh]h&dentry to try putting into shrink list}(hj@IhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjtrue **dentry** had been placed into **list**, false otherwiseh](htrue }(hjIhhhNhNubj)}(h **dentry**h]hdentry}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjIubh had been placed into }(hjIhhhNhNubj)}(h**list**h]hlist}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjIubh, false otherwise}(hjIhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMHhjIubh)}(h**Description**h]j)}(hjIh]h Description}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjIubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMJhjIubh)}(hIf **dentry** is idle and not already include into a shrink list, move it into **list** and return ``true``; otherwise do nothing and return ``false``.h](hIf }(hjJhhhNhNubj)}(h **dentry**h]hdentry}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjJubhB is idle and not already include into a shrink list, move it into }(hjJhhhNhNubj)}(h**list**h]hlist}(hj(JhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjJubh and return }(hjJhhhNhNubj)}(h``true``h]htrue}(hj:JhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjJubh"; otherwise do nothing and return }(hjJhhhNhNubj)}(h ``false``h]hfalse}(hjLJhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjJubh.}(hjJhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMIhjIubh)}(hCaller must be holding **dentry->d_lock**. There must have been no calls of dentry_free(**dentry**) prior to the beginning of the RCU read-side critical area in which __move_to_shrink_list(**dentry**, **list**) is called.h](hCaller must be holding }(hjeJhhhNhNubj)}(h**dentry->d_lock**h]hdentry->d_lock}(hjmJhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjeJubh0. There must have been no calls of dentry_free(}(hjeJhhhNhNubj)}(h **dentry**h]hdentry}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjeJubh[) prior to the beginning of the RCU read-side critical area in which __move_to_shrink_list(}(hjeJhhhNhNubj)}(h **dentry**h]hdentry}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjeJubh, }(hjeJhhhNhNubj)}(h**list**h]hlist}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjeJubh ) is called.}(hjeJhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMLhjIubh)}(h_**list** should be thread-private and eventually emptied by passing it to shrink_dentry_list().h](j)}(h**list**h]hlist}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjJubhW should be thread-private and eventually emptied by passing it to shrink_dentry_list().}(hjJhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMPhjIubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjEhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j d_find_any_alias (C function)c.d_find_any_aliashNtauh1hhjEhhhNhNubj)}(hhh](j)}(h6struct dentry * d_find_any_alias (struct inode *inode)h]j)}(h4struct dentry *d_find_any_alias(struct inode *inode)h](j )}(hjh]hstruct}(hjJhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjJhhhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMubj2)}(h h]h }(hjKhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjJhhhjKhMubh)}(hhh]jI)}(hdentryh]hdentry}(hjKhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjKubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjKmodnameN classnameNjj )}j ]j)}jd_find_any_aliassbc.d_find_any_aliasasbuh1hhjJhhhjKhMubj2)}(h h]h }(hj9KhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjJhhhjKhMubj)}(hjh]h*}(hjGKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJhhhjKhMubjC)}(hd_find_any_aliash]jI)}(hj6Kh]hd_find_any_alias}(hjXKhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjTKubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjJhhhjKhMubj=)}(h(struct inode *inode)h]jC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hjsKhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjoKubj2)}(h h]h }(hjKhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjoKubh)}(hhh]jI)}(hinodeh]hinode}(hjKhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjKubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjKmodnameN classnameNjj )}j ]j4Kc.d_find_any_aliasasbuh1hhjoKubj2)}(h h]h }(hjKhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjoKubj)}(hjh]h*}(hjKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjoKubjI)}(hinodeh]hinode}(hjKhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjoKubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjkKubah}(h]h ]h"]h$]h&]j`jauh1j<hjJhhhjKhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjJhhhjKhMubah}(h]jJah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjKhMhjJhhubjw)}(hhh]h)}(h find any alias for a given inodeh]h find any alias for a given inode}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMhjKhhubah}(h]h ]h"]h$]h&]uh1jvhjJhhhjKhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjj Ljj Ljjjuh1jhhhjEhNhNubj)}(h**Parameters** ``struct inode *inode`` inode to find an alias for **Description** If any aliases exist for the given inode, take and return a reference for one of them. If no aliases exist, return ``NULL``.h](h)}(h**Parameters**h]j)}(hjLh]h Parameters}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjLubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMhjLubj)}(hhh]j)}(h3``struct inode *inode`` inode to find an alias for h](j)}(h``struct inode *inode``h]j)}(hj5Lh]hstruct inode *inode}(hj7LhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj3Lubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMhj/Lubj)}(hhh]h)}(hinode to find an alias forh]hinode to find an alias for}(hjNLhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjJLhMhjKLubah}(h]h ]h"]h$]h&]uh1jhj/Lubeh}(h]h ]h"]h$]h&]uh1jhjJLhMhj,Lubah}(h]h ]h"]h$]h&]uh1jhjLubh)}(h**Description**h]j)}(hjpLh]h Description}(hjrLhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjnLubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMhjLubh)}(h}If any aliases exist for the given inode, take and return a reference for one of them. If no aliases exist, return ``NULL``.h](htIf any aliases exist for the given inode, take and return a reference for one of them. If no aliases exist, return }(hjLhhhNhNubj)}(h``NULL``h]hNULL}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjLubh.}(hjLhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMhjLubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjEhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j d_find_alias (C function)c.d_find_aliashNtauh1hhjEhhhNhNubj)}(hhh](j)}(h2struct dentry * d_find_alias (struct inode *inode)h]j)}(h0struct dentry *d_find_alias(struct inode *inode)h](j )}(hjh]hstruct}(hjLhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjLhhhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMubj2)}(h h]h }(hjLhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjLhhhjLhMubh)}(hhh]jI)}(hdentryh]hdentry}(hjLhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjLubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjLmodnameN classnameNjj )}j ]j)}j d_find_aliassbc.d_find_aliasasbuh1hhjLhhhjLhMubj2)}(h h]h }(hjMhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjLhhhjLhMubj)}(hjh]h*}(hjMhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjLhhhjLhMubjC)}(h d_find_aliash]jI)}(hjMh]h d_find_alias}(hj&MhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj"Mubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjLhhhjLhMubj=)}(h(struct inode *inode)h]jC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hjAMhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj=Mubj2)}(h h]h }(hjNMhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj=Mubh)}(hhh]jI)}(hinodeh]hinode}(hj_MhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj\Mubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjaMmodnameN classnameNjj )}j ]jMc.d_find_aliasasbuh1hhj=Mubj2)}(h h]h }(hj}MhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj=Mubj)}(hjh]h*}(hjMhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=MubjI)}(hinodeh]hinode}(hjMhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj=Mubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj9Mubah}(h]h ]h"]h$]h&]j`jauh1j<hjLhhhjLhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjLhhhjLhMubah}(h]jLah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjLhMhjLhhubjw)}(hhh]h)}(hgrab a hashed alias of inodeh]hgrab a hashed alias of inode}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMhjMhhubah}(h]h ]h"]h$]h&]uh1jvhjLhhhjLhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjMjjMjjjuh1jhhhjEhNhNubj)}(hX0**Parameters** ``struct inode *inode`` inode in question **Description** If inode has a hashed alias, or is a directory and has any alias, acquire the reference to alias and return it. Otherwise return NULL. Notice that if inode is a directory there can be only one alias and it can be unhashed only if it has no children, or if it is the root of a filesystem, or if the directory was renamed and d_revalidate was the first vfs operation to notice. If the inode has an IS_ROOT, DCACHE_DISCONNECTED alias, then prefer any other hashed alias over that one.h](h)}(h**Parameters**h]j)}(hjMh]h Parameters}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjMubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMhjMubj)}(hhh]j)}(h*``struct inode *inode`` inode in question h](j)}(h``struct inode *inode``h]j)}(hjNh]hstruct inode *inode}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjNubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMhjMubj)}(hhh]h)}(hinode in questionh]hinode in question}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjNhMhjNubah}(h]h ]h"]h$]h&]uh1jhjMubeh}(h]h ]h"]h$]h&]uh1jhjNhMhjMubah}(h]h ]h"]h$]h&]uh1jhjMubh)}(h**Description**h]j)}(hj>Nh]h Description}(hj@NhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjah"]h$]h&]uh1j1hjNhhhjNhMubjC)}(hshrink_dcache_sbh]jI)}(hshrink_dcache_sbh]hshrink_dcache_sb}(hjNhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjNubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjNhhhjNhMubj=)}(h(struct super_block *sb)h]jC)}(hstruct super_block *sbh](j )}(hjh]hstruct}(hjNhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjNubj2)}(h h]h }(hjNhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjNubh)}(hhh]jI)}(h super_blockh]h super_block}(hjNhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjNubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjNmodnameN classnameNjj )}j ]j)}jjNsbc.shrink_dcache_sbasbuh1hhjNubj2)}(h h]h }(hj OhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjNubj)}(hjh]h*}(hjOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubjI)}(hsbh]hsb}(hj(OhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjNubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjNubah}(h]h ]h"]h$]h&]j`jauh1j<hjNhhhjNhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjNhhhjNhMubah}(h]jNah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjNhMhjNhhubjw)}(hhh]h)}(hshrink dcache for a superblockh]hshrink dcache for a superblock}(hjROhhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMhjOOhhubah}(h]h ]h"]h$]h&]uh1jvhjNhhhjNhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjOjjjOjjjuh1jhhhjEhNhNubj)}(h**Parameters** ``struct super_block *sb`` superblock **Description** Shrink the dcache for the specified super block. This is used to free the dcache before unmounting a file system.h](h)}(h**Parameters**h]j)}(hjtOh]h Parameters}(hjvOhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjrOubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMhjnOubj)}(hhh]j)}(h&``struct super_block *sb`` superblock h](j)}(h``struct super_block *sb``h]j)}(hjOh]hstruct super_block *sb}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjOubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMhjOubj)}(hhh]h)}(h superblockh]h superblock}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjOhMhjOubah}(h]h ]h"]h$]h&]uh1jhjOubeh}(h]h ]h"]h$]h&]uh1jhjOhMhjOubah}(h]h ]h"]h$]h&]uh1jhjnOubh)}(h**Description**h]j)}(hjOh]h Description}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjOubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMhjnOubh)}(hqShrink the dcache for the specified super block. This is used to free the dcache before unmounting a file system.h]hqShrink the dcache for the specified super block. This is used to free the dcache before unmounting a file system.}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMhjnOubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjEhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j path_has_submounts (C function)c.path_has_submountshNtauh1hhjEhhhNhNubj)}(hhh](j)}(h2int path_has_submounts (const struct path *parent)h]j)}(h1int path_has_submounts(const struct path *parent)h](j)}(hinth]hint}(hjPhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjPhhhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM=ubj2)}(h h]h }(hj"PhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjPhhhj!PhM=ubjC)}(hpath_has_submountsh]jI)}(hpath_has_submountsh]hpath_has_submounts}(hj4PhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj0Pubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjPhhhj!PhM=ubj=)}(h(const struct path *parent)h]jC)}(hconst struct path *parenth](j )}(hjJh]hconst}(hjPPhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjLPubj2)}(h h]h }(hj]PhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjLPubj )}(hjh]hstruct}(hjkPhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjLPubj2)}(h h]h }(hjxPhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjLPubh)}(hhh]jI)}(hpathh]hpath}(hjPhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjPubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjPmodnameN classnameNjj )}j ]j)}jj6Psbc.path_has_submountsasbuh1hhjLPubj2)}(h h]h }(hjPhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjLPubj)}(hjh]h*}(hjPhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjLPubjI)}(hparenth]hparent}(hjPhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjLPubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjHPubah}(h]h ]h"]h$]h&]j`jauh1j<hjPhhhj!PhM=ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj Phhhj!PhM=ubah}(h]jPah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj!PhM=hjPhhubjw)}(hhh]h)}(h8check for mounts over a dentry in the current namespace.h]h8check for mounts over a dentry in the current namespace.}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM=hjPhhubah}(h]h ]h"]h$]h&]uh1jvhjPhhhj!PhM=ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjQjjQjjjuh1jhhhjEhNhNubj)}(h**Parameters** ``const struct path *parent`` path to check. **Description** Return true if the parent or its subdirectories contain a mount point in the current namespace.h](h)}(h**Parameters**h]j)}(hjQh]h Parameters}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjQubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMAhj Qubj)}(hhh]j)}(h-``const struct path *parent`` path to check. h](j)}(h``const struct path *parent``h]j)}(hj/Qh]hconst struct path *parent}(hj1QhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj-Qubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM?hj)Qubj)}(hhh]h)}(hpath to check.h]hpath to check.}(hjHQhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjDQhM?hjEQubah}(h]h ]h"]h$]h&]uh1jhj)Qubeh}(h]h ]h"]h$]h&]uh1jhjDQhM?hj&Qubah}(h]h ]h"]h$]h&]uh1jhj Qubh)}(h**Description**h]j)}(hjjQh]h Description}(hjlQhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjhQubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMAhj Qubh)}(h_Return true if the parent or its subdirectories contain a mount point in the current namespace.h]h_Return true if the parent or its subdirectories contain a mount point in the current namespace.}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM@hj Qubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjEhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j d_invalidate (C function)c.d_invalidatehNtauh1hhjEhhhNhNubj)}(hhh](j)}(h)void d_invalidate (struct dentry *dentry)h]j)}(h(void d_invalidate(struct dentry *dentry)h](j)}(hvoidh]hvoid}(hjQhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjQhhhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMgubj2)}(h h]h }(hjQhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjQhhhjQhMgubjC)}(h d_invalidateh]jI)}(h d_invalidateh]h d_invalidate}(hjQhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjQubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjQhhhjQhMgubj=)}(h(struct dentry *dentry)h]jC)}(hstruct dentry *dentryh](j )}(hjh]hstruct}(hjQhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjQubj2)}(h h]h }(hjQhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjQubh)}(hhh]jI)}(hdentryh]hdentry}(hj RhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjRubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj RmodnameN classnameNjj )}j ]j)}jjQsbc.d_invalidateasbuh1hhjQubj2)}(h h]h }(hj*RhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjQubj)}(hjh]h*}(hj8RhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjQubjI)}(hdentryh]hdentry}(hjERhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjQubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjQubah}(h]h ]h"]h$]h&]j`jauh1j<hjQhhhjQhMgubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjQhhhjQhMgubah}(h]jQah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjQhMghjQhhubjw)}(hhh]h)}(h(detach submounts, prune dcache, and droph]h(detach submounts, prune dcache, and drop}(hjoRhhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMghjlRhhubah}(h]h ]h"]h$]h&]uh1jvhjQhhhjQhMgubeh}(h]h ](jfunctioneh"]h$]h&]jjjjRjjRjjjuh1jhhhjEhNhNubj)}(h]**Parameters** ``struct dentry *dentry`` dentry to invalidate (aka detach, prune and drop)h](h)}(h**Parameters**h]j)}(hjRh]h Parameters}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjRubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMkhjRubj)}(hhh]j)}(hK``struct dentry *dentry`` dentry to invalidate (aka detach, prune and drop)h](j)}(h``struct dentry *dentry``h]j)}(hjRh]hstruct dentry *dentry}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjRubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMmhjRubj)}(hhh]h)}(h1dentry to invalidate (aka detach, prune and drop)h]h1dentry to invalidate (aka detach, prune and drop)}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMhhjRubah}(h]h ]h"]h$]h&]uh1jhjRubeh}(h]h ]h"]h$]h&]uh1jhjRhMmhjRubah}(h]h ]h"]h$]h&]uh1jhjRubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjEhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j d_alloc (C function) c.d_allochNtauh1hhjEhhhNhNubj)}(hhh](j)}(hIstruct dentry * d_alloc (struct dentry * parent, const struct qstr *name)h]j)}(hFstruct dentry *d_alloc(struct dentry *parent, const struct qstr *name)h](j )}(hjh]hstruct}(hj ShhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjShhhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMubj2)}(h h]h }(hjShhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjShhhjShMubh)}(hhh]jI)}(hdentryh]hdentry}(hj)ShhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj&Subah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj+SmodnameN classnameNjj )}j ]j)}jd_allocsb c.d_allocasbuh1hhjShhhjShMubj2)}(h h]h }(hjJShhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjShhhjShMubj)}(hjh]h*}(hjXShhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjShhhjShMubjC)}(hd_alloch]jI)}(hjGSh]hd_alloc}(hjiShhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjeSubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjShhhjShMubj=)}(h0(struct dentry *parent, const struct qstr *name)h](jC)}(hstruct dentry *parenth](j )}(hjh]hstruct}(hjShhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjSubj2)}(h h]h }(hjShhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjSubh)}(hhh]jI)}(hdentryh]hdentry}(hjShhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjSubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjSmodnameN classnameNjj )}j ]jES c.d_allocasbuh1hhjSubj2)}(h h]h }(hjShhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjSubj)}(hjh]h*}(hjShhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSubjI)}(hparenth]hparent}(hjShhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjSubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj|SubjC)}(hconst struct qstr *nameh](j )}(hjJh]hconst}(hjShhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjSubj2)}(h h]h }(hjThhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjSubj )}(hjh]hstruct}(hjThhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjSubj2)}(h h]h }(hjThhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjSubh)}(hhh]jI)}(hqstrh]hqstr}(hj-ThhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj*Tubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj/TmodnameN classnameNjj )}j ]jES c.d_allocasbuh1hhjSubj2)}(h h]h }(hjKThhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjSubj)}(hjh]h*}(hjYThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSubjI)}(hnameh]hname}(hjfThhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjSubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj|Subeh}(h]h ]h"]h$]h&]j`jauh1j<hjShhhjShMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjShhhjShMubah}(h]jRah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjShMhjRhhubjw)}(hhh]h)}(hallocate a dcache entryh]hallocate a dcache entry}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMhjThhubah}(h]h ]h"]h$]h&]uh1jvhjRhhhjShMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjTjjTjjjuh1jhhhjEhNhNubj)}(hXU**Parameters** ``struct dentry * parent`` parent of entry to allocate ``const struct qstr *name`` qstr of the name **Description** Allocates a dentry. It returns ``NULL`` if there is insufficient memory available. On a success the dentry is returned. The name passed in is copied and the copy passed in may be reused after this call.h](h)}(h**Parameters**h]j)}(hjTh]h Parameters}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jhjTubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMhjTubj)}(hhh](j)}(h7``struct dentry * parent`` parent of entry to allocate h](j)}(h``struct dentry * parent``h]j)}(hjTh]hstruct dentry * parent}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jhjTubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMhjTubj)}(hhh]h)}(hparent of entry to allocateh]hparent of entry to allocate}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1hhjThMhjTubah}(h]h ]h"]h$]h&]uh1jhjTubeh}(h]h ]h"]h$]h&]uh1jhjThMhjTubj)}(h-``const struct qstr *name`` qstr of the name h](j)}(h``const struct qstr *name``h]j)}(hj Uh]hconst struct qstr *name}(hj UhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjUubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMhjUubj)}(hhh]h)}(hqstr of the nameh]hqstr of the name}(hj#UhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjUhMhj Uubah}(h]h ]h"]h$]h&]uh1jhjUubeh}(h]h ]h"]h$]h&]uh1jhjUhMhjTubeh}(h]h ]h"]h$]h&]uh1jhjTubh)}(h**Description**h]j)}(hjEUh]h Description}(hjGUhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjCUubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMhjTubh)}(hAllocates a dentry. It returns ``NULL`` if there is insufficient memory available. On a success the dentry is returned. The name passed in is copied and the copy passed in may be reused after this call.h](hAllocates a dentry. It returns }(hj[UhhhNhNubj)}(h``NULL``h]hNULL}(hjcUhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj[Uubh if there is insufficient memory available. On a success the dentry is returned. The name passed in is copied and the copy passed in may be reused after this call.}(hj[UhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMhjTubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjEhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j d_duplicate (C function) c.d_duplicatehNtauh1hhjEhhhNhNubj)}(hhh](j)}(h3struct dentry * d_duplicate (struct dentry *dentry)h]j)}(h1struct dentry *d_duplicate(struct dentry *dentry)h](j )}(hjh]hstruct}(hjUhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjUhhhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMubj2)}(h h]h }(hjUhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjUhhhjUhMubh)}(hhh]jI)}(hdentryh]hdentry}(hjUhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjUubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjUmodnameN classnameNjj )}j ]j)}j d_duplicatesb c.d_duplicateasbuh1hhjUhhhjUhMubj2)}(h h]h }(hjUhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjUhhhjUhMubj)}(hjh]h*}(hjUhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjUhhhjUhMubjC)}(h d_duplicateh]jI)}(hjUh]h d_duplicate}(hjUhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjUubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjUhhhjUhMubj=)}(h(struct dentry *dentry)h]jC)}(hstruct dentry *dentryh](j )}(hjh]hstruct}(hjVhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjVubj2)}(h h]h }(hj#VhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjVubh)}(hhh]jI)}(hdentryh]hdentry}(hj4VhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj1Vubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj6VmodnameN classnameNjj )}j ]jU c.d_duplicateasbuh1hhjVubj2)}(h h]h }(hjRVhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjVubj)}(hjh]h*}(hj`VhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVubjI)}(hdentryh]hdentry}(hjmVhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjVubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjVubah}(h]h ]h"]h$]h&]j`jauh1j<hjUhhhjUhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjUhhhjUhMubah}(h]jUah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjUhMhjUhhubjw)}(hhh]h)}(h0duplicate a dentry for combined atomic operationh]h0duplicate a dentry for combined atomic operation}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMhjVhhubah}(h]h ]h"]h$]h&]uh1jvhjUhhhjUhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjVjjVjjjuh1jhhhjEhNhNubj)}(hX**Parameters** ``struct dentry *dentry`` the dentry to duplicate **Description** Some rename operations need to be combined with another operation inside the filesystem: 1. A cluster filesystem when renaming to an in-use file might need to first "silly-rename" that target out of the way before the main rename 2. A filesystem that supports whiteout might want to create a whiteout in place of the file being moved. For this they need two dentries which temporarily have the same name, before one is renamed. d_duplicate() provides for this. Given a positive hashed dentry, it creates a second in-lookup dentry. Because the original dentry exists, no other thread will try to create an in-lookup dentry, so there can be no race in this create. The caller should d_move() the original to a new name, often via a rename request, and should call d_lookup_done() on the newly created dentry. If the new is instantiated then the old MUST either be moved or dropped. Parent must be locked. **Return** an in-lookup dentry, or -ENOMEM.h](h)}(h**Parameters**h]j)}(hjVh]h Parameters}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjVubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMhjVubj)}(hhh]j)}(h2``struct dentry *dentry`` the dentry to duplicate h](j)}(h``struct dentry *dentry``h]j)}(hjVh]hstruct dentry *dentry}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjVubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMhjVubj)}(hhh]h)}(hthe dentry to duplicateh]hthe dentry to duplicate}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjVhMhjVubah}(h]h ]h"]h$]h&]uh1jhjVubeh}(h]h ]h"]h$]h&]uh1jhjVhMhjVubah}(h]h ]h"]h$]h&]uh1jhjVubh)}(h**Description**h]j)}(hjWh]h Description}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjWubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMhjVubh)}(hXSome rename operations need to be combined with another operation inside the filesystem:h]hXSome rename operations need to be combined with another operation inside the filesystem:}(hj)WhhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMhjVubhenumerated_list)}(hhh](jE)}(hA cluster filesystem when renaming to an in-use file might need to first "silly-rename" that target out of the way before the main renameh]h)}(hA cluster filesystem when renaming to an in-use file might need to first "silly-rename" that target out of the way before the main renameh]hA cluster filesystem when renaming to an in-use file might need to first “silly-rename” that target out of the way before the main rename}(hjAWhhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMhj=Wubah}(h]h ]h"]h$]h&]uh1jEhj:WubjE)}(hfA filesystem that supports whiteout might want to create a whiteout in place of the file being moved. h]h)}(heA filesystem that supports whiteout might want to create a whiteout in place of the file being moved.h]heA filesystem that supports whiteout might want to create a whiteout in place of the file being moved.}(hjZWhhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMhjVWubah}(h]h ]h"]h$]h&]uh1jEhj:Wubeh}(h]h ]h"]h$]h&]enumtypearabicprefixhsuffix.uh1j8WhjVubh)}(hXIFor this they need two dentries which temporarily have the same name, before one is renamed. d_duplicate() provides for this. Given a positive hashed dentry, it creates a second in-lookup dentry. Because the original dentry exists, no other thread will try to create an in-lookup dentry, so there can be no race in this create.h]hXIFor this they need two dentries which temporarily have the same name, before one is renamed. d_duplicate() provides for this. Given a positive hashed dentry, it creates a second in-lookup dentry. Because the original dentry exists, no other thread will try to create an in-lookup dentry, so there can be no race in this create.}(hjzWhhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM hjVubh)}(hThe caller should d_move() the original to a new name, often via a rename request, and should call d_lookup_done() on the newly created dentry. If the new is instantiated then the old MUST either be moved or dropped.h]hThe caller should d_move() the original to a new name, often via a rename request, and should call d_lookup_done() on the newly created dentry. If the new is instantiated then the old MUST either be moved or dropped.}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMhjVubh)}(hParent must be locked.h]hParent must be locked.}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMhjVubh)}(h **Return**h]j)}(hjWh]hReturn}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjWubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMhjVubh)}(h an in-lookup dentry, or -ENOMEM.h]h an in-lookup dentry, or -ENOMEM.}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMhjVubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjEhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j d_instantiate (C function)c.d_instantiatehNtauh1hhjEhhhNhNubj)}(hhh](j)}(h?void d_instantiate (struct dentry *entry, struct inode * inode)h]j)}(h=void d_instantiate(struct dentry *entry, struct inode *inode)h](j)}(hvoidh]hvoid}(hjWhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjWhhhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMubj2)}(h h]h }(hjWhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjWhhhjWhMubjC)}(h d_instantiateh]jI)}(h d_instantiateh]h d_instantiate}(hjXhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj Xubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjWhhhjWhMubj=)}(h+(struct dentry *entry, struct inode *inode)h](jC)}(hstruct dentry *entryh](j )}(hjh]hstruct}(hj+XhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj'Xubj2)}(h h]h }(hj8XhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj'Xubh)}(hhh]jI)}(hdentryh]hdentry}(hjIXhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjFXubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjKXmodnameN classnameNjj )}j ]j)}jjXsbc.d_instantiateasbuh1hhj'Xubj2)}(h h]h }(hjiXhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj'Xubj)}(hjh]h*}(hjwXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj'XubjI)}(hentryh]hentry}(hjXhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj'Xubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj#XubjC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hjXhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjXubj2)}(h h]h }(hjXhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjXubh)}(hhh]jI)}(hinodeh]hinode}(hjXhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjXubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjXmodnameN classnameNjj )}j ]jeXc.d_instantiateasbuh1hhjXubj2)}(h h]h }(hjXhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjXubj)}(hjh]h*}(hjXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjXubjI)}(hinodeh]hinode}(hjXhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjXubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj#Xubeh}(h]h ]h"]h$]h&]j`jauh1j<hjWhhhjWhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjWhhhjWhMubah}(h]jWah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjWhMhjWhhubjw)}(hhh]h)}(h&fill in inode information for a dentryh]h&fill in inode information for a dentry}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMhjYhhubah}(h]h ]h"]h$]h&]uh1jvhjWhhhjWhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjj6Yjj6Yjjjuh1jhhhjEhNhNubj)}(hX**Parameters** ``struct dentry *entry`` dentry to complete ``struct inode * inode`` inode to attach to this dentry **Description** Fill in inode information in the entry. This turns negative dentries into productive full members of society. NOTE! This assumes that the inode count has been incremented (or otherwise set) by the caller to indicate that it is now in use by the dcache.h](h)}(h**Parameters**h]j)}(hj@Yh]h Parameters}(hjBYhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj>Yubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMhj:Yubj)}(hhh](j)}(h,``struct dentry *entry`` dentry to complete h](j)}(h``struct dentry *entry``h]j)}(hj_Yh]hstruct dentry *entry}(hjaYhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj]Yubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMhjYYubj)}(hhh]h)}(hdentry to completeh]hdentry to complete}(hjxYhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjtYhMhjuYubah}(h]h ]h"]h$]h&]uh1jhjYYubeh}(h]h ]h"]h$]h&]uh1jhjtYhMhjVYubj)}(h8``struct inode * inode`` inode to attach to this dentry h](j)}(h``struct inode * inode``h]j)}(hjYh]hstruct inode * inode}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjYubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMhjYubj)}(hhh]h)}(hinode to attach to this dentryh]hinode to attach to this dentry}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjYhMhjYubah}(h]h ]h"]h$]h&]uh1jhjYubeh}(h]h ]h"]h$]h&]uh1jhjYhMhjVYubeh}(h]h ]h"]h$]h&]uh1jhj:Yubh)}(h**Description**h]j)}(hjYh]h Description}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjYubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMhj:Yubh)}(h'Fill in inode information in the entry.h]h'Fill in inode information in the entry.}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMhj:Yubh)}(hEThis turns negative dentries into productive full members of society.h]hEThis turns negative dentries into productive full members of society.}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMhj:Yubh)}(hNOTE! This assumes that the inode count has been incremented (or otherwise set) by the caller to indicate that it is now in use by the dcache.h]hNOTE! This assumes that the inode count has been incremented (or otherwise set) by the caller to indicate that it is now in use by the dcache.}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMhj:Yubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjEhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j d_obtain_alias (C function)c.d_obtain_aliashNtauh1hhjEhhhNhNubj)}(hhh](j)}(h4struct dentry * d_obtain_alias (struct inode *inode)h]j)}(h2struct dentry *d_obtain_alias(struct inode *inode)h](j )}(hjh]hstruct}(hj6ZhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj2ZhhhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMK ubj2)}(h h]h }(hjDZhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj2ZhhhjCZhMK ubh)}(hhh]jI)}(hdentryh]hdentry}(hjUZhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjRZubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjWZmodnameN classnameNjj )}j ]j)}jd_obtain_aliassbc.d_obtain_aliasasbuh1hhj2ZhhhjCZhMK ubj2)}(h h]h }(hjvZhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj2ZhhhjCZhMK ubj)}(hjh]h*}(hjZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2ZhhhjCZhMK ubjC)}(hd_obtain_aliash]jI)}(hjsZh]hd_obtain_alias}(hjZhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjZubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj2ZhhhjCZhMK ubj=)}(h(struct inode *inode)h]jC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hjZhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjZubj2)}(h h]h }(hjZhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjZubh)}(hhh]jI)}(hinodeh]hinode}(hjZhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjZubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjZmodnameN classnameNjj )}j ]jqZc.d_obtain_aliasasbuh1hhjZubj2)}(h h]h }(hjZhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjZubj)}(hjh]h*}(hjZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZubjI)}(hinodeh]hinode}(hj[hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjZubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjZubah}(h]h ]h"]h$]h&]j`jauh1j<hj2ZhhhjCZhMK ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj.ZhhhjCZhMK ubah}(h]j)Zah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjCZhMK hj+Zhhubjw)}(hhh]h)}(h8find or allocate a DISCONNECTED dentry for a given inodeh]h8find or allocate a DISCONNECTED dentry for a given inode}(hj1[hhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMK hj.[hhubah}(h]h ]h"]h$]h&]uh1jvhj+ZhhhjCZhMK ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjI[jjI[jjjuh1jhhhjEhNhNubj)}(hX/**Parameters** ``struct inode *inode`` inode to allocate the dentry for **Description** Obtain a dentry for an inode resulting from NFS filehandle conversion or similar open by handle operations. The returned dentry may be anonymous, or may have a full name (if the inode was already in the cache). When called on a directory inode, we must ensure that the inode only ever has one dentry. If a dentry is found, that is returned instead of allocating a new one. On successful return, the reference to the inode has been transferred to the dentry. In case of an error the reference on the inode is released. To make it easier to use in export operations a ``NULL`` or IS_ERR inode may be passed in and the error will be propagated to the return value, with a ``NULL`` **inode** replaced by ERR_PTR(-ESTALE).h](h)}(h**Parameters**h]j)}(hjS[h]h Parameters}(hjU[hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjQ[ubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMO hjM[ubj)}(hhh]j)}(h9``struct inode *inode`` inode to allocate the dentry for h](j)}(h``struct inode *inode``h]j)}(hjr[h]hstruct inode *inode}(hjt[hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjp[ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chML hjl[ubj)}(hhh]h)}(h inode to allocate the dentry forh]h inode to allocate the dentry for}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj[hML hj[ubah}(h]h ]h"]h$]h&]uh1jhjl[ubeh}(h]h ]h"]h$]h&]uh1jhj[hML hji[ubah}(h]h ]h"]h$]h&]uh1jhjM[ubh)}(h**Description**h]j)}(hj[h]h Description}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj[ubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMN hjM[ubh)}(hObtain a dentry for an inode resulting from NFS filehandle conversion or similar open by handle operations. The returned dentry may be anonymous, or may have a full name (if the inode was already in the cache).h]hObtain a dentry for an inode resulting from NFS filehandle conversion or similar open by handle operations. The returned dentry may be anonymous, or may have a full name (if the inode was already in the cache).}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMM hjM[ubh)}(hWhen called on a directory inode, we must ensure that the inode only ever has one dentry. If a dentry is found, that is returned instead of allocating a new one.h]hWhen called on a directory inode, we must ensure that the inode only ever has one dentry. If a dentry is found, that is returned instead of allocating a new one.}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMQ hjM[ubh)}(hXYOn successful return, the reference to the inode has been transferred to the dentry. In case of an error the reference on the inode is released. To make it easier to use in export operations a ``NULL`` or IS_ERR inode may be passed in and the error will be propagated to the return value, with a ``NULL`` **inode** replaced by ERR_PTR(-ESTALE).h](hOn successful return, the reference to the inode has been transferred to the dentry. In case of an error the reference on the inode is released. To make it easier to use in export operations a }(hj[hhhNhNubj)}(h``NULL``h]hNULL}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj[ubh_ or IS_ERR inode may be passed in and the error will be propagated to the return value, with a }(hj[hhhNhNubj)}(h``NULL``h]hNULL}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj[ubh }(hj[hhhNhNubj)}(h **inode**h]hinode}(hj \hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj[ubh replaced by ERR_PTR(-ESTALE).}(hj[hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMU hjM[ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjEhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j d_obtain_root (C function)c.d_obtain_roothNtauh1hhjEhhhNhNubj)}(hhh](j)}(h3struct dentry * d_obtain_root (struct inode *inode)h]j)}(h1struct dentry *d_obtain_root(struct inode *inode)h](j )}(hjh]hstruct}(hjF\hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjB\hhhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMc ubj2)}(h h]h }(hjT\hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjB\hhhjS\hMc ubh)}(hhh]jI)}(hdentryh]hdentry}(hje\hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjb\ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjg\modnameN classnameNjj )}j ]j)}j d_obtain_rootsbc.d_obtain_rootasbuh1hhjB\hhhjS\hMc ubj2)}(h h]h }(hj\hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjB\hhhjS\hMc ubj)}(hjh]h*}(hj\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjB\hhhjS\hMc ubjC)}(h d_obtain_rooth]jI)}(hj\h]h d_obtain_root}(hj\hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj\ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjB\hhhjS\hMc ubj=)}(h(struct inode *inode)h]jC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hj\hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj\ubj2)}(h h]h }(hj\hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj\ubh)}(hhh]jI)}(hinodeh]hinode}(hj\hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj\ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj\modnameN classnameNjj )}j ]j\c.d_obtain_rootasbuh1hhj\ubj2)}(h h]h }(hj\hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj\ubj)}(hjh]h*}(hj ]hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\ubjI)}(hinodeh]hinode}(hj]hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj\ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj\ubah}(h]h ]h"]h$]h&]j`jauh1j<hjB\hhhjS\hMc ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj>\hhhjS\hMc ubah}(h]j9\ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjS\hMc hj;\hhubjw)}(hhh]h)}(h+find or allocate a dentry for a given inodeh]h+find or allocate a dentry for a given inode}(hjA]hhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMc hj>]hhubah}(h]h ]h"]h$]h&]uh1jvhj;\hhhjS\hMc ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjY]jjY]jjjuh1jhhhjEhNhNubj)}(hXR**Parameters** ``struct inode *inode`` inode to allocate the dentry for **Description** Obtain an IS_ROOT dentry for the root of a filesystem. We must ensure that directory inodes only ever have one dentry. If a dentry is found, that is returned instead of allocating a new one. On successful return, the reference to the inode has been transferred to the dentry. In case of an error the reference on the inode is released. A ``NULL`` or IS_ERR inode may be passed in and will be the error will be propagate to the return value, with a ``NULL`` **inode** replaced by ERR_PTR(-ESTALE).h](h)}(h**Parameters**h]j)}(hjc]h]h Parameters}(hje]hhhNhNubah}(h]h ]h"]h$]h&]uh1jhja]ubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMg hj]]ubj)}(hhh]j)}(h9``struct inode *inode`` inode to allocate the dentry for h](j)}(h``struct inode *inode``h]j)}(hj]h]hstruct inode *inode}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj]ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMd hj|]ubj)}(hhh]h)}(h inode to allocate the dentry forh]h inode to allocate the dentry for}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj]hMd hj]ubah}(h]h ]h"]h$]h&]uh1jhj|]ubeh}(h]h ]h"]h$]h&]uh1jhj]hMd hjy]ubah}(h]h ]h"]h$]h&]uh1jhj]]ubh)}(h**Description**h]j)}(hj]h]h Description}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj]ubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMf hj]]ubh)}(h6Obtain an IS_ROOT dentry for the root of a filesystem.h]h6Obtain an IS_ROOT dentry for the root of a filesystem.}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMe hj]]ubh)}(hWe must ensure that directory inodes only ever have one dentry. If a dentry is found, that is returned instead of allocating a new one.h]hWe must ensure that directory inodes only ever have one dentry. If a dentry is found, that is returned instead of allocating a new one.}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMg hj]]ubh)}(hX3On successful return, the reference to the inode has been transferred to the dentry. In case of an error the reference on the inode is released. A ``NULL`` or IS_ERR inode may be passed in and will be the error will be propagate to the return value, with a ``NULL`` **inode** replaced by ERR_PTR(-ESTALE).h](hOn successful return, the reference to the inode has been transferred to the dentry. In case of an error the reference on the inode is released. A }(hj]hhhNhNubj)}(h``NULL``h]hNULL}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj]ubhf or IS_ERR inode may be passed in and will be the error will be propagate to the return value, with a }(hj]hhhNhNubj)}(h``NULL``h]hNULL}(hj ^hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj]ubh }(hj]hhhNhNubj)}(h **inode**h]hinode}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj]ubh replaced by ERR_PTR(-ESTALE).}(hj]hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMj hj]]ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjEhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j d_add_ci (C function) c.d_add_cihNtauh1hhjEhhhNhNubj)}(hhh](j)}(hXstruct dentry * d_add_ci (struct dentry *dentry, struct inode *inode, struct qstr *name)h]j)}(hVstruct dentry *d_add_ci(struct dentry *dentry, struct inode *inode, struct qstr *name)h](j )}(hjh]hstruct}(hjV^hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjR^hhhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMx ubj2)}(h h]h }(hjd^hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjR^hhhjc^hMx ubh)}(hhh]jI)}(hdentryh]hdentry}(hju^hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjr^ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjw^modnameN classnameNjj )}j ]j)}jd_add_cisb c.d_add_ciasbuh1hhjR^hhhjc^hMx ubj2)}(h h]h }(hj^hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjR^hhhjc^hMx ubj)}(hjh]h*}(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjR^hhhjc^hMx ubjC)}(hd_add_cih]jI)}(hj^h]hd_add_ci}(hj^hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj^ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjR^hhhjc^hMx ubj=)}(h?(struct dentry *dentry, struct inode *inode, struct qstr *name)h](jC)}(hstruct dentry *dentryh](j )}(hjh]hstruct}(hj^hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj^ubj2)}(h h]h }(hj^hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj^ubh)}(hhh]jI)}(hdentryh]hdentry}(hj^hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj^ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj^modnameN classnameNjj )}j ]j^ c.d_add_ciasbuh1hhj^ubj2)}(h h]h }(hj _hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj^ubj)}(hjh]h*}(hj_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^ubjI)}(hdentryh]hdentry}(hj'_hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj^ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj^ubjC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hj@_hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj<_ubj2)}(h h]h }(hjM_hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj<_ubh)}(hhh]jI)}(hinodeh]hinode}(hj^_hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj[_ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj`_modnameN classnameNjj )}j ]j^ c.d_add_ciasbuh1hhj<_ubj2)}(h h]h }(hj|_hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj<_ubj)}(hjh]h*}(hj_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj<_ubjI)}(hinodeh]hinode}(hj_hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj<_ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj^ubjC)}(hstruct qstr *nameh](j )}(hjh]hstruct}(hj_hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj_ubj2)}(h h]h }(hj_hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj_ubh)}(hhh]jI)}(hqstrh]hqstr}(hj_hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj_ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj_modnameN classnameNjj )}j ]j^ c.d_add_ciasbuh1hhj_ubj2)}(h h]h }(hj_hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj_ubj)}(hjh]h*}(hj_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj_ubjI)}(hnameh]hname}(hj`hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj_ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj^ubeh}(h]h ]h"]h$]h&]j`jauh1j<hjR^hhhjc^hMx ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjN^hhhjc^hMx ubah}(h]jI^ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjc^hMx hjK^hhubjw)}(hhh]h)}(h2lookup or allocate new dentry with case-exact nameh]h2lookup or allocate new dentry with case-exact name}(hj1`hhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMx hj.`hhubah}(h]h ]h"]h$]h&]uh1jvhjK^hhhjc^hMx ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjI`jjI`jjjuh1jhhhjEhNhNubj)}(hX**Parameters** ``struct dentry *dentry`` the negative dentry that was passed to the parent's lookup func ``struct inode *inode`` the inode case-insensitive lookup has found ``struct qstr *name`` the case-exact name to be associated with the returned dentry **Description** This is to avoid filling the dcache with case-insensitive names to the same inode, only the actual correct case is stored in the dcache for case-insensitive filesystems. For a case-insensitive lookup match and if the case-exact dentry already exists in the dcache, use it and return it. If no entry exists with the exact case name, allocate new dentry with the exact case, and return the spliced entry.h](h)}(h**Parameters**h]j)}(hjS`h]h Parameters}(hjU`hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjQ`ubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM| hjM`ubj)}(hhh](j)}(hZ``struct dentry *dentry`` the negative dentry that was passed to the parent's lookup func h](j)}(h``struct dentry *dentry``h]j)}(hjr`h]hstruct dentry *dentry}(hjt`hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjp`ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMy hjl`ubj)}(hhh]h)}(h?the negative dentry that was passed to the parent's lookup funch]hAthe negative dentry that was passed to the parent’s lookup func}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj`hMy hj`ubah}(h]h ]h"]h$]h&]uh1jhjl`ubeh}(h]h ]h"]h$]h&]uh1jhj`hMy hji`ubj)}(hD``struct inode *inode`` the inode case-insensitive lookup has found h](j)}(h``struct inode *inode``h]j)}(hj`h]hstruct inode *inode}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj`ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMz hj`ubj)}(hhh]h)}(h+the inode case-insensitive lookup has foundh]h+the inode case-insensitive lookup has found}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj`hMz hj`ubah}(h]h ]h"]h$]h&]uh1jhj`ubeh}(h]h ]h"]h$]h&]uh1jhj`hMz hji`ubj)}(hT``struct qstr *name`` the case-exact name to be associated with the returned dentry h](j)}(h``struct qstr *name``h]j)}(hj`h]hstruct qstr *name}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj`ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM{ hj`ubj)}(hhh]h)}(h=the case-exact name to be associated with the returned dentryh]h=the case-exact name to be associated with the returned dentry}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj`hM{ hj`ubah}(h]h ]h"]h$]h&]uh1jhj`ubeh}(h]h ]h"]h$]h&]uh1jhj`hM{ hji`ubeh}(h]h ]h"]h$]h&]uh1jhjM`ubh)}(h**Description**h]j)}(hjah]h Description}(hj!ahhhNhNubah}(h]h ]h"]h$]h&]uh1jhjaubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM} hjM`ubh)}(hThis is to avoid filling the dcache with case-insensitive names to the same inode, only the actual correct case is stored in the dcache for case-insensitive filesystems.h]hThis is to avoid filling the dcache with case-insensitive names to the same inode, only the actual correct case is stored in the dcache for case-insensitive filesystems.}(hj5ahhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM| hjM`ubh)}(htFor a case-insensitive lookup match and if the case-exact dentry already exists in the dcache, use it and return it.h]htFor a case-insensitive lookup match and if the case-exact dentry already exists in the dcache, use it and return it.}(hjDahhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM hjM`ubh)}(hsIf no entry exists with the exact case name, allocate new dentry with the exact case, and return the spliced entry.h]hsIf no entry exists with the exact case name, allocate new dentry with the exact case, and return the spliced entry.}(hjSahhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM hjM`ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjEhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j d_same_name (C function) c.d_same_namehNtauh1hhjEhhhNhNubj)}(hhh](j)}(hdbool d_same_name (const struct dentry *dentry, const struct dentry *parent, const struct qstr *name)h]j)}(hcbool d_same_name(const struct dentry *dentry, const struct dentry *parent, const struct qstr *name)h](j)}(hjh]hbool}(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~ahhhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM ubj2)}(h h]h }(hjahhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj~ahhhjahM ubjC)}(h d_same_nameh]jI)}(h d_same_nameh]h d_same_name}(hjahhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjaubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj~ahhhjahM ubj=)}(hS(const struct dentry *dentry, const struct dentry *parent, const struct qstr *name)h](jC)}(hconst struct dentry *dentryh](j )}(hjJh]hconst}(hjahhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjaubj2)}(h h]h }(hjahhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjaubj )}(hjh]hstruct}(hjahhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjaubj2)}(h h]h }(hjahhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjaubh)}(hhh]jI)}(hdentryh]hdentry}(hjahhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjaubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjamodnameN classnameNjj )}j ]j)}jjasb c.d_same_nameasbuh1hhjaubj2)}(h h]h }(hjbhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjaubj)}(hjh]h*}(hj%bhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubjI)}(hdentryh]hdentry}(hj2bhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjaubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjaubjC)}(hconst struct dentry *parenth](j )}(hjJh]hconst}(hjKbhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjGbubj2)}(h h]h }(hjXbhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjGbubj )}(hjh]hstruct}(hjfbhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjGbubj2)}(h h]h }(hjsbhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjGbubh)}(hhh]jI)}(hdentryh]hdentry}(hjbhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjbubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjbmodnameN classnameNjj )}j ]jb c.d_same_nameasbuh1hhjGbubj2)}(h h]h }(hjbhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjGbubj)}(hjh]h*}(hjbhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGbubjI)}(hparenth]hparent}(hjbhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjGbubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjaubjC)}(hconst struct qstr *nameh](j )}(hjJh]hconst}(hjbhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjbubj2)}(h h]h }(hjbhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjbubj )}(hjh]hstruct}(hjbhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjbubj2)}(h h]h }(hjbhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjbubh)}(hhh]jI)}(hqstrh]hqstr}(hjchhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj cubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjcmodnameN classnameNjj )}j ]jb c.d_same_nameasbuh1hhjbubj2)}(h h]h }(hj-chhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjbubj)}(hjh]h*}(hj;chhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjbubjI)}(hnameh]hname}(hjHchhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjbubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjaubeh}(h]h ]h"]h$]h&]j`jauh1j<hj~ahhhjahM ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjzahhhjahM ubah}(h]juaah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjahM hjwahhubjw)}(hhh]h)}(h(compare dentry name with case-exact nameh]h(compare dentry name with case-exact name}(hjrchhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM hjochhubah}(h]h ]h"]h$]h&]uh1jvhjwahhhjahM ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjcjjcjjjuh1jhhhjEhNhNubj)}(hX-**Parameters** ``const struct dentry *dentry`` the negative dentry that was passed to the parent's lookup func ``const struct dentry *parent`` parent dentry ``const struct qstr *name`` the case-exact name to be associated with the returned dentry **Return** true if names are same, or falseh](h)}(h**Parameters**h]j)}(hjch]h Parameters}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jhjcubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM hjcubj)}(hhh](j)}(h```const struct dentry *dentry`` the negative dentry that was passed to the parent's lookup func h](j)}(h``const struct dentry *dentry``h]j)}(hjch]hconst struct dentry *dentry}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jhjcubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM hjcubj)}(hhh]h)}(h?the negative dentry that was passed to the parent's lookup funch]hAthe negative dentry that was passed to the parent’s lookup func}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1hhjchM hjcubah}(h]h ]h"]h$]h&]uh1jhjcubeh}(h]h ]h"]h$]h&]uh1jhjchM hjcubj)}(h.``const struct dentry *parent`` parent dentry h](j)}(h``const struct dentry *parent``h]j)}(hjch]hconst struct dentry *parent}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jhjcubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM hjcubj)}(hhh]h)}(h parent dentryh]h parent dentry}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjdhM hjdubah}(h]h ]h"]h$]h&]uh1jhjcubeh}(h]h ]h"]h$]h&]uh1jhjdhM hjcubj)}(hZ``const struct qstr *name`` the case-exact name to be associated with the returned dentry h](j)}(h``const struct qstr *name``h]j)}(hj%dh]hconst struct qstr *name}(hj'dhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj#dubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM hjdubj)}(hhh]h)}(h=the case-exact name to be associated with the returned dentryh]h=the case-exact name to be associated with the returned dentry}(hj>dhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj:dhM hj;dubah}(h]h ]h"]h$]h&]uh1jhjdubeh}(h]h ]h"]h$]h&]uh1jhj:dhM hjcubeh}(h]h ]h"]h$]h&]uh1jhjcubh)}(h **Return**h]j)}(hj`dh]hReturn}(hjbdhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj^dubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM hjcubh)}(h true if names are same, or falseh]h true if names are same, or false}(hjvdhhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM hjcubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjEhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j d_lookup (C function) c.d_lookuphNtauh1hhjEhhhNhNubj)}(hhh](j)}(hOstruct dentry * d_lookup (const struct dentry *parent, const struct qstr *name)h]j)}(hMstruct dentry *d_lookup(const struct dentry *parent, const struct qstr *name)h](j )}(hjh]hstruct}(hjdhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjdhhhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMT ubj2)}(h h]h }(hjdhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjdhhhjdhMT ubh)}(hhh]jI)}(hdentryh]hdentry}(hjdhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjdubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjdmodnameN classnameNjj )}j ]j)}jd_lookupsb c.d_lookupasbuh1hhjdhhhjdhMT ubj2)}(h h]h }(hjdhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjdhhhjdhMT ubj)}(hjh]h*}(hjdhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjdhhhjdhMT ubjC)}(hd_lookuph]jI)}(hjdh]hd_lookup}(hjehhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjeubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjdhhhjdhMT ubj=)}(h6(const struct dentry *parent, const struct qstr *name)h](jC)}(hconst struct dentry *parenth](j )}(hjJh]hconst}(hjehhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjeubj2)}(h h]h }(hj,ehhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjeubj )}(hjh]hstruct}(hj:ehhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjeubj2)}(h h]h }(hjGehhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjeubh)}(hhh]jI)}(hdentryh]hdentry}(hjXehhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjUeubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjZemodnameN classnameNjj )}j ]jd c.d_lookupasbuh1hhjeubj2)}(h h]h }(hjvehhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjeubj)}(hjh]h*}(hjehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubjI)}(hparenth]hparent}(hjehhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjeubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjeubjC)}(hconst struct qstr *nameh](j )}(hjJh]hconst}(hjehhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjeubj2)}(h h]h }(hjehhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjeubj )}(hjh]hstruct}(hjehhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjeubj2)}(h h]h }(hjehhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjeubh)}(hhh]jI)}(hqstrh]hqstr}(hjehhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjeubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjemodnameN classnameNjj )}j ]jd c.d_lookupasbuh1hhjeubj2)}(h h]h }(hjfhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjeubj)}(hjh]h*}(hjfhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubjI)}(hnameh]hname}(hjfhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjeubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjeubeh}(h]h ]h"]h$]h&]j`jauh1j<hjdhhhjdhMT ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjdhhhjdhMT ubah}(h]jdah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjdhMT hjdhhubjw)}(hhh]h)}(hsearch for a dentryh]hsearch for a dentry}(hjFfhhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMT hjCfhhubah}(h]h ]h"]h$]h&]uh1jvhjdhhhjdhMT ubeh}(h]h ](jfunctioneh"]h$]h&]jjjj^fjj^fjjjuh1jhhhjEhNhNubj)}(hX**Parameters** ``const struct dentry *parent`` parent dentry ``const struct qstr *name`` qstr of name we wish to find **Return** dentry, or NULL **Description** d_lookup searches the children of the parent dentry for the name in question. If the dentry is found its reference count is incremented and the dentry is returned. The caller must use dput to free the entry when it has finished using it. ``NULL`` is returned if the dentry does not exist.h](h)}(h**Parameters**h]j)}(hjhfh]h Parameters}(hjjfhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjffubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMX hjbfubj)}(hhh](j)}(h.``const struct dentry *parent`` parent dentry h](j)}(h``const struct dentry *parent``h]j)}(hjfh]hconst struct dentry *parent}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjfubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMU hjfubj)}(hhh]h)}(h parent dentryh]h parent dentry}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjfhMU hjfubah}(h]h ]h"]h$]h&]uh1jhjfubeh}(h]h ]h"]h$]h&]uh1jhjfhMU hj~fubj)}(h9``const struct qstr *name`` qstr of name we wish to find h](j)}(h``const struct qstr *name``h]j)}(hjfh]hconst struct qstr *name}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjfubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMV hjfubj)}(hhh]h)}(hqstr of name we wish to findh]hqstr of name we wish to find}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjfhMV hjfubah}(h]h ]h"]h$]h&]uh1jhjfubeh}(h]h ]h"]h$]h&]uh1jhjfhMV hj~fubeh}(h]h ]h"]h$]h&]uh1jhjbfubh)}(h **Return**h]j)}(hjfh]hReturn}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjfubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMX hjbfubh)}(hdentry, or NULLh]hdentry, or NULL}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMW hjbfubh)}(h**Description**h]j)}(hj"gh]h Description}(hj$ghhhNhNubah}(h]h ]h"]h$]h&]uh1jhj gubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMY hjbfubh)}(hX d_lookup searches the children of the parent dentry for the name in question. If the dentry is found its reference count is incremented and the dentry is returned. The caller must use dput to free the entry when it has finished using it. ``NULL`` is returned if the dentry does not exist.h](hd_lookup searches the children of the parent dentry for the name in question. If the dentry is found its reference count is incremented and the dentry is returned. The caller must use dput to free the entry when it has finished using it. }(hj8ghhhNhNubj)}(h``NULL``h]hNULL}(hj@ghhhNhNubah}(h]h ]h"]h$]h&]uh1jhj8gubh* is returned if the dentry does not exist.}(hj8ghhhNhNubeh}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chMX hjbfubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjEhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j d_delete (C function) c.d_deletehNtauh1hhjEhhhNhNubj)}(hhh](j)}(h&void d_delete (struct dentry * dentry)h]j)}(h$void d_delete(struct dentry *dentry)h](j)}(hvoidh]hvoid}(hjyghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjughhhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM ubj2)}(h h]h }(hjghhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjughhhjghM ubjC)}(hd_deleteh]jI)}(hd_deleteh]hd_delete}(hjghhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjgubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjughhhjghM ubj=)}(h(struct dentry *dentry)h]jC)}(hstruct dentry *dentryh](j )}(hjh]hstruct}(hjghhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjgubj2)}(h h]h }(hjghhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjgubh)}(hhh]jI)}(hdentryh]hdentry}(hjghhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjgubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjgmodnameN classnameNjj )}j ]j)}jjgsb c.d_deleteasbuh1hhjgubj2)}(h h]h }(hjghhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjgubj)}(hjh]h*}(hjhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubjI)}(hdentryh]hdentry}(hjhhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjgubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjgubah}(h]h ]h"]h$]h&]j`jauh1j<hjughhhjghM ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjqghhhjghM ubah}(h]jlgah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjghM hjnghhubjw)}(hhh]h)}(hdelete a dentryh]hdelete a dentry}(hj9hhhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM hj6hhhubah}(h]h ]h"]h$]h&]uh1jvhjnghhhjghM ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjQhjjQhjjjuh1jhhhjEhNhNubj)}(h**Parameters** ``struct dentry * dentry`` The dentry to delete **Description** Turn the dentry into a negative dentry if possible, otherwise remove it from the hash queues so it can be deleted laterh](h)}(h**Parameters**h]j)}(hj[hh]h Parameters}(hj]hhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjYhubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM hjUhubj)}(hhh]j)}(h0``struct dentry * dentry`` The dentry to delete h](j)}(h``struct dentry * dentry``h]j)}(hjzhh]hstruct dentry * dentry}(hj|hhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjxhubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM hjthubj)}(hhh]h)}(hThe dentry to deleteh]hThe dentry to delete}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhM hjhubah}(h]h ]h"]h$]h&]uh1jhjthubeh}(h]h ]h"]h$]h&]uh1jhjhhM hjqhubah}(h]h ]h"]h$]h&]uh1jhjUhubh)}(h**Description**h]j)}(hjhh]h Description}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjhubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM hjUhubh)}(hwTurn the dentry into a negative dentry if possible, otherwise remove it from the hash queues so it can be deleted laterh]hwTurn the dentry into a negative dentry if possible, otherwise remove it from the hash queues so it can be deleted later}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM hjUhubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjEhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j d_rehash (C function) c.d_rehashhNtauh1hhjEhhhNhNubj)}(hhh](j)}(h%void d_rehash (struct dentry * entry)h]j)}(h#void d_rehash(struct dentry *entry)h](j)}(hvoidh]hvoid}(hjhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM ubj2)}(h h]h }(hj ihhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhhjihM ubjC)}(hd_rehashh]jI)}(hd_rehashh]hd_rehash}(hjihhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjiubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhhjihM ubj=)}(h(struct dentry *entry)h]jC)}(hstruct dentry *entryh](j )}(hjh]hstruct}(hj7ihhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj3iubj2)}(h h]h }(hjDihhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj3iubh)}(hhh]jI)}(hdentryh]hdentry}(hjUihhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjRiubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjWimodnameN classnameNjj )}j ]j)}jjisb c.d_rehashasbuh1hhj3iubj2)}(h h]h }(hjuihhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj3iubj)}(hjh]h*}(hjihhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3iubjI)}(hentryh]hentry}(hjihhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj3iubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj/iubah}(h]h ]h"]h$]h&]j`jauh1j<hjhhhhjihM ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhhjihM ubah}(h]jhah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjihM hjhhhubjw)}(hhh]h)}(hadd an entry back to the hashh]hadd an entry back to the hash}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM hjihhubah}(h]h ]h"]h$]h&]uh1jvhjhhhhjihM ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjijjijjjuh1jhhhjEhNhNubj)}(h**Parameters** ``struct dentry * entry`` dentry to add to the hash **Description** Adds a dentry to the hash according to its name.h](h)}(h**Parameters**h]j)}(hjih]h Parameters}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1jhjiubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM hjiubj)}(hhh]j)}(h4``struct dentry * entry`` dentry to add to the hash h](j)}(h``struct dentry * entry``h]j)}(hjih]hstruct dentry * entry}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1jhjiubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM hjiubj)}(hhh]h)}(hdentry to add to the hashh]hdentry to add to the hash}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjjhM hjjubah}(h]h ]h"]h$]h&]uh1jhjiubeh}(h]h ]h"]h$]h&]uh1jhjjhM hjiubah}(h]h ]h"]h$]h&]uh1jhjiubh)}(h**Description**h]j)}(hj6jh]h Description}(hj8jhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj4jubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM hjiubh)}(h0Adds a dentry to the hash according to its name.h]h0Adds a dentry to the hash according to its name.}(hjLjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM hjiubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjEhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j d_alloc_parallel (C function)c.d_alloc_parallelhNtauh1hhjEhhhNhNubj)}(hhh](j)}(hQstruct dentry * d_alloc_parallel (struct dentry *parent, const struct qstr *name)h]j)}(hOstruct dentry *d_alloc_parallel(struct dentry *parent, const struct qstr *name)h](j )}(hjh]hstruct}(hj{jhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjwjhhhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM ubj2)}(h h]h }(hjjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjwjhhhjjhM ubh)}(hhh]jI)}(hdentryh]hdentry}(hjjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjjmodnameN classnameNjj )}j ]j)}jd_alloc_parallelsbc.d_alloc_parallelasbuh1hhjwjhhhjjhM ubj2)}(h h]h }(hjjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjwjhhhjjhM ubj)}(hjh]h*}(hjjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjwjhhhjjhM ubjC)}(hd_alloc_parallelh]jI)}(hjjh]hd_alloc_parallel}(hjjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjwjhhhjjhM ubj=)}(h0(struct dentry *parent, const struct qstr *name)h](jC)}(hstruct dentry *parenth](j )}(hjh]hstruct}(hjjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjjubj2)}(h h]h }(hjkhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjjubh)}(hhh]jI)}(hdentryh]hdentry}(hjkhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjkubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjkmodnameN classnameNjj )}j ]jjc.d_alloc_parallelasbuh1hhjjubj2)}(h h]h }(hj1khhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjjubj)}(hjh]h*}(hj?khhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjjubjI)}(hparenth]hparent}(hjLkhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjjubjC)}(hconst struct qstr *nameh](j )}(hjJh]hconst}(hjekhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjakubj2)}(h h]h }(hjrkhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjakubj )}(hjh]hstruct}(hjkhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjakubj2)}(h h]h }(hjkhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjakubh)}(hhh]jI)}(hqstrh]hqstr}(hjkhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjkubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjkmodnameN classnameNjj )}j ]jjc.d_alloc_parallelasbuh1hhjakubj2)}(h h]h }(hjkhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjakubj)}(hjh]h*}(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjakubjI)}(hnameh]hname}(hjkhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjakubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjwjhhhjjhM ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjsjhhhjjhM ubah}(h]jnjah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjjhM hjpjhhubjw)}(hhh]h)}(h+allocate a new dentry and ensure uniquenessh]h+allocate a new dentry and ensure uniqueness}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM hjkhhubah}(h]h ]h"]h$]h&]uh1jvhjpjhhhjjhM ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjljjljjjuh1jhhhjEhNhNubj)}(hXp**Parameters** ``struct dentry *parent`` dentry of the parent ``const struct qstr *name`` name of the dentry within that parent. **Description** A new dentry is allocated and, providing it is unique, added to the relevant index. If an existing dentry is found with the same parent/name that is not d_in_lookup(), then that is returned instead. If the existing dentry is d_in_lookup(), d_alloc_parallel() waits for that lookup to complete before returning the dentry and then ensures the match is still valid. Thus if the returned dentry is d_in_lookup() then the caller has exclusive access until it completes the lookup. If the returned dentry is not d_in_lookup() then a lookup has already completed. The **name** must already have ->hash set, as can be achieved by e.g. try_lookup_noperm(). **Return** the dentry, whether found or allocated, or an error ``-ENOMEM``.h](h)}(h**Parameters**h]j)}(hj#lh]h Parameters}(hj%lhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj!lubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM hjlubj)}(hhh](j)}(h/``struct dentry *parent`` dentry of the parent h](j)}(h``struct dentry *parent``h]j)}(hjBlh]hstruct dentry *parent}(hjDlhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj@lubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM hjhash set, as can be achieved by e.g. try_lookup_noperm().h](hThe }(hjlhhhNhNubj)}(h**name**h]hname}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjlubhN must already have ->hash set, as can be achieved by e.g. try_lookup_noperm().}(hjlhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM hjlubh)}(h **Return**h]j)}(hjlh]hReturn}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjlubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM hjlubh)}(h@the dentry, whether found or allocated, or an error ``-ENOMEM``.h](h4the dentry, whether found or allocated, or an error }(hjmhhhNhNubj)}(h ``-ENOMEM``h]h-ENOMEM}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjmubh.}(hjmhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM hjlubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjEhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j d_alloc_trylock (C function)c.d_alloc_trylockhNtauh1hhjEhhhNhNubj)}(hhh](j)}(hJstruct dentry * d_alloc_trylock (struct dentry *parent, struct qstr *name)h]j)}(hHstruct dentry *d_alloc_trylock(struct dentry *parent, struct qstr *name)h](j )}(hjh]hstruct}(hjUmhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjQmhhhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM ubj2)}(h h]h }(hjcmhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjQmhhhjbmhM ubh)}(hhh]jI)}(hdentryh]hdentry}(hjtmhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjqmubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjvmmodnameN classnameNjj )}j ]j)}jd_alloc_trylocksbc.d_alloc_trylockasbuh1hhjQmhhhjbmhM ubj2)}(h h]h }(hjmhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjQmhhhjbmhM ubj)}(hjh]h*}(hjmhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjQmhhhjbmhM ubjC)}(hd_alloc_trylockh]jI)}(hjmh]hd_alloc_trylock}(hjmhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjmubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjQmhhhjbmhM ubj=)}(h*(struct dentry *parent, struct qstr *name)h](jC)}(hstruct dentry *parenth](j )}(hjh]hstruct}(hjmhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjmubj2)}(h h]h }(hjmhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjmubh)}(hhh]jI)}(hdentryh]hdentry}(hjmhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjmubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmmodnameN classnameNjj )}j ]jmc.d_alloc_trylockasbuh1hhjmubj2)}(h h]h }(hj nhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjmubj)}(hjh]h*}(hjnhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmubjI)}(hparenth]hparent}(hj&nhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjmubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjmubjC)}(hstruct qstr *nameh](j )}(hjh]hstruct}(hj?nhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj;nubj2)}(h h]h }(hjLnhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj;nubh)}(hhh]jI)}(hqstrh]hqstr}(hj]nhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjZnubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj_nmodnameN classnameNjj )}j ]jmc.d_alloc_trylockasbuh1hhj;nubj2)}(h h]h }(hj{nhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj;nubj)}(hjh]h*}(hjnhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;nubjI)}(hnameh]hname}(hjnhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj;nubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjmubeh}(h]h ]h"]h$]h&]j`jauh1j<hjQmhhhjbmhM ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjMmhhhjbmhM ubah}(h]jHmah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjbmhM hjJmhhubjw)}(hhh]h)}(hfind or allocate a new dentryh]hfind or allocate a new dentry}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM hjnhhubah}(h]h ]h"]h$]h&]uh1jvhjJmhhhjbmhM ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjnjjnjjjuh1jhhhjEhNhNubj)}(hXK**Parameters** ``struct dentry *parent`` dentry of the parent ``struct qstr *name`` name of the dentry within that parent. **Description** A new dentry is allocated and, providing it is unique, added to the relevant index. If an existing dentry is found with the same parent/name that is not d_in_lookup() then that is returned instead. If the existing dentry is d_in_lookup(), d_alloc_trylock() returns with error ``-EWOULDBLOCK``. Thus if the returned dentry is d_in_lookup() then the caller has exclusive access until it completes the lookup. If the returned dentry is not d_in_lookup() then a lookup has already completed. The **name** need not already have ->hash set. **Return** the dentry, whether found or allocated, or an error ``-ENOMEM``, ``-EWOULDBLOCK``, ``-EACCES`` (for a bad name) or anything returned by ->d_hash().h](h)}(h**Parameters**h]j)}(hjnh]h Parameters}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjnubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM hjnubj)}(hhh](j)}(h/``struct dentry *parent`` dentry of the parent h](j)}(h``struct dentry *parent``h]j)}(hjoh]hstruct dentry *parent}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1jhjnubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM hjnubj)}(hhh]h)}(hdentry of the parenth]hdentry of the parent}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1hhjohM hjoubah}(h]h ]h"]h$]h&]uh1jhjnubeh}(h]h ]h"]h$]h&]uh1jhjohM hjnubj)}(h=``struct qstr *name`` name of the dentry within that parent. h](j)}(h``struct qstr *name``h]j)}(hj:oh]hstruct qstr *name}(hjhash set.h](hThe }(hjohhhNhNubj)}(h**name**h]hname}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1jhjoubh" need not already have ->hash set.}(hjohhhNhNubeh}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM hjnubh)}(h **Return**h]j)}(hjoh]hReturn}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1jhjoubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM hjnubh)}(hthe dentry, whether found or allocated, or an error ``-ENOMEM``, ``-EWOULDBLOCK``, ``-EACCES`` (for a bad name) or anything returned by ->d_hash().h](h4the dentry, whether found or allocated, or an error }(hjohhhNhNubj)}(h ``-ENOMEM``h]h-ENOMEM}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1jhjoubh, }(hjohhhNhNubj)}(h``-EWOULDBLOCK``h]h -EWOULDBLOCK}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1jhjoubh, }hjosbj)}(h ``-EACCES``h]h-EACCES}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1jhjoubh5 (for a bad name) or anything returned by ->d_hash().}(hjohhhNhNubeh}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM hjnubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjEhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j d_add (C function)c.d_addhNtauh1hhjEhhhNhNubj)}(hhh](j)}(h6void d_add (struct dentry *entry, struct inode *inode)h]j)}(h5void d_add(struct dentry *entry, struct inode *inode)h](j)}(hvoidh]hvoid}(hjJphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFphhhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM; ubj2)}(h h]h }(hjYphhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjFphhhjXphM; ubjC)}(hd_addh]jI)}(hd_addh]hd_add}(hjkphhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjgpubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjFphhhjXphM; ubj=)}(h+(struct dentry *entry, struct inode *inode)h](jC)}(hstruct dentry *entryh](j )}(hjh]hstruct}(hjphhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjpubj2)}(h h]h }(hjphhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjpubh)}(hhh]jI)}(hdentryh]hdentry}(hjphhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjpubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjpmodnameN classnameNjj )}j ]j)}jjmpsbc.d_addasbuh1hhjpubj2)}(h h]h }(hjphhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjpubj)}(hjh]h*}(hjphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpubjI)}(hentryh]hentry}(hjphhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjpubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjpubjC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hjphhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjpubj2)}(h h]h }(hjqhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjpubh)}(hhh]jI)}(hinodeh]hinode}(hjqhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjqubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjqmodnameN classnameNjj )}j ]jpc.d_addasbuh1hhjpubj2)}(h h]h }(hj5qhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjpubj)}(hjh]h*}(hjCqhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpubjI)}(hinodeh]hinode}(hjPqhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjpubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjpubeh}(h]h ]h"]h$]h&]j`jauh1j<hjFphhhjXphM; ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjBphhhjXphM; ubah}(h]j=pah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjXphM; hj?phhubjw)}(hhh]h)}(hadd dentry to hash queuesh]hadd dentry to hash queues}(hjzqhhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM; hjwqhhubah}(h]h ]h"]h$]h&]uh1jvhj?phhhjXphM; ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjqjjqjjjuh1jhhhjEhNhNubj)}(hX**Parameters** ``struct dentry *entry`` dentry to add ``struct inode *inode`` The inode to attach to this dentry **Description** This adds the entry to the hash queues and initializes **inode**. The entry was actually filled in earlier during d_alloc().h](h)}(h**Parameters**h]j)}(hjqh]h Parameters}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjqubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM? hjqubj)}(hhh](j)}(h'``struct dentry *entry`` dentry to add h](j)}(h``struct dentry *entry``h]j)}(hjqh]hstruct dentry *entry}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjqubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM< hjqubj)}(hhh]h)}(h dentry to addh]h dentry to add}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjqhM< hjqubah}(h]h ]h"]h$]h&]uh1jhjqubeh}(h]h ]h"]h$]h&]uh1jhjqhM< hjqubj)}(h;``struct inode *inode`` The inode to attach to this dentry h](j)}(h``struct inode *inode``h]j)}(hjqh]hstruct inode *inode}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjqubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM= hjqubj)}(hhh]h)}(h"The inode to attach to this dentryh]h"The inode to attach to this dentry}(hj rhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj rhM= hj rubah}(h]h ]h"]h$]h&]uh1jhjqubeh}(h]h ]h"]h$]h&]uh1jhj rhM= hjqubeh}(h]h ]h"]h$]h&]uh1jhjqubh)}(h**Description**h]j)}(hj/rh]h Description}(hj1rhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj-rubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM? hjqubh)}(h|This adds the entry to the hash queues and initializes **inode**. The entry was actually filled in earlier during d_alloc().h](h7This adds the entry to the hash queues and initializes }(hjErhhhNhNubj)}(h **inode**h]hinode}(hjMrhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjErubh<. The entry was actually filled in earlier during d_alloc().}(hjErhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM> hjqubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjEhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j d_splice_alias (C function)c.d_splice_aliashNtauh1hhjEhhhNhNubj)}(hhh](j)}(hKstruct dentry * d_splice_alias (struct inode *inode, struct dentry *dentry)h]j)}(hIstruct dentry *d_splice_alias(struct inode *inode, struct dentry *dentry)h](j )}(hjh]hstruct}(hjrhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjrhhhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM ubj2)}(h h]h }(hjrhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjrhhhjrhM ubh)}(hhh]jI)}(hdentryh]hdentry}(hjrhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjrubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjrmodnameN classnameNjj )}j ]j)}jd_splice_aliassbc.d_splice_aliasasbuh1hhjrhhhjrhM ubj2)}(h h]h }(hjrhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjrhhhjrhM ubj)}(hjh]h*}(hjrhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjrhhhjrhM ubjC)}(hd_splice_aliash]jI)}(hjrh]hd_splice_alias}(hjrhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjrubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjrhhhjrhM ubj=)}(h,(struct inode *inode, struct dentry *dentry)h](jC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hjshhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjrubj2)}(h h]h }(hj shhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjrubh)}(hhh]jI)}(hinodeh]hinode}(hjshhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjsubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj smodnameN classnameNjj )}j ]jrc.d_splice_aliasasbuh1hhjrubj2)}(h h]h }(hjah"]h$]h&]uh1j1hjrubj)}(hjh]h*}(hjJshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjrubjI)}(hinodeh]hinode}(hjWshhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjrubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjrubjC)}(hstruct dentry *dentryh](j )}(hjh]hstruct}(hjpshhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjlsubj2)}(h h]h }(hj}shhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjlsubh)}(hhh]jI)}(hdentryh]hdentry}(hjshhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjsubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjsmodnameN classnameNjj )}j ]jrc.d_splice_aliasasbuh1hhjlsubj2)}(h h]h }(hjshhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjlsubj)}(hjh]h*}(hjshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjlsubjI)}(hdentryh]hdentry}(hjshhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjlsubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjrubeh}(h]h ]h"]h$]h&]j`jauh1j<hjrhhhjrhM ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj~rhhhjrhM ubah}(h]jyrah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjrhM hj{rhhubjw)}(hhh]h)}(h8splice a disconnected dentry into the tree if one existsh]h8splice a disconnected dentry into the tree if one exists}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM hjshhubah}(h]h ]h"]h$]h&]uh1jvhj{rhhhjrhM ubeh}(h]h ](jfunctioneh"]h$]h&]jjjj tjj tjjjuh1jhhhjEhNhNubj)}(hX~**Parameters** ``struct inode *inode`` the inode which may have a disconnected dentry ``struct dentry *dentry`` a negative dentry which we want to point to the inode. **Description** **dentry** must be negative and may be in-lookup or unhashed or hashed. If inode is a directory and has an IS_ROOT alias, then d_move that in place of the given dentry and return it, else simply d_add the inode to the dentry and return NULL. If a non-IS_ROOT directory is found, the filesystem is corrupt, and we should error out: directories can't have multiple aliases. This should be used to return the result of ->lookup() and to instantiate the result of ->mkdir(), is often useful for ->atomic_open, and may be used to instantiate other objects. If a dentry was found and moved, then it is returned. Otherwise NULL is returned. This matches the expected return value of ->lookup and ->mkdir.h](h)}(h**Parameters**h]j)}(hjth]h Parameters}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jhjtubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM hj tubj)}(hhh](j)}(hG``struct inode *inode`` the inode which may have a disconnected dentry h](j)}(h``struct inode *inode``h]j)}(hj2th]hstruct inode *inode}(hj4thhhNhNubah}(h]h ]h"]h$]h&]uh1jhj0tubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM hj,tubj)}(hhh]h)}(h.the inode which may have a disconnected dentryh]h.the inode which may have a disconnected dentry}(hjKthhhNhNubah}(h]h ]h"]h$]h&]uh1hhjGthM hjHtubah}(h]h ]h"]h$]h&]uh1jhj,tubeh}(h]h ]h"]h$]h&]uh1jhjGthM hj)tubj)}(hQ``struct dentry *dentry`` a negative dentry which we want to point to the inode. h](j)}(h``struct dentry *dentry``h]j)}(hjkth]hstruct dentry *dentry}(hjmthhhNhNubah}(h]h ]h"]h$]h&]uh1jhjitubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM hjetubj)}(hhh]h)}(h6a negative dentry which we want to point to the inode.h]h6a negative dentry which we want to point to the inode.}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1hhjthM hjtubah}(h]h ]h"]h$]h&]uh1jhjetubeh}(h]h ]h"]h$]h&]uh1jhjthM hj)tubeh}(h]h ]h"]h$]h&]uh1jhj tubh)}(h**Description**h]j)}(hjth]h Description}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jhjtubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM hj tubh)}(hG**dentry** must be negative and may be in-lookup or unhashed or hashed.h](j)}(h **dentry**h]hdentry}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jhjtubh= must be negative and may be in-lookup or unhashed or hashed.}(hjthhhNhNubeh}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM hj tubh)}(hIf inode is a directory and has an IS_ROOT alias, then d_move that in place of the given dentry and return it, else simply d_add the inode to the dentry and return NULL.h]hIf inode is a directory and has an IS_ROOT alias, then d_move that in place of the given dentry and return it, else simply d_add the inode to the dentry and return NULL.}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM hj tubh)}(hIf a non-IS_ROOT directory is found, the filesystem is corrupt, and we should error out: directories can't have multiple aliases.h]hIf a non-IS_ROOT directory is found, the filesystem is corrupt, and we should error out: directories can’t have multiple aliases.}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM hj tubh)}(hThis should be used to return the result of ->lookup() and to instantiate the result of ->mkdir(), is often useful for ->atomic_open, and may be used to instantiate other objects.h]hThis should be used to return the result of ->lookup() and to instantiate the result of ->mkdir(), is often useful for ->atomic_open, and may be used to instantiate other objects.}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM hj tubh)}(hIf a dentry was found and moved, then it is returned. Otherwise NULL is returned. This matches the expected return value of ->lookup and ->mkdir.h]hIf a dentry was found and moved, then it is returned. Otherwise NULL is returned. This matches the expected return value of ->lookup and ->mkdir.}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM hj tubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjEhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j is_subdir (C function) c.is_subdirhNtauh1hhjEhhhNhNubj)}(hhh](j)}(hEbool is_subdir (struct dentry *new_dentry, struct dentry *old_dentry)h]j)}(hDbool is_subdir(struct dentry *new_dentry, struct dentry *old_dentry)h](j)}(hjh]hbool}(hj5uhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj1uhhhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM ubj2)}(h h]h }(hjCuhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj1uhhhjBuhM ubjC)}(h is_subdirh]jI)}(h is_subdirh]h is_subdir}(hjUuhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjQuubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj1uhhhjBuhM ubj=)}(h6(struct dentry *new_dentry, struct dentry *old_dentry)h](jC)}(hstruct dentry *new_dentryh](j )}(hjh]hstruct}(hjquhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjmuubj2)}(h h]h }(hj~uhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjmuubh)}(hhh]jI)}(hdentryh]hdentry}(hjuhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjuubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjumodnameN classnameNjj )}j ]j)}jjWusb c.is_subdirasbuh1hhjmuubj2)}(h h]h }(hjuhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjmuubj)}(hjh]h*}(hjuhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmuubjI)}(h new_dentryh]h new_dentry}(hjuhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjmuubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjiuubjC)}(hstruct dentry *old_dentryh](j )}(hjh]hstruct}(hjuhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjuubj2)}(h h]h }(hjuhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjuubh)}(hhh]jI)}(hdentryh]hdentry}(hjvhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjuubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjvmodnameN classnameNjj )}j ]ju c.is_subdirasbuh1hhjuubj2)}(h h]h }(hjvhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjuubj)}(hjh]h*}(hj-vhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjuubjI)}(h old_dentryh]h old_dentry}(hj:vhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjuubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjiuubeh}(h]h ]h"]h$]h&]j`jauh1j<hj1uhhhjBuhM ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj-uhhhjBuhM ubah}(h]j(uah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjBuhM hj*uhhubjw)}(hhh]h)}(h*is new dentry a subdirectory of old_dentryh]h*is new dentry a subdirectory of old_dentry}(hjdvhhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM hjavhhubah}(h]h ]h"]h$]h&]uh1jvhj*uhhhjBuhM ubeh}(h]h ](jfunctioneh"]h$]h&]jjjj|vjj|vjjjuh1jhhhjEhNhNubj)}(hX&**Parameters** ``struct dentry *new_dentry`` new dentry ``struct dentry *old_dentry`` old dentry **Description** Returns true if new_dentry is a subdirectory of the parent (at any depth). Returns false otherwise. Caller must ensure that "new_dentry" is pinned before calling is_subdir()h](h)}(h**Parameters**h]j)}(hjvh]h Parameters}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjvubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM hjvubj)}(hhh](j)}(h)``struct dentry *new_dentry`` new dentry h](j)}(h``struct dentry *new_dentry``h]j)}(hjvh]hstruct dentry *new_dentry}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjvubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM hjvubj)}(hhh]h)}(h new dentryh]h new dentry}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjvhM hjvubah}(h]h ]h"]h$]h&]uh1jhjvubeh}(h]h ]h"]h$]h&]uh1jhjvhM hjvubj)}(h)``struct dentry *old_dentry`` old dentry h](j)}(h``struct dentry *old_dentry``h]j)}(hjvh]hstruct dentry *old_dentry}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjvubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM hjvubj)}(hhh]h)}(h old dentryh]h old dentry}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjvhM hjvubah}(h]h ]h"]h$]h&]uh1jhjvubeh}(h]h ]h"]h$]h&]uh1jhjvhM hjvubeh}(h]h ]h"]h$]h&]uh1jhjvubh)}(h**Description**h]j)}(hjwh]h Description}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjwubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM hjvubh)}(hReturns true if new_dentry is a subdirectory of the parent (at any depth). Returns false otherwise. Caller must ensure that "new_dentry" is pinned before calling is_subdir()h]hReturns true if new_dentry is a subdirectory of the parent (at any depth). Returns false otherwise. Caller must ensure that “new_dentry” is pinned before calling is_subdir()}(hj/whhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:20: ./fs/dcache.chM hjvubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjEhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j dget_dlock (C function) c.dget_dlockhNtauh1hhjEhhhNhNubj)}(hhh](j)}(h2struct dentry * dget_dlock (struct dentry *dentry)h]j)}(h0struct dentry *dget_dlock(struct dentry *dentry)h](j )}(hjh]hstruct}(hj^whhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjZwhhh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhMMubj2)}(h h]h }(hjlwhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjZwhhhjkwhMMubh)}(hhh]jI)}(hdentryh]hdentry}(hj}whhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjzwubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjwmodnameN classnameNjj )}j ]j)}j dget_dlocksb c.dget_dlockasbuh1hhjZwhhhjkwhMMubj2)}(h h]h }(hjwhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjZwhhhjkwhMMubj)}(hjh]h*}(hjwhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZwhhhjkwhMMubjC)}(h dget_dlockh]jI)}(hjwh]h dget_dlock}(hjwhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjwubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjZwhhhjkwhMMubj=)}(h(struct dentry *dentry)h]jC)}(hstruct dentry *dentryh](j )}(hjh]hstruct}(hjwhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjwubj2)}(h h]h }(hjwhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjwubh)}(hhh]jI)}(hdentryh]hdentry}(hjwhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjwubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjwmodnameN classnameNjj )}j ]jw c.dget_dlockasbuh1hhjwubj2)}(h h]h }(hjxhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjwubj)}(hjh]h*}(hj"xhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjwubjI)}(hdentryh]hdentry}(hj/xhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjwubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjwubah}(h]h ]h"]h$]h&]j`jauh1j<hjZwhhhjkwhMMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjVwhhhjkwhMMubah}(h]jQwah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjkwhMMhjSwhhubjw)}(hhh]h)}(hget a reference to a dentryh]hget a reference to a dentry}(hjYxhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhMMhjVxhhubah}(h]h ]h"]h$]h&]uh1jvhjSwhhhjkwhMMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjqxjjqxjjjuh1jhhhjEhNhNubj)}(hX**Parameters** ``struct dentry *dentry`` dentry to get a reference to **Description** Given a live dentry, increment the reference count and return the dentry. Caller must hold **dentry->d_lock**. Making sure that dentry is alive is caller's resonsibility. There are many conditions sufficient to guarantee that; e.g. anything with non-negative refcount is alive, so's anything hashed, anything positive, anyone's parent, etc.h](h)}(h**Parameters**h]j)}(hj{xh]h Parameters}(hj}xhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjyxubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhMQhjuxubj)}(hhh]j)}(h7``struct dentry *dentry`` dentry to get a reference to h](j)}(h``struct dentry *dentry``h]j)}(hjxh]hstruct dentry *dentry}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjxubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhMNhjxubj)}(hhh]h)}(hdentry to get a reference toh]hdentry to get a reference to}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjxhMNhjxubah}(h]h ]h"]h$]h&]uh1jhjxubeh}(h]h ]h"]h$]h&]uh1jhjxhMNhjxubah}(h]h ]h"]h$]h&]uh1jhjuxubh)}(h**Description**h]j)}(hjxh]h Description}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjxubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhMPhjuxubh)}(hXVGiven a live dentry, increment the reference count and return the dentry. Caller must hold **dentry->d_lock**. Making sure that dentry is alive is caller's resonsibility. There are many conditions sufficient to guarantee that; e.g. anything with non-negative refcount is alive, so's anything hashed, anything positive, anyone's parent, etc.h](h[Given a live dentry, increment the reference count and return the dentry. Caller must hold }(hjxhhhNhNubj)}(h**dentry->d_lock**h]hdentry->d_lock}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjxubh. Making sure that dentry is alive is caller’s resonsibility. There are many conditions sufficient to guarantee that; e.g. anything with non-negative refcount is alive, so’s anything hashed, anything positive, anyone’s parent, etc.}(hjxhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhMOhjuxubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjEhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j dget (C function)c.dgethNtauh1hhjEhhhNhNubj)}(hhh](j)}(h,struct dentry * dget (struct dentry *dentry)h]j)}(h*struct dentry *dget(struct dentry *dentry)h](j )}(hjh]hstruct}(hj,yhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj(yhhh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhM^ubj2)}(h h]h }(hj:yhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj(yhhhj9yhM^ubh)}(hhh]jI)}(hdentryh]hdentry}(hjKyhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjHyubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjMymodnameN classnameNjj )}j ]j)}jdgetsbc.dgetasbuh1hhj(yhhhj9yhM^ubj2)}(h h]h }(hjlyhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj(yhhhj9yhM^ubj)}(hjh]h*}(hjzyhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(yhhhj9yhM^ubjC)}(hdgeth]jI)}(hjiyh]hdget}(hjyhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjyubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj(yhhhj9yhM^ubj=)}(h(struct dentry *dentry)h]jC)}(hstruct dentry *dentryh](j )}(hjh]hstruct}(hjyhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjyubj2)}(h h]h }(hjyhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjyubh)}(hhh]jI)}(hdentryh]hdentry}(hjyhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjyubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjymodnameN classnameNjj )}j ]jgyc.dgetasbuh1hhjyubj2)}(h h]h }(hjyhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjyubj)}(hjh]h*}(hjyhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyubjI)}(hdentryh]hdentry}(hjyhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjyubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjyubah}(h]h ]h"]h$]h&]j`jauh1j<hj(yhhhj9yhM^ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj$yhhhj9yhM^ubah}(h]jyah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj9yhM^hj!yhhubjw)}(hhh]h)}(hget a reference to a dentryh]hget a reference to a dentry}(hj'zhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhM^hj$zhhubah}(h]h ]h"]h$]h&]uh1jvhj!yhhhj9yhM^ubeh}(h]h ](jfunctioneh"]h$]h&]jjjj?zjj?zjjjuh1jhhhjEhNhNubj)}(hX**Parameters** ``struct dentry *dentry`` dentry to get a reference to **Description** Given a dentry or ``NULL`` pointer increment the reference count if appropriate and return the dentry. A dentry will not be destroyed when it has references. Conversely, a dentry with no references can disappear for any number of reasons, starting with memory pressure. In other words, that primitive is used to clone an existing reference; using it on something with zero refcount is a bug. **NOTE** it will spin if **dentry->d_lock** is held. From the deadlock avoidance point of view it is equivalent to spin_lock()/increment refcount/spin_unlock(), so calling it under **dentry->d_lock** is always a bug; so's calling it under ->d_lock on any of its descendents.h](h)}(h**Parameters**h]j)}(hjIzh]h Parameters}(hjKzhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjGzubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhMbhjCzubj)}(hhh]j)}(h7``struct dentry *dentry`` dentry to get a reference to h](j)}(h``struct dentry *dentry``h]j)}(hjhzh]hstruct dentry *dentry}(hjjzhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjfzubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhM_hjbzubj)}(hhh]h)}(hdentry to get a reference toh]hdentry to get a reference to}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj}zhM_hj~zubah}(h]h ]h"]h$]h&]uh1jhjbzubeh}(h]h ]h"]h$]h&]uh1jhj}zhM_hj_zubah}(h]h ]h"]h$]h&]uh1jhjCzubh)}(h**Description**h]j)}(hjzh]h Description}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjzubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhMahjCzubh)}(hXGiven a dentry or ``NULL`` pointer increment the reference count if appropriate and return the dentry. A dentry will not be destroyed when it has references. Conversely, a dentry with no references can disappear for any number of reasons, starting with memory pressure. In other words, that primitive is used to clone an existing reference; using it on something with zero refcount is a bug.h](hGiven a dentry or }(hjzhhhNhNubj)}(h``NULL``h]hNULL}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjzubhXp pointer increment the reference count if appropriate and return the dentry. A dentry will not be destroyed when it has references. Conversely, a dentry with no references can disappear for any number of reasons, starting with memory pressure. In other words, that primitive is used to clone an existing reference; using it on something with zero refcount is a bug.}(hjzhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhM`hjCzubh)}(h**NOTE**h]j)}(hjzh]hNOTE}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjzubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhMhhjCzubh)}(hX it will spin if **dentry->d_lock** is held. From the deadlock avoidance point of view it is equivalent to spin_lock()/increment refcount/spin_unlock(), so calling it under **dentry->d_lock** is always a bug; so's calling it under ->d_lock on any of its descendents.h](hit will spin if }(hjzhhhNhNubj)}(h**dentry->d_lock**h]hdentry->d_lock}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjzubh is held. From the deadlock avoidance point of view it is equivalent to spin_lock()/increment refcount/spin_unlock(), so calling it under }(hjzhhhNhNubj)}(h**dentry->d_lock**h]hdentry->d_lock}(hj {hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjzubhM is always a bug; so’s calling it under ->d_lock on any of its descendents.}(hjzhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhMihjCzubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjEhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j d_unhashed (C function) c.d_unhashedhNtauh1hhjEhhhNhNubj)}(hhh](j)}(h,int d_unhashed (const struct dentry *dentry)h]j)}(h+int d_unhashed(const struct dentry *dentry)h](j)}(hinth]hint}(hjE{hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjA{hhh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhMubj2)}(h h]h }(hjT{hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjA{hhhjS{hMubjC)}(h d_unhashedh]jI)}(h d_unhashedh]h d_unhashed}(hjf{hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjb{ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjA{hhhjS{hMubj=)}(h(const struct dentry *dentry)h]jC)}(hconst struct dentry *dentryh](j )}(hjJh]hconst}(hj{hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj~{ubj2)}(h h]h }(hj{hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj~{ubj )}(hjh]hstruct}(hj{hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj~{ubj2)}(h h]h }(hj{hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj~{ubh)}(hhh]jI)}(hdentryh]hdentry}(hj{hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj{ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj{modnameN classnameNjj )}j ]j)}jjh{sb c.d_unhashedasbuh1hhj~{ubj2)}(h h]h }(hj{hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj~{ubj)}(hjh]h*}(hj{hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~{ubjI)}(hdentryh]hdentry}(hj{hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj~{ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjz{ubah}(h]h ]h"]h$]h&]j`jauh1j<hjA{hhhjS{hMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj={hhhjS{hMubah}(h]j8{ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjS{hMhj:{hhubjw)}(hhh]h)}(his dentry hashedh]his dentry hashed}(hj |hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhMhj|hhubah}(h]h ]h"]h$]h&]uh1jvhj:{hhhjS{hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjj8|jj8|jjjuh1jhhhjEhNhNubj)}(h**Parameters** ``const struct dentry *dentry`` entry to check **Description** Returns true if the dentry passed is not currently hashed.h](h)}(h**Parameters**h]j)}(hjB|h]h Parameters}(hjD|hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj@|ubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhMhj<|ubj)}(hhh]j)}(h/``const struct dentry *dentry`` entry to check h](j)}(h``const struct dentry *dentry``h]j)}(hja|h]hconst struct dentry *dentry}(hjc|hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj_|ubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhMhj[|ubj)}(hhh]h)}(hentry to checkh]hentry to check}(hjz|hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjv|hMhjw|ubah}(h]h ]h"]h$]h&]uh1jhj[|ubeh}(h]h ]h"]h$]h&]uh1jhjv|hMhjX|ubah}(h]h ]h"]h$]h&]uh1jhj<|ubh)}(h**Description**h]j)}(hj|h]h Description}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj|ubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhMhj<|ubh)}(h:Returns true if the dentry passed is not currently hashed.h]h:Returns true if the dentry passed is not currently hashed.}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhMhj<|ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjEhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j !d_really_is_negative (C function)c.d_really_is_negativehNtauh1hhjEhhhNhNubj)}(hhh](j)}(h7bool d_really_is_negative (const struct dentry *dentry)h]j)}(h6bool d_really_is_negative(const struct dentry *dentry)h](j)}(hjh]hbool}(hj|hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|hhh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhMubj2)}(h h]h }(hj|hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj|hhhj|hMubjC)}(hd_really_is_negativeh]jI)}(hd_really_is_negativeh]hd_really_is_negative}(hj}hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj|ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj|hhhj|hMubj=)}(h(const struct dentry *dentry)h]jC)}(hconst struct dentry *dentryh](j )}(hjJh]hconst}(hj}hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj}ubj2)}(h h]h }(hj*}hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj}ubj )}(hjh]hstruct}(hj8}hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj}ubj2)}(h h]h }(hjE}hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj}ubh)}(hhh]jI)}(hdentryh]hdentry}(hjV}hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjS}ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjX}modnameN classnameNjj )}j ]j)}jj}sbc.d_really_is_negativeasbuh1hhj}ubj2)}(h h]h }(hjv}hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj}ubj)}(hjh]h*}(hj}hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj}ubjI)}(hdentryh]hdentry}(hj}hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj}ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj}ubah}(h]h ]h"]h$]h&]j`jauh1j<hj|hhhj|hMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj|hhhj|hMubah}(h]j|ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj|hMhj|hhubjw)}(hhh]h)}(h@Determine if a dentry is really negative (ignoring fallthroughs)h]h@Determine if a dentry is really negative (ignoring fallthroughs)}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhMhj}hhubah}(h]h ]h"]h$]h&]uh1jvhj|hhhj|hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjj}jj}jjjuh1jhhhjEhNhNubj)}(hX**Parameters** ``const struct dentry *dentry`` The dentry in question **Description** Returns true if the dentry represents either an absent name or a name that doesn't map to an inode (ie. ->d_inode is NULL). The dentry could represent a true miss, a whiteout that isn't represented by a 0,0 chardev or a fallthrough marker in an opaque directory. Note! (1) This should be used *only* by a filesystem to examine its own dentries. It should not be used to look at some other filesystem's dentries. (2) It should also be used in combination with d_inode() to get the inode. (3) The dentry may have something attached to ->d_lower and the type field of the flags may be set to something other than miss or whiteout.h](h)}(h**Parameters**h]j)}(hj}h]h Parameters}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj}ubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhM hj}ubj)}(hhh]j)}(h7``const struct dentry *dentry`` The dentry in question h](j)}(h``const struct dentry *dentry``h]j)}(hj}h]hconst struct dentry *dentry}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj}ubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhMhj}ubj)}(hhh]h)}(hThe dentry in questionh]hThe dentry in question}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj~hMhj~ubah}(h]h ]h"]h$]h&]uh1jhj}ubeh}(h]h ]h"]h$]h&]uh1jhj~hMhj}ubah}(h]h ]h"]h$]h&]uh1jhj}ubh)}(h**Description**h]j)}(hj7~h]h Description}(hj9~hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj5~ubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhMhj}ubh)}(hXReturns true if the dentry represents either an absent name or a name that doesn't map to an inode (ie. ->d_inode is NULL). The dentry could represent a true miss, a whiteout that isn't represented by a 0,0 chardev or a fallthrough marker in an opaque directory.h]hX Returns true if the dentry represents either an absent name or a name that doesn’t map to an inode (ie. ->d_inode is NULL). The dentry could represent a true miss, a whiteout that isn’t represented by a 0,0 chardev or a fallthrough marker in an opaque directory.}(hjM~hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhMhj}ubh)}(hXpNote! (1) This should be used *only* by a filesystem to examine its own dentries. It should not be used to look at some other filesystem's dentries. (2) It should also be used in combination with d_inode() to get the inode. (3) The dentry may have something attached to ->d_lower and the type field of the flags may be set to something other than miss or whiteout.h](hNote! (1) This should be used }(hj\~hhhNhNubj )}(h*only*h]honly}(hjd~hhhNhNubah}(h]h ]h"]h$]h&]uh1j~ hj\~ubhXM by a filesystem to examine its own dentries. It should not be used to look at some other filesystem’s dentries. (2) It should also be used in combination with d_inode() to get the inode. (3) The dentry may have something attached to ->d_lower and the type field of the flags may be set to something other than miss or whiteout.}(hj\~hhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhM hj}ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjEhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j !d_really_is_positive (C function)c.d_really_is_positivehNtauh1hhjEhhhNhNubj)}(hhh](j)}(h7bool d_really_is_positive (const struct dentry *dentry)h]j)}(h6bool d_really_is_positive(const struct dentry *dentry)h](j)}(hjh]hbool}(hj~hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~hhh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhMubj2)}(h h]h }(hj~hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj~hhhj~hMubjC)}(hd_really_is_positiveh]jI)}(hd_really_is_positiveh]hd_really_is_positive}(hj~hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj~ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj~hhhj~hMubj=)}(h(const struct dentry *dentry)h]jC)}(hconst struct dentry *dentryh](j )}(hjJh]hconst}(hj~hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj~ubj2)}(h h]h }(hj~hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj~ubj )}(hjh]hstruct}(hj~hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj~ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj~ubh)}(hhh]jI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jj~sbc.d_really_is_positiveasbuh1hhj~ubj2)}(h h]h }(hj2hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj~ubj)}(hjh]h*}(hj@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~ubjI)}(hdentryh]hdentry}(hjMhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj~ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj~ubah}(h]h ]h"]h$]h&]j`jauh1j<hj~hhhj~hMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj~hhhj~hMubah}(h]j~ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj~hMhj~hhubjw)}(hhh]h)}(h@Determine if a dentry is really positive (ignoring fallthroughs)h]h@Determine if a dentry is really positive (ignoring fallthroughs)}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhMhjthhubah}(h]h ]h"]h$]h&]uh1jvhj~hhhj~hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjEhNhNubj)}(hX**Parameters** ``const struct dentry *dentry`` The dentry in question **Description** Returns true if the dentry represents a name that maps to an inode (ie. ->d_inode is not NULL). The dentry might still represent a whiteout if that is represented on medium as a 0,0 chardev. Note! (1) This should be used *only* by a filesystem to examine its own dentries. It should not be used to look at some other filesystem's dentries. (2) It should also be used in combination with d_inode() to get the inode.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhMhjubj)}(hhh]j)}(h7``const struct dentry *dentry`` The dentry in question h](j)}(h``const struct dentry *dentry``h]j)}(hjh]hconst struct dentry *dentry}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhMhjubj)}(hhh]h)}(hThe dentry in questionh]hThe dentry in question}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhMhjubh)}(hReturns true if the dentry represents a name that maps to an inode (ie. ->d_inode is not NULL). The dentry might still represent a whiteout if that is represented on medium as a 0,0 chardev.h]hReturns true if the dentry represents a name that maps to an inode (ie. ->d_inode is not NULL). The dentry might still represent a whiteout if that is represented on medium as a 0,0 chardev.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhMhjubh)}(hNote! (1) This should be used *only* by a filesystem to examine its own dentries. It should not be used to look at some other filesystem's dentries. (2) It should also be used in combination with d_inode() to get the inode.h](hNote! (1) This should be used }(hjhhhNhNubj )}(h*only*h]honly}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j~ hjubh by a filesystem to examine its own dentries. It should not be used to look at some other filesystem’s dentries. (2) It should also be used in combination with d_inode() to get the inode.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjEhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j d_lookup_release (C function)c.d_lookup_releasehNtauh1hhjEhhhNhNubj)}(hhh](j)}(h-void d_lookup_release (struct dentry *dentry)h]j)}(h,void d_lookup_release(struct dentry *dentry)h](j)}(hvoidh]hvoid}(hjYhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjUhhh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhM2ubj2)}(h h]h }(hjhhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjUhhhjghM2ubjC)}(hd_lookup_releaseh]jI)}(hd_lookup_releaseh]hd_lookup_release}(hjzhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjvubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjUhhhjghM2ubj=)}(h(struct dentry *dentry)h]jC)}(hstruct dentry *dentryh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jj|sbc.d_lookup_releaseasbuh1hhjubj2)}(h h]h }(hjԀhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubah}(h]h ]h"]h$]h&]j`jauh1j<hjUhhhjghM2ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjQhhhjghM2ubah}(h]jLah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjghM2hjNhhubjw)}(hhh]h)}(h+release ownership of DCACHE_PAR_LOOKUP lockh]h+release ownership of DCACHE_PAR_LOOKUP lock}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhM2hjhhubah}(h]h ]h"]h$]h&]uh1jvhjNhhhjghM2ubeh}(h]h ](jfunctioneh"]h$]h&]jjjj1jj1jjjuh1jhhhjEhNhNubj)}(hXe**Parameters** ``struct dentry *dentry`` dentry that is locked **Description** If an in-lookup dentry is to be passed to another thread which will drop the in-lookup lock, then d_lookup_release() must be called to tell lockdep that this thread no lock holds the lock. The thread that receives the lock must call d_lookup_acquire() to acquire the lock.h](h)}(h**Parameters**h]j)}(hj;h]h Parameters}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj9ubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhM6hj5ubj)}(hhh]j)}(h0``struct dentry *dentry`` dentry that is locked h](j)}(h``struct dentry *dentry``h]j)}(hjZh]hstruct dentry *dentry}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjXubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhM3hjTubj)}(hhh]h)}(hdentry that is lockedh]hdentry that is locked}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1hhjohM3hjpubah}(h]h ]h"]h$]h&]uh1jhjTubeh}(h]h ]h"]h$]h&]uh1jhjohM3hjQubah}(h]h ]h"]h$]h&]uh1jhj5ubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhM5hj5ubh)}(hXIf an in-lookup dentry is to be passed to another thread which will drop the in-lookup lock, then d_lookup_release() must be called to tell lockdep that this thread no lock holds the lock. The thread that receives the lock must call d_lookup_acquire() to acquire the lock.h]hXIf an in-lookup dentry is to be passed to another thread which will drop the in-lookup lock, then d_lookup_release() must be called to tell lockdep that this thread no lock holds the lock. The thread that receives the lock must call d_lookup_acquire() to acquire the lock.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhM4hj5ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjEhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j d_lookup_acquire (C function)c.d_lookup_acquirehNtauh1hhjEhhhNhNubj)}(hhh](j)}(h-void d_lookup_acquire (struct dentry *dentry)h]j)}(h,void d_lookup_acquire(struct dentry *dentry)h](j)}(hvoidh]hvoid}(hjځhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjցhhh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhMBubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjցhhhjhMBubjC)}(hd_lookup_acquireh]jI)}(hd_lookup_acquireh]hd_lookup_acquire}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjցhhhjhMBubj=)}(h(struct dentry *dentry)h]jC)}(hstruct dentry *dentryh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hj$hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hdentryh]hdentry}(hj5hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj2ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj7modnameN classnameNjj )}j ]j)}jjsbc.d_lookup_acquireasbuh1hhjubj2)}(h h]h }(hjUhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjchhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hdentryh]hdentry}(hjphhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubah}(h]h ]h"]h$]h&]j`jauh1j<hjցhhhjhMBubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjҁhhhjhMBubah}(h]j́ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMBhjρhhubjw)}(hhh]h)}(h+acquire ownership of DCACHE_PAR_LOOKUP lockh]h+acquire ownership of DCACHE_PAR_LOOKUP lock}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhMBhjhhubah}(h]h ]h"]h$]h&]uh1jvhjρhhhjhMBubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjEhNhNubj)}(h**Parameters** ``struct dentry *dentry`` dentry that is locked **Description** If an in-lookup dentry was passed to this thread, the d_lookup_acquire() must be called to tell lockdep that this thread now owns the DCACHE_PAR_LOOKUP lock.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhMFhjubj)}(hhh]j)}(h0``struct dentry *dentry`` dentry that is locked h](j)}(h``struct dentry *dentry``h]j)}(hjۂh]hstruct dentry *dentry}(hj݂hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjقubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhMChjՂubj)}(hhh]h)}(hdentry that is lockedh]hdentry that is locked}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMChjubah}(h]h ]h"]h$]h&]uh1jhjՂubeh}(h]h ]h"]h$]h&]uh1jhjhMChj҂ubah}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhMEhjubh)}(hIf an in-lookup dentry was passed to this thread, the d_lookup_acquire() must be called to tell lockdep that this thread now owns the DCACHE_PAR_LOOKUP lock.h]hIf an in-lookup dentry was passed to this thread, the d_lookup_acquire() must be called to tell lockdep that this thread now owns the DCACHE_PAR_LOOKUP lock.}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhMDhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjEhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j d_inode (C function) c.d_inodehNtauh1hhjEhhhNhNubj)}(hhh](j)}(h4struct inode * d_inode (const struct dentry *dentry)h]j)}(h2struct inode *d_inode(const struct dentry *dentry)h](j )}(hjh]hstruct}(hj[hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjWhhh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhMPubj2)}(h h]h }(hjihhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjWhhhjhhMPubh)}(hhh]jI)}(hinodeh]hinode}(hjzhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjwubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj|modnameN classnameNjj )}j ]j)}jd_inodesb c.d_inodeasbuh1hhjWhhhjhhMPubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjWhhhjhhMPubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjWhhhjhhMPubjC)}(hd_inodeh]jI)}(hjh]hd_inode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjWhhhjhhMPubj=)}(h(const struct dentry *dentry)h]jC)}(hconst struct dentry *dentryh](j )}(hjJh]hconst}(hjՃhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjуubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjуubj )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjуubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjуubh)}(hhh]jI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j c.d_inodeasbuh1hhjуubj2)}(h h]h }(hj,hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjуubj)}(hjh]h*}(hj:hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjуubjI)}(hdentryh]hdentry}(hjGhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjуubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj̓ubah}(h]h ]h"]h$]h&]j`jauh1j<hjWhhhjhhMPubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjShhhjhhMPubah}(h]jNah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhhMPhjPhhubjw)}(hhh]h)}(h#Get the actual inode of this dentryh]h#Get the actual inode of this dentry}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhMPhjnhhubah}(h]h ]h"]h$]h&]uh1jvhjPhhhjhhMPubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjEhNhNubj)}(h**Parameters** ``const struct dentry *dentry`` The dentry to query **Description** This is the helper normal filesystems should use to get at their own inodes in their own dentries and ignore the layering superimposed upon them.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhMThjubj)}(hhh]j)}(h4``const struct dentry *dentry`` The dentry to query h](j)}(h``const struct dentry *dentry``h]j)}(hjh]hconst struct dentry *dentry}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhMQhjubj)}(hhh]h)}(hThe dentry to queryh]hThe dentry to query}(hj˄hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjDŽhMQhjȄubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjDŽhMQhjubah}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhMShjubh)}(hThis is the helper normal filesystems should use to get at their own inodes in their own dentries and ignore the layering superimposed upon them.h]hThis is the helper normal filesystems should use to get at their own inodes in their own dentries and ignore the layering superimposed upon them.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhMRhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjEhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j d_inode_rcu (C function) c.d_inode_rcuhNtauh1hhjEhhhNhNubj)}(hhh](j)}(h8struct inode * d_inode_rcu (const struct dentry *dentry)h]j)}(h6struct inode *d_inode_rcu(const struct dentry *dentry)h](j )}(hjh]hstruct}(hj2hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj.hhh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhM\ubj2)}(h h]h }(hj@hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj.hhhj?hM\ubh)}(hhh]jI)}(hinodeh]hinode}(hjQhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjNubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjSmodnameN classnameNjj )}j ]j)}j d_inode_rcusb c.d_inode_rcuasbuh1hhj.hhhj?hM\ubj2)}(h h]h }(hjrhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj.hhhj?hM\ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj.hhhj?hM\ubjC)}(h d_inode_rcuh]jI)}(hjoh]h d_inode_rcu}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj.hhhj?hM\ubj=)}(h(const struct dentry *dentry)h]jC)}(hconst struct dentry *dentryh](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj )}(hjh]hstruct}(hjDžhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjԅhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jm c.d_inode_rcuasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubah}(h]h ]h"]h$]h&]j`jauh1j<hj.hhhj?hM\ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj*hhhj?hM\ubah}(h]j%ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj?hM\hj'hhubjw)}(hhh]h)}(h4Get the actual inode of this dentry with READ_ONCE()h]h4Get the actual inode of this dentry with READ_ONCE()}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhM\hjEhhubah}(h]h ]h"]h$]h&]uh1jvhj'hhhj?hM\ubeh}(h]h ](jfunctioneh"]h$]h&]jjjj`jj`jjjuh1jhhhjEhNhNubj)}(h**Parameters** ``const struct dentry *dentry`` The dentry to query **Description** This is the helper normal filesystems should use to get at their own inodes in their own dentries and ignore the layering superimposed upon them.h](h)}(h**Parameters**h]j)}(hjjh]h Parameters}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjhubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhM`hjdubj)}(hhh]j)}(h4``const struct dentry *dentry`` The dentry to query h](j)}(h``const struct dentry *dentry``h]j)}(hjh]hconst struct dentry *dentry}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhM]hjubj)}(hhh]h)}(hThe dentry to queryh]hThe dentry to query}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM]hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM]hjubah}(h]h ]h"]h$]h&]uh1jhjdubh)}(h**Description**h]j)}(hjĆh]h Description}(hjƆhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj†ubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhM_hjdubh)}(hThis is the helper normal filesystems should use to get at their own inodes in their own dentries and ignore the layering superimposed upon them.h]hThis is the helper normal filesystems should use to get at their own inodes in their own dentries and ignore the layering superimposed upon them.}(hjچhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhM^hjdubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjEhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j d_backing_inode (C function)c.d_backing_inodehNtauh1hhjEhhhNhNubj)}(hhh](j)}(h;struct inode * d_backing_inode (const struct dentry *upper)h]j)}(h9struct inode *d_backing_inode(const struct dentry *upper)h](j )}(hjh]hstruct}(hj hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjhhh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhMhubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMhubh)}(hhh]jI)}(hinodeh]hinode}(hj(hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj%ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj*modnameN classnameNjj )}j ]j)}jd_backing_inodesbc.d_backing_inodeasbuh1hhjhhhjhMhubj2)}(h h]h }(hjIhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMhubj)}(hjh]h*}(hjWhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMhubjC)}(hd_backing_inodeh]jI)}(hjFh]hd_backing_inode}(hjhhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjdubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhMhubj=)}(h(const struct dentry *upper)h]jC)}(hconst struct dentry *upperh](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jDc.d_backing_inodeasbuh1hhjubj2)}(h h]h }(hjڇhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hupperh]hupper}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj{ubah}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhMhubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhMhubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMhhjhhubjw)}(hhh]h)}(h+Get upper or lower inode we should be usingh]h+Get upper or lower inode we should be using}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhMhhjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhMhubeh}(h]h ](jfunctioneh"]h$]h&]jjjj7jj7jjjuh1jhhhjEhNhNubj)}(hXi**Parameters** ``const struct dentry *upper`` The upper layer **Description** This is the helper that should be used to get at the inode that will be used if this dentry were to be opened as a file. The inode may be on the upper dentry or it may be on a lower dentry pinned by the upper. Normal filesystems should not use this to access their own inodes.h](h)}(h**Parameters**h]j)}(hjAh]h Parameters}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1jhj?ubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhMlhj;ubj)}(hhh]j)}(h/``const struct dentry *upper`` The upper layer h](j)}(h``const struct dentry *upper``h]j)}(hj`h]hconst struct dentry *upper}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj^ubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhMihjZubj)}(hhh]h)}(hThe upper layerh]hThe upper layer}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjuhMihjvubah}(h]h ]h"]h$]h&]uh1jhjZubeh}(h]h ]h"]h$]h&]uh1jhjuhMihjWubah}(h]h ]h"]h$]h&]uh1jhj;ubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhMkhj;ubh)}(hThis is the helper that should be used to get at the inode that will be used if this dentry were to be opened as a file. The inode may be on the upper dentry or it may be on a lower dentry pinned by the upper.h]hThis is the helper that should be used to get at the inode that will be used if this dentry were to be opened as a file. The inode may be on the upper dentry or it may be on a lower dentry pinned by the upper.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhMjhj;ubh)}(hBNormal filesystems should not use this to access their own inodes.h]hBNormal filesystems should not use this to access their own inodes.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhMnhj;ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjEhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j d_real (C function)c.d_realhNtauh1hhjEhhhNhNubj)}(hhh](j)}(hEstruct dentry * d_real (struct dentry *dentry, enum d_real_type type)h]j)}(hCstruct dentry *d_real(struct dentry *dentry, enum d_real_type type)h](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjhhh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhMyubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMyubh)}(hhh]jI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jd_realsbc.d_realasbuh1hhjhhhjhMyubj2)}(h h]h }(hj/hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMyubj)}(hjh]h*}(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMyubjC)}(hd_realh]jI)}(hj,h]hd_real}(hjNhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjJubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhMyubj=)}(h.(struct dentry *dentry, enum d_real_type type)h](jC)}(hstruct dentry *dentryh](j )}(hjh]hstruct}(hjihhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjeubj2)}(h h]h }(hjvhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjeubh)}(hhh]jI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j*c.d_realasbuh1hhjeubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjeubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubjI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjeubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjaubjC)}(henum d_real_type typeh](j )}(hj#h]henum}(hjىhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjՉubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjՉubh)}(hhh]jI)}(h d_real_typeh]h d_real_type}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j*c.d_realasbuh1hhjՉubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjՉubjI)}(htypeh]htype}(hj#hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjՉubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjaubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhMyubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhMyubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMyhjhhubjw)}(hhh]h)}(hReturn the real dentryh]hReturn the real dentry}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhMyhjJhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhMyubeh}(h]h ](jfunctioneh"]h$]h&]jjjjejjejjjuh1jhhhjEhNhNubj)}(hX4**Parameters** ``struct dentry *dentry`` the dentry to query ``enum d_real_type type`` the type of real dentry (data or metadata) **Description** If dentry is on a union/overlay, then return the underlying, real dentry. Otherwise return the dentry itself. See also: Documentation/filesystems/vfs.rsth](h)}(h**Parameters**h]j)}(hjoh]h Parameters}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjmubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhM}hjiubj)}(hhh](j)}(h.``struct dentry *dentry`` the dentry to query h](j)}(h``struct dentry *dentry``h]j)}(hjh]hstruct dentry *dentry}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhMzhjubj)}(hhh]h)}(hthe dentry to queryh]hthe dentry to query}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMzhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMzhjubj)}(hE``enum d_real_type type`` the type of real dentry (data or metadata) h](j)}(h``enum d_real_type type``h]j)}(hjNJh]henum d_real_type type}(hjɊhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjŊubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhM{hjubj)}(hhh]h)}(h*the type of real dentry (data or metadata)h]h*the type of real dentry (data or metadata)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj܊hM{hj݊ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj܊hM{hjubeh}(h]h ]h"]h$]h&]uh1jhjiubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhM}hjiubh)}(hmIf dentry is on a union/overlay, then return the underlying, real dentry. Otherwise return the dentry itself.h]hmIf dentry is on a union/overlay, then return the underlying, real dentry. Otherwise return the dentry itself.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhM|hjiubh)}(h+See also: Documentation/filesystems/vfs.rsth]h+See also: Documentation/filesystems/vfs.rst}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhMhjiubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjEhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j d_real_inode (C function)c.d_real_inodehNtauh1hhjEhhhNhNubj)}(hhh](j)}(h9struct inode * d_real_inode (const struct dentry *dentry)h]j)}(h7struct inode *d_real_inode(const struct dentry *dentry)h](j )}(hjh]hstruct}(hjVhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjRhhh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhMubj2)}(h h]h }(hjdhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjRhhhjchMubh)}(hhh]jI)}(hinodeh]hinode}(hjuhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjrubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjwmodnameN classnameNjj )}j ]j)}j d_real_inodesbc.d_real_inodeasbuh1hhjRhhhjchMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjRhhhjchMubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRhhhjchMubjC)}(h d_real_inodeh]jI)}(hjh]h d_real_inode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjRhhhjchMubj=)}(h(const struct dentry *dentry)h]jC)}(hconst struct dentry *dentryh](j )}(hjJh]hconst}(hjЋhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj̋ubj2)}(h h]h }(hj݋hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj̋ubj )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj̋ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj̋ubh)}(hhh]jI)}(hdentryh]hdentry}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj modnameN classnameNjj )}j ]jc.d_real_inodeasbuh1hhj̋ubj2)}(h h]h }(hj'hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj̋ubj)}(hjh]h*}(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj̋ubjI)}(hdentryh]hdentry}(hjBhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj̋ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjȋubah}(h]h ]h"]h$]h&]j`jauh1j<hjRhhhjchMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjNhhhjchMubah}(h]jIah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjchMhjKhhubjw)}(hhh]h)}(h&Return the real inode hosting the datah]h&Return the real inode hosting the data}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhMhjihhubah}(h]h ]h"]h$]h&]uh1jvhjKhhhjchMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjEhNhNubj)}(h**Parameters** ``const struct dentry *dentry`` The dentry to query **Description** If dentry is on a union/overlay, then return the underlying, real inode. Otherwise return d_inode().h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhMhjubj)}(hhh]j)}(h4``const struct dentry *dentry`` The dentry to query h](j)}(h``const struct dentry *dentry``h]j)}(hjh]hconst struct dentry *dentry}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhMhjubj)}(hhh]h)}(hThe dentry to queryh]hThe dentry to query}(hjƌhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjŒhMhjÌubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjŒhMhjubah}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhMhjubh)}(hdIf dentry is on a union/overlay, then return the underlying, real inode. Otherwise return d_inode().h]hdIf dentry is on a union/overlay, then return the underlying, real inode. Otherwise return d_inode().}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:23: ./include/linux/dcache.hhMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjEhhhNhNubeh}(h]the-directory-cacheah ]h"]the directory cacheah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(hInode Handlingh]hInode Handling}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j "inode_init_always_gfp (C function)c.inode_init_always_gfphNtauh1hhjhhhNhNubj)}(hhh](j)}(hRint inode_init_always_gfp (struct super_block *sb, struct inode *inode, gfp_t gfp)h]j)}(hQint inode_init_always_gfp(struct super_block *sb, struct inode *inode, gfp_t gfp)h](j)}(hinth]hint}(hjFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chKubj2)}(h h]h }(hjUhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjBhhhjThKubjC)}(hinode_init_always_gfph]jI)}(hinode_init_always_gfph]hinode_init_always_gfp}(hjghhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjcubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjBhhhjThKubj=)}(h8(struct super_block *sb, struct inode *inode, gfp_t gfp)h](jC)}(hstruct super_block *sbh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(h super_blockh]h super_block}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jjisbc.inode_init_always_gfpasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjύhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hsbh]hsb}(hj܍hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj{ubjC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.inode_init_always_gfpasbuh1hhjubj2)}(h h]h }(hj1hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hinodeh]hinode}(hjLhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj{ubjC)}(h gfp_t gfph](h)}(hhh]jI)}(hgfp_th]hgfp_t}(hjhhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjeubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjjmodnameN classnameNjj )}j ]jc.inode_init_always_gfpasbuh1hhjaubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjaubjI)}(hgfph]hgfp}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjaubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj{ubeh}(h]h ]h"]h$]h&]j`jauh1j<hjBhhhjThKubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj>hhhjThKubah}(h]j9ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjThKhj;hhubjw)}(hhh]h)}(h&perform inode structure initialisationh]h&perform inode structure initialisation}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chKhjhhubah}(h]h ]h"]h$]h&]uh1jvhj;hhhjThKubeh}(h]h ](jfunctioneh"]h$]h&]jjjj֎jj֎jjjuh1jhhhjhNhNubj)}(hXh**Parameters** ``struct super_block *sb`` superblock inode belongs to ``struct inode *inode`` inode to initialise ``gfp_t gfp`` allocation flags **Description** These are initializations that need to be done on every inode allocation as the fields are not initialised by slab allocation. If there are additional allocations required **gfp** is used.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjގubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chKhjڎubj)}(hhh](j)}(h7``struct super_block *sb`` superblock inode belongs to h](j)}(h``struct super_block *sb``h]j)}(hjh]hstruct super_block *sb}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chKhjubj)}(hhh]h)}(hsuperblock inode belongs toh]hsuperblock inode belongs to}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubj)}(h,``struct inode *inode`` inode to initialise h](j)}(h``struct inode *inode``h]j)}(hj8h]hstruct inode *inode}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj6ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chKhj2ubj)}(hhh]h)}(hinode to initialiseh]hinode to initialise}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjMhKhjNubah}(h]h ]h"]h$]h&]uh1jhj2ubeh}(h]h ]h"]h$]h&]uh1jhjMhKhjubj)}(h``gfp_t gfp`` allocation flags h](j)}(h ``gfp_t gfp``h]j)}(hjqh]h gfp_t gfp}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1jhjoubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chKhjkubj)}(hhh]h)}(hallocation flagsh]hallocation flags}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjkubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubeh}(h]h ]h"]h$]h&]uh1jhjڎubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chKhjڎubh)}(hThese are initializations that need to be done on every inode allocation as the fields are not initialised by slab allocation. If there are additional allocations required **gfp** is used.h](hThese are initializations that need to be done on every inode allocation as the fields are not initialised by slab allocation. If there are additional allocations required }(hjhhhNhNubj)}(h**gfp**h]hgfp}(hjʏhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh is used.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chKhjڎubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j drop_nlink (C function) c.drop_nlinkhNtauh1hhjhhhNhNubj)}(hhh](j)}(h%void drop_nlink (struct inode *inode)h]j)}(h$void drop_nlink(struct inode *inode)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMubjC)}(h drop_nlinkh]jI)}(h drop_nlinkh]h drop_nlink}(hj$hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhMubj=)}(h(struct inode *inode)h]jC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hj@hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj<ubj2)}(h h]h }(hjMhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj<ubh)}(hhh]jI)}(hinodeh]hinode}(hj^hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj[ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj`modnameN classnameNjj )}j ]j)}jj&sb c.drop_nlinkasbuh1hhj<ubj2)}(h h]h }(hj~hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj<ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj<ubjI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj<ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj8ubah}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhMubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMhjhhubjw)}(hhh]h)}(h#directly drop an inode's link counth]h%directly drop an inode’s link count}(hjÐhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjېjjېjjjuh1jhhhjhNhNubj)}(hXV**Parameters** ``struct inode *inode`` inode **Description** This is a low-level filesystem helper to replace any direct filesystem manipulation of i_nlink. In cases where we are attempting to track writes to the filesystem, a decrement to zero means an imminent write when the file is truncated and actually unlinked on the filesystem.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjߐubj)}(hhh]j)}(h``struct inode *inode`` inode h](j)}(h``struct inode *inode``h]j)}(hjh]hstruct inode *inode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjubj)}(hhh]h)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjߐubh)}(h**Description**h]j)}(hj?h]h Description}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj=ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjߐubh)}(hXThis is a low-level filesystem helper to replace any direct filesystem manipulation of i_nlink. In cases where we are attempting to track writes to the filesystem, a decrement to zero means an imminent write when the file is truncated and actually unlinked on the filesystem.h]hXThis is a low-level filesystem helper to replace any direct filesystem manipulation of i_nlink. In cases where we are attempting to track writes to the filesystem, a decrement to zero means an imminent write when the file is truncated and actually unlinked on the filesystem.}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjߐubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j clear_nlink (C function) c.clear_nlinkhNtauh1hhjhhhNhNubj)}(hhh](j)}(h&void clear_nlink (struct inode *inode)h]j)}(h%void clear_nlink(struct inode *inode)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMubjC)}(h clear_nlinkh]jI)}(h clear_nlinkh]h clear_nlink}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhMubj=)}(h(struct inode *inode)h]jC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjΑhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hinodeh]hinode}(hjߑhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjܑubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jjsb c.clear_nlinkasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubah}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj|hhhjhMubah}(h]jwah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMhjyhhubjw)}(hhh]h)}(h#directly zero an inode's link counth]h%directly zero an inode’s link count}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjAhhubah}(h]h ]h"]h$]h&]uh1jvhjyhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjj\jj\jjjuh1jhhhjhNhNubj)}(h**Parameters** ``struct inode *inode`` inode **Description** This is a low-level filesystem helper to replace any direct filesystem manipulation of i_nlink. See drop_nlink() for why we care about i_nlink hitting zero.h](h)}(h**Parameters**h]j)}(hjfh]h Parameters}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjdubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhj`ubj)}(hhh]j)}(h``struct inode *inode`` inode h](j)}(h``struct inode *inode``h]j)}(hjh]hstruct inode *inode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjubj)}(hhh]h)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhj|ubah}(h]h ]h"]h$]h&]uh1jhj`ubh)}(h**Description**h]j)}(hjh]h Description}(hj’hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhj`ubh)}(hThis is a low-level filesystem helper to replace any direct filesystem manipulation of i_nlink. See drop_nlink() for why we care about i_nlink hitting zero.h]hThis is a low-level filesystem helper to replace any direct filesystem manipulation of i_nlink. See drop_nlink() for why we care about i_nlink hitting zero.}(hj֒hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhj`ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j set_nlink (C function) c.set_nlinkhNtauh1hhjhhhNhNubj)}(hhh](j)}(h8void set_nlink (struct inode *inode, unsigned int nlink)h]j)}(h7void set_nlink(struct inode *inode, unsigned int nlink)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMubjC)}(h set_nlinkh]jI)}(h set_nlinkh]h set_nlink}(hj&hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj"ubah}(h]h ](j[j\e>h"]h$]h&]j`jauh1jBhjhhhjhMubj=)}(h)(struct inode *inode, unsigned int nlink)h](jC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hjBhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj>ubj2)}(h h]h }(hjOhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj>ubh)}(hhh]jI)}(hinodeh]hinode}(hj`hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj]ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjbmodnameN classnameNjj )}j ]j)}jj(sb c.set_nlinkasbuh1hhj>ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj>ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>ubjI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj>ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj:ubjC)}(hunsigned int nlinkh](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hj“hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hinth]hint}(hjГhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjޓhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hnlinkh]hnlink}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj:ubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhMubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMhjhhubjw)}(hhh]h)}(h"directly set an inode's link counth]h$directly set an inode’s link count}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjj.jj.jjjuh1jhhhjhNhNubj)}(h**Parameters** ``struct inode *inode`` inode ``unsigned int nlink`` new nlink (should be non-zero) **Description** This is a low-level filesystem helper to replace any direct filesystem manipulation of i_nlink.h](h)}(h**Parameters**h]j)}(hj8h]h Parameters}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj6ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhj2ubj)}(hhh](j)}(h``struct inode *inode`` inode h](j)}(h``struct inode *inode``h]j)}(hjWh]hstruct inode *inode}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjUubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjQubj)}(hhh]h)}(hinodeh]hinode}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1hhjlhMhjmubah}(h]h ]h"]h$]h&]uh1jhjQubeh}(h]h ]h"]h$]h&]uh1jhjlhMhjNubj)}(h6``unsigned int nlink`` new nlink (should be non-zero) h](j)}(h``unsigned int nlink``h]j)}(hjh]hunsigned int nlink}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjubj)}(hhh]h)}(hnew nlink (should be non-zero)h]hnew nlink (should be non-zero)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjNubeh}(h]h ]h"]h$]h&]uh1jhj2ubh)}(h**Description**h]j)}(hj˔h]h Description}(hj͔hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjɔubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhj2ubh)}(h_This is a low-level filesystem helper to replace any direct filesystem manipulation of i_nlink.h]h_This is a low-level filesystem helper to replace any direct filesystem manipulation of i_nlink.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhj2ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j inc_nlink (C function) c.inc_nlinkhNtauh1hhjhhhNhNubj)}(hhh](j)}(h$void inc_nlink (struct inode *inode)h]j)}(h#void inc_nlink(struct inode *inode)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj hhhjhMubjC)}(h inc_nlinkh]jI)}(h inc_nlinkh]h inc_nlink}(hj1hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj-ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj hhhjhMubj=)}(h(struct inode *inode)h]jC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hjMhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjIubj2)}(h h]h }(hjZhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjIubh)}(hhh]jI)}(hinodeh]hinode}(hjkhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjhubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmmodnameN classnameNjj )}j ]j)}jj3sb c.inc_nlinkasbuh1hhjIubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjIubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIubjI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjIubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjEubah}(h]h ]h"]h$]h&]j`jauh1j<hj hhhjhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhMubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMhjhhubjw)}(hhh]h)}(h(directly increment an inode's link counth]h*directly increment an inode’s link count}(hjЕhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhj͕hhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjhNhNubj)}(h**Parameters** ``struct inode *inode`` inode **Description** This is a low-level filesystem helper to replace any direct filesystem manipulation of i_nlink. Currently, it is only here for parity with dec_nlink().h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjubj)}(hhh]j)}(h``struct inode *inode`` inode h](j)}(h``struct inode *inode``h]j)}(hjh]hstruct inode *inode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhj ubj)}(hhh]h)}(hinodeh]hinode}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj&hMhj'ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj&hMhjubah}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjLh]h Description}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjJubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjubh)}(hThis is a low-level filesystem helper to replace any direct filesystem manipulation of i_nlink. Currently, it is only here for parity with dec_nlink().h]hThis is a low-level filesystem helper to replace any direct filesystem manipulation of i_nlink. Currently, it is only here for parity with dec_nlink().}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j inode_sb_list_add (C function)c.inode_sb_list_addhNtauh1hhjhhhNhNubj)}(hhh](j)}(h,void inode_sb_list_add (struct inode *inode)h]j)}(h+void inode_sb_list_add(struct inode *inode)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMvubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMvubjC)}(hinode_sb_list_addh]jI)}(hinode_sb_list_addh]hinode_sb_list_add}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhMvubj=)}(h(struct inode *inode)h]jC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hjΖhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjʖubj2)}(h h]h }(hjۖhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjʖubh)}(hhh]jI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jjsbc.inode_sb_list_addasbuh1hhjʖubj2)}(h h]h }(hj hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjʖubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjʖubjI)}(hinodeh]hinode}(hj'hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjʖubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjƖubah}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhMvubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhMvubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMvhjhhubjw)}(hhh]h)}(h*add inode to the superblock list of inodesh]h*add inode to the superblock list of inodes}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMvhjNhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhMvubeh}(h]h ](jfunctioneh"]h$]h&]jjjjijjijjjuh1jhhhjhNhNubj)}(h6**Parameters** ``struct inode *inode`` inode to addh](h)}(h**Parameters**h]j)}(hjsh]h Parameters}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjqubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMzhjmubj)}(hhh]j)}(h$``struct inode *inode`` inode to addh](j)}(h``struct inode *inode``h]j)}(hjh]hstruct inode *inode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM|hjubj)}(hhh]h)}(h inode to addh]h inode to add}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMwhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM|hjubah}(h]h ]h"]h$]h&]uh1jhjmubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j  __insert_inode_hash (C function)c.__insert_inode_hashhNtauh1hhjhhhNhNubj)}(hhh](j)}(h;void __insert_inode_hash (struct inode *inode, u64 hashval)h]j)}(h:void __insert_inode_hash(struct inode *inode, u64 hashval)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMubjC)}(h__insert_inode_hashh]jI)}(h__insert_inode_hashh]h__insert_inode_hash}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhMubj=)}(h"(struct inode *inode, u64 hashval)h](jC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hj)hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj%ubj2)}(h h]h }(hj6hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj%ubh)}(hhh]jI)}(hinodeh]hinode}(hjGhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjDubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjImodnameN classnameNjj )}j ]j)}jjsbc.__insert_inode_hashasbuh1hhj%ubj2)}(h h]h }(hjghhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj%ubj)}(hjh]h*}(hjuhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%ubjI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj%ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj!ubjC)}(h u64 hashvalh](h)}(hhh]jI)}(hu64h]hu64}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jcc.__insert_inode_hashasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hhashvalh]hhashval}(hjʘhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj!ubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhMubah}(h]jߗah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMhjhhubjw)}(hhh]h)}(h hash an inodeh]h hash an inode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjj jj jjjuh1jhhhjhNhNubj)}(h**Parameters** ``struct inode *inode`` unhashed inode ``u64 hashval`` u64 value used to locate this object in the inode_hashtable. **Description** Add an inode to the inode hash for this superblock.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjubj)}(hhh](j)}(h'``struct inode *inode`` unhashed inode h](j)}(h``struct inode *inode``h]j)}(hj5h]hstruct inode *inode}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj3ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhj/ubj)}(hhh]h)}(hunhashed inodeh]hunhashed inode}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjJhMhjKubah}(h]h ]h"]h$]h&]uh1jhj/ubeh}(h]h ]h"]h$]h&]uh1jhjJhMhj,ubj)}(hM``u64 hashval`` u64 value used to locate this object in the inode_hashtable. h](j)}(h``u64 hashval``h]j)}(hjnh]h u64 hashval}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1jhjlubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjhubj)}(hhh]h)}(hah"]h$]h&]uh1j1hjhhhjhMubjC)}(h__remove_inode_hashh]jI)}(h__remove_inode_hashh]h__remove_inode_hash}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhMubj=)}(h(struct inode *inode)h]jC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hj7hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj3ubj2)}(h h]h }(hjDhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj3ubh)}(hhh]jI)}(hinodeh]hinode}(hjUhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjRubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjWmodnameN classnameNjj )}j ]j)}jjsbc.__remove_inode_hashasbuh1hhj3ubj2)}(h h]h }(hjuhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj3ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3ubjI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj3ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj/ubah}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhMubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMhjhhubjw)}(hhh]h)}(hremove an inode from the hashh]hremove an inode from the hash}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjҚjjҚjjjuh1jhhhjhNhNubj)}(hu**Parameters** ``struct inode *inode`` inode to unhash **Description** Remove an inode from the superblock.h](h)}(h**Parameters**h]j)}(hjܚh]h Parameters}(hjޚhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjښubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhj֚ubj)}(hhh]j)}(h(``struct inode *inode`` inode to unhash h](j)}(h``struct inode *inode``h]j)}(hjh]hstruct inode *inode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjubj)}(hhh]h)}(hinode to unhashh]hinode to unhash}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubah}(h]h ]h"]h$]h&]uh1jhj֚ubh)}(h**Description**h]j)}(hj6h]h Description}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj4ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhj֚ubj)}(h$Remove an inode from the superblock.h]h)}(hjNh]h$Remove an inode from the superblock.}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjLubah}(h]h ]h"]h$]h&]uh1jhj]hMhj֚ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j evict_inodes (C function)c.evict_inodeshNtauh1hhjhhhNhNubj)}(hhh](j)}(h*void evict_inodes (struct super_block *sb)h]j)}(h)void evict_inodes(struct super_block *sb)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMeubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMeubjC)}(h evict_inodesh]jI)}(h evict_inodesh]h evict_inodes}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhMeubj=)}(h(struct super_block *sb)h]jC)}(hstruct super_block *sbh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjΛhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(h super_blockh]h super_block}(hjߛhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjܛubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jjsbc.evict_inodesasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hsbh]hsb}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubah}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhMeubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj|hhhjhMeubah}(h]jwah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMehjyhhubjw)}(hhh]h)}(h+evict all evictable inodes for a superblockh]h+evict all evictable inodes for a superblock}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMehjAhhubah}(h]h ]h"]h$]h&]uh1jvhjyhhhjhMeubeh}(h]h ](jfunctioneh"]h$]h&]jjjj\jj\jjjuh1jhhhjhNhNubj)}(hX8**Parameters** ``struct super_block *sb`` superblock to operate on **Description** Make sure that no inodes with zero refcount are retained. This is called by superblock shutdown after having SB_ACTIVE flag removed, so any inode reaching zero refcount during or after that call will be immediately evicted.h](h)}(h**Parameters**h]j)}(hjfh]h Parameters}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjdubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMihj`ubj)}(hhh]j)}(h4``struct super_block *sb`` superblock to operate on h](j)}(h``struct super_block *sb``h]j)}(hjh]hstruct super_block *sb}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMfhjubj)}(hhh]h)}(hsuperblock to operate onh]hsuperblock to operate on}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMfhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMfhj|ubah}(h]h ]h"]h$]h&]uh1jhj`ubh)}(h**Description**h]j)}(hjh]h Description}(hjœhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhhj`ubh)}(hMake sure that no inodes with zero refcount are retained. This is called by superblock shutdown after having SB_ACTIVE flag removed, so any inode reaching zero refcount during or after that call will be immediately evicted.h]hMake sure that no inodes with zero refcount are retained. This is called by superblock shutdown after having SB_ACTIVE flag removed, so any inode reaching zero refcount during or after that call will be immediately evicted.}(hj֜hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMghj`ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j new_inode (C function) c.new_inodehNtauh1hhjhhhNhNubj)}(hhh](j)}(h1struct inode * new_inode (struct super_block *sb)h]j)}(h/struct inode *new_inode(struct super_block *sb)h](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMubh)}(hhh]jI)}(hinodeh]hinode}(hj$hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj!ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj&modnameN classnameNjj )}j ]j)}j new_inodesb c.new_inodeasbuh1hhjhhhjhMubj2)}(h h]h }(hjEhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMubj)}(hjh]h*}(hjShhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubjC)}(h new_inodeh]jI)}(hjBh]h new_inode}(hjdhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj`ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhMubj=)}(h(struct super_block *sb)h]jC)}(hstruct super_block *sbh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj{ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj{ubh)}(hhh]jI)}(h super_blockh]h super_block}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j@ c.new_inodeasbuh1hhj{ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj{ubj)}(hjh]h*}(hjɝhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{ubjI)}(hsbh]hsb}(hj֝hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj{ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjwubah}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhMubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMhjhhubjw)}(hhh]h)}(hobtain an inodeh]hobtain an inode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjhNhNubj)}(hX**Parameters** ``struct super_block *sb`` superblock **Description** Allocates a new inode for given superblock. The default gfp_mask for allocations related to inode->i_mapping is GFP_HIGHUSER_MOVABLE. If HIGHMEM pages are unsuitable or it is known that pages allocated for the page cache are not reclaimable or migratable, mapping_set_gfp_mask() must be called with suitable flags on the newly created inode's mappingh](h)}(h**Parameters**h]j)}(hj"h]h Parameters}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjubj)}(hhh]j)}(h&``struct super_block *sb`` superblock h](j)}(h``struct super_block *sb``h]j)}(hjAh]hstruct super_block *sb}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1jhj?ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhj;ubj)}(hhh]h)}(h superblockh]h superblock}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjVhMhjWubah}(h]h ]h"]h$]h&]uh1jhj;ubeh}(h]h ]h"]h$]h&]uh1jhjVhMhj8ubah}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hj|h]h Description}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjzubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjubj)}(hX^Allocates a new inode for given superblock. The default gfp_mask for allocations related to inode->i_mapping is GFP_HIGHUSER_MOVABLE. If HIGHMEM pages are unsuitable or it is known that pages allocated for the page cache are not reclaimable or migratable, mapping_set_gfp_mask() must be called with suitable flags on the newly created inode's mappingh]h)}(hX^Allocates a new inode for given superblock. The default gfp_mask for allocations related to inode->i_mapping is GFP_HIGHUSER_MOVABLE. If HIGHMEM pages are unsuitable or it is known that pages allocated for the page cache are not reclaimable or migratable, mapping_set_gfp_mask() must be called with suitable flags on the newly created inode's mappingh]hX`Allocates a new inode for given superblock. The default gfp_mask for allocations related to inode->i_mapping is GFP_HIGHUSER_MOVABLE. If HIGHMEM pages are unsuitable or it is known that pages allocated for the page cache are not reclaimable or migratable, mapping_set_gfp_mask() must be called with suitable flags on the newly created inode’s mapping}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjubah}(h]h ]h"]h$]h&]uh1jhjhMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j unlock_new_inode (C function)c.unlock_new_inodehNtauh1hhjhhhNhNubj)}(hhh](j)}(h+void unlock_new_inode (struct inode *inode)h]j)}(h*void unlock_new_inode(struct inode *inode)h](j)}(hvoidh]hvoid}(hj˞hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjǞhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMubj2)}(h h]h }(hjڞhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjǞhhhjٞhMubjC)}(hunlock_new_inodeh]jI)}(hunlock_new_inodeh]hunlock_new_inode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjǞhhhjٞhMubj=)}(h(struct inode *inode)h]jC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hinodeh]hinode}(hj&hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj#ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj(modnameN classnameNjj )}j ]j)}jjsbc.unlock_new_inodeasbuh1hhjubj2)}(h h]h }(hjFhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hinodeh]hinode}(hjahhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubah}(h]h ]h"]h$]h&]j`jauh1j<hjǞhhhjٞhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjÞhhhjٞhMubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjٞhMhjhhubjw)}(hhh]h)}(h-clear the I_NEW state and wake up any waitersh]h-clear the I_NEW state and wake up any waiters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjٞhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjhNhNubj)}(h**Parameters** ``struct inode *inode`` new inode to unlock **Description** Called when the inode is fully initialised to clear the new state of the inode and wake up anyone waiting for the inode to finish initialisation.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjubj)}(hhh]j)}(h,``struct inode *inode`` new inode to unlock h](j)}(h``struct inode *inode``h]j)}(hj̟h]hstruct inode *inode}(hjΟhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjʟubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjƟubj)}(hhh]h)}(hnew inode to unlockh]hnew inode to unlock}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjƟubeh}(h]h ]h"]h$]h&]uh1jhjhMhjßubah}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjubh)}(hCalled when the inode is fully initialised to clear the new state of the inode and wake up anyone waiting for the inode to finish initialisation.h]hCalled when the inode is fully initialised to clear the new state of the inode and wake up anyone waiting for the inode to finish initialisation.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j $lock_two_nondirectories (C function)c.lock_two_nondirectorieshNtauh1hhjhhhNhNubj)}(hhh](j)}(hIvoid lock_two_nondirectories (struct inode *inode1, struct inode *inode2)h]j)}(hHvoid lock_two_nondirectories(struct inode *inode1, struct inode *inode2)h](j)}(hvoidh]hvoid}(hjLhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMubj2)}(h h]h }(hj[hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjHhhhjZhMubjC)}(hlock_two_nondirectoriesh]jI)}(hlock_two_nondirectoriesh]hlock_two_nondirectories}(hjmhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjiubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjHhhhjZhMubj=)}(h,(struct inode *inode1, struct inode *inode2)h](jC)}(hstruct inode *inode1h](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jjosbc.lock_two_nondirectoriesasbuh1hhjubj2)}(h h]h }(hjǠhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjՠhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hinode1h]hinode1}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct inode *inode2h](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jàc.lock_two_nondirectoriesasbuh1hhjubj2)}(h h]h }(hj7hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hinode2h]hinode2}(hjRhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjHhhhjZhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjDhhhjZhMubah}(h]j?ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjZhMhjAhhubjw)}(hhh]h)}(h+take two i_mutexes on non-directory objectsh]h+take two i_mutexes on non-directory objects}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjyhhubah}(h]h ]h"]h$]h&]uh1jvhjAhhhjZhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjhNhNubj)}(h**Parameters** ``struct inode *inode1`` first inode to lock ``struct inode *inode2`` second inode to lock **Description** Lock any non-NULL argument. Passed objects must not be directories. Zero, one or two objects may be locked by this function.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjubj)}(hhh](j)}(h-``struct inode *inode1`` first inode to lock h](j)}(h``struct inode *inode1``h]j)}(hjh]hstruct inode *inode1}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjubj)}(hhh]h)}(hfirst inode to lockh]hfirst inode to lock}(hj֡hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjҡhMhjӡubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjҡhMhjubj)}(h.``struct inode *inode2`` second inode to lock h](j)}(h``struct inode *inode2``h]j)}(hjh]hstruct inode *inode2}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjubj)}(hhh]h)}(hsecond inode to lockh]hsecond inode to lock}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMhj ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj hMhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hj1h]h Description}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj/ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjubh)}(h|Lock any non-NULL argument. Passed objects must not be directories. Zero, one or two objects may be locked by this function.h]h|Lock any non-NULL argument. Passed objects must not be directories. Zero, one or two objects may be locked by this function.}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j &unlock_two_nondirectories (C function)c.unlock_two_nondirectorieshNtauh1hhjhhhNhNubj)}(hhh](j)}(hKvoid unlock_two_nondirectories (struct inode *inode1, struct inode *inode2)h]j)}(hJvoid unlock_two_nondirectories(struct inode *inode1, struct inode *inode2)h](j)}(hvoidh]hvoid}(hjvhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjrhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjrhhhjhMubjC)}(hunlock_two_nondirectoriesh]jI)}(hunlock_two_nondirectoriesh]hunlock_two_nondirectories}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjrhhhjhMubj=)}(h,(struct inode *inode1, struct inode *inode2)h](jC)}(hstruct inode *inode1h](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hinodeh]hinode}(hjѢhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj΢ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjӢmodnameN classnameNjj )}j ]j)}jjsbc.unlock_two_nondirectoriesasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hinode1h]hinode1}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct inode *inode2h](j )}(hjh]hstruct}(hj%hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj!ubj2)}(h h]h }(hj2hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj!ubh)}(hhh]jI)}(hinodeh]hinode}(hjChhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj@ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjEmodnameN classnameNjj )}j ]jc.unlock_two_nondirectoriesasbuh1hhj!ubj2)}(h h]h }(hjahhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj!ubj)}(hjh]h*}(hjohhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubjI)}(hinode2h]hinode2}(hj|hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj!ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjrhhhjhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjnhhhjhMubah}(h]jiah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMhjkhhubjw)}(hhh]h)}(h,release locks from lock_two_nondirectories()h]h,release locks from lock_two_nondirectories()}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjhhubah}(h]h ]h"]h$]h&]uh1jvhjkhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjhNhNubj)}(hs**Parameters** ``struct inode *inode1`` first inode to unlock ``struct inode *inode2`` second inode to unlockh](h)}(h**Parameters**h]j)}(hjȣh]h Parameters}(hjʣhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjƣubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhj£ubj)}(hhh](j)}(h/``struct inode *inode1`` first inode to unlock h](j)}(h``struct inode *inode1``h]j)}(hjh]hstruct inode *inode1}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjubj)}(hhh]h)}(hfirst inode to unlockh]hfirst inode to unlock}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjޣubj)}(h/``struct inode *inode2`` second inode to unlockh](j)}(h``struct inode *inode2``h]j)}(hj h]hstruct inode *inode2}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjubj)}(hhh]h)}(hsecond inode to unlockh]hsecond inode to unlock}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhj6ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj5hMhjޣubeh}(h]h ]h"]h$]h&]uh1jhj£ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j inode_insert5 (C function)c.inode_insert5hNtauh1hhjhhhNhNubj)}(hhh](j)}(hstruct inode * inode_insert5 (struct inode *inode, u64 hashval, int (*test)(struct inode *, void *), int (*set)(struct inode *, void *), void *data)h]j)}(hstruct inode *inode_insert5(struct inode *inode, u64 hashval, int (*test)(struct inode*, void*), int (*set)(struct inode*, void*), void *data)h](j )}(hjh]hstruct}(hjzhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjvhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjvhhhjhM ubh)}(hhh]jI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}j inode_insert5sbc.inode_insert5asbuh1hhjvhhhjhM ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjvhhhjhM ubj)}(hjh]h*}(hjȤhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvhhhjhM ubjC)}(h inode_insert5h]jI)}(hjh]h inode_insert5}(hj٤hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjդubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjvhhhjhM ubj=)}(hs(struct inode *inode, u64 hashval, int (*test)(struct inode*, void*), int (*set)(struct inode*, void*), void *data)h](jC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.inode_insert5asbuh1hhjubj2)}(h h]h }(hj0hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hinodeh]hinode}(hjKhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h u64 hashvalh](h)}(hhh]jI)}(hu64h]hu64}(hjghhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjdubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjimodnameN classnameNjj )}j ]jc.inode_insert5asbuh1hhj`ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj`ubjI)}(hhashvalh]hhashval}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj`ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h!int (*test)(struct inode*, void*)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(h(h]h(}(hjȥhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]h*}(hj֥hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(htesth]htest}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubj)}(h)h]h)}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjʥh]h(}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj )}(hjh]hstruct}(hj hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hinodeh]hinode}(hj*hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj'ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj,modnameN classnameNjj )}j ]jc.inode_insert5asbuh1hhjubj)}(hjh]h*}(hjHhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h,h]h,}(hjUhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjchhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hvoidh]hvoid}(hjqhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]h)}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h int (*set)(struct inode*, void*)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjʥh]h(}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]h*}(hjͦhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hseth]hset}(hjڦhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubj)}(hjh]h)}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjʥh]h(}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hinodeh]hinode}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj"modnameN classnameNjj )}j ]jc.inode_insert5asbuh1hhjubj)}(hjh]h*}(hj>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjWh]h,}(hjKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjXhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hvoidh]hvoid}(hjfhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]h*}(hjthhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]h)}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h void *datah](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hdatah]hdata}(hj§hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjvhhhjhM ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjrhhhjhM ubah}(h]jmah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhM hjohhubjw)}(hhh]h)}(h*obtain an inode from a mounted file systemh]h*obtain an inode from a mounted file system}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjhhubah}(h]h ]h"]h$]h&]uh1jvhjohhhjhM ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjhNhNubj)}(hX**Parameters** ``struct inode *inode`` pre-allocated inode to use for insert to cache ``u64 hashval`` hash value (usually inode number) to get ``int (*test)(struct inode *, void *)`` callback used for comparisons between inodes ``int (*set)(struct inode *, void *)`` callback used to initialize a new struct inode ``void *data`` opaque data pointer to pass to **test** and **set** **Description** Search for the inode specified by **hashval** and **data** in the inode cache, and if present return it with an increased reference count. This is a variant of iget5_locked() that doesn't allocate an inode. If the inode is not present in the cache, insert the pre-allocated inode and return it locked, hashed, and with the I_NEW flag set. The file system gets to fill it in before unlocking it via unlock_new_inode(). Note that both **test** and **set** are called with the inode_hash_lock held, so they can't sleep.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjubj)}(hhh](j)}(hG``struct inode *inode`` pre-allocated inode to use for insert to cache h](j)}(h``struct inode *inode``h]j)}(hj-h]hstruct inode *inode}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj+ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hj'ubj)}(hhh]h)}(h.pre-allocated inode to use for insert to cacheh]h.pre-allocated inode to use for insert to cache}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjBhM hjCubah}(h]h ]h"]h$]h&]uh1jhj'ubeh}(h]h ]h"]h$]h&]uh1jhjBhM hj$ubj)}(h9``u64 hashval`` hash value (usually inode number) to get h](j)}(h``u64 hashval``h]j)}(hjfh]h u64 hashval}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjdubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hj`ubj)}(hhh]h)}(h(hash value (usually inode number) to geth]h(hash value (usually inode number) to get}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj{hM hj|ubah}(h]h ]h"]h$]h&]uh1jhj`ubeh}(h]h ]h"]h$]h&]uh1jhj{hM hj$ubj)}(hU``int (*test)(struct inode *, void *)`` callback used for comparisons between inodes h](j)}(h'``int (*test)(struct inode *, void *)``h]j)}(hjh]h#int (*test)(struct inode *, void *)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjubj)}(hhh]h)}(h,callback used for comparisons between inodesh]h,callback used for comparisons between inodes}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hj$ubj)}(hV``int (*set)(struct inode *, void *)`` callback used to initialize a new struct inode h](j)}(h&``int (*set)(struct inode *, void *)``h]j)}(hjبh]h"int (*set)(struct inode *, void *)}(hjڨhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj֨ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjҨubj)}(hhh]h)}(h.callback used to initialize a new struct inodeh]h.callback used to initialize a new struct inode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjҨubeh}(h]h ]h"]h$]h&]uh1jhjhM hj$ubj)}(hC``void *data`` opaque data pointer to pass to **test** and **set** h](j)}(h``void *data``h]j)}(hjh]h void *data}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhj ubj)}(hhh]h)}(h3opaque data pointer to pass to **test** and **set**h](hopaque data pointer to pass to }(hj*hhhNhNubj)}(h**test**h]htest}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj*ubh and }(hj*hhhNhNubj)}(h**set**h]hset}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj*ubeh}(h]h ]h"]h$]h&]uh1hhj&hMhj'ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj&hMhj$ubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjlh]h Description}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjubh)}(hSearch for the inode specified by **hashval** and **data** in the inode cache, and if present return it with an increased reference count. This is a variant of iget5_locked() that doesn't allocate an inode.h](h"Search for the inode specified by }(hjhhhNhNubj)}(h **hashval**h]hhashval}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh and }(hjhhhNhNubj)}(h**data**h]hdata}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh in the inode cache, and if present return it with an increased reference count. This is a variant of iget5_locked() that doesn’t allocate an inode.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjubh)}(hIf the inode is not present in the cache, insert the pre-allocated inode and return it locked, hashed, and with the I_NEW flag set. The file system gets to fill it in before unlocking it via unlock_new_inode().h]hIf the inode is not present in the cache, insert the pre-allocated inode and return it locked, hashed, and with the I_NEW flag set. The file system gets to fill it in before unlocking it via unlock_new_inode().}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjubh)}(hbNote that both **test** and **set** are called with the inode_hash_lock held, so they can't sleep.h](hNote that both }(hjĩhhhNhNubj)}(h**test**h]htest}(hj̩hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjĩubh and }(hjĩhhhNhNubj)}(h**set**h]hset}(hjީhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjĩubhA are called with the inode_hash_lock held, so they can’t sleep.}(hjĩhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j iget5_locked (C function)c.iget5_lockedhNtauh1hhjhhhNhNubj)}(hhh](j)}(hstruct inode * iget5_locked (struct super_block *sb, u64 hashval, int (*test)(struct inode *, void *), int (*set)(struct inode *, void *), void *data)h]j)}(hstruct inode *iget5_locked(struct super_block *sb, u64 hashval, int (*test)(struct inode*, void*), int (*set)(struct inode*, void*), void *data)h](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMUubj2)}(h h]h }(hj%hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhj$hMUubh)}(hhh]jI)}(hinodeh]hinode}(hj6hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj3ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj8modnameN classnameNjj )}j ]j)}j iget5_lockedsbc.iget5_lockedasbuh1hhjhhhj$hMUubj2)}(h h]h }(hjWhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhj$hMUubj)}(hjh]h*}(hjehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhj$hMUubjC)}(h iget5_lockedh]jI)}(hjTh]h iget5_locked}(hjvhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjrubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhj$hMUubj=)}(hv(struct super_block *sb, u64 hashval, int (*test)(struct inode*, void*), int (*set)(struct inode*, void*), void *data)h](jC)}(hstruct super_block *sbh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(h super_blockh]h super_block}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jRc.iget5_lockedasbuh1hhjubj2)}(h h]h }(hjͪhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj۪hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hsbh]hsb}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h u64 hashvalh](h)}(hhh]jI)}(hu64h]hu64}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jRc.iget5_lockedasbuh1hhjubj2)}(h h]h }(hj"hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hhashvalh]hhashval}(hj0hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h!int (*test)(struct inode*, void*)h](j)}(hinth]hint}(hjIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEubj2)}(h h]h }(hjWhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjEubj)}(hjʥh]h(}(hjehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEubj)}(hjh]h*}(hjrhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEubjI)}(htesth]htest}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjEubj)}(hjh]h)}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEubj)}(hjʥh]h(}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEubj )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjEubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjEubh)}(hhh]jI)}(hinodeh]hinode}(hjūhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj«ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjǫmodnameN classnameNjj )}j ]jRc.iget5_lockedasbuh1hhjEubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEubj)}(hjWh]h,}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjEubj)}(hvoidh]hvoid}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEubj)}(hjh]h)}(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h int (*set)(struct inode*, void*)h](j)}(hinth]hint}(hj>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:ubj2)}(h h]h }(hjLhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj:ubj)}(hjʥh]h(}(hjZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:ubj)}(hjh]h*}(hjghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:ubjI)}(hseth]hset}(hjthhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj:ubj)}(hjh]h)}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:ubj)}(hjʥh]h(}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:ubj )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj:ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj:ubh)}(hhh]jI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jRc.iget5_lockedasbuh1hhj:ubj)}(hjh]h*}(hjجhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:ubj)}(hjWh]h,}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj:ubj)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:ubj)}(hjh]h)}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h void *datah](j)}(hvoidh]hvoid}(hj3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/ubj2)}(h h]h }(hjAhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj/ubj)}(hjh]h*}(hjOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/ubjI)}(hdatah]hdata}(hj\hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj/ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhj$hMUubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhj$hMUubah}(h]j ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj$hMUhj hhubjw)}(hhh]h)}(h*obtain an inode from a mounted file systemh]h*obtain an inode from a mounted file system}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMUhjhhubah}(h]h ]h"]h$]h&]uh1jvhj hhhj$hMUubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjhNhNubj)}(hX**Parameters** ``struct super_block *sb`` super block of file system ``u64 hashval`` hash value (usually inode number) to get ``int (*test)(struct inode *, void *)`` callback used for comparisons between inodes ``int (*set)(struct inode *, void *)`` callback used to initialize a new struct inode ``void *data`` opaque data pointer to pass to **test** and **set** **Description** Search for the inode specified by **hashval** and **data** in the inode cache, and if present return it with an increased reference count. This is a generalized version of iget_locked() for file systems where the inode number is not sufficient for unique identification of an inode. If the inode is not present in the cache, allocate and insert a new inode and return it locked, hashed, and with the I_NEW flag set. The file system gets to fill it in before unlocking it via unlock_new_inode(). Note that both **test** and **set** are called with the inode_hash_lock held, so they can't sleep.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMYhjubj)}(hhh](j)}(h6``struct super_block *sb`` super block of file system h](j)}(h``struct super_block *sb``h]j)}(hjǭh]hstruct super_block *sb}(hjɭhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjŭubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMVhjubj)}(hhh]h)}(hsuper block of file systemh]hsuper block of file system}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjܭhMVhjݭubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjܭhMVhjubj)}(h9``u64 hashval`` hash value (usually inode number) to get h](j)}(h``u64 hashval``h]j)}(hjh]h u64 hashval}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMWhjubj)}(hhh]h)}(h(hash value (usually inode number) to geth]h(hash value (usually inode number) to get}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMWhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMWhjubj)}(hU``int (*test)(struct inode *, void *)`` callback used for comparisons between inodes h](j)}(h'``int (*test)(struct inode *, void *)``h]j)}(hj9h]h#int (*test)(struct inode *, void *)}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj7ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMXhj3ubj)}(hhh]h)}(h,callback used for comparisons between inodesh]h,callback used for comparisons between inodes}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjNhMXhjOubah}(h]h ]h"]h$]h&]uh1jhj3ubeh}(h]h ]h"]h$]h&]uh1jhjNhMXhjubj)}(hV``int (*set)(struct inode *, void *)`` callback used to initialize a new struct inode h](j)}(h&``int (*set)(struct inode *, void *)``h]j)}(hjrh]h"int (*set)(struct inode *, void *)}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jhjpubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMYhjlubj)}(hhh]h)}(h.callback used to initialize a new struct inodeh]h.callback used to initialize a new struct inode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMYhjubah}(h]h ]h"]h$]h&]uh1jhjlubeh}(h]h ]h"]h$]h&]uh1jhjhMYhjubj)}(hC``void *data`` opaque data pointer to pass to **test** and **set** h](j)}(h``void *data``h]j)}(hjh]h void *data}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMZhjubj)}(hhh]h)}(h3opaque data pointer to pass to **test** and **set**h](hopaque data pointer to pass to }(hjĮhhhNhNubj)}(h**test**h]htest}(hj̮hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjĮubh and }(hjĮhhhNhNubj)}(h**set**h]hset}(hjޮhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjĮubeh}(h]h ]h"]h$]h&]uh1hhjhMZhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMZhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM\hjubh)}(hXSearch for the inode specified by **hashval** and **data** in the inode cache, and if present return it with an increased reference count. This is a generalized version of iget_locked() for file systems where the inode number is not sufficient for unique identification of an inode.h](h"Search for the inode specified by }(hjhhhNhNubj)}(h **hashval**h]hhashval}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh and }(hjhhhNhNubj)}(h**data**h]hdata}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh in the inode cache, and if present return it with an increased reference count. This is a generalized version of iget_locked() for file systems where the inode number is not sufficient for unique identification of an inode.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM[hjubh)}(hIf the inode is not present in the cache, allocate and insert a new inode and return it locked, hashed, and with the I_NEW flag set. The file system gets to fill it in before unlocking it via unlock_new_inode().h]hIf the inode is not present in the cache, allocate and insert a new inode and return it locked, hashed, and with the I_NEW flag set. The file system gets to fill it in before unlocking it via unlock_new_inode().}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM`hjubh)}(hbNote that both **test** and **set** are called with the inode_hash_lock held, so they can't sleep.h](hNote that both }(hj^hhhNhNubj)}(h**test**h]htest}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj^ubh and }(hj^hhhNhNubj)}(h**set**h]hset}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj^ubhA are called with the inode_hash_lock held, so they can’t sleep.}(hj^hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMdhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j iget5_locked_rcu (C function)c.iget5_locked_rcuhNtauh1hhjhhhNhNubj)}(hhh](j)}(hstruct inode * iget5_locked_rcu (struct super_block *sb, u64 hashval, int (*test)(struct inode *, void *), int (*set)(struct inode *, void *), void *data)h]j)}(hstruct inode *iget5_locked_rcu(struct super_block *sb, u64 hashval, int (*test)(struct inode*, void*), int (*set)(struct inode*, void*), void *data)h](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM|ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhM|ubh)}(hhh]jI)}(hinodeh]hinode}(hjЯhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjͯubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjүmodnameN classnameNjj )}j ]j)}jiget5_locked_rcusbc.iget5_locked_rcuasbuh1hhjhhhjhM|ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhM|ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM|ubjC)}(higet5_locked_rcuh]jI)}(hjh]higet5_locked_rcu}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhM|ubj=)}(hv(struct super_block *sb, u64 hashval, int (*test)(struct inode*, void*), int (*set)(struct inode*, void*), void *data)h](jC)}(hstruct super_block *sbh](j )}(hjh]hstruct}(hj+hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj'ubj2)}(h h]h }(hj8hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj'ubh)}(hhh]jI)}(h super_blockh]h super_block}(hjIhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjFubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjKmodnameN classnameNjj )}j ]jc.iget5_locked_rcuasbuh1hhj'ubj2)}(h h]h }(hjghhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj'ubj)}(hjh]h*}(hjuhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj'ubjI)}(hsbh]hsb}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj'ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj#ubjC)}(h u64 hashvalh](h)}(hhh]jI)}(hu64h]hu64}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.iget5_locked_rcuasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hhashvalh]hhashval}(hjʰhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj#ubjC)}(h!int (*test)(struct inode*, void*)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj߰ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj߰ubj)}(hjʥh]h(}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj߰ubj)}(hjh]h*}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj߰ubjI)}(htesth]htest}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj߰ubj)}(hjh]h)}(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj߰ubj)}(hjʥh]h(}(hj4hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj߰ubj )}(hjh]hstruct}(hjAhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj߰ubj2)}(h h]h }(hjNhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj߰ubh)}(hhh]jI)}(hinodeh]hinode}(hj_hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj\ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjamodnameN classnameNjj )}j ]jc.iget5_locked_rcuasbuh1hhj߰ubj)}(hjh]h*}(hj}hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj߰ubj)}(hjWh]h,}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj߰ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj߰ubj)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj߰ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj߰ubj)}(hjh]h)}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj߰ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj#ubjC)}(h int (*set)(struct inode*, void*)h](j)}(hinth]hint}(hjرhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjԱubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjԱubj)}(hjʥh]h(}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjԱubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjԱubjI)}(hseth]hset}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjԱubj)}(hjh]h)}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjԱubj)}(hjʥh]h(}(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjԱubj )}(hjh]hstruct}(hj6hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjԱubj2)}(h h]h }(hjChhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjԱubh)}(hhh]jI)}(hinodeh]hinode}(hjThhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjQubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjVmodnameN classnameNjj )}j ]jc.iget5_locked_rcuasbuh1hhjԱubj)}(hjh]h*}(hjrhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjԱubj)}(hjWh]h,}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjԱubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjԱubj)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjԱubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjԱubj)}(hjh]h)}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjԱubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj#ubjC)}(h void *datah](j)}(hvoidh]hvoid}(hjͲhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjɲubj2)}(h h]h }(hj۲hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjɲubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjɲubjI)}(hdatah]hdata}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjɲubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj#ubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhM|ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhM|ubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhM|hjhhubjw)}(hhh]h)}(h*obtain an inode from a mounted file systemh]h*obtain an inode from a mounted file system}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM|hjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhM|ubeh}(h]h ](jfunctioneh"]h$]h&]jjjj8jj8jjjuh1jhhhjhNhNubj)}(hX**Parameters** ``struct super_block *sb`` super block of file system ``u64 hashval`` hash value (usually inode number) to get ``int (*test)(struct inode *, void *)`` callback used for comparisons between inodes ``int (*set)(struct inode *, void *)`` callback used to initialize a new struct inode ``void *data`` opaque data pointer to pass to **test** and **set** **Description** This is equivalent to iget5_locked, except the **test** callback must tolerate the inode not being stable, including being mid-teardown.h](h)}(h**Parameters**h]j)}(hjBh]h Parameters}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj@ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhj<ubj)}(hhh](j)}(h6``struct super_block *sb`` super block of file system h](j)}(h``struct super_block *sb``h]j)}(hjah]hstruct super_block *sb}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jhj_ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM}hj[ubj)}(hhh]h)}(hsuper block of file systemh]hsuper block of file system}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjvhM}hjwubah}(h]h ]h"]h$]h&]uh1jhj[ubeh}(h]h ]h"]h$]h&]uh1jhjvhM}hjXubj)}(h9``u64 hashval`` hash value (usually inode number) to get h](j)}(h``u64 hashval``h]j)}(hjh]h u64 hashval}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM~hjubj)}(hhh]h)}(h(hash value (usually inode number) to geth]h(hash value (usually inode number) to get}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM~hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM~hjXubj)}(hU``int (*test)(struct inode *, void *)`` callback used for comparisons between inodes h](j)}(h'``int (*test)(struct inode *, void *)``h]j)}(hjӳh]h#int (*test)(struct inode *, void *)}(hjճhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjѳubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjͳubj)}(hhh]h)}(h,callback used for comparisons between inodesh]h,callback used for comparisons between inodes}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjͳubeh}(h]h ]h"]h$]h&]uh1jhjhMhjXubj)}(hV``int (*set)(struct inode *, void *)`` callback used to initialize a new struct inode h](j)}(h&``int (*set)(struct inode *, void *)``h]j)}(hj h]h"int (*set)(struct inode *, void *)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjubj)}(hhh]h)}(h.callback used to initialize a new struct inodeh]h.callback used to initialize a new struct inode}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj!hMhj"ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj!hMhjXubj)}(hC``void *data`` opaque data pointer to pass to **test** and **set** h](j)}(h``void *data``h]j)}(hjEh]h void *data}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjCubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhj?ubj)}(hhh]h)}(h3opaque data pointer to pass to **test** and **set**h](hopaque data pointer to pass to }(hj^hhhNhNubj)}(h**test**h]htest}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj^ubh and }(hj^hhhNhNubj)}(h**set**h]hset}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj^ubeh}(h]h ]h"]h$]h&]uh1hhjZhMhj[ubah}(h]h ]h"]h$]h&]uh1jhj?ubeh}(h]h ]h"]h$]h&]uh1jhjZhMhjXubeh}(h]h ]h"]h$]h&]uh1jhj<ubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhj<ubh)}(hThis is equivalent to iget5_locked, except the **test** callback must tolerate the inode not being stable, including being mid-teardown.h](h/This is equivalent to iget5_locked, except the }(hjhhhNhNubj)}(h**test**h]htest}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhQ callback must tolerate the inode not being stable, including being mid-teardown.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhj<ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j iget_locked (C function) c.iget_lockedhNtauh1hhjhhhNhNubj)}(hhh](j)}(hah"]h$]h&]uh1j1hjhhhjhMubh)}(hhh]jI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}j iget_lockedsb c.iget_lockedasbuh1hhjhhhjhMubj2)}(h h]h }(hj7hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMubj)}(hjh]h*}(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubjC)}(h iget_lockedh]jI)}(hj4h]h iget_locked}(hjVhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjRubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhMubj=)}(h!(struct super_block *sb, u64 ino)h](jC)}(hstruct super_block *sbh](j )}(hjh]hstruct}(hjqhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjmubj2)}(h h]h }(hj~hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjmubh)}(hhh]jI)}(h super_blockh]h super_block}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j2 c.iget_lockedasbuh1hhjmubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjmubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmubjI)}(hsbh]hsb}(hjȵhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjmubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjiubjC)}(hu64 inoh](h)}(hhh]jI)}(hu64h]hu64}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j2 c.iget_lockedasbuh1hhjݵubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjݵubjI)}(hinoh]hino}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjݵubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjiubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhMubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMhjhhubjw)}(hhh]h)}(h*obtain an inode from a mounted file systemh]h*obtain an inode from a mounted file system}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhj7hhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjRjjRjjjuh1jhhhjhNhNubj)}(hX**Parameters** ``struct super_block *sb`` super block of file system ``u64 ino`` inode number to get **Description** Search for the inode specified by **ino** in the inode cache and if present return it with an increased reference count. This is for file systems where the inode number is sufficient for unique identification of an inode. If the inode is not in cache, allocate a new inode and return it locked, hashed, and with the I_NEW flag set. The file system gets to fill it in before unlocking it via unlock_new_inode().h](h)}(h**Parameters**h]j)}(hj\h]h Parameters}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjZubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjVubj)}(hhh](j)}(h6``struct super_block *sb`` super block of file system h](j)}(h``struct super_block *sb``h]j)}(hj{h]hstruct super_block *sb}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjyubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjuubj)}(hhh]h)}(hsuper block of file systemh]hsuper block of file system}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjuubeh}(h]h ]h"]h$]h&]uh1jhjhMhjrubj)}(h ``u64 ino`` inode number to get h](j)}(h ``u64 ino``h]j)}(hjh]hu64 ino}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjubj)}(hhh]h)}(hinode number to geth]hinode number to get}(hjͶhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjɶhMhjʶubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjɶhMhjrubeh}(h]h ]h"]h$]h&]uh1jhjVubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjVubh)}(hSearch for the inode specified by **ino** in the inode cache and if present return it with an increased reference count. This is for file systems where the inode number is sufficient for unique identification of an inode.h](h"Search for the inode specified by }(hjhhhNhNubj)}(h**ino**h]hino}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh in the inode cache and if present return it with an increased reference count. This is for file systems where the inode number is sufficient for unique identification of an inode.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjVubh)}(hIf the inode is not in cache, allocate a new inode and return it locked, hashed, and with the I_NEW flag set. The file system gets to fill it in before unlocking it via unlock_new_inode().h]hIf the inode is not in cache, allocate a new inode and return it locked, hashed, and with the I_NEW flag set. The file system gets to fill it in before unlocking it via unlock_new_inode().}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjVubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j iunique (C function) c.iuniquehNtauh1hhjhhhNhNubj)}(hhh](j)}(h:ino_t iunique (struct super_block *sb, ino_t max_reserved)h]j)}(h9ino_t iunique(struct super_block *sb, ino_t max_reserved)h](h)}(hhh]jI)}(hino_th]hino_t}(hjXhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjUubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjZmodnameN classnameNjj )}j ]j)}jiuniquesb c.iuniqueasbuh1hhjQhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM ubj2)}(h h]h }(hjzhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjQhhhjyhM ubjC)}(hiuniqueh]jI)}(hjvh]hiunique}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjQhhhjyhM ubj=)}(h,(struct super_block *sb, ino_t max_reserved)h](jC)}(hstruct super_block *sbh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(h super_blockh]h super_block}(hjŷhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj·ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjǷmodnameN classnameNjj )}j ]jt c.iuniqueasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hsbh]hsb}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hino_t max_reservedh](h)}(hhh]jI)}(hino_th]hino_t}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jt c.iuniqueasbuh1hhjubj2)}(h h]h }(hj8hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(h max_reservedh]h max_reserved}(hjFhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjQhhhjyhM ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjMhhhjyhM ubah}(h]jHah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjyhM hjJhhubjw)}(hhh]h)}(hget a unique inode numberh]hget a unique inode number}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjmhhubah}(h]h ]h"]h$]h&]uh1jvhjJhhhjyhM ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjhNhNubj)}(hX**Parameters** ``struct super_block *sb`` superblock ``ino_t max_reserved`` highest reserved inode number **Description** Obtain an inode number that is unique on the system for a given superblock. This is used by file systems that have no natural permanent inode numbering system. An inode number is returned that is higher than the reserved limit but unique. BUGS: With a large number of inodes live on the file system this function currently becomes quite slow.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjubj)}(hhh](j)}(h&``struct super_block *sb`` superblock h](j)}(h``struct super_block *sb``h]j)}(hjh]hstruct super_block *sb}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjubj)}(hhh]h)}(h superblockh]h superblock}(hjʸhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjƸhM hjǸubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjƸhM hjubj)}(h5``ino_t max_reserved`` highest reserved inode number h](j)}(h``ino_t max_reserved``h]j)}(hjh]hino_t max_reserved}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjubj)}(hhh]h)}(hhighest reserved inode numberh]hhighest reserved inode number}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hj%h]h Description}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj#ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjubj)}(hXWObtain an inode number that is unique on the system for a given superblock. This is used by file systems that have no natural permanent inode numbering system. An inode number is returned that is higher than the reserved limit but unique. BUGS: With a large number of inodes live on the file system this function currently becomes quite slow.h](h)}(hObtain an inode number that is unique on the system for a given superblock. This is used by file systems that have no natural permanent inode numbering system. An inode number is returned that is higher than the reserved limit but unique.h]hObtain an inode number that is unique on the system for a given superblock. This is used by file systems that have no natural permanent inode numbering system. An inode number is returned that is higher than the reserved limit but unique.}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hj;ubh)}(hgBUGS: With a large number of inodes live on the file system this function currently becomes quite slow.h]hgBUGS: With a large number of inodes live on the file system this function currently becomes quite slow.}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhj;ubeh}(h]h ]h"]h$]h&]uh1jhjMhM hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j ihold (C function)c.iholdhNtauh1hhjhhhNhNubj)}(hhh](j)}(h void ihold (struct inode *inode)h]j)}(hvoid ihold(struct inode *inode)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM1ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhM1ubjC)}(hiholdh]jI)}(hiholdh]hihold}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhM1ubj=)}(h(struct inode *inode)h]jC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hj͹hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hinodeh]hinode}(hj޹hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj۹ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jjsbc.iholdasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubah}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhM1ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj{hhhjhM1ubah}(h]jvah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhM1hjxhhubjw)}(hhh]h)}(h;get a reference on the inode, provided you already have oneh]h;get a reference on the inode, provided you already have one}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM1hj@hhubah}(h]h ]h"]h$]h&]uh1jvhjxhhhjhM1ubeh}(h]h ](jfunctioneh"]h$]h&]jjjj[jj[jjjuh1jhhhjhNhNubj)}(h=**Parameters** ``struct inode *inode`` inode to operate onh](h)}(h**Parameters**h]j)}(hjeh]h Parameters}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1jhjcubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM5hj_ubj)}(hhh]j)}(h+``struct inode *inode`` inode to operate onh](j)}(h``struct inode *inode``h]j)}(hjh]hstruct inode *inode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM7hj~ubj)}(hhh]h)}(hinode to operate onh]hinode to operate on}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM2hjubah}(h]h ]h"]h$]h&]uh1jhj~ubeh}(h]h ]h"]h$]h&]uh1jhjhM7hj{ubah}(h]h ]h"]h$]h&]uh1jhj_ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j ilookup5_nowait (C function)c.ilookup5_nowaithNtauh1hhjhhhNhNubj)}(hhh](j)}(hstruct inode * ilookup5_nowait (struct super_block *sb, u64 hashval, int (*test)(struct inode *, void *), void *data, bool *isnew)h]j)}(h~struct inode *ilookup5_nowait(struct super_block *sb, u64 hashval, int (*test)(struct inode*, void*), void *data, bool *isnew)h](j )}(hjh]hstruct}(hj޺hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjںhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM|ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjںhhhjhM|ubh)}(hhh]jI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jilookup5_nowaitsbc.ilookup5_nowaitasbuh1hhjںhhhjhM|ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjںhhhjhM|ubj)}(hjh]h*}(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjںhhhjhM|ubjC)}(hilookup5_nowaith]jI)}(hjh]hilookup5_nowait}(hj=hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj9ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjںhhhjhM|ubj=)}(ha(struct super_block *sb, u64 hashval, int (*test)(struct inode*, void*), void *data, bool *isnew)h](jC)}(hstruct super_block *sbh](j )}(hjh]hstruct}(hjXhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjTubj2)}(h h]h }(hjehhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjTubh)}(hhh]jI)}(h super_blockh]h super_block}(hjvhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjsubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjxmodnameN classnameNjj )}j ]jc.ilookup5_nowaitasbuh1hhjTubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjTubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjTubjI)}(hsbh]hsb}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjTubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjPubjC)}(h u64 hashvalh](h)}(hhh]jI)}(hu64h]hu64}(hj˻hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjȻubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjͻmodnameN classnameNjj )}j ]jc.ilookup5_nowaitasbuh1hhjĻubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjĻubjI)}(hhashvalh]hhashval}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjĻubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjPubjC)}(h!int (*test)(struct inode*, void*)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj ubj)}(hjʥh]h(}(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(hjh]h*}(hj9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubjI)}(htesth]htest}(hjFhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubj)}(hjh]h)}(hjThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(hjʥh]h(}(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj )}(hjh]hstruct}(hjnhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj ubj2)}(h h]h }(hj{hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj ubh)}(hhh]jI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.ilookup5_nowaitasbuh1hhj ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(hjWh]h,}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj2)}(h h]h }(hjļhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj ubj)}(hvoidh]hvoid}(hjҼhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(hjh]h)}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjPubjC)}(h void *datah](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hdatah]hdata}(hj.hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjPubjC)}(h bool *isnewh](j)}(hjh]hbool}(hjGhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCubj2)}(h h]h }(hjThhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjCubj)}(hjh]h*}(hjbhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCubjI)}(hisnewh]hisnew}(hjohhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjCubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjPubeh}(h]h ]h"]h$]h&]j`jauh1j<hjںhhhjhM|ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjֺhhhjhM|ubah}(h]jѺah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhM|hjӺhhubjw)}(hhh]h)}(h&search for an inode in the inode cacheh]h&search for an inode in the inode cache}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM|hjhhubah}(h]h ]h"]h$]h&]uh1jvhjӺhhhjhM|ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjhNhNubj)}(hXX**Parameters** ``struct super_block *sb`` super block of file system to search ``u64 hashval`` hash value (usually inode number) to search for ``int (*test)(struct inode *, void *)`` callback used for comparisons between inodes ``void *data`` opaque data pointer to pass to **test** ``bool *isnew`` return argument telling whether I_NEW was set when the inode was found in hash (the caller needs to wait for I_NEW to clear) **Description** Search for the inode specified by **hashval** and **data** in the inode cache. If the inode is in the cache, the inode is returned with an incremented reference count. **Note** I_NEW is not waited upon so you have to be very careful what you do with the returned inode. You probably should be using ilookup5() instead. Note2: **test** is called with the inode_hash_lock held, so can't sleep.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjubj)}(hhh](j)}(h@``struct super_block *sb`` super block of file system to search h](j)}(h``struct super_block *sb``h]j)}(hjڽh]hstruct super_block *sb}(hjܽhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjؽubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM}hjԽubj)}(hhh]h)}(h$super block of file system to searchh]h$super block of file system to search}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM}hjubah}(h]h ]h"]h$]h&]uh1jhjԽubeh}(h]h ]h"]h$]h&]uh1jhjhM}hjѽubj)}(h@``u64 hashval`` hash value (usually inode number) to search for h](j)}(h``u64 hashval``h]j)}(hjh]h u64 hashval}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM~hj ubj)}(hhh]h)}(h/hash value (usually inode number) to search forh]h/hash value (usually inode number) to search for}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj(hM~hj)ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj(hM~hjѽubj)}(hU``int (*test)(struct inode *, void *)`` callback used for comparisons between inodes h](j)}(h'``int (*test)(struct inode *, void *)``h]j)}(hjLh]h#int (*test)(struct inode *, void *)}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjJubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjFubj)}(hhh]h)}(h,callback used for comparisons between inodesh]h,callback used for comparisons between inodes}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1hhjahMhjbubah}(h]h ]h"]h$]h&]uh1jhjFubeh}(h]h ]h"]h$]h&]uh1jhjahMhjѽubj)}(h7``void *data`` opaque data pointer to pass to **test** h](j)}(h``void *data``h]j)}(hjh]h void *data}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjubj)}(hhh]h)}(h'opaque data pointer to pass to **test**h](hopaque data pointer to pass to }(hjhhhNhNubj)}(h**test**h]htest}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjѽubj)}(h``bool *isnew`` return argument telling whether I_NEW was set when the inode was found in hash (the caller needs to wait for I_NEW to clear) h](j)}(h``bool *isnew``h]j)}(hj̾h]h bool *isnew}(hjξhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjʾubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjƾubj)}(hhh]h)}(h|return argument telling whether I_NEW was set when the inode was found in hash (the caller needs to wait for I_NEW to clear)h]h|return argument telling whether I_NEW was set when the inode was found in hash (the caller needs to wait for I_NEW to clear)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjubah}(h]h ]h"]h$]h&]uh1jhjƾubeh}(h]h ]h"]h$]h&]uh1jhjhMhjѽubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjubh)}(hSearch for the inode specified by **hashval** and **data** in the inode cache. If the inode is in the cache, the inode is returned with an incremented reference count.h](h"Search for the inode specified by }(hjhhhNhNubj)}(h **hashval**h]hhashval}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh and }(hjhhhNhNubj)}(h**data**h]hdata}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhm in the inode cache. If the inode is in the cache, the inode is returned with an incremented reference count.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjubh)}(h**Note**h]j)}(hjSh]hNote}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjQubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjubh)}(hI_NEW is not waited upon so you have to be very careful what you do with the returned inode. You probably should be using ilookup5() instead.h]hI_NEW is not waited upon so you have to be very careful what you do with the returned inode. You probably should be using ilookup5() instead.}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjubh)}(hHNote2: **test** is called with the inode_hash_lock held, so can't sleep.h](hNote2: }(hjxhhhNhNubj)}(h**test**h]htest}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjxubh; is called with the inode_hash_lock held, so can’t sleep.}(hjxhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j ilookup5 (C function) c.ilookup5hNtauh1hhjhhhNhNubj)}(hhh](j)}(hnstruct inode * ilookup5 (struct super_block *sb, u64 hashval, int (*test)(struct inode *, void *), void *data)h]j)}(hjstruct inode *ilookup5(struct super_block *sb, u64 hashval, int (*test)(struct inode*, void*), void *data)h](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMubj2)}(h h]h }(hjǿhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjƿhMubh)}(hhh]jI)}(hinodeh]hinode}(hjؿhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjտubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjڿmodnameN classnameNjj )}j ]j)}jilookup5sb c.ilookup5asbuh1hhjhhhjƿhMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjƿhMubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjƿhMubjC)}(hilookup5h]jI)}(hjh]hilookup5}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjƿhMubj=)}(hT(struct super_block *sb, u64 hashval, int (*test)(struct inode*, void*), void *data)h](jC)}(hstruct super_block *sbh](j )}(hjh]hstruct}(hj3hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj/ubj2)}(h h]h }(hj@hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj/ubh)}(hhh]jI)}(h super_blockh]h super_block}(hjQhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjNubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjSmodnameN classnameNjj )}j ]j c.ilookup5asbuh1hhj/ubj2)}(h h]h }(hjohhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj/ubj)}(hjh]h*}(hj}hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/ubjI)}(hsbh]hsb}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj/ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj+ubjC)}(h u64 hashvalh](h)}(hhh]jI)}(hu64h]hu64}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j c.ilookup5asbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hhashvalh]hhashval}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj+ubjC)}(h!int (*test)(struct inode*, void*)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjʥh]h(}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(htesth]htest}(hj!hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubj)}(hjh]h)}(hj/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjʥh]h(}(hj<hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj )}(hjh]hstruct}(hjIhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjVhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hinodeh]hinode}(hjghhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjdubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjimodnameN classnameNjj )}j ]j c.ilookup5asbuh1hhjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjWh]h,}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]h)}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj+ubjC)}(h void *datah](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hdatah]hdata}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj+ubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjƿhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjƿhMubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjƿhMhjhhubjw)}(hhh]h)}(h&search for an inode in the inode cacheh]h&search for an inode in the inode cache}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhj0hhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjƿhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjKjjKjjjuh1jhhhjhNhNubj)}(hX**Parameters** ``struct super_block *sb`` super block of file system to search ``u64 hashval`` hash value (usually inode number) to search for ``int (*test)(struct inode *, void *)`` callback used for comparisons between inodes ``void *data`` opaque data pointer to pass to **test** **Description** Search for the inode specified by **hashval** and **data** in the inode cache, and if the inode is in the cache, return the inode with an incremented reference count. Waits on I_NEW before returning the inode. returned with an incremented reference count. This is a generalized version of ilookup() for file systems where the inode number is not sufficient for unique identification of an inode. **Note** **test** is called with the inode_hash_lock held, so can't sleep.h](h)}(h**Parameters**h]j)}(hjUh]h Parameters}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjSubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjOubj)}(hhh](j)}(h@``struct super_block *sb`` super block of file system to search h](j)}(h``struct super_block *sb``h]j)}(hjth]hstruct super_block *sb}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjrubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjnubj)}(hhh]h)}(h$super block of file system to searchh]h$super block of file system to search}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjnubeh}(h]h ]h"]h$]h&]uh1jhjhMhjkubj)}(h@``u64 hashval`` hash value (usually inode number) to search for h](j)}(h``u64 hashval``h]j)}(hjh]h u64 hashval}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjubj)}(hhh]h)}(h/hash value (usually inode number) to search forh]h/hash value (usually inode number) to search for}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjkubj)}(hU``int (*test)(struct inode *, void *)`` callback used for comparisons between inodes h](j)}(h'``int (*test)(struct inode *, void *)``h]j)}(hjh]h#int (*test)(struct inode *, void *)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjubj)}(hhh]h)}(h,callback used for comparisons between inodesh]h,callback used for comparisons between inodes}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjkubj)}(h7``void *data`` opaque data pointer to pass to **test** h](j)}(h``void *data``h]j)}(hjh]h void *data}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjubj)}(hhh]h)}(h'opaque data pointer to pass to **test**h](hopaque data pointer to pass to }(hj8hhhNhNubj)}(h**test**h]htest}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj8ubeh}(h]h ]h"]h$]h&]uh1hhj4hMhj5ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj4hMhjkubeh}(h]h ]h"]h$]h&]uh1jhjOubh)}(h**Description**h]j)}(hjhh]h Description}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjfubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjOubh)}(hXSearch for the inode specified by **hashval** and **data** in the inode cache, and if the inode is in the cache, return the inode with an incremented reference count. Waits on I_NEW before returning the inode. returned with an incremented reference count.h](h"Search for the inode specified by }(hj~hhhNhNubj)}(h **hashval**h]hhashval}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj~ubh and }(hj~hhhNhNubj)}(h**data**h]hdata}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj~ubh in the inode cache, and if the inode is in the cache, return the inode with an incremented reference count. Waits on I_NEW before returning the inode. returned with an incremented reference count.}(hj~hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjOubh)}(hThis is a generalized version of ilookup() for file systems where the inode number is not sufficient for unique identification of an inode.h]hThis is a generalized version of ilookup() for file systems where the inode number is not sufficient for unique identification of an inode.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjOubh)}(h**Note**h]j)}(hjh]hNote}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjOubh)}(hA**test** is called with the inode_hash_lock held, so can't sleep.h](j)}(h**test**h]htest}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh; is called with the inode_hash_lock held, so can’t sleep.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjOubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j ilookup (C function) c.ilookuphNtauh1hhjhhhNhNubj)}(hhh](j)}(h8struct inode * ilookup (struct super_block *sb, u64 ino)h]j)}(h6struct inode *ilookup(struct super_block *sb, u64 ino)h](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMubj2)}(h h]h }(hj#hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhj"hMubh)}(hhh]jI)}(hinodeh]hinode}(hj4hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj1ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj6modnameN classnameNjj )}j ]j)}jilookupsb c.ilookupasbuh1hhjhhhj"hMubj2)}(h h]h }(hjUhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhj"hMubj)}(hjh]h*}(hjchhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhj"hMubjC)}(hilookuph]jI)}(hjRh]hilookup}(hjthhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjpubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhj"hMubj=)}(h!(struct super_block *sb, u64 ino)h](jC)}(hstruct super_block *sbh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(h super_blockh]h super_block}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jP c.ilookupasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hsbh]hsb}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hu64 inoh](h)}(hhh]jI)}(hu64h]hu64}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jP c.ilookupasbuh1hhjubj2)}(h h]h }(hj hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hinoh]hino}(hj.hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhj"hMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj hhhj"hMubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj"hMhj hhubjw)}(hhh]h)}(h&search for an inode in the inode cacheh]h&search for an inode in the inode cache}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjUhhubah}(h]h ]h"]h$]h&]uh1jvhj hhhj"hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjpjjpjjjuh1jhhhjhNhNubj)}(hX**Parameters** ``struct super_block *sb`` super block of file system to search ``u64 ino`` inode number to search for **Description** Search for the inode **ino** in the inode cache, and if the inode is in the cache, the inode is returned with an incremented reference count.h](h)}(h**Parameters**h]j)}(hjzh]h Parameters}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjxubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjtubj)}(hhh](j)}(h@``struct super_block *sb`` super block of file system to search h](j)}(h``struct super_block *sb``h]j)}(hjh]hstruct super_block *sb}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjubj)}(hhh]h)}(h$super block of file system to searchh]h$super block of file system to search}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h'``u64 ino`` inode number to search for h](j)}(h ``u64 ino``h]j)}(hjh]hu64 ino}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjubj)}(hhh]h)}(hinode number to search forh]hinode number to search for}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubeh}(h]h ]h"]h$]h&]uh1jhjtubh)}(h**Description**h]j)}(hj h]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjtubh)}(hSearch for the inode **ino** in the inode cache, and if the inode is in the cache, the inode is returned with an incremented reference count.h](hSearch for the inode }(hj#hhhNhNubj)}(h**ino**h]hino}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj#ubhq in the inode cache, and if the inode is in the cache, the inode is returned with an incremented reference count.}(hj#hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjtubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j find_inode_nowait (C function)c.find_inode_nowaithNtauh1hhjhhhNhNubj)}(hhh](j)}(h}struct inode * find_inode_nowait (struct super_block *sb, u64 hashval, int (*match)(struct inode *, u64, void *), void *data)h]j)}(hystruct inode *find_inode_nowait(struct super_block *sb, u64 hashval, int (*match)(struct inode*, u64, void*), void *data)h](j )}(hjh]hstruct}(hjdhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj`hhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMubj2)}(h h]h }(hjrhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj`hhhjqhMubh)}(hhh]jI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jfind_inode_nowaitsbc.find_inode_nowaitasbuh1hhj`hhhjqhMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj`hhhjqhMubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj`hhhjqhMubjC)}(hfind_inode_nowaith]jI)}(hjh]hfind_inode_nowait}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj`hhhjqhMubj=)}(hZ(struct super_block *sb, u64 hashval, int (*match)(struct inode*, u64, void*), void *data)h](jC)}(hstruct super_block *sbh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(h super_blockh]h super_block}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.find_inode_nowaitasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj(hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hsbh]hsb}(hj5hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h u64 hashvalh](h)}(hhh]jI)}(hu64h]hu64}(hjQhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjNubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjSmodnameN classnameNjj )}j ]jc.find_inode_nowaitasbuh1hhjJubj2)}(h h]h }(hjohhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjJubjI)}(hhashvalh]hhashval}(hj}hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjJubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h'int (*match)(struct inode*, u64, void*)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjʥh]h(}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hmatchh]hmatch}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubj)}(hjh]h)}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjʥh]h(}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.find_inode_nowaitasbuh1hhjubj)}(hjh]h*}(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjWh]h,}(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjJhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hu64h]hu64}(hj[hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjXubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj]modnameN classnameNjj )}j ]jc.find_inode_nowaitasbuh1hhjubj)}(hjWh]h,}(hjyhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]h)}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h void *datah](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hdatah]hdata}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hj`hhhjqhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj\hhhjqhMubah}(h]jWah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjqhMhjYhhubjw)}(hhh]h)}(h find an inode in the inode cacheh]h find an inode in the inode cache}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjhhubah}(h]h ]h"]h$]h&]uh1jvhjYhhhjqhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjj2jj2jjjuh1jhhhjhNhNubj)}(hX**Parameters** ``struct super_block *sb`` super block of file system to search ``u64 hashval`` hash value (usually inode number) to search for ``int (*match)(struct inode *, u64, void *)`` callback used for comparisons between inodes ``void *data`` opaque data pointer to pass to **match** **Description** Search for the inode specified by **hashval** and **data** in the inode cache, where the helper function **match** will return 0 if the inode does not match, 1 if the inode does match, and -1 if the search should be stopped. The **match** function must be responsible for taking the i_lock spin_lock and checking i_state for an inode being freed or being initialized, and incrementing the reference count before returning 1. It also must not sleep, since it is called with the inode_hash_lock spinlock held. This is a even more generalized version of ilookup5() when the function must never block --- find_inode() can block in __wait_on_freeing_inode() --- or when the caller can not increment the reference count because the resulting iput() might cause an inode eviction. The tradeoff is that the **match** function must be very carefully implemented.h](h)}(h**Parameters**h]j)}(hj<h]h Parameters}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj:ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhj6ubj)}(hhh](j)}(h@``struct super_block *sb`` super block of file system to search h](j)}(h``struct super_block *sb``h]j)}(hj[h]hstruct super_block *sb}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjYubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjUubj)}(hhh]h)}(h$super block of file system to searchh]h$super block of file system to search}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1hhjphMhjqubah}(h]h ]h"]h$]h&]uh1jhjUubeh}(h]h ]h"]h$]h&]uh1jhjphMhjRubj)}(h@``u64 hashval`` hash value (usually inode number) to search for h](j)}(h``u64 hashval``h]j)}(hjh]h u64 hashval}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjubj)}(hhh]h)}(h/hash value (usually inode number) to search forh]h/hash value (usually inode number) to search for}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjRubj)}(h[``int (*match)(struct inode *, u64, void *)`` callback used for comparisons between inodes h](j)}(h-``int (*match)(struct inode *, u64, void *)``h]j)}(hjh]h)int (*match)(struct inode *, u64, void *)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjubj)}(hhh]h)}(h,callback used for comparisons between inodesh]h,callback used for comparisons between inodes}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjRubj)}(h8``void *data`` opaque data pointer to pass to **match** h](j)}(h``void *data``h]j)}(hjh]h void *data}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjubj)}(hhh]h)}(h(opaque data pointer to pass to **match**h](hopaque data pointer to pass to }(hjhhhNhNubj)}(h **match**h]hmatch}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjRubeh}(h]h ]h"]h$]h&]uh1jhj6ubh)}(h**Description**h]j)}(hjOh]h Description}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjMubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhj6ubh)}(hXSearch for the inode specified by **hashval** and **data** in the inode cache, where the helper function **match** will return 0 if the inode does not match, 1 if the inode does match, and -1 if the search should be stopped. The **match** function must be responsible for taking the i_lock spin_lock and checking i_state for an inode being freed or being initialized, and incrementing the reference count before returning 1. It also must not sleep, since it is called with the inode_hash_lock spinlock held.h](h"Search for the inode specified by }(hjehhhNhNubj)}(h **hashval**h]hhashval}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjeubh and }(hjehhhNhNubj)}(h**data**h]hdata}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjeubh/ in the inode cache, where the helper function }(hjehhhNhNubj)}(h **match**h]hmatch}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjeubht will return 0 if the inode does not match, 1 if the inode does match, and -1 if the search should be stopped. The }(hjehhhNhNubj)}(h **match**h]hmatch}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjeubhX function must be responsible for taking the i_lock spin_lock and checking i_state for an inode being freed or being initialized, and incrementing the reference count before returning 1. It also must not sleep, since it is called with the inode_hash_lock spinlock held.}(hjehhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhj6ubh)}(hXZThis is a even more generalized version of ilookup5() when the function must never block --- find_inode() can block in __wait_on_freeing_inode() --- or when the caller can not increment the reference count because the resulting iput() might cause an inode eviction. The tradeoff is that the **match** function must be very carefully implemented.h](hX$This is a even more generalized version of ilookup5() when the function must never block --- find_inode() can block in __wait_on_freeing_inode() --- or when the caller can not increment the reference count because the resulting iput() might cause an inode eviction. The tradeoff is that the }(hjhhhNhNubj)}(h **match**h]hmatch}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh- function must be very carefully implemented.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhj6ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j find_inode_rcu (C function)c.find_inode_rcuhNtauh1hhjhhhNhNubj)}(hhh](j)}(htstruct inode * find_inode_rcu (struct super_block *sb, u64 hashval, int (*test)(struct inode *, void *), void *data)h]j)}(hpstruct inode *find_inode_rcu(struct super_block *sb, u64 hashval, int (*test)(struct inode*, void*), void *data)h](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMubj2)}(h h]h }(hj hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhj hMubh)}(hhh]jI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jfind_inode_rcusbc.find_inode_rcuasbuh1hhjhhhj hMubj2)}(h h]h }(hj=hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhj hMubj)}(hjh]h*}(hjKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhj hMubjC)}(hfind_inode_rcuh]jI)}(hj:h]hfind_inode_rcu}(hj\hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjXubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhj hMubj=)}(hT(struct super_block *sb, u64 hashval, int (*test)(struct inode*, void*), void *data)h](jC)}(hstruct super_block *sbh](j )}(hjh]hstruct}(hjwhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjsubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjsubh)}(hhh]jI)}(h super_blockh]h super_block}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j8c.find_inode_rcuasbuh1hhjsubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjsubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjsubjI)}(hsbh]hsb}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjsubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjoubjC)}(h u64 hashvalh](h)}(hhh]jI)}(hu64h]hu64}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j8c.find_inode_rcuasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hhashvalh]hhashval}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjoubjC)}(h!int (*test)(struct inode*, void*)h](j)}(hinth]hint}(hj/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubj2)}(h h]h }(hj=hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj+ubj)}(hjʥh]h(}(hjKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubj)}(hjh]h*}(hjXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubjI)}(htesth]htest}(hjehhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj+ubj)}(hjh]h)}(hjshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubj)}(hjʥh]h(}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubj )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj+ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj+ubh)}(hhh]jI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j8c.find_inode_rcuasbuh1hhj+ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubj)}(hjWh]h,}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj+ubj)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubj)}(hjh]h)}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjoubjC)}(h void *datah](j)}(hvoidh]hvoid}(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj2)}(h h]h }(hj2hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj ubj)}(hjh]h*}(hj@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubjI)}(hdatah]hdata}(hjMhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjoubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhj hMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhj hMubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj hMhjhhubjw)}(hhh]h)}(h find an inode in the inode cacheh]h find an inode in the inode cache}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjthhubah}(h]h ]h"]h$]h&]uh1jvhjhhhj hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjhNhNubj)}(hX:**Parameters** ``struct super_block *sb`` Super block of file system to search ``u64 hashval`` Key to hash ``int (*test)(struct inode *, void *)`` Function to test match on an inode ``void *data`` Data for test function **Description** Search for the inode specified by **hashval** and **data** in the inode cache, where the helper function **test** will return 0 if the inode does not match and 1 if it does. The **test** function must be responsible for taking the i_lock spin_lock and checking i_state for an inode being freed or being initialized. If successful, this will return the inode for which the **test** function returned 1 and NULL otherwise. The **test** function is not permitted to take a ref on any inode presented. It is also not permitted to sleep. The caller must hold the RCU read lock.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjubj)}(hhh](j)}(h@``struct super_block *sb`` Super block of file system to search h](j)}(h``struct super_block *sb``h]j)}(hjh]hstruct super_block *sb}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjubj)}(hhh]h)}(h$Super block of file system to searchh]h$Super block of file system to search}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h``u64 hashval`` Key to hash h](j)}(h``u64 hashval``h]j)}(hjh]h u64 hashval}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjubj)}(hhh]h)}(h Key to hashh]h Key to hash}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(hK``int (*test)(struct inode *, void *)`` Function to test match on an inode h](j)}(h'``int (*test)(struct inode *, void *)``h]j)}(hj*h]h#int (*test)(struct inode *, void *)}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj(ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhj$ubj)}(hhh]h)}(h"Function to test match on an inodeh]h"Function to test match on an inode}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1hhj?hMhj@ubah}(h]h ]h"]h$]h&]uh1jhj$ubeh}(h]h ]h"]h$]h&]uh1jhj?hMhjubj)}(h&``void *data`` Data for test function h](j)}(h``void *data``h]j)}(hjch]h void *data}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1jhjaubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhj]ubj)}(hhh]h)}(hData for test functionh]hData for test function}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjxhMhjyubah}(h]h ]h"]h$]h&]uh1jhj]ubeh}(h]h ]h"]h$]h&]uh1jhjxhMhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjubh)}(hX<Search for the inode specified by **hashval** and **data** in the inode cache, where the helper function **test** will return 0 if the inode does not match and 1 if it does. The **test** function must be responsible for taking the i_lock spin_lock and checking i_state for an inode being freed or being initialized.h](h"Search for the inode specified by }(hjhhhNhNubj)}(h **hashval**h]hhashval}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh and }(hjhhhNhNubj)}(h**data**h]hdata}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh/ in the inode cache, where the helper function }(hjhhhNhNubj)}(h**test**h]htest}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhB will return 0 if the inode does not match and 1 if it does. The }(hjhhhNhNubj)}(h**test**h]htest}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh function must be responsible for taking the i_lock spin_lock and checking i_state for an inode being freed or being initialized.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjubh)}(hhIf successful, this will return the inode for which the **test** function returned 1 and NULL otherwise.h](h8If successful, this will return the inode for which the }(hj hhhNhNubj)}(h**test**h]htest}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubh( function returned 1 and NULL otherwise.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM"hjubh)}(hoThe **test** function is not permitted to take a ref on any inode presented. It is also not permitted to sleep.h](hThe }(hj,hhhNhNubj)}(h**test**h]htest}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj,ubhc function is not permitted to take a ref on any inode presented. It is also not permitted to sleep.}(hj,hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM%hjubh)}(h'The caller must hold the RCU read lock.h]h'The caller must hold the RCU read lock.}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM(hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j "find_inode_by_ino_rcu (C function)c.find_inode_by_ino_rcuhNtauh1hhjhhhNhNubj)}(hhh](j)}(hFstruct inode * find_inode_by_ino_rcu (struct super_block *sb, u64 ino)h]j)}(hDstruct inode *find_inode_by_ino_rcu(struct super_block *sb, u64 ino)h](j )}(hjh]hstruct}(hj|hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjxhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM?ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjxhhhjhM?ubh)}(hhh]jI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jfind_inode_by_ino_rcusbc.find_inode_by_ino_rcuasbuh1hhjxhhhjhM?ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjxhhhjhM?ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjxhhhjhM?ubjC)}(hfind_inode_by_ino_rcuh]jI)}(hjh]hfind_inode_by_ino_rcu}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjxhhhjhM?ubj=)}(h!(struct super_block *sb, u64 ino)h](jC)}(hstruct super_block *sbh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(h super_blockh]h super_block}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.find_inode_by_ino_rcuasbuh1hhjubj2)}(h h]h }(hj2hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hsbh]hsb}(hjMhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hu64 inoh](h)}(hhh]jI)}(hu64h]hu64}(hjihhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjfubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjkmodnameN classnameNjj )}j ]jc.find_inode_by_ino_rcuasbuh1hhjbubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjbubjI)}(hinoh]hino}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjbubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjxhhhjhM?ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjthhhjhM?ubah}(h]joah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhM?hjqhhubjw)}(hhh]h)}(h Find an inode in the inode cacheh]h Find an inode in the inode cache}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM?hjhhubah}(h]h ]h"]h$]h&]uh1jvhjqhhhjhM?ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjhNhNubj)}(hX**Parameters** ``struct super_block *sb`` Super block of file system to search ``u64 ino`` The inode number to match **Description** Search for the inode specified by **hashval** and **data** in the inode cache, where the helper function **test** will return 0 if the inode does not match and 1 if it does. The **test** function must be responsible for taking the i_lock spin_lock and checking i_state for an inode being freed or being initialized. If successful, this will return the inode for which the **test** function returned 1 and NULL otherwise. The **test** function is not permitted to take a ref on any inode presented. It is also not permitted to sleep. The caller must hold the RCU read lock.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMChjubj)}(hhh](j)}(h@``struct super_block *sb`` Super block of file system to search h](j)}(h``struct super_block *sb``h]j)}(hjh]hstruct super_block *sb}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM@hjubj)}(hhh]h)}(h$Super block of file system to searchh]h$Super block of file system to search}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM@hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM@hjubj)}(h&``u64 ino`` The inode number to match h](j)}(h ``u64 ino``h]j)}(hj9h]hu64 ino}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj7ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMAhj3ubj)}(hhh]h)}(hThe inode number to matchh]hThe inode number to match}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjNhMAhjOubah}(h]h ]h"]h$]h&]uh1jhj3ubeh}(h]h ]h"]h$]h&]uh1jhjNhMAhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjth]h Description}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjrubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMChjubh)}(hX<Search for the inode specified by **hashval** and **data** in the inode cache, where the helper function **test** will return 0 if the inode does not match and 1 if it does. The **test** function must be responsible for taking the i_lock spin_lock and checking i_state for an inode being freed or being initialized.h](h"Search for the inode specified by }(hjhhhNhNubj)}(h **hashval**h]hhashval}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh and }(hjhhhNhNubj)}(h**data**h]hdata}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh/ in the inode cache, where the helper function }(hjhhhNhNubj)}(h**test**h]htest}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhB will return 0 if the inode does not match and 1 if it does. The }(hjhhhNhNubj)}(h**test**h]htest}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh function must be responsible for taking the i_lock spin_lock and checking i_state for an inode being freed or being initialized.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMBhjubh)}(hhIf successful, this will return the inode for which the **test** function returned 1 and NULL otherwise.h](h8If successful, this will return the inode for which the }(hjhhhNhNubj)}(h**test**h]htest}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh( function returned 1 and NULL otherwise.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMHhjubh)}(hoThe **test** function is not permitted to take a ref on any inode presented. It is also not permitted to sleep.h](hThe }(hjhhhNhNubj)}(h**test**h]htest}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhc function is not permitted to take a ref on any inode presented. It is also not permitted to sleep.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMKhjubh)}(h'The caller must hold the RCU read lock.h]h'The caller must hold the RCU read lock.}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMNhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j iput (C function)c.iputhNtauh1hhjhhhNhNubj)}(hhh](j)}(hvoid iput (struct inode *inode)h]j)}(hvoid iput(struct inode *inode)h](j)}(hvoidh]hvoid}(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMubj2)}(h h]h }(hjahhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjNhhhj`hMubjC)}(hiputh]jI)}(hiputh]hiput}(hjshhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjoubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjNhhhj`hMubj=)}(h(struct inode *inode)h]jC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jjusbc.iputasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubah}(h]h ]h"]h$]h&]j`jauh1j<hjNhhhj`hMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjJhhhj`hMubah}(h]jEah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj`hMhjGhhubjw)}(hhh]h)}(h put an inodeh]h put an inode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjhhubah}(h]h ]h"]h$]h&]uh1jvhjGhhhj`hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjj*jj*jjjuh1jhhhjhNhNubj)}(h**Parameters** ``struct inode *inode`` inode to put **Description** Puts an inode, dropping its usage count. If the inode use count hits zero, the inode is then freed and may also be destroyed. Consequently, iput() can sleep.h](h)}(h**Parameters**h]j)}(hj4h]h Parameters}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj2ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhj.ubj)}(hhh]j)}(h%``struct inode *inode`` inode to put h](j)}(h``struct inode *inode``h]j)}(hjSh]hstruct inode *inode}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjQubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjMubj)}(hhh]h)}(h inode to puth]h inode to put}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhMhjiubah}(h]h ]h"]h$]h&]uh1jhjMubeh}(h]h ]h"]h$]h&]uh1jhjhhMhjJubah}(h]h ]h"]h$]h&]uh1jhj.ubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhj.ubj)}(hPuts an inode, dropping its usage count. If the inode use count hits zero, the inode is then freed and may also be destroyed. Consequently, iput() can sleep.h](h)}(h}Puts an inode, dropping its usage count. If the inode use count hits zero, the inode is then freed and may also be destroyed.h]h}Puts an inode, dropping its usage count. If the inode use count hits zero, the inode is then freed and may also be destroyed.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjubh)}(hConsequently, iput() can sleep.h]hConsequently, iput() can sleep.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhj.ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j iput_not_last (C function)c.iput_not_lasthNtauh1hhjhhhNhNubj)}(hhh](j)}(h(void iput_not_last (struct inode *inode)h]j)}(h'void iput_not_last(struct inode *inode)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMubjC)}(h iput_not_lasth]jI)}(h iput_not_lasth]h iput_not_last}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhMubj=)}(h(struct inode *inode)h]jC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hj)hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj%ubj2)}(h h]h }(hj6hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj%ubh)}(hhh]jI)}(hinodeh]hinode}(hjGhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjDubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjImodnameN classnameNjj )}j ]j)}jjsbc.iput_not_lastasbuh1hhj%ubj2)}(h h]h }(hjghhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj%ubj)}(hjh]h*}(hjuhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%ubjI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj%ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj!ubah}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhMubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMhjhhubjw)}(hhh]h)}(h4put an inode assuming this is not the last referenceh]h4put an inode assuming this is not the last reference}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjhNhNubj)}(h6**Parameters** ``struct inode *inode`` inode to puth](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM#hjubj)}(hhh]j)}(h$``struct inode *inode`` inode to puth](j)}(h``struct inode *inode``h]j)}(hjh]hstruct inode *inode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM%hjubj)}(hhh]h)}(h inode to puth]h inode to put}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM%hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j bmap (C function)c.bmaphNtauh1hhjhhhNhNubj)}(hhh](j)}(h/int bmap (struct inode *inode, sector_t *block)h]j)}(h.int bmap(struct inode *inode, sector_t *block)h](j)}(hinth]hint}(hjGhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjChhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM-ubj2)}(h h]h }(hjVhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjChhhjUhM-ubjC)}(hbmaph]jI)}(hbmaph]hbmap}(hjhhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjdubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjChhhjUhM-ubj=)}(h&(struct inode *inode, sector_t *block)h](jC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jjjsbc.bmapasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj|ubjC)}(hsector_t *blockh](h)}(hhh]jI)}(hsector_th]hsector_t}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.bmapasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hblockh]hblock}(hj2hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj|ubeh}(h]h ]h"]h$]h&]j`jauh1j<hjChhhjUhM-ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj?hhhjUhM-ubah}(h]j:ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjUhM-hj<hhubjw)}(hhh]h)}(hfind a block number in a fileh]hfind a block number in a file}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM-hjYhhubah}(h]h ]h"]h$]h&]uh1jvhj<hhhjUhM-ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjtjjtjjjuh1jhhhjhNhNubj)}(hXj**Parameters** ``struct inode *inode`` inode owning the block number being requested ``sector_t *block`` pointer containing the block to find **Description** Replaces the value in ``*block`` with the block number on the device holding corresponding to the requested block number in the file. That is, asked for block 4 of inode 1 the function will replace the 4 in ``*block``, with disk block relative to the disk start that holds that block of the file. Returns -EINVAL in case of error, 0 otherwise. If mapping falls into a hole, returns 0 and ``*block`` is also set to 0. h](h)}(h**Parameters**h]j)}(hj~h]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj|ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM1hjxubj)}(hhh](j)}(hF``struct inode *inode`` inode owning the block number being requested h](j)}(h``struct inode *inode``h]j)}(hjh]hstruct inode *inode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM.hjubj)}(hhh]h)}(h-inode owning the block number being requestedh]h-inode owning the block number being requested}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM.hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM.hjubj)}(h9``sector_t *block`` pointer containing the block to find h](j)}(h``sector_t *block``h]j)}(hjh]hsector_t *block}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM/hjubj)}(hhh]h)}(h$pointer containing the block to findh]h$pointer containing the block to find}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM/hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM/hjubeh}(h]h ]h"]h$]h&]uh1jhjxubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM1hjxubj)}(hXReplaces the value in ``*block`` with the block number on the device holding corresponding to the requested block number in the file. That is, asked for block 4 of inode 1 the function will replace the 4 in ``*block``, with disk block relative to the disk start that holds that block of the file. Returns -EINVAL in case of error, 0 otherwise. If mapping falls into a hole, returns 0 and ``*block`` is also set to 0.h](h)}(hX(Replaces the value in ``*block`` with the block number on the device holding corresponding to the requested block number in the file. That is, asked for block 4 of inode 1 the function will replace the 4 in ``*block``, with disk block relative to the disk start that holds that block of the file.h](hReplaces the value in }(hj+hhhNhNubj)}(h ``*block``h]h*block}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj+ubh with the block number on the device holding corresponding to the requested block number in the file. That is, asked for block 4 of inode 1 the function will replace the 4 in }(hj+hhhNhNubj)}(h ``*block``h]h*block}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj+ubhO, with disk block relative to the disk start that holds that block of the file.}(hj+hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM0hj'ubh)}(hwReturns -EINVAL in case of error, 0 otherwise. If mapping falls into a hole, returns 0 and ``*block`` is also set to 0.h](h[Returns -EINVAL in case of error, 0 otherwise. If mapping falls into a hole, returns 0 and }(hj^hhhNhNubj)}(h ``*block``h]h*block}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj^ubh is also set to 0.}(hj^hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM6hj'ubeh}(h]h ]h"]h$]h&]uh1jhj]hM0hjxubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j inode_update_time (C function)c.inode_update_timehNtauh1hhjhhhNhNubj)}(hhh](j)}(hYint inode_update_time (struct inode *inode, enum fs_update_time type, unsigned int flags)h]j)}(hXint inode_update_time(struct inode *inode, enum fs_update_time type, unsigned int flags)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMubjC)}(hinode_update_timeh]jI)}(hinode_update_timeh]hinode_update_time}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhMubj=)}(hC(struct inode *inode, enum fs_update_time type, unsigned int flags)h](jC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jjsbc.inode_update_timeasbuh1hhjubj2)}(h h]h }(hj hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hinodeh]hinode}(hj;hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(henum fs_update_time typeh](j )}(hj#h]henum}(hjThhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjPubj2)}(h h]h }(hjahhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjPubh)}(hhh]jI)}(hfs_update_timeh]hfs_update_time}(hjrhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjoubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjtmodnameN classnameNjj )}j ]jc.inode_update_timeasbuh1hhjPubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjPubjI)}(htypeh]htype}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjPubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hunsigned int flagsh](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hflagsh]hflags}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhMubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMhjhhubjw)}(hhh]h)}(h9update either atime or c/mtime and i_version on the inodeh]h9update either atime or c/mtime and i_version on the inode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjj1jj1jjjuh1jhhhjhNhNubj)}(hX**Parameters** ``struct inode *inode`` inode to be updated ``enum fs_update_time type`` timestamp to be updated ``unsigned int flags`` flags for the update **Description** Update either atime or c/mtime and version in a inode if needed for a file access or modification. It is up to the caller to mark the inode dirty appropriately. Returns the positive I_DIRTY_* flags for __mark_inode_dirty() if the inode needs to be marked dirty, 0 if it did not, or a negative errno if an error happened.h](h)}(h**Parameters**h]j)}(hj;h]h Parameters}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj9ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhj5ubj)}(hhh](j)}(h,``struct inode *inode`` inode to be updated h](j)}(h``struct inode *inode``h]j)}(hjZh]hstruct inode *inode}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjXubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjTubj)}(hhh]h)}(hinode to be updatedh]hinode to be updated}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1hhjohMhjpubah}(h]h ]h"]h$]h&]uh1jhjTubeh}(h]h ]h"]h$]h&]uh1jhjohMhjQubj)}(h5``enum fs_update_time type`` timestamp to be updated h](j)}(h``enum fs_update_time type``h]j)}(hjh]henum fs_update_time type}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjubj)}(hhh]h)}(htimestamp to be updatedh]htimestamp to be updated}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjQubj)}(h,``unsigned int flags`` flags for the update h](j)}(h``unsigned int flags``h]j)}(hjh]hunsigned int flags}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjubj)}(hhh]h)}(hflags for the updateh]hflags for the update}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjQubeh}(h]h ]h"]h$]h&]uh1jhj5ubh)}(h**Description**h]j)}(hjh]h Description}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhj5ubh)}(hUpdate either atime or c/mtime and version in a inode if needed for a file access or modification. It is up to the caller to mark the inode dirty appropriately.h]hUpdate either atime or c/mtime and version in a inode if needed for a file access or modification. It is up to the caller to mark the inode dirty appropriately.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhj5ubh)}(hReturns the positive I_DIRTY_* flags for __mark_inode_dirty() if the inode needs to be marked dirty, 0 if it did not, or a negative errno if an error happened.h]hReturns the positive I_DIRTY_* flags for __mark_inode_dirty() if the inode needs to be marked dirty, 0 if it did not, or a negative errno if an error happened.}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhj5ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j  generic_update_time (C function)c.generic_update_timehNtauh1hhjhhhNhNubj)}(hhh](j)}(h[int generic_update_time (struct inode *inode, enum fs_update_time type, unsigned int flags)h]j)}(hZint generic_update_time(struct inode *inode, enum fs_update_time type, unsigned int flags)h](j)}(hinth]hint}(hj[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjWhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMubj2)}(h h]h }(hjjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjWhhhjihMubjC)}(hgeneric_update_timeh]jI)}(hgeneric_update_timeh]hgeneric_update_time}(hj|hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjxubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjWhhhjihMubj=)}(hC(struct inode *inode, enum fs_update_time type, unsigned int flags)h](jC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jj~sbc.generic_update_timeasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(henum fs_update_time typeh](j )}(hj#h]henum}(hj hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hfs_update_timeh]hfs_update_time}(hj(hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj%ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj*modnameN classnameNjj )}j ]jc.generic_update_timeasbuh1hhjubj2)}(h h]h }(hjFhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(htypeh]htype}(hjThhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hunsigned int flagsh](j)}(hunsignedh]hunsigned}(hjmhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjiubj2)}(h h]h }(hj{hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjiubj)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjiubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjiubjI)}(hflagsh]hflags}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjiubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjWhhhjihMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjShhhjihMubah}(h]jNah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjihMhjPhhubjw)}(hhh]h)}(h"update the timestamps on the inodeh]h"update the timestamps on the inode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjhhubah}(h]h ]h"]h$]h&]uh1jvhjPhhhjihMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjhNhNubj)}(h**Parameters** ``struct inode *inode`` inode to be updated ``enum fs_update_time type`` timestamp to be updated ``unsigned int flags`` flags for the update **Description** Returns a negative error value on error, else 0.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjubj)}(hhh](j)}(h,``struct inode *inode`` inode to be updated h](j)}(h``struct inode *inode``h]j)}(hjh]hstruct inode *inode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhj ubj)}(hhh]h)}(hinode to be updatedh]hinode to be updated}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj%hMhj&ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj%hMhjubj)}(h5``enum fs_update_time type`` timestamp to be updated h](j)}(h``enum fs_update_time type``h]j)}(hjIh]henum fs_update_time type}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjGubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjCubj)}(hhh]h)}(htimestamp to be updatedh]htimestamp to be updated}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj^hMhj_ubah}(h]h ]h"]h$]h&]uh1jhjCubeh}(h]h ]h"]h$]h&]uh1jhj^hMhjubj)}(h,``unsigned int flags`` flags for the update h](j)}(h``unsigned int flags``h]j)}(hjh]hunsigned int flags}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhj|ubj)}(hhh]h)}(hflags for the updateh]hflags for the update}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhj|ubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjubh)}(h0Returns a negative error value on error, else 0.h]h0Returns a negative error value on error, else 0.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j file_remove_privs (C function)c.file_remove_privshNtauh1hhjhhhNhNubj)}(hhh](j)}(h)int file_remove_privs (struct file *file)h]j)}(h(int file_remove_privs(struct file *file)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMi ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMi ubjC)}(hfile_remove_privsh]jI)}(hfile_remove_privsh]hfile_remove_privs}(hj#hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhMi ubj=)}(h(struct file *file)h]jC)}(hstruct file *fileh](j )}(hjh]hstruct}(hj?hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj;ubj2)}(h h]h }(hjLhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj;ubh)}(hhh]jI)}(hfileh]hfile}(hj]hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjZubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj_modnameN classnameNjj )}j ]j)}jj%sbc.file_remove_privsasbuh1hhj;ubj2)}(h h]h }(hj}hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj;ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;ubjI)}(hfileh]hfile}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj;ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj7ubah}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhMi ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhMi ubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMi hjhhubjw)}(hhh]h)}(h3remove special file privileges (suid, capabilities)h]h3remove special file privileges (suid, capabilities)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMi hjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhMi ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjhNhNubj)}(h**Parameters** ``struct file *file`` file to remove privileges from **Description** When file is modified by a write or truncation ensure that special file privileges are removed. **Return** 0 on success, negative errno on failure.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMm hjubj)}(hhh]j)}(h5``struct file *file`` file to remove privileges from h](j)}(h``struct file *file``h]j)}(hjh]hstruct file *file}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMj hjubj)}(hhh]h)}(hfile to remove privileges fromh]hfile to remove privileges from}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMj hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMj hjubah}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hj>h]h Description}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj<ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMl hjubh)}(h_When file is modified by a write or truncation ensure that special file privileges are removed.h]h_When file is modified by a write or truncation ensure that special file privileges are removed.}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMk hjubh)}(h **Return**h]j)}(hjeh]hReturn}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1jhjcubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMn hjubh)}(h(0 on success, negative errno on failure.h]h(0 on success, negative errno on failure.}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMo hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j current_time (C function)c.current_timehNtauh1hhjhhhNhNubj)}(hhh](j)}(h4struct timespec64 current_time (struct inode *inode)h]j)}(h3struct timespec64 current_time(struct inode *inode)h](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMx ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMx ubh)}(hhh]jI)}(h timespec64h]h timespec64}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}j current_timesbc.current_timeasbuh1hhjhhhjhMx ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMx ubjC)}(h current_timeh]jI)}(hjh]h current_time}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhMx ubj=)}(h(struct inode *inode)h]jC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hj$hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hinodeh]hinode}(hj5hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj2ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj7modnameN classnameNjj )}j ]jc.current_timeasbuh1hhjubj2)}(h h]h }(hjShhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hinodeh]hinode}(hjnhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubah}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhMx ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhMx ubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMx hjhhubjw)}(hhh]h)}(h&Return FS time (possibly fine-grained)h]h&Return FS time (possibly fine-grained)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMx hjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhMx ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjhNhNubj)}(hX**Parameters** ``struct inode *inode`` inode. **Description** Return the current time truncated to the time granularity supported by the fs, as suitable for a ctime/mtime change. If the ctime is flagged as having been QUERIED, get a fine-grained timestamp, but don't update the floor. For a multigrain inode, this is effectively an estimate of the timestamp that a file would receive. An actual update must go through inode_set_ctime_current().h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM| hjubj)}(hhh]j)}(h``struct inode *inode`` inode. h](j)}(h``struct inode *inode``h]j)}(hjh]hstruct inode *inode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMy hjubj)}(hhh]h)}(hinode.h]hinode.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMy hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMy hjubah}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM{ hjubh)}(hReturn the current time truncated to the time granularity supported by the fs, as suitable for a ctime/mtime change. If the ctime is flagged as having been QUERIED, get a fine-grained timestamp, but don't update the floor.h]hReturn the current time truncated to the time granularity supported by the fs, as suitable for a ctime/mtime change. If the ctime is flagged as having been QUERIED, get a fine-grained timestamp, but don’t update the floor.}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMz hjubh)}(hFor a multigrain inode, this is effectively an estimate of the timestamp that a file would receive. An actual update must go through inode_set_ctime_current().h]hFor a multigrain inode, this is effectively an estimate of the timestamp that a file would receive. An actual update must go through inode_set_ctime_current().}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j file_update_time (C function)c.file_update_timehNtauh1hhjhhhNhNubj)}(hhh](j)}(h(int file_update_time (struct file *file)h]j)}(h'int file_update_time(struct file *file)h](j)}(hinth]hint}(hjhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjdhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM ubj2)}(h h]h }(hjwhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjdhhhjvhM ubjC)}(hfile_update_timeh]jI)}(hfile_update_timeh]hfile_update_time}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjdhhhjvhM ubj=)}(h(struct file *file)h]jC)}(hstruct file *fileh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hfileh]hfile}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jjsbc.file_update_timeasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hfileh]hfile}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubah}(h]h ]h"]h$]h&]j`jauh1j<hjdhhhjvhM ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj`hhhjvhM ubah}(h]j[ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjvhM hj]hhubjw)}(hhh]h)}(hupdate mtime and ctime timeh]hupdate mtime and ctime time}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hj%hhubah}(h]h ]h"]h$]h&]uh1jvhj]hhhjvhM ubeh}(h]h ](jfunctioneh"]h$]h&]jjjj@jj@jjjuh1jhhhjhNhNubj)}(hXD**Parameters** ``struct file *file`` file accessed **Description** Update the mtime and ctime members of an inode and mark the inode for writeback. Note that this function is meant exclusively for usage in the file write path of filesystems, and filesystems may choose to explicitly ignore updates via this function with the _NOCMTIME inode flag, e.g. for network filesystem where these imestamps are handled by the server. This can return an error for file systems who need to allocate space in order to update an inode. **Return** 0 on success, negative errno on failure.h](h)}(h**Parameters**h]j)}(hjJh]h Parameters}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjHubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjDubj)}(hhh]j)}(h$``struct file *file`` file accessed h](j)}(h``struct file *file``h]j)}(hjih]hstruct file *file}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjgubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjcubj)}(hhh]h)}(h file accessedh]h file accessed}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj~hM hjubah}(h]h ]h"]h$]h&]uh1jhjcubeh}(h]h ]h"]h$]h&]uh1jhj~hM hj`ubah}(h]h ]h"]h$]h&]uh1jhjDubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjDubh)}(hXUpdate the mtime and ctime members of an inode and mark the inode for writeback. Note that this function is meant exclusively for usage in the file write path of filesystems, and filesystems may choose to explicitly ignore updates via this function with the _NOCMTIME inode flag, e.g. for network filesystem where these imestamps are handled by the server. This can return an error for file systems who need to allocate space in order to update an inode.h]hXUpdate the mtime and ctime members of an inode and mark the inode for writeback. Note that this function is meant exclusively for usage in the file write path of filesystems, and filesystems may choose to explicitly ignore updates via this function with the _NOCMTIME inode flag, e.g. for network filesystem where these imestamps are handled by the server. This can return an error for file systems who need to allocate space in order to update an inode.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjDubh)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjDubh)}(h(0 on success, negative errno on failure.h]h(0 on success, negative errno on failure.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjDubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j file_modified (C function)c.file_modifiedhNtauh1hhjhhhNhNubj)}(hhh](j)}(h%int file_modified (struct file *file)h]j)}(h$int file_modified(struct file *file)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj hhhjhM ubjC)}(h file_modifiedh]jI)}(h file_modifiedh]h file_modified}(hj1hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj-ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj hhhjhM ubj=)}(h(struct file *file)h]jC)}(hstruct file *fileh](j )}(hjh]hstruct}(hjMhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjIubj2)}(h h]h }(hjZhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjIubh)}(hhh]jI)}(hfileh]hfile}(hjkhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjhubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmmodnameN classnameNjj )}j ]j)}jj3sbc.file_modifiedasbuh1hhjIubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjIubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIubjI)}(hfileh]hfile}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjIubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjEubah}(h]h ]h"]h$]h&]j`jauh1j<hj hhhjhM ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhM ubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhM hjhhubjw)}(hhh]h)}(h1handle mandated vfs changes when modifying a fileh]h1handle mandated vfs changes when modifying a file}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhM ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjhNhNubj)}(hX'**Parameters** ``struct file *file`` file that was modified **Description** When file has been modified ensure that special file privileges are removed and time settings are updated. **Context** Caller must hold the file's inode lock. **Return** 0 on success, negative errno on failure.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjubj)}(hhh]j)}(h-``struct file *file`` file that was modified h](j)}(h``struct file *file``h]j)}(hjh]hstruct file *file}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hj ubj)}(hhh]h)}(hfile that was modifiedh]hfile that was modified}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj&hM hj'ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj&hM hjubah}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjLh]h Description}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjJubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjubh)}(hjWhen file has been modified ensure that special file privileges are removed and time settings are updated.h]hjWhen file has been modified ensure that special file privileges are removed and time settings are updated.}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjubh)}(h **Context**h]j)}(hjsh]hContext}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjqubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjubh)}(h'Caller must hold the file's inode lock.h]h)Caller must hold the file’s inode lock.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjubh)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjubh)}(h(0 on success, negative errno on failure.h]h(0 on success, negative errno on failure.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j kiocb_modified (C function)c.kiocb_modifiedhNtauh1hhjhhhNhNubj)}(hhh](j)}(h'int kiocb_modified (struct kiocb *iocb)h]j)}(h&int kiocb_modified(struct kiocb *iocb)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhM ubjC)}(hkiocb_modifiedh]jI)}(hkiocb_modifiedh]hkiocb_modified}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhM ubj=)}(h(struct kiocb *iocb)h]jC)}(hstruct kiocb *iocbh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hj)hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hkiocbh]hkiocb}(hj:hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj7ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj<modnameN classnameNjj )}j ]j)}jjsbc.kiocb_modifiedasbuh1hhjubj2)}(h h]h }(hjZhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hiocbh]hiocb}(hjuhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubah}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhM ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhM ubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhM hjhhubjw)}(hhh]h)}(h1handle mandated vfs changes when modifying a fileh]h1handle mandated vfs changes when modifying a file}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhM ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjhNhNubj)}(hX(**Parameters** ``struct kiocb *iocb`` iocb that was modified **Description** When file has been modified ensure that special file privileges are removed and time settings are updated. **Context** Caller must hold the file's inode lock. **Return** 0 on success, negative errno on failure.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjubj)}(hhh]j)}(h.``struct kiocb *iocb`` iocb that was modified h](j)}(h``struct kiocb *iocb``h]j)}(hjh]hstruct kiocb *iocb}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjubj)}(hhh]h)}(hiocb that was modifiedh]hiocb that was modified}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjubh)}(hjWhen file has been modified ensure that special file privileges are removed and time settings are updated.h]hjWhen file has been modified ensure that special file privileges are removed and time settings are updated.}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjubh)}(h **Context**h]j)}(hjBh]hContext}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj@ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjubh)}(h'Caller must hold the file's inode lock.h]h)Caller must hold the file’s inode lock.}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjubh)}(h **Return**h]j)}(hjih]hReturn}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjgubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjubh)}(h(0 on success, negative errno on failure.h]h(0 on success, negative errno on failure.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j inode_init_owner (C function)c.inode_init_ownerhNtauh1hhjhhhNhNubj)}(hhh](j)}(hqvoid inode_init_owner (const struct mnt_idmap *idmap, struct inode *inode, const struct inode *dir, umode_t mode)h]j)}(hpvoid inode_init_owner(const struct mnt_idmap *idmap, struct inode *inode, const struct inode *dir, umode_t mode)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhM ubjC)}(hinode_init_ownerh]jI)}(hinode_init_ownerh]hinode_init_owner}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhM ubj=)}(h[(const struct mnt_idmap *idmap, struct inode *inode, const struct inode *dir, umode_t mode)h](jC)}(hconst struct mnt_idmap *idmaph](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(h mnt_idmaph]h mnt_idmap}(hj$hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj!ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj&modnameN classnameNjj )}j ]j)}jjsbc.inode_init_ownerasbuh1hhjubj2)}(h h]h }(hjDhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hidmaph]hidmap}(hj_hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hjxhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjtubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjtubh)}(hhh]jI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j@c.inode_init_ownerasbuh1hhjtubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjtubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjtubjI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjtubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hconst struct inode *dirh](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hinodeh]hinode}(hj!hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj#modnameN classnameNjj )}j ]j@c.inode_init_ownerasbuh1hhjubj2)}(h h]h }(hj?hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjMhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hdirh]hdir}(hjZhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h umode_t modeh](h)}(hhh]jI)}(humode_th]humode_t}(hjvhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjsubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjxmodnameN classnameNjj )}j ]j@c.inode_init_ownerasbuh1hhjoubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjoubjI)}(hmodeh]hmode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjoubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhM ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhM ubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhM hjhhubjw)}(hhh]h)}(hah"]h$]h&]uh1j1hjjhhhj{hM ubjC)}(hinode_owner_or_capableh]jI)}(hinode_owner_or_capableh]hinode_owner_or_capable}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjjhhhj{hM ubj=)}(h:(const struct mnt_idmap *idmap, const struct inode *inode)h](jC)}(hconst struct mnt_idmap *idmaph](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(h mnt_idmaph]h mnt_idmap}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jjsbc.inode_owner_or_capableasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hidmaph]hidmap}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hconst struct inode *inodeh](j )}(hjJh]hconst}(hj7hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj3ubj2)}(h h]h }(hjDhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj3ubj )}(hjh]hstruct}(hjRhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj3ubj2)}(h h]h }(hj_hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj3ubh)}(hhh]jI)}(hinodeh]hinode}(hjphhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjmubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjrmodnameN classnameNjj )}j ]jc.inode_owner_or_capableasbuh1hhj3ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj3ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3ubjI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj3ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjjhhhj{hM ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjfhhhj{hM ubah}(h]jaah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj{hM hjchhubjw)}(hhh]h)}(h'check current task permissions to inodeh]h'check current task permissions to inode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjhhubah}(h]h ]h"]h$]h&]uh1jvhjchhhj{hM ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjhNhNubj)}(hXc**Parameters** ``const struct mnt_idmap *idmap`` idmap of the mount the inode was found from ``const struct inode *inode`` inode being checked **Description** Return true if current either has CAP_FOWNER in a namespace with the inode owner uid mapped, or owns the file. If the inode has been found through an idmapped mount the idmap of the vfsmount must be passed through **idmap**. This function will then take care to map the inode according to **idmap** before checking permissions. On non-idmapped mounts or if permission checking is to be performed on the raw inode simply pass **nop_mnt_idmap**.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjubj)}(hhh](j)}(hN``const struct mnt_idmap *idmap`` idmap of the mount the inode was found from h](j)}(h!``const struct mnt_idmap *idmap``h]j)}(hjh]hconst struct mnt_idmap *idmap}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjubj)}(hhh]h)}(h+idmap of the mount the inode was found fromh]h+idmap of the mount the inode was found from}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj)hM hj*ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj)hM hj ubj)}(h2``const struct inode *inode`` inode being checked h](j)}(h``const struct inode *inode``h]j)}(hjMh]hconst struct inode *inode}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjKubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjGubj)}(hhh]h)}(hinode being checkedh]hinode being checked}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjbhM hjcubah}(h]h ]h"]h$]h&]uh1jhjGubeh}(h]h ]h"]h$]h&]uh1jhjbhM hj ubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjubh)}(hnReturn true if current either has CAP_FOWNER in a namespace with the inode owner uid mapped, or owns the file.h]hnReturn true if current either has CAP_FOWNER in a namespace with the inode owner uid mapped, or owns the file.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjubh)}(hXLIf the inode has been found through an idmapped mount the idmap of the vfsmount must be passed through **idmap**. This function will then take care to map the inode according to **idmap** before checking permissions. On non-idmapped mounts or if permission checking is to be performed on the raw inode simply pass **nop_mnt_idmap**.h](hgIf the inode has been found through an idmapped mount the idmap of the vfsmount must be passed through }(hjhhhNhNubj)}(h **idmap**h]hidmap}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhB. This function will then take care to map the inode according to }(hjhhhNhNubj)}(h **idmap**h]hidmap}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh before checking permissions. On non-idmapped mounts or if permission checking is to be performed on the raw inode simply pass }(hjhhhNhNubj)}(h**nop_mnt_idmap**h]h nop_mnt_idmap}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j inode_dio_wait (C function)c.inode_dio_waithNtauh1hhjhhhNhNubj)}(hhh](j)}(h)void inode_dio_wait (struct inode *inode)h]j)}(h(void inode_dio_wait(struct inode *inode)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM ubj2)}(h h]h }(hj!hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhj hM ubjC)}(hinode_dio_waith]jI)}(hinode_dio_waith]hinode_dio_wait}(hj3hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj/ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhj hM ubj=)}(h(struct inode *inode)h]jC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hjOhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjKubj2)}(h h]h }(hj\hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjKubh)}(hhh]jI)}(hinodeh]hinode}(hjmhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjomodnameN classnameNjj )}j ]j)}jj5sbc.inode_dio_waitasbuh1hhjKubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjKubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjKubjI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjKubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjGubah}(h]h ]h"]h$]h&]j`jauh1j<hjhhhj hM ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj hhhj hM ubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj hM hjhhubjw)}(hhh]h)}(h+wait for outstanding DIO requests to finishh]h+wait for outstanding DIO requests to finish}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhj hM ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjhNhNubj)}(hX/**Parameters** ``struct inode *inode`` inode to wait for **Description** Waits for all pending direct I/O requests to finish so that we can proceed with a truncate or equivalent operation. Must be called under a lock that serializes taking new references to i_dio_count, usually by inode->i_rwsem.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjubj)}(hhh]j)}(h*``struct inode *inode`` inode to wait for h](j)}(h``struct inode *inode``h]j)}(hjh]hstruct inode *inode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hj ubj)}(hhh]h)}(hinode to wait forh]hinode to wait for}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj(hM hj)ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj(hM hj ubah}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjNh]h Description}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjLubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjubh)}(hsWaits for all pending direct I/O requests to finish so that we can proceed with a truncate or equivalent operation.h]hsWaits for all pending direct I/O requests to finish so that we can proceed with a truncate or equivalent operation.}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjubh)}(hlMust be called under a lock that serializes taking new references to i_dio_count, usually by inode->i_rwsem.h]hlMust be called under a lock that serializes taking new references to i_dio_count, usually by inode->i_rwsem.}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j timestamp_truncate (C function)c.timestamp_truncatehNtauh1hhjhhhNhNubj)}(hhh](j)}(hOstruct timespec64 timestamp_truncate (struct timespec64 t, struct inode *inode)h]j)}(hNstruct timespec64 timestamp_truncate(struct timespec64 t, struct inode *inode)h](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM! ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhM! ubh)}(hhh]jI)}(h timespec64h]h timespec64}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jtimestamp_truncatesbc.timestamp_truncateasbuh1hhjhhhjhM! ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhM! ubjC)}(htimestamp_truncateh]jI)}(hjh]htimestamp_truncate}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhM! ubj=)}(h*(struct timespec64 t, struct inode *inode)h](jC)}(hstruct timespec64 th](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj ubh)}(hhh]jI)}(h timespec64h]h timespec64}(hj-hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj*ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj/modnameN classnameNjj )}j ]jc.timestamp_truncateasbuh1hhj ubj2)}(h h]h }(hjKhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj ubjI)}(hth]ht}(hjYhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hjrhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjnubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjnubh)}(hhh]jI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.timestamp_truncateasbuh1hhjnubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjnubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnubjI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjnubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhM! ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhM! ubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhM! hjhhubjw)}(hhh]h)}(h"Truncate timespec to a granularityh]h"Truncate timespec to a granularity}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM! hjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhM! ubeh}(h]h ](jfunctioneh"]h$]h&]jjjj jj jjjuh1jhhhjhNhNubj)}(hX!**Parameters** ``struct timespec64 t`` Timespec ``struct inode *inode`` inode being updated **Description** Truncate a timespec to the granularity supported by the fs containing the inode. Always rounds down. gran must not be 0 nor greater than a second (NSEC_PER_SEC, or 10^9 ns).h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM% hjubj)}(hhh](j)}(h!``struct timespec64 t`` Timespec h](j)}(h``struct timespec64 t``h]j)}(hj4h]hstruct timespec64 t}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj2ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM" hj.ubj)}(hhh]h)}(hTimespech]hTimespec}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjIhM" hjJubah}(h]h ]h"]h$]h&]uh1jhj.ubeh}(h]h ]h"]h$]h&]uh1jhjIhM" hj+ubj)}(h,``struct inode *inode`` inode being updated h](j)}(h``struct inode *inode``h]j)}(hjmh]hstruct inode *inode}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1jhjkubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM# hjgubj)}(hhh]h)}(hinode being updatedh]hinode being updated}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM# hjubah}(h]h ]h"]h$]h&]uh1jhjgubeh}(h]h ]h"]h$]h&]uh1jhjhM# hj+ubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM% hjubh)}(hTruncate a timespec to the granularity supported by the fs containing the inode. Always rounds down. gran must not be 0 nor greater than a second (NSEC_PER_SEC, or 10^9 ns).h]hTruncate a timespec to the granularity supported by the fs containing the inode. Always rounds down. gran must not be 0 nor greater than a second (NSEC_PER_SEC, or 10^9 ns).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM$ hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j $inode_set_ctime_current (C function)c.inode_set_ctime_currenthNtauh1hhjhhhNhNubj)}(hhh](j)}(h?struct timespec64 inode_set_ctime_current (struct inode *inode)h]j)}(h>struct timespec64 inode_set_ctime_current(struct inode *inode)h](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM@ ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhM@ ubh)}(hhh]jI)}(h timespec64h]h timespec64}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jinode_set_ctime_currentsbc.inode_set_ctime_currentasbuh1hhjhhhjhM@ ubj2)}(h h]h }(hj-hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhM@ ubjC)}(hinode_set_ctime_currenth]jI)}(hj*h]hinode_set_ctime_current}(hj?hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj;ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhM@ ubj=)}(h(struct inode *inode)h]jC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hjZhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjVubj2)}(h h]h }(hjghhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjVubh)}(hhh]jI)}(hinodeh]hinode}(hjxhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjuubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjzmodnameN classnameNjj )}j ]j(c.inode_set_ctime_currentasbuh1hhjVubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjVubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVubjI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjVubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjRubah}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhM@ ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhM@ ubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhM@ hjhhubjw)}(hhh]h)}(hset the ctime to current_timeh]hset the ctime to current_time}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM@ hjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhM@ ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjhNhNubj)}(hX**Parameters** ``struct inode *inode`` inode **Description** Set the inode's ctime to the current value for the inode. Returns the current value that was assigned. If this is not a multigrain inode, then we set it to the later of the coarse time and floor value. If it is multigrain, then we first see if the coarse-grained timestamp is distinct from what is already there. If so, then use that. Otherwise, get a fine-grained timestamp. After that, try to swap the new value into i_ctime_nsec. Accept the resulting ctime, regardless of the outcome of the swap. If it has already been replaced, then that timestamp is later than the earlier unacceptable one, and is thus acceptable.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMD hjubj)}(hhh]j)}(h``struct inode *inode`` inode h](j)}(h``struct inode *inode``h]j)}(hjh]hstruct inode *inode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMA hjubj)}(hhh]h)}(hinodeh]hinode}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj1hMA hj2ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj1hMA hjubah}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjWh]h Description}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjUubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMC hjubh)}(hSet the inode's ctime to the current value for the inode. Returns the current value that was assigned. If this is not a multigrain inode, then we set it to the later of the coarse time and floor value.h]hSet the inode’s ctime to the current value for the inode. Returns the current value that was assigned. If this is not a multigrain inode, then we set it to the later of the coarse time and floor value.}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMB hjubh)}(hIf it is multigrain, then we first see if the coarse-grained timestamp is distinct from what is already there. If so, then use that. Otherwise, get a fine-grained timestamp.h]hIf it is multigrain, then we first see if the coarse-grained timestamp is distinct from what is already there. If so, then use that. Otherwise, get a fine-grained timestamp.}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMF hjubh)}(hAfter that, try to swap the new value into i_ctime_nsec. Accept the resulting ctime, regardless of the outcome of the swap. If it has already been replaced, then that timestamp is later than the earlier unacceptable one, and is thus acceptable.h]hAfter that, try to swap the new value into i_ctime_nsec. Accept the resulting ctime, regardless of the outcome of the swap. If it has already been replaced, then that timestamp is later than the earlier unacceptable one, and is thus acceptable.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chMJ hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j "inode_set_ctime_deleg (C function)c.inode_set_ctime_deleghNtauh1hhjhhhNhNubj)}(hhh](j)}(hWstruct timespec64 inode_set_ctime_deleg (struct inode *inode, struct timespec64 update)h]j)}(hVstruct timespec64 inode_set_ctime_deleg(struct inode *inode, struct timespec64 update)h](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhM ubh)}(hhh]jI)}(h timespec64h]h timespec64}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jinode_set_ctime_delegsbc.inode_set_ctime_delegasbuh1hhjhhhjhM ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhM ubjC)}(hinode_set_ctime_delegh]jI)}(hjh]hinode_set_ctime_deleg}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhM ubj=)}(h/(struct inode *inode, struct timespec64 update)h](jC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hj'hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj#ubj2)}(h h]h }(hj4hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj#ubh)}(hhh]jI)}(hinodeh]hinode}(hjEhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjBubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjGmodnameN classnameNjj )}j ]jc.inode_set_ctime_delegasbuh1hhj#ubj2)}(h h]h }(hjchhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj#ubj)}(hjh]h*}(hjqhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#ubjI)}(hinodeh]hinode}(hj~hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj#ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct timespec64 updateh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(h timespec64h]h timespec64}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.inode_set_ctime_delegasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hupdateh]hupdate}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhM ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhM ubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhM hjhhubjw)}(hhh]h)}(h,try to update the ctime on a delegated inodeh]h,try to update the ctime on a delegated inode}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhM ubeh}(h]h ](jfunctioneh"]h$]h&]jjjj#jj#jjjuh1jhhhjhNhNubj)}(hXK**Parameters** ``struct inode *inode`` inode to update ``struct timespec64 update`` timespec64 to set the ctime **Description** Attempt to atomically update the ctime on behalf of a delegation holder. The nfs server can call back the holder of a delegation to get updated inode attributes, including the mtime. When updating the mtime, update the ctime to a value at least equal to that. This can race with concurrent updates to the inode, in which case the update is skipped. Note that this works even when multigrain timestamps are not enabled, so it is used in either case.h](h)}(h**Parameters**h]j)}(hj-h]h Parameters}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj+ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hj'ubj)}(hhh](j)}(h(``struct inode *inode`` inode to update h](j)}(h``struct inode *inode``h]j)}(hjLh]hstruct inode *inode}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjJubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjFubj)}(hhh]h)}(hinode to updateh]hinode to update}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1hhjahM hjbubah}(h]h ]h"]h$]h&]uh1jhjFubeh}(h]h ]h"]h$]h&]uh1jhjahM hjCubj)}(h9``struct timespec64 update`` timespec64 to set the ctime h](j)}(h``struct timespec64 update``h]j)}(hjh]hstruct timespec64 update}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjubj)}(hhh]h)}(htimespec64 to set the ctimeh]htimespec64 to set the ctime}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hjCubeh}(h]h ]h"]h$]h&]uh1jhj'ubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hj'ubh)}(hHAttempt to atomically update the ctime on behalf of a delegation holder.h]hHAttempt to atomically update the ctime on behalf of a delegation holder.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hj'ubh)}(hThe nfs server can call back the holder of a delegation to get updated inode attributes, including the mtime. When updating the mtime, update the ctime to a value at least equal to that.h]hThe nfs server can call back the holder of a delegation to get updated inode attributes, including the mtime. When updating the mtime, update the ctime to a value at least equal to that.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hj'ubh)}(hXThis can race with concurrent updates to the inode, in which case the update is skipped.h]hXThis can race with concurrent updates to the inode, in which case the update is skipped.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hj'ubh)}(hcNote that this works even when multigrain timestamps are not enabled, so it is used in either case.h]hcNote that this works even when multigrain timestamps are not enabled, so it is used in either case.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hj'ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j  in_group_or_capable (C function)c.in_group_or_capablehNtauh1hhjhhhNhNubj)}(hhh](j)}(hdbool in_group_or_capable (const struct mnt_idmap *idmap, const struct inode *inode, vfsgid_t vfsgid)h]j)}(hcbool in_group_or_capable(const struct mnt_idmap *idmap, const struct inode *inode, vfsgid_t vfsgid)h](j)}(hjh]hbool}(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj.hhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM ubj2)}(h h]h }(hj@hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj.hhhj?hM ubjC)}(hin_group_or_capableh]jI)}(hin_group_or_capableh]hin_group_or_capable}(hjRhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjNubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj.hhhj?hM ubj=)}(hK(const struct mnt_idmap *idmap, const struct inode *inode, vfsgid_t vfsgid)h](jC)}(hconst struct mnt_idmap *idmaph](j )}(hjJh]hconst}(hjnhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjjubj2)}(h h]h }(hj{hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjjubj )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjjubh)}(hhh]jI)}(h mnt_idmaph]h mnt_idmap}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jjTsbc.in_group_or_capableasbuh1hhjjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjjubjI)}(hidmaph]hidmap}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjfubjC)}(hconst struct inode *inodeh](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hj#hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hinodeh]hinode}(hj4hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj1ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj6modnameN classnameNjj )}j ]jc.in_group_or_capableasbuh1hhjubj2)}(h h]h }(hjRhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj`hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hinodeh]hinode}(hjmhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjfubjC)}(hvfsgid_t vfsgidh](h)}(hhh]jI)}(hvfsgid_th]hvfsgid_t}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.in_group_or_capableasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hvfsgidh]hvfsgid}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjfubeh}(h]h ]h"]h$]h&]j`jauh1j<hj.hhhj?hM ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj*hhhj?hM ubah}(h]j%ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj?hM hj'hhubjw)}(hhh]h)}(h-check whether caller is CAP_FSETID privilegedh]h-check whether caller is CAP_FSETID privileged}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjhhubah}(h]h ]h"]h$]h&]uh1jvhj'hhhj?hM ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjhNhNubj)}(hX**Parameters** ``const struct mnt_idmap *idmap`` idmap of the mount **inode** was found from ``const struct inode *inode`` inode to check ``vfsgid_t vfsgid`` the new/current vfsgid of **inode** **Description** Check whether **vfsgid** is in the caller's group list or if the caller is privileged with CAP_FSETID over **inode**. This can be used to determine whether the setgid bit can be kept or must be dropped. **Return** true if the caller is sufficiently privileged, false if not.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjubj)}(hhh](j)}(hN``const struct mnt_idmap *idmap`` idmap of the mount **inode** was found from h](j)}(h!``const struct mnt_idmap *idmap``h]j)}(hj h]hconst struct mnt_idmap *idmap}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjubj)}(hhh]h)}(h+idmap of the mount **inode** was found fromh](hidmap of the mount }(hj9hhhNhNubj)}(h **inode**h]hinode}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj9ubh was found from}(hj9hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj5hM hj6ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj5hM hjubj)}(h-``const struct inode *inode`` inode to check h](j)}(h``const struct inode *inode``h]j)}(hjkh]hconst struct inode *inode}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjiubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjeubj)}(hhh]h)}(hinode to checkh]hinode to check}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjeubeh}(h]h ]h"]h$]h&]uh1jhjhM hjubj)}(h8``vfsgid_t vfsgid`` the new/current vfsgid of **inode** h](j)}(h``vfsgid_t vfsgid``h]j)}(hjh]hvfsgid_t vfsgid}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjubj)}(hhh]h)}(h#the new/current vfsgid of **inode**h](hthe new/current vfsgid of }(hjhhhNhNubj)}(h **inode**h]hinode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1hhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjubh)}(hCheck whether **vfsgid** is in the caller's group list or if the caller is privileged with CAP_FSETID over **inode**. This can be used to determine whether the setgid bit can be kept or must be dropped.h](hCheck whether }(hjhhhNhNubj)}(h **vfsgid**h]hvfsgid}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhU is in the caller’s group list or if the caller is privileged with CAP_FSETID over }(hjhhhNhNubj)}(h **inode**h]hinode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhV. This can be used to determine whether the setgid bit can be kept or must be dropped.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjubh)}(h **Return**h]j)}(hj8h]hReturn}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj6ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjubh)}(hah"]h$]h&]uh1j1hjyhhhjhM ubjC)}(hmode_strip_sgidh]jI)}(hjh]hmode_strip_sgid}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjyhhhjhM ubj=)}(hF(const struct mnt_idmap *idmap, const struct inode *dir, umode_t mode)h](jC)}(hconst struct mnt_idmap *idmaph](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(h mnt_idmaph]h mnt_idmap}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj modnameN classnameNjj )}j ]jc.mode_strip_sgidasbuh1hhjubj2)}(h h]h }(hj&hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj4hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hidmaph]hidmap}(hjAhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hconst struct inode *dirh](j )}(hjJh]hconst}(hjZhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjVubj2)}(h h]h }(hjghhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjVubj )}(hjh]hstruct}(hjuhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjVubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjVubh)}(hhh]jI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.mode_strip_sgidasbuh1hhjVubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjVubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVubjI)}(hdirh]hdir}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjVubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h umode_t modeh](h)}(hhh]jI)}(humode_th]humode_t}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.mode_strip_sgidasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hmodeh]hmode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjyhhhjhM ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjuhhhjhM ubah}(h]jpah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhM hjrhhubjw)}(hhh]h)}(h'handle the sgid bit for non-directoriesh]h'handle the sgid bit for non-directories}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hj;hhubah}(h]h ]h"]h$]h&]uh1jvhjrhhhjhM ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjVjjVjjjuh1jhhhjhNhNubj)}(hXe**Parameters** ``const struct mnt_idmap *idmap`` idmap of the mount the inode was created from ``const struct inode *dir`` parent directory inode ``umode_t mode`` mode of the file to be created in **dir** **Description** If the **mode** of the new file has both the S_ISGID and S_IXGRP bit raised and **dir** has the S_ISGID bit raised ensure that the caller is either in the group of the parent directory or they have CAP_FSETID in their user namespace and are privileged over the parent directory. In all other cases, strip the S_ISGID bit from **mode**. **Return** the new mode to use for the fileh](h)}(h**Parameters**h]j)}(hj`h]h Parameters}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj^ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjZubj)}(hhh](j)}(hP``const struct mnt_idmap *idmap`` idmap of the mount the inode was created from h](j)}(h!``const struct mnt_idmap *idmap``h]j)}(hjh]hconst struct mnt_idmap *idmap}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj}ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjyubj)}(hhh]h)}(h-idmap of the mount the inode was created fromh]h-idmap of the mount the inode was created from}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjyubeh}(h]h ]h"]h$]h&]uh1jhjhM hjvubj)}(h3``const struct inode *dir`` parent directory inode h](j)}(h``const struct inode *dir``h]j)}(hjh]hconst struct inode *dir}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjubj)}(hhh]h)}(hparent directory inodeh]hparent directory inode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hjvubj)}(h;``umode_t mode`` mode of the file to be created in **dir** h](j)}(h``umode_t mode``h]j)}(hjh]h umode_t mode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjubj)}(hhh]h)}(h)mode of the file to be created in **dir**h](h"mode of the file to be created in }(hj hhhNhNubj)}(h**dir**h]hdir}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1hhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hjvubeh}(h]h ]h"]h$]h&]uh1jhjZubh)}(h**Description**h]j)}(hj:h]h Description}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj8ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjZubh)}(hXOIf the **mode** of the new file has both the S_ISGID and S_IXGRP bit raised and **dir** has the S_ISGID bit raised ensure that the caller is either in the group of the parent directory or they have CAP_FSETID in their user namespace and are privileged over the parent directory. In all other cases, strip the S_ISGID bit from **mode**.h](hIf the }(hjPhhhNhNubj)}(h**mode**h]hmode}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjPubhA of the new file has both the S_ISGID and S_IXGRP bit raised and }(hjPhhhNhNubj)}(h**dir**h]hdir}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjPubh has the S_ISGID bit raised ensure that the caller is either in the group of the parent directory or they have CAP_FSETID in their user namespace and are privileged over the parent directory. In all other cases, strip the S_ISGID bit from }(hjPhhhNhNubj)}(h**mode**h]hmode}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjPubh.}(hjPhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjZubh)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjZubh)}(h the new mode to use for the fileh]h the new mode to use for the file}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjZubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j dump_inode (C function) c.dump_inodehNtauh1hhjhhhNhNubj)}(hhh](j)}(h9void dump_inode (struct inode *inode, const char *reason)h]j)}(h8void dump_inode(struct inode *inode, const char *reason)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhM ubjC)}(h dump_inodeh]jI)}(h dump_inodeh]h dump_inode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhM ubj=)}(h)(struct inode *inode, const char *reason)h](jC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hj&hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hinodeh]hinode}(hj7hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj4ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj9modnameN classnameNjj )}j ]j)}jjsb c.dump_inodeasbuh1hhjubj2)}(h h]h }(hjWhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hinodeh]hinode}(hjrhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hconst char *reasonh](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hcharh]hchar}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hreasonh]hreason}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhM ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhM ubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhM hjhhubjw)}(hhh]h)}(hdump an inode.h]hdump an inode.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhM ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjhNhNubj)}(hX**Parameters** ``struct inode *inode`` inode to dump ``const char *reason`` reason for dumping **Description** If inode is an invalid pointer, we don't want to crash accessing it, so probe everything depending on it carefully with get_kernel_nofault().h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjubj)}(hhh](j)}(h&``struct inode *inode`` inode to dump h](j)}(h``struct inode *inode``h]j)}(hj:h]hstruct inode *inode}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj8ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hj4ubj)}(hhh]h)}(h inode to dumph]h inode to dump}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1hhjOhM hjPubah}(h]h ]h"]h$]h&]uh1jhj4ubeh}(h]h ]h"]h$]h&]uh1jhjOhM hj1ubj)}(h*``const char *reason`` reason for dumping h](j)}(h``const char *reason``h]j)}(hjsh]hconst char *reason}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjqubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjmubj)}(hhh]h)}(hreason for dumpingh]hreason for dumping}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjmubeh}(h]h ]h"]h$]h&]uh1jhjhM hj1ubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjubh)}(hIf inode is an invalid pointer, we don't want to crash accessing it, so probe everything depending on it carefully with get_kernel_nofault().h]hIf inode is an invalid pointer, we don’t want to crash accessing it, so probe everything depending on it carefully with get_kernel_nofault().}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:29: ./fs/inode.chM hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j make_bad_inode (C function)c.make_bad_inodehNtauh1hhjhhhNhNubj)}(hhh](j)}(h)void make_bad_inode (struct inode *inode)h]j)}(h(void make_bad_inode(struct inode *inode)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:32: ./fs/bad_inode.chKubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhKubjC)}(hmake_bad_inodeh]jI)}(hmake_bad_inodeh]hmake_bad_inode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhKubj=)}(h(struct inode *inode)h]jC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hj0hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj,ubj2)}(h h]h }(hj=hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj,ubh)}(hhh]jI)}(hinodeh]hinode}(hjNhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjKubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjPmodnameN classnameNjj )}j ]j)}jjsbc.make_bad_inodeasbuh1hhj,ubj2)}(h h]h }(hjnhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj,ubj)}(hjh]h*}(hj|hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,ubjI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj,ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj(ubah}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhKubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhKubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhKhjhhubjw)}(hhh]h)}(h%mark an inode bad due to an I/O errorh]h%mark an inode bad due to an I/O error}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:32: ./fs/bad_inode.chKhjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhKubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjhNhNubj)}(hX**Parameters** ``struct inode *inode`` Inode to mark bad **Description** When an inode cannot be read due to a media or remote network failure this function makes the inode "bad" and causes I/O operations on it to fail from this point on.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:32: ./fs/bad_inode.chKhjubj)}(hhh]j)}(h*``struct inode *inode`` Inode to mark bad h](j)}(h``struct inode *inode``h]j)}(hjh]hstruct inode *inode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:32: ./fs/bad_inode.chKhjubj)}(hhh]h)}(hInode to mark badh]hInode to mark bad}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hKhj ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj hKhjubah}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hj/h]h Description}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj-ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:32: ./fs/bad_inode.chKhjubj)}(hWhen an inode cannot be read due to a media or remote network failure this function makes the inode "bad" and causes I/O operations on it to fail from this point on.h]h)}(hWhen an inode cannot be read due to a media or remote network failure this function makes the inode "bad" and causes I/O operations on it to fail from this point on.h]hWhen an inode cannot be read due to a media or remote network failure this function makes the inode “bad” and causes I/O operations on it to fail from this point on.}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:32: ./fs/bad_inode.chKhjEubah}(h]h ]h"]h$]h&]uh1jhjWhKhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j is_bad_inode (C function)c.is_bad_inodehNtauh1hhjhhhNhNubj)}(hhh](j)}(h'bool is_bad_inode (struct inode *inode)h]j)}(h&bool is_bad_inode(struct inode *inode)h](j)}(hjh]hbool}(hj~hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjzhhhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:32: ./fs/bad_inode.chKubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjzhhhjhKubjC)}(h is_bad_inodeh]jI)}(h is_bad_inodeh]h is_bad_inode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjzhhhjhKubj=)}(h(struct inode *inode)h]jC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jjsbc.is_bad_inodeasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubah}(h]h ]h"]h$]h&]j`jauh1j<hjzhhhjhKubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjvhhhjhKubah}(h]jqah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhKhjshhubjw)}(hhh]h)}(his an inode erroredh]his an inode errored}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:32: ./fs/bad_inode.chKhj:hhubah}(h]h ]h"]h$]h&]uh1jvhjshhhjhKubeh}(h]h ](jfunctioneh"]h$]h&]jjjjUjjUjjjuh1jhhhjhNhNubj)}(h**Parameters** ``struct inode *inode`` inode to test **Description** Returns true if the inode in question has been marked as bad.h](h)}(h**Parameters**h]j)}(hj_h]h Parameters}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1jhj]ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:32: ./fs/bad_inode.chKhjYubj)}(hhh]j)}(h&``struct inode *inode`` inode to test h](j)}(h``struct inode *inode``h]j)}(hj~h]hstruct inode *inode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj|ubah}(h]h ]h"]h$]h&]uh1jhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:32: ./fs/bad_inode.chKhjxubj)}(hhh]h)}(h inode to testh]h inode to test}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjxubeh}(h]h ]h"]h$]h&]uh1jhjhKhjuubah}(h]h ]h"]h$]h&]uh1jhjYubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:32: ./fs/bad_inode.chKhjYubj)}(h=Returns true if the inode in question has been marked as bad.h]h)}(hjh]h=Returns true if the inode in question has been marked as bad.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:32: ./fs/bad_inode.chKhjubah}(h]h ]h"]h$]h&]uh1jhjhKhjYubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j iget_failed (C function) c.iget_failedhNtauh1hhjhhhNhNubj)}(hhh](j)}(h&void iget_failed (struct inode *inode)h]j)}(h%void iget_failed(struct inode *inode)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:32: ./fs/bad_inode.chKubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhKubjC)}(h iget_failedh]jI)}(h iget_failedh]h iget_failed}(hj(hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj$ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhKubj=)}(h(struct inode *inode)h]jC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hjDhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj@ubj2)}(h h]h }(hjQhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj@ubh)}(hhh]jI)}(hinodeh]hinode}(hjbhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj_ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjdmodnameN classnameNjj )}j ]j)}jj*sb c.iget_failedasbuh1hhj@ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj@ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@ubjI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj@ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj<ubah}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhKubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhKubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhKhjhhubjw)}(hhh]h)}(h7Mark an under-construction inode as dead and release ith]h7Mark an under-construction inode as dead and release it}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:32: ./fs/bad_inode.chKhjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhKubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjhNhNubj)}(h**Parameters** ``struct inode *inode`` The inode to discard **Description** Mark an under-construction inode as dead and release it.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:32: ./fs/bad_inode.chKhjubj)}(hhh]j)}(h-``struct inode *inode`` The inode to discard h](j)}(h``struct inode *inode``h]j)}(hjh]hstruct inode *inode}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:32: ./fs/bad_inode.chKhjubj)}(hhh]h)}(hThe inode to discardh]hThe inode to discard}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjCh]h Description}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjAubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:32: ./fs/bad_inode.chKhjubh)}(h8Mark an under-construction inode as dead and release it.h]h8Mark an under-construction inode as dead and release it.}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:32: ./fs/bad_inode.chKhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubeh}(h]inode-handlingah ]h"]inode handlingah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(hRegistration and Superblocksh]hRegistration and Superblocks}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjwhhhhhK$ubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j $deactivate_locked_super (C function)c.deactivate_locked_superhNtauh1hhjwhhhNhNubj)}(hhh](j)}(h4void deactivate_locked_super (struct super_block *s)h]j)}(h3void deactivate_locked_super(struct super_block *s)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMubjC)}(hdeactivate_locked_superh]jI)}(hdeactivate_locked_superh]hdeactivate_locked_super}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhMubj=)}(h(struct super_block *s)h]jC)}(hstruct super_block *sh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(h super_blockh]h super_block}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jjsbc.deactivate_locked_superasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hsh]hs}(hj7hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubah}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhMubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMhjhhubjw)}(hhh]h)}(h&drop an active reference to superblockh]h&drop an active reference to superblock}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhj^hhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjyjjyjjjuh1jhhhjwhNhNubj)}(hX**Parameters** ``struct super_block *s`` superblock to deactivate **Description** Drops an active reference to superblock, converting it into a temporary one if there is no other active references left. In that case we tell fs driver to shut it down and drop the temporary reference we had just acquired. Caller holds exclusive lock on superblock; that lock is released.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chM#hj}ubj)}(hhh]j)}(h3``struct super_block *s`` superblock to deactivate h](j)}(h``struct super_block *s``h]j)}(hjh]hstruct super_block *s}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chM hjubj)}(hhh]h)}(hsuperblock to deactivateh]hsuperblock to deactivate}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hjubah}(h]h ]h"]h$]h&]uh1jhj}ubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chM"hj}ubj)}(hX"Drops an active reference to superblock, converting it into a temporary one if there is no other active references left. In that case we tell fs driver to shut it down and drop the temporary reference we had just acquired. Caller holds exclusive lock on superblock; that lock is released.h](h)}(hDrops an active reference to superblock, converting it into a temporary one if there is no other active references left. In that case we tell fs driver to shut it down and drop the temporary reference we had just acquired.h]hDrops an active reference to superblock, converting it into a temporary one if there is no other active references left. In that case we tell fs driver to shut it down and drop the temporary reference we had just acquired.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chM!hjubh)}(hACaller holds exclusive lock on superblock; that lock is released.h]hACaller holds exclusive lock on superblock; that lock is released.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chM&hjubeh}(h]h ]h"]h$]h&]uh1jhjhM!hj}ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjwhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j deactivate_super (C function)c.deactivate_superhNtauh1hhjwhhhNhNubj)}(hhh](j)}(h-void deactivate_super (struct super_block *s)h]j)}(h,void deactivate_super(struct super_block *s)h](j)}(hvoidh]hvoid}(hj;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7hhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chM?ubj2)}(h h]h }(hjJhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj7hhhjIhM?ubjC)}(hdeactivate_superh]jI)}(hdeactivate_superh]hdeactivate_super}(hj\hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjXubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj7hhhjIhM?ubj=)}(h(struct super_block *s)h]jC)}(hstruct super_block *sh](j )}(hjh]hstruct}(hjxhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjtubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjtubh)}(hhh]jI)}(h super_blockh]h super_block}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jj^sbc.deactivate_superasbuh1hhjtubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjtubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjtubjI)}(hj9h]hs}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjtubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjpubah}(h]h ]h"]h$]h&]j`jauh1j<hj7hhhjIhM?ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj3hhhjIhM?ubah}(h]j.ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjIhM?hj0hhubjw)}(hhh]h)}(h&drop an active reference to superblockh]h&drop an active reference to superblock}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chM?hjhhubah}(h]h ]h"]h$]h&]uh1jvhj0hhhjIhM?ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjwhNhNubj)}(hX**Parameters** ``struct super_block *s`` superblock to deactivate **Description** Variant of deactivate_locked_super(), except that superblock is *not* locked by caller. If we are going to drop the final active reference, lock will be acquired prior to that.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMChjubj)}(hhh]j)}(h3``struct super_block *s`` superblock to deactivate h](j)}(h``struct super_block *s``h]j)}(hj;h]hstruct super_block *s}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj9ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chM@hj5ubj)}(hhh]h)}(hsuperblock to deactivateh]hsuperblock to deactivate}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1hhjPhM@hjQubah}(h]h ]h"]h$]h&]uh1jhj5ubeh}(h]h ]h"]h$]h&]uh1jhjPhM@hj2ubah}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjvh]h Description}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjtubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMBhjubj)}(hVariant of deactivate_locked_super(), except that superblock is *not* locked by caller. If we are going to drop the final active reference, lock will be acquired prior to that.h]h)}(hVariant of deactivate_locked_super(), except that superblock is *not* locked by caller. If we are going to drop the final active reference, lock will be acquired prior to that.h](h@Variant of deactivate_locked_super(), except that superblock is }(hjhhhNhNubj )}(h*not*h]hnot}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j~ hjubhl locked by caller. If we are going to drop the final active reference, lock will be acquired prior to that.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMAhjubah}(h]h ]h"]h$]h&]uh1jhjhMAhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjwhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j retire_super (C function)c.retire_superhNtauh1hhjwhhhNhNubj)}(hhh](j)}(h*void retire_super (struct super_block *sb)h]j)}(h)void retire_super(struct super_block *sb)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMubjC)}(h retire_superh]jI)}(h retire_superh]h retire_super}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhMubj=)}(h(struct super_block *sb)h]jC)}(hstruct super_block *sbh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hj!hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(h super_blockh]h super_block}(hj2hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj/ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj4modnameN classnameNjj )}j ]j)}jjsbc.retire_superasbuh1hhjubj2)}(h h]h }(hjRhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj`hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hsbh]hsb}(hjmhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj ubah}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhMubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMhjhhubjw)}(hhh]h)}(h%prevents superblock from being reusedh]h%prevents superblock from being reused}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjwhNhNubj)}(hX**Parameters** ``struct super_block *sb`` superblock to retire **Description** The function marks superblock to be ignored in superblock test, which prevents it from being reused for any new mounts. If the superblock has a private bdi, it also unregisters it, but doesn't reduce the refcount of the superblock to prevent potential races. The refcount is reduced by generic_shutdown_super(). The function can not be called concurrently with generic_shutdown_super(). It is safe to call the function multiple times, subsequent calls have no effect. The marker will affect the re-use only for block-device-based superblocks. Other superblocks will still get marked if this function is used, but that will not affect their reusability.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhjubj)}(hhh]j)}(h0``struct super_block *sb`` superblock to retire h](j)}(h``struct super_block *sb``h]j)}(hjh]hstruct super_block *sb}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhjubj)}(hhh]h)}(hsuperblock to retireh]hsuperblock to retire}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhjubj)}(hXThe function marks superblock to be ignored in superblock test, which prevents it from being reused for any new mounts. If the superblock has a private bdi, it also unregisters it, but doesn't reduce the refcount of the superblock to prevent potential races. The refcount is reduced by generic_shutdown_super(). The function can not be called concurrently with generic_shutdown_super(). It is safe to call the function multiple times, subsequent calls have no effect. The marker will affect the re-use only for block-device-based superblocks. Other superblocks will still get marked if this function is used, but that will not affect their reusability.h](h)}(hXThe function marks superblock to be ignored in superblock test, which prevents it from being reused for any new mounts. If the superblock has a private bdi, it also unregisters it, but doesn't reduce the refcount of the superblock to prevent potential races. The refcount is reduced by generic_shutdown_super(). The function can not be called concurrently with generic_shutdown_super(). It is safe to call the function multiple times, subsequent calls have no effect.h]hXThe function marks superblock to be ignored in superblock test, which prevents it from being reused for any new mounts. If the superblock has a private bdi, it also unregisters it, but doesn’t reduce the refcount of the superblock to prevent potential races. The refcount is reduced by generic_shutdown_super(). The function can not be called concurrently with generic_shutdown_super(). It is safe to call the function multiple times, subsequent calls have no effect.}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhj)ubh)}(hThe marker will affect the re-use only for block-device-based superblocks. Other superblocks will still get marked if this function is used, but that will not affect their reusability.h]hThe marker will affect the re-use only for block-device-based superblocks. Other superblocks will still get marked if this function is used, but that will not affect their reusability.}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhj)ubeh}(h]h ]h"]h$]h&]uh1jhj;hMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjwhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j #generic_shutdown_super (C function)c.generic_shutdown_superhNtauh1hhjwhhhNhNubj)}(hhh](j)}(h4void generic_shutdown_super (struct super_block *sb)h]j)}(h3void generic_shutdown_super(struct super_block *sb)h](j)}(hvoidh]hvoid}(hjqhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjmhhhjhMubjC)}(hgeneric_shutdown_superh]jI)}(hgeneric_shutdown_superh]hgeneric_shutdown_super}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjmhhhjhMubj=)}(h(struct super_block *sb)h]jC)}(hstruct super_block *sbh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(h super_blockh]h super_block}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jjsbc.generic_shutdown_superasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hsbh]hsb}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubah}(h]h ]h"]h$]h&]j`jauh1j<hjmhhhjhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjihhhjhMubah}(h]jdah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMhjfhhubjw)}(hhh]h)}(hcommon helper for ->kill_sb()h]hcommon helper for ->kill_sb()}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhj.hhubah}(h]h ]h"]h$]h&]uh1jvhjfhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjIjjIjjjuh1jhhhjwhNhNubj)}(hXv**Parameters** ``struct super_block *sb`` superblock to kill **Description** generic_shutdown_super() does all fs-independent work on superblock shutdown. Typical ->kill_sb() should pick all fs-specific objects that need destruction out of superblock, call generic_shutdown_super() and release aforementioned objects. Note: dentries and inodes _are_ taken care of and do not need specific handling. Upon calling this function, the filesystem may no longer alter or rearrange the set of dentries belonging to this super_block, nor may it change the attachments of dentries to inodes.h](h)}(h**Parameters**h]j)}(hjSh]h Parameters}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjQubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhjMubj)}(hhh]j)}(h.``struct super_block *sb`` superblock to kill h](j)}(h``struct super_block *sb``h]j)}(hjrh]hstruct super_block *sb}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jhjpubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhjlubj)}(hhh]h)}(hsuperblock to killh]hsuperblock to kill}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjlubeh}(h]h ]h"]h$]h&]uh1jhjhMhjiubah}(h]h ]h"]h$]h&]uh1jhjMubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhjMubj)}(hXgeneric_shutdown_super() does all fs-independent work on superblock shutdown. Typical ->kill_sb() should pick all fs-specific objects that need destruction out of superblock, call generic_shutdown_super() and release aforementioned objects. Note: dentries and inodes _are_ taken care of and do not need specific handling. Upon calling this function, the filesystem may no longer alter or rearrange the set of dentries belonging to this super_block, nor may it change the attachments of dentries to inodes.h](h)}(hXCgeneric_shutdown_super() does all fs-independent work on superblock shutdown. Typical ->kill_sb() should pick all fs-specific objects that need destruction out of superblock, call generic_shutdown_super() and release aforementioned objects. Note: dentries and inodes _are_ taken care of and do not need specific handling.h]hXCgeneric_shutdown_super() does all fs-independent work on superblock shutdown. Typical ->kill_sb() should pick all fs-specific objects that need destruction out of superblock, call generic_shutdown_super() and release aforementioned objects. Note: dentries and inodes _are_ taken care of and do not need specific handling.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhjubh)}(hUpon calling this function, the filesystem may no longer alter or rearrange the set of dentries belonging to this super_block, nor may it change the attachments of dentries to inodes.h]hUpon calling this function, the filesystem may no longer alter or rearrange the set of dentries belonging to this super_block, nor may it change the attachments of dentries to inodes.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjMubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjwhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j sget_fc (C function) c.sget_fchNtauh1hhjwhhhNhNubj)}(hhh](j)}(hstruct super_block * sget_fc (struct fs_context *fc, int (*test)(struct super_block *, struct fs_context *), int (*set)(struct super_block *, struct fs_context *))h]j)}(hstruct super_block *sget_fc(struct fs_context *fc, int (*test)(struct super_block*, struct fs_context*), int (*set)(struct super_block*, struct fs_context*))h](j )}(hjh]hstruct}(hj hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chM ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhM ubh)}(hhh]jI)}(h super_blockh]h super_block}(hj*hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj'ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj,modnameN classnameNjj )}j ]j)}jsget_fcsb c.sget_fcasbuh1hhjhhhjhM ubj2)}(h h]h }(hjKhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhM ubj)}(hjh]h*}(hjYhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM ubjC)}(hsget_fch]jI)}(hjHh]hsget_fc}(hjjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjfubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhM ubj=)}(h(struct fs_context *fc, int (*test)(struct super_block*, struct fs_context*), int (*set)(struct super_block*, struct fs_context*))h](jC)}(hstruct fs_context *fch](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(h fs_contexth]h fs_context}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jF c.sget_fcasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hfch]hfc}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj}ubjC)}(h4int (*test)(struct super_block*, struct fs_context*)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hj hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjʥh]h(}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]h*}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(htesth]htest}(hj+ hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubj)}(hjh]h)}(hj9 hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjʥh]h(}(hjF hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj )}(hjh]hstruct}(hjS hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hj` hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(h super_blockh]h super_block}(hjq hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjn ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjs modnameN classnameNjj )}j ]jF c.sget_fcasbuh1hhjubj)}(hjh]h*}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjWh]h,}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hj hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj )}(hjh]hstruct}(hj hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hj hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(h fs_contexth]h fs_context}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj modnameN classnameNjj )}j ]jF c.sget_fcasbuh1hhjubj)}(hjh]h*}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]h)}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj}ubjC)}(h3int (*set)(struct super_block*, struct fs_context*)h](j)}(hinth]hint}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj2)}(h h]h }(hj& hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj ubj)}(hjʥh]h(}(hj4 hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(hjh]h*}(hjA hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubjI)}(hseth]hset}(hjN hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubj)}(hjh]h)}(hj\ hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(hjʥh]h(}(hji hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj )}(hjh]hstruct}(hjv hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj ubj2)}(h h]h }(hj hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj ubh)}(hhh]jI)}(h super_blockh]h super_block}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj modnameN classnameNjj )}j ]jF c.sget_fcasbuh1hhj ubj)}(hjh]h*}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(hjWh]h,}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj2)}(h h]h }(hj hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj ubj )}(hjh]hstruct}(hj hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj ubj2)}(h h]h }(hj hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj ubh)}(hhh]jI)}(h fs_contexth]h fs_context}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj modnameN classnameNjj )}j ]jF c.sget_fcasbuh1hhj ubj)}(hjh]h*}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(hjh]h)}(hj# hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj}ubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhM ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhM ubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhM hjhhubjw)}(hhh]h)}(hFind or create a superblockh]hFind or create a superblock}(hjL hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chM hjI hhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhM ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjd jjd jjjuh1jhhhjwhNhNubj)}(hX**Parameters** ``struct fs_context *fc`` Filesystem context. ``int (*test)(struct super_block *, struct fs_context *)`` Comparison callback ``int (*set)(struct super_block *, struct fs_context *)`` Setup callback **Description** Create a new superblock or find an existing one. The **test** callback is used to find a matching existing superblock. Whether or not the requested parameters in **fc** are taken into account is specific to the **test** callback that is used. They may even be completely ignored. If an extant superblock is matched, it will be returned unless: (1) the namespace the filesystem context **fc** and the extant superblock's namespace differ (2) the filesystem context **fc** has requested that reusing an extant superblock is not allowed In both cases EBUSY will be returned. If no match is made, a new superblock will be allocated and basic initialisation will be performed (s_type, s_fs_info and s_id will be set and the **set** callback will be invoked), the superblock will be published and it will be returned in a partially constructed state with SB_BORN and SB_ACTIVE as yet unset. **Return** On success, an extant or newly created superblock is returned. On failure an error pointer is returned.h](h)}(h**Parameters**h]j)}(hjn h]h Parameters}(hjp hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjl ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhjh ubj)}(hhh](j)}(h.``struct fs_context *fc`` Filesystem context. h](j)}(h``struct fs_context *fc``h]j)}(hj h]hstruct fs_context *fc}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chM hj ubj)}(hhh]h)}(hFilesystem context.h]hFilesystem context.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hM hj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hM hj ubj)}(hO``int (*test)(struct super_block *, struct fs_context *)`` Comparison callback h](j)}(h:``int (*test)(struct super_block *, struct fs_context *)``h]j)}(hj h]h6int (*test)(struct super_block *, struct fs_context *)}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhj ubj)}(hhh]h)}(hComparison callbackh]hComparison callback}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hMhj ubj)}(hI``int (*set)(struct super_block *, struct fs_context *)`` Setup callback h](j)}(h9``int (*set)(struct super_block *, struct fs_context *)``h]j)}(hj h]h5int (*set)(struct super_block *, struct fs_context *)}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhj ubj)}(hhh]h)}(hSetup callbackh]hSetup callback}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hMhj ubeh}(h]h ]h"]h$]h&]uh1jhjh ubh)}(h**Description**h]j)}(hj: h]h Description}(hj< hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj8 ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhjh ubh)}(h0Create a new superblock or find an existing one.h]h0Create a new superblock or find an existing one.}(hjP hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhjh ubh)}(hThe **test** callback is used to find a matching existing superblock. Whether or not the requested parameters in **fc** are taken into account is specific to the **test** callback that is used. They may even be completely ignored.h](hThe }(hj_ hhhNhNubj)}(h**test**h]htest}(hjg hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj_ ubhe callback is used to find a matching existing superblock. Whether or not the requested parameters in }(hj_ hhhNhNubj)}(h**fc**h]hfc}(hjy hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj_ ubh+ are taken into account is specific to the }(hj_ hhhNhNubj)}(h**test**h]htest}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj_ ubh< callback that is used. They may even be completely ignored.}(hj_ hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhjh ubh)}(h?If an extant superblock is matched, it will be returned unless:h]h?If an extant superblock is matched, it will be returned unless:}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhjh ubj9W)}(hhh](jE)}(hYthe namespace the filesystem context **fc** and the extant superblock's namespace differ h]h)}(hXthe namespace the filesystem context **fc** and the extant superblock's namespace differh](h%the namespace the filesystem context }(hj hhhNhNubj)}(h**fc**h]hfc}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubh/ and the extant superblock’s namespace differ}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhj ubah}(h]h ]h"]h$]h&]uh1jEhj ubjE)}(h]the filesystem context **fc** has requested that reusing an extant superblock is not allowed h]h)}(h\the filesystem context **fc** has requested that reusing an extant superblock is not allowedh](hthe filesystem context }(hj hhhNhNubj)}(h**fc**h]hfc}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubh? has requested that reusing an extant superblock is not allowed}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhj ubah}(h]h ]h"]h$]h&]uh1jEhj ubeh}(h]h ]h"]h$]h&]juWjvWjwWjʥjxWjuh1j8Whjh ubh)}(h%In both cases EBUSY will be returned.h]h%In both cases EBUSY will be returned.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhjh ubh)}(hX8If no match is made, a new superblock will be allocated and basic initialisation will be performed (s_type, s_fs_info and s_id will be set and the **set** callback will be invoked), the superblock will be published and it will be returned in a partially constructed state with SB_BORN and SB_ACTIVE as yet unset.h](hIf no match is made, a new superblock will be allocated and basic initialisation will be performed (s_type, s_fs_info and s_id will be set and the }(hj! hhhNhNubj)}(h**set**h]hset}(hj) hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj! ubh callback will be invoked), the superblock will be published and it will be returned in a partially constructed state with SB_BORN and SB_ACTIVE as yet unset.}(hj! hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chM!hjh ubh)}(h **Return**h]j)}(hjD h]hReturn}(hjF hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjB ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chM'hjh ubh)}(hgOn success, an extant or newly created superblock is returned. On failure an error pointer is returned.h]hgOn success, an extant or newly created superblock is returned. On failure an error pointer is returned.}(hjZ hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chM(hjh ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjwhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j  iterate_supers_type (C function)c.iterate_supers_typehNtauh1hhjwhhhNhNubj)}(hhh](j)}(hlvoid iterate_supers_type (struct file_system_type *type, void (*f)(struct super_block *, void *), void *arg)h]j)}(hivoid iterate_supers_type(struct file_system_type *type, void (*f)(struct super_block*, void*), void *arg)h](j)}(hvoidh]hvoid}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMubj2)}(h h]h }(hj hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj hhhj hMubjC)}(hiterate_supers_typeh]jI)}(hiterate_supers_typeh]hiterate_supers_type}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj hhhj hMubj=)}(hQ(struct file_system_type *type, void (*f)(struct super_block*, void*), void *arg)h](jC)}(hstruct file_system_type *typeh](j )}(hjh]hstruct}(hj hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj ubj2)}(h h]h }(hj hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj ubh)}(hhh]jI)}(hfile_system_typeh]hfile_system_type}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj modnameN classnameNjj )}j ]j)}jj sbc.iterate_supers_typeasbuh1hhj ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubjI)}(htypeh]htype}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj ubjC)}(h%void (*f)(struct super_block*, void*)h](j)}(hvoidh]hvoid}(hj8hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4ubj2)}(h h]h }(hjFhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj4ubj)}(hjʥh]h(}(hjThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4ubj)}(hjh]h*}(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4ubjI)}(hfh]hf}(hjnhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj4ubj)}(hjh]h)}(hj|hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4ubj)}(hjʥh]h(}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4ubj )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj4ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj4ubh)}(hhh]jI)}(h super_blockh]h super_block}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.iterate_supers_typeasbuh1hhj4ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4ubj)}(hjWh]h,}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj4ubj)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4ubj)}(hjh]h)}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj ubjC)}(h void *argh](j)}(hvoidh]hvoid}(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubj2)}(h h]h }(hj;hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj)ubj)}(hjh]h*}(hjIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubjI)}(hargh]harg}(hjVhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj)ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj ubeh}(h]h ]h"]h$]h&]j`jauh1j<hj hhhj hMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj hhhj hMubah}(h]j| ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj hMhj~ hhubjw)}(hhh]h)}(h+call function for superblocks of given typeh]h+call function for superblocks of given type}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhj}hhubah}(h]h ]h"]h$]h&]uh1jvhj~ hhhj hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjwhNhNubj)}(hX$**Parameters** ``struct file_system_type *type`` fs type ``void (*f)(struct super_block *, void *)`` function to call ``void *arg`` argument to pass to it **Description** Scans the superblock list and calls given function, passing it locked superblock and given argument.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhjubj)}(hhh](j)}(h*``struct file_system_type *type`` fs type h](j)}(h!``struct file_system_type *type``h]j)}(hjh]hstruct file_system_type *type}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhjubj)}(hhh]h)}(hfs typeh]hfs type}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h=``void (*f)(struct super_block *, void *)`` function to call h](j)}(h+``void (*f)(struct super_block *, void *)``h]j)}(hjh]h'void (*f)(struct super_block *, void *)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhjubj)}(hhh]h)}(hfunction to callh]hfunction to call}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h%``void *arg`` argument to pass to it h](j)}(h ``void *arg``h]j)}(hj3h]h void *arg}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj1ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhj-ubj)}(hhh]h)}(hargument to pass to ith]hargument to pass to it}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjHhMhjIubah}(h]h ]h"]h$]h&]uh1jhj-ubeh}(h]h ]h"]h$]h&]uh1jhjHhMhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjnh]h Description}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1jhjlubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhjubj)}(hdScans the superblock list and calls given function, passing it locked superblock and given argument.h]h)}(hdScans the superblock list and calls given function, passing it locked superblock and given argument.h]hdScans the superblock list and calls given function, passing it locked superblock and given argument.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhjubah}(h]h ]h"]h$]h&]uh1jhjhMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjwhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j get_anon_bdev (C function)c.get_anon_bdevhNtauh1hhjwhhhNhNubj)}(hhh](j)}(hint get_anon_bdev (dev_t *p)h]j)}(hint get_anon_bdev(dev_t *p)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMubjC)}(h get_anon_bdevh]jI)}(h get_anon_bdevh]h get_anon_bdev}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhMubj=)}(h (dev_t *p)h]jC)}(hdev_t *ph](h)}(hhh]jI)}(hdev_th]hdev_t}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jjsbc.get_anon_bdevasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hjh]hp}(hj8hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubah}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhMubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMhjhhubjw)}(hhh]h)}(h=Allocate a block device for filesystems which don't have one.h]h?Allocate a block device for filesystems which don’t have one.}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhj^hhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjyjjyjjjuh1jhhhjwhNhNubj)}(hXc**Parameters** ``dev_t *p`` Pointer to a dev_t. **Description** Filesystems which don't use real block devices can call this function to allocate a virtual block device. **Context** Any context. Frequently called while holding sb_lock. **Return** 0 on success, -EMFILE if there are no anonymous bdevs left or -ENOMEM if memory allocation failed.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhj}ubj)}(hhh]j)}(h!``dev_t *p`` Pointer to a dev_t. h](j)}(h ``dev_t *p``h]j)}(hjh]hdev_t *p}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhjubj)}(hhh]h)}(hPointer to a dev_t.h]hPointer to a dev_t.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubah}(h]h ]h"]h$]h&]uh1jhj}ubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhj}ubh)}(hiFilesystems which don't use real block devices can call this function to allocate a virtual block device.h]hkFilesystems which don’t use real block devices can call this function to allocate a virtual block device.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhj}ubh)}(h **Context**h]j)}(hjh]hContext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhj}ubh)}(h6Any context. Frequently called while holding sb_lock.h]h6Any context. Frequently called while holding sb_lock.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhj}ubh)}(h **Return**h]j)}(hj+h]hReturn}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj)ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhj}ubh)}(hb0 on success, -EMFILE if there are no anonymous bdevs left or -ENOMEM if memory allocation failed.h]hb0 on success, -EMFILE if there are no anonymous bdevs left or -ENOMEM if memory allocation failed.}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhj}ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjwhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j get_tree_super (C function)c.get_tree_superhNtauh1hhjwhhhNhNubj)}(hhh](j)}(hint get_tree_super (struct fs_context *fc, int (*test)(struct super_block *, struct fs_context *), int (*fill_super)(struct super_block *sb, struct fs_context *fc))h]j)}(hint get_tree_super(struct fs_context *fc, int (*test)(struct super_block*, struct fs_context*), int (*fill_super)(struct super_block *sb, struct fs_context *fc))h](j)}(hinth]hint}(hjphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjlhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chM:ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjlhhhj~hM:ubjC)}(hget_tree_superh]jI)}(hget_tree_superh]hget_tree_super}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjlhhhj~hM:ubj=)}(h(struct fs_context *fc, int (*test)(struct super_block*, struct fs_context*), int (*fill_super)(struct super_block *sb, struct fs_context *fc))h](jC)}(hstruct fs_context *fch](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(h fs_contexth]h fs_context}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jjsbc.get_tree_superasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hfch]hfc}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h4int (*test)(struct super_block*, struct fs_context*)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hj-hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjʥh]h(}(hj;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]h*}(hjHhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(htesth]htest}(hjUhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubj)}(hjh]h)}(hjchhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjʥh]h(}(hjphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj )}(hjh]hstruct}(hj}hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(h super_blockh]h super_block}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.get_tree_superasbuh1hhjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjWh]h,}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(h fs_contexth]h fs_context}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.get_tree_superasbuh1hhjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]h)}(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h@int (*fill_super)(struct super_block *sb, struct fs_context *fc)h](j)}(hinth]hint}(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>ubj2)}(h h]h }(hjPhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj>ubj)}(hjʥh]h(}(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>ubj)}(hjh]h*}(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>ubjI)}(h fill_superh]h fill_super}(hjxhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj>ubj)}(hjh]h)}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>ubj)}(hjʥh]h(}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>ubj )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj>ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj>ubh)}(hhh]jI)}(h super_blockh]h super_block}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.get_tree_superasbuh1hhj>ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj>ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>ubjI)}(hsbh]hsb}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj>ubj)}(hjWh]h,}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj>ubj )}(hjh]hstruct}(hj hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj>ubj2)}(h h]h }(hj-hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj>ubh)}(hhh]jI)}(h fs_contexth]h fs_context}(hj>hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj;ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj@modnameN classnameNjj )}j ]jc.get_tree_superasbuh1hhj>ubj2)}(h h]h }(hj\hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj>ubj)}(hjh]h*}(hjjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>ubjI)}(hfch]hfc}(hjwhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj>ubj)}(hjh]h)}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjlhhhj~hM:ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhhj~hM:ubah}(h]jcah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj~hM:hjehhubjw)}(hhh]h)}(h4Get a superblock, optionally sharing an existing oneh]h4Get a superblock, optionally sharing an existing one}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chM:hjhhubah}(h]h ]h"]h$]h&]uh1jvhjehhhj~hM:ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjwhNhNubj)}(hXC**Parameters** ``struct fs_context *fc`` The filesystem context holding the parameters ``int (*test)(struct super_block *, struct fs_context *)`` Comparison function to find a matching existing superblock, or NULL ``int (*fill_super)(struct super_block *sb, struct fs_context *fc)`` Helper to initialise a new superblock **Description** If **test** is non-NULL and matches an existing superblock, that superblock is reused; otherwise a new anonymous superblock is created and initialised with **fill_super**. Passing NULL for **test** always creates a new superblock.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chM>hjubj)}(hhh](j)}(hH``struct fs_context *fc`` The filesystem context holding the parameters h](j)}(h``struct fs_context *fc``h]j)}(hjh]hstruct fs_context *fc}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chM;hjubj)}(hhh]h)}(h-The filesystem context holding the parametersh]h-The filesystem context holding the parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM;hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM;hjubj)}(h``int (*test)(struct super_block *, struct fs_context *)`` Comparison function to find a matching existing superblock, or NULL h](j)}(h:``int (*test)(struct super_block *, struct fs_context *)``h]j)}(hj(h]h6int (*test)(struct super_block *, struct fs_context *)}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj&ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chM<hj"ubj)}(hhh]h)}(hCComparison function to find a matching existing superblock, or NULLh]hCComparison function to find a matching existing superblock, or NULL}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj=hM<hj>ubah}(h]h ]h"]h$]h&]uh1jhj"ubeh}(h]h ]h"]h$]h&]uh1jhj=hM<hjubj)}(hk``int (*fill_super)(struct super_block *sb, struct fs_context *fc)`` Helper to initialise a new superblock h](j)}(hD``int (*fill_super)(struct super_block *sb, struct fs_context *fc)``h]j)}(hjah]h@int (*fill_super)(struct super_block *sb, struct fs_context *fc)}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jhj_ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chM=hj[ubj)}(hhh]h)}(h%Helper to initialise a new superblockh]h%Helper to initialise a new superblock}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjvhM=hjwubah}(h]h ]h"]h$]h&]uh1jhj[ubeh}(h]h ]h"]h$]h&]uh1jhjvhM=hjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chM?hjubh)}(hIf **test** is non-NULL and matches an existing superblock, that superblock is reused; otherwise a new anonymous superblock is created and initialised with **fill_super**. Passing NULL for **test** always creates a new superblock.h](hIf }(hjhhhNhNubj)}(h**test**h]htest}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh is non-NULL and matches an existing superblock, that superblock is reused; otherwise a new anonymous superblock is created and initialised with }(hjhhhNhNubj)}(h**fill_super**h]h fill_super}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh. Passing NULL for }(hjhhhNhNubj)}(h**test**h]htest}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh! always creates a new superblock.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chM>hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjwhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j sget_dev (C function) c.sget_devhNtauh1hhjwhhhNhNubj)}(hhh](j)}(h@struct super_block * sget_dev (struct fs_context *fc, dev_t dev)h]j)}(h>struct super_block *sget_dev(struct fs_context *fc, dev_t dev)h](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMubj2)}(h h]h }(hj%hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhj$hMubh)}(hhh]jI)}(h super_blockh]h super_block}(hj6hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj3ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj8modnameN classnameNjj )}j ]j)}jsget_devsb c.sget_devasbuh1hhjhhhj$hMubj2)}(h h]h }(hjWhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhj$hMubj)}(hjh]h*}(hjehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhj$hMubjC)}(hsget_devh]jI)}(hjTh]hsget_dev}(hjvhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjrubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhj$hMubj=)}(h"(struct fs_context *fc, dev_t dev)h](jC)}(hstruct fs_context *fch](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(h fs_contexth]h fs_context}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jR c.sget_devasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hfch]hfc}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h dev_t devh](h)}(hhh]jI)}(hdev_th]hdev_t}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jR c.sget_devasbuh1hhjubj2)}(h h]h }(hj"hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hdevh]hdev}(hj0hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhj$hMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhj$hMubah}(h]j ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj$hMhj hhubjw)}(hhh]h)}(h,Find or create a superblock by device numberh]h,Find or create a superblock by device number}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhjWhhubah}(h]h ]h"]h$]h&]uh1jvhj hhhj$hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjrjjrjjjuh1jhhhjwhNhNubj)}(hX**Parameters** ``struct fs_context *fc`` Filesystem context. ``dev_t dev`` device number **Description** Find or create a superblock using the provided device number that will be stored in fc->sget_key. If an extant superblock is matched, then that will be returned with an elevated reference count that the caller must transfer or discard. If no match is made, a new superblock will be allocated and basic initialisation will be performed (s_type, s_fs_info, s_id, s_dev will be set). The superblock will be published and it will be returned in a partially constructed state with SB_BORN and SB_ACTIVE as yet unset. **Return** an existing or newly created superblock on success, an error pointer on failure.h](h)}(h**Parameters**h]j)}(hj|h]h Parameters}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjzubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhjvubj)}(hhh](j)}(h.``struct fs_context *fc`` Filesystem context. h](j)}(h``struct fs_context *fc``h]j)}(hjh]hstruct fs_context *fc}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhjubj)}(hhh]h)}(hFilesystem context.h]hFilesystem context.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h``dev_t dev`` device number h](j)}(h ``dev_t dev``h]j)}(hjh]h dev_t dev}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhjubj)}(hhh]h)}(h device numberh]h device number}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubeh}(h]h ]h"]h$]h&]uh1jhjvubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhjvubh)}(haFind or create a superblock using the provided device number that will be stored in fc->sget_key.h]haFind or create a superblock using the provided device number that will be stored in fc->sget_key.}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhjvubh)}(hIf an extant superblock is matched, then that will be returned with an elevated reference count that the caller must transfer or discard.h]hIf an extant superblock is matched, then that will be returned with an elevated reference count that the caller must transfer or discard.}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhjvubh)}(hXIf no match is made, a new superblock will be allocated and basic initialisation will be performed (s_type, s_fs_info, s_id, s_dev will be set). The superblock will be published and it will be returned in a partially constructed state with SB_BORN and SB_ACTIVE as yet unset.h]hXIf no match is made, a new superblock will be allocated and basic initialisation will be performed (s_type, s_fs_info, s_id, s_dev will be set). The superblock will be published and it will be returned in a partially constructed state with SB_BORN and SB_ACTIVE as yet unset.}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhjvubh)}(h **Return**h]j)}(hjTh]hReturn}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjRubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhjvubh)}(hPan existing or newly created superblock on success, an error pointer on failure.h]hPan existing or newly created superblock on success, an error pointer on failure.}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhjvubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjwhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j %fs_bdev_file_open_by_dev (C function)c.fs_bdev_file_open_by_devhNtauh1hhjwhhhNhNubj)}(hhh](j)}(histruct file * fs_bdev_file_open_by_dev (dev_t dev, blk_mode_t mode, void *holder, struct super_block *sb)h]j)}(hgstruct file *fs_bdev_file_open_by_dev(dev_t dev, blk_mode_t mode, void *holder, struct super_block *sb)h](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chM_ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhM_ubh)}(hhh]jI)}(hfileh]hfile}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jfs_bdev_file_open_by_devsbc.fs_bdev_file_open_by_devasbuh1hhjhhhjhM_ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhM_ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM_ubjC)}(hfs_bdev_file_open_by_devh]jI)}(hjh]hfs_bdev_file_open_by_dev}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhM_ubj=)}(hB(dev_t dev, blk_mode_t mode, void *holder, struct super_block *sb)h](jC)}(h dev_t devh](h)}(hhh]jI)}(hdev_th]hdev_t}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.fs_bdev_file_open_by_devasbuh1hhjubj2)}(h h]h }(hj4hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hdevh]hdev}(hjBhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj ubjC)}(hblk_mode_t modeh](h)}(hhh]jI)}(h blk_mode_th]h blk_mode_t}(hj^hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj[ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj`modnameN classnameNjj )}j ]jc.fs_bdev_file_open_by_devasbuh1hhjWubj2)}(h h]h }(hj|hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjWubjI)}(hmodeh]hmode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjWubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj ubjC)}(h void *holderh](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hholderh]hholder}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj ubjC)}(hstruct super_block *sbh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(h super_blockh]h super_block}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.fs_bdev_file_open_by_devasbuh1hhjubj2)}(h h]h }(hj!hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hsbh]hsb}(hj<hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj ubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhM_ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhM_ubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhM_hjhhubjw)}(hhh]h)}(h.claim a block device on behalf of a superblockh]h.claim a block device on behalf of a superblock}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chM_hjchhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhM_ubeh}(h]h ](jfunctioneh"]h$]h&]jjjj~jj~jjjuh1jhhhjwhNhNubj)}(hXj**Parameters** ``dev_t dev`` block device number ``blk_mode_t mode`` open mode ``void *holder`` block-layer exclusivity token (a superblock, or the file_system_type when the device may be shared by several superblocks of that type) ``struct super_block *sb`` superblock to drive fs_holder_ops events for **Description** Open **dev** with :c:type:`fs_holder_ops` and register that **sb** uses it, so device removal/sync/freeze/thaw are propagated to **sb** (and any other superblock sharing **dev**). Must be paired with fs_bdev_file_release(). **Return** an opened block-device file or an ERR_PTR().h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMchjubj)}(hhh](j)}(h"``dev_t dev`` block device number h](j)}(h ``dev_t dev``h]j)}(hjh]h dev_t dev}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chM`hjubj)}(hhh]h)}(hblock device numberh]hblock device number}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM`hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM`hjubj)}(h``blk_mode_t mode`` open mode h](j)}(h``blk_mode_t mode``h]j)}(hjh]hblk_mode_t mode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMahjubj)}(hhh]h)}(h open modeh]h open mode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMahjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMahjubj)}(h``void *holder`` block-layer exclusivity token (a superblock, or the file_system_type when the device may be shared by several superblocks of that type) h](j)}(h``void *holder``h]j)}(hjh]h void *holder}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMchjubj)}(hhh]h)}(hblock-layer exclusivity token (a superblock, or the file_system_type when the device may be shared by several superblocks of that type)h]hblock-layer exclusivity token (a superblock, or the file_system_type when the device may be shared by several superblocks of that type)}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMbhj/ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj.hMchjubj)}(hH``struct super_block *sb`` superblock to drive fs_holder_ops events for h](j)}(h``struct super_block *sb``h]j)}(hjSh]hstruct super_block *sb}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjQubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMdhjMubj)}(hhh]h)}(h,superblock to drive fs_holder_ops events forh]h,superblock to drive fs_holder_ops events for}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhMdhjiubah}(h]h ]h"]h$]h&]uh1jhjMubeh}(h]h ]h"]h$]h&]uh1jhjhhMdhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMfhjubh)}(hOpen **dev** with :c:type:`fs_holder_ops` and register that **sb** uses it, so device removal/sync/freeze/thaw are propagated to **sb** (and any other superblock sharing **dev**). Must be paired with fs_bdev_file_release().h](hOpen }(hjhhhNhNubj)}(h**dev**h]hdev}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh with }(hjhhhNhNubh)}(h:c:type:`fs_holder_ops`h]j)}(hjh]h fs_holder_ops}(hjhhhNhNubah}(h]h ](xrefjc-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocfilesystems/api-summary refdomainjreftypetype refexplicitrefwarnjj )}j ]sb reftarget fs_holder_opsuh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMehjubh and register that }(hjhhhNhNubj)}(h**sb**h]hsb}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh? uses it, so device removal/sync/freeze/thaw are propagated to }(hjhhhNhNubj)}(h**sb**h]hsb}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh# (and any other superblock sharing }(hjhhhNhNubj)}(h**dev**h]hdev}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh/). Must be paired with fs_bdev_file_release().}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhMehjubh)}(h **Return**h]j)}(hj&h]hReturn}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj$ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMihjubh)}(h,an opened block-device file or an ERR_PTR().h]h,an opened block-device file or an ERR_PTR().}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMjhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjwhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j &fs_bdev_file_open_by_path (C function)c.fs_bdev_file_open_by_pathhNtauh1hhjwhhhNhNubj)}(hhh](j)}(hqstruct file * fs_bdev_file_open_by_path (const char *path, blk_mode_t mode, void *holder, struct super_block *sb)h]j)}(hostruct file *fs_bdev_file_open_by_path(const char *path, blk_mode_t mode, void *holder, struct super_block *sb)h](j )}(hjh]hstruct}(hjkhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjghhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMubj2)}(h h]h }(hjyhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjghhhjxhMubh)}(hhh]jI)}(hfileh]hfile}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jfs_bdev_file_open_by_pathsbc.fs_bdev_file_open_by_pathasbuh1hhjghhhjxhMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjghhhjxhMubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjghhhjxhMubjC)}(hfs_bdev_file_open_by_pathh]jI)}(hjh]hfs_bdev_file_open_by_path}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjghhhjxhMubj=)}(hI(const char *path, blk_mode_t mode, void *holder, struct super_block *sb)h](jC)}(hconst char *pathh](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hcharh]hchar}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hpathh]hpath}(hj)hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hblk_mode_t modeh](h)}(hhh]jI)}(h blk_mode_th]h blk_mode_t}(hjEhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjBubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjGmodnameN classnameNjj )}j ]jc.fs_bdev_file_open_by_pathasbuh1hhj>ubj2)}(h h]h }(hjchhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj>ubjI)}(hmodeh]hmode}(hjqhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj>ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h void *holderh](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hholderh]hholder}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct super_block *sbh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(h super_blockh]h super_block}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.fs_bdev_file_open_by_pathasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hsbh]hsb}(hj#hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjghhhjxhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjchhhjxhMubah}(h]j^ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjxhMhj`hhubjw)}(hhh]h)}(h.claim a block device on behalf of a superblockh]h.claim a block device on behalf of a superblock}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhjJhhubah}(h]h ]h"]h$]h&]uh1jvhj`hhhjxhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjejjejjjuh1jhhhjwhNhNubj)}(hX**Parameters** ``const char *path`` path to the block device ``blk_mode_t mode`` open mode ``void *holder`` block-layer exclusivity token (a superblock, or the file_system_type when the device may be shared by several superblocks of that type) ``struct super_block *sb`` superblock to drive fs_holder_ops events for **Description** Open the block device at **path** with :c:type:`fs_holder_ops` and register that **sb** uses it, so device removal/sync/freeze/thaw are propagated to **sb** (and any other superblock sharing the device). Must be paired with fs_bdev_file_release(). **Return** an opened block-device file or an ERR_PTR().h](h)}(h**Parameters**h]j)}(hjoh]h Parameters}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjmubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhjiubj)}(hhh](j)}(h.``const char *path`` path to the block device h](j)}(h``const char *path``h]j)}(hjh]hconst char *path}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhjubj)}(hhh]h)}(hpath to the block deviceh]hpath to the block device}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h``blk_mode_t mode`` open mode h](j)}(h``blk_mode_t mode``h]j)}(hjh]hblk_mode_t mode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhjubj)}(hhh]h)}(h open modeh]h open mode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h``void *holder`` block-layer exclusivity token (a superblock, or the file_system_type when the device may be shared by several superblocks of that type) h](j)}(h``void *holder``h]j)}(hj h]h void *holder}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhjubj)}(hhh]h)}(hblock-layer exclusivity token (a superblock, or the file_system_type when the device may be shared by several superblocks of that type)h]hblock-layer exclusivity token (a superblock, or the file_system_type when the device may be shared by several superblocks of that type)}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhj ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj hMhjubj)}(hH``struct super_block *sb`` superblock to drive fs_holder_ops events for h](j)}(h``struct super_block *sb``h]j)}(hj: h]hstruct super_block *sb}(hj< hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj8 ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhj4 ubj)}(hhh]h)}(h,superblock to drive fs_holder_ops events forh]h,superblock to drive fs_holder_ops events for}(hjS hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjO hMhjP ubah}(h]h ]h"]h$]h&]uh1jhj4 ubeh}(h]h ]h"]h$]h&]uh1jhjO hMhjubeh}(h]h ]h"]h$]h&]uh1jhjiubh)}(h**Description**h]j)}(hju h]h Description}(hjw hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjs ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhjiubh)}(hOpen the block device at **path** with :c:type:`fs_holder_ops` and register that **sb** uses it, so device removal/sync/freeze/thaw are propagated to **sb** (and any other superblock sharing the device). Must be paired with fs_bdev_file_release().h](hOpen the block device at }(hj hhhNhNubj)}(h**path**h]hpath}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubh with }(hj hhhNhNubh)}(h:c:type:`fs_holder_ops`h]j)}(hj h]h fs_holder_ops}(hj hhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnjjj fs_holder_opsuh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhj ubh and register that }(hj hhhNhNubj)}(h**sb**h]hsb}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubh? uses it, so device removal/sync/freeze/thaw are propagated to }(hj hhhNhNubj)}(h**sb**h]hsb}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubh\ (and any other superblock sharing the device). Must be paired with fs_bdev_file_release().}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj hMhjiubh)}(h **Return**h]j)}(hj h]hReturn}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhjiubh)}(h,an opened block-device file or an ERR_PTR().h]h,an opened block-device file or an ERR_PTR().}(hj !hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhjiubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjwhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j fs_bdev_unregister (C function)c.fs_bdev_unregisterhNtauh1hhjwhhhNhNubj)}(hhh](j)}(hHvoid fs_bdev_unregister (struct file *bdev_file, struct super_block *sb)h]j)}(hGvoid fs_bdev_unregister(struct file *bdev_file, struct super_block *sb)h](j)}(hvoidh]hvoid}(hj:!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj6!hhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMubj2)}(h h]h }(hjI!hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj6!hhhjH!hMubjC)}(hfs_bdev_unregisterh]jI)}(hfs_bdev_unregisterh]hfs_bdev_unregister}(hj[!hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjW!ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj6!hhhjH!hMubj=)}(h0(struct file *bdev_file, struct super_block *sb)h](jC)}(hstruct file *bdev_fileh](j )}(hjh]hstruct}(hjw!hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjs!ubj2)}(h h]h }(hj!hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjs!ubh)}(hhh]jI)}(hfileh]hfile}(hj!hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj!ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj!modnameN classnameNjj )}j ]j)}jj]!sbc.fs_bdev_unregisterasbuh1hhjs!ubj2)}(h h]h }(hj!hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjs!ubj)}(hjh]h*}(hj!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjs!ubjI)}(h bdev_fileh]h bdev_file}(hj!hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjs!ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjo!ubjC)}(hstruct super_block *sbh](j )}(hjh]hstruct}(hj!hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj!ubj2)}(h h]h }(hj!hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj!ubh)}(hhh]jI)}(h super_blockh]h super_block}(hj"hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj"ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj "modnameN classnameNjj )}j ]j!c.fs_bdev_unregisterasbuh1hhj!ubj2)}(h h]h }(hj%"hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj!ubj)}(hjh]h*}(hj3"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubjI)}(hsbh]hsb}(hj@"hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj!ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjo!ubeh}(h]h ]h"]h$]h&]j`jauh1j<hj6!hhhjH!hMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj2!hhhjH!hMubah}(h]j-!ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjH!hMhj/!hhubjw)}(hhh]h)}(h+drop a superblock's claim on a block deviceh]h-drop a superblock’s claim on a block device}(hjj"hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhjg"hhubah}(h]h ]h"]h$]h&]uh1jvhj/!hhhjH!hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjj"jj"jjjuh1jhhhjwhNhNubj)}(hX(**Parameters** ``struct file *bdev_file`` file returned by fs_bdev_file_open_by_{dev,path}() ``struct super_block *sb`` superblock the device was claimed for **Description** The inverse of fs_bdev_register(): drop one claim on the {dev, **sb**} entry (the last claim unregisters it) without closing the device. A caller that must act on the still-open device between unregistering and closing - e.g. re-allow freezing one denied for a membership change - pairs this with bdev_fput(). fs_bdev_file_release() is the common unregister-and-close.h](h)}(h**Parameters**h]j)}(hj"h]h Parameters}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj"ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhj"ubj)}(hhh](j)}(hN``struct file *bdev_file`` file returned by fs_bdev_file_open_by_{dev,path}() h](j)}(h``struct file *bdev_file``h]j)}(hj"h]hstruct file *bdev_file}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj"ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhj"ubj)}(hhh]h)}(h2file returned by fs_bdev_file_open_by_{dev,path}()h]h2file returned by fs_bdev_file_open_by_{dev,path}()}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj"hMhj"ubah}(h]h ]h"]h$]h&]uh1jhj"ubeh}(h]h ]h"]h$]h&]uh1jhj"hMhj"ubj)}(hA``struct super_block *sb`` superblock the device was claimed for h](j)}(h``struct super_block *sb``h]j)}(hj"h]hstruct super_block *sb}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj"ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhj"ubj)}(hhh]h)}(h%superblock the device was claimed forh]h%superblock the device was claimed for}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj"hMhj"ubah}(h]h ]h"]h$]h&]uh1jhj"ubeh}(h]h ]h"]h$]h&]uh1jhj"hMhj"ubeh}(h]h ]h"]h$]h&]uh1jhj"ubh)}(h**Description**h]j)}(hj#h]h Description}(hj!#hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj#ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhj"ubh)}(hXrThe inverse of fs_bdev_register(): drop one claim on the {dev, **sb**} entry (the last claim unregisters it) without closing the device. A caller that must act on the still-open device between unregistering and closing - e.g. re-allow freezing one denied for a membership change - pairs this with bdev_fput(). fs_bdev_file_release() is the common unregister-and-close.h](h?The inverse of fs_bdev_register(): drop one claim on the {dev, }(hj5#hhhNhNubj)}(h**sb**h]hsb}(hj=#hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj5#ubhX-} entry (the last claim unregisters it) without closing the device. A caller that must act on the still-open device between unregistering and closing - e.g. re-allow freezing one denied for a membership change - pairs this with bdev_fput(). fs_bdev_file_release() is the common unregister-and-close.}(hj5#hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhj"ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjwhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j !fs_bdev_file_release (C function)c.fs_bdev_file_releasehNtauh1hhjwhhhNhNubj)}(hhh](j)}(hJvoid fs_bdev_file_release (struct file *bdev_file, struct super_block *sb)h]j)}(hIvoid fs_bdev_file_release(struct file *bdev_file, struct super_block *sb)h](j)}(hvoidh]hvoid}(hjv#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjr#hhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMubj2)}(h h]h }(hj#hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjr#hhhj#hMubjC)}(hfs_bdev_file_releaseh]jI)}(hfs_bdev_file_releaseh]hfs_bdev_file_release}(hj#hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj#ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjr#hhhj#hMubj=)}(h0(struct file *bdev_file, struct super_block *sb)h](jC)}(hstruct file *bdev_fileh](j )}(hjh]hstruct}(hj#hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj#ubj2)}(h h]h }(hj#hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj#ubh)}(hhh]jI)}(hfileh]hfile}(hj#hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj#ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj#modnameN classnameNjj )}j ]j)}jj#sbc.fs_bdev_file_releaseasbuh1hhj#ubj2)}(h h]h }(hj#hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj#ubj)}(hjh]h*}(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#ubjI)}(h bdev_fileh]h bdev_file}(hj $hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj#ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj#ubjC)}(hstruct super_block *sbh](j )}(hjh]hstruct}(hj%$hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj!$ubj2)}(h h]h }(hj2$hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj!$ubh)}(hhh]jI)}(h super_blockh]h super_block}(hjC$hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj@$ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjE$modnameN classnameNjj )}j ]j#c.fs_bdev_file_releaseasbuh1hhj!$ubj2)}(h h]h }(hja$hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj!$ubj)}(hjh]h*}(hjo$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!$ubjI)}(hsbh]hsb}(hj|$hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj!$ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj#ubeh}(h]h ]h"]h$]h&]j`jauh1j<hjr#hhhj#hMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjn#hhhj#hMubah}(h]ji#ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj#hMhjk#hhubjw)}(hhh]h)}(h/release a block device claimed for a superblockh]h/release a block device claimed for a superblock}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhj$hhubah}(h]h ]h"]h$]h&]uh1jvhjk#hhhj#hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjj$jj$jjjuh1jhhhjwhNhNubj)}(h**Parameters** ``struct file *bdev_file`` file returned by fs_bdev_file_open_by_{dev,path}() ``struct super_block *sb`` superblock the device was claimed for **Description** Unregister the {dev, **sb**} entry, then close the block device.h](h)}(h**Parameters**h]j)}(hj$h]h Parameters}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj$ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhj$ubj)}(hhh](j)}(hN``struct file *bdev_file`` file returned by fs_bdev_file_open_by_{dev,path}() h](j)}(h``struct file *bdev_file``h]j)}(hj$h]hstruct file *bdev_file}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj$ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhj$ubj)}(hhh]h)}(h2file returned by fs_bdev_file_open_by_{dev,path}()h]h2file returned by fs_bdev_file_open_by_{dev,path}()}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj$hMhj$ubah}(h]h ]h"]h$]h&]uh1jhj$ubeh}(h]h ]h"]h$]h&]uh1jhj$hMhj$ubj)}(hA``struct super_block *sb`` superblock the device was claimed for h](j)}(h``struct super_block *sb``h]j)}(hj %h]hstruct super_block *sb}(hj"%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj%ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhj%ubj)}(hhh]h)}(h%superblock the device was claimed forh]h%superblock the device was claimed for}(hj9%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj5%hMhj6%ubah}(h]h ]h"]h$]h&]uh1jhj%ubeh}(h]h ]h"]h$]h&]uh1jhj5%hMhj$ubeh}(h]h ]h"]h$]h&]uh1jhj$ubh)}(h**Description**h]j)}(hj[%h]h Description}(hj]%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjY%ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhj$ubh)}(h@Unregister the {dev, **sb**} entry, then close the block device.h](hUnregister the {dev, }(hjq%hhhNhNubj)}(h**sb**h]hsb}(hjy%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjq%ubh%} entry, then close the block device.}(hjq%hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhj$ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjwhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j  get_tree_bdev_flags (C function)c.get_tree_bdev_flagshNtauh1hhjwhhhNhNubj)}(hhh](j)}(hint get_tree_bdev_flags (struct fs_context *fc, int (*fill_super)(struct super_block *sb, struct fs_context *fc), unsigned int flags)h]j)}(hint get_tree_bdev_flags(struct fs_context *fc, int (*fill_super)(struct super_block *sb, struct fs_context *fc), unsigned int flags)h](j)}(hinth]hint}(hj%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%hhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMubj2)}(h h]h }(hj%hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj%hhhj%hMubjC)}(hget_tree_bdev_flagsh]jI)}(hget_tree_bdev_flagsh]hget_tree_bdev_flags}(hj%hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj%ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj%hhhj%hMubj=)}(hm(struct fs_context *fc, int (*fill_super)(struct super_block *sb, struct fs_context *fc), unsigned int flags)h](jC)}(hstruct fs_context *fch](j )}(hjh]hstruct}(hj%hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj%ubj2)}(h h]h }(hj%hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj%ubh)}(hhh]jI)}(h fs_contexth]h fs_context}(hj &hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj &ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj&modnameN classnameNjj )}j ]j)}jj%sbc.get_tree_bdev_flagsasbuh1hhj%ubj2)}(h h]h }(hj-&hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj%ubj)}(hjh]h*}(hj;&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%ubjI)}(hfch]hfc}(hjH&hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj%ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj%ubjC)}(h@int (*fill_super)(struct super_block *sb, struct fs_context *fc)h](j)}(hinth]hint}(hja&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj]&ubj2)}(h h]h }(hjo&hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj]&ubj)}(hjʥh]h(}(hj}&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj]&ubj)}(hjh]h*}(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj]&ubjI)}(h fill_superh]h fill_super}(hj&hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj]&ubj)}(hjh]h)}(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj]&ubj)}(hjʥh]h(}(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj]&ubj )}(hjh]hstruct}(hj&hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj]&ubj2)}(h h]h }(hj&hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj]&ubh)}(hhh]jI)}(h super_blockh]h super_block}(hj&hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj&ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj&modnameN classnameNjj )}j ]j)&c.get_tree_bdev_flagsasbuh1hhj]&ubj2)}(h h]h }(hj&hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj]&ubj)}(hjh]h*}(hj 'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj]&ubjI)}(hsbh]hsb}(hj'hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj]&ubj)}(hjWh]h,}(hj$'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj]&ubj2)}(h h]h }(hj1'hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj]&ubj )}(hjh]hstruct}(hj?'hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj]&ubj2)}(h h]h }(hjL'hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj]&ubh)}(hhh]jI)}(h fs_contexth]h fs_context}(hj]'hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjZ'ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj_'modnameN classnameNjj )}j ]j)&c.get_tree_bdev_flagsasbuh1hhj]&ubj2)}(h h]h }(hj{'hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj]&ubj)}(hjh]h*}(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj]&ubjI)}(hfch]hfc}(hj'hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj]&ubj)}(hjh]h)}(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj]&ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj%ubjC)}(hunsigned int flagsh](j)}(hunsignedh]hunsigned}(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj'ubj2)}(h h]h }(hj'hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj'ubj)}(hinth]hint}(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj'ubj2)}(h h]h }(hj'hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj'ubjI)}(hflagsh]hflags}(hj'hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj'ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj%ubeh}(h]h ]h"]h$]h&]j`jauh1j<hj%hhhj%hMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj%hhhj%hMubah}(h]j%ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj%hMhj%hhubjw)}(hhh]h)}(h/Get a superblock based on a single block deviceh]h/Get a superblock based on a single block device}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhj(hhubah}(h]h ]h"]h$]h&]uh1jvhj%hhhj%hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjj6(jj6(jjjuh1jhhhjwhNhNubj)}(h**Parameters** ``struct fs_context *fc`` The filesystem context holding the parameters ``int (*fill_super)(struct super_block *sb, struct fs_context *fc)`` Helper to initialise a new superblock ``unsigned int flags`` GET_TREE_BDEV_* flagsh](h)}(h**Parameters**h]j)}(hj@(h]h Parameters}(hjB(hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj>(ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhj:(ubj)}(hhh](j)}(hH``struct fs_context *fc`` The filesystem context holding the parameters h](j)}(h``struct fs_context *fc``h]j)}(hj_(h]hstruct fs_context *fc}(hja(hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj](ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhjY(ubj)}(hhh]h)}(h-The filesystem context holding the parametersh]h-The filesystem context holding the parameters}(hjx(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjt(hMhju(ubah}(h]h ]h"]h$]h&]uh1jhjY(ubeh}(h]h ]h"]h$]h&]uh1jhjt(hMhjV(ubj)}(hk``int (*fill_super)(struct super_block *sb, struct fs_context *fc)`` Helper to initialise a new superblock h](j)}(hD``int (*fill_super)(struct super_block *sb, struct fs_context *fc)``h]j)}(hj(h]h@int (*fill_super)(struct super_block *sb, struct fs_context *fc)}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj(ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhj(ubj)}(hhh]h)}(h%Helper to initialise a new superblockh]h%Helper to initialise a new superblock}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj(hMhj(ubah}(h]h ]h"]h$]h&]uh1jhj(ubeh}(h]h ]h"]h$]h&]uh1jhj(hMhjV(ubj)}(h,``unsigned int flags`` GET_TREE_BDEV_* flagsh](j)}(h``unsigned int flags``h]j)}(hj(h]hunsigned int flags}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj(ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhj(ubj)}(hhh]h)}(hGET_TREE_BDEV_* flagsh]hGET_TREE_BDEV_* flags}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhj(ubah}(h]h ]h"]h$]h&]uh1jhj(ubeh}(h]h ]h"]h$]h&]uh1jhj(hMhjV(ubeh}(h]h ]h"]h$]h&]uh1jhj:(ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjwhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j get_tree_bdev (C function)c.get_tree_bdevhNtauh1hhjwhhhNhNubj)}(hhh](j)}(hgint get_tree_bdev (struct fs_context *fc, int (*fill_super)(struct super_block *, struct fs_context *))h]j)}(hdint get_tree_bdev(struct fs_context *fc, int (*fill_super)(struct super_block*, struct fs_context*))h](j)}(hinth]hint}(hj+)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj')hhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chM,ubj2)}(h h]h }(hj:)hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj')hhhj9)hM,ubjC)}(h get_tree_bdevh]jI)}(h get_tree_bdevh]h get_tree_bdev}(hjL)hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjH)ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj')hhhj9)hM,ubj=)}(hS(struct fs_context *fc, int (*fill_super)(struct super_block*, struct fs_context*))h](jC)}(hstruct fs_context *fch](j )}(hjh]hstruct}(hjh)hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjd)ubj2)}(h h]h }(hju)hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjd)ubh)}(hhh]jI)}(h fs_contexth]h fs_context}(hj)hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj)ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj)modnameN classnameNjj )}j ]j)}jjN)sbc.get_tree_bdevasbuh1hhjd)ubj2)}(h h]h }(hj)hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjd)ubj)}(hjh]h*}(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjd)ubjI)}(hfch]hfc}(hj)hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjd)ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj`)ubjC)}(h:int (*fill_super)(struct super_block*, struct fs_context*)h](j)}(hinth]hint}(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubj2)}(h h]h }(hj)hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj)ubj)}(hjʥh]h(}(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubj)}(hjh]h*}(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubjI)}(h fill_superh]h fill_super}(hj*hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj)ubj)}(hjh]h)}(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubj)}(hjʥh]h(}(hj+*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubj )}(hjh]hstruct}(hj8*hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj)ubj2)}(h h]h }(hjE*hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj)ubh)}(hhh]jI)}(h super_blockh]h super_block}(hjV*hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjS*ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjX*modnameN classnameNjj )}j ]j)c.get_tree_bdevasbuh1hhj)ubj)}(hjh]h*}(hjt*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubj)}(hjWh]h,}(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubj2)}(h h]h }(hj*hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj)ubj )}(hjh]hstruct}(hj*hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj)ubj2)}(h h]h }(hj*hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj)ubh)}(hhh]jI)}(h fs_contexth]h fs_context}(hj*hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj*ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj*modnameN classnameNjj )}j ]j)c.get_tree_bdevasbuh1hhj)ubj)}(hjh]h*}(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubj)}(hjh]h)}(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj`)ubeh}(h]h ]h"]h$]h&]j`jauh1j<hj')hhhj9)hM,ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj#)hhhj9)hM,ubah}(h]j)ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj9)hM,hj )hhubjw)}(hhh]h)}(h/Get a superblock based on a single block deviceh]h/Get a superblock based on a single block device}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chM,hj +hhubah}(h]h ]h"]h$]h&]uh1jvhj )hhhj9)hM,ubeh}(h]h ](jfunctioneh"]h$]h&]jjjj&+jj&+jjjuh1jhhhjwhNhNubj)}(h**Parameters** ``struct fs_context *fc`` The filesystem context holding the parameters ``int (*fill_super)(struct super_block *, struct fs_context *)`` Helper to initialise a new superblockh](h)}(h**Parameters**h]j)}(hj0+h]h Parameters}(hj2+hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj.+ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chM0hj*+ubj)}(hhh](j)}(hH``struct fs_context *fc`` The filesystem context holding the parameters h](j)}(h``struct fs_context *fc``h]j)}(hjO+h]hstruct fs_context *fc}(hjQ+hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjM+ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chM-hjI+ubj)}(hhh]h)}(h-The filesystem context holding the parametersh]h-The filesystem context holding the parameters}(hjh+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjd+hM-hje+ubah}(h]h ]h"]h$]h&]uh1jhjI+ubeh}(h]h ]h"]h$]h&]uh1jhjd+hM-hjF+ubj)}(hf``int (*fill_super)(struct super_block *, struct fs_context *)`` Helper to initialise a new superblockh](j)}(h@``int (*fill_super)(struct super_block *, struct fs_context *)``h]j)}(hj+h]hah"]h$]h&]uh1j1hj+hhhj+hMGubjC)}(h vfs_get_treeh]jI)}(h vfs_get_treeh]h vfs_get_tree}(hj,hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj+ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj+hhhj+hMGubj=)}(h(struct fs_context *fc)h]jC)}(hstruct fs_context *fch](j )}(hjh]hstruct}(hj,hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj,ubj2)}(h h]h }(hj,,hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj,ubh)}(hhh]jI)}(h fs_contexth]h fs_context}(hj=,hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj:,ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj?,modnameN classnameNjj )}j ]j)}jj,sbc.vfs_get_treeasbuh1hhj,ubj2)}(h h]h }(hj],hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj,ubj)}(hjh]h*}(hjk,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,ubjI)}(hfch]hfc}(hjx,hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj,ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj,ubah}(h]h ]h"]h$]h&]j`jauh1j<hj+hhhj+hMGubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj+hhhj+hMGubah}(h]j+ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj+hMGhj+hhubjw)}(hhh]h)}(hGet the mountable rooth]hGet the mountable root}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMGhj,hhubah}(h]h ]h"]h$]h&]uh1jvhj+hhhj+hMGubeh}(h]h ](jfunctioneh"]h$]h&]jjjj,jj,jjjuh1jhhhjwhNhNubj)}(hX**Parameters** ``struct fs_context *fc`` The superblock configuration context. **Description** The filesystem is invoked to get or create a superblock which can then later be used for mounting. The filesystem places a pointer to the root to be used for mounting in **fc->root**.h](h)}(h**Parameters**h]j)}(hj,h]h Parameters}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj,ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMKhj,ubj)}(hhh]j)}(h@``struct fs_context *fc`` The superblock configuration context. h](j)}(h``struct fs_context *fc``h]j)}(hj,h]hstruct fs_context *fc}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj,ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMHhj,ubj)}(hhh]h)}(h%The superblock configuration context.h]h%The superblock configuration context.}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj,hMHhj,ubah}(h]h ]h"]h$]h&]uh1jhj,ubeh}(h]h ]h"]h$]h&]uh1jhj,hMHhj,ubah}(h]h ]h"]h$]h&]uh1jhj,ubh)}(h**Description**h]j)}(hj-h]h Description}(hj -hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj-ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMJhj,ubh)}(hThe filesystem is invoked to get or create a superblock which can then later be used for mounting. The filesystem places a pointer to the root to be used for mounting in **fc->root**.h](hThe filesystem is invoked to get or create a superblock which can then later be used for mounting. The filesystem places a pointer to the root to be used for mounting in }(hj4-hhhNhNubj)}(h **fc->root**h]hfc->root}(hj<-hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj4-ubh.}(hj4-hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMIhj,ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjwhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j freeze_super (C function)c.freeze_superhNtauh1hhjwhhhNhNubj)}(hhh](j)}(h[int freeze_super (struct super_block *sb, enum freeze_holder who, const void *freeze_owner)h]j)}(hZint freeze_super(struct super_block *sb, enum freeze_holder who, const void *freeze_owner)h](j)}(hinth]hint}(hju-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjq-hhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chM^ubj2)}(h h]h }(hj-hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjq-hhhj-hM^ubjC)}(h freeze_superh]jI)}(h freeze_superh]h freeze_super}(hj-hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj-ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjq-hhhj-hM^ubj=)}(hJ(struct super_block *sb, enum freeze_holder who, const void *freeze_owner)h](jC)}(hstruct super_block *sbh](j )}(hjh]hstruct}(hj-hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj-ubj2)}(h h]h }(hj-hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj-ubh)}(hhh]jI)}(h super_blockh]h super_block}(hj-hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj-ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj-modnameN classnameNjj )}j ]j)}jj-sbc.freeze_superasbuh1hhj-ubj2)}(h h]h }(hj-hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj-ubj)}(hjh]h*}(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-ubjI)}(hsbh]hsb}(hj .hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj-ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj-ubjC)}(henum freeze_holder whoh](j )}(hj#h]henum}(hj$.hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj .ubj2)}(h h]h }(hj1.hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj .ubh)}(hhh]jI)}(h freeze_holderh]h freeze_holder}(hjB.hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj?.ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjD.modnameN classnameNjj )}j ]j-c.freeze_superasbuh1hhj .ubj2)}(h h]h }(hj`.hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj .ubjI)}(hwhoh]hwho}(hjn.hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj .ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj-ubjC)}(hconst void *freeze_ownerh](j )}(hjJh]hconst}(hj.hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj.ubj2)}(h h]h }(hj.hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj.ubj)}(hvoidh]hvoid}(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj.ubj2)}(h h]h }(hj.hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj.ubj)}(hjh]h*}(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj.ubjI)}(h freeze_ownerh]h freeze_owner}(hj.hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj.ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj-ubeh}(h]h ]h"]h$]h&]j`jauh1j<hjq-hhhj-hM^ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjm-hhhj-hM^ubah}(h]jh-ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj-hM^hjj-hhubjw)}(hhh]h)}(h8lock the filesystem and force it into a consistent stateh]h8lock the filesystem and force it into a consistent state}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chM^hj.hhubah}(h]h ]h"]h$]h&]uh1jvhjj-hhhj-hM^ubeh}(h]h ](jfunctioneh"]h$]h&]jjjj /jj /jjjuh1jhhhjwhNhNubj)}(hX **Parameters** ``struct super_block *sb`` the super to lock ``enum freeze_holder who`` context that wants to freeze ``const void *freeze_owner`` owner of the freeze **Description** Syncs the super to make sure the filesystem is consistent and calls the fs's freeze_fs. Subsequent calls to this without first thawing the fs may return -EBUSY. **who** should be: * ``FREEZE_HOLDER_USERSPACE`` if userspace wants to freeze the fs; * ``FREEZE_HOLDER_KERNEL`` if the kernel wants to freeze the fs. * ``FREEZE_MAY_NEST`` whether nesting freeze and thaw requests is allowed. The **who** argument distinguishes between the kernel and userspace trying to freeze the filesystem. Although there cannot be multiple kernel freezes or multiple userspace freezes in effect at any given time, the kernel and userspace can both hold a filesystem frozen. The filesystem remains frozen until there are no kernel or userspace freezes in effect. A filesystem may hold multiple devices and thus a filesystems may be frozen through the block layer via multiple block devices. In this case the request is marked as being allowed to nest by passing FREEZE_MAY_NEST. The filesystem remains frozen until all block devices are unfrozen. If multiple freezes are attempted without FREEZE_MAY_NEST -EBUSY will be returned. During this function, sb->s_writers.frozen goes through these values: SB_UNFROZEN: File system is normal, all writes progress as usual. SB_FREEZE_WRITE: The file system is in the process of being frozen. New writes should be blocked, though page faults are still allowed. We wait for all writes to complete and then proceed to the next stage. SB_FREEZE_PAGEFAULT: Freezing continues. Now also page faults are blocked but internal fs threads can still modify the filesystem (although they should not dirty new pages or inodes), writeback can run etc. After waiting for all running page faults we sync the filesystem which will clean all dirty pages and inodes (no new dirty pages or inodes can be created when sync is running). SB_FREEZE_FS: The file system is frozen. Now all internal sources of fs modification are blocked (e.g. XFS preallocation truncation on inode reclaim). This is usually implemented by blocking new transactions for filesystems that have them and need this additional guard. After all internal writers are finished we call ->freeze_fs() to finish filesystem freezing. Then we transition to SB_FREEZE_COMPLETE state. This state is mostly auxiliary for filesystems to verify they do not modify frozen fs. sb->s_writers.frozen is protected by sb->s_umount. **Return** If the freeze was successful zero is returned. If the freeze failed a negative error code is returned.h](h)}(h**Parameters**h]j)}(hj/h]h Parameters}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj/ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMbhj/ubj)}(hhh](j)}(h-``struct super_block *sb`` the super to lock h](j)}(h``struct super_block *sb``h]j)}(hj6/h]hstruct super_block *sb}(hj8/hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj4/ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chM_hj0/ubj)}(hhh]h)}(hthe super to lockh]hthe super to lock}(hjO/hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjK/hM_hjL/ubah}(h]h ]h"]h$]h&]uh1jhj0/ubeh}(h]h ]h"]h$]h&]uh1jhjK/hM_hj-/ubj)}(h8``enum freeze_holder who`` context that wants to freeze h](j)}(h``enum freeze_holder who``h]j)}(hjo/h]henum freeze_holder who}(hjq/hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjm/ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chM`hji/ubj)}(hhh]h)}(hcontext that wants to freezeh]hcontext that wants to freeze}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/hM`hj/ubah}(h]h ]h"]h$]h&]uh1jhji/ubeh}(h]h ]h"]h$]h&]uh1jhj/hM`hj-/ubj)}(h1``const void *freeze_owner`` owner of the freeze h](j)}(h``const void *freeze_owner``h]j)}(hj/h]hconst void *freeze_owner}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj/ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMahj/ubj)}(hhh]h)}(howner of the freezeh]howner of the freeze}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/hMahj/ubah}(h]h ]h"]h$]h&]uh1jhj/ubeh}(h]h ]h"]h$]h&]uh1jhj/hMahj-/ubeh}(h]h ]h"]h$]h&]uh1jhj/ubh)}(h**Description**h]j)}(hj/h]h Description}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj/ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMchj/ubh)}(hSyncs the super to make sure the filesystem is consistent and calls the fs's freeze_fs. Subsequent calls to this without first thawing the fs may return -EBUSY.h]hSyncs the super to make sure the filesystem is consistent and calls the fs’s freeze_fs. Subsequent calls to this without first thawing the fs may return -EBUSY.}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMbhj/ubh)}(h**who** should be: * ``FREEZE_HOLDER_USERSPACE`` if userspace wants to freeze the fs; * ``FREEZE_HOLDER_KERNEL`` if the kernel wants to freeze the fs. * ``FREEZE_MAY_NEST`` whether nesting freeze and thaw requests is allowed.h](j)}(h**who**h]hwho}(hj 0hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj0ubh should be: * }(hj0hhhNhNubj)}(h``FREEZE_HOLDER_USERSPACE``h]hFREEZE_HOLDER_USERSPACE}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj0ubh( if userspace wants to freeze the fs; * }(hj0hhhNhNubj)}(h``FREEZE_HOLDER_KERNEL``h]hFREEZE_HOLDER_KERNEL}(hj00hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj0ubh) if the kernel wants to freeze the fs. * }(hj0hhhNhNubj)}(h``FREEZE_MAY_NEST``h]hFREEZE_MAY_NEST}(hjB0hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj0ubh5 whether nesting freeze and thaw requests is allowed.}(hj0hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMfhj/ubh)}(hXfThe **who** argument distinguishes between the kernel and userspace trying to freeze the filesystem. Although there cannot be multiple kernel freezes or multiple userspace freezes in effect at any given time, the kernel and userspace can both hold a filesystem frozen. The filesystem remains frozen until there are no kernel or userspace freezes in effect.h](hThe }(hj[0hhhNhNubj)}(h**who**h]hwho}(hjc0hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj[0ubhX[ argument distinguishes between the kernel and userspace trying to freeze the filesystem. Although there cannot be multiple kernel freezes or multiple userspace freezes in effect at any given time, the kernel and userspace can both hold a filesystem frozen. The filesystem remains frozen until there are no kernel or userspace freezes in effect.}(hj[0hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMkhj/ubh)}(hXnA filesystem may hold multiple devices and thus a filesystems may be frozen through the block layer via multiple block devices. In this case the request is marked as being allowed to nest by passing FREEZE_MAY_NEST. The filesystem remains frozen until all block devices are unfrozen. If multiple freezes are attempted without FREEZE_MAY_NEST -EBUSY will be returned.h]hXnA filesystem may hold multiple devices and thus a filesystems may be frozen through the block layer via multiple block devices. In this case the request is marked as being allowed to nest by passing FREEZE_MAY_NEST. The filesystem remains frozen until all block devices are unfrozen. If multiple freezes are attempted without FREEZE_MAY_NEST -EBUSY will be returned.}(hj|0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMqhj/ubh)}(hEDuring this function, sb->s_writers.frozen goes through these values:h]hEDuring this function, sb->s_writers.frozen goes through these values:}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMxhj/ubh)}(hASB_UNFROZEN: File system is normal, all writes progress as usual.h]hASB_UNFROZEN: File system is normal, all writes progress as usual.}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMzhj/ubh)}(hSB_FREEZE_WRITE: The file system is in the process of being frozen. New writes should be blocked, though page faults are still allowed. We wait for all writes to complete and then proceed to the next stage.h]hSB_FREEZE_WRITE: The file system is in the process of being frozen. New writes should be blocked, though page faults are still allowed. We wait for all writes to complete and then proceed to the next stage.}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chM|hj/ubh)}(hXSB_FREEZE_PAGEFAULT: Freezing continues. Now also page faults are blocked but internal fs threads can still modify the filesystem (although they should not dirty new pages or inodes), writeback can run etc. After waiting for all running page faults we sync the filesystem which will clean all dirty pages and inodes (no new dirty pages or inodes can be created when sync is running).h]hXSB_FREEZE_PAGEFAULT: Freezing continues. Now also page faults are blocked but internal fs threads can still modify the filesystem (although they should not dirty new pages or inodes), writeback can run etc. After waiting for all running page faults we sync the filesystem which will clean all dirty pages and inodes (no new dirty pages or inodes can be created when sync is running).}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhj/ubh)}(hXSB_FREEZE_FS: The file system is frozen. Now all internal sources of fs modification are blocked (e.g. XFS preallocation truncation on inode reclaim). This is usually implemented by blocking new transactions for filesystems that have them and need this additional guard. After all internal writers are finished we call ->freeze_fs() to finish filesystem freezing. Then we transition to SB_FREEZE_COMPLETE state. This state is mostly auxiliary for filesystems to verify they do not modify frozen fs.h]hXSB_FREEZE_FS: The file system is frozen. Now all internal sources of fs modification are blocked (e.g. XFS preallocation truncation on inode reclaim). This is usually implemented by blocking new transactions for filesystems that have them and need this additional guard. After all internal writers are finished we call ->freeze_fs() to finish filesystem freezing. Then we transition to SB_FREEZE_COMPLETE state. This state is mostly auxiliary for filesystems to verify they do not modify frozen fs.}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhj/ubh)}(h2sb->s_writers.frozen is protected by sb->s_umount.h]h2sb->s_writers.frozen is protected by sb->s_umount.}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhj/ubh)}(h **Return**h]j)}(hj0h]hReturn}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj0ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhj/ubh)}(hfIf the freeze was successful zero is returned. If the freeze failed a negative error code is returned.h]hfIf the freeze was successful zero is returned. If the freeze failed a negative error code is returned.}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chMhj/ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjwhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j thaw_super (C function) c.thaw_superhNtauh1hhjwhhhNhNubj)}(hhh](j)}(hYint thaw_super (struct super_block *sb, enum freeze_holder who, const void *freeze_owner)h]j)}(hXint thaw_super(struct super_block *sb, enum freeze_holder who, const void *freeze_owner)h](j)}(hinth]hint}(hj,1hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(1hhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chM, ubj2)}(h h]h }(hj;1hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj(1hhhj:1hM, ubjC)}(h thaw_superh]jI)}(h thaw_superh]h thaw_super}(hjM1hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjI1ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj(1hhhj:1hM, ubj=)}(hJ(struct super_block *sb, enum freeze_holder who, const void *freeze_owner)h](jC)}(hstruct super_block *sbh](j )}(hjh]hstruct}(hji1hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhje1ubj2)}(h h]h }(hjv1hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hje1ubh)}(hhh]jI)}(h super_blockh]h super_block}(hj1hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj1ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj1modnameN classnameNjj )}j ]j)}jjO1sb c.thaw_superasbuh1hhje1ubj2)}(h h]h }(hj1hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hje1ubj)}(hjh]h*}(hj1hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhje1ubjI)}(hsbh]hsb}(hj1hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhje1ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhja1ubjC)}(henum freeze_holder whoh](j )}(hj#h]henum}(hj1hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj1ubj2)}(h h]h }(hj1hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj1ubh)}(hhh]jI)}(h freeze_holderh]h freeze_holder}(hj1hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj1ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj1modnameN classnameNjj )}j ]j1 c.thaw_superasbuh1hhj1ubj2)}(h h]h }(hj2hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj1ubjI)}(hwhoh]hwho}(hj%2hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj1ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhja1ubjC)}(hconst void *freeze_ownerh](j )}(hjJh]hconst}(hj>2hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj:2ubj2)}(h h]h }(hjK2hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj:2ubj)}(hvoidh]hvoid}(hjY2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:2ubj2)}(h h]h }(hjg2hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj:2ubj)}(hjh]h*}(hju2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:2ubjI)}(h freeze_ownerh]h freeze_owner}(hj2hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj:2ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhja1ubeh}(h]h ]h"]h$]h&]j`jauh1j<hj(1hhhj:1hM, ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj$1hhhj:1hM, ubah}(h]j1ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj:1hM, hj!1hhubjw)}(hhh]jE)}(hhh]jE)}(hunlock filesystemh]h)}(hj2h]hunlock filesystem}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chM, hj2ubah}(h]h ]h"]h$]h&]uh1jEhj2hhhj2hNubah}(h]h ]h"]h$]h&]jE-uh1jEhj2hM, hj2hhubah}(h]h ]h"]h$]h&]uh1jvhj!1hhhj:1hM, ubeh}(h]h ](jfunctioneh"]h$]h&]jjjj2jj2jjjuh1jhhhjwhNhNubj)}(hX**Parameters** ``struct super_block *sb`` the super to thaw ``enum freeze_holder who`` context that wants to freeze ``const void *freeze_owner`` owner of the freeze **Description** Unlocks the filesystem and marks it writeable again after freeze_super() if there are no remaining freezes on the filesystem. **who** should be: * ``FREEZE_HOLDER_USERSPACE`` if userspace wants to thaw the fs; * ``FREEZE_HOLDER_KERNEL`` if the kernel wants to thaw the fs. * ``FREEZE_MAY_NEST`` whether nesting freeze and thaw requests is allowed A filesystem may hold multiple devices and thus a filesystems may have been frozen through the block layer via multiple block devices. The filesystem remains frozen until all block devices are unfrozen.h](h)}(h**Parameters**h]j)}(hj2h]h Parameters}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj2ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chM0 hj2ubj)}(hhh](j)}(h-``struct super_block *sb`` the super to thaw h](j)}(h``struct super_block *sb``h]j)}(hj3h]hstruct super_block *sb}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj2ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chM- hj2ubj)}(hhh]h)}(hthe super to thawh]hthe super to thaw}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj3hM- hj3ubah}(h]h ]h"]h$]h&]uh1jhj2ubeh}(h]h ]h"]h$]h&]uh1jhj3hM- hj2ubj)}(h8``enum freeze_holder who`` context that wants to freeze h](j)}(h``enum freeze_holder who``h]j)}(hj93h]henum freeze_holder who}(hj;3hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj73ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chM. hj33ubj)}(hhh]h)}(hcontext that wants to freezeh]hcontext that wants to freeze}(hjR3hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjN3hM. hjO3ubah}(h]h ]h"]h$]h&]uh1jhj33ubeh}(h]h ]h"]h$]h&]uh1jhjN3hM. hj2ubj)}(h1``const void *freeze_owner`` owner of the freeze h](j)}(h``const void *freeze_owner``h]j)}(hjr3h]hconst void *freeze_owner}(hjt3hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjp3ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chM/ hjl3ubj)}(hhh]h)}(howner of the freezeh]howner of the freeze}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj3hM/ hj3ubah}(h]h ]h"]h$]h&]uh1jhjl3ubeh}(h]h ]h"]h$]h&]uh1jhj3hM/ hj2ubeh}(h]h ]h"]h$]h&]uh1jhj2ubh)}(h**Description**h]j)}(hj3h]h Description}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj3ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chM1 hj2ubh)}(h}Unlocks the filesystem and marks it writeable again after freeze_super() if there are no remaining freezes on the filesystem.h]h}Unlocks the filesystem and marks it writeable again after freeze_super() if there are no remaining freezes on the filesystem.}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chM0 hj2ubh)}(h**who** should be: * ``FREEZE_HOLDER_USERSPACE`` if userspace wants to thaw the fs; * ``FREEZE_HOLDER_KERNEL`` if the kernel wants to thaw the fs. * ``FREEZE_MAY_NEST`` whether nesting freeze and thaw requests is allowedh](j)}(h**who**h]hwho}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj3ubh should be: * }(hj3hhhNhNubj)}(h``FREEZE_HOLDER_USERSPACE``h]hFREEZE_HOLDER_USERSPACE}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj3ubh& if userspace wants to thaw the fs; * }(hj3hhhNhNubj)}(h``FREEZE_HOLDER_KERNEL``h]hFREEZE_HOLDER_KERNEL}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj3ubh' if the kernel wants to thaw the fs. * }(hj3hhhNhNubj)}(h``FREEZE_MAY_NEST``h]hFREEZE_MAY_NEST}(hj 4hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj3ubh4 whether nesting freeze and thaw requests is allowed}(hj3hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chM3 hj2ubh)}(hA filesystem may hold multiple devices and thus a filesystems may have been frozen through the block layer via multiple block devices. The filesystem remains frozen until all block devices are unfrozen.h]hA filesystem may hold multiple devices and thus a filesystems may have been frozen through the block layer via multiple block devices. The filesystem remains frozen until all block devices are unfrozen.}(hj%4hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:38: ./fs/super.chM8 hj2ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjwhhhNhNubeh}(h]registration-and-superblocksah ]h"]registration and superblocksah$]h&]uh1hhhhhhhhK$ubh)}(hhh](h)}(h File Locksh]h File Locks}(hjF4hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjC4hhhhhK*ubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j %locks_owner_has_blockers (C function)c.locks_owner_has_blockershNtauh1hhjC4hhhNhNubj)}(hhh](j)}(hQbool locks_owner_has_blockers (struct file_lock_context *flctx, fl_owner_t owner)h]j)}(hPbool locks_owner_has_blockers(struct file_lock_context *flctx, fl_owner_t owner)h](j)}(hjh]hbool}(hjm4hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhji4hhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chMMubj2)}(h h]h }(hj{4hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hji4hhhjz4hMMubjC)}(hlocks_owner_has_blockersh]jI)}(hlocks_owner_has_blockersh]hlocks_owner_has_blockers}(hj4hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj4ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhji4hhhjz4hMMubj=)}(h3(struct file_lock_context *flctx, fl_owner_t owner)h](jC)}(hstruct file_lock_context *flctxh](j )}(hjh]hstruct}(hj4hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj4ubj2)}(h h]h }(hj4hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj4ubh)}(hhh]jI)}(hfile_lock_contexth]hfile_lock_context}(hj4hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj4ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj4modnameN classnameNjj )}j ]j)}jj4sbc.locks_owner_has_blockersasbuh1hhj4ubj2)}(h h]h }(hj4hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj4ubj)}(hjh]h*}(hj4hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4ubjI)}(hflctxh]hflctx}(hj5hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj4ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj4ubjC)}(hfl_owner_t ownerh](h)}(hhh]jI)}(h fl_owner_th]h fl_owner_t}(hj5hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj5ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj 5modnameN classnameNjj )}j ]j4c.locks_owner_has_blockersasbuh1hhj5ubj2)}(h h]h }(hj<5hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj5ubjI)}(hownerh]howner}(hjJ5hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj5ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj4ubeh}(h]h ]h"]h$]h&]j`jauh1j<hji4hhhjz4hMMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhje4hhhjz4hMMubah}(h]j`4ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjz4hMMhjb4hhubjw)}(hhh]h)}(h Check for blocking lock requestsh]h Check for blocking lock requests}(hjt5hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chMMhjq5hhubah}(h]h ]h"]h$]h&]uh1jvhjb4hhhjz4hMMubeh}(h]h ](jfunctioneh"]h$]h&]jjjj5jj5jjjuh1jhhhjC4hNhNubj)}(h**Parameters** ``struct file_lock_context *flctx`` file lock context ``fl_owner_t owner`` lock owner **Description** Return values: ``true``: **owner** has at least one blocker ``false``: **owner** has no blockersh](h)}(h**Parameters**h]j)}(hj5h]h Parameters}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj5ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chMQhj5ubj)}(hhh](j)}(h6``struct file_lock_context *flctx`` file lock context h](j)}(h#``struct file_lock_context *flctx``h]j)}(hj5h]hstruct file_lock_context *flctx}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj5ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chMNhj5ubj)}(hhh]h)}(hfile lock contexth]hfile lock context}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj5hMNhj5ubah}(h]h ]h"]h$]h&]uh1jhj5ubeh}(h]h ]h"]h$]h&]uh1jhj5hMNhj5ubj)}(h ``fl_owner_t owner`` lock owner h](j)}(h``fl_owner_t owner``h]j)}(hj5h]hfl_owner_t owner}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj5ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chMOhj5ubj)}(hhh]h)}(h lock ownerh]h lock owner}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj6hMOhj6ubah}(h]h ]h"]h$]h&]uh1jhj5ubeh}(h]h ]h"]h$]h&]uh1jhj6hMOhj5ubeh}(h]h ]h"]h$]h&]uh1jhj5ubh)}(h**Description**h]j)}(hj)6h]h Description}(hj+6hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj'6ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chMQhj5ubj)}(hhh]j)}(h`Return values: ``true``: **owner** has at least one blocker ``false``: **owner** has no blockersh](j)}(hReturn values:h]hReturn values:}(hjF6hhhNhNubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chMQhjB6ubj)}(hhh]h)}(hQ``true``: **owner** has at least one blocker ``false``: **owner** has no blockersh](j)}(h``true``h]htrue}(hj\6hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjX6ubh: }(hjX6hhhNhNubj)}(h **owner**h]howner}(hjn6hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjX6ubh has at least one blocker }(hjX6hhhNhNubj)}(h ``false``h]hfalse}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjX6ubh: }hjX6sbj)}(h **owner**h]howner}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjX6ubh has no blockers}(hjX6hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjT6hMQhjU6ubah}(h]h ]h"]h$]h&]uh1jhjB6ubeh}(h]h ]h"]h$]h&]uh1jhjT6hMQhj?6ubah}(h]h ]h"]h$]h&]uh1jhj5ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjC4hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j locks_delete_block (C function)c.locks_delete_blockhNtauh1hhjC4hhhNhNubj)}(hhh](j)}(h1int locks_delete_block (struct file_lock *waiter)h]j)}(h0int locks_delete_block(struct file_lock *waiter)h](j)}(hinth]hint}(hj6hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj6hhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chM>ubj2)}(h h]h }(hj6hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj6hhhj6hM>ubjC)}(hlocks_delete_blockh]jI)}(hlocks_delete_blockh]hlocks_delete_block}(hj6hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj6ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj6hhhj6hM>ubj=)}(h(struct file_lock *waiter)h]jC)}(hstruct file_lock *waiterh](j )}(hjh]hstruct}(hj7hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj7ubj2)}(h h]h }(hj&7hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj7ubh)}(hhh]jI)}(h file_lockh]h file_lock}(hj77hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj47ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj97modnameN classnameNjj )}j ]j)}jj6sbc.locks_delete_blockasbuh1hhj7ubj2)}(h h]h }(hjW7hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj7ubj)}(hjh]h*}(hje7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7ubjI)}(hwaiterh]hwaiter}(hjr7hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj7ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj7ubah}(h]h ]h"]h$]h&]j`jauh1j<hj6hhhj6hM>ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj6hhhj6hM>ubah}(h]j6ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj6hM>hj6hhubjw)}(hhh]h)}(hstop waiting for a file lockh]hstop waiting for a file lock}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chM>hj7hhubah}(h]h ]h"]h$]h&]uh1jvhj6hhhj6hM>ubeh}(h]h ](jfunctioneh"]h$]h&]jjjj7jj7jjjuh1jhhhjC4hNhNubj)}(h**Parameters** ``struct file_lock *waiter`` the lock which was waiting **Description** lockd/nfsd need to disconnect the lock while working on it.h](h)}(h**Parameters**h]j)}(hj7h]h Parameters}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj7ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chMBhj7ubj)}(hhh]j)}(h8``struct file_lock *waiter`` the lock which was waiting h](j)}(h``struct file_lock *waiter``h]j)}(hj7h]hstruct file_lock *waiter}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj7ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chM?hj7ubj)}(hhh]h)}(hthe lock which was waitingh]hthe lock which was waiting}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj7hM?hj7ubah}(h]h ]h"]h$]h&]uh1jhj7ubeh}(h]h ]h"]h$]h&]uh1jhj7hM?hj7ubah}(h]h ]h"]h$]h&]uh1jhj7ubh)}(h**Description**h]j)}(hj8h]h Description}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj8ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chMAhj7ubj)}(h;lockd/nfsd need to disconnect the lock while working on it.h]h)}(hj08h]h;lockd/nfsd need to disconnect the lock while working on it.}(hj28hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chM@hj.8ubah}(h]h ]h"]h$]h&]uh1jhj?8hM@hj7ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjC4hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j posix_lock_file (C function)c.posix_lock_filehNtauh1hhjC4hhhNhNubj)}(hhh](j)}(hYint posix_lock_file (struct file *filp, struct file_lock *fl, struct file_lock *conflock)h]j)}(hXint posix_lock_file(struct file *filp, struct file_lock *fl, struct file_lock *conflock)h](j)}(hinth]hint}(hjf8hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjb8hhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chMubj2)}(h h]h }(hju8hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjb8hhhjt8hMubjC)}(hposix_lock_fileh]jI)}(hposix_lock_fileh]hposix_lock_file}(hj8hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj8ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjb8hhhjt8hMubj=)}(hE(struct file *filp, struct file_lock *fl, struct file_lock *conflock)h](jC)}(hstruct file *filph](j )}(hjh]hstruct}(hj8hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj8ubj2)}(h h]h }(hj8hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj8ubh)}(hhh]jI)}(hfileh]hfile}(hj8hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj8ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj8modnameN classnameNjj )}j ]j)}jj8sbc.posix_lock_fileasbuh1hhj8ubj2)}(h h]h }(hj8hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj8ubj)}(hjh]h*}(hj8hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj8ubjI)}(hfilph]hfilp}(hj8hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj8ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj8ubjC)}(hstruct file_lock *flh](j )}(hjh]hstruct}(hj9hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj9ubj2)}(h h]h }(hj"9hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj9ubh)}(hhh]jI)}(h file_lockh]h file_lock}(hj39hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj09ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj59modnameN classnameNjj )}j ]j8c.posix_lock_fileasbuh1hhj9ubj2)}(h h]h }(hjQ9hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj9ubj)}(hjh]h*}(hj_9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9ubjI)}(hflh]hfl}(hjl9hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj9ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj8ubjC)}(hstruct file_lock *conflockh](j )}(hjh]hstruct}(hj9hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj9ubj2)}(h h]h }(hj9hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj9ubh)}(hhh]jI)}(h file_lockh]h file_lock}(hj9hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj9ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj9modnameN classnameNjj )}j ]j8c.posix_lock_fileasbuh1hhj9ubj2)}(h h]h }(hj9hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj9ubj)}(hjh]h*}(hj9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9ubjI)}(hconflockh]hconflock}(hj9hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj9ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj8ubeh}(h]h ]h"]h$]h&]j`jauh1j<hjb8hhhjt8hMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj^8hhhjt8hMubah}(h]jY8ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjt8hMhj[8hhubjw)}(hhh]h)}(h"Apply a POSIX-style lock to a fileh]h"Apply a POSIX-style lock to a file}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chMhj:hhubah}(h]h ]h"]h$]h&]uh1jvhj[8hhhjt8hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjj:jj:jjjuh1jhhhjC4hNhNubj)}(hX **Parameters** ``struct file *filp`` The file to apply the lock to ``struct file_lock *fl`` The lock to be applied ``struct file_lock *conflock`` Place to return a copy of the conflicting lock, if found. **Description** Add a POSIX style lock to a file. We merge adjacent & overlapping locks whenever possible. POSIX locks are sorted by owner task, then by starting address Note that if called with an FL_EXISTS argument, the caller may determine whether or not a lock was successfully freed by testing the return value for -ENOENT.h](h)}(h**Parameters**h]j)}(hj(:h]h Parameters}(hj*:hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj&:ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chMhj":ubj)}(hhh](j)}(h4``struct file *filp`` The file to apply the lock to h](j)}(h``struct file *filp``h]j)}(hjG:h]hstruct file *filp}(hjI:hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjE:ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chMhjA:ubj)}(hhh]h)}(hThe file to apply the lock toh]hThe file to apply the lock to}(hj`:hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj\:hMhj]:ubah}(h]h ]h"]h$]h&]uh1jhjA:ubeh}(h]h ]h"]h$]h&]uh1jhj\:hMhj>:ubj)}(h0``struct file_lock *fl`` The lock to be applied h](j)}(h``struct file_lock *fl``h]j)}(hj:h]hstruct file_lock *fl}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj~:ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chMhjz:ubj)}(hhh]h)}(hThe lock to be appliedh]hThe lock to be applied}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj:hMhj:ubah}(h]h ]h"]h$]h&]uh1jhjz:ubeh}(h]h ]h"]h$]h&]uh1jhj:hMhj>:ubj)}(hY``struct file_lock *conflock`` Place to return a copy of the conflicting lock, if found. h](j)}(h``struct file_lock *conflock``h]j)}(hj:h]hstruct file_lock *conflock}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj:ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chMhj:ubj)}(hhh]h)}(h9Place to return a copy of the conflicting lock, if found.h]h9Place to return a copy of the conflicting lock, if found.}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj:hMhj:ubah}(h]h ]h"]h$]h&]uh1jhj:ubeh}(h]h ]h"]h$]h&]uh1jhj:hMhj>:ubeh}(h]h ]h"]h$]h&]uh1jhj":ubh)}(h**Description**h]j)}(hj:h]h Description}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj:ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chMhj":ubh)}(hAdd a POSIX style lock to a file. We merge adjacent & overlapping locks whenever possible. POSIX locks are sorted by owner task, then by starting addressh]hAdd a POSIX style lock to a file. We merge adjacent & overlapping locks whenever possible. POSIX locks are sorted by owner task, then by starting address}(hj ;hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chMhj":ubh)}(hNote that if called with an FL_EXISTS argument, the caller may determine whether or not a lock was successfully freed by testing the return value for -ENOENT.h]hNote that if called with an FL_EXISTS argument, the caller may determine whether or not a lock was successfully freed by testing the return value for -ENOENT.}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chMhj":ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjC4hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j $inode_lease_ignore_mask (C function)c.inode_lease_ignore_maskhNtauh1hhjC4hhhNhNubj)}(hhh](j)}(h1u32 inode_lease_ignore_mask (struct inode *inode)h]j)}(h0u32 inode_lease_ignore_mask(struct inode *inode)h](h)}(hhh]jI)}(hu32h]hu32}(hjK;hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjH;ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjM;modnameN classnameNjj )}j ]j)}jinode_lease_ignore_masksbc.inode_lease_ignore_maskasbuh1hhjD;hhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chM4ubj2)}(h h]h }(hjm;hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjD;hhhjl;hM4ubjC)}(hinode_lease_ignore_maskh]jI)}(hji;h]hinode_lease_ignore_mask}(hj;hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj{;ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjD;hhhjl;hM4ubj=)}(h(struct inode *inode)h]jC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hj;hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj;ubj2)}(h h]h }(hj;hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj;ubh)}(hhh]jI)}(hinodeh]hinode}(hj;hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj;ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj;modnameN classnameNjj )}j ]jg;c.inode_lease_ignore_maskasbuh1hhj;ubj2)}(h h]h }(hj;hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj;ubj)}(hjh]h*}(hj;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;ubjI)}(hinodeh]hinode}(hj;hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj;ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj;ubah}(h]h ]h"]h$]h&]j`jauh1j<hjD;hhhjl;hM4ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj@;hhhjl;hM4ubah}(h]j;;ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjl;hM4hj=;hhubjw)}(hhh]h)}(h7return union of all ignored inode events for this inodeh]h7return union of all ignored inode events for this inode}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chM4hj<hhubah}(h]h ]h"]h$]h&]uh1jvhj=;hhhjl;hM4ubeh}(h]h ](jfunctioneh"]h$]h&]jjjj3<jj3<jjjuh1jhhhjC4hNhNubj)}(h**Parameters** ``struct inode *inode`` inode of which to get ignore mask **Description** Walk the list of leases, and return the result of all of their FL_IGN_DIR_* bits or'ed together.h](h)}(h**Parameters**h]j)}(hj=<h]h Parameters}(hj?<hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj;<ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chM8hj7<ubj)}(hhh]j)}(h:``struct inode *inode`` inode of which to get ignore mask h](j)}(h``struct inode *inode``h]j)}(hj\<h]hstruct inode *inode}(hj^<hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjZ<ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chM5hjV<ubj)}(hhh]h)}(h!inode of which to get ignore maskh]h!inode of which to get ignore mask}(hju<hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjq<hM5hjr<ubah}(h]h ]h"]h$]h&]uh1jhjV<ubeh}(h]h ]h"]h$]h&]uh1jhjq<hM5hjS<ubah}(h]h ]h"]h$]h&]uh1jhj7<ubh)}(h**Description**h]j)}(hj<h]h Description}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj<ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chM7hj7<ubh)}(h`Walk the list of leases, and return the result of all of their FL_IGN_DIR_* bits or'ed together.h]hbWalk the list of leases, and return the result of all of their FL_IGN_DIR_* bits or’ed together.}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chM6hj7<ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjC4hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j __break_lease (C function)c.__break_leasehNtauh1hhjC4hhhNhNubj)}(hhh](j)}(h;int __break_lease (struct inode *inode, unsigned int flags)h]j)}(h:int __break_lease(struct inode *inode, unsigned int flags)h](j)}(hinth]hint}(hj<hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj<hhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chMubj2)}(h h]h }(hj<hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj<hhhj<hMubjC)}(h __break_leaseh]jI)}(h __break_leaseh]h __break_lease}(hj<hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj<ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj<hhhj<hMubj=)}(h)(struct inode *inode, unsigned int flags)h](jC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hj=hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj=ubj2)}(h h]h }(hj&=hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj=ubh)}(hhh]jI)}(hinodeh]hinode}(hj7=hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj4=ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj9=modnameN classnameNjj )}j ]j)}jj<sbc.__break_leaseasbuh1hhj=ubj2)}(h h]h }(hjW=hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj=ubj)}(hjh]h*}(hje=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=ubjI)}(hinodeh]hinode}(hjr=hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj=ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj=ubjC)}(hunsigned int flagsh](j)}(hunsignedh]hunsigned}(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=ubj2)}(h h]h }(hj=hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj=ubj)}(hinth]hint}(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=ubj2)}(h h]h }(hj=hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj=ubjI)}(hflagsh]hflags}(hj=hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj=ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj=ubeh}(h]h ]h"]h$]h&]j`jauh1j<hj<hhhj<hMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj<hhhj<hMubah}(h]j<ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj<hMhj<hhubjw)}(hhh]h)}(h%revoke all outstanding leases on fileh]h%revoke all outstanding leases on file}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chMhj=hhubah}(h]h ]h"]h$]h&]uh1jvhj<hhhj<hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjj>jj>jjjuh1jhhhjC4hNhNubj)}(hX^**Parameters** ``struct inode *inode`` the inode of the file to return ``unsigned int flags`` LEASE_BREAK_* flags **Description** break_lease (inlined for speed) has checked there already is at least some kind of lock (maybe a lease) on this file. Leases and Delegations are broken on a call to open() or truncate(). Delegations are also broken on any event that would change the ctime. Directory delegations are broken whenever the directory changes (unless the delegation is set up to ignore the event). This function can block waiting for the lease break unless you specify LEASE_BREAK_NONBLOCK.h](h)}(h**Parameters**h]j)}(hj>h]h Parameters}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj >ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chMhj >ubj)}(hhh](j)}(h8``struct inode *inode`` the inode of the file to return h](j)}(h``struct inode *inode``h]j)}(hj.>h]hstruct inode *inode}(hj0>hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj,>ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chMhj(>ubj)}(hhh]h)}(hthe inode of the file to returnh]hthe inode of the file to return}(hjG>hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjC>hMhjD>ubah}(h]h ]h"]h$]h&]uh1jhj(>ubeh}(h]h ]h"]h$]h&]uh1jhjC>hMhj%>ubj)}(h+``unsigned int flags`` LEASE_BREAK_* flags h](j)}(h``unsigned int flags``h]j)}(hjg>h]hunsigned int flags}(hji>hhhNhNubah}(h]h ]h"]h$]h&]uh1jhje>ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chMhja>ubj)}(hhh]h)}(hLEASE_BREAK_* flagsh]hLEASE_BREAK_* flags}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj|>hMhj}>ubah}(h]h ]h"]h$]h&]uh1jhja>ubeh}(h]h ]h"]h$]h&]uh1jhj|>hMhj%>ubeh}(h]h ]h"]h$]h&]uh1jhj >ubh)}(h**Description**h]j)}(hj>h]h Description}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj>ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chMhj >ubh)}(hXbreak_lease (inlined for speed) has checked there already is at least some kind of lock (maybe a lease) on this file. Leases and Delegations are broken on a call to open() or truncate(). Delegations are also broken on any event that would change the ctime. Directory delegations are broken whenever the directory changes (unless the delegation is set up to ignore the event). This function can block waiting for the lease break unless you specify LEASE_BREAK_NONBLOCK.h]hXbreak_lease (inlined for speed) has checked there already is at least some kind of lock (maybe a lease) on this file. Leases and Delegations are broken on a call to open() or truncate(). Delegations are also broken on any event that would change the ctime. Directory delegations are broken whenever the directory changes (unless the delegation is set up to ignore the event). This function can block waiting for the lease break unless you specify LEASE_BREAK_NONBLOCK.}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chMhj >ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjC4hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j lease_get_mtime (C function)c.lease_get_mtimehNtauh1hhjC4hhhNhNubj)}(hhh](j)}(hCvoid lease_get_mtime (struct inode *inode, struct timespec64 *time)h]j)}(hBvoid lease_get_mtime(struct inode *inode, struct timespec64 *time)h](j)}(hvoidh]hvoid}(hj>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>hhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chMubj2)}(h h]h }(hj>hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj>hhhj>hMubjC)}(hlease_get_mtimeh]jI)}(hlease_get_mtimeh]hlease_get_mtime}(hj?hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj?ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj>hhhj>hMubj=)}(h.(struct inode *inode, struct timespec64 *time)h](jC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hj$?hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj ?ubj2)}(h h]h }(hj1?hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj ?ubh)}(hhh]jI)}(hinodeh]hinode}(hjB?hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj??ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjD?modnameN classnameNjj )}j ]j)}jj ?sbc.lease_get_mtimeasbuh1hhj ?ubj2)}(h h]h }(hjb?hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj ?ubj)}(hjh]h*}(hjp?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ?ubjI)}(hinodeh]hinode}(hj}?hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ?ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj?ubjC)}(hstruct timespec64 *timeh](j )}(hjh]hstruct}(hj?hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj?ubj2)}(h h]h }(hj?hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj?ubh)}(hhh]jI)}(h timespec64h]h timespec64}(hj?hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj?ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj?modnameN classnameNjj )}j ]j^?c.lease_get_mtimeasbuh1hhj?ubj2)}(h h]h }(hj?hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj?ubj)}(hjh]h*}(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?ubjI)}(htimeh]htime}(hj?hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj?ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj?ubeh}(h]h ]h"]h$]h&]j`jauh1j<hj>hhhj>hMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj>hhhj>hMubah}(h]j>ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj>hMhj>hhubjw)}(hhh]h)}(h5update modified time of an inode with exclusive leaseh]h5update modified time of an inode with exclusive lease}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chMhj@hhubah}(h]h ]h"]h$]h&]uh1jvhj>hhhj>hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjj/@jj/@jjjuh1jhhhjC4hNhNubj)}(hXS**Parameters** ``struct inode *inode`` the inode ``struct timespec64 *time`` pointer to a timespec which contains the last modified time **Description** This is to force NFS clients to flush their caches for files with exclusive leases. The justification is that if someone has an exclusive lease, then they could be modifying it.h](h)}(h**Parameters**h]j)}(hj9@h]h Parameters}(hj;@hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj7@ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chMhj3@ubj)}(hhh](j)}(h"``struct inode *inode`` the inode h](j)}(h``struct inode *inode``h]j)}(hjX@h]hstruct inode *inode}(hjZ@hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjV@ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chMhjR@ubj)}(hhh]h)}(h the inodeh]h the inode}(hjq@hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjm@hMhjn@ubah}(h]h ]h"]h$]h&]uh1jhjR@ubeh}(h]h ]h"]h$]h&]uh1jhjm@hMhjO@ubj)}(hX``struct timespec64 *time`` pointer to a timespec which contains the last modified time h](j)}(h``struct timespec64 *time``h]j)}(hj@h]hstruct timespec64 *time}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj@ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chMhj@ubj)}(hhh]h)}(h;pointer to a timespec which contains the last modified timeh]h;pointer to a timespec which contains the last modified time}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj@hMhj@ubah}(h]h ]h"]h$]h&]uh1jhj@ubeh}(h]h ]h"]h$]h&]uh1jhj@hMhjO@ubeh}(h]h ]h"]h$]h&]uh1jhj3@ubh)}(h**Description**h]j)}(hj@h]h Description}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj@ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chMhj3@ubh)}(hThis is to force NFS clients to flush their caches for files with exclusive leases. The justification is that if someone has an exclusive lease, then they could be modifying it.h]hThis is to force NFS clients to flush their caches for files with exclusive leases. The justification is that if someone has an exclusive lease, then they could be modifying it.}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chMhj3@ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjC4hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j generic_setlease (C function)c.generic_setleasehNtauh1hhjC4hhhNhNubj)}(hhh](j)}(hWint generic_setlease (struct file *filp, int arg, struct file_lease **flp, void **priv)h]j)}(hVint generic_setlease(struct file *filp, int arg, struct file_lease **flp, void **priv)h](j)}(hinth]hint}(hjAhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj AhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chMubj2)}(h h]h }(hj AhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj AhhhjAhMubjC)}(hgeneric_setleaseh]jI)}(hgeneric_setleaseh]hgeneric_setlease}(hj2AhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj.Aubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj AhhhjAhMubj=)}(hB(struct file *filp, int arg, struct file_lease **flp, void **priv)h](jC)}(hstruct file *filph](j )}(hjh]hstruct}(hjNAhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjJAubj2)}(h h]h }(hj[AhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjJAubh)}(hhh]jI)}(hfileh]hfile}(hjlAhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjiAubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjnAmodnameN classnameNjj )}j ]j)}jj4Asbc.generic_setleaseasbuh1hhjJAubj2)}(h h]h }(hjAhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjJAubj)}(hjh]h*}(hjAhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJAubjI)}(hfilph]hfilp}(hjAhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjJAubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjFAubjC)}(hint argh](j)}(hinth]hint}(hjAhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjAubj2)}(h h]h }(hjAhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjAubjI)}(hargh]harg}(hjAhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjAubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjFAubjC)}(hstruct file_lease **flph](j )}(hjh]hstruct}(hjAhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjAubj2)}(h h]h }(hjBhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjAubh)}(hhh]jI)}(h file_leaseh]h file_lease}(hjBhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjBubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjBmodnameN classnameNjj )}j ]jAc.generic_setleaseasbuh1hhjAubj2)}(h h]h }(hj1BhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjAubj)}(hjh]h*}(hj?BhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjAubj)}(hjh]h*}(hjLBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjAubjI)}(hflph]hflp}(hjYBhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjAubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjFAubjC)}(h void **privh](j)}(hvoidh]hvoid}(hjrBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnBubj2)}(h h]h }(hjBhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjnBubj)}(hjh]h*}(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnBubj)}(hjh]h*}(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnBubjI)}(hprivh]hpriv}(hjBhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjnBubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjFAubeh}(h]h ]h"]h$]h&]j`jauh1j<hj AhhhjAhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj AhhhjAhMubah}(h]jAah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjAhMhjAhhubjw)}(hhh]h)}(hsets a lease on an open fileh]hsets a lease on an open file}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chMhjBhhubah}(h]h ]h"]h$]h&]uh1jvhjAhhhjAhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjBjjBjjjuh1jhhhjC4hNhNubj)}(hXs**Parameters** ``struct file *filp`` file pointer ``int arg`` type of lease to obtain ``struct file_lease **flp`` input - file_lock to use, output - file_lock inserted ``void **priv`` private data for lm_setup (may be NULL if lm_setup doesn't require it) **Description** The (input) flp->fl_lmops->lm_break function is required by break_lease().h](h)}(h**Parameters**h]j)}(hjBh]h Parameters}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjBubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chMhjBubj)}(hhh](j)}(h#``struct file *filp`` file pointer h](j)}(h``struct file *filp``h]j)}(hjCh]hstruct file *filp}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1jhjCubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chMhj Cubj)}(hhh]h)}(h file pointerh]h file pointer}(hj,ChhhNhNubah}(h]h ]h"]h$]h&]uh1hhj(ChMhj)Cubah}(h]h ]h"]h$]h&]uh1jhj Cubeh}(h]h ]h"]h$]h&]uh1jhj(ChMhj Cubj)}(h$``int arg`` type of lease to obtain h](j)}(h ``int arg``h]j)}(hjLCh]hint arg}(hjNChhhNhNubah}(h]h ]h"]h$]h&]uh1jhjJCubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chMhjFCubj)}(hhh]h)}(htype of lease to obtainh]htype of lease to obtain}(hjeChhhNhNubah}(h]h ]h"]h$]h&]uh1hhjaChMhjbCubah}(h]h ]h"]h$]h&]uh1jhjFCubeh}(h]h ]h"]h$]h&]uh1jhjaChMhj Cubj)}(hR``struct file_lease **flp`` input - file_lock to use, output - file_lock inserted h](j)}(h``struct file_lease **flp``h]j)}(hjCh]hstruct file_lease **flp}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1jhjCubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chMhjCubj)}(hhh]h)}(h5input - file_lock to use, output - file_lock insertedh]h5input - file_lock to use, output - file_lock inserted}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1hhjChMhjCubah}(h]h ]h"]h$]h&]uh1jhjCubeh}(h]h ]h"]h$]h&]uh1jhjChMhj Cubj)}(hW``void **priv`` private data for lm_setup (may be NULL if lm_setup doesn't require it) h](j)}(h``void **priv``h]j)}(hjCh]h void **priv}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1jhjCubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chMhjCubj)}(hhh]h)}(hFprivate data for lm_setup (may be NULL if lm_setup doesn't require it)h]hHprivate data for lm_setup (may be NULL if lm_setup doesn’t require it)}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chMhjCubah}(h]h ]h"]h$]h&]uh1jhjCubeh}(h]h ]h"]h$]h&]uh1jhjChMhj Cubeh}(h]h ]h"]h$]h&]uh1jhjBubh)}(h**Description**h]j)}(hjCh]h Description}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1jhjCubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chMhjBubj)}(hJThe (input) flp->fl_lmops->lm_break function is required by break_lease().h]h)}(hJThe (input) flp->fl_lmops->lm_break function is required by break_lease().h]hJThe (input) flp->fl_lmops->lm_break function is required by break_lease().}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chMhjDubah}(h]h ]h"]h$]h&]uh1jhj"DhMhjBubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjC4hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j vfs_setlease (C function)c.vfs_setleasehNtauh1hhjC4hhhNhNubj)}(hhh](j)}(hUint vfs_setlease (struct file *filp, int arg, struct file_lease **lease, void **priv)h]j)}(hTint vfs_setlease(struct file *filp, int arg, struct file_lease **lease, void **priv)h](j)}(hinth]hint}(hjIDhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEDhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chMGubj2)}(h h]h }(hjXDhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjEDhhhjWDhMGubjC)}(h vfs_setleaseh]jI)}(h vfs_setleaseh]h vfs_setlease}(hjjDhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjfDubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjEDhhhjWDhMGubj=)}(hD(struct file *filp, int arg, struct file_lease **lease, void **priv)h](jC)}(hstruct file *filph](j )}(hjh]hstruct}(hjDhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjDubj2)}(h h]h }(hjDhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjDubh)}(hhh]jI)}(hfileh]hfile}(hjDhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjDubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjDmodnameN classnameNjj )}j ]j)}jjlDsbc.vfs_setleaseasbuh1hhjDubj2)}(h h]h }(hjDhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjDubj)}(hjh]h*}(hjDhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjDubjI)}(hfilph]hfilp}(hjDhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjDubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj~DubjC)}(hint argh](j)}(hinth]hint}(hjDhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjDubj2)}(h h]h }(hjEhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjDubjI)}(hargh]harg}(hjEhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjDubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj~DubjC)}(hstruct file_lease **leaseh](j )}(hjh]hstruct}(hj-EhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj)Eubj2)}(h h]h }(hj:EhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj)Eubh)}(hhh]jI)}(h file_leaseh]h file_lease}(hjKEhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjHEubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjMEmodnameN classnameNjj )}j ]jDc.vfs_setleaseasbuh1hhj)Eubj2)}(h h]h }(hjiEhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj)Eubj)}(hjh]h*}(hjwEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)Eubj)}(hjh]h*}(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)EubjI)}(hleaseh]hlease}(hjEhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj)Eubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj~DubjC)}(h void **privh](j)}(hvoidh]hvoid}(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEubj2)}(h h]h }(hjEhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjEubj)}(hjh]h*}(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEubj)}(hjh]h*}(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEubjI)}(hprivh]hpriv}(hjEhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjEubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj~Dubeh}(h]h ]h"]h$]h&]j`jauh1j<hjEDhhhjWDhMGubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjADhhhjWDhMGubah}(h]jDhhubjw)}(hhh]h)}(hsets a lease on an open fileh]hsets a lease on an open file}(hj FhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chMGhjFhhubah}(h]h ]h"]h$]h&]uh1jvhj>DhhhjWDhMGubeh}(h]h ](jfunctioneh"]h$]h&]jjjj"Fjj"Fjjjuh1jhhhjC4hNhNubj)}(hX**Parameters** ``struct file *filp`` file pointer ``int arg`` type of lease to obtain ``struct file_lease **lease`` file_lock to use when adding a lease ``void **priv`` private info for lm_setup when adding a lease (may be NULL if lm_setup doesn't require it) **Description** Call this to establish a lease on the file. The "lease" argument is not used for F_UNLCK requests and may be NULL. For commands that set or alter an existing lease, the ``(*lease)->fl_lmops->lm_break`` operation must be set; if not, this function will return -ENOLCK (and generate a scary-looking stack trace). The "priv" pointer is passed directly to the lm_setup function as-is. It may be NULL if the lm_setup operation doesn't require it.h](h)}(h**Parameters**h]j)}(hj,Fh]h Parameters}(hj.FhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj*Fubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chMKhj&Fubj)}(hhh](j)}(h#``struct file *filp`` file pointer h](j)}(h``struct file *filp``h]j)}(hjKFh]hstruct file *filp}(hjMFhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjIFubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chMHhjEFubj)}(hhh]h)}(h file pointerh]h file pointer}(hjdFhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj`FhMHhjaFubah}(h]h ]h"]h$]h&]uh1jhjEFubeh}(h]h ]h"]h$]h&]uh1jhj`FhMHhjBFubj)}(h$``int arg`` type of lease to obtain h](j)}(h ``int arg``h]j)}(hjFh]hint arg}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjFubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chMIhj~Fubj)}(hhh]h)}(htype of lease to obtainh]htype of lease to obtain}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjFhMIhjFubah}(h]h ]h"]h$]h&]uh1jhj~Fubeh}(h]h ]h"]h$]h&]uh1jhjFhMIhjBFubj)}(hC``struct file_lease **lease`` file_lock to use when adding a lease h](j)}(h``struct file_lease **lease``h]j)}(hjFh]hstruct file_lease **lease}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjFubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chMJhjFubj)}(hhh]h)}(h$file_lock to use when adding a leaseh]h$file_lock to use when adding a lease}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjFhMJhjFubah}(h]h ]h"]h$]h&]uh1jhjFubeh}(h]h ]h"]h$]h&]uh1jhjFhMJhjBFubj)}(hk``void **priv`` private info for lm_setup when adding a lease (may be NULL if lm_setup doesn't require it) h](j)}(h``void **priv``h]j)}(hjFh]h void **priv}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjFubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chMLhjFubj)}(hhh]h)}(hZprivate info for lm_setup when adding a lease (may be NULL if lm_setup doesn't require it)h]h\private info for lm_setup when adding a lease (may be NULL if lm_setup doesn’t require it)}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chMKhj Gubah}(h]h ]h"]h$]h&]uh1jhjFubeh}(h]h ]h"]h$]h&]uh1jhj GhMLhjBFubeh}(h]h ]h"]h$]h&]uh1jhj&Fubh)}(h**Description**h]j)}(hj2Gh]h Description}(hj4GhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj0Gubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chMNhj&Fubh)}(hX6Call this to establish a lease on the file. The "lease" argument is not used for F_UNLCK requests and may be NULL. For commands that set or alter an existing lease, the ``(*lease)->fl_lmops->lm_break`` operation must be set; if not, this function will return -ENOLCK (and generate a scary-looking stack trace).h](hCall this to establish a lease on the file. The “lease” argument is not used for F_UNLCK requests and may be NULL. For commands that set or alter an existing lease, the }(hjHGhhhNhNubj)}(h ``(*lease)->fl_lmops->lm_break``h]h(*lease)->fl_lmops->lm_break}(hjPGhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjHGubhm operation must be set; if not, this function will return -ENOLCK (and generate a scary-looking stack trace).}(hjHGhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chMMhj&Fubh)}(hThe "priv" pointer is passed directly to the lm_setup function as-is. It may be NULL if the lm_setup operation doesn't require it.h]hThe “priv” pointer is passed directly to the lm_setup function as-is. It may be NULL if the lm_setup operation doesn’t require it.}(hjiGhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chMShj&Fubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjC4hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j "locks_lock_inode_wait (C function)c.locks_lock_inode_waithNtauh1hhjC4hhhNhNubj)}(hhh](j)}(hEint locks_lock_inode_wait (struct inode *inode, struct file_lock *fl)h]j)}(hDint locks_lock_inode_wait(struct inode *inode, struct file_lock *fl)h](j)}(hinth]hint}(hjGhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chMubj2)}(h h]h }(hjGhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjGhhhjGhMubjC)}(hlocks_lock_inode_waith]jI)}(hlocks_lock_inode_waith]hlocks_lock_inode_wait}(hjGhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjGubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjGhhhjGhMubj=)}(h+(struct inode *inode, struct file_lock *fl)h](jC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hjGhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjGubj2)}(h h]h }(hjGhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjGubh)}(hhh]jI)}(hinodeh]hinode}(hjGhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjGubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjGmodnameN classnameNjj )}j ]j)}jjGsbc.locks_lock_inode_waitasbuh1hhjGubj2)}(h h]h }(hjHhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjGubj)}(hjh]h*}(hj!HhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGubjI)}(hinodeh]hinode}(hj.HhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjGubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjGubjC)}(hstruct file_lock *flh](j )}(hjh]hstruct}(hjGHhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjCHubj2)}(h h]h }(hjTHhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjCHubh)}(hhh]jI)}(h file_lockh]h file_lock}(hjeHhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjbHubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjgHmodnameN classnameNjj )}j ]jHc.locks_lock_inode_waitasbuh1hhjCHubj2)}(h h]h }(hjHhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjCHubj)}(hjh]h*}(hjHhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCHubjI)}(hflh]hfl}(hjHhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjCHubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjGubeh}(h]h ]h"]h$]h&]j`jauh1j<hjGhhhjGhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjGhhhjGhMubah}(h]jGah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjGhMhjGhhubjw)}(hhh]h)}(hApply a lock to an inodeh]hApply a lock to an inode}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chMhjHhhubah}(h]h ]h"]h$]h&]uh1jvhjGhhhjGhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjHjjHjjjuh1jhhhjC4hNhNubj)}(h**Parameters** ``struct inode *inode`` inode of the file to apply to ``struct file_lock *fl`` The lock to be applied **Description** Apply a POSIX or FLOCK style lock request to an inode.h](h)}(h**Parameters**h]j)}(hjHh]h Parameters}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjHubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chMhjHubj)}(hhh](j)}(h6``struct inode *inode`` inode of the file to apply to h](j)}(h``struct inode *inode``h]j)}(hj Ih]hstruct inode *inode}(hj IhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjIubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chMhjIubj)}(hhh]h)}(hinode of the file to apply toh]hinode of the file to apply to}(hj"IhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjIhMhjIubah}(h]h ]h"]h$]h&]uh1jhjIubeh}(h]h ]h"]h$]h&]uh1jhjIhMhjIubj)}(h0``struct file_lock *fl`` The lock to be applied h](j)}(h``struct file_lock *fl``h]j)}(hjBIh]hstruct file_lock *fl}(hjDIhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj@Iubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chMhjah"]h$]h&]uh1j1hjIhhhjIhM ubjC)}(h vfs_test_lockh]jI)}(h vfs_test_lockh]h vfs_test_lock}(hjIhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjIubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjIhhhjIhM ubj=)}(h)(struct file *filp, struct file_lock *fl)h](jC)}(hstruct file *filph](j )}(hjh]hstruct}(hjIhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjIubj2)}(h h]h }(hj JhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjIubh)}(hhh]jI)}(hfileh]hfile}(hjJhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjJubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjJmodnameN classnameNjj )}j ]j)}jjIsbc.vfs_test_lockasbuh1hhjIubj2)}(h h]h }(hj=JhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjIubj)}(hjh]h*}(hjKJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIubjI)}(hfilph]hfilp}(hjXJhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjIubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjIubjC)}(hstruct file_lock *flh](j )}(hjh]hstruct}(hjqJhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjmJubj2)}(h h]h }(hj~JhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjmJubh)}(hhh]jI)}(h file_lockh]h file_lock}(hjJhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjJubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjJmodnameN classnameNjj )}j ]j9Jc.vfs_test_lockasbuh1hhjmJubj2)}(h h]h }(hjJhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjmJubj)}(hjh]h*}(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmJubjI)}(hflh]hfl}(hjJhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjmJubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjIubeh}(h]h ]h"]h$]h&]j`jauh1j<hjIhhhjIhM ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjIhhhjIhM ubah}(h]jIah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjIhM hjIhhubjw)}(hhh]h)}(htest file byte range lockh]htest file byte range lock}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chM hjJhhubah}(h]h ]h"]h$]h&]uh1jvhjIhhhjIhM ubeh}(h]h ](jfunctioneh"]h$]h&]jjjj Kjj Kjjjuh1jhhhjC4hNhNubj)}(hX**Parameters** ``struct file *filp`` The file to test lock for ``struct file_lock *fl`` The byte-range in the file to test; also used to hold result **Description** On entry, **fl** does not contain a lock, but identifies a range (fl_start, fl_end) in the file (c.flc_file), and an owner (c.flc_owner) for whom existing locks should be ignored. c.flc_type and c.flc_flags are ignored. Both fl_lmops and fl_ops in **fl** must be NULL. Returns -ERRNO on failure. Indicates presence of conflicting lock by setting fl->fl_type to something other than F_UNLCK. If vfs_test_lock() does find a lock and return it, the caller must use locks_free_lock() or locks_release_private() on the returned lock.h](h)}(h**Parameters**h]j)}(hjKh]h Parameters}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjKubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chM hjKubj)}(hhh](j)}(h0``struct file *filp`` The file to test lock for h](j)}(h``struct file *filp``h]j)}(hj3Kh]hstruct file *filp}(hj5KhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj1Kubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chM hj-Kubj)}(hhh]h)}(hThe file to test lock forh]hThe file to test lock for}(hjLKhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjHKhM hjIKubah}(h]h ]h"]h$]h&]uh1jhj-Kubeh}(h]h ]h"]h$]h&]uh1jhjHKhM hj*Kubj)}(hV``struct file_lock *fl`` The byte-range in the file to test; also used to hold result h](j)}(h``struct file_lock *fl``h]j)}(hjlKh]hstruct file_lock *fl}(hjnKhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjjKubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chM hjfKubj)}(hhh]h)}(hfl_type to something other than F_UNLCK.h](h On entry, }(hjKhhhNhNubj)}(h**fl**h]hfl}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjKubh does not contain a lock, but identifies a range (fl_start, fl_end) in the file (c.flc_file), and an owner (c.flc_owner) for whom existing locks should be ignored. c.flc_type and c.flc_flags are ignored. Both fl_lmops and fl_ops in }(hjKhhhNhNubj)}(h**fl**h]hfl}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjKubh must be NULL. Returns -ERRNO on failure. Indicates presence of conflicting lock by setting fl->fl_type to something other than F_UNLCK.}(hjKhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chM hjKubh)}(hIf vfs_test_lock() does find a lock and return it, the caller must use locks_free_lock() or locks_release_private() on the returned lock.h]hIf vfs_test_lock() does find a lock and return it, the caller must use locks_free_lock() or locks_release_private() on the returned lock.}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chM% hjKubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjC4hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j vfs_lock_file (C function)c.vfs_lock_filehNtauh1hhjC4hhhNhNubj)}(hhh](j)}(heint vfs_lock_file (struct file *filp, unsigned int cmd, struct file_lock *fl, struct file_lock *conf)h]j)}(hdint vfs_lock_file(struct file *filp, unsigned int cmd, struct file_lock *fl, struct file_lock *conf)h](j)}(hinth]hint}(hjLhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjLhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chM ubj2)}(h h]h }(hj.LhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjLhhhj-LhM ubjC)}(h vfs_lock_fileh]jI)}(h vfs_lock_fileh]h vfs_lock_file}(hj@LhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjah"]h$]h&]uh1j1hjXLubh)}(hhh]jI)}(hfileh]hfile}(hjzLhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjwLubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj|LmodnameN classnameNjj )}j ]j)}jjBLsbc.vfs_lock_fileasbuh1hhjXLubj2)}(h h]h }(hjLhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjXLubj)}(hjh]h*}(hjLhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjXLubjI)}(hfilph]hfilp}(hjLhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjXLubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjTLubjC)}(hunsigned int cmdh](j)}(hunsignedh]hunsigned}(hjLhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjLubj2)}(h h]h }(hjLhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjLubj)}(hinth]hint}(hjLhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjLubj2)}(h h]h }(hjLhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjLubjI)}(hcmdh]hcmd}(hjMhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjLubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjTLubjC)}(hstruct file_lock *flh](j )}(hjh]hstruct}(hjMhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjMubj2)}(h h]h }(hj,MhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjMubh)}(hhh]jI)}(h file_lockh]h file_lock}(hj=MhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj:Mubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj?MmodnameN classnameNjj )}j ]jLc.vfs_lock_fileasbuh1hhjMubj2)}(h h]h }(hj[MhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjMubj)}(hjh]h*}(hjiMhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjMubjI)}(hflh]hfl}(hjvMhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjMubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjTLubjC)}(hstruct file_lock *confh](j )}(hjh]hstruct}(hjMhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjMubj2)}(h h]h }(hjMhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjMubh)}(hhh]jI)}(h file_lockh]h file_lock}(hjMhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjMubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjMmodnameN classnameNjj )}j ]jLc.vfs_lock_fileasbuh1hhjMubj2)}(h h]h }(hjMhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjMubj)}(hjh]h*}(hjMhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjMubjI)}(hconfh]hconf}(hjMhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjMubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjTLubeh}(h]h ]h"]h$]h&]j`jauh1j<hjLhhhj-LhM ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjLhhhj-LhM ubah}(h]jLah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj-LhM hjLhhubjw)}(hhh]h)}(hfile byte range lockh]hfile byte range lock}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chM hj Nhhubah}(h]h ]h"]h$]h&]uh1jvhjLhhhj-LhM ubeh}(h]h ](jfunctioneh"]h$]h&]jjjj(Njj(Njjjuh1jhhhjC4hNhNubj)}(hX**Parameters** ``struct file *filp`` The file to apply the lock to ``unsigned int cmd`` type of locking operation (F_SETLK, F_GETLK, etc.) ``struct file_lock *fl`` The lock to be applied ``struct file_lock *conf`` Place to return a copy of the conflicting lock, if found. **Description** A caller that doesn't care about the conflicting lock may pass NULL as the final argument. If the filesystem defines a private ->lock() method, then **conf** will be left unchanged; so a caller that cares should initialize it to some acceptable default. To avoid blocking kernel daemons, such as lockd, that need to acquire POSIX locks, the ->lock() interface may return asynchronously, before the lock has been granted or denied by the underlying filesystem, if (and only if) lm_grant is set. Additionally FOP_ASYNC_LOCK in file_operations fop_flags need to be set. Callers expecting ->lock() to return asynchronously will only use F_SETLK, not F_SETLKW; they will set FL_SLEEP if (and only if) the request is for a blocking lock. When ->lock() does return asynchronously, it must return FILE_LOCK_DEFERRED, and call ->lm_grant() when the lock request completes. If the request is for non-blocking lock the file system should return FILE_LOCK_DEFERRED then try to get the lock and call the callback routine with the result. If the request timed out the callback routine will return a nonzero return code and the file system should release the lock. The file system is also responsible to keep a corresponding posix lock when it grants a lock so the VFS can find out which locks are locally held and do the correct lock cleanup when required. The underlying filesystem must not drop the kernel lock or call ->lm_grant() before returning to the caller with a FILE_LOCK_DEFERRED return code.h](h)}(h**Parameters**h]j)}(hj2Nh]h Parameters}(hj4NhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj0Nubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chM hj,Nubj)}(hhh](j)}(h4``struct file *filp`` The file to apply the lock to h](j)}(h``struct file *filp``h]j)}(hjQNh]hstruct file *filp}(hjSNhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjONubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chM hjKNubj)}(hhh]h)}(hThe file to apply the lock toh]hThe file to apply the lock to}(hjjNhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjfNhM hjgNubah}(h]h ]h"]h$]h&]uh1jhjKNubeh}(h]h ]h"]h$]h&]uh1jhjfNhM hjHNubj)}(hH``unsigned int cmd`` type of locking operation (F_SETLK, F_GETLK, etc.) h](j)}(h``unsigned int cmd``h]j)}(hjNh]hunsigned int cmd}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjNubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chM hjNubj)}(hhh]h)}(h2type of locking operation (F_SETLK, F_GETLK, etc.)h]h2type of locking operation (F_SETLK, F_GETLK, etc.)}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjNhM hjNubah}(h]h ]h"]h$]h&]uh1jhjNubeh}(h]h ]h"]h$]h&]uh1jhjNhM hjHNubj)}(h0``struct file_lock *fl`` The lock to be applied h](j)}(h``struct file_lock *fl``h]j)}(hjNh]hstruct file_lock *fl}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjNubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chM hjNubj)}(hhh]h)}(hThe lock to be appliedh]hThe lock to be applied}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjNhM hjNubah}(h]h ]h"]h$]h&]uh1jhjNubeh}(h]h ]h"]h$]h&]uh1jhjNhM hjHNubj)}(hU``struct file_lock *conf`` Place to return a copy of the conflicting lock, if found. h](j)}(h``struct file_lock *conf``h]j)}(hjNh]hstruct file_lock *conf}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjNubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chM hjNubj)}(hhh]h)}(h9Place to return a copy of the conflicting lock, if found.h]h9Place to return a copy of the conflicting lock, if found.}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjOhM hjOubah}(h]h ]h"]h$]h&]uh1jhjNubeh}(h]h ]h"]h$]h&]uh1jhjOhM hjHNubeh}(h]h ]h"]h$]h&]uh1jhj,Nubh)}(h**Description**h]j)}(hj7Oh]h Description}(hj9OhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj5Oubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chM hj,Nubh)}(hZA caller that doesn't care about the conflicting lock may pass NULL as the final argument.h]h\A caller that doesn’t care about the conflicting lock may pass NULL as the final argument.}(hjMOhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chM hj,Nubh)}(hIf the filesystem defines a private ->lock() method, then **conf** will be left unchanged; so a caller that cares should initialize it to some acceptable default.h](h:If the filesystem defines a private ->lock() method, then }(hj\OhhhNhNubj)}(h**conf**h]hconf}(hjdOhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj\Oubh` will be left unchanged; so a caller that cares should initialize it to some acceptable default.}(hj\OhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chM hj,Nubh)}(hX8To avoid blocking kernel daemons, such as lockd, that need to acquire POSIX locks, the ->lock() interface may return asynchronously, before the lock has been granted or denied by the underlying filesystem, if (and only if) lm_grant is set. Additionally FOP_ASYNC_LOCK in file_operations fop_flags need to be set.h]hX8To avoid blocking kernel daemons, such as lockd, that need to acquire POSIX locks, the ->lock() interface may return asynchronously, before the lock has been granted or denied by the underlying filesystem, if (and only if) lm_grant is set. Additionally FOP_ASYNC_LOCK in file_operations fop_flags need to be set.}(hj}OhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chM hj,Nubh)}(hXCallers expecting ->lock() to return asynchronously will only use F_SETLK, not F_SETLKW; they will set FL_SLEEP if (and only if) the request is for a blocking lock. When ->lock() does return asynchronously, it must return FILE_LOCK_DEFERRED, and call ->lm_grant() when the lock request completes. If the request is for non-blocking lock the file system should return FILE_LOCK_DEFERRED then try to get the lock and call the callback routine with the result. If the request timed out the callback routine will return a nonzero return code and the file system should release the lock. The file system is also responsible to keep a corresponding posix lock when it grants a lock so the VFS can find out which locks are locally held and do the correct lock cleanup when required. The underlying filesystem must not drop the kernel lock or call ->lm_grant() before returning to the caller with a FILE_LOCK_DEFERRED return code.h]hXCallers expecting ->lock() to return asynchronously will only use F_SETLK, not F_SETLKW; they will set FL_SLEEP if (and only if) the request is for a blocking lock. When ->lock() does return asynchronously, it must return FILE_LOCK_DEFERRED, and call ->lm_grant() when the lock request completes. If the request is for non-blocking lock the file system should return FILE_LOCK_DEFERRED then try to get the lock and call the callback routine with the result. If the request timed out the callback routine will return a nonzero return code and the file system should release the lock. The file system is also responsible to keep a corresponding posix lock when it grants a lock so the VFS can find out which locks are locally held and do the correct lock cleanup when required. The underlying filesystem must not drop the kernel lock or call ->lm_grant() before returning to the caller with a FILE_LOCK_DEFERRED return code.}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chM hj,Nubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjC4hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j vfs_cancel_lock (C function)c.vfs_cancel_lockhNtauh1hhjC4hhhNhNubj)}(hhh](j)}(h=int vfs_cancel_lock (struct file *filp, struct file_lock *fl)h]j)}(hah"]h$]h&]uh1j1hjOhhhjOhM: ubjC)}(hvfs_cancel_lockh]jI)}(hvfs_cancel_lockh]hvfs_cancel_lock}(hjOhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjOubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjOhhhjOhM: ubj=)}(h)(struct file *filp, struct file_lock *fl)h](jC)}(hstruct file *filph](j )}(hjh]hstruct}(hjOhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjOubj2)}(h h]h }(hjPhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjOubh)}(hhh]jI)}(hfileh]hfile}(hjPhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjPubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjPmodnameN classnameNjj )}j ]j)}jjOsbc.vfs_cancel_lockasbuh1hhjOubj2)}(h h]h }(hj6PhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjOubj)}(hjh]h*}(hjDPhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjOubjI)}(hfilph]hfilp}(hjQPhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjOubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjOubjC)}(hstruct file_lock *flh](j )}(hjh]hstruct}(hjjPhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjfPubj2)}(h h]h }(hjwPhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjfPubh)}(hhh]jI)}(h file_lockh]h file_lock}(hjPhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjPubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjPmodnameN classnameNjj )}j ]j2Pc.vfs_cancel_lockasbuh1hhjfPubj2)}(h h]h }(hjPhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjfPubj)}(hjh]h*}(hjPhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjfPubjI)}(hflh]hfl}(hjPhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjfPubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjOubeh}(h]h ]h"]h$]h&]j`jauh1j<hjOhhhjOhM: ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjOhhhjOhM: ubah}(h]jOah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjOhM: hjOhhubjw)}(hhh]h)}(hfile byte range unblock lockh]hfile byte range unblock lock}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chM: hjPhhubah}(h]h ]h"]h$]h&]uh1jvhjOhhhjOhM: ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjQjjQjjjuh1jhhhjC4hNhNubj)}(h**Parameters** ``struct file *filp`` The file to apply the unblock to ``struct file_lock *fl`` The lock to be unblocked **Description** Used by lock managers to cancel blocked requestsh](h)}(h**Parameters**h]j)}(hj Qh]h Parameters}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj Qubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chM> hjQubj)}(hhh](j)}(h7``struct file *filp`` The file to apply the unblock to h](j)}(h``struct file *filp``h]j)}(hj,Qh]hstruct file *filp}(hj.QhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj*Qubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chM; hj&Qubj)}(hhh]h)}(h The file to apply the unblock toh]h The file to apply the unblock to}(hjEQhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjAQhM; hjBQubah}(h]h ]h"]h$]h&]uh1jhj&Qubeh}(h]h ]h"]h$]h&]uh1jhjAQhM; hj#Qubj)}(h2``struct file_lock *fl`` The lock to be unblocked h](j)}(h``struct file_lock *fl``h]j)}(hjeQh]hstruct file_lock *fl}(hjgQhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjcQubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chM< hj_Qubj)}(hhh]h)}(hThe lock to be unblockedh]hThe lock to be unblocked}(hj~QhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjzQhM< hj{Qubah}(h]h ]h"]h$]h&]uh1jhj_Qubeh}(h]h ]h"]h$]h&]uh1jhjzQhM< hj#Qubeh}(h]h ]h"]h$]h&]uh1jhjQubh)}(h**Description**h]j)}(hjQh]h Description}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjQubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chM> hjQubh)}(h0Used by lock managers to cancel blocked requestsh]h0Used by lock managers to cancel blocked requests}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chM= hjQubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjC4hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j  vfs_inode_has_locks (C function)c.vfs_inode_has_lockshNtauh1hhjC4hhhNhNubj)}(hhh](j)}(h.bool vfs_inode_has_locks (struct inode *inode)h]j)}(h-bool vfs_inode_has_locks(struct inode *inode)h](j)}(hjh]hbool}(hjQhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjQhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chMJ ubj2)}(h h]h }(hjQhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjQhhhjQhMJ ubjC)}(hvfs_inode_has_locksh]jI)}(hvfs_inode_has_locksh]hvfs_inode_has_locks}(hjRhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjRubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjQhhhjQhMJ ubj=)}(h(struct inode *inode)h]jC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hj!RhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjRubj2)}(h h]h }(hj.RhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjRubh)}(hhh]jI)}(hinodeh]hinode}(hj?RhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjah"]h$]h&]uh1j1hjRubj)}(hjh]h*}(hjmRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRubjI)}(hinodeh]hinode}(hjzRhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjRubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjRubah}(h]h ]h"]h$]h&]j`jauh1j<hjQhhhjQhMJ ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjQhhhjQhMJ ubah}(h]jQah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjQhMJ hjQhhubjw)}(hhh]h)}(h%are any file locks held on **inode**?h](hare any file locks held on }(hjRhhhNhNubj)}(h **inode**h]hinode}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjRubh?}(hjRhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chMJ hjRhhubah}(h]h ]h"]h$]h&]uh1jvhjQhhhjQhMJ ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjRjjRjjjuh1jhhhjC4hNhNubj)}(h**Parameters** ``struct inode *inode`` inode to check for locks **Description** Return true if there are any FL_POSIX or FL_FLOCK locks currently set on **inode**.h](h)}(h**Parameters**h]j)}(hjRh]h Parameters}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjRubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chMN hjRubj)}(hhh]j)}(h1``struct inode *inode`` inode to check for locks h](j)}(h``struct inode *inode``h]j)}(hjRh]hstruct inode *inode}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjRubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chMK hjRubj)}(hhh]h)}(hinode to check for locksh]hinode to check for locks}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1hhj ShMK hj Subah}(h]h ]h"]h$]h&]uh1jhjRubeh}(h]h ]h"]h$]h&]uh1jhj ShMK hjRubah}(h]h ]h"]h$]h&]uh1jhjRubh)}(h**Description**h]j)}(hj2Sh]h Description}(hj4ShhhNhNubah}(h]h ]h"]h$]h&]uh1jhj0Subah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chMM hjRubh)}(hSReturn true if there are any FL_POSIX or FL_FLOCK locks currently set on **inode**.h](hIReturn true if there are any FL_POSIX or FL_FLOCK locks currently set on }(hjHShhhNhNubj)}(h **inode**h]hinode}(hjPShhhNhNubah}(h]h ]h"]h$]h&]uh1jhjHSubh.}(hjHShhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:44: ./fs/locks.chML hjRubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjC4hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j  lease_open_conflict (C function)c.lease_open_conflicthNtauh1hhjC4hhhNhNubj)}(hhh](j)}(h:int lease_open_conflict (struct file *filp, const int arg)h]j)}(h9int lease_open_conflict(struct file *filp, const int arg)h](j)}(hinth]hint}(hjShhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjShhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:47: ./fs/locks.chMWubj2)}(h h]h }(hjShhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjShhhjShMWubjC)}(hlease_open_conflicth]jI)}(hlease_open_conflicth]hlease_open_conflict}(hjShhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjSubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjShhhjShMWubj=)}(h"(struct file *filp, const int arg)h](jC)}(hstruct file *filph](j )}(hjh]hstruct}(hjShhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjSubj2)}(h h]h }(hjShhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjSubh)}(hhh]jI)}(hfileh]hfile}(hjShhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjSubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjSmodnameN classnameNjj )}j ]j)}jjSsbc.lease_open_conflictasbuh1hhjSubj2)}(h h]h }(hjThhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjSubj)}(hjh]h*}(hjThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSubjI)}(hfilph]hfilp}(hjThhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjSubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjSubjC)}(h const int argh](j )}(hjJh]hconst}(hj8ThhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj4Tubj2)}(h h]h }(hjEThhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj4Tubj)}(hinth]hint}(hjSThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4Tubj2)}(h h]h }(hjaThhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj4TubjI)}(hargh]harg}(hjoThhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj4Tubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjSubeh}(h]h ]h"]h$]h&]j`jauh1j<hjShhhjShMWubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjShhhjShMWubah}(h]j|Sah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjShMWhj~Shhubjw)}(hhh]h)}(hnsee if the given file points to an inode that has an existing open that would conflict with the desired lease.h]hnsee if the given file points to an inode that has an existing open that would conflict with the desired lease.}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:47: ./fs/locks.chMWhjThhubah}(h]h ]h"]h$]h&]uh1jvhj~S#hhhjShMWubeh}(h]h ](jfunctioneh"]h$]h&]jjjjTjjTjjjuh1jhhhjC4hNhNubj)}(h**Parameters** ``struct file *filp`` file to check ``const int arg`` type of lease that we're trying to acquire **Description** Check to see if there's an existing open fd on this file that would conflict with the lease we're trying to set.h](h)}(h**Parameters**h]j)}(hjTh]h Parameters}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jhjTubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:47: ./fs/locks.chM[hjTubj)}(hhh](j)}(h$``struct file *filp`` file to check h](j)}(h``struct file *filp``h]j)}(hjTh]hstruct file *filp}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jhjTubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:47: ./fs/locks.chMZhjTubj)}(hhh]h)}(h file to checkh]h file to check}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1hhjThMZhjTubah}(h]h ]h"]h$]h&]uh1jhjTubeh}(h]h ]h"]h$]h&]uh1jhjThMZhjTubj)}(h=``const int arg`` type of lease that we're trying to acquire h](j)}(h``const int arg``h]j)}(hjUh]h const int arg}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjUubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:47: ./fs/locks.chM[hj Uubj)}(hhh]h)}(h*type of lease that we're trying to acquireh]h,type of lease that we’re trying to acquire}(hj,UhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj(UhM[hj)Uubah}(h]h ]h"]h$]h&]uh1jhj Uubeh}(h]h ]h"]h$]h&]uh1jhj(UhM[hjTubeh}(h]h ]h"]h$]h&]uh1jhjTubh)}(h**Description**h]j)}(hjNUh]h Description}(hjPUhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjLUubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:47: ./fs/locks.chM]hjTubh)}(hpCheck to see if there's an existing open fd on this file that would conflict with the lease we're trying to set.h]htCheck to see if there’s an existing open fd on this file that would conflict with the lease we’re trying to set.}(hjdUhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:47: ./fs/locks.chM\hjTubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjC4hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j "posix_lock_inode_wait (C function)c.posix_lock_inode_waithNtauh1hhjC4hhhNhNubj)}(hhh](j)}(hEint posix_lock_inode_wait (struct inode *inode, struct file_lock *fl)h]j)}(hDint posix_lock_inode_wait(struct inode *inode, struct file_lock *fl)h](j)}(hinth]hint}(hjUhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjUhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:47: ./fs/locks.chMubj2)}(h h]h }(hjUhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjUhhhjUhMubjC)}(hposix_lock_inode_waith]jI)}(hposix_lock_inode_waith]hposix_lock_inode_wait}(hjUhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjUubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjUhhhjUhMubj=)}(h+(struct inode *inode, struct file_lock *fl)h](jC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hjUhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjUubj2)}(h h]h }(hjUhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjUubh)}(hhh]jI)}(hinodeh]hinode}(hjUhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjUubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjUmodnameN classnameNjj )}j ]j)}jjUsbc.posix_lock_inode_waitasbuh1hhjUubj2)}(h h]h }(hjVhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjUubj)}(hjh]h*}(hjVhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjUubjI)}(hinodeh]hinode}(hj)VhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjUubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjUubjC)}(hstruct file_lock *flh](j )}(hjh]hstruct}(hjBVhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj>Vubj2)}(h h]h }(hjOVhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj>Vubh)}(hhh]jI)}(h file_lockh]h file_lock}(hj`VhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj]Vubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjbVmodnameN classnameNjj )}j ]j Vc.posix_lock_inode_waitasbuh1hhj>Vubj2)}(h h]h }(hj~VhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj>Vubj)}(hjh]h*}(hjVhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>VubjI)}(hflh]hfl}(hjVhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj>Vubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjUubeh}(h]h ]h"]h$]h&]j`jauh1j<hjUhhhjUhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjUhhhjUhMubah}(h]jUah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjUhMhjUhhubjw)}(hhh]h)}(h"Apply a POSIX-style lock to a fileh]h"Apply a POSIX-style lock to a file}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:47: ./fs/locks.chMhjVhhubah}(h]h ]h"]h$]h&]uh1jvhjUhhhjUhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjVjjVjjjuh1jhhhjC4hNhNubj)}(h**Parameters** ``struct inode *inode`` inode of file to which lock request should be applied ``struct file_lock *fl`` The lock to be applied **Description** Apply a POSIX style lock request to an inode.h](h)}(h**Parameters**h]j)}(hjVh]h Parameters}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjVubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:47: ./fs/locks.chMhjVubj)}(hhh](j)}(hN``struct inode *inode`` inode of file to which lock request should be applied h](j)}(h``struct inode *inode``h]j)}(hjWh]hstruct inode *inode}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjWubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:47: ./fs/locks.chMhjVubj)}(hhh]h)}(h5inode of file to which lock request should be appliedh]h5inode of file to which lock request should be applied}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjWhMhjWubah}(h]h ]h"]h$]h&]uh1jhjVubeh}(h]h ]h"]h$]h&]uh1jhjWhMhjVubj)}(h0``struct file_lock *fl`` The lock to be applied h](j)}(h``struct file_lock *fl``h]j)}(hj=Wh]hstruct file_lock *fl}(hj?WhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj;Wubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:47: ./fs/locks.chMhj7Wubj)}(hhh]h)}(hThe lock to be appliedh]hThe lock to be applied}(hjVWhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjRWhMhjSWubah}(h]h ]h"]h$]h&]uh1jhj7Wubeh}(h]h ]h"]h$]h&]uh1jhjRWhMhjVubeh}(h]h ]h"]h$]h&]uh1jhjVubh)}(h**Description**h]j)}(hjxWh]h Description}(hjzWhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjvWubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:47: ./fs/locks.chMhjVubh)}(h-Apply a POSIX style lock request to an inode.h]h-Apply a POSIX style lock request to an inode.}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:47: ./fs/locks.chMhjVubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjC4hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j __fcntl_getlease (C function)c.__fcntl_getleasehNtauh1hhjC4hhhNhNubj)}(hhh](j)}(h=int __fcntl_getlease (struct file *filp, unsigned int flavor)h]j)}(hah"]h$]h&]uh1j1hjWhhhjWhM!ubjC)}(h__fcntl_getleaseh]jI)}(h__fcntl_getleaseh]h__fcntl_getlease}(hjWhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjWubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjWhhhjWhM!ubj=)}(h((struct file *filp, unsigned int flavor)h](jC)}(hstruct file *filph](j )}(hjh]hstruct}(hjWhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjWubj2)}(h h]h }(hjXhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjWubh)}(hhh]jI)}(hfileh]hfile}(hjXhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjXubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjXmodnameN classnameNjj )}j ]j)}jjWsbc.__fcntl_getleaseasbuh1hhjWubj2)}(h h]h }(hj8XhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjWubj)}(hjh]h*}(hjFXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjWubjI)}(hfilph]hfilp}(hjSXhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjWubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjWubjC)}(hunsigned int flavorh](j)}(hunsignedh]hunsigned}(hjlXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhXubj2)}(h h]h }(hjzXhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhXubj)}(hinth]hint}(hjXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhXubj2)}(h h]h }(hjXhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhXubjI)}(hflavorh]hflavor}(hjXhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjhXubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjWubeh}(h]h ]h"]h$]h&]j`jauh1j<hjWhhhjWhM!ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjWhhhjWhM!ubah}(h]jWah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjWhM!hjWhhubjw)}(hhh]h)}(h&Enquire what lease is currently activeh]h&Enquire what lease is currently active}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:47: ./fs/locks.chM!hjXhhubah}(h]h ]h"]h$]h&]uh1jvhjWhhhjWhM!ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjXjjXjjjuh1jhhhjC4hNhNubj)}(hX**Parameters** ``struct file *filp`` the file ``unsigned int flavor`` type of lease flags to check **Description** The value returned by this function will be one of (if no lease break is pending): ``F_RDLCK`` to indicate a shared lease is held. ``F_WRLCK`` to indicate an exclusive lease is held. ``F_UNLCK`` to indicate no lease is held. (if a lease break is pending): ``F_RDLCK`` to indicate an exclusive lease needs to be changed to a shared lease (or removed). ``F_UNLCK`` to indicate the lease needs to be removed. XXX: sfr & willy disagree over whether F_INPROGRESS should be returned to userspace.h](h)}(h**Parameters**h]j)}(hjXh]h Parameters}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjXubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:47: ./fs/locks.chM%hjXubj)}(hhh](j)}(h``struct file *filp`` the file h](j)}(h``struct file *filp``h]j)}(hjYh]hstruct file *filp}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj Yubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:47: ./fs/locks.chM"hj Yubj)}(hhh]h)}(hthe fileh]hthe file}(hj(YhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj$YhM"hj%Yubah}(h]h ]h"]h$]h&]uh1jhj Yubeh}(h]h ]h"]h$]h&]uh1jhj$YhM"hjYubj)}(h5``unsigned int flavor`` type of lease flags to check h](j)}(h``unsigned int flavor``h]j)}(hjHYh]hunsigned int flavor}(hjJYhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjFYubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:47: ./fs/locks.chM#hjBYubj)}(hhh]h)}(htype of lease flags to checkh]htype of lease flags to check}(hjaYhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj]YhM#hj^Yubah}(h]h ]h"]h$]h&]uh1jhjBYubeh}(h]h ]h"]h$]h&]uh1jhj]YhM#hjYubeh}(h]h ]h"]h$]h&]uh1jhjXubh)}(h**Description**h]j)}(hjYh]h Description}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjYubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:47: ./fs/locks.chM%hjXubj)}(hXThe value returned by this function will be one of (if no lease break is pending): ``F_RDLCK`` to indicate a shared lease is held. ``F_WRLCK`` to indicate an exclusive lease is held. ``F_UNLCK`` to indicate no lease is held. (if a lease break is pending): ``F_RDLCK`` to indicate an exclusive lease needs to be changed to a shared lease (or removed). ``F_UNLCK`` to indicate the lease needs to be removed. XXX: sfr & willy disagree over whether F_INPROGRESS should be returned to userspace.h](h)}(hRThe value returned by this function will be one of (if no lease break is pending):h]hRThe value returned by this function will be one of (if no lease break is pending):}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:47: ./fs/locks.chM$hjYubh)}(h/``F_RDLCK`` to indicate a shared lease is held.h](j)}(h ``F_RDLCK``h]hF_RDLCK}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjYubh$ to indicate a shared lease is held.}(hjYhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:47: ./fs/locks.chM'hjYubh)}(h3``F_WRLCK`` to indicate an exclusive lease is held.h](j)}(h ``F_WRLCK``h]hF_WRLCK}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjYubh( to indicate an exclusive lease is held.}(hjYhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:47: ./fs/locks.chM)hjYubh)}(h)``F_UNLCK`` to indicate no lease is held.h](j)}(h ``F_UNLCK``h]hF_UNLCK}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjYubh to indicate no lease is held.}(hjYhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:47: ./fs/locks.chM+hjYubh)}(h(if a lease break is pending):h]h(if a lease break is pending):}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:47: ./fs/locks.chM-hjYubj)}(hhh]j)}(h_``F_RDLCK`` to indicate an exclusive lease needs to be changed to a shared lease (or removed). h](j)}(h6``F_RDLCK`` to indicate an exclusive lease needs to beh](j)}(h ``F_RDLCK``h]hF_RDLCK}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjZubh+ to indicate an exclusive lease needs to be}(hjZhhhNhNubeh}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:47: ./fs/locks.chM0hjZubj)}(hhh]h)}(h'changed to a shared lease (or removed).h]h'changed to a shared lease (or removed).}(hj9ZhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj5ZhM0hj6Zubah}(h]h ]h"]h$]h&]uh1jhjZubeh}(h]h ]h"]h$]h&]uh1jhj5ZhM0hjZubah}(h]h ]h"]h$]h&]uh1jhjYubh)}(h6``F_UNLCK`` to indicate the lease needs to be removed.h](j)}(h ``F_UNLCK``h]hF_UNLCK}(hj]ZhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjYZubh+ to indicate the lease needs to be removed.}(hjYZhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:47: ./fs/locks.chM2hjYubh)}(hTXXX: sfr & willy disagree over whether F_INPROGRESS should be returned to userspace.h]hTXXX: sfr & willy disagree over whether F_INPROGRESS should be returned to userspace.}(hjvZhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:47: ./fs/locks.chM4hjYubeh}(h]h ]h"]h$]h&]uh1jhjYhM$hjXubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjC4hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j fcntl_setlease (C function)c.fcntl_setleasehNtauh1hhjC4hhhNhNubj)}(hhh](j)}(h@int fcntl_setlease (unsigned int fd, struct file *filp, int arg)h]j)}(h?int fcntl_setlease(unsigned int fd, struct file *filp, int arg)h](j)}(hinth]hint}(hjZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:47: ./fs/locks.chMubj2)}(h h]h }(hjZhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjZhhhjZhMubjC)}(hfcntl_setleaseh]jI)}(hfcntl_setleaseh]hfcntl_setlease}(hjZhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjZubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjZhhhjZhMubj=)}(h-(unsigned int fd, struct file *filp, int arg)h](jC)}(hunsigned int fdh](j)}(hunsignedh]hunsigned}(hjZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZubj2)}(h h]h }(hjZhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjZubj)}(hinth]hint}(hj[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZubj2)}(h h]h }(hj[hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjZubjI)}(hfdh]hfd}(hj [hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjZubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjZubjC)}(hstruct file *filph](j )}(hjh]hstruct}(hj9[hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj5[ubj2)}(h h]h }(hjF[hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj5[ubh)}(hhh]jI)}(hfileh]hfile}(hjW[hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjT[ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjY[modnameN classnameNjj )}j ]j)}jjZsbc.fcntl_setleaseasbuh1hhj5[ubj2)}(h h]h }(hjw[hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj5[ubj)}(hjh]h*}(hj[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5[ubjI)}(hfilph]hfilp}(hj[hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj5[ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjZubjC)}(hint argh](j)}(hinth]hint}(hj[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj[ubj2)}(h h]h }(hj[hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj[ubjI)}(hargh]harg}(hj[hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj[ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjZubeh}(h]h ]h"]h$]h&]j`jauh1j<hjZhhhjZhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjZhhhjZhMubah}(h]jZah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjZhMhjZhhubjw)}(hhh]h)}(hsets a lease on an open fileh]hsets a lease on an open file}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:47: ./fs/locks.chMhj[hhubah}(h]h ]h"]h$]h&]uh1jvhjZhhhjZhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjj \jj \jjjuh1jhhhjC4hNhNubj)}(hX5**Parameters** ``unsigned int fd`` open file descriptor ``struct file *filp`` file pointer ``int arg`` type of lease to obtain **Description** Call this fcntl to establish a lease on the file. Note that you also need to call ``F_SETSIG`` to receive a signal when the lease is broken.h](h)}(h**Parameters**h]j)}(hj\h]h Parameters}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj\ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:47: ./fs/locks.chMhj \ubj)}(hhh](j)}(h)``unsigned int fd`` open file descriptor h](j)}(h``unsigned int fd``h]j)}(hj2\h]hunsigned int fd}(hj4\hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj0\ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:47: ./fs/locks.chMhj,\ubj)}(hhh]h)}(hopen file descriptorh]hopen file descriptor}(hjK\hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjG\hMhjH\ubah}(h]h ]h"]h$]h&]uh1jhj,\ubeh}(h]h ]h"]h$]h&]uh1jhjG\hMhj)\ubj)}(h#``struct file *filp`` file pointer h](j)}(h``struct file *filp``h]j)}(hjk\h]hstruct file *filp}(hjm\hhhNhNubah}(h]h ]h"]h$]h&]uh1jhji\ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:47: ./fs/locks.chMhje\ubj)}(hhh]h)}(h file pointerh]h file pointer}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj\hMhj\ubah}(h]h ]h"]h$]h&]uh1jhje\ubeh}(h]h ]h"]h$]h&]uh1jhj\hMhj)\ubj)}(h$``int arg`` type of lease to obtain h](j)}(h ``int arg``h]j)}(hj\h]hint arg}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj\ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:47: ./fs/locks.chMhj\ubj)}(hhh]h)}(htype of lease to obtainh]htype of lease to obtain}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj\hMhj\ubah}(h]h ]h"]h$]h&]uh1jhj\ubeh}(h]h ]h"]h$]h&]uh1jhj\hMhj)\ubeh}(h]h ]h"]h$]h&]uh1jhj \ubh)}(h**Description**h]j)}(hj\h]h Description}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj\ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:47: ./fs/locks.chMhj \ubj)}(hCall this fcntl to establish a lease on the file. Note that you also need to call ``F_SETSIG`` to receive a signal when the lease is broken.h]h)}(hCall this fcntl to establish a lease on the file. Note that you also need to call ``F_SETSIG`` to receive a signal when the lease is broken.h](hRCall this fcntl to establish a lease on the file. Note that you also need to call }(hj\hhhNhNubj)}(h ``F_SETSIG``h]hF_SETSIG}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj\ubh. to receive a signal when the lease is broken.}(hj\hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:47: ./fs/locks.chMhj\ubah}(h]h ]h"]h$]h&]uh1jhj]hMhj \ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjC4hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j fcntl_setdeleg (C function)c.fcntl_setdeleghNtauh1hhjC4hhhNhNubj)}(hhh](j)}(hQint fcntl_setdeleg (unsigned int fd, struct file *filp, struct delegation *deleg)h]j)}(hPint fcntl_setdeleg(unsigned int fd, struct file *filp, struct delegation *deleg)h](j)}(hinth]hint}(hj@]hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj<]hhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:47: ./fs/locks.chMubj2)}(h h]h }(hjO]hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj<]hhhjN]hMubjC)}(hfcntl_setdelegh]jI)}(hfcntl_setdelegh]hfcntl_setdeleg}(hja]hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj]]ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj<]hhhjN]hMubj=)}(h>(unsigned int fd, struct file *filp, struct delegation *deleg)h](jC)}(hunsigned int fdh](j)}(hunsignedh]hunsigned}(hj}]hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjy]ubj2)}(h h]h }(hj]hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjy]ubj)}(hinth]hint}(hj]hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjy]ubj2)}(h h]h }(hj]hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjy]ubjI)}(hfdh]hfd}(hj]hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjy]ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhju]ubjC)}(hstruct file *filph](j )}(hjh]hstruct}(hj]hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj]ubj2)}(h h]h }(hj]hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj]ubh)}(hhh]jI)}(hfileh]hfile}(hj]hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj]ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj]modnameN classnameNjj )}j ]j)}jjc]sbc.fcntl_setdelegasbuh1hhj]ubj2)}(h h]h }(hj ^hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj]ubj)}(hjh]h*}(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj]ubjI)}(hfilph]hfilp}(hj'^hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj]ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhju]ubjC)}(hstruct delegation *delegh](j )}(hjh]hstruct}(hj@^hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj<^ubj2)}(h h]h }(hjM^hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj<^ubh)}(hhh]jI)}(h delegationh]h delegation}(hj^^hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj[^ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj`^modnameN classnameNjj )}j ]j^c.fcntl_setdelegasbuh1hhj<^ubj2)}(h h]h }(hj|^hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj<^ubj)}(hjh]h*}(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj<^ubjI)}(hdelegh]hdeleg}(hj^hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj<^ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhju]ubeh}(h]h ]h"]h$]h&]j`jauh1j<hj<]hhhjN]hMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj8]hhhjN]hMubah}(h]j3]ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjN]hMhj5]hhubjw)}(hhh]h)}(h!sets a delegation on an open fileh]h!sets a delegation on an open file}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:47: ./fs/locks.chMhj^hhubah}(h]h ]h"]h$]h&]uh1jvhj5]hhhjN]hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjj^jj^jjjuh1jhhhjC4hNhNubj)}(hXT**Parameters** ``unsigned int fd`` open file descriptor ``struct file *filp`` file pointer ``struct delegation *deleg`` delegation request from userland **Description** Call this fcntl to establish a delegation on the file. Note that you also need to call ``F_SETSIG`` to receive a signal when the lease is broken.h](h)}(h**Parameters**h]j)}(hj^h]h Parameters}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj^ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:47: ./fs/locks.chMhj^ubj)}(hhh](j)}(h)``unsigned int fd`` open file descriptor h](j)}(h``unsigned int fd``h]j)}(hj_h]hunsigned int fd}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj_ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:47: ./fs/locks.chMhj^ubj)}(hhh]h)}(hopen file descriptorh]hopen file descriptor}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj_hMhj_ubah}(h]h ]h"]h$]h&]uh1jhj^ubeh}(h]h ]h"]h$]h&]uh1jhj_hMhj^ubj)}(h#``struct file *filp`` file pointer h](j)}(h``struct file *filp``h]j)}(hj;_h]hstruct file *filp}(hj=_hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj9_ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:47: ./fs/locks.chMhj5_ubj)}(hhh]h)}(h file pointerh]h file pointer}(hjT_hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjP_hMhjQ_ubah}(h]h ]h"]h$]h&]uh1jhj5_ubeh}(h]h ]h"]h$]h&]uh1jhjP_hMhj^ubj)}(h>``struct delegation *deleg`` delegation request from userland h](j)}(h``struct delegation *deleg``h]j)}(hjt_h]hstruct delegation *deleg}(hjv_hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjr_ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:47: ./fs/locks.chMhjn_ubj)}(hhh]h)}(h delegation request from userlandh]h delegation request from userland}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj_hMhj_ubah}(h]h ]h"]h$]h&]uh1jhjn_ubeh}(h]h ]h"]h$]h&]uh1jhj_hMhj^ubeh}(h]h ]h"]h$]h&]uh1jhj^ubh)}(h**Description**h]j)}(hj_h]h Description}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj_ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:47: ./fs/locks.chMhj^ubj)}(hCall this fcntl to establish a delegation on the file. Note that you also need to call ``F_SETSIG`` to receive a signal when the lease is broken.h]h)}(hCall this fcntl to establish a delegation on the file. Note that you also need to call ``F_SETSIG`` to receive a signal when the lease is broken.h](hWCall this fcntl to establish a delegation on the file. Note that you also need to call }(hj_hhhNhNubj)}(h ``F_SETSIG``h]hF_SETSIG}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj_ubh. to receive a signal when the lease is broken.}(hj_hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:47: ./fs/locks.chMhj_ubah}(h]h ]h"]h$]h&]uh1jhj_hMhj^ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjC4hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j "flock_lock_inode_wait (C function)c.flock_lock_inode_waithNtauh1hhjC4hhhNhNubj)}(hhh](j)}(hEint flock_lock_inode_wait (struct inode *inode, struct file_lock *fl)h]j)}(hDint flock_lock_inode_wait(struct inode *inode, struct file_lock *fl)h](j)}(hinth]hint}(hj`hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj `hhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:47: ./fs/locks.chMubj2)}(h h]h }(hj`hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj `hhhj`hMubjC)}(hflock_lock_inode_waith]jI)}(hflock_lock_inode_waith]hflock_lock_inode_wait}(hj1`hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj-`ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj `hhhj`hMubj=)}(h+(struct inode *inode, struct file_lock *fl)h](jC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hjM`hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjI`ubj2)}(h h]h }(hjZ`hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjI`ubh)}(hhh]jI)}(hinodeh]hinode}(hjk`hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjh`ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjm`modnameN classnameNjj )}j ]j)}jj3`sbc.flock_lock_inode_waitasbuh1hhjI`ubj2)}(h h]h }(hj`hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjI`ubj)}(hjh]h*}(hj`hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjI`ubjI)}(hinodeh]hinode}(hj`hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjI`ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjE`ubjC)}(hstruct file_lock *flh](j )}(hjh]hstruct}(hj`hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj`ubj2)}(h h]h }(hj`hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj`ubh)}(hhh]jI)}(h file_lockh]h file_lock}(hj`hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj`ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj`modnameN classnameNjj )}j ]j`c.flock_lock_inode_waitasbuh1hhj`ubj2)}(h h]h }(hj`hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj`ubj)}(hjh]h*}(hj ahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj`ubjI)}(hflh]hfl}(hjahhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj`ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjE`ubeh}(h]h ]h"]h$]h&]j`jauh1j<hj `hhhj`hMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj`hhhj`hMubah}(h]j`ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj`hMhj`hhubjw)}(hhh]h)}(h"Apply a FLOCK-style lock to a fileh]h"Apply a FLOCK-style lock to a file}(hj@ahhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:47: ./fs/locks.chMhj=ahhubah}(h]h ]h"]h$]h&]uh1jvhj`hhhj`hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjXajjXajjjuh1jhhhjC4hNhNubj)}(h**Parameters** ``struct inode *inode`` inode of the file to apply to ``struct file_lock *fl`` The lock to be applied **Description** Apply a FLOCK style lock request to an inode.h](h)}(h**Parameters**h]j)}(hjbah]h Parameters}(hjdahhhNhNubah}(h]h ]h"]h$]h&]uh1jhj`aubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:47: ./fs/locks.chMhj\aubj)}(hhh](j)}(h6``struct inode *inode`` inode of the file to apply to h](j)}(h``struct inode *inode``h]j)}(hjah]hstruct inode *inode}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1jhjaubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:47: ./fs/locks.chMhj{aubj)}(hhh]h)}(hinode of the file to apply toh]hinode of the file to apply to}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1hhjahMhjaubah}(h]h ]h"]h$]h&]uh1jhj{aubeh}(h]h ]h"]h$]h&]uh1jhjahMhjxaubj)}(h0``struct file_lock *fl`` The lock to be applied h](j)}(h``struct file_lock *fl``h]j)}(hjah]hstruct file_lock *fl}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1jhjaubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:47: ./fs/locks.chMhjaubj)}(hhh]h)}(hThe lock to be appliedh]hThe lock to be applied}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1hhjahMhjaubah}(h]h ]h"]h$]h&]uh1jhjaubeh}(h]h ]h"]h$]h&]uh1jhjahMhjxaubeh}(h]h ]h"]h$]h&]uh1jhj\aubh)}(h**Description**h]j)}(hjah]h Description}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1jhjaubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:47: ./fs/locks.chMhj\aubh)}(h-Apply a FLOCK style lock request to an inode.h]h-Apply a FLOCK style lock request to an inode.}(hj bhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:47: ./fs/locks.chMhj\aubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjC4hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j sys_flock (C function) c.sys_flockhNtauh1hhjC4hhhNhNubj)}(hhh](j)}(h2long sys_flock (unsigned int fd, unsigned int cmd)h]j)}(h1long sys_flock(unsigned int fd, unsigned int cmd)h](j)}(hlongh]hlong}(hj:bhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj6bhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:47: ./fs/locks.chMubj2)}(h h]h }(hjIbhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj6bhhhjHbhMubjC)}(h sys_flockh]jI)}(h sys_flockh]h sys_flock}(hj[bhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjWbubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj6bhhhjHbhMubj=)}(h#(unsigned int fd, unsigned int cmd)h](jC)}(hunsigned int fdh](j)}(hunsignedh]hunsigned}(hjwbhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjsbubj2)}(h h]h }(hjbhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjsbubj)}(hinth]hint}(hjbhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjsbubj2)}(h h]h }(hjbhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjsbubjI)}(hfdh]hfd}(hjbhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjsbubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjobubjC)}(hunsigned int cmdh](j)}(hunsignedh]hunsigned}(hjbhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjbubj2)}(h h]h }(hjbhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjbubj)}(hinth]hint}(hjbhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjbubj2)}(h h]h }(hjbhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjbubjI)}(hcmdh]hcmd}(hjchhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjbubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjobubeh}(h]h ]h"]h$]h&]j`jauh1j<hj6bhhhjHbhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj2bhhhjHbhMubah}(h]j-bah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjHbhMhj/bhhubjw)}(hhh]jE)}(hhh]jE)}(hflock() system call.h]h)}(hj/ch]hflock() system call.}(hj1chhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:47: ./fs/locks.chMhj-cubah}(h]h ]h"]h$]h&]uh1jEhj*chhhj>chNubah}(h]h ]h"]h$]h&]jEj2uh1jEhj>chMhj'chhubah}(h]h ]h"]h$]h&]uh1jvhj/bhhhjHbhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjTcjjTcjjjuh1jhhhjC4hNhNubj)}(hX**Parameters** ``unsigned int fd`` the file descriptor to lock. ``unsigned int cmd`` the type of lock to apply. **Description** Apply a ``FL_FLOCK`` style lock to an open file descriptor. The **cmd** can be one of: - ``LOCK_SH`` -- a shared lock. - ``LOCK_EX`` -- an exclusive lock. - ``LOCK_UN`` -- remove an existing lock. - ``LOCK_MAND`` -- a 'mandatory' flock. (DEPRECATED) ``LOCK_MAND`` support has been removed from the kernel.h](h)}(h**Parameters**h]j)}(hj^ch]h Parameters}(hj`chhhNhNubah}(h]h ]h"]h$]h&]uh1jhj\cubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:47: ./fs/locks.chMhjXcubj)}(hhh](j)}(h1``unsigned int fd`` the file descriptor to lock. h](j)}(h``unsigned int fd``h]j)}(hj}ch]hunsigned int fd}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jhj{cubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:47: ./fs/locks.chMhjwcubj)}(hhh]h)}(hthe file descriptor to lock.h]hthe file descriptor to lock.}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1hhjchMhjcubah}(h]h ]h"]h$]h&]uh1jhjwcubeh}(h]h ]h"]h$]h&]uh1jhjchMhjtcubj)}(h0``unsigned int cmd`` the type of lock to apply. h](j)}(h``unsigned int cmd``h]j)}(hjch]hunsigned int cmd}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jhjcubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:47: ./fs/locks.chMhjcubj)}(hhh]h)}(hthe type of lock to apply.h]hthe type of lock to apply.}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1hhjchMhjcubah}(h]h ]h"]h$]h&]uh1jhjcubeh}(h]h ]h"]h$]h&]uh1jhjchMhjtcubeh}(h]h ]h"]h$]h&]uh1jhjXcubh)}(h**Description**h]j)}(hjch]h Description}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jhjcubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:47: ./fs/locks.chMhjXcubj)}(hX3Apply a ``FL_FLOCK`` style lock to an open file descriptor. The **cmd** can be one of: - ``LOCK_SH`` -- a shared lock. - ``LOCK_EX`` -- an exclusive lock. - ``LOCK_UN`` -- remove an existing lock. - ``LOCK_MAND`` -- a 'mandatory' flock. (DEPRECATED) ``LOCK_MAND`` support has been removed from the kernel.h](h)}(hVApply a ``FL_FLOCK`` style lock to an open file descriptor. The **cmd** can be one of:h](hApply a }(hj dhhhNhNubj)}(h ``FL_FLOCK``h]hFL_FLOCK}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj dubh, style lock to an open file descriptor. The }(hj dhhhNhNubj)}(h**cmd**h]hcmd}(hj%dhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj dubh can be one of:}(hj dhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:47: ./fs/locks.chMhjdubjE)}(hhh](jE)}(h``LOCK_SH`` -- a shared lock.h]h)}(hjCdh](j)}(h ``LOCK_SH``h]hLOCK_SH}(hjHdhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjEdubh -- a shared lock.}(hjEdhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:47: ./fs/locks.chMhjAdubah}(h]h ]h"]h$]h&]uh1jEhj>dubjE)}(h!``LOCK_EX`` -- an exclusive lock.h]h)}(hjidh](j)}(h ``LOCK_EX``h]hLOCK_EX}(hjndhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjkdubh -- an exclusive lock.}(hjkdhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:47: ./fs/locks.chMhjgdubah}(h]h ]h"]h$]h&]uh1jEhj>dubjE)}(h'``LOCK_UN`` -- remove an existing lock.h]h)}(hjdh](j)}(h ``LOCK_UN``h]hLOCK_UN}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjdubh -- remove an existing lock.}(hjdhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:47: ./fs/locks.chMhjdubah}(h]h ]h"]h$]h&]uh1jEhj>dubjE)}(h3``LOCK_MAND`` -- a 'mandatory' flock. (DEPRECATED) h]h)}(h2``LOCK_MAND`` -- a 'mandatory' flock. (DEPRECATED)h](j)}(h ``LOCK_MAND``h]h LOCK_MAND}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjdubh) -- a ‘mandatory’ flock. (DEPRECATED)}(hjdhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:47: ./fs/locks.chMhjdubah}(h]h ]h"]h$]h&]uh1jEhj>dubeh}(h]h ]h"]h$]h&]jEj2uh1jEhj`dhMhjdubh)}(h7``LOCK_MAND`` support has been removed from the kernel.h](j)}(h ``LOCK_MAND``h]h LOCK_MAND}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjdubh* support has been removed from the kernel.}(hjdhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:47: ./fs/locks.chMhjdubeh}(h]h ]h"]h$]h&]uh1jhj=dhMhjXcubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjC4hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j  locks_translate_pid (C function)c.locks_translate_pidhNtauh1hhjC4hhhNhNubj)}(hhh](j)}(hOpid_t locks_translate_pid (struct file_lock_core *fl, struct pid_namespace *ns)h]j)}(hNpid_t locks_translate_pid(struct file_lock_core *fl, struct pid_namespace *ns)h](h)}(hhh]jI)}(hpid_th]hpid_t}(hj&ehhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj#eubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj(emodnameN classnameNjj )}j ]j)}jlocks_translate_pidsbc.locks_translate_pidasbuh1hhjehhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:47: ./fs/locks.chM@ ubj2)}(h h]h }(hjHehhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjehhhjGehM@ ubjC)}(hlocks_translate_pidh]jI)}(hjDeh]hlocks_translate_pid}(hjZehhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjVeubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjehhhjGehM@ ubj=)}(h5(struct file_lock_core *fl, struct pid_namespace *ns)h](jC)}(hstruct file_lock_core *flh](j )}(hjh]hstruct}(hjuehhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjqeubj2)}(h h]h }(hjehhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjqeubh)}(hhh]jI)}(hfile_lock_coreh]hfile_lock_core}(hjehhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjeubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjemodnameN classnameNjj )}j ]jBec.locks_translate_pidasbuh1hhjqeubj2)}(h h]h }(hjehhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjqeubj)}(hjh]h*}(hjehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjqeubjI)}(hflh]hfl}(hjehhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjqeubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjmeubjC)}(hstruct pid_namespace *nsh](j )}(hjh]hstruct}(hjehhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjeubj2)}(h h]h }(hjehhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjeubh)}(hhh]jI)}(h pid_namespaceh]h pid_namespace}(hjfhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjfubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjfmodnameN classnameNjj )}j ]jBec.locks_translate_pidasbuh1hhjeubj2)}(h h]h }(hj!fhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjeubj)}(hjh]h*}(hj/fhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubjI)}(hnsh]hns}(hjUsed to translate a fl_pid into a namespace virtual pid numberh]h>Used to translate a fl_pid into a namespace virtual pid number}(hj1ghhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:47: ./fs/locks.chMC hjfubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjC4hhhNhNubeh}(h] file-locksah ]h"] file locksah$]h&]uh1hhhhhhhhK*ubh)}(hhh](h)}(hOther Functionsh]hOther Functions}(hjRghhhNhNubah}(h]h ]h"]h$]h&]uh1hhjOghhhhhK3ubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j mpage_readahead (C function)c.mpage_readaheadhNtauh1hhjOghhhNhNubj)}(hhh](j)}(hKvoid mpage_readahead (struct readahead_control *rac, get_block_t get_block)h]j)}(hJvoid mpage_readahead(struct readahead_control *rac, get_block_t get_block)h](j)}(hvoidh]hvoid}(hjyghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjughhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:53: ./fs/mpage.chM@ubj2)}(h h]h }(hjghhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjughhhjghM@ubjC)}(hmpage_readaheadh]jI)}(hmpage_readaheadh]hmpage_readahead}(hjghhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjgubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjughhhjghM@ubj=)}(h6(struct readahead_control *rac, get_block_t get_block)h](jC)}(hstruct readahead_control *rach](j )}(hjh]hstruct}(hjghhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjgubj2)}(h h]h }(hjghhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjgubh)}(hhh]jI)}(hreadahead_controlh]hreadahead_control}(hjghhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjgubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjgmodnameN classnameNjj )}j ]j)}jjgsbc.mpage_readaheadasbuh1hhjgubj2)}(h h]h }(hjghhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjgubj)}(hjh]h*}(hjhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubjI)}(hrach]hrac}(hjhhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjgubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjgubjC)}(hget_block_t get_blockh](h)}(hhh]jI)}(h get_block_th]h get_block_t}(hj+hhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj(hubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj-hmodnameN classnameNjj )}j ]jgc.mpage_readaheadasbuh1hhj$hubj2)}(h h]h }(hjIhhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj$hubjI)}(h get_blockh]h get_block}(hjWhhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj$hubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjgubeh}(h]h ]h"]h$]h&]j`jauh1j<hjughhhjghM@ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjqghhhjghM@ubah}(h]jlgah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjghM@hjnghhubjw)}(hhh]h)}(hstart reads against pagesh]hstart reads against pages}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:53: ./fs/mpage.chM@hj~hhhubah}(h]h ]h"]h$]h&]uh1jvhjnghhhjghM@ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjhjjhjjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``struct readahead_control *rac`` Describes which pages to read. ``get_block_t get_block`` The filesystem's block mapper function. **Description** This function walks the pages and the blocks within each page, building and emitting large BIOs. If anything unusual happens, such as: - encountering a page which has buffers - encountering a page which has a non-hole after a hole - encountering a page with non-contiguous blocks then this code just gives up and calls the buffer_head-based read function. It does handle a page which has holes at the end - that is a common case: the end-of-file on blocksize < PAGE_SIZE setups. BH_Boundary explanation: There is a problem. The mpage read code assembles several pages, gets all their disk mappings, and then submits them all. That's fine, but obtaining the disk mappings may require I/O. Reads of indirect blocks, for example. So an mpage read of the first 16 blocks of an ext2 file will cause I/O to be submitted in the following order: 12 0 1 2 3 4 5 6 7 8 9 10 11 13 14 15 16 because the indirect block has to be read to get the mappings of blocks 13,14,15,16. Obviously, this impacts performance. So what we do it to allow the filesystem's get_block() function to set BH_Boundary when it maps block 11. BH_Boundary says: mapping of the block after this one will require I/O against a block which is probably close to this one. So you should push what I/O you have currently accumulated. This all causes the disk requests to be issued in the correct order.h](h)}(h**Parameters**h]j)}(hjhh]h Parameters}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjhubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:53: ./fs/mpage.chMDhjhubj)}(hhh](j)}(hA``struct readahead_control *rac`` Describes which pages to read. h](j)}(h!``struct readahead_control *rac``h]j)}(hjhh]hstruct readahead_control *rac}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjhubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:53: ./fs/mpage.chMAhjhubj)}(hhh]h)}(hDescribes which pages to read.h]hDescribes which pages to read.}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhMAhjhubah}(h]h ]h"]h$]h&]uh1jhjhubeh}(h]h ]h"]h$]h&]uh1jhjhhMAhjhubj)}(hB``get_block_t get_block`` The filesystem's block mapper function. h](j)}(h``get_block_t get_block``h]j)}(hjhh]hget_block_t get_block}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjhubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:53: ./fs/mpage.chMBhjhubj)}(hhh]h)}(h'The filesystem's block mapper function.h]h)The filesystem’s block mapper function.}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1hhjihMBhjiubah}(h]h ]h"]h$]h&]uh1jhjhubeh}(h]h ]h"]h$]h&]uh1jhjihMBhjhubeh}(h]h ]h"]h$]h&]uh1jhjhubh)}(h**Description**h]j)}(hj6ih]h Description}(hj8ihhhNhNubah}(h]h ]h"]h$]h&]uh1jhj4iubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:53: ./fs/mpage.chMDhjhubh)}(h`This function walks the pages and the blocks within each page, building and emitting large BIOs.h]h`This function walks the pages and the blocks within each page, building and emitting large BIOs.}(hjLihhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:53: ./fs/mpage.chMChjhubh)}(h%If anything unusual happens, such as:h]h%If anything unusual happens, such as:}(hj[ihhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:53: ./fs/mpage.chMFhjhubjE)}(hhh](jE)}(h%encountering a page which has buffersh]h)}(hjoih]h%encountering a page which has buffers}(hjqihhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:53: ./fs/mpage.chMHhjmiubah}(h]h ]h"]h$]h&]uh1jEhjjiubjE)}(h5encountering a page which has a non-hole after a holeh]h)}(hjih]h5encountering a page which has a non-hole after a hole}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:53: ./fs/mpage.chMIhjiubah}(h]h ]h"]h$]h&]uh1jEhjjiubjE)}(h/encountering a page with non-contiguous blocks h]h)}(h.encountering a page with non-contiguous blocksh]h.encountering a page with non-contiguous blocks}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:53: ./fs/mpage.chMJhjiubah}(h]h ]h"]h$]h&]uh1jEhjjiubeh}(h]h ]h"]h$]h&]jEj2uh1jEhj~ihMHhjhubh)}(hthen this code just gives up and calls the buffer_head-based read function. It does handle a page which has holes at the end - that is a common case: the end-of-file on blocksize < PAGE_SIZE setups.h]hthen this code just gives up and calls the buffer_head-based read function. It does handle a page which has holes at the end - that is a common case: the end-of-file on blocksize < PAGE_SIZE setups.}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:53: ./fs/mpage.chMLhjhubh)}(hBH_Boundary explanation:h]hBH_Boundary explanation:}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:53: ./fs/mpage.chMPhjhubh)}(hThere is a problem. The mpage read code assembles several pages, gets all their disk mappings, and then submits them all. That's fine, but obtaining the disk mappings may require I/O. Reads of indirect blocks, for example.h]hThere is a problem. The mpage read code assembles several pages, gets all their disk mappings, and then submits them all. That’s fine, but obtaining the disk mappings may require I/O. Reads of indirect blocks, for example.}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:53: ./fs/mpage.chMRhjhubh)}(hnSo an mpage read of the first 16 blocks of an ext2 file will cause I/O to be submitted in the following order:h]hnSo an mpage read of the first 16 blocks of an ext2 file will cause I/O to be submitted in the following order:}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:53: ./fs/mpage.chMVhjhubj)}(h)12 0 1 2 3 4 5 6 7 8 9 10 11 13 14 15 16 h]h)}(h(12 0 1 2 3 4 5 6 7 8 9 10 11 13 14 15 16h]h(12 0 1 2 3 4 5 6 7 8 9 10 11 13 14 15 16}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:53: ./fs/mpage.chMYhjiubah}(h]h ]h"]h$]h&]uh1jhj jhMYhjhubh)}(hzbecause the indirect block has to be read to get the mappings of blocks 13,14,15,16. Obviously, this impacts performance.h]hzbecause the indirect block has to be read to get the mappings of blocks 13,14,15,16. Obviously, this impacts performance.}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:53: ./fs/mpage.chM[hjhubh)}(hX#So what we do it to allow the filesystem's get_block() function to set BH_Boundary when it maps block 11. BH_Boundary says: mapping of the block after this one will require I/O against a block which is probably close to this one. So you should push what I/O you have currently accumulated.h]hX%So what we do it to allow the filesystem’s get_block() function to set BH_Boundary when it maps block 11. BH_Boundary says: mapping of the block after this one will require I/O against a block which is probably close to this one. So you should push what I/O you have currently accumulated.}(hj jhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:53: ./fs/mpage.chM^hjhubh)}(hDThis all causes the disk requests to be issued in the correct order.h]hDThis all causes the disk requests to be issued in the correct order.}(hj/jhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:53: ./fs/mpage.chMchjhubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j __mpage_writepages (C function)c.__mpage_writepageshNtauh1hhjOghhhNhNubj)}(hhh](j)}(hint __mpage_writepages (struct address_space *mapping, struct writeback_control *wbc, get_block_t get_block, int (*write_folio)(struct folio *folio, struct writeback_control *wbc))h]j)}(hint __mpage_writepages(struct address_space *mapping, struct writeback_control *wbc, get_block_t get_block, int (*write_folio)(struct folio *folio, struct writeback_control *wbc))h](j)}(hinth]hint}(hj^jhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZjhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:53: ./fs/mpage.chMubj2)}(h h]h }(hjmjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjZjhhhjljhMubjC)}(h__mpage_writepagesh]jI)}(h__mpage_writepagesh]h__mpage_writepages}(hjjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj{jubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjZjhhhjljhMubj=)}(h(struct address_space *mapping, struct writeback_control *wbc, get_block_t get_block, int (*write_folio)(struct folio *folio, struct writeback_control *wbc))h](jC)}(hstruct address_space *mappingh](j )}(hjh]hstruct}(hjjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjjubj2)}(h h]h }(hjjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjjubh)}(hhh]jI)}(h address_spaceh]h address_space}(hjjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjjmodnameN classnameNjj )}j ]j)}jjjsbc.__mpage_writepagesasbuh1hhjjubj2)}(h h]h }(hjjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjjubj)}(hjh]h*}(hjjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjjubjI)}(hmappingh]hmapping}(hjjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjjubjC)}(hstruct writeback_control *wbch](j )}(hjh]hstruct}(hj khhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj kubj2)}(h h]h }(hjkhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj kubh)}(hhh]jI)}(hwriteback_controlh]hwriteback_control}(hj+khhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj(kubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj-kmodnameN classnameNjj )}j ]jjc.__mpage_writepagesasbuh1hhj kubj2)}(h h]h }(hjIkhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj kubj)}(hjh]h*}(hjWkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj kubjI)}(hwbch]hwbc}(hjdkhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj kubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjjubjC)}(hget_block_t get_blockh](h)}(hhh]jI)}(h get_block_th]h get_block_t}(hjkhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj}kubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjkmodnameN classnameNjj )}j ]jjc.__mpage_writepagesasbuh1hhjykubj2)}(h h]h }(hjkhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjykubjI)}(h get_blockh]h get_block}(hjkhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjykubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjjubjC)}(hFint (*write_folio)(struct folio *folio, struct writeback_control *wbc)h](j)}(hinth]hint}(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjkubj2)}(h h]h }(hjkhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjkubj)}(hjʥh]h(}(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjkubj)}(hjh]h*}(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjkubjI)}(h write_folioh]h write_folio}(hjkhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjkubj)}(hjh]h)}(hj lhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjkubj)}(hjʥh]h(}(hjlhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjkubj )}(hjh]hstruct}(hj#lhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjkubj2)}(h h]h }(hj0lhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjkubh)}(hhh]jI)}(hfolioh]hfolio}(hjAlhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj>lubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjClmodnameN classnameNjj )}j ]jjc.__mpage_writepagesasbuh1hhjkubj2)}(h h]h }(hj_lhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjkubj)}(hjh]h*}(hjmlhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjkubjI)}(hfolioh]hfolio}(hjzlhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjkubj)}(hjWh]h,}(hjlhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjkubj2)}(h h]h }(hjlhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjkubj )}(hjh]hstruct}(hjlhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjkubj2)}(h h]h }(hjlhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjkubh)}(hhh]jI)}(hwriteback_controlh]hwriteback_control}(hjlhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjlubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjlmodnameN classnameNjj )}j ]jjc.__mpage_writepagesasbuh1hhjkubj2)}(h h]h }(hjlhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjkubj)}(hjh]h*}(hjlhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjkubjI)}(hwbch]hwbc}(hjlhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjkubj)}(hjh]h)}(hjmhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjkubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjZjhhhjljhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjVjhhhjljhMubah}(h]jQjah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjljhMhjSjhhubjw)}(hhh]h)}(hQwalk the list of dirty pages of the given address space & writepage() all of themh]hQwalk the list of dirty pages of the given address space & writepage() all of them}(hj1mhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:53: ./fs/mpage.chMhj.mhhubah}(h]h ]h"]h$]h&]uh1jvhjSjhhhjljhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjImjjImjjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``struct address_space *mapping`` address space structure to write ``struct writeback_control *wbc`` subtract the number of written pages from ***wbc->nr_to_write** ``get_block_t get_block`` the filesystem's block mapper function. ``int (*write_folio)(struct folio *folio, struct writeback_control *wbc)`` handler to call for each folio before calling mpage_write_folio() **Description** This is a library function, which implements the writepages() address_space_operation. It calls **write_folio** handler for each folio. If the handler returns value > 0, it calls mpage_write_folio() to do the folio writeback.h](h)}(h**Parameters**h]j)}(hjSmh]h Parameters}(hjUmhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjQmubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:53: ./fs/mpage.chMhjMmubj)}(hhh](j)}(hC``struct address_space *mapping`` address space structure to write h](j)}(h!``struct address_space *mapping``h]j)}(hjrmh]hstruct address_space *mapping}(hjtmhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjpmubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:53: ./fs/mpage.chMhjlmubj)}(hhh]h)}(h address space structure to writeh]h address space structure to write}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjmhMhjmubah}(h]h ]h"]h$]h&]uh1jhjlmubeh}(h]h ]h"]h$]h&]uh1jhjmhMhjimubj)}(hb``struct writeback_control *wbc`` subtract the number of written pages from ***wbc->nr_to_write** h](j)}(h!``struct writeback_control *wbc``h]j)}(hjmh]hstruct writeback_control *wbc}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjmubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:53: ./fs/mpage.chMhjmubj)}(hhh]h)}(h?subtract the number of written pages from ***wbc->nr_to_write**h](h*subtract the number of written pages from }(hjmhhhNhNubj)}(h***wbc->nr_to_write**h]h*wbc->nr_to_write}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjmubeh}(h]h ]h"]h$]h&]uh1hhjmhMhjmubah}(h]h ]h"]h$]h&]uh1jhjmubeh}(h]h ]h"]h$]h&]uh1jhjmhMhjimubj)}(hB``get_block_t get_block`` the filesystem's block mapper function. h](j)}(h``get_block_t get_block``h]j)}(hjmh]hget_block_t get_block}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjmubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:53: ./fs/mpage.chMhjmubj)}(hhh]h)}(h'the filesystem's block mapper function.h]h)the filesystem’s block mapper function.}(hj nhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjnhMhjnubah}(h]h ]h"]h$]h&]uh1jhjmubeh}(h]h ]h"]h$]h&]uh1jhjnhMhjimubj)}(h``int (*write_folio)(struct folio *folio, struct writeback_control *wbc)`` handler to call for each folio before calling mpage_write_folio() h](j)}(hJ``int (*write_folio)(struct folio *folio, struct writeback_control *wbc)``h]j)}(hj+nh]hFint (*write_folio)(struct folio *folio, struct writeback_control *wbc)}(hj-nhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj)nubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:53: ./fs/mpage.chMhj%nubj)}(hhh]h)}(hAhandler to call for each folio before calling mpage_write_folio()h]hAhandler to call for each folio before calling mpage_write_folio()}(hjDnhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:53: ./fs/mpage.chMhjAnubah}(h]h ]h"]h$]h&]uh1jhj%nubeh}(h]h ]h"]h$]h&]uh1jhj@nhMhjimubeh}(h]h ]h"]h$]h&]uh1jhjMmubh)}(h**Description**h]j)}(hjgnh]h Description}(hjinhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjenubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:53: ./fs/mpage.chMhjMmubh)}(hThis is a library function, which implements the writepages() address_space_operation. It calls **write_folio** handler for each folio. If the handler returns value > 0, it calls mpage_write_folio() to do the folio writeback.h](h`This is a library function, which implements the writepages() address_space_operation. It calls }(hj}nhhhNhNubj)}(h**write_folio**h]h write_folio}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj}nubhr handler for each folio. If the handler returns value > 0, it calls mpage_write_folio() to do the folio writeback.}(hj}nhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:53: ./fs/mpage.chMhjMmubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j generic_permission (C function)c.generic_permissionhNtauh1hhjOghhhNhNubj)}(hhh](j)}(hUint generic_permission (const struct mnt_idmap *idmap, struct inode *inode, int mask)h]j)}(hTint generic_permission(const struct mnt_idmap *idmap, struct inode *inode, int mask)h](j)}(hinth]hint}(hjnhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMubj2)}(h h]h }(hjnhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjnhhhjnhMubjC)}(hgeneric_permissionh]jI)}(hgeneric_permissionh]hgeneric_permission}(hjnhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjnubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjnhhhjnhMubj=)}(h>(const struct mnt_idmap *idmap, struct inode *inode, int mask)h](jC)}(hconst struct mnt_idmap *idmaph](j )}(hjJh]hconst}(hjnhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjnubj2)}(h h]h }(hjohhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjnubj )}(hjh]hstruct}(hjohhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjnubj2)}(h h]h }(hj#ohhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjnubh)}(hhh]jI)}(h mnt_idmaph]h mnt_idmap}(hj4ohhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj1oubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj6omodnameN classnameNjj )}j ]j)}jjnsbc.generic_permissionasbuh1hhjnubj2)}(h h]h }(hjTohhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjnubj)}(hjh]h*}(hjbohhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnubjI)}(hidmaph]hidmap}(hjoohhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjnubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjnubjC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hjohhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjoubj2)}(h h]h }(hjohhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjoubh)}(hhh]jI)}(hinodeh]hinode}(hjohhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjoubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjomodnameN classnameNjj )}j ]jPoc.generic_permissionasbuh1hhjoubj2)}(h h]h }(hjohhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjoubj)}(hjh]h*}(hjohhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjoubjI)}(hinodeh]hinode}(hjohhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjoubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjnubjC)}(hint maskh](j)}(hinth]hint}(hjohhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjoubj2)}(h h]h }(hjphhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjoubjI)}(hmaskh]hmask}(hjphhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjoubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjnubeh}(h]h ]h"]h$]h&]j`jauh1j<hjnhhhjnhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjnhhhjnhMubah}(h]jnah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjnhMhjnhhubjw)}(hhh]h)}(h2check for access rights on a Posix-like filesystemh]h2check for access rights on a Posix-like filesystem}(hj>phhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhj;phhubah}(h]h ]h"]h$]h&]uh1jvhjnhhhjnhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjVpjjVpjjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``const struct mnt_idmap *idmap`` idmap of the mount the inode was found from ``struct inode *inode`` inode to check access rights for ``int mask`` right to check for (``MAY_READ``, ``MAY_WRITE``, ``MAY_EXEC``, ``MAY_NOT_BLOCK`` ...) **Description** Used to check for read/write/execute permissions on a file. We use "fsuid" for this, letting us set arbitrary permissions for filesystem access without changing the "normal" uids which are used for other things. generic_permission is rcu-walk aware. It returns -ECHILD in case an rcu-walk request cannot be satisfied (eg. requires blocking or too much complexity). It would then be called again in ref-walk mode. If the inode has been found through an idmapped mount the idmap of the vfsmount must be passed through **idmap**. This function will then take care to map the inode according to **idmap** before checking permissions. On non-idmapped mounts or if permission checking is to be performed on the raw inode simply pass **nop_mnt_idmap**.h](h)}(h**Parameters**h]j)}(hj`ph]h Parameters}(hjbphhhNhNubah}(h]h ]h"]h$]h&]uh1jhj^pubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjZpubj)}(hhh](j)}(hN``const struct mnt_idmap *idmap`` idmap of the mount the inode was found from h](j)}(h!``const struct mnt_idmap *idmap``h]j)}(hjph]hconst struct mnt_idmap *idmap}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1jhj}pubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjypubj)}(hhh]h)}(h+idmap of the mount the inode was found fromh]h+idmap of the mount the inode was found from}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1hhjphMhjpubah}(h]h ]h"]h$]h&]uh1jhjypubeh}(h]h ]h"]h$]h&]uh1jhjphMhjvpubj)}(h9``struct inode *inode`` inode to check access rights for h](j)}(h``struct inode *inode``h]j)}(hjph]hstruct inode *inode}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1jhjpubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjpubj)}(hhh]h)}(h inode to check access rights forh]h inode to check access rights for}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1hhjphMhjpubah}(h]h ]h"]h$]h&]uh1jhjpubeh}(h]h ]h"]h$]h&]uh1jhjphMhjvpubj)}(hc``int mask`` right to check for (``MAY_READ``, ``MAY_WRITE``, ``MAY_EXEC``, ``MAY_NOT_BLOCK`` ...) h](j)}(h ``int mask``h]j)}(hjph]hint mask}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1jhjpubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjpubj)}(hhh]h)}(hUright to check for (``MAY_READ``, ``MAY_WRITE``, ``MAY_EXEC``, ``MAY_NOT_BLOCK`` ...)h](hright to check for (}(hj qhhhNhNubj)}(h ``MAY_READ``h]hMAY_READ}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj qubh, }(hj qhhhNhNubj)}(h ``MAY_WRITE``h]h MAY_WRITE}(hj$qhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj qubh, }hj qsbj)}(h ``MAY_EXEC``h]hMAY_EXEC}(hj6qhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj qubh, }(hj qhhhNhNubj)}(h``MAY_NOT_BLOCK``h]h MAY_NOT_BLOCK}(hjHqhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj qubh ...)}(hj qhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjqubah}(h]h ]h"]h$]h&]uh1jhjpubeh}(h]h ]h"]h$]h&]uh1jhjqhMhjvpubeh}(h]h ]h"]h$]h&]uh1jhjZpubh)}(h**Description**h]j)}(hjuqh]h Description}(hjwqhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjsqubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjZpubh)}(hUsed to check for read/write/execute permissions on a file. We use "fsuid" for this, letting us set arbitrary permissions for filesystem access without changing the "normal" uids which are used for other things.h]hUsed to check for read/write/execute permissions on a file. We use “fsuid” for this, letting us set arbitrary permissions for filesystem access without changing the “normal” uids which are used for other things.}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjZpubh)}(hgeneric_permission is rcu-walk aware. It returns -ECHILD in case an rcu-walk request cannot be satisfied (eg. requires blocking or too much complexity). It would then be called again in ref-walk mode.h]hgeneric_permission is rcu-walk aware. It returns -ECHILD in case an rcu-walk request cannot be satisfied (eg. requires blocking or too much complexity). It would then be called again in ref-walk mode.}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjZpubh)}(hXLIf the inode has been found through an idmapped mount the idmap of the vfsmount must be passed through **idmap**. This function will then take care to map the inode according to **idmap** before checking permissions. On non-idmapped mounts or if permission checking is to be performed on the raw inode simply pass **nop_mnt_idmap**.h](hgIf the inode has been found through an idmapped mount the idmap of the vfsmount must be passed through }(hjqhhhNhNubj)}(h **idmap**h]hidmap}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjqubhB. This function will then take care to map the inode according to }(hjqhhhNhNubj)}(h **idmap**h]hidmap}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjqubh before checking permissions. On non-idmapped mounts or if permission checking is to be performed on the raw inode simply pass }(hjqhhhNhNubj)}(h**nop_mnt_idmap**h]h nop_mnt_idmap}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjqubh.}(hjqhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjZpubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j inode_permission (C function)c.inode_permissionhNtauh1hhjOghhhNhNubj)}(hhh](j)}(hSint inode_permission (const struct mnt_idmap *idmap, struct inode *inode, int mask)h]j)}(hRint inode_permission(const struct mnt_idmap *idmap, struct inode *inode, int mask)h](j)}(hinth]hint}(hjrhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj rhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMiubj2)}(h h]h }(hjrhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj rhhhjrhMiubjC)}(hinode_permissionh]jI)}(hinode_permissionh]hinode_permission}(hj/rhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj+rubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj rhhhjrhMiubj=)}(h>(const struct mnt_idmap *idmap, struct inode *inode, int mask)h](jC)}(hconst struct mnt_idmap *idmaph](j )}(hjJh]hconst}(hjKrhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjGrubj2)}(h h]h }(hjXrhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjGrubj )}(hjh]hstruct}(hjfrhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjGrubj2)}(h h]h }(hjsrhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjGrubh)}(hhh]jI)}(h mnt_idmaph]h mnt_idmap}(hjrhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjrubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjrmodnameN classnameNjj )}j ]j)}jj1rsbc.inode_permissionasbuh1hhjGrubj2)}(h h]h }(hjrhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjGrubj)}(hjh]h*}(hjrhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGrubjI)}(hidmaph]hidmap}(hjrhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjGrubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjCrubjC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hjrhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjrubj2)}(h h]h }(hjrhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjrubh)}(hhh]jI)}(hinodeh]hinode}(hjrhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjrubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjrmodnameN classnameNjj )}j ]jrc.inode_permissionasbuh1hhjrubj2)}(h h]h }(hjshhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjrubj)}(hjh]h*}(hj"shhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjrubjI)}(hinodeh]hinode}(hj/shhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjrubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjCrubjC)}(hint maskh](j)}(hinth]hint}(hjHshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjDsubj2)}(h h]h }(hjVshhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjDsubjI)}(hmaskh]hmask}(hjdshhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjDsubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjCrubeh}(h]h ]h"]h$]h&]j`jauh1j<hj rhhhjrhMiubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjrhhhjrhMiubah}(h]jrah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjrhMihjrhhubjw)}(hhh]h)}(h(Check for access rights to a given inodeh]h(Check for access rights to a given inode}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMihjshhubah}(h]h ]h"]h$]h&]uh1jvhjrhhhjrhMiubeh}(h]h ](jfunctioneh"]h$]h&]jjjjsjjsjjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``const struct mnt_idmap *idmap`` idmap of the mount the inode was found from ``struct inode *inode`` Inode to check permission on ``int mask`` Right to check for (``MAY_READ``, ``MAY_WRITE``, ``MAY_EXEC``) **Description** Check for read/write/execute permissions on an inode. We use fs[ug]id for this, letting us set arbitrary permissions for filesystem access without changing the "normal" UIDs which are used for other things. When checking for MAY_APPEND, MAY_WRITE must also be set in **mask**.h](h)}(h**Parameters**h]j)}(hjsh]h Parameters}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1jhjsubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMmhjsubj)}(hhh](j)}(hN``const struct mnt_idmap *idmap`` idmap of the mount the inode was found from h](j)}(h!``const struct mnt_idmap *idmap``h]j)}(hjsh]hconst struct mnt_idmap *idmap}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1jhjsubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMjhjsubj)}(hhh]h)}(h+idmap of the mount the inode was found fromh]h+idmap of the mount the inode was found from}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1hhjshMjhjsubah}(h]h ]h"]h$]h&]uh1jhjsubeh}(h]h ]h"]h$]h&]uh1jhjshMjhjsubj)}(h5``struct inode *inode`` Inode to check permission on h](j)}(h``struct inode *inode``h]j)}(hjth]hstruct inode *inode}(hj thhhNhNubah}(h]h ]h"]h$]h&]uh1jhjtubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMkhjtubj)}(hhh]h)}(hInode to check permission onh]hInode to check permission on}(hj!thhhNhNubah}(h]h ]h"]h$]h&]uh1hhjthMkhjtubah}(h]h ]h"]h$]h&]uh1jhjtubeh}(h]h ]h"]h$]h&]uh1jhjthMkhjsubj)}(hL``int mask`` Right to check for (``MAY_READ``, ``MAY_WRITE``, ``MAY_EXEC``) h](j)}(h ``int mask``h]j)}(hjAth]hint mask}(hjCthhhNhNubah}(h]h ]h"]h$]h&]uh1jhj?tubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMlhj;tubj)}(hhh]h)}(h>Right to check for (``MAY_READ``, ``MAY_WRITE``, ``MAY_EXEC``)h](hRight to check for (}(hjZthhhNhNubj)}(h ``MAY_READ``h]hMAY_READ}(hjbthhhNhNubah}(h]h ]h"]h$]h&]uh1jhjZtubh, }(hjZthhhNhNubj)}(h ``MAY_WRITE``h]h MAY_WRITE}(hjtthhhNhNubah}(h]h ]h"]h$]h&]uh1jhjZtubh, }hjZtsbj)}(h ``MAY_EXEC``h]hMAY_EXEC}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jhjZtubh)}(hjZthhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjVthMlhjWtubah}(h]h ]h"]h$]h&]uh1jhj;tubeh}(h]h ]h"]h$]h&]uh1jhjVthMlhjsubeh}(h]h ]h"]h$]h&]uh1jhjsubh)}(h**Description**h]j)}(hjth]h Description}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jhjtubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMnhjsubh)}(hCheck for read/write/execute permissions on an inode. We use fs[ug]id for this, letting us set arbitrary permissions for filesystem access without changing the "normal" UIDs which are used for other things.h]hCheck for read/write/execute permissions on an inode. We use fs[ug]id for this, letting us set arbitrary permissions for filesystem access without changing the “normal” UIDs which are used for other things.}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMmhjsubh)}(hEWhen checking for MAY_APPEND, MAY_WRITE must also be set in **mask**.h](hah"]h$]h&]uh1j1hjuhhhj&uhMubjC)}(hpath_geth]jI)}(hpath_geth]hpath_get}(hj9uhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj5uubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjuhhhj&uhMubj=)}(h(const struct path *path)h]jC)}(hconst struct path *pathh](j )}(hjJh]hconst}(hjUuhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjQuubj2)}(h h]h }(hjbuhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjQuubj )}(hjh]hstruct}(hjpuhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjQuubj2)}(h h]h }(hj}uhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjQuubh)}(hhh]jI)}(hpathh]hpath}(hjuhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjuubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjumodnameN classnameNjj )}j ]j)}jj;usb c.path_getasbuh1hhjQuubj2)}(h h]h }(hjuhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjQuubj)}(hjh]h*}(hjuhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjQuubjI)}(hpathh]hpath}(hjuhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjQuubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjMuubah}(h]h ]h"]h$]h&]j`jauh1j<hjuhhhj&uhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjuhhhj&uhMubah}(h]j uah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj&uhMhj uhhubjw)}(hhh]h)}(hget a reference to a pathh]hget a reference to a path}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjuhhubah}(h]h ]h"]h$]h&]uh1jvhj uhhhj&uhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjj vjj vjjjuh1jhhhjOghNhNubj)}(h**Parameters** ``const struct path *path`` path to get the reference to **Description** Given a path increment the reference count to the dentry and the vfsmount.h](h)}(h**Parameters**h]j)}(hjvh]h Parameters}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjvubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjvubj)}(hhh]j)}(h9``const struct path *path`` path to get the reference to h](j)}(h``const struct path *path``h]j)}(hj4vh]hconst struct path *path}(hj6vhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj2vubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhj.vubj)}(hhh]h)}(hpath to get the reference toh]hpath to get the reference to}(hjMvhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjIvhMhjJvubah}(h]h ]h"]h$]h&]uh1jhj.vubeh}(h]h ]h"]h$]h&]uh1jhjIvhMhj+vubah}(h]h ]h"]h$]h&]uh1jhjvubh)}(h**Description**h]j)}(hjovh]h Description}(hjqvhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjmvubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjvubh)}(hJGiven a path increment the reference count to the dentry and the vfsmount.h]hJGiven a path increment the reference count to the dentry and the vfsmount.}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjvubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j path_put (C function) c.path_puthNtauh1hhjOghhhNhNubj)}(hhh](j)}(h'void path_put (const struct path *path)h]j)}(h&void path_put(const struct path *path)h](j)}(hvoidh]hvoid}(hjvhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMubj2)}(h h]h }(hjvhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjvhhhjvhMubjC)}(hpath_puth]jI)}(hpath_puth]hpath_put}(hjvhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjvubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjvhhhjvhMubj=)}(h(const struct path *path)h]jC)}(hconst struct path *pathh](j )}(hjJh]hconst}(hjvhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjvubj2)}(h h]h }(hjvhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjvubj )}(hjh]hstruct}(hj whhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjvubj2)}(h h]h }(hjwhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjvubh)}(hhh]jI)}(hpathh]hpath}(hj*whhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj'wubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj,wmodnameN classnameNjj )}j ]j)}jjvsb c.path_putasbuh1hhjvubj2)}(h h]h }(hjJwhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjvubj)}(hjh]h*}(hjXwhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvubjI)}(hpathh]hpath}(hjewhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjvubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjvubah}(h]h ]h"]h$]h&]j`jauh1j<hjvhhhjvhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjvhhhjvhMubah}(h]jvah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjvhMhjvhhubjw)}(hhh]h)}(hput a reference to a pathh]hput a reference to a path}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjwhhubah}(h]h ]h"]h$]h&]uh1jvhjvhhhjvhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjwjjwjjjuh1jhhhjOghNhNubj)}(h**Parameters** ``const struct path *path`` path to put the reference to **Description** Given a path decrement the reference count to the dentry and the vfsmount.h](h)}(h**Parameters**h]j)}(hjwh]h Parameters}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjwubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjwubj)}(hhh]j)}(h9``const struct path *path`` path to put the reference to h](j)}(h``const struct path *path``h]j)}(hjwh]hconst struct path *path}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjwubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjwubj)}(hhh]h)}(hpath to put the reference toh]hpath to put the reference to}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjwhMhjwubah}(h]h ]h"]h$]h&]uh1jhjwubeh}(h]h ]h"]h$]h&]uh1jhjwhMhjwubah}(h]h ]h"]h$]h&]uh1jhjwubh)}(h**Description**h]j)}(hj xh]h Description}(hj xhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj xubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjwubh)}(hJGiven a path decrement the reference count to the dentry and the vfsmount.h]hJGiven a path decrement the reference count to the dentry and the vfsmount.}(hj!xhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjwubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j end_dirop (C function) c.end_dirophNtauh1hhjOghhhNhNubj)}(hhh](j)}(h"void end_dirop (struct dentry *de)h]j)}(h!void end_dirop(struct dentry *de)h](j)}(hvoidh]hvoid}(hjPxhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjLxhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM ubj2)}(h h]h }(hj_xhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjLxhhhj^xhM ubjC)}(h end_diroph]jI)}(h end_diroph]h end_dirop}(hjqxhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjmxubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjLxhhhj^xhM ubj=)}(h(struct dentry *de)h]jC)}(hstruct dentry *deh](j )}(hjh]hstruct}(hjxhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjxubj2)}(h h]h }(hjxhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjxubh)}(hhh]jI)}(hdentryh]hdentry}(hjxhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjxubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjxmodnameN classnameNjj )}j ]j)}jjsxsb c.end_diropasbuh1hhjxubj2)}(h h]h }(hjxhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjxubj)}(hjh]h*}(hjxhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjxubjI)}(hdeh]hde}(hjxhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjxubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjxubah}(h]h ]h"]h$]h&]j`jauh1j<hjLxhhhj^xhM ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjHxhhhj^xhM ubah}(h]jCxah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj^xhM hjExhhubjw)}(hhh]h)}(hsignal completion of a diroph]hsignal completion of a dirop}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hj yhhubah}(h]h ]h"]h$]h&]uh1jvhjExhhhj^xhM ubeh}(h]h ](jfunctioneh"]h$]h&]jjjj(yjj(yjjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``struct dentry *de`` the dentry which was returned by start_dirop or similar. **Description** If the **de** is an error, nothing happens. Otherwise any lock taken to protect the dentry is dropped and the dentry itself is released (dput()).h](h)}(h**Parameters**h]j)}(hj2yh]h Parameters}(hj4yhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj0yubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hj,yubj)}(hhh]j)}(hO``struct dentry *de`` the dentry which was returned by start_dirop or similar. h](j)}(h``struct dentry *de``h]j)}(hjQyh]hstruct dentry *de}(hjSyhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjOyubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjKyubj)}(hhh]h)}(h8the dentry which was returned by start_dirop or similar.h]h8the dentry which was returned by start_dirop or similar.}(hjjyhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjfyhM hjgyubah}(h]h ]h"]h$]h&]uh1jhjKyubeh}(h]h ]h"]h$]h&]uh1jhjfyhM hjHyubah}(h]h ]h"]h$]h&]uh1jhj,yubh)}(h**Description**h]j)}(hjyh]h Description}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjyubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hj,yubh)}(hIf the **de** is an error, nothing happens. Otherwise any lock taken to protect the dentry is dropped and the dentry itself is released (dput()).h](hIf the }(hjyhhhNhNubj)}(h**de**h]hde}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjyubh is an error, nothing happens. Otherwise any lock taken to protect the dentry is dropped and the dentry itself is released (dput()).}(hjyhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hj,yubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j #vfs_path_parent_lookup (C function)c.vfs_path_parent_lookuphNtauh1hhjOghhhNhNubj)}(hhh](j)}(hint vfs_path_parent_lookup (struct filename *filename, unsigned int flags, struct path *parent, struct qstr *last, const struct path *root)h]j)}(hint vfs_path_parent_lookup(struct filename *filename, unsigned int flags, struct path *parent, struct qstr *last, const struct path *root)h](j)}(hinth]hint}(hjyhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM ubj2)}(h h]h }(hjyhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjyhhhjyhM ubjC)}(hvfs_path_parent_lookuph]jI)}(hvfs_path_parent_lookuph]hvfs_path_parent_lookup}(hjzhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjzubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjyhhhjyhM ubj=)}(hp(struct filename *filename, unsigned int flags, struct path *parent, struct qstr *last, const struct path *root)h](jC)}(hstruct filename *filenameh](j )}(hjh]hstruct}(hj zhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjzubj2)}(h h]h }(hj-zhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjzubh)}(hhh]jI)}(hfilenameh]hfilename}(hj>zhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj;zubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj@zmodnameN classnameNjj )}j ]j)}jjzsbc.vfs_path_parent_lookupasbuh1hhjzubj2)}(h h]h }(hj^zhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjzubj)}(hjh]h*}(hjlzhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjzubjI)}(hfilenameh]hfilename}(hjyzhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjzubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjzubjC)}(hunsigned int flagsh](j)}(hunsignedh]hunsigned}(hjzhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjzubj2)}(h h]h }(hjzhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjzubj)}(hinth]hint}(hjzhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjzubj2)}(h h]h }(hjzhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjzubjI)}(hflagsh]hflags}(hjzhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjzubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjzubjC)}(hstruct path *parenth](j )}(hjh]hstruct}(hjzhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjzubj2)}(h h]h }(hjzhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjzubh)}(hhh]jI)}(hpathh]hpath}(hj{hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjzubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj{modnameN classnameNjj )}j ]jZzc.vfs_path_parent_lookupasbuh1hhjzubj2)}(h h]h }(hj{hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjzubj)}(hjh]h*}(hj-{hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjzubjI)}(hparenth]hparent}(hj:{hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjzubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjzubjC)}(hstruct qstr *lasth](j )}(hjh]hstruct}(hjS{hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjO{ubj2)}(h h]h }(hj`{hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjO{ubh)}(hhh]jI)}(hqstrh]hqstr}(hjq{hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjn{ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjs{modnameN classnameNjj )}j ]jZzc.vfs_path_parent_lookupasbuh1hhjO{ubj2)}(h h]h }(hj{hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjO{ubj)}(hjh]h*}(hj{hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjO{ubjI)}(hlasth]hlast}(hj{hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjO{ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjzubjC)}(hconst struct path *rooth](j )}(hjJh]hconst}(hj{hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj{ubj2)}(h h]h }(hj{hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj{ubj )}(hjh]hstruct}(hj{hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj{ubj2)}(h h]h }(hj{hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj{ubh)}(hhh]jI)}(hpathh]hpath}(hj{hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj{ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj{modnameN classnameNjj )}j ]jZzc.vfs_path_parent_lookupasbuh1hhj{ubj2)}(h h]h }(hj|hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj{ubj)}(hjh]h*}(hj(|hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{ubjI)}(hrooth]hroot}(hj5|hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj{ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjzubeh}(h]h ]h"]h$]h&]j`jauh1j<hjyhhhjyhM ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjyhhhjyhM ubah}(h]jyah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjyhM hjyhhubjw)}(hhh]h)}(h7lookup a parent path relative to a dentry-vfsmount pairh]h7lookup a parent path relative to a dentry-vfsmount pair}(hj_|hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hj\|hhubah}(h]h ]h"]h$]h&]uh1jvhjyhhhjyhM ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjw|jjw|jjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``struct filename *filename`` filename structure ``unsigned int flags`` lookup flags ``struct path *parent`` pointer to struct path to fill ``struct qstr *last`` last component ``const struct path *root`` pointer to struct path of the base directoryh](h)}(h**Parameters**h]j)}(hj|h]h Parameters}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj|ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hj{|ubj)}(hhh](j)}(h1``struct filename *filename`` filename structure h](j)}(h``struct filename *filename``h]j)}(hj|h]hstruct filename *filename}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj|ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hj|ubj)}(hhh]h)}(hfilename structureh]hfilename structure}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj|hM hj|ubah}(h]h ]h"]h$]h&]uh1jhj|ubeh}(h]h ]h"]h$]h&]uh1jhj|hM hj|ubj)}(h$``unsigned int flags`` lookup flags h](j)}(h``unsigned int flags``h]j)}(hj|h]hunsigned int flags}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj|ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hj|ubj)}(hhh]h)}(h lookup flagsh]h lookup flags}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj|hM hj|ubah}(h]h ]h"]h$]h&]uh1jhj|ubeh}(h]h ]h"]h$]h&]uh1jhj|hM hj|ubj)}(h7``struct path *parent`` pointer to struct path to fill h](j)}(h``struct path *parent``h]j)}(hj}h]hstruct path *parent}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj}ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hj }ubj)}(hhh]h)}(hpointer to struct path to fillh]hpointer to struct path to fill}(hj+}hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj'}hM hj(}ubah}(h]h ]h"]h$]h&]uh1jhj }ubeh}(h]h ]h"]h$]h&]uh1jhj'}hM hj|ubj)}(h%``struct qstr *last`` last component h](j)}(h``struct qstr *last``h]j)}(hjK}h]hstruct qstr *last}(hjM}hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjI}ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjE}ubj)}(hhh]h)}(hlast componenth]hlast component}(hjd}hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj`}hM hja}ubah}(h]h ]h"]h$]h&]uh1jhjE}ubeh}(h]h ]h"]h$]h&]uh1jhj`}hM hj|ubj)}(hH``const struct path *root`` pointer to struct path of the base directoryh](j)}(h``const struct path *root``h]j)}(hj}h]hconst struct path *root}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj}ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hj~}ubj)}(hhh]h)}(h,pointer to struct path of the base directoryh]h,pointer to struct path of the base directory}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hj}ubah}(h]h ]h"]h$]h&]uh1jhj~}ubeh}(h]h ]h"]h$]h&]uh1jhj}hM hj|ubeh}(h]h ]h"]h$]h&]uh1jhj{|ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j vfs_path_lookup (C function)c.vfs_path_lookuphNtauh1hhjOghhhNhNubj)}(hhh](j)}(hzint vfs_path_lookup (struct dentry *dentry, struct vfsmount *mnt, const char *name, unsigned int flags, struct path *path)h]j)}(hyint vfs_path_lookup(struct dentry *dentry, struct vfsmount *mnt, const char *name, unsigned int flags, struct path *path)h](j)}(hinth]hint}(hj}hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj}hhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM ubj2)}(h h]h }(hj}hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj}hhhj}hM ubjC)}(hvfs_path_lookuph]jI)}(hvfs_path_lookuph]hvfs_path_lookup}(hj}hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj}ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj}hhhj}hM ubj=)}(hf(struct dentry *dentry, struct vfsmount *mnt, const char *name, unsigned int flags, struct path *path)h](jC)}(hstruct dentry *dentryh](j )}(hjh]hstruct}(hj~hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj~ubj2)}(h h]h }(hj(~hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj~ubh)}(hhh]jI)}(hdentryh]hdentry}(hj9~hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj6~ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj;~modnameN classnameNjj )}j ]j)}jj~sbc.vfs_path_lookupasbuh1hhj~ubj2)}(h h]h }(hjY~hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj~ubj)}(hjh]h*}(hjg~hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~ubjI)}(hdentryh]hdentry}(hjt~hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj~ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj~ubjC)}(hstruct vfsmount *mnth](j )}(hjh]hstruct}(hj~hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj~ubj2)}(h h]h }(hj~hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj~ubh)}(hhh]jI)}(hvfsmounth]hvfsmount}(hj~hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj~ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj~modnameN classnameNjj )}j ]jU~c.vfs_path_lookupasbuh1hhj~ubj2)}(h h]h }(hj~hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj~ubj)}(hjh]h*}(hj~hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~ubjI)}(hmnth]hmnt}(hj~hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj~ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj~ubjC)}(hconst char *nameh](j )}(hjJh]hconst}(hj~hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj~ubj2)}(h h]h }(hj hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj~ubj)}(hcharh]hchar}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~ubj2)}(h h]h }(hj&hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj~ubj)}(hjh]h*}(hj4hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~ubjI)}(hnameh]hname}(hjAhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj~ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj~ubjC)}(hunsigned int flagsh](j)}(hunsignedh]hunsigned}(hjZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVubj2)}(h h]h }(hjhhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjVubj)}(hinth]hint}(hjvhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjVubjI)}(hflagsh]hflags}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjVubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj~ubjC)}(hstruct path *pathh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hpathh]hpath}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jU~c.vfs_path_lookupasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hpathh]hpath}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj~ubeh}(h]h ]h"]h$]h&]j`jauh1j<hj}hhhj}hM ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj}hhhj}hM ubah}(h]j}ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj}hM hj}hhubjw)}(hhh]h)}(h5lookup a file path relative to a dentry-vfsmount pairh]h5lookup a file path relative to a dentry-vfsmount pair}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hj)hhubah}(h]h ]h"]h$]h&]uh1jvhj}hhhj}hM ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjDjjDjjjuh1jhhhjOghNhNubj)}(hX&**Parameters** ``struct dentry *dentry`` pointer to dentry of the base directory ``struct vfsmount *mnt`` pointer to vfs mount of the base directory ``const char *name`` pointer to file name ``unsigned int flags`` lookup flags ``struct path *path`` pointer to struct path to fillh](h)}(h**Parameters**h]j)}(hjNh]h Parameters}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjLubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjHubj)}(hhh](j)}(hB``struct dentry *dentry`` pointer to dentry of the base directory h](j)}(h``struct dentry *dentry``h]j)}(hjmh]hstruct dentry *dentry}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1jhjkubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjgubj)}(hhh]h)}(h'pointer to dentry of the base directoryh]h'pointer to dentry of the base directory}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjgubeh}(h]h ]h"]h$]h&]uh1jhjhM hjdubj)}(hD``struct vfsmount *mnt`` pointer to vfs mount of the base directory h](j)}(h``struct vfsmount *mnt``h]j)}(hjh]hstruct vfsmount *mnt}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjubj)}(hhh]h)}(h*pointer to vfs mount of the base directoryh]h*pointer to vfs mount of the base directory}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hjdubj)}(h*``const char *name`` pointer to file name h](j)}(h``const char *name``h]j)}(hj߀h]hconst char *name}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj݀ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjـubj)}(hhh]h)}(hpointer to file nameh]hpointer to file name}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjـubeh}(h]h ]h"]h$]h&]uh1jhjhM hjdubj)}(h$``unsigned int flags`` lookup flags h](j)}(h``unsigned int flags``h]j)}(hjh]hunsigned int flags}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjubj)}(hhh]h)}(h lookup flagsh]h lookup flags}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj-hM hj.ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj-hM hjdubj)}(h4``struct path *path`` pointer to struct path to fillh](j)}(h``struct path *path``h]j)}(hjQh]hstruct path *path}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1jhjOubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjKubj)}(hhh]h)}(hpointer to struct path to fillh]hpointer to struct path to fill}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjgubah}(h]h ]h"]h$]h&]uh1jhjKubeh}(h]h ]h"]h$]h&]uh1jhjfhM hjdubeh}(h]h ]h"]h$]h&]uh1jhjHubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j try_lookup_noperm (C function)c.try_lookup_nopermhNtauh1hhjOghhhNhNubj)}(hhh](j)}(hJstruct dentry * try_lookup_noperm (struct qstr *name, struct dentry *base)h]j)}(hHstruct dentry *try_lookup_noperm(struct qstr *name, struct dentry *base)h](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM; ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhM; ubh)}(hhh]jI)}(hdentryh]hdentry}(hjʁhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjǁubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj́modnameN classnameNjj )}j ]j)}jtry_lookup_nopermsbc.try_lookup_nopermasbuh1hhjhhhjhM; ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhM; ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM; ubjC)}(htry_lookup_nopermh]jI)}(hjh]htry_lookup_noperm}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhM; ubj=)}(h((struct qstr *name, struct dentry *base)h](jC)}(hstruct qstr *nameh](j )}(hjh]hstruct}(hj%hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj!ubj2)}(h h]h }(hj2hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj!ubh)}(hhh]jI)}(hqstrh]hqstr}(hjChhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj@ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjEmodnameN classnameNjj )}j ]jc.try_lookup_nopermasbuh1hhj!ubj2)}(h h]h }(hjahhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj!ubj)}(hjh]h*}(hjohhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubjI)}(hnameh]hname}(hj|hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj!ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct dentry *baseh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.try_lookup_nopermasbuh1hhjubj2)}(h h]h }(hjтhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj߂hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hbaseh]hbase}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhM; ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhM; ubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhM; hjhhubjw)}(hhh]h)}(h5filesystem helper to lookup single pathname componenth]h5filesystem helper to lookup single pathname component}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM; hjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhM; ubeh}(h]h ](jfunctioneh"]h$]h&]jjjj.jj.jjjuh1jhhhjOghNhNubj)}(hX?**Parameters** ``struct qstr *name`` qstr storing pathname component to lookup ``struct dentry *base`` base directory to lookup from **Description** Look up a dentry by name in the dcache, returning NULL if it does not currently exist or an error if there is a problem with the name. The function does not try to create a dentry and if one is found it doesn't try to revalidate it. Note that this routine is purely a helper for filesystem usage and should not be called by generic code. It does no permission checking. No locks need be held - only a counted reference to **base** is needed. **Return** - ref-counted dentry on success, or - ``NULL`` if name could not be found, or - ERR_PTR(-EACCES) if name is dot or dotdot or contains a slash or nul, or - ERR_PTR() if fs provide ->d_hash, and this returned an error.h](h)}(h**Parameters**h]j)}(hj8h]h Parameters}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj6ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM? hj2ubj)}(hhh](j)}(h@``struct qstr *name`` qstr storing pathname component to lookup h](j)}(h``struct qstr *name``h]j)}(hjWh]hstruct qstr *name}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjUubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM< hjQubj)}(hhh]h)}(h)qstr storing pathname component to lookuph]h)qstr storing pathname component to lookup}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1hhjlhM< hjmubah}(h]h ]h"]h$]h&]uh1jhjQubeh}(h]h ]h"]h$]h&]uh1jhjlhM< hjNubj)}(h6``struct dentry *base`` base directory to lookup from h](j)}(h``struct dentry *base``h]j)}(hjh]hstruct dentry *base}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM= hjubj)}(hhh]h)}(hbase directory to lookup fromh]hbase directory to lookup from}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM= hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM= hjNubeh}(h]h ]h"]h$]h&]uh1jhj2ubh)}(h**Description**h]j)}(hj˃h]h Description}(hj̓hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjɃubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM? hj2ubh)}(hLook up a dentry by name in the dcache, returning NULL if it does not currently exist or an error if there is a problem with the name. The function does not try to create a dentry and if one is found it doesn't try to revalidate it.h]hLook up a dentry by name in the dcache, returning NULL if it does not currently exist or an error if there is a problem with the name. The function does not try to create a dentry and if one is found it doesn’t try to revalidate it.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM> hj2ubh)}(hNote that this routine is purely a helper for filesystem usage and should not be called by generic code. It does no permission checking.h]hNote that this routine is purely a helper for filesystem usage and should not be called by generic code. It does no permission checking.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMC hj2ubh)}(hGNo locks need be held - only a counted reference to **base** is needed.h](h4No locks need be held - only a counted reference to }(hjhhhNhNubj)}(h**base**h]hbase}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh is needed.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMF hj2ubh)}(h **Return**h]j)}(hj"h]hReturn}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMH hj2ubjE)}(hhh](jE)}(h!ref-counted dentry on success, orh]h)}(hj=h]h!ref-counted dentry on success, or}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMI hj;ubah}(h]h ]h"]h$]h&]uh1jEhj8ubjE)}(h'``NULL`` if name could not be found, orh]h)}(hjUh](j)}(h``NULL``h]hNULL}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjWubh if name could not be found, or}(hjWhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMJ hjSubah}(h]h ]h"]h$]h&]uh1jEhj8ubjE)}(hHERR_PTR(-EACCES) if name is dot or dotdot or contains a slash or nul, orh]h)}(hj{h]hHERR_PTR(-EACCES) if name is dot or dotdot or contains a slash or nul, or}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMK hjyubah}(h]h ]h"]h$]h&]uh1jEhj8ubjE)}(h=ERR_PTR() if fs provide ->d_hash, and this returned an error.h]h)}(hjh]h=ERR_PTR() if fs provide ->d_hash, and this returned an error.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chML hjubah}(h]h ]h"]h$]h&]uh1jEhj8ubeh}(h]h ]h"]h$]h&]jEj2uh1jEhjLhMI hj2ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j lookup_noperm (C function)c.lookup_nopermhNtauh1hhjOghhhNhNubj)}(hhh](j)}(hFstruct dentry * lookup_noperm (struct qstr *name, struct dentry *base)h]j)}(hDstruct dentry *lookup_noperm(struct qstr *name, struct dentry *base)h](j )}(hjh]hstruct}(hjτhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj˄hhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM\ ubj2)}(h h]h }(hj݄hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj˄hhhj܄hM\ ubh)}(hhh]jI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}j lookup_nopermsbc.lookup_nopermasbuh1hhj˄hhhj܄hM\ ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj˄hhhj܄hM\ ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj˄hhhj܄hM\ ubjC)}(h lookup_nopermh]jI)}(hj h]h lookup_noperm}(hj.hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj*ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj˄hhhj܄hM\ ubj=)}(h((struct qstr *name, struct dentry *base)h](jC)}(hstruct qstr *nameh](j )}(hjh]hstruct}(hjIhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjEubj2)}(h h]h }(hjVhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjEubh)}(hhh]jI)}(hqstrh]hqstr}(hjghhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjdubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjimodnameN classnameNjj )}j ]j c.lookup_nopermasbuh1hhjEubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjEubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEubjI)}(hnameh]hname}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjEubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjAubjC)}(hstruct dentry *baseh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjƅhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hdentryh]hdentry}(hjׅhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjԅubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjمmodnameN classnameNjj )}j ]j c.lookup_nopermasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hbaseh]hbase}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjAubeh}(h]h ]h"]h$]h&]j`jauh1j<hj˄hhhj܄hM\ ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjDŽhhhj܄hM\ ubah}(h]j„ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj܄hM\ hjĄhhubjw)}(hhh]h)}(h5filesystem helper to lookup single pathname componenth]h5filesystem helper to lookup single pathname component}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM\ hj7hhubah}(h]h ]h"]h$]h&]uh1jvhjĄhhhj܄hM\ ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjRjjRjjjuh1jhhhjOghNhNubj)}(hXK**Parameters** ``struct qstr *name`` qstr storing pathname component to lookup ``struct dentry *base`` base directory to lookup from **Description** Note that this routine is purely a helper for filesystem usage and should not be called by generic code. It does no permission checking. The caller must hold base->i_rwsem.h](h)}(h**Parameters**h]j)}(hj\h]h Parameters}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjZubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM` hjVubj)}(hhh](j)}(h@``struct qstr *name`` qstr storing pathname component to lookup h](j)}(h``struct qstr *name``h]j)}(hj{h]hstruct qstr *name}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjyubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM] hjuubj)}(hhh]h)}(h)qstr storing pathname component to lookuph]h)qstr storing pathname component to lookup}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM] hjubah}(h]h ]h"]h$]h&]uh1jhjuubeh}(h]h ]h"]h$]h&]uh1jhjhM] hjrubj)}(h6``struct dentry *base`` base directory to lookup from h](j)}(h``struct dentry *base``h]j)}(hjh]hstruct dentry *base}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM^ hjubj)}(hhh]h)}(hbase directory to lookup fromh]hbase directory to lookup from}(hj͆hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjɆhM^ hjʆubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjɆhM^ hjrubeh}(h]h ]h"]h$]h&]uh1jhjVubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM` hjVubh)}(hNote that this routine is purely a helper for filesystem usage and should not be called by generic code. It does no permission checking.h]hNote that this routine is purely a helper for filesystem usage and should not be called by generic code. It does no permission checking.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM_ hjVubh)}(h#The caller must hold base->i_rwsem.h]h#The caller must hold base->i_rwsem.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMb hjVubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j lookup_one (C function) c.lookup_onehNtauh1hhjOghhhNhNubj)}(hhh](j)}(hbstruct dentry * lookup_one (const struct mnt_idmap *idmap, struct qstr *name, struct dentry *base)h]j)}(h`struct dentry *lookup_one(const struct mnt_idmap *idmap, struct qstr *name, struct dentry *base)h](j )}(hjh]hstruct}(hjChhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj?hhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMv ubj2)}(h h]h }(hjQhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj?hhhjPhMv ubh)}(hhh]jI)}(hdentryh]hdentry}(hjbhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj_ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjdmodnameN classnameNjj )}j ]j)}j lookup_onesb c.lookup_oneasbuh1hhj?hhhjPhMv ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj?hhhjPhMv ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?hhhjPhMv ubjC)}(h lookup_oneh]jI)}(hjh]h lookup_one}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj?hhhjPhMv ubj=)}(hG(const struct mnt_idmap *idmap, struct qstr *name, struct dentry *base)h](jC)}(hconst struct mnt_idmap *idmaph](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjʇhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj )}(hjh]hstruct}(hj؇hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(h mnt_idmaph]h mnt_idmap}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j~ c.lookup_oneasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hidmaph]hidmap}(hj/hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct qstr *nameh](j )}(hjh]hstruct}(hjHhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjDubj2)}(h h]h }(hjUhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjDubh)}(hhh]jI)}(hqstrh]hqstr}(hjfhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjcubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjhmodnameN classnameNjj )}j ]j~ c.lookup_oneasbuh1hhjDubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjDubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjDubjI)}(hnameh]hname}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjDubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct dentry *baseh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjňhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hdentryh]hdentry}(hjֈhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjӈubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj؈modnameN classnameNjj )}j ]j~ c.lookup_oneasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hbaseh]hbase}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hj?hhhjPhMv ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj;hhhjPhMv ubah}(h]j6ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjPhMv hj8hhubjw)}(hhh]h)}(h lookup single pathname componenth]h lookup single pathname component}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMv hj6hhubah}(h]h ]h"]h$]h&]uh1jvhj8hhhjPhMv ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjQjjQjjjuh1jhhhjOghNhNubj)}(hX^**Parameters** ``const struct mnt_idmap *idmap`` idmap of the mount the lookup is performed from ``struct qstr *name`` qstr holding pathname component to lookup ``struct dentry *base`` base directory to lookup from **Description** This can be used for in-kernel filesystem clients such as file servers. The caller must hold base->i_rwsem.h](h)}(h**Parameters**h]j)}(hj[h]h Parameters}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjYubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMz hjUubj)}(hhh](j)}(hR``const struct mnt_idmap *idmap`` idmap of the mount the lookup is performed from h](j)}(h!``const struct mnt_idmap *idmap``h]j)}(hjzh]hconst struct mnt_idmap *idmap}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjxubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMw hjtubj)}(hhh]h)}(h/idmap of the mount the lookup is performed fromh]h/idmap of the mount the lookup is performed from}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMw hjubah}(h]h ]h"]h$]h&]uh1jhjtubeh}(h]h ]h"]h$]h&]uh1jhjhMw hjqubj)}(h@``struct qstr *name`` qstr holding pathname component to lookup h](j)}(h``struct qstr *name``h]j)}(hjh]hstruct qstr *name}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMx hjubj)}(hhh]h)}(h)qstr holding pathname component to lookuph]h)qstr holding pathname component to lookup}(hj̉hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjȉhMx hjɉubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjȉhMx hjqubj)}(h6``struct dentry *base`` base directory to lookup from h](j)}(h``struct dentry *base``h]j)}(hjh]hstruct dentry *base}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMy hjubj)}(hhh]h)}(hbase directory to lookup fromh]hbase directory to lookup from}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMy hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMy hjqubeh}(h]h ]h"]h$]h&]uh1jhjUubh)}(h**Description**h]j)}(hj'h]h Description}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj%ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM{ hjUubh)}(hGThis can be used for in-kernel filesystem clients such as file servers.h]hGThis can be used for in-kernel filesystem clients such as file servers.}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMz hjUubh)}(h#The caller must hold base->i_rwsem.h]h#The caller must hold base->i_rwsem.}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM| hjUubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j  lookup_one_unlocked (C function)c.lookup_one_unlockedhNtauh1hhjOghhhNhNubj)}(hhh](j)}(hkstruct dentry * lookup_one_unlocked (const struct mnt_idmap *idmap, struct qstr *name, struct dentry *base)h]j)}(histruct dentry *lookup_one_unlocked(const struct mnt_idmap *idmap, struct qstr *name, struct dentry *base)h](j )}(hjh]hstruct}(hj{hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjwhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjwhhhjhM ubh)}(hhh]jI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jlookup_one_unlockedsbc.lookup_one_unlockedasbuh1hhjwhhhjhM ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjwhhhjhM ubj)}(hjh]h*}(hjɊhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjwhhhjhM ubjC)}(hlookup_one_unlockedh]jI)}(hjh]hlookup_one_unlocked}(hjڊhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj֊ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjwhhhjhM ubj=)}(hG(const struct mnt_idmap *idmap, struct qstr *name, struct dentry *base)h](jC)}(hconst struct mnt_idmap *idmaph](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(h mnt_idmaph]h mnt_idmap}(hj.hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj+ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj0modnameN classnameNjj )}j ]jc.lookup_one_unlockedasbuh1hhjubj2)}(h h]h }(hjLhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hidmaph]hidmap}(hjghhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct qstr *nameh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj|ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj|ubh)}(hhh]jI)}(hqstrh]hqstr}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.lookup_one_unlockedasbuh1hhj|ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj|ubj)}(hjh]h*}(hjʋhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|ubjI)}(hnameh]hname}(hj׋hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj|ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct dentry *baseh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.lookup_one_unlockedasbuh1hhjubj2)}(h h]h }(hj,hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj:hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hbaseh]hbase}(hjGhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjwhhhjhM ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjshhhjhM ubah}(h]jnah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhM hjphhubjw)}(hhh]h)}(h lookup single pathname componenth]h lookup single pathname component}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjnhhubah}(h]h ]h"]h$]h&]uh1jvhjphhhjhM ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjOghNhNubj)}(hXt**Parameters** ``const struct mnt_idmap *idmap`` idmap of the mount the lookup is performed from ``struct qstr *name`` qstr holding pathname component to lookup ``struct dentry *base`` base directory to lookup from **Description** This can be used for in-kernel filesystem clients such as file servers. Unlike lookup_one, it should be called without the parent i_rwsem held, and will take the i_rwsem itself if necessary. **Return** - A dentry, possibly negative, or - same errors as try_lookup_noperm() or - ERR_PTR(-ENOENT) if parent has been removed, or - ERR_PTR(-EACCES) if parent directory is not searchable.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjubj)}(hhh](j)}(hR``const struct mnt_idmap *idmap`` idmap of the mount the lookup is performed from h](j)}(h!``const struct mnt_idmap *idmap``h]j)}(hjh]hconst struct mnt_idmap *idmap}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjubj)}(hhh]h)}(h/idmap of the mount the lookup is performed fromh]h/idmap of the mount the lookup is performed from}(hjˌhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjnjhM hjȌubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjnjhM hjubj)}(h@``struct qstr *name`` qstr holding pathname component to lookup h](j)}(h``struct qstr *name``h]j)}(hjh]hstruct qstr *name}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjubj)}(hhh]h)}(h)qstr holding pathname component to lookuph]h)qstr holding pathname component to lookup}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hjubj)}(h6``struct dentry *base`` base directory to lookup from h](j)}(h``struct dentry *base``h]j)}(hj$h]hstruct dentry *base}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj"ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjubj)}(hhh]h)}(hbase directory to lookup fromh]hbase directory to lookup from}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj9hM hj:ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj9hM hjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hj_h]h Description}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1jhj]ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjubh)}(hGThis can be used for in-kernel filesystem clients such as file servers.h]hGThis can be used for in-kernel filesystem clients such as file servers.}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjubh)}(hvUnlike lookup_one, it should be called without the parent i_rwsem held, and will take the i_rwsem itself if necessary.h]hvUnlike lookup_one, it should be called without the parent i_rwsem held, and will take the i_rwsem itself if necessary.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjubh)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjubjE)}(hhh](jE)}(hA dentry, possibly negative, orh]h)}(hjh]hA dentry, possibly negative, or}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjubah}(h]h ]h"]h$]h&]uh1jEhjubjE)}(h%same errors as try_lookup_noperm() orh]h)}(hjȍh]h%same errors as try_lookup_noperm() or}(hjʍhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjƍubah}(h]h ]h"]h$]h&]uh1jEhjubjE)}(h/ERR_PTR(-ENOENT) if parent has been removed, orh]h)}(hjh]h/ERR_PTR(-ENOENT) if parent has been removed, or}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjލubah}(h]h ]h"]h$]h&]uh1jEhjubjE)}(h7ERR_PTR(-EACCES) if parent directory is not searchable.h]h)}(hjh]h7ERR_PTR(-EACCES) if parent directory is not searchable.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjubah}(h]h ]h"]h$]h&]uh1jEhjubeh}(h]h ]h"]h$]h&]jEj2uh1jEhjhM hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j )lookup_one_positive_killable (C function)c.lookup_one_positive_killablehNtauh1hhjOghhhNhNubj)}(hhh](j)}(htstruct dentry * lookup_one_positive_killable (const struct mnt_idmap *idmap, struct qstr *name, struct dentry *base)h]j)}(hrstruct dentry *lookup_one_positive_killable(const struct mnt_idmap *idmap, struct qstr *name, struct dentry *base)h](j )}(hjh]hstruct}(hj4hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj0hhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM ubj2)}(h h]h }(hjBhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj0hhhjAhM ubh)}(hhh]jI)}(hdentryh]hdentry}(hjShhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjPubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjUmodnameN classnameNjj )}j ]j)}jlookup_one_positive_killablesbc.lookup_one_positive_killableasbuh1hhj0hhhjAhM ubj2)}(h h]h }(hjthhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj0hhhjAhM ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0hhhjAhM ubjC)}(hlookup_one_positive_killableh]jI)}(hjqh]hlookup_one_positive_killable}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj0hhhjAhM ubj=)}(hG(const struct mnt_idmap *idmap, struct qstr *name, struct dentry *base)h](jC)}(hconst struct mnt_idmap *idmaph](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj )}(hjh]hstruct}(hjɎhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hj֎hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(h mnt_idmaph]h mnt_idmap}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]joc.lookup_one_positive_killableasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hidmaph]hidmap}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct qstr *nameh](j )}(hjh]hstruct}(hj9hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj5ubj2)}(h h]h }(hjFhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj5ubh)}(hhh]jI)}(hqstrh]hqstr}(hjWhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjTubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjYmodnameN classnameNjj )}j ]joc.lookup_one_positive_killableasbuh1hhj5ubj2)}(h h]h }(hjuhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj5ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5ubjI)}(hnameh]hname}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj5ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct dentry *baseh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hdentryh]hdentry}(hjǏhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjďubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjɏmodnameN classnameNjj )}j ]joc.lookup_one_positive_killableasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hbaseh]hbase}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hj0hhhjAhM ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj,hhhjAhM ubah}(h]j'ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjAhM hj)hhubjw)}(hhh]h)}(h lookup single pathname componenth]h lookup single pathname component}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hj'hhubah}(h]h ]h"]h$]h&]uh1jvhj)hhhjAhM ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjBjjBjjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``const struct mnt_idmap *idmap`` idmap of the mount the lookup is performed from ``struct qstr *name`` qstr holding pathname component to lookup ``struct dentry *base`` base directory to lookup from **Description** This helper will yield ERR_PTR(-ENOENT) on negatives. The helper returns known positive or ERR_PTR(). This is what most of the users want. Note that pinned negative with unlocked parent _can_ become positive at any time, so callers of lookup_one_unlocked() need to be very careful; pinned positives have >d_inode stable, so this one avoids such problems. This can be used for in-kernel filesystem clients such as file servers. It should be called without the parent i_rwsem held, and will take the i_rwsem itself if necessary. If a fatal signal is pending or delivered, it will return ``-EINTR`` if the lock is needed. **Return** A positive dentry, or - same errors as lookup_one_unlocked() or - ERR_PTR(-EINTR) if a fatal signal is pending.h](h)}(h**Parameters**h]j)}(hjLh]h Parameters}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjJubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjFubj)}(hhh](j)}(hR``const struct mnt_idmap *idmap`` idmap of the mount the lookup is performed from h](j)}(h!``const struct mnt_idmap *idmap``h]j)}(hjkh]hconst struct mnt_idmap *idmap}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjiubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjeubj)}(hhh]h)}(h/idmap of the mount the lookup is performed fromh]h/idmap of the mount the lookup is performed from}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjeubeh}(h]h ]h"]h$]h&]uh1jhjhM hjbubj)}(h@``struct qstr *name`` qstr holding pathname component to lookup h](j)}(h``struct qstr *name``h]j)}(hjh]hstruct qstr *name}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjubj)}(hhh]h)}(h)qstr holding pathname component to lookuph]h)qstr holding pathname component to lookup}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hjbubj)}(h6``struct dentry *base`` base directory to lookup from h](j)}(h``struct dentry *base``h]j)}(hjݐh]hstruct dentry *base}(hjߐhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjېubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjאubj)}(hhh]h)}(hbase directory to lookup fromh]hbase directory to lookup from}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjאubeh}(h]h ]h"]h$]h&]uh1jhjhM hjbubeh}(h]h ]h"]h$]h&]uh1jhjFubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjFubh)}(hThis helper will yield ERR_PTR(-ENOENT) on negatives. The helper returns known positive or ERR_PTR(). This is what most of the users want.h]hThis helper will yield ERR_PTR(-ENOENT) on negatives. The helper returns known positive or ERR_PTR(). This is what most of the users want.}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjFubh)}(hNote that pinned negative with unlocked parent _can_ become positive at any time, so callers of lookup_one_unlocked() need to be very careful; pinned positives have >d_inode stable, so this one avoids such problems.h]hNote that pinned negative with unlocked parent _can_ become positive at any time, so callers of lookup_one_unlocked() need to be very careful; pinned positives have >d_inode stable, so this one avoids such problems.}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjFubh)}(hGThis can be used for in-kernel filesystem clients such as file servers.h]hGThis can be used for in-kernel filesystem clients such as file servers.}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjFubh)}(hIt should be called without the parent i_rwsem held, and will take the i_rwsem itself if necessary. If a fatal signal is pending or delivered, it will return ``-EINTR`` if the lock is needed.h](hIt should be called without the parent i_rwsem held, and will take the i_rwsem itself if necessary. If a fatal signal is pending or delivered, it will return }(hj[hhhNhNubj)}(h ``-EINTR``h]h-EINTR}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jhj[ubh if the lock is needed.}(hj[hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjFubh)}(h **Return**h]j)}(hj~h]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj|ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjFubh)}(hoA positive dentry, or - same errors as lookup_one_unlocked() or - ERR_PTR(-EINTR) if a fatal signal is pending.h]hoA positive dentry, or - same errors as lookup_one_unlocked() or - ERR_PTR(-EINTR) if a fatal signal is pending.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjFubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j )lookup_one_positive_unlocked (C function)c.lookup_one_positive_unlockedhNtauh1hhjOghhhNhNubj)}(hhh](j)}(htstruct dentry * lookup_one_positive_unlocked (const struct mnt_idmap *idmap, struct qstr *name, struct dentry *base)h]j)}(hrstruct dentry *lookup_one_positive_unlocked(const struct mnt_idmap *idmap, struct qstr *name, struct dentry *base)h](j )}(hjh]hstruct}(hjÑhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM ubj2)}(h h]h }(hjёhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjБhM ubh)}(hhh]jI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjߑubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jlookup_one_positive_unlockedsbc.lookup_one_positive_unlockedasbuh1hhjhhhjБhM ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjБhM ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjБhM ubjC)}(hlookup_one_positive_unlockedh]jI)}(hjh]hlookup_one_positive_unlocked}(hj"hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjБhM ubj=)}(hG(const struct mnt_idmap *idmap, struct qstr *name, struct dentry *base)h](jC)}(hconst struct mnt_idmap *idmaph](j )}(hjJh]hconst}(hj=hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj9ubj2)}(h h]h }(hjJhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj9ubj )}(hjh]hstruct}(hjXhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj9ubj2)}(h h]h }(hjehhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj9ubh)}(hhh]jI)}(h mnt_idmaph]h mnt_idmap}(hjvhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjsubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjxmodnameN classnameNjj )}j ]jc.lookup_one_positive_unlockedasbuh1hhj9ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj9ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9ubjI)}(hidmaph]hidmap}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj9ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj5ubjC)}(hstruct qstr *nameh](j )}(hjh]hstruct}(hjȒhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjĒubj2)}(h h]h }(hjՒhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjĒubh)}(hhh]jI)}(hqstrh]hqstr}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.lookup_one_positive_unlockedasbuh1hhjĒubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjĒubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjĒubjI)}(hnameh]hname}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjĒubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj5ubjC)}(hstruct dentry *baseh](j )}(hjh]hstruct}(hj8hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj4ubj2)}(h h]h }(hjEhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj4ubh)}(hhh]jI)}(hdentryh]hdentry}(hjVhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjSubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjXmodnameN classnameNjj )}j ]jc.lookup_one_positive_unlockedasbuh1hhj4ubj2)}(h h]h }(hjthhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj4ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4ubjI)}(hbaseh]hbase}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj4ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj5ubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjБhM ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjБhM ubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjБhM hjhhubjw)}(hhh]h)}(h lookup single pathname componenth]h lookup single pathname component}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjБhM ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjѓjjѓjjjuh1jhhhjOghNhNubj)}(hXR**Parameters** ``const struct mnt_idmap *idmap`` idmap of the mount the lookup is performed from ``struct qstr *name`` qstr holding pathname component to lookup ``struct dentry *base`` base directory to lookup from **Description** This helper will yield ERR_PTR(-ENOENT) on negatives. The helper returns known positive or ERR_PTR(). This is what most of the users want. Note that pinned negative with unlocked parent _can_ become positive at any time, so callers of lookup_one_unlocked() need to be very careful; pinned positives have >d_inode stable, so this one avoids such problems. This can be used for in-kernel filesystem clients such as file servers. The helper should be called without i_rwsem held. **Return** A positive dentry, or - ERR_PTR(-ENOENT) if the name could not be found, or - same errors as lookup_one_unlocked().h](h)}(h**Parameters**h]j)}(hjۓh]h Parameters}(hjݓhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjٓubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjՓubj)}(hhh](j)}(hR``const struct mnt_idmap *idmap`` idmap of the mount the lookup is performed from h](j)}(h!``const struct mnt_idmap *idmap``h]j)}(hjh]hconst struct mnt_idmap *idmap}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjubj)}(hhh]h)}(h/idmap of the mount the lookup is performed fromh]h/idmap of the mount the lookup is performed from}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hjubj)}(h@``struct qstr *name`` qstr holding pathname component to lookup h](j)}(h``struct qstr *name``h]j)}(hj3h]hstruct qstr *name}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj1ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hj-ubj)}(hhh]h)}(h)qstr holding pathname component to lookuph]h)qstr holding pathname component to lookup}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjHhM hjIubah}(h]h ]h"]h$]h&]uh1jhj-ubeh}(h]h ]h"]h$]h&]uh1jhjHhM hjubj)}(h6``struct dentry *base`` base directory to lookup from h](j)}(h``struct dentry *base``h]j)}(hjlh]hstruct dentry *base}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjfubj)}(hhh]h)}(hbase directory to lookup fromh]hbase directory to lookup from}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjfubeh}(h]h ]h"]h$]h&]uh1jhjhM hjubeh}(h]h ]h"]h$]h&]uh1jhjՓubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjՓubh)}(hThis helper will yield ERR_PTR(-ENOENT) on negatives. The helper returns known positive or ERR_PTR(). This is what most of the users want.h]hThis helper will yield ERR_PTR(-ENOENT) on negatives. The helper returns known positive or ERR_PTR(). This is what most of the users want.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjՓubh)}(hNote that pinned negative with unlocked parent _can_ become positive at any time, so callers of lookup_one_unlocked() need to be very careful; pinned positives have >d_inode stable, so this one avoids such problems.h]hNote that pinned negative with unlocked parent _can_ become positive at any time, so callers of lookup_one_unlocked() need to be very careful; pinned positives have >d_inode stable, so this one avoids such problems.}(hj̔hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjՓubh)}(hGThis can be used for in-kernel filesystem clients such as file servers.h]hGThis can be used for in-kernel filesystem clients such as file servers.}(hj۔hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjՓubh)}(h1The helper should be called without i_rwsem held.h]h1The helper should be called without i_rwsem held.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjՓubh)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjՓubh)}(hsA positive dentry, or - ERR_PTR(-ENOENT) if the name could not be found, or - same errors as lookup_one_unlocked().h]hsA positive dentry, or - ERR_PTR(-ENOENT) if the name could not be found, or - same errors as lookup_one_unlocked().}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjՓubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j #lookup_noperm_unlocked (C function)c.lookup_noperm_unlockedhNtauh1hhjOghhhNhNubj)}(hhh](j)}(hOstruct dentry * lookup_noperm_unlocked (struct qstr *name, struct dentry *base)h]j)}(hMstruct dentry *lookup_noperm_unlocked(struct qstr *name, struct dentry *base)h](j )}(hjh]hstruct}(hj@hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj<hhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM ubj2)}(h h]h }(hjNhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj<hhhjMhM ubh)}(hhh]jI)}(hdentryh]hdentry}(hj_hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj\ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjamodnameN classnameNjj )}j ]j)}jlookup_noperm_unlockedsbc.lookup_noperm_unlockedasbuh1hhj<hhhjMhM ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj<hhhjMhM ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj<hhhjMhM ubjC)}(hlookup_noperm_unlockedh]jI)}(hj}h]hlookup_noperm_unlocked}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj<hhhjMhM ubj=)}(h((struct qstr *name, struct dentry *base)h](jC)}(hstruct qstr *nameh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjǕhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hqstrh]hqstr}(hjؕhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjՕubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjڕmodnameN classnameNjj )}j ]j{c.lookup_noperm_unlockedasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hnameh]hname}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct dentry *baseh](j )}(hjh]hstruct}(hj*hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj&ubj2)}(h h]h }(hj7hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj&ubh)}(hhh]jI)}(hdentryh]hdentry}(hjHhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjEubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjJmodnameN classnameNjj )}j ]j{c.lookup_noperm_unlockedasbuh1hhj&ubj2)}(h h]h }(hjfhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj&ubj)}(hjh]h*}(hjthhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubjI)}(hbaseh]hbase}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj&ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hj<hhhjMhM ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj8hhhjMhM ubah}(h]j3ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjMhM hj5hhubjw)}(hhh]h)}(h5filesystem helper to lookup single pathname componenth]h5filesystem helper to lookup single pathname component}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjhhubah}(h]h ]h"]h$]h&]uh1jvhj5hhhjMhM ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjÖjjÖjjjuh1jhhhjOghNhNubj)}(hXl**Parameters** ``struct qstr *name`` pathname component to lookup ``struct dentry *base`` base directory to lookup from **Description** Note that this routine is purely a helper for filesystem usage and should not be called by generic code. It does no permission checking. Unlike lookup_noperm(), it should be called without the parent i_rwsem held, and will take the i_rwsem itself if necessary. Unlike try_lookup_noperm() it *does* revalidate the dentry if it already existed. **Return** A dentry, possibly negative, or - ERR_PTR(-ENOENT) if parent has been removed, or - same errors as try_lookup_noperm()h](h)}(h**Parameters**h]j)}(hj͖h]h Parameters}(hjϖhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj˖ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjǖubj)}(hhh](j)}(h3``struct qstr *name`` pathname component to lookup h](j)}(h``struct qstr *name``h]j)}(hjh]hstruct qstr *name}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjubj)}(hhh]h)}(hpathname component to lookuph]hpathname component to lookup}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hjubj)}(h6``struct dentry *base`` base directory to lookup from h](j)}(h``struct dentry *base``h]j)}(hj%h]hstruct dentry *base}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj#ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjubj)}(hhh]h)}(hbase directory to lookup fromh]hbase directory to lookup from}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj:hM hj;ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj:hM hjubeh}(h]h ]h"]h$]h&]uh1jhjǖubh)}(h**Description**h]j)}(hj`h]h Description}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj^ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjǖubh)}(hNote that this routine is purely a helper for filesystem usage and should not be called by generic code. It does no permission checking.h]hNote that this routine is purely a helper for filesystem usage and should not be called by generic code. It does no permission checking.}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjǖubh)}(h{Unlike lookup_noperm(), it should be called without the parent i_rwsem held, and will take the i_rwsem itself if necessary.h]h{Unlike lookup_noperm(), it should be called without the parent i_rwsem held, and will take the i_rwsem itself if necessary.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjǖubh)}(hQUnlike try_lookup_noperm() it *does* revalidate the dentry if it already existed.h](hUnlike try_lookup_noperm() it }(hjhhhNhNubj )}(h*does*h]hdoes}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j~ hjubh- revalidate the dentry if it already existed.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjǖubh)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjǖubh)}(hvA dentry, possibly negative, or - ERR_PTR(-ENOENT) if parent has been removed, or - same errors as try_lookup_noperm()h]hvA dentry, possibly negative, or - ERR_PTR(-ENOENT) if parent has been removed, or - same errors as try_lookup_noperm()}(hj͗hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjǖubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j start_creating (C function)c.start_creatinghNtauh1hhjOghhhNhNubj)}(hhh](j)}(hhstruct dentry * start_creating (const struct mnt_idmap *idmap, struct dentry *parent, struct qstr *name)h]j)}(hfstruct dentry *start_creating(const struct mnt_idmap *idmap, struct dentry *parent, struct qstr *name)h](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM> ubj2)}(h h]h }(hj hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhj hM> ubh)}(hhh]jI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jstart_creatingsbc.start_creatingasbuh1hhjhhhj hM> ubj2)}(h h]h }(hj<hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhj hM> ubj)}(hjh]h*}(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhj hM> ubjC)}(hstart_creatingh]jI)}(hj9h]hstart_creating}(hj[hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjWubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhj hM> ubj=)}(hI(const struct mnt_idmap *idmap, struct dentry *parent, struct qstr *name)h](jC)}(hconst struct mnt_idmap *idmaph](j )}(hjJh]hconst}(hjvhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjrubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjrubj )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjrubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjrubh)}(hhh]jI)}(h mnt_idmaph]h mnt_idmap}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j7c.start_creatingasbuh1hhjrubj2)}(h h]h }(hj͘hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjrubj)}(hjh]h*}(hjۘhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjrubjI)}(hidmaph]hidmap}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjrubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjnubjC)}(hstruct dentry *parenth](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj!modnameN classnameNjj )}j ]j7c.start_creatingasbuh1hhjubj2)}(h h]h }(hj=hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hparenth]hparent}(hjXhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjnubjC)}(hstruct qstr *nameh](j )}(hjh]hstruct}(hjqhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjmubj2)}(h h]h }(hj~hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjmubh)}(hhh]jI)}(hqstrh]hqstr}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j7c.start_creatingasbuh1hhjmubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjmubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmubjI)}(hnameh]hname}(hjșhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjmubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjnubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhj hM> ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhj hM> ubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj hM> hjhhubjw)}(hhh]h)}(hAprepare to access or create a given name with permission checkingh]hAprepare to access or create a given name with permission checking}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM> hjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhj hM> ubeh}(h]h ](jfunctioneh"]h$]h&]jjjj jj jjjuh1jhhhjOghNhNubj)}(hX5**Parameters** ``const struct mnt_idmap *idmap`` idmap of the mount ``struct dentry *parent`` directory in which to prepare to create the name ``struct qstr *name`` the name to be created **Description** Locks are taken and a lookup is performed prior to creating an object in a directory. Permission checking (MAY_EXEC) is performed against **idmap**. If the name already exists, a positive dentry is returned, so behaviour is similar to O_CREAT without O_EXCL, which doesn't fail with -EEXIST. **Return** a negative or positive dentry, or an error.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMB hjubj)}(hhh](j)}(h5``const struct mnt_idmap *idmap`` idmap of the mount h](j)}(h!``const struct mnt_idmap *idmap``h]j)}(hj3h]hconst struct mnt_idmap *idmap}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj1ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM? hj-ubj)}(hhh]h)}(hidmap of the mounth]hidmap of the mount}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjHhM? hjIubah}(h]h ]h"]h$]h&]uh1jhj-ubeh}(h]h ]h"]h$]h&]uh1jhjHhM? hj*ubj)}(hK``struct dentry *parent`` directory in which to prepare to create the name h](j)}(h``struct dentry *parent``h]j)}(hjlh]hstruct dentry *parent}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM@ hjfubj)}(hhh]h)}(h0directory in which to prepare to create the nameh]h0directory in which to prepare to create the name}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM@ hjubah}(h]h ]h"]h$]h&]uh1jhjfubeh}(h]h ]h"]h$]h&]uh1jhjhM@ hj*ubj)}(h-``struct qstr *name`` the name to be created h](j)}(h``struct qstr *name``h]j)}(hjh]hstruct qstr *name}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMA hjubj)}(hhh]h)}(hthe name to be createdh]hthe name to be created}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMA hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMA hj*ubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjޚubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMC hjubh)}(hLocks are taken and a lookup is performed prior to creating an object in a directory. Permission checking (MAY_EXEC) is performed against **idmap**.h](hLocks are taken and a lookup is performed prior to creating an object in a directory. Permission checking (MAY_EXEC) is performed against }(hjhhhNhNubj)}(h **idmap**h]hidmap}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMB hjubh)}(hIf the name already exists, a positive dentry is returned, so behaviour is similar to O_CREAT without O_EXCL, which doesn't fail with -EEXIST.h]hIf the name already exists, a positive dentry is returned, so behaviour is similar to O_CREAT without O_EXCL, which doesn’t fail with -EEXIST.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMF hjubh)}(h **Return**h]j)}(hj(h]hReturn}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj&ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMJ hjubh)}(h+a negative or positive dentry, or an error.h]h+a negative or positive dentry, or an error.}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMK hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j start_removing (C function)c.start_removinghNtauh1hhjOghhhNhNubj)}(hhh](j)}(hhstruct dentry * start_removing (const struct mnt_idmap *idmap, struct dentry *parent, struct qstr *name)h]j)}(hfstruct dentry *start_removing(const struct mnt_idmap *idmap, struct dentry *parent, struct qstr *name)h](j )}(hjh]hstruct}(hjmhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjihhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMY ubj2)}(h h]h }(hj{hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjihhhjzhMY ubh)}(hhh]jI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jstart_removingsbc.start_removingasbuh1hhjihhhjzhMY ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjihhhjzhMY ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjihhhjzhMY ubjC)}(hstart_removingh]jI)}(hjh]hstart_removing}(hj̛hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjțubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjihhhjzhMY ubj=)}(hI(const struct mnt_idmap *idmap, struct dentry *parent, struct qstr *name)h](jC)}(hconst struct mnt_idmap *idmaph](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(h mnt_idmaph]h mnt_idmap}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj"modnameN classnameNjj )}j ]jc.start_removingasbuh1hhjubj2)}(h h]h }(hj>hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjLhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hidmaph]hidmap}(hjYhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjߛubjC)}(hstruct dentry *parenth](j )}(hjh]hstruct}(hjrhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjnubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjnubh)}(hhh]jI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.start_removingasbuh1hhjnubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjnubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnubjI)}(hparenth]hparent}(hjɜhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjnubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjߛubjC)}(hstruct qstr *nameh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjޜubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjޜubh)}(hhh]jI)}(hqstrh]hqstr}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.start_removingasbuh1hhjޜubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjޜubj)}(hjh]h*}(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjޜubjI)}(hnameh]hname}(hj9hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjޜubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjߛubeh}(h]h ]h"]h$]h&]j`jauh1j<hjihhhjzhMY ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjehhhjzhMY ubah}(h]j`ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjzhMY hjbhhubjw)}(hhh]h)}(h7prepare to remove a given name with permission checkingh]h7prepare to remove a given name with permission checking}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMY hj`hhubah}(h]h ]h"]h$]h&]uh1jvhjbhhhjzhMY ubeh}(h]h ](jfunctioneh"]h$]h&]jjjj{jj{jjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``const struct mnt_idmap *idmap`` idmap of the mount ``struct dentry *parent`` directory in which to find the name ``struct qstr *name`` the name to be removed **Description** Locks are taken and a lookup is performed prior to removing an object from a directory. Permission checking (MAY_EXEC) is performed against **idmap**. If the name doesn't exist, an error is returned. end_removing() should be called when removal is complete, or aborted. **Return** a positive dentry, or an error.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM] hjubj)}(hhh](j)}(h5``const struct mnt_idmap *idmap`` idmap of the mount h](j)}(h!``const struct mnt_idmap *idmap``h]j)}(hjh]hconst struct mnt_idmap *idmap}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMZ hjubj)}(hhh]h)}(hidmap of the mounth]hidmap of the mount}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMZ hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMZ hjubj)}(h>``struct dentry *parent`` directory in which to find the name h](j)}(h``struct dentry *parent``h]j)}(hjݝh]hstruct dentry *parent}(hjߝhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj۝ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM[ hjםubj)}(hhh]h)}(h#directory in which to find the nameh]h#directory in which to find the name}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM[ hjubah}(h]h ]h"]h$]h&]uh1jhjםubeh}(h]h ]h"]h$]h&]uh1jhjhM[ hjubj)}(h-``struct qstr *name`` the name to be removed h](j)}(h``struct qstr *name``h]j)}(hjh]hstruct qstr *name}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM\ hjubj)}(hhh]h)}(hthe name to be removedh]hthe name to be removed}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj+hM\ hj,ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj+hM\ hjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjQh]h Description}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1jhjOubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM^ hjubh)}(hLocks are taken and a lookup is performed prior to removing an object from a directory. Permission checking (MAY_EXEC) is performed against **idmap**.h](hLocks are taken and a lookup is performed prior to removing an object from a directory. Permission checking (MAY_EXEC) is performed against }(hjghhhNhNubj)}(h **idmap**h]hidmap}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1jhjgubh.}(hjghhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM] hjubh)}(h0If the name doesn't exist, an error is returned.h]h2If the name doesn’t exist, an error is returned.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMa hjubh)}(hEend_removing() should be called when removal is complete, or aborted.h]hEend_removing() should be called when removal is complete, or aborted.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMc hjubh)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMe hjubh)}(ha positive dentry, or an error.h]ha positive dentry, or an error.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMf hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j $start_creating_killable (C function)c.start_creating_killablehNtauh1hhjOghhhNhNubj)}(hhh](j)}(hqstruct dentry * start_creating_killable (const struct mnt_idmap *idmap, struct dentry *parent, struct qstr *name)h]j)}(hostruct dentry *start_creating_killable(const struct mnt_idmap *idmap, struct dentry *parent, struct qstr *name)h](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMt ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMt ubh)}(hhh]jI)}(hdentryh]hdentry}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jstart_creating_killablesbc.start_creating_killableasbuh1hhjhhhjhMt ubj2)}(h h]h }(hj-hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMt ubj)}(hjh]h*}(hj;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMt ubjC)}(hstart_creating_killableh]jI)}(hj*h]hstart_creating_killable}(hjLhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjHubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhMt ubj=)}(hI(const struct mnt_idmap *idmap, struct dentry *parent, struct qstr *name)h](jC)}(hconst struct mnt_idmap *idmaph](j )}(hjJh]hconst}(hjghhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjcubj2)}(h h]h }(hjthhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjcubj )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjcubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjcubh)}(hhh]jI)}(h mnt_idmaph]h mnt_idmap}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j(c.start_creating_killableasbuh1hhjcubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjcubj)}(hjh]h*}(hj̟hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjcubjI)}(hidmaph]hidmap}(hjٟhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjcubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj_ubjC)}(hstruct dentry *parenth](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j(c.start_creating_killableasbuh1hhjubj2)}(h h]h }(hj.hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj<hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hparenth]hparent}(hjIhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj_ubjC)}(hstruct qstr *nameh](j )}(hjh]hstruct}(hjbhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj^ubj2)}(h h]h }(hjohhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj^ubh)}(hhh]jI)}(hqstrh]hqstr}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj}ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j(c.start_creating_killableasbuh1hhj^ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj^ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^ubjI)}(hnameh]hname}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj^ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj_ubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhMt ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhMt ubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMt hjhhubjw)}(hhh]h)}(h7prepare to create a given name with permission checkingh]h7prepare to create a given name with permission checking}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMt hjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhMt ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjOghNhNubj)}(hX3**Parameters** ``const struct mnt_idmap *idmap`` idmap of the mount ``struct dentry *parent`` directory in which to prepare to create the name ``struct qstr *name`` the name to be created **Description** Locks are taken and a lookup is performed prior to creating an object in a directory. Permission checking (MAY_EXEC) is performed against **idmap**. If the name already exists, a positive dentry is returned. If a signal is received or was already pending, the function aborts with -EINTR; **Return** a negative or positive dentry, or an error.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMx hjubj)}(hhh](j)}(h5``const struct mnt_idmap *idmap`` idmap of the mount h](j)}(h!``const struct mnt_idmap *idmap``h]j)}(hj$h]hconst struct mnt_idmap *idmap}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj"ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMu hjubj)}(hhh]h)}(hidmap of the mounth]hidmap of the mount}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj9hMu hj:ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj9hMu hjubj)}(hK``struct dentry *parent`` directory in which to prepare to create the name h](j)}(h``struct dentry *parent``h]j)}(hj]h]hstruct dentry *parent}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj[ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMv hjWubj)}(hhh]h)}(h0directory in which to prepare to create the nameh]h0directory in which to prepare to create the name}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjrhMv hjsubah}(h]h ]h"]h$]h&]uh1jhjWubeh}(h]h ]h"]h$]h&]uh1jhjrhMv hjubj)}(h-``struct qstr *name`` the name to be created h](j)}(h``struct qstr *name``h]j)}(hjh]hstruct qstr *name}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMw hjubj)}(hhh]h)}(hthe name to be createdh]hthe name to be created}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMw hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMw hjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjѡh]h Description}(hjӡhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjϡubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMy hjubh)}(hLocks are taken and a lookup is performed prior to creating an object in a directory. Permission checking (MAY_EXEC) is performed against **idmap**.h](hLocks are taken and a lookup is performed prior to creating an object in a directory. Permission checking (MAY_EXEC) is performed against }(hjhhhNhNubj)}(h **idmap**h]hidmap}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMx hjubh)}(h:If the name already exists, a positive dentry is returned.h]h:If the name already exists, a positive dentry is returned.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM| hjubh)}(hPIf a signal is received or was already pending, the function aborts with -EINTR;h]hPIf a signal is received or was already pending, the function aborts with -EINTR;}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM~ hjubh)}(h **Return**h]j)}(hj(h]hReturn}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj&ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjubh)}(h+a negative or positive dentry, or an error.h]h+a negative or positive dentry, or an error.}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j $start_removing_killable (C function)c.start_removing_killablehNtauh1hhjOghhhNhNubj)}(hhh](j)}(hqstruct dentry * start_removing_killable (const struct mnt_idmap *idmap, struct dentry *parent, struct qstr *name)h]j)}(hostruct dentry *start_removing_killable(const struct mnt_idmap *idmap, struct dentry *parent, struct qstr *name)h](j )}(hjh]hstruct}(hjmhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjihhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM ubj2)}(h h]h }(hj{hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjihhhjzhM ubh)}(hhh]jI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jstart_removing_killablesbc.start_removing_killableasbuh1hhjihhhjzhM ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjihhhjzhM ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjihhhjzhM ubjC)}(hstart_removing_killableh]jI)}(hjh]hstart_removing_killable}(hj̢hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjȢubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjihhhjzhM ubj=)}(hI(const struct mnt_idmap *idmap, struct dentry *parent, struct qstr *name)h](jC)}(hconst struct mnt_idmap *idmaph](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(h mnt_idmaph]h mnt_idmap}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj"modnameN classnameNjj )}j ]jc.start_removing_killableasbuh1hhjubj2)}(h h]h }(hj>hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjLhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hidmaph]hidmap}(hjYhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjߢubjC)}(hstruct dentry *parenth](j )}(hjh]hstruct}(hjrhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjnubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjnubh)}(hhh]jI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.start_removing_killableasbuh1hhjnubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjnubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnubjI)}(hparenth]hparent}(hjɣhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjnubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjߢubjC)}(hstruct qstr *nameh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjޣubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjޣubh)}(hhh]jI)}(hqstrh]hqstr}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.start_removing_killableasbuh1hhjޣubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjޣubj)}(hjh]h*}(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjޣubjI)}(hnameh]hname}(hj9hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjޣubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjߢubeh}(h]h ]h"]h$]h&]j`jauh1j<hjihhhjzhM ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjehhhjzhM ubah}(h]j`ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjzhM hjbhhubjw)}(hhh]h)}(h7prepare to remove a given name with permission checkingh]h7prepare to remove a given name with permission checking}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hj`hhubah}(h]h ]h"]h$]h&]uh1jvhjbhhhjzhM ubeh}(h]h ](jfunctioneh"]h$]h&]jjjj{jj{jjjuh1jhhhjOghNhNubj)}(hXY**Parameters** ``const struct mnt_idmap *idmap`` idmap of the mount ``struct dentry *parent`` directory in which to find the name ``struct qstr *name`` the name to be removed **Description** Locks are taken and a lookup is performed prior to removing an object from a directory. Permission checking (MAY_EXEC) is performed against **idmap**. If the name doesn't exist, an error is returned. end_removing() should be called when removal is complete, or aborted. If a signal is received or was already pending, the function aborts with -EINTR; **Return** a positive dentry, or an error.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjubj)}(hhh](j)}(h5``const struct mnt_idmap *idmap`` idmap of the mount h](j)}(h!``const struct mnt_idmap *idmap``h]j)}(hjh]hconst struct mnt_idmap *idmap}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjubj)}(hhh]h)}(hidmap of the mounth]hidmap of the mount}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hjubj)}(h>``struct dentry *parent`` directory in which to find the name h](j)}(h``struct dentry *parent``h]j)}(hjݤh]hstruct dentry *parent}(hjߤhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjۤubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjפubj)}(hhh]h)}(h#directory in which to find the nameh]h#directory in which to find the name}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjפubeh}(h]h ]h"]h$]h&]uh1jhjhM hjubj)}(h-``struct qstr *name`` the name to be removed h](j)}(h``struct qstr *name``h]j)}(hjh]hstruct qstr *name}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjubj)}(hhh]h)}(hthe name to be removedh]hthe name to be removed}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj+hM hj,ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj+hM hjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjQh]h Description}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1jhjOubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjubh)}(hLocks are taken and a lookup is performed prior to removing an object from a directory. Permission checking (MAY_EXEC) is performed against **idmap**.h](hLocks are taken and a lookup is performed prior to removing an object from a directory. Permission checking (MAY_EXEC) is performed against }(hjghhhNhNubj)}(h **idmap**h]hidmap}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1jhjgubh.}(hjghhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjubh)}(h0If the name doesn't exist, an error is returned.h]h2If the name doesn’t exist, an error is returned.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjubh)}(hEend_removing() should be called when removal is complete, or aborted.h]hEend_removing() should be called when removal is complete, or aborted.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjubh)}(hPIf a signal is received or was already pending, the function aborts with -EINTR;h]hPIf a signal is received or was already pending, the function aborts with -EINTR;}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjubh)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjubh)}(ha positive dentry, or an error.h]ha positive dentry, or an error.}(hjͥhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j "start_creating_noperm (C function)c.start_creating_nopermhNtauh1hhjOghhhNhNubj)}(hhh](j)}(hPstruct dentry * start_creating_noperm (struct dentry *parent, struct qstr *name)h]j)}(hNstruct dentry *start_creating_noperm(struct dentry *parent, struct qstr *name)h](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM ubj2)}(h h]h }(hj hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhj hM ubh)}(hhh]jI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jstart_creating_nopermsbc.start_creating_nopermasbuh1hhjhhhj hM ubj2)}(h h]h }(hj<hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhj hM ubj)}(hjh]h*}(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhj hM ubjC)}(hstart_creating_nopermh]jI)}(hj9h]hstart_creating_noperm}(hj[hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjWubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhj hM ubj=)}(h*(struct dentry *parent, struct qstr *name)h](jC)}(hstruct dentry *parenth](j )}(hjh]hstruct}(hjvhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjrubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjrubh)}(hhh]jI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j7c.start_creating_nopermasbuh1hhjrubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjrubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjrubjI)}(hparenth]hparent}(hjͦhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjrubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjnubjC)}(hstruct qstr *nameh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hqstrh]hqstr}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j7c.start_creating_nopermasbuh1hhjubj2)}(h h]h }(hj"hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hnameh]hname}(hj=hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjnubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhj hM ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhj hM ubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj hM hjhhubjw)}(hhh]h)}(h:prepare to create a given name without permission checkingh]h:prepare to create a given name without permission checking}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjdhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhj hM ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjOghNhNubj)}(hXi**Parameters** ``struct dentry *parent`` directory in which to prepare to create the name ``struct qstr *name`` the name to be created **Description** Locks are taken and a lookup is performed prior to creating an object in a directory. If the name already exists, a positive dentry is returned. **Return** a negative or positive dentry, or an error.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjubj)}(hhh](j)}(hK``struct dentry *parent`` directory in which to prepare to create the name h](j)}(h``struct dentry *parent``h]j)}(hjh]hstruct dentry *parent}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjubj)}(hhh]h)}(h0directory in which to prepare to create the nameh]h0directory in which to prepare to create the name}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hjubj)}(h-``struct qstr *name`` the name to be created h](j)}(h``struct qstr *name``h]j)}(hjh]hstruct qstr *name}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjߧubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjۧubj)}(hhh]h)}(hthe name to be createdh]hthe name to be created}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjۧubeh}(h]h ]h"]h$]h&]uh1jhjhM hjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjubh)}(hULocks are taken and a lookup is performed prior to creating an object in a directory.h]hULocks are taken and a lookup is performed prior to creating an object in a directory.}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjubh)}(h:If the name already exists, a positive dentry is returned.h]h:If the name already exists, a positive dentry is returned.}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjubh)}(h **Return**h]j)}(hjRh]hReturn}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jhjPubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjubh)}(h+a negative or positive dentry, or an error.h]h+a negative or positive dentry, or an error.}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j "start_removing_noperm (C function)c.start_removing_nopermhNtauh1hhjOghhhNhNubj)}(hhh](j)}(hPstruct dentry * start_removing_noperm (struct dentry *parent, struct qstr *name)h]j)}(hNstruct dentry *start_removing_noperm(struct dentry *parent, struct qstr *name)h](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhM ubh)}(hhh]jI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jstart_removing_nopermsbc.start_removing_nopermasbuh1hhjhhhjhM ubj2)}(h h]h }(hjרhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhM ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM ubjC)}(hstart_removing_nopermh]jI)}(hjԨh]hstart_removing_noperm}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhM ubj=)}(h*(struct dentry *parent, struct qstr *name)h](jC)}(hstruct dentry *parenth](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj ubh)}(hhh]jI)}(hdentryh]hdentry}(hj/hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj,ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj1modnameN classnameNjj )}j ]jҨc.start_removing_nopermasbuh1hhj ubj2)}(h h]h }(hjMhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj ubj)}(hjh]h*}(hj[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubjI)}(hparenth]hparent}(hjhhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj ubjC)}(hstruct qstr *nameh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj}ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj}ubh)}(hhh]jI)}(hqstrh]hqstr}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jҨc.start_removing_nopermasbuh1hhj}ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj}ubj)}(hjh]h*}(hj˩hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj}ubjI)}(hnameh]hname}(hjةhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj}ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj ubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhM ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhM ubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhM hjhhubjw)}(hhh]h)}(h:prepare to remove a given name without permission checkingh]h:prepare to remove a given name without permission checking}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhM ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``struct dentry *parent`` directory in which to find the name ``struct qstr *name`` the name to be removed **Description** Locks are taken and a lookup is performed prior to removing an object from a directory. If the name doesn't exist, an error is returned. end_removing() should be called when removal is complete, or aborted. **Return** a positive dentry, or an error.h](h)}(h**Parameters**h]j)}(hj$h]h Parameters}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj"ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjubj)}(hhh](j)}(h>``struct dentry *parent`` directory in which to find the name h](j)}(h``struct dentry *parent``h]j)}(hjCh]hstruct dentry *parent}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjAubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hj=ubj)}(hhh]h)}(h#directory in which to find the nameh]h#directory in which to find the name}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjXhM hjYubah}(h]h ]h"]h$]h&]uh1jhj=ubeh}(h]h ]h"]h$]h&]uh1jhjXhM hj:ubj)}(h-``struct qstr *name`` the name to be removed h](j)}(h``struct qstr *name``h]j)}(hj|h]hstruct qstr *name}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjzubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjvubj)}(hhh]h)}(hthe name to be removedh]hthe name to be removed}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjvubeh}(h]h ]h"]h$]h&]uh1jhjhM hj:ubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjubh)}(hWLocks are taken and a lookup is performed prior to removing an object from a directory.h]hWLocks are taken and a lookup is performed prior to removing an object from a directory.}(hjͪhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjubh)}(h0If the name doesn't exist, an error is returned.h]h2If the name doesn’t exist, an error is returned.}(hjܪhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjubh)}(hEend_removing() should be called when removal is complete, or aborted.h]hEend_removing() should be called when removal is complete, or aborted.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjubh)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjubh)}(ha positive dentry, or an error.h]ha positive dentry, or an error.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j "start_creating_dentry (C function)c.start_creating_dentryhNtauh1hhjOghhhNhNubj)}(hhh](j)}(hSstruct dentry * start_creating_dentry (struct dentry *parent, struct dentry *child)h]j)}(hQstruct dentry *start_creating_dentry(struct dentry *parent, struct dentry *child)h](j )}(hjh]hstruct}(hjAhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj=hhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM ubj2)}(h h]h }(hjOhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj=hhhjNhM ubh)}(hhh]jI)}(hdentryh]hdentry}(hj`hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj]ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjbmodnameN classnameNjj )}j ]j)}jstart_creating_dentrysbc.start_creating_dentryasbuh1hhj=hhhjNhM ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj=hhhjNhM ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=hhhjNhM ubjC)}(hstart_creating_dentryh]jI)}(hj~h]hstart_creating_dentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj=hhhjNhM ubj=)}(h-(struct dentry *parent, struct dentry *child)h](jC)}(hstruct dentry *parenth](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjȫhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hdentryh]hdentry}(hj٫hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj֫ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj۫modnameN classnameNjj )}j ]j|c.start_creating_dentryasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hparenth]hparent}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct dentry *childh](j )}(hjh]hstruct}(hj+hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj'ubj2)}(h h]h }(hj8hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj'ubh)}(hhh]jI)}(hdentryh]hdentry}(hjIhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjFubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjKmodnameN classnameNjj )}j ]j|c.start_creating_dentryasbuh1hhj'ubj2)}(h h]h }(hjghhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj'ubj)}(hjh]h*}(hjuhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj'ubjI)}(hchildh]hchild}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj'ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hj=hhhjNhM ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj9hhhjNhM ubah}(h]j4ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjNhM hj6hhubjw)}(hhh]h)}(h*prepare to access or create a given dentryh]h*prepare to access or create a given dentry}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjhhubah}(h]h ]h"]h$]h&]uh1jvhj6hhhjNhM ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjĬjjĬjjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``struct dentry *parent`` directory of dentry ``struct dentry *child`` the dentry to be prepared **Description** A lock is taken to protect the dentry against other dirops and the validity of the dentry is checked: correct parent and still hashed. If the dentry is valid and negative a reference is taken and returned. If not an error is returned. end_creating() should be called when creation is complete, or aborted. **Return** the valid dentry, or an error.h](h)}(h**Parameters**h]j)}(hjάh]h Parameters}(hjЬhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj̬ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjȬubj)}(hhh](j)}(h.``struct dentry *parent`` directory of dentry h](j)}(h``struct dentry *parent``h]j)}(hjh]hstruct dentry *parent}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjubj)}(hhh]h)}(hdirectory of dentryh]hdirectory of dentry}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hjubj)}(h3``struct dentry *child`` the dentry to be prepared h](j)}(h``struct dentry *child``h]j)}(hj&h]hstruct dentry *child}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj$ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hj ubj)}(hhh]h)}(hthe dentry to be preparedh]hthe dentry to be prepared}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj;hM hj<ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj;hM hjubeh}(h]h ]h"]h$]h&]uh1jhjȬubh)}(h**Description**h]j)}(hjah]h Description}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jhj_ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjȬubh)}(hA lock is taken to protect the dentry against other dirops and the validity of the dentry is checked: correct parent and still hashed.h]hA lock is taken to protect the dentry against other dirops and the validity of the dentry is checked: correct parent and still hashed.}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjȬubh)}(hdIf the dentry is valid and negative a reference is taken and returned. If not an error is returned.h]hdIf the dentry is valid and negative a reference is taken and returned. If not an error is returned.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjȬubh)}(hFend_creating() should be called when creation is complete, or aborted.h]hFend_creating() should be called when creation is complete, or aborted.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjȬubh)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjȬubh)}(hthe valid dentry, or an error.h]hthe valid dentry, or an error.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjȬubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j "start_removing_dentry (C function)c.start_removing_dentryhNtauh1hhjOghhhNhNubj)}(hhh](j)}(hSstruct dentry * start_removing_dentry (struct dentry *parent, struct dentry *child)h]j)}(hQstruct dentry *start_removing_dentry(struct dentry *parent, struct dentry *child)h](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMubh)}(hhh]jI)}(hdentryh]hdentry}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj modnameN classnameNjj )}j ]j)}jstart_removing_dentrysbc.start_removing_dentryasbuh1hhjhhhjhMubj2)}(h h]h }(hj+hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMubj)}(hjh]h*}(hj9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubjC)}(hstart_removing_dentryh]jI)}(hj(h]hstart_removing_dentry}(hjJhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjFubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhMubj=)}(h-(struct dentry *parent, struct dentry *child)h](jC)}(hstruct dentry *parenth](j )}(hjh]hstruct}(hjehhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjaubj2)}(h h]h }(hjrhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjaubh)}(hhh]jI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j&c.start_removing_dentryasbuh1hhjaubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjaubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubjI)}(hparenth]hparent}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjaubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj]ubjC)}(hstruct dentry *childh](j )}(hjh]hstruct}(hjծhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjѮubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjѮubh)}(hhh]jI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j&c.start_removing_dentryasbuh1hhjѮubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjѮubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjѮubjI)}(hchildh]hchild}(hj,hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjѮubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj]ubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhMubah}(h]jޭah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMhjhhubjw)}(hhh]h)}(h prepare to remove a given dentryh]h prepare to remove a given dentry}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjShhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjnjjnjjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``struct dentry *parent`` directory from which dentry should be removed ``struct dentry *child`` the dentry to be removed **Description** A lock is taken to protect the dentry against other dirops and the validity of the dentry is checked: correct parent and still hashed. If the dentry is valid and positive, a reference is taken and returned. If not an error is returned. end_removing() should be called when removal is complete, or aborted. **Return** the valid dentry, or an error.h](h)}(h**Parameters**h]j)}(hjxh]h Parameters}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjvubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjrubj)}(hhh](j)}(hH``struct dentry *parent`` directory from which dentry should be removed h](j)}(h``struct dentry *parent``h]j)}(hjh]hstruct dentry *parent}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjubj)}(hhh]h)}(h-directory from which dentry should be removedh]h-directory from which dentry should be removed}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h2``struct dentry *child`` the dentry to be removed h](j)}(h``struct dentry *child``h]j)}(hjЯh]hstruct dentry *child}(hjүhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjίubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjʯubj)}(hhh]h)}(hthe dentry to be removedh]hthe dentry to be removed}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjʯubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubeh}(h]h ]h"]h$]h&]uh1jhjrubh)}(h**Description**h]j)}(hj h]h Description}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjrubh)}(hA lock is taken to protect the dentry against other dirops and the validity of the dentry is checked: correct parent and still hashed.h]hA lock is taken to protect the dentry against other dirops and the validity of the dentry is checked: correct parent and still hashed.}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjrubh)}(heIf the dentry is valid and positive, a reference is taken and returned. If not an error is returned.h]heIf the dentry is valid and positive, a reference is taken and returned. If not an error is returned.}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjrubh)}(hEend_removing() should be called when removal is complete, or aborted.h]hEend_removing() should be called when removal is complete, or aborted.}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjrubh)}(h **Return**h]j)}(hjPh]hReturn}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjrubh)}(hthe valid dentry, or an error.h]hthe valid dentry, or an error.}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjrubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j start_renaming (C function)c.start_renaminghNtauh1hhjOghhhNhNubj)}(hhh](j)}(hjint start_renaming (struct renamedata *rd, int lookup_flags, struct qstr *old_last, struct qstr *new_last)h]j)}(hiint start_renaming(struct renamedata *rd, int lookup_flags, struct qstr *old_last, struct qstr *new_last)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMZubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMZubjC)}(hstart_renamingh]jI)}(hstart_renamingh]hstart_renaming}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhMZubj=)}(hW(struct renamedata *rd, int lookup_flags, struct qstr *old_last, struct qstr *new_last)h](jC)}(hstruct renamedata *rdh](j )}(hjh]hstruct}(hjҰhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjΰubj2)}(h h]h }(hj߰hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjΰubh)}(hhh]jI)}(h renamedatah]h renamedata}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jjsbc.start_renamingasbuh1hhjΰubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjΰubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjΰubjI)}(hrdh]hrd}(hj+hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjΰubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjʰubjC)}(hint lookup_flagsh](j)}(hinth]hint}(hjDhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@ubj2)}(h h]h }(hjRhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj@ubjI)}(h lookup_flagsh]h lookup_flags}(hj`hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj@ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjʰubjC)}(hstruct qstr *old_lasth](j )}(hjh]hstruct}(hjyhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjuubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjuubh)}(hhh]jI)}(hqstrh]hqstr}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j c.start_renamingasbuh1hhjuubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjuubj)}(hjh]h*}(hjñhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjuubjI)}(hold_lasth]hold_last}(hjбhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjuubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjʰubjC)}(hstruct qstr *new_lasth](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hqstrh]hqstr}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj modnameN classnameNjj )}j ]j c.start_renamingasbuh1hhjubj2)}(h h]h }(hj%hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hnew_lasth]hnew_last}(hj@hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjʰubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhMZubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhMZubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMZhjhhubjw)}(hhh]h)}(h9lookup and lock names for rename with permission checkingh]h9lookup and lock names for rename with permission checking}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMZhjghhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhMZubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``struct renamedata *rd`` rename data containing parents and flags, and for receiving found dentries ``int lookup_flags`` extra flags to pass to ->lookup (e.g. LOOKUP_REVAL, LOOKUP_NO_SYMLINKS etc). ``struct qstr *old_last`` name of object in **rd.old_parent** ``struct qstr *new_last`` name of object in **rd.new_parent** **Description** Look up two names and ensure locks are in place for rename. On success the found dentries are stored in **rd.old_dentry**, **rd.new_dentry**. Also the refcount on **rd->old_parent** is increased. These references and the lock are dropped by end_renaming(). The passed in qstrs need not have the hash calculated, and basic eXecute permission checking is performed against **rd.mnt_idmap**. **Return** zero or an error.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM^hjubj)}(hhh](j)}(he``struct renamedata *rd`` rename data containing parents and flags, and for receiving found dentries h](j)}(h``struct renamedata *rd``h]j)}(hjh]hstruct renamedata *rd}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM\hjubj)}(hhh]h)}(hJrename data containing parents and flags, and for receiving found dentriesh]hJrename data containing parents and flags, and for receiving found dentries}(hjIJhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM[hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM\hjubj)}(hb``int lookup_flags`` extra flags to pass to ->lookup (e.g. LOOKUP_REVAL, LOOKUP_NO_SYMLINKS etc). h](j)}(h``int lookup_flags``h]j)}(hjh]hint lookup_flags}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM^hj߲ubj)}(hhh]h)}(hLextra flags to pass to ->lookup (e.g. LOOKUP_REVAL, LOOKUP_NO_SYMLINKS etc).h]hLextra flags to pass to ->lookup (e.g. LOOKUP_REVAL, LOOKUP_NO_SYMLINKS etc).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM]hjubah}(h]h ]h"]h$]h&]uh1jhj߲ubeh}(h]h ]h"]h$]h&]uh1jhjhM^hjubj)}(h>``struct qstr *old_last`` name of object in **rd.old_parent** h](j)}(h``struct qstr *old_last``h]j)}(hjh]hstruct qstr *old_last}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM_hjubj)}(hhh]h)}(h#name of object in **rd.old_parent**h](hname of object in }(hj8hhhNhNubj)}(h**rd.old_parent**h]h rd.old_parent}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj8ubeh}(h]h ]h"]h$]h&]uh1hhj4hM_hj5ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj4hM_hjubj)}(h>``struct qstr *new_last`` name of object in **rd.new_parent** h](j)}(h``struct qstr *new_last``h]j)}(hjfh]hstruct qstr *new_last}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjdubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM`hj`ubj)}(hhh]h)}(h#name of object in **rd.new_parent**h](hname of object in }(hjhhhNhNubj)}(h**rd.new_parent**h]h rd.new_parent}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1hhj{hM`hj|ubah}(h]h ]h"]h$]h&]uh1jhj`ubeh}(h]h ]h"]h$]h&]uh1jhj{hM`hjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMbhjubh)}(h;Look up two names and ensure locks are in place for rename.h]h;Look up two names and ensure locks are in place for rename.}(hjųhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMahjubh)}(hOn success the found dentries are stored in **rd.old_dentry**, **rd.new_dentry**. Also the refcount on **rd->old_parent** is increased. These references and the lock are dropped by end_renaming().h](h,On success the found dentries are stored in }(hjԳhhhNhNubj)}(h**rd.old_dentry**h]h rd.old_dentry}(hjܳhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjԳubh, }(hjԳhhhNhNubj)}(h**rd.new_dentry**h]h rd.new_dentry}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjԳubh. Also the refcount on }(hjԳhhhNhNubj)}(h**rd->old_parent**h]hrd->old_parent}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjԳubhK is increased. These references and the lock are dropped by end_renaming().}(hjԳhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMdhjubh)}(hThe passed in qstrs need not have the hash calculated, and basic eXecute permission checking is performed against **rd.mnt_idmap**.h](hrThe passed in qstrs need not have the hash calculated, and basic eXecute permission checking is performed against }(hjhhhNhNubj)}(h**rd.mnt_idmap**h]h rd.mnt_idmap}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhhjubh)}(h **Return**h]j)}(hj<h]hReturn}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj:ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMkhjubh)}(hzero or an error.h]hzero or an error.}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMlhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j "start_renaming_dentry (C function)c.start_renaming_dentryhNtauh1hhjOghhhNhNubj)}(hhh](j)}(huint start_renaming_dentry (struct renamedata *rd, int lookup_flags, struct dentry *old_dentry, struct qstr *new_last)h]j)}(htint start_renaming_dentry(struct renamedata *rd, int lookup_flags, struct dentry *old_dentry, struct qstr *new_last)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj}hhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj}hhhjhMubjC)}(hstart_renaming_dentryh]jI)}(hstart_renaming_dentryh]hstart_renaming_dentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj}hhhjhMubj=)}(h[(struct renamedata *rd, int lookup_flags, struct dentry *old_dentry, struct qstr *new_last)h](jC)}(hstruct renamedata *rdh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hj˴hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(h renamedatah]h renamedata}(hjܴhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjٴubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj޴modnameN classnameNjj )}j ]j)}jjsbc.start_renaming_dentryasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hrdh]hrd}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hint lookup_flagsh](j)}(hinth]hint}(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,ubj2)}(h h]h }(hj>hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj,ubjI)}(h lookup_flagsh]h lookup_flags}(hjLhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj,ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct dentry *old_dentryh](j )}(hjh]hstruct}(hjehhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjaubj2)}(h h]h }(hjrhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjaubh)}(hhh]jI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.start_renaming_dentryasbuh1hhjaubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjaubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubjI)}(h old_dentryh]h old_dentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjaubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct qstr *new_lasth](j )}(hjh]hstruct}(hjյhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjѵubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjѵubh)}(hhh]jI)}(hqstrh]hqstr}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.start_renaming_dentryasbuh1hhjѵubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjѵubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjѵubjI)}(hnew_lasth]hnew_last}(hj,hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjѵubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hj}hhhjhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjyhhhjhMubah}(h]jtah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMhjvhhubjw)}(hhh]h)}(h8lookup and lock name for rename with permission checkingh]h8lookup and lock name for rename with permission checking}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjShhubah}(h]h ]h"]h$]h&]uh1jvhjvhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjnjjnjjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``struct renamedata *rd`` rename data containing parents and flags, and for receiving found dentries ``int lookup_flags`` extra flags to pass to ->lookup (e.g. LOOKUP_REVAL, LOOKUP_NO_SYMLINKS etc). ``struct dentry *old_dentry`` dentry of name to move ``struct qstr *new_last`` name of target in **rd.new_parent** **Description** Look up target name and ensure locks are in place for rename. On success the found dentry is stored in **rd.new_dentry** and **rd.old_parent** is confirmed to be the parent of **old_dentry**. If it was originally ``NULL``, it is set. In either case a reference is taken so that end_renaming() can have a stable reference to unlock. References and the lock can be dropped with end_renaming() The passed in qstr need not have the hash calculated, and basic eXecute permission checking is performed against **rd.mnt_idmap**. **Return** zero or an error.h](h)}(h**Parameters**h]j)}(hjxh]h Parameters}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjvubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjrubj)}(hhh](j)}(he``struct renamedata *rd`` rename data containing parents and flags, and for receiving found dentries h](j)}(h``struct renamedata *rd``h]j)}(hjh]hstruct renamedata *rd}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjubj)}(hhh]h)}(hJrename data containing parents and flags, and for receiving found dentriesh]hJrename data containing parents and flags, and for receiving found dentries}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(hb``int lookup_flags`` extra flags to pass to ->lookup (e.g. LOOKUP_REVAL, LOOKUP_NO_SYMLINKS etc). h](j)}(h``int lookup_flags``h]j)}(hjѶh]hint lookup_flags}(hjӶhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj϶ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhj˶ubj)}(hhh]h)}(hLextra flags to pass to ->lookup (e.g. LOOKUP_REVAL, LOOKUP_NO_SYMLINKS etc).h]hLextra flags to pass to ->lookup (e.g. LOOKUP_REVAL, LOOKUP_NO_SYMLINKS etc).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjubah}(h]h ]h"]h$]h&]uh1jhj˶ubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h5``struct dentry *old_dentry`` dentry of name to move h](j)}(h``struct dentry *old_dentry``h]j)}(hj h]hstruct dentry *old_dentry}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjubj)}(hhh]h)}(hdentry of name to moveh]hdentry of name to move}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMhj!ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj hMhjubj)}(h>``struct qstr *new_last`` name of target in **rd.new_parent** h](j)}(h``struct qstr *new_last``h]j)}(hjDh]hstruct qstr *new_last}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjBubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhj>ubj)}(hhh]h)}(h#name of target in **rd.new_parent**h](hname of target in }(hj]hhhNhNubj)}(h**rd.new_parent**h]h rd.new_parent}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1jhj]ubeh}(h]h ]h"]h$]h&]uh1hhjYhMhjZubah}(h]h ]h"]h$]h&]uh1jhj>ubeh}(h]h ]h"]h$]h&]uh1jhjYhMhjubeh}(h]h ]h"]h$]h&]uh1jhjrubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjrubh)}(h=Look up target name and ensure locks are in place for rename.h]h=Look up target name and ensure locks are in place for rename.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjrubh)}(hXOn success the found dentry is stored in **rd.new_dentry** and **rd.old_parent** is confirmed to be the parent of **old_dentry**. If it was originally ``NULL``, it is set. In either case a reference is taken so that end_renaming() can have a stable reference to unlock.h](h)On success the found dentry is stored in }(hjhhhNhNubj)}(h**rd.new_dentry**h]h rd.new_dentry}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh and }(hjhhhNhNubj)}(h**rd.old_parent**h]h rd.old_parent}(hj̷hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh" is confirmed to be the parent of }(hjhhhNhNubj)}(h**old_dentry**h]h old_dentry}(hj޷hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh. If it was originally }(hjhhhNhNubj)}(h``NULL``h]hNULL}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubho, it is set. In either case a reference is taken so that end_renaming() can have a stable reference to unlock.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjrubh)}(h:References and the lock can be dropped with end_renaming()h]h:References and the lock can be dropped with end_renaming()}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjrubh)}(hThe passed in qstr need not have the hash calculated, and basic eXecute permission checking is performed against **rd.mnt_idmap**.h](hqThe passed in qstr need not have the hash calculated, and basic eXecute permission checking is performed against }(hjhhhNhNubj)}(h**rd.mnt_idmap**h]h rd.mnt_idmap}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjrubh)}(h **Return**h]j)}(hj;h]hReturn}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj9ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjrubh)}(hzero or an error.h]hzero or an error.}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjrubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j (start_renaming_two_dentries (C function)c.start_renaming_two_dentrieshNtauh1hhjOghhhNhNubj)}(hhh](j)}(hmint start_renaming_two_dentries (struct renamedata *rd, struct dentry *old_dentry, struct dentry *new_dentry)h]j)}(hlint start_renaming_two_dentries(struct renamedata *rd, struct dentry *old_dentry, struct dentry *new_dentry)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|hhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj|hhhjhMubjC)}(hstart_renaming_two_dentriesh]jI)}(hstart_renaming_two_dentriesh]hstart_renaming_two_dentries}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj|hhhjhMubj=)}(hM(struct renamedata *rd, struct dentry *old_dentry, struct dentry *new_dentry)h](jC)}(hstruct renamedata *rdh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjʸhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(h renamedatah]h renamedata}(hj۸hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjظubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjݸmodnameN classnameNjj )}j ]j)}jjsbc.start_renaming_two_dentriesasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hrdh]hrd}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct dentry *old_dentryh](j )}(hjh]hstruct}(hj/hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj+ubj2)}(h h]h }(hj<hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj+ubh)}(hhh]jI)}(hdentryh]hdentry}(hjMhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjJubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjOmodnameN classnameNjj )}j ]jc.start_renaming_two_dentriesasbuh1hhj+ubj2)}(h h]h }(hjkhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj+ubj)}(hjh]h*}(hjyhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubjI)}(h old_dentryh]h old_dentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj+ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct dentry *new_dentryh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.start_renaming_two_dentriesasbuh1hhjubj2)}(h h]h }(hj۹hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(h new_dentryh]h new_dentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hj|hhhjhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjxhhhjhMubah}(h]jsah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMhjuhhubjw)}(hhh]h)}(h,Lock to dentries in given parents for renameh]h,Lock to dentries in given parents for rename}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjhhubah}(h]h ]h"]h$]h&]uh1jvhjuhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjj8jj8jjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``struct renamedata *rd`` rename data containing parent ``struct dentry *old_dentry`` dentry of name to move ``struct dentry *new_dentry`` dentry to move to **Description** Ensure locks are in place for rename and check parentage is still correct. On success the two dentries are stored in **rd.old_dentry** and **rd.new_dentry** and **rd.old_parent** and **rd.new_parent** are confirmed to be the parents of the dentries. References and the lock can be dropped with end_renaming() **Return** zero or an error.h](h)}(h**Parameters**h]j)}(hjBh]h Parameters}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj@ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhj<ubj)}(hhh](j)}(h8``struct renamedata *rd`` rename data containing parent h](j)}(h``struct renamedata *rd``h]j)}(hjah]hstruct renamedata *rd}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jhj_ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhj[ubj)}(hhh]h)}(hrename data containing parenth]hrename data containing parent}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjvhMhjwubah}(h]h ]h"]h$]h&]uh1jhj[ubeh}(h]h ]h"]h$]h&]uh1jhjvhMhjXubj)}(h5``struct dentry *old_dentry`` dentry of name to move h](j)}(h``struct dentry *old_dentry``h]j)}(hjh]hstruct dentry *old_dentry}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjubj)}(hhh]h)}(hdentry of name to moveh]hdentry of name to move}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjXubj)}(h0``struct dentry *new_dentry`` dentry to move to h](j)}(h``struct dentry *new_dentry``h]j)}(hjӺh]hstruct dentry *new_dentry}(hjպhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjѺubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjͺubj)}(hhh]h)}(hdentry to move toh]hdentry to move to}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjͺubeh}(h]h ]h"]h$]h&]uh1jhjhMhjXubeh}(h]h ]h"]h$]h&]uh1jhj<ubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhj<ubh)}(hJEnsure locks are in place for rename and check parentage is still correct.h]hJEnsure locks are in place for rename and check parentage is still correct.}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhj<ubh)}(hOn success the two dentries are stored in **rd.old_dentry** and **rd.new_dentry** and **rd.old_parent** and **rd.new_parent** are confirmed to be the parents of the dentries.h](h*On success the two dentries are stored in }(hj3hhhNhNubj)}(h**rd.old_dentry**h]h rd.old_dentry}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj3ubh and }(hj3hhhNhNubj)}(h**rd.new_dentry**h]h rd.new_dentry}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj3ubh and }(hj3hhhNhNubj)}(h**rd.old_parent**h]h rd.old_parent}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj3ubh and }hj3sbj)}(h**rd.new_parent**h]h rd.new_parent}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj3ubh1 are confirmed to be the parents of the dentries.}(hj3hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhj<ubh)}(h:References and the lock can be dropped with end_renaming()h]h:References and the lock can be dropped with end_renaming()}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhj<ubh)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhj<ubh)}(hzero or an error.h]hzero or an error.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhj<ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j vfs_create (C function) c.vfs_createhNtauh1hhjOghhhNhNubj)}(hhh](j)}(hoint vfs_create (const struct mnt_idmap *idmap, struct dentry *dentry, umode_t mode, struct delegated_inode *di)h]j)}(hnint vfs_create(const struct mnt_idmap *idmap, struct dentry *dentry, umode_t mode, struct delegated_inode *di)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjܻhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMIubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjܻhhhjhMIubjC)}(h vfs_createh]jI)}(h vfs_createh]h vfs_create}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjܻhhhjhMIubj=)}(h`(const struct mnt_idmap *idmap, struct dentry *dentry, umode_t mode, struct delegated_inode *di)h](jC)}(hconst struct mnt_idmap *idmaph](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hj*hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj )}(hjh]hstruct}(hj8hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjEhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(h mnt_idmaph]h mnt_idmap}(hjVhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjSubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjXmodnameN classnameNjj )}j ]j)}jjsb c.vfs_createasbuh1hhjubj2)}(h h]h }(hjvhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hidmaph]hidmap}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct dentry *dentryh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hdentryh]hdentry}(hjȼhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjżubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjʼmodnameN classnameNjj )}j ]jr c.vfs_createasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h umode_t modeh](h)}(hhh]jI)}(humode_th]humode_t}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jr c.vfs_createasbuh1hhjubj2)}(h h]h }(hj;hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hmodeh]hmode}(hjIhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct delegated_inode *dih](j )}(hjh]hstruct}(hjbhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj^ubj2)}(h h]h }(hjohhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj^ubh)}(hhh]jI)}(hdelegated_inodeh]hdelegated_inode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj}ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jr c.vfs_createasbuh1hhj^ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj^ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^ubjI)}(hdih]hdi}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj^ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjܻhhhjhMIubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjػhhhjhMIubah}(h]jӻah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMIhjջhhubjw)}(hhh]h)}(hcreate new fileh]hcreate new file}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMIhjhhubah}(h]h ]h"]h$]h&]uh1jvhjջhhhjhMIubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``const struct mnt_idmap *idmap`` idmap of the mount the inode was found from ``struct dentry *dentry`` dentry of the child file ``umode_t mode`` mode of the child file ``struct delegated_inode *di`` returns parent inode, if the inode is delegated. **Description** Create a new file. If the inode has been found through an idmapped mount the idmap of the vfsmount must be passed through **idmap**. This function will then take care to map the inode according to **idmap** before checking permissions. On non-idmapped mounts or if permission checking is to be performed on the raw inode simply pass **nop_mnt_idmap**.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMMhjubj)}(hhh](j)}(hN``const struct mnt_idmap *idmap`` idmap of the mount the inode was found from h](j)}(h!``const struct mnt_idmap *idmap``h]j)}(hj$h]hconst struct mnt_idmap *idmap}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj"ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMJhjubj)}(hhh]h)}(h+idmap of the mount the inode was found fromh]h+idmap of the mount the inode was found from}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj9hMJhj:ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj9hMJhjubj)}(h3``struct dentry *dentry`` dentry of the child file h](j)}(h``struct dentry *dentry``h]j)}(hj]h]hstruct dentry *dentry}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj[ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMKhjWubj)}(hhh]h)}(hdentry of the child fileh]hdentry of the child file}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjrhMKhjsubah}(h]h ]h"]h$]h&]uh1jhjWubeh}(h]h ]h"]h$]h&]uh1jhjrhMKhjubj)}(h(``umode_t mode`` mode of the child file h](j)}(h``umode_t mode``h]j)}(hjh]h umode_t mode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMLhjubj)}(hhh]h)}(hmode of the child fileh]hmode of the child file}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMLhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMLhjubj)}(hP``struct delegated_inode *di`` returns parent inode, if the inode is delegated. h](j)}(h``struct delegated_inode *di``h]j)}(hjϾh]hstruct delegated_inode *di}(hjѾhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj;ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMMhjɾubj)}(hhh]h)}(h0returns parent inode, if the inode is delegated.h]h0returns parent inode, if the inode is delegated.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMMhjubah}(h]h ]h"]h$]h&]uh1jhjɾubeh}(h]h ]h"]h$]h&]uh1jhjhMMhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hj h]h Description}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMOhjubh)}(hCreate a new file.h]hCreate a new file.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMNhjubh)}(hXLIf the inode has been found through an idmapped mount the idmap of the vfsmount must be passed through **idmap**. This function will then take care to map the inode according to **idmap** before checking permissions. On non-idmapped mounts or if permission checking is to be performed on the raw inode simply pass **nop_mnt_idmap**.h](hgIf the inode has been found through an idmapped mount the idmap of the vfsmount must be passed through }(hj/hhhNhNubj)}(h **idmap**h]hidmap}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj/ubhB. This function will then take care to map the inode according to }(hj/hhhNhNubj)}(h **idmap**h]hidmap}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj/ubh before checking permissions. On non-idmapped mounts or if permission checking is to be performed on the raw inode simply pass }(hj/hhhNhNubj)}(h**nop_mnt_idmap**h]h nop_mnt_idmap}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj/ubh.}(hj/hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMPhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j  kernel_tmpfile_open (C function)c.kernel_tmpfile_openhNtauh1hhjOghhhNhNubj)}(hhh](j)}(hstruct file * kernel_tmpfile_open (const struct mnt_idmap *idmap, const struct path *parentpath, umode_t mode, int open_flag, const struct cred *cred)h]j)}(hstruct file *kernel_tmpfile_open(const struct mnt_idmap *idmap, const struct path *parentpath, umode_t mode, int open_flag, const struct cred *cred)h](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMAubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMAubh)}(hhh]jI)}(hfileh]hfile}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jkernel_tmpfile_opensbc.kernel_tmpfile_openasbuh1hhjhhhjhMAubj2)}(h h]h }(hjԿhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMAubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMAubjC)}(hkernel_tmpfile_openh]jI)}(hjѿh]hkernel_tmpfile_open}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhMAubj=)}(ht(const struct mnt_idmap *idmap, const struct path *parentpath, umode_t mode, int open_flag, const struct cred *cred)h](jC)}(hconst struct mnt_idmap *idmaph](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj ubj )}(hjh]hstruct}(hj)hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj ubj2)}(h h]h }(hj6hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj ubh)}(hhh]jI)}(h mnt_idmaph]h mnt_idmap}(hjGhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjDubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjImodnameN classnameNjj )}j ]jϿc.kernel_tmpfile_openasbuh1hhj ubj2)}(h h]h }(hjehhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj ubj)}(hjh]h*}(hjshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubjI)}(hidmaph]hidmap}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hconst struct path *parentpathh](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hpathh]hpath}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jϿc.kernel_tmpfile_openasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&X]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(h parentpathh]h parentpath}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h umode_t modeh](h)}(hhh]jI)}(humode_th]humode_t}(hj'hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj$ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj)modnameN classnameNjj )}j ]jϿc.kernel_tmpfile_openasbuh1hhj ubj2)}(h h]h }(hjEhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj ubjI)}(hmodeh]hmode}(hjShhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h int open_flagh](j)}(hinth]hint}(hjlhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhubj2)}(h h]h }(hjzhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhubjI)}(h open_flagh]h open_flag}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjhubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hconst struct cred *credh](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hcredh]hcred}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jϿc.kernel_tmpfile_openasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hcredh]hcred}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhMAubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhMAubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMAhjhhubjw)}(hhh]h)}(h&open a tmpfile for kernel internal useh]h&open a tmpfile for kernel internal use}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMAhj:hhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhMAubeh}(h]h ](jfunctioneh"]h$]h&]jjjjUjjUjjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``const struct mnt_idmap *idmap`` idmap of the mount the inode was found from ``const struct path *parentpath`` path of the base directory ``umode_t mode`` mode of the new tmpfile ``int open_flag`` flags ``const struct cred *cred`` credentials for open **Description** Create and open a temporary file. The file is not accounted in nr_files, hence this is only for kernel internal use, and must not be installed into file tables or such.h](h)}(h**Parameters**h]j)}(hj_h]h Parameters}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1jhj]ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMEhjYubj)}(hhh](j)}(hN``const struct mnt_idmap *idmap`` idmap of the mount the inode was found from h](j)}(h!``const struct mnt_idmap *idmap``h]j)}(hj~h]hconst struct mnt_idmap *idmap}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj|ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMBhjxubj)}(hhh]h)}(h+idmap of the mount the inode was found fromh]h+idmap of the mount the inode was found from}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMBhjubah}(h]h ]h"]h$]h&]uh1jhjxubeh}(h]h ]h"]h$]h&]uh1jhjhMBhjuubj)}(h=``const struct path *parentpath`` path of the base directory h](j)}(h!``const struct path *parentpath``h]j)}(hjh]hconst struct path *parentpath}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMChjubj)}(hhh]h)}(hpath of the base directoryh]hpath of the base directory}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMChjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMChjuubj)}(h)``umode_t mode`` mode of the new tmpfile h](j)}(h``umode_t mode``h]j)}(hjh]h umode_t mode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMDhjubj)}(hhh]h)}(hmode of the new tmpfileh]hmode of the new tmpfile}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMDhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMDhjuubj)}(h``int open_flag`` flags h](j)}(h``int open_flag``h]j)}(hj)h]h int open_flag}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj'ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMEhj#ubj)}(hhh]h)}(hflagsh]hflags}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj>hMEhj?ubah}(h]h ]h"]h$]h&]uh1jhj#ubeh}(h]h ]h"]h$]h&]uh1jhj>hMEhjuubj)}(h1``const struct cred *cred`` credentials for open h](j)}(h``const struct cred *cred``h]j)}(hjbh]hconst struct cred *cred}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj`ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMFhj\ubj)}(hhh]h)}(hcredentials for openh]hcredentials for open}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjwhMFhjxubah}(h]h ]h"]h$]h&]uh1jhj\ubeh}(h]h ]h"]h$]h&]uh1jhjwhMFhjuubeh}(h]h ]h"]h$]h&]uh1jhjYubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMHhjYubh)}(hCreate and open a temporary file. The file is not accounted in nr_files, hence this is only for kernel internal use, and must not be installed into file tables or such.h]hCreate and open a temporary file. The file is not accounted in nr_files, hence this is only for kernel internal use, and must not be installed into file tables or such.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMGhjYubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j end_creating_path (C function)c.end_creating_pathhNtauh1hhjOghhhNhNubj)}(hhh](j)}(hGvoid end_creating_path (const struct path *path, struct dentry *dentry)h]j)}(hFvoid end_creating_path(const struct path *path, struct dentry *dentry)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMubjC)}(hend_creating_pathh]jI)}(hend_creating_pathh]hend_creating_path}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhMubj=)}(h0(const struct path *path, struct dentry *dentry)h](jC)}(hconst struct path *pathh](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hj,hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj )}(hjh]hstruct}(hj:hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjGhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hpathh]hpath}(hjXhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjUubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjZmodnameN classnameNjj )}j ]j)}jjsbc.end_creating_pathasbuh1hhjubj2)}(h h]h }(hjxhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hpathh]hpath}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct dentry *dentryh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jtc.end_creating_pathasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhMubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMhjhhubjw)}(hhh]h)}(h6finish a code section started by start_creating_path()h]h6finish a code section started by start_creating_path()}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhj*hhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjEjjEjjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``const struct path *path`` the path instantiated by start_creating_path() ``struct dentry *dentry`` the dentry returned by start_creating_path() **Description** end_creating_path() will unlock and locks taken by start_creating_path() and drop an references that were taken. It should only be called if start_creating_path() returned a non-error. If vfs_mkdir() was called and it returned an error, that error *should* be passed to end_creating_path() together with the path.h](h)}(h**Parameters**h]j)}(hjOh]h Parameters}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjMubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjIubj)}(hhh](j)}(hK``const struct path *path`` the path instantiated by start_creating_path() h](j)}(h``const struct path *path``h]j)}(hjnh]hconst struct path *path}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1jhjlubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjhubj)}(hhh]h)}(h.the path instantiated by start_creating_path()h]h.the path instantiated by start_creating_path()}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjhubeh}(h]h ]h"]h$]h&]uh1jhjhMhjeubj)}(hG``struct dentry *dentry`` the dentry returned by start_creating_path() h](j)}(h``struct dentry *dentry``h]j)}(hjh]hstruct dentry *dentry}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjubj)}(hhh]h)}(h,the dentry returned by start_creating_path()h]h,the dentry returned by start_creating_path()}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjeubeh}(h]h ]h"]h$]h&]uh1jhjIubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjIubh)}(hX:end_creating_path() will unlock and locks taken by start_creating_path() and drop an references that were taken. It should only be called if start_creating_path() returned a non-error. If vfs_mkdir() was called and it returned an error, that error *should* be passed to end_creating_path() together with the path.h](hend_creating_path() will unlock and locks taken by start_creating_path() and drop an references that were taken. It should only be called if start_creating_path() returned a non-error. If vfs_mkdir() was called and it returned an error, that error }(hjhhhNhNubj )}(h*should*h]hshould}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j~ hjubh9 be passed to end_creating_path() together with the path.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjIubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j dentry_create (C function)c.dentry_createhNtauh1hhjOghhhNhNubj)}(hhh](j)}(hastruct file * dentry_create (struct path *path, int flags, umode_t mode, const struct cred *cred)h]j)}(h_struct file *dentry_create(struct path *path, int flags, umode_t mode, const struct cred *cred)h](j )}(hjh]hstruct}(hj9hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj5hhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM,ubj2)}(h h]h }(hjGhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj5hhhjFhM,ubh)}(hhh]jI)}(hfileh]hfile}(hjXhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjUubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjZmodnameN classnameNjj )}j ]j)}j dentry_createsbc.dentry_createasbuh1hhj5hhhjFhM,ubj2)}(h h]h }(hjyhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj5hhhjFhM,ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5hhhjFhM,ubjC)}(h dentry_createh]jI)}(hjvh]h dentry_create}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj5hhhjFhM,ubj=)}(hE(struct path *path, int flags, umode_t mode, const struct cred *cred)h](jC)}(hstruct path *pathh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hpathh]hpath}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jtc.dentry_createasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hpathh]hpath}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h int flagsh](j)}(hinth]hint}(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hj1hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hflagsh]hflags}(hj?hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h umode_t modeh](h)}(hhh]jI)}(humode_th]humode_t}(hj[hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjXubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj]modnameN classnameNjj )}j ]jtc.dentry_createasbuh1hhjTubj2)}(h h]h }(hjyhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjTubjI)}(hmodeh]hmode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjTubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hconst struct cred *credh](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hcredh]hcred}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jtc.dentry_createasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hcredh]hcred}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hj5hhhjFhM,ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj1hhhjFhM,ubah}(h]j,ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjFhM,hj.hhubjw)}(hhh]h)}(hCreate and open a fileh]hCreate and open a file}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM,hj9hhubah}(h]h ]h"]h$]h&]uh1jvhj.hhhjFhM,ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjTjjTjjjuh1jhhhjOghNhNubj)}(hXI**Parameters** ``struct path *path`` path to create ``int flags`` O\_ flags ``umode_t mode`` mode bits for new file ``const struct cred *cred`` credentials to use **Description** Caller must hold the parent directory's lock, and have prepared a negative dentry, placed in **path->dentry**, for the new file. Caller sets **path->mnt** to the vfsmount of the filesystem where the new file is to be created. The parent directory and the negative dentry must reside on the same filesystem instance. On success, returns a ``struct file *``. Otherwise an ERR_PTR is returned.h](h)}(h**Parameters**h]j)}(hj^h]h Parameters}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj\ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM0hjXubj)}(hhh](j)}(h%``struct path *path`` path to create h](j)}(h``struct path *path``h]j)}(hj}h]hstruct path *path}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj{ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM-hjwubj)}(hhh]h)}(hpath to createh]hpath to create}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM-hjubah}(h]h ]h"]h$]h&]uh1jhjwubeh}(h]h ]h"]h$]h&]uh1jhjhM-hjtubj)}(h``int flags`` O\_ flags h](j)}(h ``int flags``h]j)}(hjh]h int flags}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM.hjubj)}(hhh]h)}(h O\_ flagsh]h O_ flags}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM.hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM.hjtubj)}(h(``umode_t mode`` mode bits for new file h](j)}(h``umode_t mode``h]j)}(hjh]h umode_t mode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM/hjubj)}(hhh]h)}(hmode bits for new fileh]hmode bits for new file}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM/hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM/hjtubj)}(h/``const struct cred *cred`` credentials to use h](j)}(h``const struct cred *cred``h]j)}(hj(h]hconst struct cred *cred}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj&ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM0hj"ubj)}(hhh]h)}(hcredentials to useh]hcredentials to use}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj=hM0hj>ubah}(h]h ]h"]h$]h&]uh1jhj"ubeh}(h]h ]h"]h$]h&]uh1jhj=hM0hjtubeh}(h]h ]h"]h$]h&]uh1jhjXubh)}(h**Description**h]j)}(hjch]h Description}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1jhjaubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM2hjXubh)}(hCaller must hold the parent directory's lock, and have prepared a negative dentry, placed in **path->dentry**, for the new file.h](h_Caller must hold the parent directory’s lock, and have prepared a negative dentry, placed in }(hjyhhhNhNubj)}(h**path->dentry**h]h path->dentry}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjyubh, for the new file.}(hjyhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM1hjXubh)}(hCaller sets **path->mnt** to the vfsmount of the filesystem where the new file is to be created. The parent directory and the negative dentry must reside on the same filesystem instance.h](h Caller sets }(hjhhhNhNubj)}(h **path->mnt**h]h path->mnt}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh to the vfsmount of the filesystem where the new file is to be created. The parent directory and the negative dentry must reside on the same filesystem instance.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM4hjXubh)}(hJOn success, returns a ``struct file *``. Otherwise an ERR_PTR is returned.h](hOn success, returns a }(hjhhhNhNubj)}(h``struct file *``h]h struct file *}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh#. Otherwise an ERR_PTR is returned.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM8hjXubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j vfs_mknod (C function) c.vfs_mknodhNtauh1hhjOghhhNhNubj)}(hhh](j)}(hint vfs_mknod (const struct mnt_idmap *idmap, struct inode *dir, struct dentry *dentry, umode_t mode, dev_t dev, struct delegated_inode *delegated_inode)h]j)}(hint vfs_mknod(const struct mnt_idmap *idmap, struct inode *dir, struct dentry *dentry, umode_t mode, dev_t dev, struct delegated_inode *delegated_inode)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMyubj2)}(h h]h }(hj hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhj hMyubjC)}(h vfs_mknodh]jI)}(h vfs_mknodh]h vfs_mknod}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhj hMyubj=)}(h(const struct mnt_idmap *idmap, struct inode *dir, struct dentry *dentry, umode_t mode, dev_t dev, struct delegated_inode *delegated_inode)h](jC)}(hconst struct mnt_idmap *idmaph](j )}(hjJh]hconst}(hj9hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj5ubj2)}(h h]h }(hjFhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj5ubj )}(hjh]hstruct}(hjThhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj5ubj2)}(h h]h }(hjahhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj5ubh)}(hhh]jI)}(h mnt_idmaph]h mnt_idmap}(hjrhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjoubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjtmodnameN classnameNjj )}j ]j)}jjsb c.vfs_mknodasbuh1hhj5ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj5ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5ubjI)}(hidmaph]hidmap}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj5ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj1ubjC)}(hstruct inode *dirh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j c.vfs_mknodasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hdirh]hdir}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj1ubjC)}(hstruct dentry *dentryh](j )}(hjh]hstruct}(hj6hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj2ubj2)}(h h]h }(hjChhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj2ubh)}(hhh]jI)}(hdentryh]hdentry}(hjThhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjQubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjVmodnameN classnameNjj )}j ]j c.vfs_mknodasbuh1hhj2ubj2)}(h h]h }(hjrhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj2ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2ubjI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj2ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj1ubjC)}(h umode_t modeh](h)}(hhh]jI)}(humode_th]humode_t}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j c.vfs_mknodasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hmodeh]hmode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj1ubjC)}(h dev_t devh](h)}(hhh]jI)}(hdev_th]hdev_t}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j c.vfs_mknodasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hdevh]hdev}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj1ubjC)}(h'struct delegated_inode *delegated_inodeh](j )}(hjh]hstruct}(hj6hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj2ubj2)}(h h]h }(hjChhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj2ubh)}(hhh]jI)}(hdelegated_inodeh]hdelegated_inode}(hjThhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjQubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjVmodnameN classnameNjj )}j ]j c.vfs_mknodasbuh1hhj2ubj2)}(h h]h }(hjrhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj2ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2ubjI)}(hdelegated_inodeh]hdelegated_inode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj2ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj1ubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhj hMyubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhj hMyubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj hMyhjhhubjw)}(hhh]h)}(hcreate device node or fileh]hcreate device node or file}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMyhjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhj hMyubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``const struct mnt_idmap *idmap`` idmap of the mount the inode was found from ``struct inode *dir`` inode of the parent directory ``struct dentry *dentry`` dentry of the child device node ``umode_t mode`` mode of the child device node ``dev_t dev`` device number of device to create ``struct delegated_inode *delegated_inode`` returns parent inode, if the inode is delegated. **Description** Create a device node or file. If the inode has been found through an idmapped mount the idmap of the vfsmount must be passed through **idmap**. This function will then take care to map the inode according to **idmap** before checking permissions. On non-idmapped mounts or if permission checking is to be performed on the raw inode simply pass **nop_mnt_idmap**.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM}hjubj)}(hhh](j)}(hN``const struct mnt_idmap *idmap`` idmap of the mount the inode was found from h](j)}(h!``const struct mnt_idmap *idmap``h]j)}(hjh]hconst struct mnt_idmap *idmap}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMzhjubj)}(hhh]h)}(h+idmap of the mount the inode was found fromh]h+idmap of the mount the inode was found from}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMzhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj hMzhjubj)}(h4``struct inode *dir`` inode of the parent directory h](j)}(h``struct inode *dir``h]j)}(hj1h]hstruct inode *dir}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj/ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM{hj+ubj)}(hhh]h)}(hinode of the parent directoryh]hinode of the parent directory}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjFhM{hjGubah}(h]h ]h"]h$]h&]uh1jhj+ubeh}(h]h ]h"]h$]h&]uh1jhjFhM{hjubj)}(h:``struct dentry *dentry`` dentry of the child device node h](j)}(h``struct dentry *dentry``h]j)}(hjjh]hstruct dentry *dentry}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjhubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM|hjdubj)}(hhh]h)}(hdentry of the child device nodeh]hdentry of the child device node}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM|hjubah}(h]h ]h"]h$]h&]uh1jhjdubeh}(h]h ]h"]h$]h&]uh1jhjhM|hjubj)}(h/``umode_t mode`` mode of the child device node h](j)}(h``umode_t mode``h]j)}(hjh]h umode_t mode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM}hjubj)}(hhh]h)}(hmode of the child device nodeh]hmode of the child device node}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM}hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM}hjubj)}(h0``dev_t dev`` device number of device to create h](j)}(h ``dev_t dev``h]j)}(hjh]h dev_t dev}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM~hjubj)}(hhh]h)}(h!device number of device to createh]h!device number of device to create}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM~hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM~hjubj)}(h]``struct delegated_inode *delegated_inode`` returns parent inode, if the inode is delegated. h](j)}(h+``struct delegated_inode *delegated_inode``h]j)}(hjh]h'struct delegated_inode *delegated_inode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjubj)}(hhh]h)}(h0returns parent inode, if the inode is delegated.h]h0returns parent inode, if the inode is delegated.}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj*hMhj+ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj*hMhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjPh]h Description}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjubh)}(hCreate a device node or file.h]hCreate a device node or file.}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjubh)}(hXLIf the inode has been found through an idmapped mount the idmap of the vfsmount must be passed through **idmap**. This function will then take care to map the inode according to **idmap** before checking permissions. On non-idmapped mounts or if permission checking is to be performed on the raw inode simply pass **nop_mnt_idmap**.h](hgIf the inode has been found through an idmapped mount the idmap of the vfsmount must be passed through }(hjuhhhNhNubj)}(h **idmap**h]hidmap}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjuubhB. This function will then take care to map the inode according to }(hjuhhhNhNubj)}(h **idmap**h]hidmap}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjuubh before checking permissions. On non-idmapped mounts or if permission checking is to be performed on the raw inode simply pass }(hjuhhhNhNubj)}(h**nop_mnt_idmap**h]h nop_mnt_idmap}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjuubh.}(hjuhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j vfs_mkdir (C function) c.vfs_mkdirhNtauh1hhjOghhhNhNubj)}(hhh](j)}(hstruct dentry * vfs_mkdir (const struct mnt_idmap *idmap, struct inode *dir, struct dentry *dentry, umode_t mode, struct delegated_inode *delegated_inode)h]j)}(hstruct dentry *vfs_mkdir(const struct mnt_idmap *idmap, struct inode *dir, struct dentry *dentry, umode_t mode, struct delegated_inode *delegated_inode)h](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMubh)}(hhh]jI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}j vfs_mkdirsb c.vfs_mkdirasbuh1hhjhhhjhMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMubj)}(hjh]h*}(hj(hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubjC)}(h vfs_mkdirh]jI)}(hjh]h vfs_mkdir}(hj9hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj5ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhMubj=)}(h(const struct mnt_idmap *idmap, struct inode *dir, struct dentry *dentry, umode_t mode, struct delegated_inode *delegated_inode)h](jC)}(hconst struct mnt_idmap *idmaph](j )}(hjJh]hconst}(hjThhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjPubj2)}(h h]h }(hjahhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjPubj )}(hjh]hstruct}(hjohhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjPubj2)}(h h]h }(hj|hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjPubh)}(hhh]jI)}(h mnt_idmaph]h mnt_idmap}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j c.vfs_mkdirasbuh1hhjPubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjPubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjPubjI)}(hidmaph]hidmap}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjPubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjLubjC)}(hstruct inode *dirh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j c.vfs_mkdirasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hdirh]hdir}(hj6hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjLubjC)}(hstruct dentry *dentryh](j )}(hjh]hstruct}(hjOhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjKubj2)}(h h]h }(hj\hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjKubh)}(hhh]jI)}(hdentryh]hdentry}(hjmhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjomodnameN classnameNjj )}j ]j c.vfs_mkdirasbuh1hhjKubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjKubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjKubjI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjKubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjLubjC)}(h umode_t modeh](h)}(hhh]jI)}(humode_th]humode_t}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j c.vfs_mkdirasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hmodeh]hmode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjLubjC)}(h'struct delegated_inode *delegated_inodeh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hdelegated_inodeh]hdelegated_inode}(hj%hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj"ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj'modnameN classnameNjj )}j ]j c.vfs_mkdirasbuh1hhjubj2)}(h h]h }(hjChhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjQhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hdelegated_inodeh]hdelegated_inode}(hj^hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjLubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhMubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMhjhhubjw)}(hhh]h)}(h5create directory returning correct dentry if possibleh]h5create directory returning correct dentry if possible}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``const struct mnt_idmap *idmap`` idmap of the mount the inode was found from ``struct inode *dir`` inode of the parent directory ``struct dentry *dentry`` dentry of the child directory ``umode_t mode`` mode of the child directory ``struct delegated_inode *delegated_inode`` returns parent inode, if the inode is delegated. **Description** Create a directory. If the inode has been found through an idmapped mount the idmap of the vfsmount must be passed through **idmap**. This function will then take care to map the inode according to **idmap** before checking permissions. On non-idmapped mounts or if permission checking is to be performed on the raw inode simply pass **nop_mnt_idmap**. In the event that the filesystem does not use the ***dentry** but leaves it negative or unhashes it and possibly splices a different one returning it, the original dentry is dput() and the alternate is returned. In case of an error the dentry is dput() and an ERR_PTR() is returned.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjubj)}(hhh](j)}(hN``const struct mnt_idmap *idmap`` idmap of the mount the inode was found from h](j)}(h!``const struct mnt_idmap *idmap``h]j)}(hjh]hconst struct mnt_idmap *idmap}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjubj)}(hhh]h)}(h+idmap of the mount the inode was found fromh]h+idmap of the mount the inode was found from}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h4``struct inode *dir`` inode of the parent directory h](j)}(h``struct inode *dir``h]j)}(hjh]hstruct inode *dir}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjubj)}(hhh]h)}(hinode of the parent directoryh]hinode of the parent directory}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h8``struct dentry *dentry`` dentry of the child directory h](j)}(h``struct dentry *dentry``h]j)}(hj;h]hstruct dentry *dentry}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj9ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhj5ubj)}(hhh]h)}(hdentry of the child directoryh]hdentry of the child directory}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1hhjPhMhjQubah}(h]h ]h"]h$]h&]uh1jhj5ubeh}(h]h ]h"]h$]h&]uh1jhjPhMhjubj)}(h-``umode_t mode`` mode of the child directory h](j)}(h``umode_t mode``h]j)}(hjth]h umode_t mode}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjrubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjnubj)}(hhh]h)}(hmode of the child directoryh]hmode of the child directory}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjnubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h]``struct delegated_inode *delegated_inode`` returns parent inode, if the inode is delegated. h](j)}(h+``struct delegated_inode *delegated_inode``h]j)}(hjh]h'struct delegated_inode *delegated_inode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjubj)}(hhh]h)}(h0returns parent inode, if the inode is delegated.h]h0returns parent inode, if the inode is delegated.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjubh)}(hCreate a directory.h]hCreate a directory.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjubh)}(hXLIf the inode has been found through an idmapped mount the idmap of the vfsmount must be passed through **idmap**. This function will then take care to map the inode according to **idmap** before checking permissions. On non-idmapped mounts or if permission checking is to be performed on the raw inode simply pass **nop_mnt_idmap**.h](hgIf the inode has been found through an idmapped mount the idmap of the vfsmount must be passed through }(hj hhhNhNubj)}(h **idmap**h]hidmap}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubhB. This function will then take care to map the inode according to }(hj hhhNhNubj)}(h **idmap**h]hidmap}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubh before checking permissions. On non-idmapped mounts or if permission checking is to be performed on the raw inode simply pass }(hj hhhNhNubj)}(h**nop_mnt_idmap**h]h nop_mnt_idmap}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubh.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hjubh)}(hIn the event that the filesystem does not use the ***dentry** but leaves it negative or unhashes it and possibly splices a different one returning it, the original dentry is dput() and the alternate is returned.h](h2In the event that the filesystem does not use the }(hjRhhhNhNubj)}(h ***dentry**h]h*dentry}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjRubh but leaves it negative or unhashes it and possibly splices a different one returning it, the original dentry is dput() and the alternate is returned.}(hjRhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjubh)}(hFIn case of an error the dentry is dput() and an ERR_PTR() is returned.h]hFIn case of an error the dentry is dput() and an ERR_PTR() is returned.}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j vfs_rmdir (C function) c.vfs_rmdirhNtauh1hhjOghhhNhNubj)}(hhh](j)}(hint vfs_rmdir (const struct mnt_idmap *idmap, struct inode *dir, struct dentry *dentry, struct delegated_inode *delegated_inode)h]j)}(hint vfs_rmdir(const struct mnt_idmap *idmap, struct inode *dir, struct dentry *dentry, struct delegated_inode *delegated_inode)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMtubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMtubjC)}(h vfs_rmdirh]jI)}(h vfs_rmdirh]h vfs_rmdir}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhMtubj=)}(hr(const struct mnt_idmap *idmap, struct inode *dir, struct dentry *dentry, struct delegated_inode *delegated_inode)h](jC)}(hconst struct mnt_idmap *idmaph](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(h mnt_idmaph]h mnt_idmap}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jjsb c.vfs_rmdirasbuh1hhjubj2)}(h h]h }(hj8hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hidmaph]hidmap}(hjShhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct inode *dirh](j )}(hjh]hstruct}(hjlhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjhubj2)}(h h]h }(hjyhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhubh)}(hhh]jI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j4 c.vfs_rmdirasbuh1hhjhubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhubjI)}(hdirh]hdir}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjhubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct dentry *dentryh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j4 c.vfs_rmdirasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hdentryh]hdentry}(hj3hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h'struct delegated_inode *delegated_inodeh](j )}(hjh]hstruct}(hjLhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjHubj2)}(h h]h }(hjYhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjHubh)}(hhh]jI)}(hdelegated_inodeh]hdelegated_inode}(hjjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjgubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjlmodnameN classnameNjj )}j ]j4 c.vfs_rmdirasbuh1hhjHubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjHubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHubjI)}(hdelegated_inodeh]hdelegated_inode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjHubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhMtubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhMtubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMthjhhubjw)}(hhh]h)}(hremove directoryh]hremove directory}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMthjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhMtubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``const struct mnt_idmap *idmap`` idmap of the mount the inode was found from ``struct inode *dir`` inode of the parent directory ``struct dentry *dentry`` dentry of the child directory ``struct delegated_inode *delegated_inode`` returns parent inode, if it's delegated. **Description** Remove a directory. If the inode has been found through an idmapped mount the idmap of the vfsmount must be passed through **idmap**. This function will then take care to map the inode according to **idmap** before checking permissions. On non-idmapped mounts or if permission checking is to be performed on the raw inode simply pass **nop_mnt_idmap**.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMxhjubj)}(hhh](j)}(hN``const struct mnt_idmap *idmap`` idmap of the mount the inode was found from h](j)}(h!``const struct mnt_idmap *idmap``h]j)}(hjh]hconst struct mnt_idmap *idmap}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMuhjubj)}(hhh]h)}(h+idmap of the mount the inode was found fromh]h+idmap of the mount the inode was found from}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj#hMuhj$ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj#hMuhjubj)}(h4``struct inode *dir`` inode of the parent directory h](j)}(h``struct inode *dir``h]j)}(hjGh]hstruct inode *dir}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjEubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMvhjAubj)}(hhh]h)}(hinode of the parent directoryh]hinode of the parent directory}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj\hMvhj]ubah}(h]h ]h"]h$]h&]uh1jhjAubeh}(h]h ]h"]h$]h&]uh1jhj\hMvhjubj)}(h8``struct dentry *dentry`` dentry of the child directory h](j)}(h``struct dentry *dentry``h]j)}(hjh]hstruct dentry *dentry}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj~ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMwhjzubj)}(hhh]h)}(hdentry of the child directoryh]hdentry of the child directory}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMwhjubah}(h]h ]h"]h$]h&]uh1jhjzubeh}(h]h ]h"]h$]h&]uh1jhjhMwhjubj)}(hU``struct delegated_inode *delegated_inode`` returns parent inode, if it's delegated. h](j)}(h+``struct delegated_inode *delegated_inode``h]j)}(hjh]h'struct delegated_inode *delegated_inode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMxhjubj)}(hhh]h)}(h(returns parent inode, if it's delegated.h]h*returns parent inode, if it’s delegated.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMxhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMxhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMzhjubh)}(hRemove a directory.h]hRemove a directory.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMyhjubh)}(hXLIf the inode has been found through an idmapped mount the idmap of the vfsmount must be passed through **idmap**. This function will then take care to map the inode according to **idmap** before checking permissions. On non-idmapped mounts or if permission checking is to be performed on the raw inode simply pass **nop_mnt_idmap**.h](hgIf the inode has been found through an idmapped mount the idmap of the vfsmount must be passed through }(hjhhhNhNubj)}(h **idmap**h]hidmap}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhB. This function will then take care to map the inode according to }(hjhhhNhNubj)}(h **idmap**h]hidmap}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh before checking permissions. On non-idmapped mounts or if permission checking is to be performed on the raw inode simply pass }(hjhhhNhNubj)}(h**nop_mnt_idmap**h]h nop_mnt_idmap}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM{hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j vfs_unlink (C function) c.vfs_unlinkhNtauh1hhjOghhhNhNubj)}(hhh](j)}(hint vfs_unlink (const struct mnt_idmap *idmap, struct inode *dir, struct dentry *dentry, struct delegated_inode *delegated_inode)h]j)}(hint vfs_unlink(const struct mnt_idmap *idmap, struct inode *dir, struct dentry *dentry, struct delegated_inode *delegated_inode)h](j)}(hinth]hint}(hj~hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjzhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjzhhhjhMubjC)}(h vfs_unlinkh]jI)}(h vfs_unlinkh]h vfs_unlink}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjzhhhjhMubj=)}(hr(const struct mnt_idmap *idmap, struct inode *dir, struct dentry *dentry, struct delegated_inode *delegated_inode)h](jC)}(hconst struct mnt_idmap *idmaph](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(h mnt_idmaph]h mnt_idmap}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jjsb c.vfs_unlinkasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hidmaph]hidmap}(hj/hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct inode *dirh](j )}(hjh]hstruct}(hjHhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjDubj2)}(h h]h }(hjUhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjDubh)}(hhh]jI)}(hinodeh]hinode}(hjfhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjcubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjhmodnameN classnameNjj )}j ]j c.vfs_unlinkasbuh1hhjDubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjDubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjDubjI)}(hdirh]hdir}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjDubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct dentry *dentryh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j c.vfs_unlinkasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h'struct delegated_inode *delegated_inodeh](j )}(hjh]hstruct}(hj(hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj$ubj2)}(h h]h }(hj5hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj$ubh)}(hhh]jI)}(hdelegated_inodeh]hdelegated_inode}(hjFhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjCubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjHmodnameN classnameNjj )}j ]j c.vfs_unlinkasbuh1hhj$ubj2)}(h h]h }(hjdhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj$ubj)}(hjh]h*}(hjrhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$ubjI)}(hdelegated_inodeh]hdelegated_inode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj$ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjzhhhjhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjvhhhjhMubah}(h]jqah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMhjshhubjw)}(hhh]h)}(hunlink a filesystem objecth]hunlink a filesystem object}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjhhubah}(h]h ]h"]h$]h&]uh1jvhjshhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjOghNhNubj)}(hXf**Parameters** ``const struct mnt_idmap *idmap`` idmap of the mount the inode was found from ``struct inode *dir`` parent directory ``struct dentry *dentry`` victim ``struct delegated_inode *delegated_inode`` returns victim inode, if the inode is delegated. **Description** The caller must hold dir->i_rwsem exclusively. If vfs_unlink discovers a delegation, it will return -EWOULDBLOCK and return a reference to the inode in delegated_inode. The caller should then break the delegation on that inode and retry. Because breaking a delegation may take a long time, the caller should drop dir->i_rwsem before doing so. Alternatively, a caller may pass NULL for delegated_inode. This may be appropriate for callers that expect the underlying filesystem not to be NFS exported. If the inode has been found through an idmapped mount the idmap of the vfsmount must be passed through **idmap**. This function will then take care to map the inode according to **idmap** before checking permissions. On non-idmapped mounts or if permission checking is to be performed on the raw inode simply pass **nop_mnt_idmap**.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjubj)}(hhh](j)}(hN``const struct mnt_idmap *idmap`` idmap of the mount the inode was found from h](j)}(h!``const struct mnt_idmap *idmap``h]j)}(hjh]hconst struct mnt_idmap *idmap}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjubj)}(hhh]h)}(h+idmap of the mount the inode was found fromh]h+idmap of the mount the inode was found from}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h'``struct inode *dir`` parent directory h](j)}(h``struct inode *dir``h]j)}(hj#h]hstruct inode *dir}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj!ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjubj)}(hhh]h)}(hparent directoryh]hparent directory}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj8hMhj9ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj8hMhjubj)}(h!``struct dentry *dentry`` victim h](j)}(h``struct dentry *dentry``h]j)}(hj\h]hstruct dentry *dentry}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjZubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjVubj)}(hhh]h)}(hvictimh]hvictim}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjqhMhjrubah}(h]h ]h"]h$]h&]uh1jhjVubeh}(h]h ]h"]h$]h&]uh1jhjqhMhjubj)}(h]``struct delegated_inode *delegated_inode`` returns victim inode, if the inode is delegated. h](j)}(h+``struct delegated_inode *delegated_inode``h]j)}(hjh]h'struct delegated_inode *delegated_inode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjubj)}(hhh]h)}(h0returns victim inode, if the inode is delegated.h]h0returns victim inode, if the inode is delegated.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjubh)}(h.The caller must hold dir->i_rwsem exclusively.h]h.The caller must hold dir->i_rwsem exclusively.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjubh)}(hX)If vfs_unlink discovers a delegation, it will return -EWOULDBLOCK and return a reference to the inode in delegated_inode. The caller should then break the delegation on that inode and retry. Because breaking a delegation may take a long time, the caller should drop dir->i_rwsem before doing so.h]hX)If vfs_unlink discovers a delegation, it will return -EWOULDBLOCK and return a reference to the inode in delegated_inode. The caller should then break the delegation on that inode and retry. Because breaking a delegation may take a long time, the caller should drop dir->i_rwsem before doing so.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjubh)}(hAlternatively, a caller may pass NULL for delegated_inode. This may be appropriate for callers that expect the underlying filesystem not to be NFS exported.h]hAlternatively, a caller may pass NULL for delegated_inode. This may be appropriate for callers that expect the underlying filesystem not to be NFS exported.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjubh)}(hXLIf the inode has been found through an idmapped mount the idmap of the vfsmount must be passed through **idmap**. This function will then take care to map the inode according to **idmap** before checking permissions. On non-idmapped mounts or if permission checking is to be performed on the raw inode simply pass **nop_mnt_idmap**.h](hgIf the inode has been found through an idmapped mount the idmap of the vfsmount must be passed through }(hjhhhNhNubj)}(h **idmap**h]hidmap}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhB. This function will then take care to map the inode according to }(hjhhhNhNubj)}(h **idmap**h]hidmap}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh before checking permissions. On non-idmapped mounts or if permission checking is to be performed on the raw inode simply pass }(hjhhhNhNubj)}(h**nop_mnt_idmap**h]h nop_mnt_idmap}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j vfs_symlink (C function) c.vfs_symlinkhNtauh1hhjOghhhNhNubj)}(hhh](j)}(hint vfs_symlink (const struct mnt_idmap *idmap, struct inode *dir, struct dentry *dentry, const char *oldname, struct delegated_inode *delegated_inode)h]j)}(hint vfs_symlink(const struct mnt_idmap *idmap, struct inode *dir, struct dentry *dentry, const char *oldname, struct delegated_inode *delegated_inode)h](j)}(hinth]hint}(hjxhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjthhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjthhhjhMubjC)}(h vfs_symlinkh]jI)}(h vfs_symlinkh]h vfs_symlink}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjthhhjhMubj=)}(h(const struct mnt_idmap *idmap, struct inode *dir, struct dentry *dentry, const char *oldname, struct delegated_inode *delegated_inode)h](jC)}(hconst struct mnt_idmap *idmaph](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(h mnt_idmaph]h mnt_idmap}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jjsb c.vfs_symlinkasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hidmaph]hidmap}(hj)hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct inode *dirh](j )}(hjh]hstruct}(hjBhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj>ubj2)}(h h]h }(hjOhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj>ubh)}(hhh]jI)}(hinodeh]hinode}(hj`hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj]ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjbmodnameN classnameNjj )}j ]j  c.vfs_symlinkasbuh1hhj>ubj2)}(h h]h }(hj~hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj>ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>ubjI)}(hdirh]hdir}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj>ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct dentry *dentryh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j  c.vfs_symlinkasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hdentryh]hdentry}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hconst char *oldnameh](j )}(hjJh]hconst}(hj"hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hj/hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hcharh]hchar}(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjKhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjYhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(holdnameh]holdname}(hjfhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h'struct delegated_inode *delegated_inodeh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj{ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj{ubh)}(hhh]jI)}(hdelegated_inodeh]hdelegated_inode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j  c.vfs_symlinkasbuh1hhj{ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj{ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{ubjI)}(hdelegated_inodeh]hdelegated_inode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj{ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjthhhjhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjphhhjhMubah}(h]jkah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMhjmhhubjw)}(hhh]h)}(hcreate symlinkh]hcreate symlink}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjhhubah}(h]h ]h"]h$]h&]uh1jvhjmhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``const struct mnt_idmap *idmap`` idmap of the mount the inode was found from ``struct inode *dir`` inode of the parent directory ``struct dentry *dentry`` dentry of the child symlink file ``const char *oldname`` name of the file to link to ``struct delegated_inode *delegated_inode`` returns victim inode, if the inode is delegated. **Description** Create a symlink. If the inode has been found through an idmapped mount the idmap of the vfsmount must be passed through **idmap**. This function will then take care to map the inode according to **idmap** before checking permissions. On non-idmapped mounts or if permission checking is to be performed on the raw inode simply pass **nop_mnt_idmap**.h](h)}(h**Parameters**h]j)}(hj"h]h Parameters}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjubj)}(hhh](j)}(hN``const struct mnt_idmap *idmap`` idmap of the mount the inode was found from h](j)}(h!``const struct mnt_idmap *idmap``h]j)}(hjAh]hconst struct mnt_idmap *idmap}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1jhj?ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhj;ubj)}(hhh]h)}(h+idmap of the mount the inode was found fromh]h+idmap of the mount the inode was found from}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjVhMhjWubah}(h]h ]h"]h$]h&]uh1jhj;ubeh}(h]h ]h"]h$]h&]uh1jhjVhMhj8ubj)}(h4``struct inode *dir`` inode of the parent directory h](j)}(h``struct inode *dir``h]j)}(hjzh]hstruct inode *dir}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjxubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjtubj)}(hhh]h)}(hinode of the parent directoryh]hinode of the parent directory}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjtubeh}(h]h ]h"]h$]h&]uh1jhjhMhj8ubj)}(h;``struct dentry *dentry`` dentry of the child symlink file h](j)}(h``struct dentry *dentry``h]j)}(hjh]hstruct dentry *dentry}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjubj)}(hhh]h)}(h dentry of the child symlink fileh]h dentry of the child symlink file}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhj8ubj)}(h4``const char *oldname`` name of the file to link to h](j)}(h``const char *oldname``h]j)}(hjh]hconst char *oldname}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjubj)}(hhh]h)}(hname of the file to link toh]hname of the file to link to}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhj8ubj)}(h]``struct delegated_inode *delegated_inode`` returns victim inode, if the inode is delegated. h](j)}(h+``struct delegated_inode *delegated_inode``h]j)}(hj%h]h'struct delegated_inode *delegated_inode}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj#ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjubj)}(hhh]h)}(h0returns victim inode, if the inode is delegated.h]h0returns victim inode, if the inode is delegated.}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj:hMhj;ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj:hMhj8ubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hj`h]h Description}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj^ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjubh)}(hCreate a symlink.h]hCreate a symlink.}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjubh)}(hXLIf the inode has been found through an idmapped mount the idmap of the vfsmount must be passed through **idmap**. This function will then take care to map the inode according to **idmap** before checking permissions. On non-idmapped mounts or if permission checking is to be performed on the raw inode simply pass **nop_mnt_idmap**.h](hgIf the inode has been found through an idmapped mount the idmap of the vfsmount must be passed through }(hjhhhNhNubj)}(h **idmap**h]hidmap}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhB. This function will then take care to map the inode according to }(hjhhhNhNubj)}(h **idmap**h]hidmap}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh before checking permissions. On non-idmapped mounts or if permission checking is to be performed on the raw inode simply pass }(hjhhhNhNubj)}(h**nop_mnt_idmap**h]h nop_mnt_idmap}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j vfs_link (C function) c.vfs_linkhNtauh1hhjOghhhNhNubj)}(hhh](j)}(hint vfs_link (struct dentry *old_dentry, const struct mnt_idmap *idmap, struct inode *dir, struct dentry *new_dentry, struct delegated_inode *delegated_inode)h]j)}(hint vfs_link(struct dentry *old_dentry, const struct mnt_idmap *idmap, struct inode *dir, struct dentry *new_dentry, struct delegated_inode *delegated_inode)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMubjC)}(hvfs_linkh]jI)}(hvfs_linkh]hvfs_link}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhMubj=)}(h(struct dentry *old_dentry, const struct mnt_idmap *idmap, struct inode *dir, struct dentry *new_dentry, struct delegated_inode *delegated_inode)h](jC)}(hstruct dentry *old_dentryh](j )}(hjh]hstruct}(hj'hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj#ubj2)}(h h]h }(hj4hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj#ubh)}(hhh]jI)}(hdentryh]hdentry}(hjEhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjBubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjGmodnameN classnameNjj )}j ]j)}jj sb c.vfs_linkasbuh1hhj#ubj2)}(h h]h }(hjehhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj#ubj)}(hjh]h*}(hjshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#ubjI)}(h old_dentryh]h old_dentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj#ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hconst struct mnt_idmap *idmaph](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(h mnt_idmaph]h mnt_idmap}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]ja c.vfs_linkasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hidmaph]hidmap}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct inode *dirh](j )}(hjh]hstruct}(hj$hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj ubj2)}(h h]h }(hj1hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj ubh)}(hhh]jI)}(hinodeh]hinode}(hjBhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj?ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjDmodnameN classnameNjj )}j ]ja c.vfs_linkasbuh1hhj ubj2)}(h h]h }(hj`hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj ubj)}(hjh]h*}(hjnhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubjI)}(hdirh]hdir}(hj{hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct dentry *new_dentryh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]ja c.vfs_linkasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(h new_dentryh]h new_dentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h'struct delegated_inode *delegated_inodeh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hdelegated_inodeh]hdelegated_inode}(hj"hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj$modnameN classnameNjj )}j ]ja c.vfs_linkasbuh1hhjubj2)}(h h]h }(hj@hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hdelegated_inodeh]hdelegated_inode}(hj[hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhMubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMhjhhubjw)}(hhh]h)}(hcreate a new linkh]hcreate a new link}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``struct dentry *old_dentry`` object to be linked ``const struct mnt_idmap *idmap`` idmap of the mount ``struct inode *dir`` new parent ``struct dentry *new_dentry`` where to create the new link ``struct delegated_inode *delegated_inode`` returns inode needing a delegation break **Description** The caller must hold dir->i_rwsem exclusively. If vfs_link discovers a delegation on the to-be-linked file in need of breaking, it will return -EWOULDBLOCK and return a reference to the inode in delegated_inode. The caller should then break the delegation and retry. Because breaking a delegation may take a long time, the caller should drop the i_rwsem before doing so. Alternatively, a caller may pass NULL for delegated_inode. This may be appropriate for callers that expect the underlying filesystem not to be NFS exported. If the inode has been found through an idmapped mount the idmap of the vfsmount must be passed through **idmap**. This function will then take care to map the inode according to **idmap** before checking permissions. On non-idmapped mounts or if permission checking is to be performed on the raw inode simply pass **nop_mnt_idmap**.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjubj)}(hhh](j)}(h2``struct dentry *old_dentry`` object to be linked h](j)}(h``struct dentry *old_dentry``h]j)}(hjh]hstruct dentry *old_dentry}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjubj)}(hhh]h)}(hobject to be linkedh]hobject to be linked}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h5``const struct mnt_idmap *idmap`` idmap of the mount h](j)}(h!``const struct mnt_idmap *idmap``h]j)}(hjh]hconst struct mnt_idmap *idmap}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjubj)}(hhh]h)}(hidmap of the mounth]hidmap of the mount}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h!``struct inode *dir`` new parent h](j)}(h``struct inode *dir``h]j)}(hj8h]hstruct inode *dir}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj6ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhj2ubj)}(hhh]h)}(h new parenth]h new parent}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjMhMhjNubah}(h]h ]h"]h$]h&]uh1jhj2ubeh}(h]h ]h"]h$]h&]uh1jhjMhMhjubj)}(h;``struct dentry *new_dentry`` where to create the new link h](j)}(h``struct dentry *new_dentry``h]j)}(hjqh]hstruct dentry *new_dentry}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1jhjoubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjkubj)}(hhh]h)}(hwhere to create the new linkh]hwhere to create the new link}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjkubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(hU``struct delegated_inode *delegated_inode`` returns inode needing a delegation break h](j)}(h+``struct delegated_inode *delegated_inode``h]j)}(hjh]h'struct delegated_inode *delegated_inode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjubj)}(hhh]h)}(h(returns inode needing a delegation breakh]h(returns inode needing a delegation break}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjubh)}(h.The caller must hold dir->i_rwsem exclusively.h]h.The caller must hold dir->i_rwsem exclusively.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjubh)}(hXEIf vfs_link discovers a delegation on the to-be-linked file in need of breaking, it will return -EWOULDBLOCK and return a reference to the inode in delegated_inode. The caller should then break the delegation and retry. Because breaking a delegation may take a long time, the caller should drop the i_rwsem before doing so.h]hXEIf vfs_link discovers a delegation on the to-be-linked file in need of breaking, it will return -EWOULDBLOCK and return a reference to the inode in delegated_inode. The caller should then break the delegation and retry. Because breaking a delegation may take a long time, the caller should drop the i_rwsem before doing so.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjubh)}(hAlternatively, a caller may pass NULL for delegated_inode. This may be appropriate for callers that expect the underlying filesystem not to be NFS exported.h]hAlternatively, a caller may pass NULL for delegated_inode. This may be appropriate for callers that expect the underlying filesystem not to be NFS exported.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjubh)}(hXLIf the inode has been found through an idmapped mount the idmap of the vfsmount must be passed through **idmap**. This function will then take care to map the inode according to **idmap** before checking permissions. On non-idmapped mounts or if permission checking is to be performed on the raw inode simply pass **nop_mnt_idmap**.h](hgIf the inode has been found through an idmapped mount the idmap of the vfsmount must be passed through }(hj(hhhNhNubj)}(h **idmap**h]hidmap}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj(ubhB. This function will then take care to map the inode according to }(hj(hhhNhNubj)}(h **idmap**h]hidmap}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj(ubh before checking permissions. On non-idmapped mounts or if permission checking is to be performed on the raw inode simply pass }(hj(hhhNhNubj)}(h**nop_mnt_idmap**h]h nop_mnt_idmap}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jhj(ubh.}(hj(hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j vfs_rename (C function) c.vfs_renamehNtauh1hhjOghhhNhNubj)}(hhh](j)}(h&int vfs_rename (struct renamedata *rd)h]j)}(h%int vfs_rename(struct renamedata *rd)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMubjC)}(h vfs_renameh]jI)}(h vfs_renameh]h vfs_rename}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhMubj=)}(h(struct renamedata *rd)h]jC)}(hstruct renamedata *rdh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(h renamedatah]h renamedata}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jjsb c.vfs_renameasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hrdh]hrd}(hj#hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubah}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhMubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMhjhhubjw)}(hhh]h)}(hrename a filesystem objecth]hrename a filesystem object}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjJhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjejjejjjuh1jhhhjOghNhNubj)}(hXr **Parameters** ``struct renamedata *rd`` pointer to :c:type:`struct renamedata ` info **Description** The caller must hold multiple mutexes--see lock_rename()). If vfs_rename discovers a delegation in need of breaking at either the source or destination, it will return -EWOULDBLOCK and return a reference to the inode in delegated_inode. The caller should then break the delegation and retry. Because breaking a delegation may take a long time, the caller should drop all locks before doing so. Alternatively, a caller may pass NULL for delegated_inode. This may be appropriate for callers that expect the underlying filesystem not to be NFS exported. The worst of all namespace operations - renaming directory. "Perverted" doesn't even start to describe it. Somebody in UCB had a heck of a trip... Problems: a) we can get into loop creation. b) race potential - two innocent renames can create a loop together. That's where 4.4BSD screws up. Current fix: serialization on sb->s_vfs_rename_mutex. We might be more accurate, but that's another story. c) we may have to lock up to _four_ objects - parents and victim (if it exists), and source (if it's a non-directory or a subdirectory that moves to different parent). And that - after we got ->i_rwsem on parents (until then we don't know whether the target exists). Solution: try to be smart with locking order for inodes. We rely on the fact that tree topology may change only under ->s_vfs_rename_mutex _and_ that parent of the object we move will be locked. Thus we can rank directories by the tree (ancestors first) and rank all non-directories after them. That works since everybody except rename does "lock parent, lookup, lock child" and rename is under ->s_vfs_rename_mutex. HOWEVER, it relies on the assumption that any object with ->lookup() has no more than 1 dentry. If "hybrid" objects will ever appear, we'd better make sure that there's no link(2) for them. d) conversion from fhandle to dentry may come in the wrong moment - when we are removing the target. Solution: we will have to grab ->i_rwsem in the fhandle_to_dentry code. [FIXME - current nfsfh.c relies on ->i_rwsem on parents, which works but leads to some truly excessive locking].h](h)}(h**Parameters**h]j)}(hjoh]h Parameters}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjmubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjiubj)}(hhh]j)}(hS``struct renamedata *rd`` pointer to :c:type:`struct renamedata ` info h](j)}(h``struct renamedata *rd``h]j)}(hjh]hstruct renamedata *rd}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjubj)}(hhh]h)}(h8pointer to :c:type:`struct renamedata ` infoh](h pointer to }(hjhhhNhNubh)}(h(:c:type:`struct renamedata `h]j)}(hjh]hstruct renamedata}(hjhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnjjj renamedatauh1hhjhMhjubh info}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjiubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjiubh)}(h:The caller must hold multiple mutexes--see lock_rename()).h]h:The caller must hold multiple mutexes--see lock_rename()).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjiubh)}(hXPIf vfs_rename discovers a delegation in need of breaking at either the source or destination, it will return -EWOULDBLOCK and return a reference to the inode in delegated_inode. The caller should then break the delegation and retry. Because breaking a delegation may take a long time, the caller should drop all locks before doing so.h]hXPIf vfs_rename discovers a delegation in need of breaking at either the source or destination, it will return -EWOULDBLOCK and return a reference to the inode in delegated_inode. The caller should then break the delegation and retry. Because breaking a delegation may take a long time, the caller should drop all locks before doing so.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjiubh)}(hAlternatively, a caller may pass NULL for delegated_inode. This may be appropriate for callers that expect the underlying filesystem not to be NFS exported.h]hAlternatively, a caller may pass NULL for delegated_inode. This may be appropriate for callers that expect the underlying filesystem not to be NFS exported.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjiubh)}(hThe worst of all namespace operations - renaming directory. "Perverted" doesn't even start to describe it. Somebody in UCB had a heck of a trip... Problems:h]hThe worst of all namespace operations - renaming directory. “Perverted” doesn’t even start to describe it. Somebody in UCB had a heck of a trip... Problems:}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjiubj)}(hXa) we can get into loop creation. b) race potential - two innocent renames can create a loop together. That's where 4.4BSD screws up. Current fix: serialization on sb->s_vfs_rename_mutex. We might be more accurate, but that's another story. c) we may have to lock up to _four_ objects - parents and victim (if it exists), and source (if it's a non-directory or a subdirectory that moves to different parent). And that - after we got ->i_rwsem on parents (until then we don't know whether the target exists). Solution: try to be smart with locking order for inodes. We rely on the fact that tree topology may change only under ->s_vfs_rename_mutex _and_ that parent of the object we move will be locked. Thus we can rank directories by the tree (ancestors first) and rank all non-directories after them. That works since everybody except rename does "lock parent, lookup, lock child" and rename is under ->s_vfs_rename_mutex. HOWEVER, it relies on the assumption that any object with ->lookup() has no more than 1 dentry. If "hybrid" objects will ever appear, we'd better make sure that there's no link(2) for them. d) conversion from fhandle to dentry may come in the wrong moment - when we are removing the target. Solution: we will have to grab ->i_rwsem in the fhandle_to_dentry code. [FIXME - current nfsfh.c relies on ->i_rwsem on parents, which works but leads to some truly excessive locking].h]j9W)}(hhh](jE)}(hwe can get into loop creation.h]h)}(hjGh]hwe can get into loop creation.}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjEubah}(h]h ]h"]h$]h&]uh1jEhjBubjE)}(hrace potential - two innocent renames can create a loop together. That's where 4.4BSD screws up. Current fix: serialization on sb->s_vfs_rename_mutex. We might be more accurate, but that's another story.h]h)}(hrace potential - two innocent renames can create a loop together. That's where 4.4BSD screws up. Current fix: serialization on sb->s_vfs_rename_mutex. We might be more accurate, but that's another story.h]hrace potential - two innocent renames can create a loop together. That’s where 4.4BSD screws up. Current fix: serialization on sb->s_vfs_rename_mutex. We might be more accurate, but that’s another story.}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhj]ubah}(h]h ]h"]h$]h&]uh1jEhjBubjE)}(hXjwe may have to lock up to _four_ objects - parents and victim (if it exists), and source (if it's a non-directory or a subdirectory that moves to different parent). And that - after we got ->i_rwsem on parents (until then we don't know whether the target exists). Solution: try to be smart with locking order for inodes. We rely on the fact that tree topology may change only under ->s_vfs_rename_mutex _and_ that parent of the object we move will be locked. Thus we can rank directories by the tree (ancestors first) and rank all non-directories after them. That works since everybody except rename does "lock parent, lookup, lock child" and rename is under ->s_vfs_rename_mutex. HOWEVER, it relies on the assumption that any object with ->lookup() has no more than 1 dentry. If "hybrid" objects will ever appear, we'd better make sure that there's no link(2) for them.h]h)}(hXjwe may have to lock up to _four_ objects - parents and victim (if it exists), and source (if it's a non-directory or a subdirectory that moves to different parent). And that - after we got ->i_rwsem on parents (until then we don't know whether the target exists). Solution: try to be smart with locking order for inodes. We rely on the fact that tree topology may change only under ->s_vfs_rename_mutex _and_ that parent of the object we move will be locked. Thus we can rank directories by the tree (ancestors first) and rank all non-directories after them. That works since everybody except rename does "lock parent, lookup, lock child" and rename is under ->s_vfs_rename_mutex. HOWEVER, it relies on the assumption that any object with ->lookup() has no more than 1 dentry. If "hybrid" objects will ever appear, we'd better make sure that there's no link(2) for them.h]hXzwe may have to lock up to _four_ objects - parents and victim (if it exists), and source (if it’s a non-directory or a subdirectory that moves to different parent). And that - after we got ->i_rwsem on parents (until then we don’t know whether the target exists). Solution: try to be smart with locking order for inodes. We rely on the fact that tree topology may change only under ->s_vfs_rename_mutex _and_ that parent of the object we move will be locked. Thus we can rank directories by the tree (ancestors first) and rank all non-directories after them. That works since everybody except rename does “lock parent, lookup, lock child” and rename is under ->s_vfs_rename_mutex. HOWEVER, it relies on the assumption that any object with ->lookup() has no more than 1 dentry. If “hybrid” objects will ever appear, we’d better make sure that there’s no link(2) for them.}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjvubah}(h]h ]h"]h$]h&]uh1jEhjBubjE)}(hXconversion from fhandle to dentry may come in the wrong moment - when we are removing the target. Solution: we will have to grab ->i_rwsem in the fhandle_to_dentry code. [FIXME - current nfsfh.c relies on ->i_rwsem on parents, which works but leads to some truly excessive locking].h]h)}(hXconversion from fhandle to dentry may come in the wrong moment - when we are removing the target. Solution: we will have to grab ->i_rwsem in the fhandle_to_dentry code. [FIXME - current nfsfh.c relies on ->i_rwsem on parents, which works but leads to some truly excessive locking].h]hXconversion from fhandle to dentry may come in the wrong moment - when we are removing the target. Solution: we will have to grab ->i_rwsem in the fhandle_to_dentry code. [FIXME - current nfsfh.c relies on ->i_rwsem on parents, which works but leads to some truly excessive locking].}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjubah}(h]h ]h"]h$]h&]uh1jEhjBubeh}(h]h ]h"]h$]h&]juW loweralphajwWhjxWjuh1j8Whj>ubah}(h]h ]h"]h$]h&]uh1jhjVhMhjiubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j vfs_readlink (C function)c.vfs_readlinkhNtauh1hhjOghhhNhNubj)}(hhh](j)}(hIint vfs_readlink (struct dentry *dentry, char __user *buffer, int buflen)h]j)}(hHint vfs_readlink(struct dentry *dentry, char __user *buffer, int buflen)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMubjC)}(h vfs_readlinkh]jI)}(h vfs_readlinkh]h vfs_readlink}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhMubj=)}(h8(struct dentry *dentry, char __user *buffer, int buflen)h](jC)}(hstruct dentry *dentryh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hdentryh]hdentry}(hj0hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj-ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj2modnameN classnameNjj )}j ]j)}jjsbc.vfs_readlinkasbuh1hhjubj2)}(h h]h }(hjPhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hdentryh]hdentry}(hjkhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj ubjC)}(hchar __user *bufferh](j)}(hcharh]hchar}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh__user}(hjhhhNhNubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hbufferh]hbuffer}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj ubjC)}(h int buflenh](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hbuflenh]hbuflen}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj ubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhMubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMhjhhubjw)}(hhh]h)}(h'copy symlink body into userspace bufferh]h'copy symlink body into userspace buffer}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjj6jj6jjjuh1jhhhjOghNhNubj)}(hX **Parameters** ``struct dentry *dentry`` dentry on which to get symbolic link ``char __user *buffer`` user memory pointer ``int buflen`` size of buffer **Description** Does not touch atime. That's up to the caller if necessary Does not call security hook.h](h)}(h**Parameters**h]j)}(hj@h]h Parameters}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj>ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhj:ubj)}(hhh](j)}(h?``struct dentry *dentry`` dentry on which to get symbolic link h](j)}(h``struct dentry *dentry``h]j)}(hj_h]hstruct dentry *dentry}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1jhj]ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjYubj)}(hhh]h)}(h$dentry on which to get symbolic linkh]h$dentry on which to get symbolic link}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjthMhjuubah}(h]h ]h"]h$]h&]uh1jhjYubeh}(h]h ]h"]h$]h&]uh1jhjthMhjVubj)}(h,``char __user *buffer`` user memory pointer h](j)}(h``char __user *buffer``h]j)}(hjh]hchar __user *buffer}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjubj)}(hhh]h)}(huser memory pointerh]huser memory pointer}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjVubj)}(h``int buflen`` size of buffer h](j)}(h``int buflen``h]j)}(hjh]h int buflen}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjubj)}(hhh]h)}(hsize of bufferh]hsize of buffer}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjVubeh}(h]h ]h"]h$]h&]uh1jhj:ubh)}(h**Description**h]j)}(hj h]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hj:ubh)}(h;Does not touch atime. That's up to the caller if necessaryh]h=Does not touch atime. That’s up to the caller if necessary}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhj:ubh)}(hDoes not call security hook.h]hDoes not call security hook.}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM hj:ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j vfs_get_link (C function)c.vfs_get_linkhNtauh1hhjOghhhNhNubj)}(hhh](j)}(hLconst char * vfs_get_link (struct dentry *dentry, struct delayed_call *done)h]j)}(hJconst char *vfs_get_link(struct dentry *dentry, struct delayed_call *done)h](j )}(hjJh]hconst}(hj`hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj\hhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM0ubj2)}(h h]h }(hjnhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj\hhhjmhM0ubj)}(hcharh]hchar}(hj|hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\hhhjmhM0ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj\hhhjmhM0ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\hhhjmhM0ubjC)}(h vfs_get_linkh]jI)}(h vfs_get_linkh]h vfs_get_link}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj\hhhjmhM0ubj=)}(h2(struct dentry *dentry, struct delayed_call *done)h](jC)}(hstruct dentry *dentryh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jjsbc.vfs_get_linkasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct delayed_call *doneh](j )}(hjh]hstruct}(hj7hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj3ubj2)}(h h]h }(hjDhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj3ubh)}(hhh]jI)}(h delayed_callh]h delayed_call}(hjUhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjRubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjWmodnameN classnameNjj )}j ]jc.vfs_get_linkasbuh1hhj3ubj2)}(h h]h }(hjshhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj3ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3ubjI)}(hdoneh]hdone}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj3ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hj\hhhjmhM0ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjXhhhjmhM0ubah}(h]jSah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjmhM0hjUhhubjw)}(hhh]h)}(hget symlink bodyh]hget symlink body}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM0hjhhubah}(h]h ]h"]h$]h&]uh1jvhjUhhhjmhM0ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjOghNhNubj)}(hXi**Parameters** ``struct dentry *dentry`` dentry on which to get symbolic link ``struct delayed_call *done`` caller needs to free returned data with this **Description** Calls security hook and i_op->get_link() on the supplied inode. It does not touch atime. That's up to the caller if necessary. Does not work on "special" symlinks like /proc/$$/fd/Nh](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM4hjubj)}(hhh](j)}(h?``struct dentry *dentry`` dentry on which to get symbolic link h](j)}(h``struct dentry *dentry``h]j)}(hjh]hstruct dentry *dentry}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM1hjubj)}(hhh]h)}(h$dentry on which to get symbolic linkh]h$dentry on which to get symbolic link}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM1hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM1hjubj)}(hK``struct delayed_call *done`` caller needs to free returned data with this h](j)}(h``struct delayed_call *done``h]j)}(hj2h]hstruct delayed_call *done}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj0ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM2hj,ubj)}(hhh]h)}(h,caller needs to free returned data with thish]h,caller needs to free returned data with this}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjGhM2hjHubah}(h]h ]h"]h$]h&]uh1jhj,ubeh}(h]h ]h"]h$]h&]uh1jhjGhM2hjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjmh]h Description}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1jhjkubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM4hjubh)}(h?Calls security hook and i_op->get_link() on the supplied inode.h]h?Calls security hook and i_op->get_link() on the supplied inode.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM3hjubh)}(h?It does not touch atime. That's up to the caller if necessary.h]hAIt does not touch atime. That’s up to the caller if necessary.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM5hjubh)}(h6Does not work on "special" symlinks like /proc/$$/fd/Nh]h:Does not work on “special” symlinks like /proc/$$/fd/N}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chM7hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j page_get_link (C function)c.page_get_linkhNtauh1hhjOghhhNhNubj)}(hhh](j)}(hfconst char * page_get_link (struct dentry *dentry, struct inode *inode, struct delayed_call *callback)h]j)}(hdconst char *page_get_link(struct dentry *dentry, struct inode *inode, struct delayed_call *callback)h](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMiubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMiubj)}(hcharh]hchar}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMiubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMiubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMiubjC)}(h page_get_linkh]jI)}(h page_get_linkh]h page_get_link}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhMiubj=)}(hK(struct dentry *dentry, struct inode *inode, struct delayed_call *callback)h](jC)}(hstruct dentry *dentryh](j )}(hjh]hstruct}(hj5hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj1ubj2)}(h h]h }(hjBhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj1ubh)}(hhh]jI)}(hdentryh]hdentry}(hjShhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjPubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjUmodnameN classnameNjj )}j ]j)}jjsbc.page_get_linkasbuh1hhj1ubj2)}(h h]h }(hjshhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj1ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj1ubjI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj1ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj-ubjC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]joc.page_get_linkasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj-ubjC)}(hstruct delayed_call *callbackh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hj$hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(h delayed_callh]h delayed_call}(hj5hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj2ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj7modnameN classnameNjj )}j ]joc.page_get_linkasbuh1hhjubj2)}(h h]h }(hjShhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hcallbackh]hcallback}(hjnhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj-ubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhMiubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhMiubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMihjhhubjw)}(hhh]h)}(h2An implementation of the get_link inode_operation.h]h2An implementation of the get_link inode_operation.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMihjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhMiubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``struct dentry *dentry`` The directory entry which is the symlink. ``struct inode *inode`` The inode for the symlink. ``struct delayed_call *callback`` Used to drop the reference to the symlink. **Description** Filesystems which store their symlinks in the page cache should use this to implement the get_link() member of their inode_operations. **Return** A pointer to the NUL-terminated symlink.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMmhjubj)}(hhh](j)}(hD``struct dentry *dentry`` The directory entry which is the symlink. h](j)}(h``struct dentry *dentry``h]j)}(hjh]hstruct dentry *dentry}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMjhjubj)}(hhh]h)}(h)The directory entry which is the symlink.h]h)The directory entry which is the symlink.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMjhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMjhjubj)}(h3``struct inode *inode`` The inode for the symlink. h](j)}(h``struct inode *inode``h]j)}(hjh]hstruct inode *inode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMkhj ubj)}(hhh]h)}(hThe inode for the symlink.h]hThe inode for the symlink.}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj'hMkhj(ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj'hMkhjubj)}(hM``struct delayed_call *callback`` Used to drop the reference to the symlink. h](j)}(h!``struct delayed_call *callback``h]j)}(hjKh]hstruct delayed_call *callback}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjIubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMlhjEubj)}(hhh]h)}(h*Used to drop the reference to the symlink.h]h*Used to drop the reference to the symlink.}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj`hMlhjaubah}(h]h ]h"]h$]h&]uh1jhjEubeh}(h]h ]h"]h$]h&]uh1jhj`hMlhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMnhjubh)}(hFilesystems which store their symlinks in the page cache should use this to implement the get_link() member of their inode_operations.h]hFilesystems which store their symlinks in the page cache should use this to implement the get_link() member of their inode_operations.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMmhjubh)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMphjubh)}(h(A pointer to the NUL-terminated symlink.h]h(A pointer to the NUL-terminated symlink.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMqhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j page_put_link (C function)c.page_put_linkhNtauh1hhjOghhhNhNubj)}(hhh](j)}(hvoid page_put_link (void *arg)h]j)}(hvoid page_put_link(void *arg)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMubjC)}(h page_put_linkh]jI)}(h page_put_linkh]h page_put_link}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhMubj=)}(h (void *arg)h]jC)}(h void *argh](j)}(hvoidh]hvoid}(hj/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubj2)}(h h]h }(hj=hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj+ubj)}(hjh]h*}(hjKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubjI)}(hargh]harg}(hjXhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj+ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj'ubah}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhMubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMhjhhubjw)}(hhh]h)}(h"Drop the reference to the symlink.h]h"Drop the reference to the symlink.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjOghNhNubj)}(hX>**Parameters** ``void *arg`` The folio which contains the symlink. **Description** This is used internally by page_get_link(). It is exported for use by filesystems which need to implement a variant of page_get_link() themselves. Despite the apparent symmetry, filesystems which use page_get_link() do not need to call page_put_link(). The argument, while it has a void pointer type, must be a pointer to the folio which was retrieved from the page cache. The delayed_call infrastructure is used to drop the reference count once the caller is done with the symlink.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjubj)}(hhh]j)}(h4``void *arg`` The folio which contains the symlink. h](j)}(h ``void *arg``h]j)}(hjh]h void *arg}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjubj)}(hhh]h)}(h%The folio which contains the symlink.h]h%The folio which contains the symlink.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjubh)}(hThis is used internally by page_get_link(). It is exported for use by filesystems which need to implement a variant of page_get_link() themselves. Despite the apparent symmetry, filesystems which use page_get_link() do not need to call page_put_link().h]hThis is used internally by page_get_link(). It is exported for use by filesystems which need to implement a variant of page_get_link() themselves. Despite the apparent symmetry, filesystems which use page_get_link() do not need to call page_put_link().}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjubh)}(hThe argument, while it has a void pointer type, must be a pointer to the folio which was retrieved from the page cache. The delayed_call infrastructure is used to drop the reference count once the caller is done with the symlink.h]hThe argument, while it has a void pointer type, must be a pointer to the folio which was retrieved from the page cache. The delayed_call infrastructure is used to drop the reference count once the caller is done with the symlink.}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:56: ./fs/namei.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j finish_open (C function) c.finish_openhNtauh1hhjOghhhNhNubj)}(hhh](j)}(hfint finish_open (struct file *file, struct dentry *dentry, int (*open)(struct inode *, struct file *))h]j)}(hcint finish_open(struct file *file, struct dentry *dentry, int (*open)(struct inode*, struct file*))h](j)}(hinth]hint}(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNhhhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:59: ./fs/open.chMubj2)}(h h]h }(hjahhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjNhhhj`hMubjC)}(h finish_openh]jI)}(h finish_openh]h finish_open}(hjshhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjoubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjNhhhj`hMubj=)}(hT(struct file *file, struct dentry *dentry, int (*open)(struct inode*, struct file*))h](jC)}(hstruct file *fileh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hfileh]hfile}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jjusb c.finish_openasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hfileh]hfile}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct dentry *dentryh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj!modnameN classnameNjj )}j ]j c.finish_openasbuh1hhjubj2)}(h h]h }(hj=hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hdentryh]hdentry}(hjXhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h(int (*open)(struct inode*, struct file*)h](j)}(hinth]hint}(hjqhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjmubj)}(hjʥh]h(}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmubjI)}(hopenh]hopen}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjmubj)}(hjh]h)}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmubj)}(hjʥh]h(}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmubj )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjmubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjmubh)}(hhh]jI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j c.finish_openasbuh1hhjmubj)}(hjh]h*}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmubj)}(hjWh]h,}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmubj2)}(h h]h }(hj%hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjmubj )}(hjh]hstruct}(hj3hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjmubj2)}(h h]h }(hj@hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjmubh)}(hhh]jI)}(hfileh]hfile}(hjQhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjNubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjSmodnameN classnameNjj )}j ]j c.finish_openasbuh1hhjmubj)}(hjh]h*}(hjohhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmubj)}(hjh]h)}(hj|hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjNhhhj`hMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjJhhhj`hMubah}(h]jEah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj`hMhjGhhubjw)}(hhh]h)}(hfinish opening a fileh]hfinish opening a file}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:59: ./fs/open.chMhjhhubah}(h]h ]h"]h$]h&]uh1jvhjGhhhj`hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjOghNhNubj)}(hXT**Parameters** ``struct file *file`` file pointer ``struct dentry *dentry`` pointer to dentry ``int (*open)(struct inode *, struct file *)`` open callback **Description** This can be used to finish opening a file passed to i_op->atomic_open(). If the open callback is set to NULL, then the standard f_op->open() filesystem callback is substituted. NB: the dentry reference is _not_ consumed. If, for example, the dentry is the return value of d_splice_alias(), then the caller needs to perform dput() on it after finish_open(). Returns zero on success or -errno if the open failed.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:59: ./fs/open.chMhjubj)}(hhh](j)}(h#``struct file *file`` file pointer h](j)}(h``struct file *file``h]j)}(hjh]hstruct file *file}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:59: ./fs/open.chMhjubj)}(hhh]h)}(h file pointerh]h file pointer}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h,``struct dentry *dentry`` pointer to dentry h](j)}(h``struct dentry *dentry``h]j)}(hjh]hstruct dentry *dentry}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:59: ./fs/open.chMhjubj)}(hhh]h)}(hpointer to dentryh]hpointer to dentry}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj4hMhj5ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj4hMhjubj)}(h=``int (*open)(struct inode *, struct file *)`` open callback h](j)}(h.``int (*open)(struct inode *, struct file *)``h]j)}(hjXh]h*int (*open)(struct inode *, struct file *)}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjVubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:59: ./fs/open.chMhjRubj)}(hhh]h)}(h open callbackh]h open callback}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjmhMhjnubah}(h]h ]h"]h$]h&]uh1jhjRubeh}(h]h ]h"]h$]h&]uh1jhjmhMhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:59: ./fs/open.chMhjubh)}(hHThis can be used to finish opening a file passed to i_op->atomic_open().h]hHThis can be used to finish opening a file passed to i_op->atomic_open().}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:59: ./fs/open.chMhjubh)}(hgIf the open callback is set to NULL, then the standard f_op->open() filesystem callback is substituted.h]hgIf the open callback is set to NULL, then the standard f_op->open() filesystem callback is substituted.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:59: ./fs/open.chMhjubh)}(hNB: the dentry reference is _not_ consumed. If, for example, the dentry is the return value of d_splice_alias(), then the caller needs to perform dput() on it after finish_open().h]hNB: the dentry reference is _not_ consumed. If, for example, the dentry is the return value of d_splice_alias(), then the caller needs to perform dput() on it after finish_open().}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:59: ./fs/open.chMhjubh)}(h5Returns zero on success or -errno if the open failed.h]h5Returns zero on success or -errno if the open failed.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:59: ./fs/open.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j finish_no_open (C function)c.finish_no_openhNtauh1hhjOghhhNhNubj)}(hhh](j)}(h=int finish_no_open (struct file *file, struct dentry *dentry)h]j)}(hah"]h$]h&]uh1j1hjhhhjhM,ubjC)}(hfinish_no_openh]jI)}(hfinish_no_openh]hfinish_no_open}(hj&hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj"ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhM,ubj=)}(h*(struct file *file, struct dentry *dentry)h](jC)}(hstruct file *fileh](j )}(hjh]hstruct}(hjBhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj>ubj2)}(h h]h }(hjOhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj>ubh)}(hhh]jI)}(hfileh]hfile}(hj`hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj]ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjbmodnameN classnameNjj )}j ]j)}jj(sbc.finish_no_openasbuh1hhj>ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj>ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>ubjI)}(hfileh]hfile}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj>ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj:ubjC)}(hstruct dentry *dentryh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j|c.finish_no_openasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hdentryh]hdentry}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj:ubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhM,ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhM,ubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhM,hjhhubjw)}(hhh]h)}(h/finish ->atomic_open() without opening the fileh]h/finish ->atomic_open() without opening the file}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:59: ./fs/open.chM,hj2hhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhM,ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjMjjMjjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``struct file *file`` file pointer ``struct dentry *dentry`` dentry, ERR_PTR(-E...) or NULL (as returned from ->lookup()) **Description** This can be used to set the result of a lookup in ->atomic_open(). NB: unlike finish_open() this function does consume the dentry reference and the caller need not dput() it. Returns 0 or -E..., which must be the return value of ->atomic_open() after having called this function.h](h)}(h**Parameters**h]j)}(hjWh]h Parameters}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjUubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:59: ./fs/open.chM0hjQubj)}(hhh](j)}(h#``struct file *file`` file pointer h](j)}(h``struct file *file``h]j)}(hjvh]hstruct file *file}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjtubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:59: ./fs/open.chM.hjpubj)}(hhh]h)}(h file pointerh]h file pointer}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM.hjubah}(h]h ]h"]h$]h&]uh1jhjpubeh}(h]h ]h"]h$]h&]uh1jhjhM.hjmubj)}(hW``struct dentry *dentry`` dentry, ERR_PTR(-E...) or NULL (as returned from ->lookup()) h](j)}(h``struct dentry *dentry``h]j)}(hjh]hstruct dentry *dentry}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:59: ./fs/open.chM/hjubj)}(hhh]h)}(hlookup())h]hlookup())}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM/hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM/hjmubeh}(h]h ]h"]h$]h&]uh1jhjQubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:59: ./fs/open.chM1hjQubh)}(hBThis can be used to set the result of a lookup in ->atomic_open().h]hBThis can be used to set the result of a lookup in ->atomic_open().}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:59: ./fs/open.chM0hjQubh)}(hkNB: unlike finish_open() this function does consume the dentry reference and the caller need not dput() it.h]hkNB: unlike finish_open() this function does consume the dentry reference and the caller need not dput() it.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:59: ./fs/open.chM2hjQubh)}(hhReturns 0 or -E..., which must be the return value of ->atomic_open() after having called this function.h]hhReturns 0 or -E..., which must be the return value of ->atomic_open() after having called this function.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:59: ./fs/open.chM5hjQubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j kernel_file_open (C function)c.kernel_file_openhNtauh1hhjOghhhNhNubj)}(hhh](j)}(h\struct file * kernel_file_open (const struct path *path, int flags, const struct cred *cred)h]j)}(hZstruct file *kernel_file_open(const struct path *path, int flags, const struct cred *cred)h](j )}(hjh]hstruct}(hjMhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjIhhhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:59: ./fs/open.chMubj2)}(h h]h }(hj[hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjIhhhjZhMubh)}(hhh]jI)}(hfileh]hfile}(hjlhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjiubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjnmodnameN classnameNjj )}j ]j)}jkernel_file_opensbc.kernel_file_openasbuh1hhjIhhhjZhMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjIhhhjZhMubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIhhhjZhMubjC)}(hkernel_file_openh]jI)}(hjh]hkernel_file_open}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjIhhhjZhMubj=)}(h=(const struct path *path, int flags, const struct cred *cred)h](jC)}(hconst struct path *pathh](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hpathh]hpath}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.kernel_file_openasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hpathh]hpath}(hj9hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h int flagsh](j)}(hinth]hint}(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubj2)}(h h]h }(hj`hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjNubjI)}(hflagsh]hflags}(hjnhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjNubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hconst struct cred *credh](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hcredh]hcred}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.kernel_file_openasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hcredh]hcred}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjIhhhjZhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjEhhhjZhMubah}(h]j@ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjZhMhjBhhubjw)}(hhh]h)}(h#open a file for kernel internal useh]h#open a file for kernel internal use}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:59: ./fs/open.chMhj hhubah}(h]h ]h"]h$]h&]uh1jvhjBhhhjZhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjj;jj;jjjuh1jhhhjOghNhNubj)}(hX{**Parameters** ``const struct path *path`` path of the file to open ``int flags`` open flags ``const struct cred *cred`` credentials for open **Description** Open a file for use by in-kernel consumers. The file is not accounted against nr_files and must not be installed into the file descriptor table. **Return** Opened file on success, an error pointer on failure.h](h)}(h**Parameters**h]j)}(hjEh]h Parameters}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjCubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:59: ./fs/open.chMhj?ubj)}(hhh](j)}(h5``const struct path *path`` path of the file to open h](j)}(h``const struct path *path``h]j)}(hjdh]hconst struct path *path}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjbubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:59: ./fs/open.chMhj^ubj)}(hhh]h)}(hpath of the file to openh]hpath of the file to open}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjyhMhjzubah}(h]h ]h"]h$]h&]uh1jhj^ubeh}(h]h ]h"]h$]h&]uh1jhjyhMhj[ubj)}(h``int flags`` open flags h](j)}(h ``int flags``h]j)}(hjh]h int flags}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:59: ./fs/open.chMhjubj)}(hhh]h)}(h open flagsh]h open flags}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhj[ubj)}(h1``const struct cred *cred`` credentials for open h](j)}(h``const struct cred *cred``h]j)}(hjh]hconst struct cred *cred}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:59: ./fs/open.chMhjubj)}(hhh]h)}(hcredentials for openh]hcredentials for open}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhj[ubeh}(h]h ]h"]h$]h&]uh1jhj?ubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:59: ./fs/open.chMhj?ubh)}(hOpen a file for use by in-kernel consumers. The file is not accounted against nr_files and must not be installed into the file descriptor table.h]hOpen a file for use by in-kernel consumers. The file is not accounted against nr_files and must not be installed into the file descriptor table.}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:59: ./fs/open.chMhj?ubh)}(h **Return**h]j)}(hj8h]hReturn}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj6ubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:59: ./fs/open.chMhj?ubh)}(h4Opened file on success, an error pointer on failure.h]h4Opened file on success, an error pointer on failure.}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:59: ./fs/open.chMhj?ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j filp_open (C function) c.filp_openhNtauh1hhjOghhhNhNubj)}(hhh](j)}(hGstruct file * filp_open (const char *filename, int flags, umode_t mode)h]j)}(hEstruct file *filp_open(const char *filename, int flags, umode_t mode)h](j )}(hjh]hstruct}(hj}hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjyhhhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:59: ./fs/open.chM|ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjyhhhjhM|ubh)}(hhh]jI)}(hfileh]hfile}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}j filp_opensb c.filp_openasbuh1hhjyhhhjhM|ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjyhhhjhM|ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyhhhjhM|ubjC)}(h filp_openh]jI)}(hjh]h filp_open}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjyhhhjhM|ubj=)}(h/(const char *filename, int flags, umode_t mode)h](jC)}(hconst char *filenameh](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hcharh]hchar}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hj hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hfilenameh]hfilename}(hj;hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h int flagsh](j)}(hinth]hint}(hjThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjPubj2)}(h h]h }(hjbhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjPubjI)}(hflagsh]hflags}(hjphhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjPubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h umode_t modeh](h)}(hhh]jI)}(humode_th]humode_t}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j c.filp_openasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hmodeh]hmode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjyhhhjhM|ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjuhhhjhM|ubah}(h]jpah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhM|hjrhhubjw)}(hhh]h)}(h!open file and return file pointerh]h!open file and return file pointer}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:59: ./fs/open.chM|hjhhubah}(h]h ]h"]h$]h&]uh1jvhjrhhhjhM|ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjOghNhNubj)}(hXr**Parameters** ``const char *filename`` path to open ``int flags`` open flags as per the open(2) second argument ``umode_t mode`` mode for the new file if O_CREAT is set, else ignored **Description** This is the helper to open a file from kernelspace if you really have to. But in generally you should not do this, so please move along, nothing to see here..h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:59: ./fs/open.chMhjubj)}(hhh](j)}(h&``const char *filename`` path to open h](j)}(h``const char *filename``h]j)}(hj#h]hconst char *filename}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj!ubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:59: ./fs/open.chM~hjubj)}(hhh]h)}(h path to openh]h path to open}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj8hM~hj9ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj8hM~hjubj)}(h<``int flags`` open flags as per the open(2) second argument h](j)}(h ``int flags``h]j)}(hj\h]h int flags}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjZubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:59: ./fs/open.chMhjVubj)}(hhh]h)}(h-open flags as per the open(2) second argumenth]h-open flags as per the open(2) second argument}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjqhMhjrubah}(h]h ]h"]h$]h&]uh1jhjVubeh}(h]h ]h"]h$]h&]uh1jhjqhMhjubj)}(hG``umode_t mode`` mode for the new file if O_CREAT is set, else ignored h](j)}(h``umode_t mode``h]j)}(hjh]h umode_t mode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:59: ./fs/open.chMhjubj)}(hhh]h)}(h5mode for the new file if O_CREAT is set, else ignoredh]h5mode for the new file if O_CREAT is set, else ignored}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:59: ./fs/open.chMhjubh)}(hThis is the helper to open a file from kernelspace if you really have to. But in generally you should not do this, so please move along, nothing to see here..h]hThis is the helper to open a file from kernelspace if you really have to. But in generally you should not do this, so please move along, nothing to see here..}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:59: ./fs/open.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j bio_reset (C function) c.bio_resethNtauh1hhjOghhhNhNubj)}(hhh](j)}(hJvoid bio_reset (struct bio *bio, struct block_device *bdev, blk_opf_t opf)h]j)}(hIvoid bio_reset(struct bio *bio, struct block_device *bdev, blk_opf_t opf)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMubj2)}(h h]h }(hj$hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhj#hMubjC)}(h bio_reseth]jI)}(h bio_reseth]h bio_reset}(hj6hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj2ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhj#hMubj=)}(h;(struct bio *bio, struct block_device *bdev, blk_opf_t opf)h](jC)}(hstruct bio *bioh](j )}(hjh]hstruct}(hjRhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjNubj2)}(h h]h }(hj_hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjNubh)}(hhh]jI)}(hbioh]hbio}(hjphhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjmubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjrmodnameN classnameNjj )}j ]j)}jj8sb c.bio_resetasbuh1hhjNubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjNubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubjI)}(hbioh]hbio}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjNubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjJubjC)}(hstruct block_device *bdevh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(h block_deviceh]h block_device}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j c.bio_resetasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hbdevh]hbdev}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjJubjC)}(h blk_opf_t opfh](h)}(hhh]jI)}(h blk_opf_th]h blk_opf_t}(hj7hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj4ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj9modnameN classnameNjj )}j ]j c.bio_resetasbuh1hhj0ubj2)}(h h]h }(hjUhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj0ubjI)}(hopfh]hopf}(hjchhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj0ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjJubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhj#hMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj hhhj#hMubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj#hMhj hhubjw)}(hhh]h)}(hreinitialize a bioh]hreinitialize a bio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhjhhubah}(h]h ]h"]h$]h&]uh1jvhj hhhj#hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``struct bio *bio`` bio to reset ``struct block_device *bdev`` block device to use the bio for ``blk_opf_t opf`` operation and flags for bio **Description** After calling bio_reset(), **bio** will be in the same state as a freshly allocated bio returned bio bio_alloc_bioset() - the only fields that are preserved are the ones that are initialized by bio_alloc_bioset(). See comment in struct bio.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chM hjubj)}(hhh](j)}(h!``struct bio *bio`` bio to reset h](j)}(h``struct bio *bio``h]j)}(hjh]hstruct bio *bio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhjubj)}(hhh]h)}(h bio to reseth]h bio to reset}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h>``struct block_device *bdev`` block device to use the bio for h](j)}(h``struct block_device *bdev``h]j)}(hjh]hstruct block_device *bdev}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chM hjubj)}(hhh]h)}(hblock device to use the bio forh]hblock device to use the bio for}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hjubj)}(h.``blk_opf_t opf`` operation and flags for bio h](j)}(h``blk_opf_t opf``h]j)}(hj@h]h blk_opf_t opf}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj>ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chM hj:ubj)}(hhh]h)}(hoperation and flags for bioh]hoperation and flags for bio}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjUhM hjVubah}(h]h ]h"]h$]h&]uh1jhj:ubeh}(h]h ]h"]h$]h&]uh1jhjUhM hjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hj{h]h Description}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjyubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chM hjubj)}(hAfter calling bio_reset(), **bio** will be in the same state as a freshly allocated bio returned bio bio_alloc_bioset() - the only fields that are preserved are the ones that are initialized by bio_alloc_bioset(). See comment in struct bio.h]h)}(hAfter calling bio_reset(), **bio** will be in the same state as a freshly allocated bio returned bio bio_alloc_bioset() - the only fields that are preserved are the ones that are initialized by bio_alloc_bioset(). See comment in struct bio.h](hAfter calling bio_reset(), }(hjhhhNhNubj)}(h**bio**h]hbio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh will be in the same state as a freshly allocated bio returned bio bio_alloc_bioset() - the only fields that are preserved are the ones that are initialized by bio_alloc_bioset(). See comment in struct bio.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chM hjubah}(h]h ]h"]h$]h&]uh1jhjhM hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j bio_reuse (C function) c.bio_reusehNtauh1hhjOghhhNhNubj)}(hhh](j)}(h/void bio_reuse (struct bio *bio, blk_opf_t opf)h]j)}(h.void bio_reuse(struct bio *bio, blk_opf_t opf)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chM"ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhM"ubjC)}(h bio_reuseh]jI)}(h bio_reuseh]h bio_reuse}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhM"ubj=)}(h (struct bio *bio, blk_opf_t opf)h](jC)}(hstruct bio *bioh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hj&hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hbioh]hbio}(hj7hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj4ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj9modnameN classnameNjj )}j ]j)}jjsb c.bio_reuseasbuh1hhjubj2)}(h h]h }(hjWhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hbioh]hbio}(hjrhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h blk_opf_t opfh](h)}(hhh]jI)}(h blk_opf_th]h blk_opf_t}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jS c.bio_reuseasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hopfh]hopf}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhM"ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhM"ubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhM"hjhhubjw)}(hhh]h)}(h(reuse a bio with the payload left intacth]h(reuse a bio with the payload left intact}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chM"hjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhM"ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjOghNhNubj)}(hXc**Parameters** ``struct bio *bio`` bio to reuse ``blk_opf_t opf`` operation and flags for the next I/O **Description** Allow reusing an existing bio for another operation with all set up fields including the payload, device and end_io handler left intact. Typically used when **bio** is first used to read data which is then written to another location without modification. **bio** must not be in-flight and owned by the caller. Can't be used for cloned bios. **Note** Can't be used when **bio** has integrity or blk-crypto contexts for now. Feel free to add that support when you need it, though.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chM&hjubj)}(hhh](j)}(h!``struct bio *bio`` bio to reuse h](j)}(h``struct bio *bio``h]j)}(hj%h]hstruct bio *bio}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj#ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chM#hjubj)}(hhh]h)}(h bio to reuseh]h bio to reuse}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj:hM#hj;ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj:hM#hjubj)}(h7``blk_opf_t opf`` operation and flags for the next I/O h](j)}(h``blk_opf_t opf``h]j)}(hj^h]h blk_opf_t opf}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj\ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chM$hjXubj)}(hhh]h)}(h$operation and flags for the next I/Oh]h$operation and flags for the next I/O}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjshM$hjtubah}(h]h ]h"]h$]h&]uh1jhjXubeh}(h]h ]h"]h$]h&]uh1jhjshM$hjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chM&hjubh)}(hAllow reusing an existing bio for another operation with all set up fields including the payload, device and end_io handler left intact.h]hAllow reusing an existing bio for another operation with all set up fields including the payload, device and end_io handler left intact.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chM%hjubh)}(hTypically used when **bio** is first used to read data which is then written to another location without modification. **bio** must not be in-flight and owned by the caller. Can't be used for cloned bios.h](hTypically used when }(hjhhhNhNubj)}(h**bio**h]hbio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh] is first used to read data which is then written to another location without modification. }(hjhhhNhNubj)}(h**bio**h]hbio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhQ must not be in-flight and owned by the caller. Can’t be used for cloned bios.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chM(hjubh)}(h**Note**h]j)}(hjh]hNote}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chM,hjubh)}(hCan't be used when **bio** has integrity or blk-crypto contexts for now. Feel free to add that support when you need it, though.h](hCan’t be used when }(hj hhhNhNubj)}(h**bio**h]hbio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubhf has integrity or blk-crypto contexts for now. Feel free to add that support when you need it, though.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chM-hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j  bio_prepare_reissue (C function)c.bio_prepare_reissuehNtauh1hhjOghhhNhNubj)}(hhh](j)}(hEvoid bio_prepare_reissue (struct bio *bio, struct block_device *bdev)h]j)}(hDvoid bio_prepare_reissue(struct bio *bio, struct block_device *bdev)h](j)}(hvoidh]hvoid}(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFhhhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMDubj2)}(h h]h }(hjYhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjFhhhjXhMDubjC)}(hbio_prepare_reissueh]jI)}(hbio_prepare_reissueh]hbio_prepare_reissue}(hjkhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjgubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjFhhhjXhMDubj=)}(h,(struct bio *bio, struct block_device *bdev)h](jC)}(hstruct bio *bioh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hbioh]hbio}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jjmsbc.bio_prepare_reissueasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hbioh]hbio}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct block_device *bdevh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(h block_deviceh]h block_device}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.bio_prepare_reissueasbuh1hhjubj2)}(h h]h }(hj5hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hbdevh]hbdev}(hjPhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjFhhhjXhMDubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjBhhhjXhMDubah}(h]j=ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjXhMDhj?hhubjw)}(hhh]h)}(h,prepare a bio for reuissing the original I/Oh]h,prepare a bio for reuissing the original I/O}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMDhjwhhubah}(h]h ]h"]h$]h&]uh1jvhj?hhhjXhMDubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``struct bio *bio`` bio to reuse ``struct block_device *bdev`` block device to use the bio for **Description** Prepare **bio** to be resubmitted to retry the original operation. The caller must reset bio->bi_iter to the original state.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMHhjubj)}(hhh](j)}(h!``struct bio *bio`` bio to reuse h](j)}(h``struct bio *bio``h]j)}(hjh]hstruct bio *bio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMEhjubj)}(hhh]h)}(h bio to reuseh]h bio to reuse}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMEhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMEhjubj)}(h>``struct block_device *bdev`` block device to use the bio for h](j)}(h``struct block_device *bdev``h]j)}(hjh]hstruct block_device *bdev}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMFhjubj)}(hhh]h)}(hblock device to use the bio forh]hblock device to use the bio for}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMFhj ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj hMFhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hj/h]h Description}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj-ubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMHhjubh)}(h|Prepare **bio** to be resubmitted to retry the original operation. The caller must reset bio->bi_iter to the original state.h](hPrepare }(hjEhhhNhNubj)}(h**bio**h]hbio}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjEubhm to be resubmitted to retry the original operation. The caller must reset bio->bi_iter to the original state.}(hjEhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMGhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j bio_chain (C function) c.bio_chainhNtauh1hhjOghhhNhNubj)}(hhh](j)}(h4void bio_chain (struct bio *bio, struct bio *parent)h]j)}(h3void bio_chain(struct bio *bio, struct bio *parent)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMkubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMkubjC)}(h bio_chainh]jI)}(h bio_chainh]h bio_chain}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhMkubj=)}(h%(struct bio *bio, struct bio *parent)h](jC)}(hstruct bio *bioh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hbioh]hbio}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jjsb c.bio_chainasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hbioh]hbio}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct bio *parenth](j )}(hjh]hstruct}(hj5hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj1ubj2)}(h h]h }(hjBhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj1ubh)}(hhh]jI)}(hbioh]hbio}(hjShhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjPubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjUmodnameN classnameNjj )}j ]j c.bio_chainasbuh1hhj1ubj2)}(h h]h }(hjqhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj1ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj1ubjI)}(hparenth]hparent}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj1ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhMkubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj~hhhjhMkubah}(h]jyah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMkhj{hhubjw)}(hhh]h)}(hchain bio completionsh]hchain bio completions}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMkhjhhubah}(h]h ]h"]h$]h&]uh1jvhj{hhhjhMkubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``struct bio *bio`` the target bio ``struct bio *parent`` the parent bio of **bio** **Description** The caller won't have a bi_end_io called when **bio** completes - instead, **parent**'s bi_end_io won't be called until both **parent** and **bio** have completed; the chained bio will also be freed when it completes. The caller must not set bi_private or bi_end_io in **bio**.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMohjubj)}(hhh](j)}(h#``struct bio *bio`` the target bio h](j)}(h``struct bio *bio``h]j)}(hjh]hstruct bio *bio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMlhjubj)}(hhh]h)}(hthe target bioh]hthe target bio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMlhj ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj hMlhjubj)}(h1``struct bio *parent`` the parent bio of **bio** h](j)}(h``struct bio *parent``h]j)}(hj0h]hstruct bio *parent}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj.ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMmhj*ubj)}(hhh]h)}(hthe parent bio of **bio**h](hthe parent bio of }(hjIhhhNhNubj)}(h**bio**h]hbio}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjIubeh}(h]h ]h"]h$]h&]uh1hhjEhMmhjFubah}(h]h ]h"]h$]h&]uh1jhj*ubeh}(h]h ]h"]h$]h&]uh1jhjEhMmhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjyh]h Description}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjwubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMohjubh)}(hThe caller won't have a bi_end_io called when **bio** completes - instead, **parent**'s bi_end_io won't be called until both **parent** and **bio** have completed; the chained bio will also be freed when it completes.h](h0The caller won’t have a bi_end_io called when }(hjhhhNhNubj)}(h**bio**h]hbio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh completes - instead, }(hjhhhNhNubj)}(h **parent**h]hparent}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh,’s bi_end_io won’t be called until both }(hjhhhNhNubj)}(h **parent**h]hparent}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh and }(hjhhhNhNubj)}(h**bio**h]hbio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhF have completed; the chained bio will also be freed when it completes.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMnhjubh)}(h;The caller must not set bi_private or bi_end_io in **bio**.h](h3The caller must not set bi_private or bi_end_io in }(hjhhhNhNubj)}(h**bio**h]hbio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMrhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j bio_alloc_bioset (C function)c.bio_alloc_biosethNtauh1hhjOghhhNhNubj)}(hhh](j)}(hstruct bio * bio_alloc_bioset (struct block_device *bdev, unsigned short nr_vecs, blk_opf_t opf, gfp_t gfp, struct bio_set *bs)h]j)}(h}struct bio *bio_alloc_bioset(struct block_device *bdev, unsigned short nr_vecs, blk_opf_t opf, gfp_t gfp, struct bio_set *bs)h](j )}(hjh]hstruct}(hj'hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj#hhhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chM ubj2)}(h h]h }(hj5hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj#hhhj4hM ubh)}(hhh]jI)}(hbioh]hbio}(hjFhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjCubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjHmodnameN classnameNjj )}j ]j)}jbio_alloc_biosetsbc.bio_alloc_biosetasbuh1hhj#hhhj4hM ubj2)}(h h]h }(hjghhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj#hhhj4hM ubj)}(hjh]h*}(hjuhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#hhhj4hM ubjC)}(hbio_alloc_bioseth]jI)}(hjdh]hbio_alloc_bioset}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj#hhhj4hM ubj=)}(ha(struct block_device *bdev, unsigned short nr_vecs, blk_opf_t opf, gfp_t gfp, struct bio_set *bs)h](jC)}(hstruct block_device *bdevh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(h block_deviceh]h block_device}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jbc.bio_alloc_biosetasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hbdevh]hbdev}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hunsigned short nr_vecsh](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj ubj)}(hshorth]hshort}(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj2)}(h h]h }(hj;hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj ubjI)}(hnr_vecsh]hnr_vecs}(hjIhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h blk_opf_t opfh](h)}(hhh]jI)}(h blk_opf_th]h blk_opf_t}(hjehhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjbubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjgmodnameN classnameNjj )}j ]jbc.bio_alloc_biosetasbuh1hhj^ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj^ubjI)}(hopfh]hopf}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj^ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h gfp_t gfph](h)}(hhh]jI)}(hgfp_th]hgfp_t}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jbc.bio_alloc_biosetasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hgfph]hgfp}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct bio_set *bsh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hbio_seth]hbio_set}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jbc.bio_alloc_biosetasbuh1hhjubj2)}(h h]h }(hj.hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj<hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hbsh]hbs}(hjIhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hj#hhhj4hM ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhj4hM ubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj4hM hjhhubjw)}(hhh]h)}(hallocate a bio for I/Oh]hallocate a bio for I/O}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chM hjphhubah}(h]h ]h"]h$]h&]uh1jvhjhhhj4hM ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjOghNhNubj)}(hX **Parameters** ``struct block_device *bdev`` block device to allocate the bio for (can be ``NULL``) ``unsigned short nr_vecs`` number of bvecs to pre-allocate ``blk_opf_t opf`` operation and flags for bio ``gfp_t gfp`` the GFP_* mask given to the slab allocator ``struct bio_set *bs`` the bio_set to allocate from. **Description** Allocate a bio from the mempools in **bs**. If ``__GFP_DIRECT_RECLAIM`` is set then bio_alloc will always be able to allocate a bio. This is due to the mempool guarantees. To make this work, callers must never allocate more than 1 bio at a time from the general pool. Callers that need to allocate more than 1 bio must always submit the previously allocated bio for IO before attempting to allocate a new one. Failure to do so can cause deadlocks under memory pressure. Note that when running under submit_bio_noacct() (i.e. any block driver), bios are not submitted until after you return - see the code in submit_bio_noacct() that converts recursion into iteration, to prevent stack overflows. This would normally mean allocating multiple bios under submit_bio_noacct() would be susceptible to deadlocks, but we have deadlock avoidance code that resubmits any blocked bios from a rescuer thread. However, we do not guarantee forward progress for allocations from other mempools. Doing multiple allocations from the same mempool under submit_bio_noacct() should be avoided - instead, use bio_set's front_pad for per bio allocations. **Return** Pointer to new bio on success, NULL on failure.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhjubj)}(hhh](j)}(hU``struct block_device *bdev`` block device to allocate the bio for (can be ``NULL``) h](j)}(h``struct block_device *bdev``h]j)}(hjh]hstruct block_device *bdev}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chM hjubj)}(hhh]h)}(h6block device to allocate the bio for (can be ``NULL``)h](h-block device to allocate the bio for (can be }(hjhhhNhNubj)}(h``NULL``h]hNULL}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh)}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hjubj)}(h;``unsigned short nr_vecs`` number of bvecs to pre-allocate h](j)}(h``unsigned short nr_vecs``h]j)}(hjh]hunsigned short nr_vecs}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chM hjubj)}(hhh]h)}(hnumber of bvecs to pre-allocateh]hnumber of bvecs to pre-allocate}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hM hj ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj hM hjubj)}(h.``blk_opf_t opf`` operation and flags for bio h](j)}(h``blk_opf_t opf``h]j)}(hj8 h]h blk_opf_t opf}(hj: hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj6 ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chM hj2 ubj)}(hhh]h)}(hoperation and flags for bioh]hoperation and flags for bio}(hjQ hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjM hM hjN ubah}(h]h ]h"]h$]h&]uh1jhj2 ubeh}(h]h ]h"]h$]h&]uh1jhjM hM hjubj)}(h9``gfp_t gfp`` the GFP_* mask given to the slab allocator h](j)}(h ``gfp_t gfp``h]j)}(hjq h]h gfp_t gfp}(hjs hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjo ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhjk ubj)}(hhh]h)}(h*the GFP_* mask given to the slab allocatorh]h*the GFP_* mask given to the slab allocator}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMhj ubah}(h]h ]h"]h$]h&]uh1jhjk ubeh}(h]h ]h"]h$]h&]uh1jhj hMhjubj)}(h5``struct bio_set *bs`` the bio_set to allocate from. h](j)}(h``struct bio_set *bs``h]j)}(hj h]hstruct bio_set *bs}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhj ubj)}(hhh]h)}(hthe bio_set to allocate from.h]hthe bio_set to allocate from.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hMhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hj h]h Description}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhjubh)}(h+Allocate a bio from the mempools in **bs**.h](h$Allocate a bio from the mempools in }(hj hhhNhNubj)}(h**bs**h]hbs}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubh.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhjubh)}(hXIf ``__GFP_DIRECT_RECLAIM`` is set then bio_alloc will always be able to allocate a bio. This is due to the mempool guarantees. To make this work, callers must never allocate more than 1 bio at a time from the general pool. Callers that need to allocate more than 1 bio must always submit the previously allocated bio for IO before attempting to allocate a new one. Failure to do so can cause deadlocks under memory pressure.h](hIf }(hj hhhNhNubj)}(h``__GFP_DIRECT_RECLAIM``h]h__GFP_DIRECT_RECLAIM}(hj$ hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubhX is set then bio_alloc will always be able to allocate a bio. This is due to the mempool guarantees. To make this work, callers must never allocate more than 1 bio at a time from the general pool. Callers that need to allocate more than 1 bio must always submit the previously allocated bio for IO before attempting to allocate a new one. Failure to do so can cause deadlocks under memory pressure.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhjubh)}(hNote that when running under submit_bio_noacct() (i.e. any block driver), bios are not submitted until after you return - see the code in submit_bio_noacct() that converts recursion into iteration, to prevent stack overflows.h]hNote that when running under submit_bio_noacct() (i.e. any block driver), bios are not submitted until after you return - see the code in submit_bio_noacct() that converts recursion into iteration, to prevent stack overflows.}(hj= hhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhjubh)}(hThis would normally mean allocating multiple bios under submit_bio_noacct() would be susceptible to deadlocks, but we have deadlock avoidance code that resubmits any blocked bios from a rescuer thread.h]hThis would normally mean allocating multiple bios under submit_bio_noacct() would be susceptible to deadlocks, but we have deadlock avoidance code that resubmits any blocked bios from a rescuer thread.}(hjL hhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhjubh)}(hHowever, we do not guarantee forward progress for allocations from other mempools. Doing multiple allocations from the same mempool under submit_bio_noacct() should be avoided - instead, use bio_set's front_pad for per bio allocations.h]hHowever, we do not guarantee forward progress for allocations from other mempools. Doing multiple allocations from the same mempool under submit_bio_noacct() should be avoided - instead, use bio_set’s front_pad for per bio allocations.}(hj[ hhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chM#hjubh)}(h **Return**h]j)}(hjl h]hReturn}(hjn hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjj ubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chM(hjubh)}(h/Pointer to new bio on success, NULL on failure.h]h/Pointer to new bio on success, NULL on failure.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chM)hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j bio_kmalloc (C function) c.bio_kmallochNtauh1hhjOghhhNhNubj)}(hhh](j)}(hAstruct bio * bio_kmalloc (unsigned short nr_vecs, gfp_t gfp_mask)h]j)}(h?struct bio *bio_kmalloc(unsigned short nr_vecs, gfp_t gfp_mask)h](j )}(hjh]hstruct}(hj hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj hhhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMubj2)}(h h]h }(hj hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj hhhj hMubh)}(hhh]jI)}(hbioh]hbio}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj modnameN classnameNjj )}j ]j)}j bio_kmallocsb c.bio_kmallocasbuh1hhj hhhj hMubj2)}(h h]h }(hj hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj hhhj hMubj)}(hjh]h*}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhj hMubjC)}(h bio_kmalloch]jI)}(hj h]h bio_kmalloc}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj hhhj hMubj=)}(h((unsigned short nr_vecs, gfp_t gfp_mask)h](jC)}(hunsigned short nr_vecsh](j)}(hunsignedh]hunsigned}(hj+ hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj' ubj2)}(h h]h }(hj9 hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj' ubj)}(hshorth]hshort}(hjG hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj' ubj2)}(h h]h }(hjU hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj' ubjI)}(hnr_vecsh]hnr_vecs}(hjc hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj' ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj# ubjC)}(hgfp_t gfp_maskh](h)}(hhh]jI)}(hgfp_th]hgfp_t}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj| ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj modnameN classnameNjj )}j ]j  c.bio_kmallocasbuh1hhjx ubj2)}(h h]h }(hj hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjx ubjI)}(hgfp_maskh]hgfp_mask}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjx ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj# ubeh}(h]h ]h"]h$]h&]j`jauh1j<hj hhhj hMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj hhhj hMubah}(h]j ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj hMhj hhubjw)}(hhh]h)}(h kmalloc a bioh]h kmalloc a bio}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhj hhubah}(h]h ]h"]h$]h&]uh1jvhj hhhj hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjj jj jjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``unsigned short nr_vecs`` number of bio_vecs to allocate ``gfp_t gfp_mask`` the GFP_* mask given to the slab allocator **Description** Use kmalloc to allocate a bio (including bvecs). The bio must be initialized using bio_init() before use. To free a bio returned from this function use kfree() after calling bio_uninit(). A bio returned from this function can be reused by calling bio_uninit() before calling bio_init() again. Note that unlike bio_alloc() or bio_alloc_bioset() allocations from this function are not backed by a mempool can fail. Do not use this function for allocations in the file system I/O path. **Return** Pointer to new bio on success, NULL on failure.h](h)}(h**Parameters**h]j)}(hj h]h Parameters}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhj ubj)}(hhh](j)}(h:``unsigned short nr_vecs`` number of bio_vecs to allocate h](j)}(h``unsigned short nr_vecs``h]j)}(hj h]hunsigned short nr_vecs}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhj ubj)}(hhh]h)}(hnumber of bio_vecs to allocateh]hnumber of bio_vecs to allocate}(hj/ hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj+ hMhj, ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj+ hMhj ubj)}(h>``gfp_t gfp_mask`` the GFP_* mask given to the slab allocator h](j)}(h``gfp_t gfp_mask``h]j)}(hjO h]hgfp_t gfp_mask}(hjQ hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjM ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhjI ubj)}(hhh]h)}(h*the GFP_* mask given to the slab allocatorh]h*the GFP_* mask given to the slab allocator}(hjh hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjd hMhje ubah}(h]h ]h"]h$]h&]uh1jhjI ubeh}(h]h ]h"]h$]h&]uh1jhjd hMhj ubeh}(h]h ]h"]h$]h&]uh1jhj ubh)}(h**Description**h]j)}(hj h]h Description}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhj ubh)}(hX'Use kmalloc to allocate a bio (including bvecs). The bio must be initialized using bio_init() before use. To free a bio returned from this function use kfree() after calling bio_uninit(). A bio returned from this function can be reused by calling bio_uninit() before calling bio_init() again.h]hX'Use kmalloc to allocate a bio (including bvecs). The bio must be initialized using bio_init() before use. To free a bio returned from this function use kfree() after calling bio_uninit(). A bio returned from this function can be reused by calling bio_uninit() before calling bio_init() again.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhj ubh)}(hNote that unlike bio_alloc() or bio_alloc_bioset() allocations from this function are not backed by a mempool can fail. Do not use this function for allocations in the file system I/O path.h]hNote that unlike bio_alloc() or bio_alloc_bioset() allocations from this function are not backed by a mempool can fail. Do not use this function for allocations in the file system I/O path.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhj ubh)}(h **Return**h]j)}(hj h]hReturn}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhj ubh)}(h/Pointer to new bio on success, NULL on failure.h]h/Pointer to new bio on success, NULL on failure.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhj ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j bio_put (C function) c.bio_puthNtauh1hhjOghhhNhNubj)}(hhh](j)}(hvoid bio_put (struct bio *bio)h]j)}(hvoid bio_put(struct bio *bio)h](j)}(hvoidh]hvoid}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMWubj2)}(h h]h }(hj hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj hhhj hMWubjC)}(hbio_puth]jI)}(hbio_puth]hbio_put}(hj& hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj" ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj hhhj hMWubj=)}(h(struct bio *bio)h]jC)}(hstruct bio *bioh](j )}(hjh]hstruct}(hjB hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj> ubj2)}(h h]h }(hjO hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj> ubh)}(hhh]jI)}(hbioh]hbio}(hj` hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj] ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjb modnameN classnameNjj )}j ]j)}jj( sb c.bio_putasbuh1hhj> ubj2)}(h h]h }(hj hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj> ubj)}(hjh]h*}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj> ubjI)}(hbioh]hbio}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj> ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj: ubah}(h]h ]h"]h$]h&]j`jauh1j<hj hhhj hMWubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj hhhj hMWubah}(h]j ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj hMWhj hhubjw)}(hhh]h)}(hrelease a reference to a bioh]hrelease a reference to a bio}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMWhj hhubah}(h]h ]h"]h$]h&]uh1jvhj hhhj hMWubeh}(h]h ](jfunctioneh"]h$]h&]jjjj jj jjjuh1jhhhjOghNhNubj)}(h**Parameters** ``struct bio *bio`` bio to release reference to **Description** Put a reference to a :c:type:`struct bio `, either one you have gotten with bio_alloc, bio_get or bio_clone_*. The last put of a bio will free it.h](h)}(h**Parameters**h]j)}(hj h]h Parameters}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chM[hj ubj)}(hhh]j)}(h0``struct bio *bio`` bio to release reference to h](j)}(h``struct bio *bio``h]j)}(hjh]hstruct bio *bio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMXhjubj)}(hhh]h)}(hbio to release reference toh]hbio to release reference to}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMXhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMXhj ubah}(h]h ]h"]h$]h&]uh1jhj ubh)}(h**Description**h]j)}(hjAh]h Description}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1jhj?ubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMZhj ubj)}(hPut a reference to a :c:type:`struct bio `, either one you have gotten with bio_alloc, bio_get or bio_clone_*. The last put of a bio will free it.h]h)}(hPut a reference to a :c:type:`struct bio `, either one you have gotten with bio_alloc, bio_get or bio_clone_*. The last put of a bio will free it.h](hPut a reference to a }(hj[hhhNhNubh)}(h:c:type:`struct bio `h]j)}(hjeh]h struct bio}(hjghhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjcubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnjjjbiouh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMZhj[ubhh, either one you have gotten with bio_alloc, bio_get or bio_clone_*. The last put of a bio will free it.}(hj[hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhMZhjWubah}(h]h ]h"]h$]h&]uh1jhjhMZhj ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j bio_alloc_clone (C function)c.bio_alloc_clonehNtauh1hhjOghhhNhNubj)}(hhh](j)}(hlstruct bio * bio_alloc_clone (struct block_device *bdev, struct bio *bio_src, gfp_t gfp, struct bio_set *bs)h]j)}(hjstruct bio *bio_alloc_clone(struct block_device *bdev, struct bio *bio_src, gfp_t gfp, struct bio_set *bs)h](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjhhhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMubh)}(hhh]jI)}(hbioh]hbio}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jbio_alloc_clonesbc.bio_alloc_cloneasbuh1hhjhhhjhMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubjC)}(hbio_alloc_cloneh]jI)}(hjh]hbio_alloc_clone}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhMubj=)}(hO(struct block_device *bdev, struct bio *bio_src, gfp_t gfp, struct bio_set *bs)h](jC)}(hstruct block_device *bdevh](j )}(hjh]hstruct}(hj-hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj)ubj2)}(h h]h }(hj:hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj)ubh)}(hhh]jI)}(h block_deviceh]h block_device}(hjKhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjHubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjMmodnameN classnameNjj )}j ]jc.bio_alloc_cloneasbuh1hhj)ubj2)}(h h]h }(hjihhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj)ubj)}(hjh]h*}(hjwhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubjI)}(hbdevh]hbdev}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj)ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj%ubjC)}(hstruct bio *bio_srch](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hbioh]hbio}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.bio_alloc_cloneasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hbio_srch]hbio_src}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj%ubjC)}(h gfp_t gfph](h)}(hhh]jI)}(hgfp_th]hgfp_t}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.bio_alloc_cloneasbuh1hhj ubj2)}(h h]h }(hj.hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj ubjI)}(hgfph]hgfp}(hj<hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj%ubjC)}(hstruct bio_set *bsh](j )}(hjh]hstruct}(hjUhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjQubj2)}(h h]h }(hjbhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjQubh)}(hhh]jI)}(hbio_seth]hbio_set}(hjshhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjpubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjumodnameN classnameNjj )}j ]jc.bio_alloc_cloneasbuh1hhjQubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjQubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjQubjI)}(hbsh]hbs}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjQubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj%ubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhMubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMhjhhubjw)}(hhh]h)}(h1clone a bio that shares the original bio's biovech]h3clone a bio that shares the original bio’s biovec}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjOghNhNubj)}(hX&**Parameters** ``struct block_device *bdev`` block_device to clone onto ``struct bio *bio_src`` bio to clone from ``gfp_t gfp`` allocation priority ``struct bio_set *bs`` bio_set to allocate from **Description** Allocate a new bio that is a clone of **bio_src**. This reuses the bio_vecs pointed to by **bio_src->bi_io_vec**, and clones the iterator pointing to the current position in it. The caller owns the returned bio, but not the bio_vecs, and must ensure the bio is freed before the memory pointed to by **bio_Src->bi_io_vecs**.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhjubj)}(hhh](j)}(h9``struct block_device *bdev`` block_device to clone onto h](j)}(h``struct block_device *bdev``h]j)}(hjh]hstruct block_device *bdev}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhjubj)}(hhh]h)}(hblock_device to clone ontoh]hblock_device to clone onto}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj,hMhj-ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj,hMhjubj)}(h*``struct bio *bio_src`` bio to clone from h](j)}(h``struct bio *bio_src``h]j)}(hjPh]hstruct bio *bio_src}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjNubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhjJubj)}(hhh]h)}(hbio to clone fromh]hbio to clone from}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1hhjehMhjfubah}(h]h ]h"]h$]h&]uh1jhjJubeh}(h]h ]h"]h$]h&]uh1jhjehMhjubj)}(h"``gfp_t gfp`` allocation priority h](j)}(h ``gfp_t gfp``h]j)}(hjh]h gfp_t gfp}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhjubj)}(hhh]h)}(hallocation priorityh]hallocation priority}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h0``struct bio_set *bs`` bio_set to allocate from h](j)}(h``struct bio_set *bs``h]j)}(hjh]hstruct bio_set *bs}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhjubj)}(hhh]h)}(hbio_set to allocate fromh]hbio_set to allocate from}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhjubh)}(hXDAllocate a new bio that is a clone of **bio_src**. This reuses the bio_vecs pointed to by **bio_src->bi_io_vec**, and clones the iterator pointing to the current position in it. The caller owns the returned bio, but not the bio_vecs, and must ensure the bio is freed before the memory pointed to by **bio_Src->bi_io_vecs**.h](h&Allocate a new bio that is a clone of }(hjhhhNhNubj)}(h **bio_src**h]hbio_src}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh). This reuses the bio_vecs pointed to by }(hjhhhNhNubj)}(h**bio_src->bi_io_vec**h]hbio_src->bi_io_vec}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh, and clones the iterator pointing to the current position in it. The caller owns the returned bio, but not the bio_vecs, and must ensure the bio is freed before the memory pointed to by }(hjhhhNhNubj)}(h**bio_Src->bi_io_vecs**h]hbio_Src->bi_io_vecs}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j bio_init_clone (C function)c.bio_init_clonehNtauh1hhjOghhhNhNubj)}(hhh](j)}(h_int bio_init_clone (struct block_device *bdev, struct bio *bio, struct bio *bio_src, gfp_t gfp)h]j)}(h^int bio_init_clone(struct block_device *bdev, struct bio *bio, struct bio *bio_src, gfp_t gfp)h](j)}(hinth]hint}(hjxhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjthhhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjthhhjhMubjC)}(hbio_init_cloneh]jI)}(hbio_init_cloneh]hbio_init_clone}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjthhhjhMubj=)}(hL(struct block_device *bdev, struct bio *bio, struct bio *bio_src, gfp_t gfp)h](jC)}(hstruct block_device *bdevh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(h block_deviceh]h block_device}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jjsbc.bio_init_cloneasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hbdevh]hbdev}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct bio *bioh](j )}(hjh]hstruct}(hj'hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj#ubj2)}(h h]h }(hj4hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj#ubh)}(hhh]jI)}(hbioh]hbio}(hjEhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjBubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjGmodnameN classnameNjj )}j ]jc.bio_init_cloneasbuh1hhj#ubj2)}(h h]h }(hjchhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj#ubj)}(hjh]h*}(hjqhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#ubjI)}(hbioh]hbio}(hj~hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj#ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct bio *bio_srch](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hbioh]hbio}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.bio_init_cloneasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hbio_srch]hbio_src}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h gfp_t gfph](h)}(hhh]jI)}(hgfp_th]hgfp_t}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj modnameN classnameNjj )}j ]jc.bio_init_cloneasbuh1hhjubj2)}(h h]h }(hj(hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hgfph]hgfp}(hj6hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjthhhjhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjphhhjhMubah}(h]jkah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMhjmhhubjw)}(hhh]h)}(h1clone a bio that shares the original bio's biovech]h3clone a bio that shares the original bio’s biovec}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhj]hhubah}(h]h ]h"]h$]h&]uh1jvhjmhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjxjjxjjjuh1jhhhjOghNhNubj)}(hXq**Parameters** ``struct block_device *bdev`` block_device to clone onto ``struct bio *bio`` bio to clone into ``struct bio *bio_src`` bio to clone from ``gfp_t gfp`` allocation priority **Description** Initialize a new bio in caller provided memory that is a clone of **bio_src**. The same bio_vecs reuse and bio lifetime rules as bio_alloc_clone() apply.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhj|ubj)}(hhh](j)}(h9``struct block_device *bdev`` block_device to clone onto h](j)}(h``struct block_device *bdev``h]j)}(hjh]hstruct block_device *bdev}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhjubj)}(hhh]h)}(hblock_device to clone ontoh]hblock_device to clone onto}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h&``struct bio *bio`` bio to clone into h](j)}(h``struct bio *bio``h]j)}(hjh]hstruct bio *bio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhjubj)}(hhh]h)}(hbio to clone intoh]hbio to clone into}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h*``struct bio *bio_src`` bio to clone from h](j)}(h``struct bio *bio_src``h]j)}(hjh]hstruct bio *bio_src}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhj ubj)}(hhh]h)}(hbio to clone fromh]hbio to clone from}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj(hMhj)ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj(hMhjubj)}(h"``gfp_t gfp`` allocation priority h](j)}(h ``gfp_t gfp``h]j)}(hjLh]h gfp_t gfp}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjJubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhjFubj)}(hhh]h)}(hallocation priorityh]hallocation priority}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1hhjahMhjbubah}(h]h ]h"]h$]h&]uh1jhjFubeh}(h]h ]h"]h$]h&]uh1jhjahMhjubeh}(h ]h ]h"]h$]h&]uh1jhj|ubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhj|ubh)}(hInitialize a new bio in caller provided memory that is a clone of **bio_src**. The same bio_vecs reuse and bio lifetime rules as bio_alloc_clone() apply.h](hBInitialize a new bio in caller provided memory that is a clone of }(hjhhhNhNubj)}(h **bio_src**h]hbio_src}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhL. The same bio_vecs reuse and bio lifetime rules as bio_alloc_clone() apply.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhj|ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j __bio_add_page (C function)c.__bio_add_pagehNtauh1hhjOghhhNhNubj)}(hhh](j)}(h\void __bio_add_page (struct bio *bio, struct page *page, unsigned int len, unsigned int off)h]j)}(h[void __bio_add_page(struct bio *bio, struct page *page, unsigned int len, unsigned int off)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMubjC)}(h__bio_add_pageh]jI)}(h__bio_add_pageh]h__bio_add_page}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhMubj=)}(hH(struct bio *bio, struct page *page, unsigned int len, unsigned int off)h](jC)}(hstruct bio *bioh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hj(hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hbioh]hbio}(hj9hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj6ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj;modnameN classnameNjj )}j ]j)}jjsbc.__bio_add_pageasbuh1hhjubj2)}(h h]h }(hjYhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hbioh]hbio}(hjthhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct page *pageh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hpageh]hpage}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jUc.__bio_add_pageasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hpageh]hpage}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hunsigned int lenh](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hj hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hj'hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hlenh]hlen}(hj5hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hunsigned int offh](j)}(hunsignedh]hunsigned}(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJubj2)}(h h]h }(hj\hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjJubj)}(hinth]hint}(hjjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJubj2)}(h h]h }(hjxhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjJubjI)}(hoffh]hoff}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjJubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhMubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMhjhhubjw)}(hhh]h)}(h%add page(s) to a bio in a new segmenth]h%add page(s) to a bio in a new segment}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``struct bio *bio`` destination bio ``struct page *page`` start page to add ``unsigned int len`` length of the data to add, may cross pages ``unsigned int off`` offset of the data relative to **page**, may cross pages **Description** Add the data at **page** + **off** to **bio** as a new bvec. The caller must ensure that **bio** has space for another bvec.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhjubj)}(hhh](j)}(h$``struct bio *bio`` destination bio h](j)}(h``struct bio *bio``h]j)}(hjh]hstruct bio *bio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhjubj)}(hhh]h)}(hdestination bioh]hdestination bio}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h(``struct page *page`` start page to add h](j)}(h``struct page *page``h]j)}(hj*h]hstruct page *page}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj(ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhj$ubj)}(hhh]h)}(hstart page to addh]hstart page to add}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1hhj?hMhj@ubah}(h]h ]h"]h$]h&]uh1jhj$ubeh}(h]h ]h"]h$]h&]uh1jhj?hMhjubj)}(h@``unsigned int len`` length of the data to add, may cross pages h](j)}(h``unsigned int len``h]j)}(hjch]hunsigned int len}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1jhjaubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhj]ubj)}(hhh]h)}(h*length of the data to add, may cross pagesh]h*length of the data to add, may cross pages}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjxhMhjyubah}(h]h ]h"]h$]h&]uh1jhj]ubeh}(h]h ]h"]h$]h&]uh1jhjxhMhjubj)}(hN``unsigned int off`` offset of the data relative to **page**, may cross pages h](j)}(h``unsigned int off``h]j)}(hjh]hunsigned int off}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhjubj)}(hhh]h)}(h8offset of the data relative to **page**, may cross pagesh](hoffset of the data relative to }(hjhhhNhNubj)}(h**page**h]hpage}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh, may cross pages}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhjubh)}(h}Add the data at **page** + **off** to **bio** as a new bvec. The caller must ensure that **bio** has space for another bvec.h](hAdd the data at }(hjhhhNhNubj)}(h**page**h]hpage}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh + }(hjhhhNhNubj)}(h**off**h]hoff}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh to }(hjhhhNhNubj)}(h**bio**h]hbio}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh- as a new bvec. The caller must ensure that }(hjhhhNhNubj)}(h**bio**h]hbio}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh has space for another bvec.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j  bio_add_virt_nofail (C function)c.bio_add_virt_nofailhNtauh1hhjOghhhNhNubj)}(hhh](j)}(hEvoid bio_add_virt_nofail (struct bio *bio, void *vaddr, unsigned len)h]j)}(hDvoid bio_add_virt_nofail(struct bio *bio, void *vaddr, unsigned len)h](j)}(hvoidh]hvoid}(hjvhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjrhhhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjrhhhjhMubjC)}(hbio_add_virt_nofailh]jI)}(hbio_add_virt_nofailh]hbio_add_virt_nofail}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjrhhhjhMubj=)}(h,(struct bio *bio, void *vaddr, unsigned len)h](jC)}(hstruct bio *bioh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hbioh]hbio}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jjsbc.bio_add_virt_nofailasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hbioh]hbio}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h void *vaddrh](j)}(hvoidh]hvoid}(hj%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubj2)}(h h]h }(hj3hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj!ubj)}(hjh]h*}(hjAhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubjI)}(hvaddrh]hvaddr}(hjNhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj!ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h unsigned lenh](j)}(hunsignedh]hunsigned}(hjghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjcubj2)}(h h]h }(hjuhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjcubjI)}(hlenh]hlen}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjcubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjrhhhjhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjnhhhjhMubah}(h]jiah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMhjkhhubjw)}(hhh]h)}(h.add data in the direct kernel mapping to a bioh]h.add data in the direct kernel mapping to a bio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhjhhubah}(h]h ]h"]h$]h&]uh1jvhjkhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjOghNhNubj)}(hXK**Parameters** ``struct bio *bio`` destination bio ``void *vaddr`` data to add ``unsigned len`` length of the data to add, may cross pages **Description** Add the data at **vaddr** to **bio**. The caller must have ensure a segment is available for the added data. No merging into an existing segment will be performed.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhjubj)}(hhh](j)}(h$``struct bio *bio`` destination bio h](j)}(h``struct bio *bio``h]j)}(hjh]hstruct bio *bio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhjubj)}(hhh]h)}(hdestination bioh]hdestination bio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h``void *vaddr`` data to add h](j)}(h``void *vaddr``h]j)}(hj'h]h void *vaddr}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj%ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhj!ubj)}(hhh]h)}(h data to addh]h data to add}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj<hMhj=ubah}(h]h ]h"]h$]h&]uh1jhj!ubeh}(h]h ]h"]h$]h&]uh1jhj<hMhjubj)}(h<``unsigned len`` length of the data to add, may cross pages h](j)}(h``unsigned len``h]j)}(hj`h]h unsigned len}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj^ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhjZubj)}(hhh]h)}(h*length of the data to add, may cross pagesh]h*length of the data to add, may cross pages}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjuhMhjvubah}(h]h ]h"]h$]h&]uh1jhjZubeh}(h]h ]h"]h$]h&]uh1jhjuhMhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhjubh)}(hAdd the data at **vaddr** to **bio**. The caller must have ensure a segment is available for the added data. No merging into an existing segment will be performed.h](hAdd the data at }(hjhhhNhNubj)}(h **vaddr**h]hvaddr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh to }(hjhhhNhNubj)}(h**bio**h]hbio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh. The caller must have ensure a segment is available for the added data. No merging into an existing segment will be performed.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j bio_add_page (C function)c.bio_add_pagehNtauh1hhjOghhhNhNubj)}(hhh](j)}(h\int bio_add_page (struct bio *bio, struct page *page, unsigned int len, unsigned int offset)h]j)}(h[int bio_add_page(struct bio *bio, struct page *page, unsigned int len, unsigned int offset)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chM&ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhM&ubjC)}(h bio_add_pageh]jI)}(h bio_add_pageh]h bio_add_page}(hj%hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj!ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhM&ubj=)}(hK(struct bio *bio, struct page *page, unsigned int len, unsigned int offset)h](jC)}(hstruct bio *bioh](j )}(hjh]hstruct}(hjAhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj=ubj2)}(h h]h }(hjNhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj=ubh)}(hhh]jI)}(hbioh]hbio}(hj_hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj\ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjamodnameN classnameNjj )}j ]j)}jj'sbc.bio_add_pageasbuh1hhj=ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj=ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=ubjI)}(hbioh]hbio}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj=ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj9ubjC)}(hstruct page *pageh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hpageh]hpage}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j{c.bio_add_pageasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hpageh]hpage}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj9ubjC)}(hunsigned int lenh](j)}(hunsignedh]hunsigned}(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hj1hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hinth]hint}(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjMhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hlenh]hlen}(hj[hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj9ubjC)}(hunsigned int offseth](j)}(hunsignedh]hunsigned}(hjthhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjpubj)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjpubjI)}(hoffseth]hoffset}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjpubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj9ubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhM&ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhM&ubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhM&hjhhubjw)}(hhh]h)}(hattempt to add page(s) to bioh]hattempt to add page(s) to bio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chM&hjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhM&ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``struct bio *bio`` destination bio ``struct page *page`` start page to add ``unsigned int len`` vec entry length, may cross pages ``unsigned int offset`` vec entry offset relative to **page**, may cross pages **Description** Attempt to add page(s) to the bio_vec maplist. This will only fail if either bio->bi_vcnt == bio->bi_max_vecs or it's a cloned bio.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chM*hjubj)}(hhh](j)}(h$``struct bio *bio`` destination bio h](j)}(h``struct bio *bio``h]j)}(hjh]hstruct bio *bio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chM'hjubj)}(hhh]h)}(hdestination bioh]hdestination bio}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj,hM'hj-ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj,hM'hjubj)}(h(``struct page *page`` start page to add h](j)}(h``struct page *page``h]j)}(hjPh]hstruct page *page}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjNubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chM(hjJubj)}(hhh]h)}(hstart page to addh]hstart page to add}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1hhjehM(hjfubah}(h]h ]h"]h$]h&]uh1jhjJubeh}(h]h ]h"]h$]h&]uh1jhjehM(hjubj)}(h7``unsigned int len`` vec entry length, may cross pages h](j)}(h``unsigned int len``h]j)}(hjh]hunsigned int len}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chM)hjubj)}(hhh]h)}(h!vec entry length, may cross pagesh]h!vec entry length, may cross pages}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM)hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM)hjubj)}(hO``unsigned int offset`` vec entry offset relative to **page**, may cross pages h](j)}(h``unsigned int offset``h]j)}(hjh]hunsigned int offset}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chM*hjubj)}(hhh]h)}(h6vec entry offset relative to **page**, may cross pagesh](hvec entry offset relative to }(hjhhhNhNubj)}(h**page**h]hpage}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh, may cross pages}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhM*hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM*hjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chM,hjubj)}(hAttempt to add page(s) to the bio_vec maplist. This will only fail if either bio->bi_vcnt == bio->bi_max_vecs or it's a cloned bio.h]h)}(hAttempt to add page(s) to the bio_vec maplist. This will only fail if either bio->bi_vcnt == bio->bi_max_vecs or it's a cloned bio.h]hAttempt to add page(s) to the bio_vec maplist. This will only fail if either bio->bi_vcnt == bio->bi_max_vecs or it’s a cloned bio.}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chM+hj%ubah}(h]h ]h"]h$]h&]uh1jhj7hM+hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j bio_add_folio (C function)c.bio_add_foliohNtauh1hhjOghhhNhNubj)}(hhh](j)}(hQbool bio_add_folio (struct bio *bio, struct folio *folio, size_t len, size_t off)h]j)}(hPbool bio_add_folio(struct bio *bio, struct folio *folio, size_t len, size_t off)h](j)}(hjh]hbool}(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZhhhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMWubj2)}(h h]h }(hjlhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjZhhhjkhMWubjC)}(h bio_add_folioh]jI)}(h bio_add_folioh]h bio_add_folio}(hj~hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjzubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjZhhhjkhMWubj=)}(h>(struct bio *bio, struct folio *folio, size_t len, size_t off)h](jC)}(hstruct bio *bioh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hbioh]hbio}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jjsbc.bio_add_folioasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hbioh]hbio}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct folio *folioh](j )}(hjh]hstruct}(hj hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj ubj2)}(h h]h }(hj hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj ubh)}(hhh]jI)}(hfolioh]hfolio}(hj* hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj' ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj, modnameN classnameNjj )}j ]jc.bio_add_folioasbuh1hhj ubj2)}(h h]h }(hjH hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj ubj)}(hjh]h*}(hjV hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubjI)}(hfolioh]hfolio}(hjc hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h size_t lenh](h)}(hhh]jI)}(hsize_th]hsize_t}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj| ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj modnameN classnameNjj )}j ]jc.bio_add_folioasbuh1hhjx ubj2)}(h h]h }(hj hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjx ubjI)}(hlenh]hlen}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjx ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h size_t offh](h)}(hhh]jI)}(hsize_th]hsize_t}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj modnameN classnameNjj )}j ]jc.bio_add_folioasbuh1hhj ubj2)}(h h]h }(hj hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj ubjI)}(hoffh]hoff}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjZhhhjkhMWubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjVhhhjkhMWubah}(h]jQah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjkhMWhjShhubjw)}(hhh]h)}(h(Attempt to add part of a folio to a bio.h]h(Attempt to add part of a folio to a bio.}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMWhj!hhubah}(h]h ]h"]h$]h&]uh1jvhjShhhjkhMWubeh}(h]h ](jfunctioneh"]h$]h&]jjjj5!jj5!jjjuh1jhhhjOghNhNubj)}(hX$**Parameters** ``struct bio *bio`` BIO to add to. ``struct folio *folio`` Folio to add. ``size_t len`` How many bytes from the folio to add. ``size_t off`` First byte in this folio to add. **Description** Filesystems that use folios can call this function instead of calling bio_add_page() for each page in the folio. If **off** is bigger than PAGE_SIZE, this function can create a bio_vec that starts in a page after the bv_page. BIOs do not support folios that are 4GiB or larger. **Return** Whether the addition was successful.h](h)}(h**Parameters**h]j)}(hj?!h]h Parameters}(hjA!hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj=!ubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chM[hj9!ubj)}(hhh](j)}(h#``struct bio *bio`` BIO to add to. h](j)}(h``struct bio *bio``h]j)}(hj^!h]hstruct bio *bio}(hj`!hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj\!ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMXhjX!ubj)}(hhh]h)}(hBIO to add to.h]hBIO to add to.}(hjw!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjs!hMXhjt!ubah}(h]h ]h"]h$]h&]uh1jhjX!ubeh}(h]h ]h"]h$]h&]uh1jhjs!hMXhjU!ubj)}(h&``struct folio *folio`` Folio to add. h](j)}(h``struct folio *folio``h]j)}(hj!h]hstruct folio *folio}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj!ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMYhj!ubj)}(hhh]h)}(h Folio to add.h]h Folio to add.}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj!hMYhj!ubah}(h]h ]h"]h$]h&]uh1jhj!ubeh}(h]h ]h"]h$]h&]uh1jhj!hMYhjU!ubj)}(h5``size_t len`` How many bytes from the folio to add. h](j)}(h``size_t len``h]j)}(hj!h]h size_t len}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj!ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMZhj!ubj)}(hhh]h)}(h%How many bytes from the folio to add.h]h%How many bytes from the folio to add.}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj!hMZhj!ubah}(h]h ]h"]h$]h&]uh1jhj!ubeh}(h]h ]h"]h$]h&]uh1jhj!hMZhjU!ubj)}(h0``size_t off`` First byte in this folio to add. h](j)}(h``size_t off``h]j)}(hj "h]h size_t off}(hj "hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj"ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chM[hj"ubj)}(hhh]h)}(h First byte in this folio to add.h]h First byte in this folio to add.}(hj""hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj"hM[hj"ubah}(h]h ]h"]h$]h&]uh1jhj"ubeh}(h]h ]h"]h$]h&]uh1jhj"hM[hjU!ubeh}(h]h ]h"]h$]h&]uh1jhj9!ubh)}(h**Description**h]j)}(hjD"h]h Description}(hjF"hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjB"ubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chM]hj9!ubh)}(hXFilesystems that use folios can call this function instead of calling bio_add_page() for each page in the folio. If **off** is bigger than PAGE_SIZE, this function can create a bio_vec that starts in a page after the bv_page. BIOs do not support folios that are 4GiB or larger.h](huFilesystems that use folios can call this function instead of calling bio_add_page() for each page in the folio. If }(hjZ"hhhNhNubj)}(h**off**h]hoff}(hjb"hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjZ"ubh is bigger than PAGE_SIZE, this function can create a bio_vec that starts in a page after the bv_page. BIOs do not support folios that are 4GiB or larger.}(hjZ"hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chM\hj9!ubh)}(h **Return**h]j)}(hj}"h]hReturn}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj{"ubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMahj9!ubh)}(h$Whether the addition was successful.h]h$Whether the addition was successful.}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMbhj9!ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j "bio_add_vmalloc_chunk (C function)c.bio_add_vmalloc_chunkhNtauh1hhjOghhhNhNubj)}(hhh](j)}(hOunsigned int bio_add_vmalloc_chunk (struct bio *bio, void *vaddr, unsigned len)h]j)}(hNunsigned int bio_add_vmalloc_chunk(struct bio *bio, void *vaddr, unsigned len)h](j)}(hunsignedh]hunsigned}(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"hhhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMpubj2)}(h h]h }(hj"hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj"hhhj"hMpubj)}(hinth]hint}(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"hhhj"hMpubj2)}(h h]h }(hj"hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj"hhhj"hMpubjC)}(hbio_add_vmalloc_chunkh]jI)}(hbio_add_vmalloc_chunkh]hbio_add_vmalloc_chunk}(hj"hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj"ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj"hhhj"hMpubj=)}(h,(struct bio *bio, void *vaddr, unsigned len)h](jC)}(hstruct bio *bioh](j )}(hjh]hstruct}(hj#hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj#ubj2)}(h h]h }(hj(#hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj#ubh)}(hhh]jI)}(hbioh]hbio}(hj9#hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj6#ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj;#modnameN classnameNjj )}j ]j)}jj#sbc.bio_add_vmalloc_chunkasbuh1hhj#ubj2)}(h h]h }(hjY#hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj#ubj)}(hjh]h*}(hjg#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#ubjI)}(hbioh]hbio}(hjt#hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj#ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj#ubjC)}(h void *vaddrh](j)}(hvoidh]hvoid}(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#ubj2)}(h h]h }(hj#hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj#ubj)}(hjh]h*}(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#ubjI)}(hvaddrh]hvaddr}(hj#hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj#ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj#ubjC)}(h unsigned lenh](j)}(hunsignedh]hunsigned}(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#ubj2)}(h h]h }(hj#hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj#ubjI)}(hlenh]hlen}(hj#hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj#ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj#ubeh}(h]h ]h"]h$]h&]j`jauh1j<hj"hhhj"hMpubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj"hhhj"hMpubah}(h]j"ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj"hMphj"hhubjw)}(hhh]h)}(hadd a vmalloc chunk to a bioh]hadd a vmalloc chunk to a bio}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMphj$hhubah}(h]h ]h"]h$]h&]uh1jvhj"hhhj"hMpubeh}(h]h ](jfunctioneh"]h$]h&]jjjj-$jj-$jjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``struct bio *bio`` destination bio ``void *vaddr`` vmalloc address to add ``unsigned len`` total length in bytes of the data to add **Description** Add data starting at **vaddr** to **bio** and return how many bytes were added. This may be less than the amount originally asked. Returns 0 if no data could be added to **bio**. This helper calls flush_kernel_vmap_range() for the range added. For reads the caller still needs to manually call invalidate_kernel_vmap_range() in the completion handler.h](h)}(h**Parameters**h]j)}(hj7$h]h Parameters}(hj9$hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj5$ubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMthj1$ubj)}(hhh](j)}(h$``struct bio *bio`` destination bio h](j)}(h``struct bio *bio``h]j)}(hjV$h]hstruct bio *bio}(hjX$hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjT$ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMqhjP$ubj)}(hhh]h)}(hdestination bioh]hdestination bio}(hjo$hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjk$hMqhjl$ubah}(h]h ]h"]h$]h&]uh1jhjP$ubeh}(h]h ]h"]h$]h&]uh1jhjk$hMqhjM$ubj)}(h'``void *vaddr`` vmalloc address to add h](j)}(h``void *vaddr``h]j)}(hj$h]h void *vaddr}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj$ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMrhj$ubj)}(hhh]h)}(hvmalloc address to addh]hvmalloc address to add}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj$hMrhj$ubah}(h]h ]h"]h$]h&]uh1jhj$ubeh}(h]h ]h"]h$]h&]uh1jhj$hMrhjM$ubj)}(h:``unsigned len`` total length in bytes of the data to add h](j)}(h``unsigned len``h]j)}(hj$h]h unsigned len}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj$ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMshj$ubj)}(hhh]h)}(h(total length in bytes of the data to addh]h(total length in bytes of the data to add}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj$hMshj$ubah}(h]h ]h"]h$]h&]uh1jhj$ubeh}(h]h ]h"]h$]h&]uh1jhj$hMshjM$ubeh}(h]h ]h"]h$]h&]uh1jhj1$ubh)}(h**Description**h]j)}(hj%h]h Description}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj%ubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMuhj1$ubh)}(hAdd data starting at **vaddr** to **bio** and return how many bytes were added. This may be less than the amount originally asked. Returns 0 if no data could be added to **bio**.h](hAdd data starting at }(hj%hhhNhNubj)}(h **vaddr**h]hvaddr}(hj!%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj%ubh to }(hj%hhhNhNubj)}(h**bio**h]hbio}(hj3%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj%ubh and return how many bytes were added. This may be less than the amount originally asked. Returns 0 if no data could be added to }(hj%hhhNhNubj)}(h**bio**h]hbio}(hjE%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj%ubh.}(hj%hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMthj1$ubh)}(hThis helper calls flush_kernel_vmap_range() for the range added. For reads the caller still needs to manually call invalidate_kernel_vmap_range() in the completion handler.h]hThis helper calls flush_kernel_vmap_range() for the range added. For reads the caller still needs to manually call invalidate_kernel_vmap_range() in the completion handler.}(hj^%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMxhj1$ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j bio_add_vmalloc (C function)c.bio_add_vmallochNtauh1hhjOghhhNhNubj)}(hhh](j)}(hEbool bio_add_vmalloc (struct bio *bio, void *vaddr, unsigned int len)h]j)}(hDbool bio_add_vmalloc(struct bio *bio, void *vaddr, unsigned int len)h](j)}(hjh]hbool}(hj%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%hhhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMubj2)}(h h]h }(hj%hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj%hhhj%hMubjC)}(hbio_add_vmalloch]jI)}(hbio_add_vmalloch]hbio_add_vmalloc}(hj%hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj%ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj%hhhj%hMubj=)}(h0(struct bio *bio, void *vaddr, unsigned int len)h](jC)}(hstruct bio *bioh](j )}(hjh]hstruct}(hj%hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj%ubj2)}(h h]h }(hj%hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj%ubh)}(hhh]jI)}(hbioh]hbio}(hj%hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj%ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj%modnameN classnameNjj )}j ]j)}jj%sbc.bio_add_vmallocasbuh1hhj%ubj2)}(h h]h }(hj&hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj%ubj)}(hjh]h*}(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%ubjI)}(hbioh]hbio}(hj"&hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj%ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj%ubjC)}(h void *vaddrh](j)}(hvoidh]hvoid}(hj;&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7&ubj2)}(h h]h }(hjI&hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj7&ubj)}(hjh]h*}(hjW&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7&ubjI)}(hvaddrh]hvaddr}(hjd&hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj7&ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj%ubjC)}(hunsigned int lenh](j)}(hunsignedh]hunsigned}(hj}&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjy&ubj2)}(h h]h }(hj&hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjy&ubj)}(hinth]hint}(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjy&ubj2)}(h h]h }(hj&hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjy&ubjI)}(hlenh]hlen}(hj&hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjy&ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj%ubeh}(h]h ]h"]h$]h&]j`jauh1j<hj%hhhj%hMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj%hhhj%hMubah}(h]j%ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj%hMhj%hhubjw)}(hhh]h)}(hadd a vmalloc region to a bioh]hadd a vmalloc region to a bio}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhj&hhubah}(h]h ]h"]h$]h&]uh1jvhj%hhhj%hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjj&jj&jjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``struct bio *bio`` destination bio ``void *vaddr`` vmalloc address to add ``unsigned int len`` total length in bytes of the data to add **Description** Add data starting at **vaddr** to **bio**. Return ``true`` on success or ``false`` if **bio** does not have enough space for the payload. This helper calls flush_kernel_vmap_range() for the range added. For reads the caller still needs to manually call invalidate_kernel_vmap_range() in the completion handler.h](h)}(h**Parameters**h]j)}(hj'h]h Parameters}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj&ubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhj&ubj)}(hhh](j)}(h$``struct bio *bio`` destination bio h](j)}(h``struct bio *bio``h]j)}(hj 'h]hstruct bio *bio}(hj"'hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj'ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhj'ubj)}(hhh]h)}(hdestination bioh]hdestination bio}(hj9'hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj5'hMhj6'ubah}(h]h ]h"]h$]h&]uh1jhj'ubeh}(h]h ]h"]h$]h&]uh1jhj5'hMhj'ubj)}(h'``void *vaddr`` vmalloc address to add h](j)}(h``void *vaddr``h]j)}(hjY'h]h void *vaddr}(hj['hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjW'ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhjS'ubj)}(hhh]h)}(hvmalloc address to addh]hvmalloc address to add}(hjr'hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjn'hMhjo'ubah}(h]h ]h"]h$]h&]uh1jhjS'ubeh}(h]h ]h"]h$]h&]uh1jhjn'hMhj'ubj)}(h>``unsigned int len`` total length in bytes of the data to add h](j)}(h``unsigned int len``h]j)}(hj'h]hunsigned int len}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj'ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhj'ubj)}(hhh]h)}(h(total length in bytes of the data to addh]h(total length in bytes of the data to add}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj'hMhj'ubah}(h]h ]h"]h$]h&]uh1jhj'ubeh}(h]h ]h"]h$]h&]uh1jhj'hMhj'ubeh}(h]h ]h"]h$]h&]uh1jhj&ubh)}(h**Description**h]j)}(hj'h]h Description}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj'ubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhj&ubh)}(hAdd data starting at **vaddr** to **bio**. Return ``true`` on success or ``false`` if **bio** does not have enough space for the payload.h](hAdd data starting at }(hj'hhhNhNubj)}(h **vaddr**h]hvaddr}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj'ubh to }(hj'hhhNhNubj)}(h**bio**h]hbio}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj'ubh . Return }(hj'hhhNhNubj)}(h``true``h]htrue}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj'ubh on success or }(hj'hhhNhNubj)}(h ``false``h]hfalse}(hj!(hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj'ubh if }(hj'hhhNhNubj)}(h**bio**h]hbio}(hj3(hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj'ubh, does not have enough space for the payload.}(hj'hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhj&ubh)}(hThis helper calls flush_kernel_vmap_range() for the range added. For reads the caller still needs to manually call invalidate_kernel_vmap_range() in the completion handler.h]hThis helper calls flush_kernel_vmap_range() for the range added. For reads the caller still needs to manually call invalidate_kernel_vmap_range() in the completion handler.}(hjL(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhj&ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j &bio_iov_iter_bounce_write (C function)c.bio_iov_iter_bounce_writehNtauh1hhjOghhhNhNubj)}(hhh](j)}(heint bio_iov_iter_bounce_write (struct bio *bio, struct iov_iter *iter, size_t maxlen, size_t minsize)h]j)}(hdint bio_iov_iter_bounce_write(struct bio *bio, struct iov_iter *iter, size_t maxlen, size_t minsize)h](j)}(hinth]hint}(hj{(hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjw(hhhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMubj2)}(h h]h }(hj(hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjw(hhhj(hMubjC)}(hbio_iov_iter_bounce_writeh]jI)}(hbio_iov_iter_bounce_writeh]hbio_iov_iter_bounce_write}(hj(hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj(ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjw(hhhj(hMubj=)}(hG(struct bio *bio, struct iov_iter *iter, size_t maxlen, size_t minsize)h](jC)}(hstruct bio *bioh](j )}(hjh]hstruct}(hj(hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj(ubj2)}(h h]h }(hj(hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj(ubh)}(hhh]jI)}(hbioh]hbio}(hj(hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj(ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj(modnameN classnameNjj )}j ]j)}jj(sbc.bio_iov_iter_bounce_writeasbuh1hhj(ubj2)}(h h]h }(hj(hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj(ubj)}(hjh]h*}(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(ubjI)}(hbioh]hbio}(hj)hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj(ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj(ubjC)}(hstruct iov_iter *iterh](j )}(hjh]hstruct}(hj*)hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj&)ubj2)}(h h]h }(hj7)hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj&)ubh)}(hhh]jI)}(hiov_iterh]hiov_iter}(hjH)hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjE)ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjJ)modnameN classnameNjj )}j ]j(c.bio_iov_iter_bounce_writeasbuh1hhj&)ubj2)}(h h]h }(hjf)hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj&)ubj)}(hjh]h*}(hjt)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&)ubjI)}(hiterh]hiter}(hj)hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj&)ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj(ubjC)}(h size_t maxlenh](h)}(hhh]jI)}(hsize_th]hsize_t}(hj)hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj)ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj)modnameN classnameNjj )}j ]j(c.bio_iov_iter_bounce_writeasbuh1hhj)ubj2)}(h h]h }(hj)hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj)ubjI)}(hmaxlenh]hmaxlen}(hj)hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj)ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj(ubjC)}(hsize_t minsizeh](h)}(hhh]jI)}(hsize_th]hsize_t}(hj)hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj)ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj)modnameN classnameNjj )}j ]j(c.bio_iov_iter_bounce_writeasbuh1hhj)ubj2)}(h h]h }(hj*hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj)ubjI)}(hminsizeh]hminsize}(hj*hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj)ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj(ubeh}(h]h ]h"]h$]h&]j`jauh1j<hjw(hhhj(hMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjs(hhhj(hMubah}(h]jn(ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj(hMhjp(hhubjw)}(hhh]h)}(h*bounce buffer data from an iter into a bioh]h*bounce buffer data from an iter into a bio}(hj;*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhj8*hhubah}(h]h ]h"]h$]h&]uh1jvhjp(hhhj(hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjS*jjS*jjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``struct bio *bio`` bio to send ``struct iov_iter *iter`` iter to read from ``size_t maxlen`` maximum size to bounce ``size_t minsize`` minimum folio allocation size **Description** Helper for direct I/O write implementations that need to bounce buffer because they need need to checksum the data or perform other operations that require consistency. Allocates folios to back the bounce buffer, and copies the data into it. Needs to be paired with bio_free_folios() called on completion.h](h)}(h**Parameters**h]j)}(hj]*h]h Parameters}(hj_*hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj[*ubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhjW*ubj)}(hhh](j)}(h ``struct bio *bio`` bio to send h](j)}(h``struct bio *bio``h]j)}(hj|*h]hstruct bio *bio}(hj~*hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjz*ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhjv*ubj)}(hhh]h)}(h bio to sendh]h bio to send}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj*hMhj*ubah}(h]h ]h"]h$]h&]uh1jhjv*ubeh}(h]h ]h"]h$]h&]uh1jhj*hMhjs*ubj)}(h,``struct iov_iter *iter`` iter to read from h](j)}(h``struct iov_iter *iter``h]j)}(hj*h]hstruct iov_iter *iter}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj*ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhj*ubj)}(hhh]h)}(hiter to read fromh]hiter to read from}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj*hMhj*ubah}(h]h ]h"]h$]h&]uh1jhj*ubeh}(h]h ]h"]h$]h&]uh1jhj*hMhjs*ubj)}(h)``size_t maxlen`` maximum size to bounce h](j)}(h``size_t maxlen``h]j)}(hj*h]h size_t maxlen}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj*ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhj*ubj)}(hhh]h)}(hmaximum size to bounceh]hmaximum size to bounce}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj+hMhj+ubah}(h]h ]h"]h$]h&]uh1jhj*ubeh}(h]h ]h"]h$]h&]uh1jhj+hMhjs*ubj)}(h1``size_t minsize`` minimum folio allocation size h](j)}(h``size_t minsize``h]j)}(hj'+h]hsize_t minsize}(hj)+hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj%+ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhj!+ubj)}(hhh]h)}(hminimum folio allocation sizeh]hminimum folio allocation size}(hj@+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj<+hMhj=+ubah}(h]h ]h"]h$]h&]uh1jhj!+ubeh}(h]h ]h"]h$]h&]uh1jhj<+hMhjs*ubeh}(h]h ]h"]h$]h&]uh1jhjW*ubh)}(h**Description**h]j)}(hjb+h]h Description}(hjd+hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj`+ubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhjW*ubh)}(hX3Helper for direct I/O write implementations that need to bounce buffer because they need need to checksum the data or perform other operations that require consistency. Allocates folios to back the bounce buffer, and copies the data into it. Needs to be paired with bio_free_folios() called on completion.h]hX3Helper for direct I/O write implementations that need to bounce buffer because they need need to checksum the data or perform other operations that require consistency. Allocates folios to back the bounce buffer, and copies the data into it. Needs to be paired with bio_free_folios() called on completion.}(hjx+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhjW*ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j bio_await (C function) c.bio_awaithNtauh1hhjOghhhNhNubj)}(hhh](j)}(hYvoid bio_await (struct bio *bio, void *priv, void (*submit)(struct bio *bio, void *priv))h]j)}(hXvoid bio_await(struct bio *bio, void *priv, void (*submit)(struct bio *bio, void *priv))h](j)}(hvoidh]hvoid}(hj+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+hhhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMubj2)}(h h]h }(hj+hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj+hhhj+hMubjC)}(h bio_awaith]jI)}(h bio_awaith]h bio_await}(hj+hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj+ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj+hhhj+hMubj=)}(hJ(struct bio *bio, void *priv, void (*submit)(struct bio *bio, void *priv))h](jC)}(hstruct bio *bioh](j )}(hjh]hstruct}(hj+hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj+ubj2)}(h h]h }(hj+hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj+ubh)}(hhh]jI)}(hbioh]hbio}(hj,hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj+ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj,modnameN classnameNjj )}j ]j)}jj+sb c.bio_awaitasbuh1hhj+ubj2)}(h h]h }(hj",hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj+ubj)}(hjh]h*}(hj0,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubjI)}(hbioh]hbio}(hj=,hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj+ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj+ubjC)}(h void *privh](j)}(hvoidh]hvoid}(hjV,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjR,ubj2)}(h h]h }(hjd,hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjR,ubj)}(hjh]h*}(hjr,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjR,ubjI)}(hprivh]hpriv}(hj,hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjR,ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj+ubjC)}(h+void (*submit)(struct bio *bio, void *priv)h](j)}(hvoidh]hvoid!}(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,ubj2)}(h h]h }(hj,hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj,ubj)}(hjʥh]h(}(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,ubj)}(hjh]h*}(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,ubjI)}(hsubmith]hsubmit}(hj,hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj,ubj)}(hjh]h)}(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,ubj)}(hjʥh]h(}(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,ubj )}(hjh]hstruct}(hj,hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj,ubj2)}(h h]h }(hj-hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj,ubh)}(hhh]jI)}(hbioh]hbio}(hj-hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj-ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj-modnameN classnameNjj )}j ]j, c.bio_awaitasbuh1hhj,ubj2)}(h h]h }(hj2-hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj,ubj)}(hjh]h*}(hj@-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,ubjI)}(hbioh]hbio}(hjM-hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj,ubj)}(hjWh]h,}(hj[-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,ubj2)}(h h]h }(hjh-hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj,ubj)}(hvoidh]hvoid}(hjv-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,ubj2)}(h h]h }(hj-hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj,ubj)}(hjh]h*}(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,ubjI)}(hprivh]hpriv}(hj-hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj,ubj)}(hjh]h)}(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj+ubeh}(h]h ]h"]h$]h&]j`jauh1j<hj+hhhj+hMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj+hhhj+hMubah}(h]j+ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj+hMhj+hhubjw)}(hhh]h)}(h5call a function on a bio, and wait until it completesh]h5call a function on a bio, and wait until it completes}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhj-hhubah}(h]h ]h"]h$]h&]uh1jvhj+hhhj+hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjj-jj-jjjuh1jhhhjOghNhNubj)}(hXA**Parameters** ``struct bio *bio`` the bio which describes the I/O ``void *priv`` private data passed to **submit** ``void (*submit)(struct bio *bio, void *priv)`` function called to submit the bio **Description** Wait for the bio as well as any bio chained off it after executing the passed in callback **submit**. The wait for the bio is set up before calling **submit** to ensure that the completion is captured. If **submit** is ``NULL``, submit_bio() is used instead to submit the bio. **Note** this overrides the bi_private and bi_end_io fields in the bio.h](h)}(h**Parameters**h]j)}(hj-h]h Parameters}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj-ubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhj-ubj)}(hhh](j)}(h4``struct bio *bio`` the bio which describes the I/O h](j)}(h``struct bio *bio``h]j)}(hj.h]hstruct bio *bio}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj.ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhj.ubj)}(hhh]h)}(hthe bio which describes the I/Oh]hthe bio which describes the I/O}(hj0.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj,.hMhj-.ubah}(h]h ]h"]h$]h&]uh1jhj.ubeh}(h]h ]h"]h$]h&]uh1jhj,.hMhj.ubj)}(h1``void *priv`` private data passed to **submit** h](j)}(h``void *priv``h]j)}(hjP.h]h void *priv}(hjR.hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjN.ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhjJ.ubj)}(hhh]h)}(h!private data passed to **submit**h](hprivate data passed to }(hji.hhhNhNubj)}(h **submit**h]hsubmit}(hjq.hhhNhNubah}(h]h ]h"]h$]h&]uh1jhji.ubeh}(h]h ]h"]h$]h&]uh1hhje.hMhjf.ubah}(h]h ]h"]h$]h&]uh1jhjJ.ubeh}(h]h ]h"]h$]h&]uh1jhje.hMhj.ubj)}(hR``void (*submit)(struct bio *bio, void *priv)`` function called to submit the bio h](j)}(h/``void (*submit)(struct bio *bio, void *priv)``h]j)}(hj.h]h+void (*submit)(struct bio *bio, void *priv)}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj.ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhj.ubj)}(hhh]h)}(h!function called to submit the bioh]h!function called to submit the bio}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj.hMhj.ubah}(h]h ]h"]h$]h&]uh1jhj.ubeh}(h]h ]h"]h$]h&]uh1jhj.hMhj.ubeh}(h]h ]h"]h$]h&]uh1jhj-ubh)}(h**Description**h]j)}(hj.h]h Description}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj.ubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhj-ubh)}(hXWait for the bio as well as any bio chained off it after executing the passed in callback **submit**. The wait for the bio is set up before calling **submit** to ensure that the completion is captured. If **submit** is ``NULL``, submit_bio() is used instead to submit the bio.h](hZWait for the bio as well as any bio chained off it after executing the passed in callback }(hj.hhhNhNubj)}(h **submit**h]hsubmit}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj.ubh1. The wait for the bio is set up before calling }(hj.hhhNhNubj)}(h **submit**h]hsubmit}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj.ubh0 to ensure that the completion is captured. If }(hj.hhhNhNubj)}(h **submit**h]hsubmit}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj.ubh is }(hj.hhhNhNubj)}(h``NULL``h]hNULL}(hj&/hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj.ubh1, submit_bio() is used instead to submit the bio.}(hj.hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhj-ubh)}(h**Note**h]j)}(hjA/h]hNote}(hjC/hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj?/ubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chM hj-ubh)}(h>this overrides the bi_private and bi_end_io fields in the bio.h]h>this overrides the bi_private and bi_end_io fields in the bio.}(hjW/hhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chM hj-ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j submit_bio_wait (C function)c.submit_bio_waithNtauh1hhjOghhhNhNubj)}(hhh](j)}(h%int submit_bio_wait (struct bio *bio)h]j)}(h$int submit_bio_wait(struct bio *bio)h](j)}(hinth]hint}(hj/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/hhhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMubj2)}(h h]h }(hj/hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj/hhhj/hMubjC)}(hsubmit_bio_waith]jI)}(hsubmit_bio_waith]hsubmit_bio_wait}(hj/hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj/ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj/hhhj/hMubj=)}(h(struct bio *bio)h]jC)}(hstruct bio *bioh](j )}(hjh]hstruct}(hj/hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj/ubj2)}(h h]h }(hj/hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj/ubh)}(hhh]jI)}(hbioh]hbio}(hj/hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj/ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj/modnameN classnameNjj )}j ]j)}jj/sbc.submit_bio_waitasbuh1hhj/ubj2)}(h h]h }(hj0hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj/ubj)}(hjh]h*}(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/ubjI)}(hbioh]hbio}(hj0hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj/ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj/ubah}(h]h ]h"]h$]h&]j`jauh1j<hj/hhhj/hMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj~/hhhj/hMubah}(h]jy/ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj/hMhj{/hhubjw)}(hhh]h)}(h)submit a bio, and wait until it completesh]h)submit a bio, and wait until it completes}(hjF0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhjC0hhubah}(h]h ]h"]h$]h&]uh1jvhj{/hhhj/hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjj^0jj^0jjjuh1jhhhjOghNhNubj)}(hXv**Parameters** ``struct bio *bio`` The :c:type:`struct bio ` which describes the I/O **Description** Simple wrapper around submit_bio(). Returns 0 on success, or the error from bio_endio() on failure. WARNING: Unlike to how submit_bio() is usually used, this function does not result in bio reference to be consumed. The caller must drop the reference on his own.h](h)}(h**Parameters**h]j)}(hjh0h]h Parameters}(hjj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjf0ubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chM"hjb0ubj)}(hhh]j)}(hK``struct bio *bio`` The :c:type:`struct bio ` which describes the I/O h](j)}(h``struct bio *bio``h]j)}(hj0h]hstruct bio *bio}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj0ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhj0ubj)}(hhh]h)}(h6The :c:type:`struct bio ` which describes the I/Oh](hThe }(hj0hhhNhNubh)}(h:c:type:`struct bio `h]j)}(hj0h]h struct bio}(hj0hhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhj0ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnjjjbiouh1hhj0hMhj0ubh which describes the I/O}(hj0hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj0hMhj0ubah}(h]h ]h"]h$]h&]uh1jhj0ubeh}(h]h ]h"]h$]h&]uh1jhj0hMhj~0ubah}(h]h ]h"]h$]h&]uh1jhjb0ubh)}(h**Description**h]j)}(hj0h]h Description}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj0ubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chM!hjb0ubh)}(hcSimple wrapper around submit_bio(). Returns 0 on success, or the error from bio_endio() on failure.h]hcSimple wrapper around submit_bio(). Returns 0 on success, or the error from bio_endio() on failure.}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chM hjb0ubh)}(hWARNING: Unlike to how submit_bio() is usually used, this function does not result in bio reference to be consumed. The caller must drop the reference on his own.h]hWARNING: Unlike to how submit_bio() is usually used, this function does not result in bio reference to be consumed. The caller must drop the reference on his own.}(hj 1hhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chM#hjb0ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j bdev_rw_virt (C function)c.bdev_rw_virthNtauh1hhjOghhhNhNubj)}(hhh](j)}(heint bdev_rw_virt (struct block_device *bdev, sector_t sector, void *data, size_t len, enum req_op op)h]j)}(hdint bdev_rw_virt(struct block_device *bdev, sector_t sector, void *data, size_t len, enum req_op op)h](j)}(hinth]hint}(hj91hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj51hhhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMCubj2)}(h h]h }(hjH1hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj51hhhjG1hMCubjC)}(h bdev_rw_virth]jI)}(h bdev_rw_virth]h bdev_rw_virt}(hjZ1hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjV1ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj51hhhjG1hMCubj=)}(hT(struct block_device *bdev, sector_t sector, void *data, size_t len, enum req_op op)h](jC)}(hstruct block_device *bdevh](j )}(hjh]hstruct}(hjv1hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjr1ubj2)}(h h]h }(hj1hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjr1ubh)}(hhh]jI)}(h block_deviceh]h block_device}(hj1hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj1ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj1modnameN classnameNjj )}j ]j)}jj\1sbc.bdev_rw_virtasbuh1hhjr1ubj2)}(h h]h }(hj1hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjr1ubj)}(hjh]h*}(hj1hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjr1ubjI)}(hbdevh]hbdev}(hj1hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjr1ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjn1ubjC)}(hsector_t sectorh](h)}(hhh]jI)}(hsector_th]hsector_t}(hj1hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj1ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj1modnameN classnameNjj )}j ]j1c.bdev_rw_virtasbuh1hhj1ubj2)}(h h]h }(hj 2hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj1ubjI)}(hsectorh]hsector}(hj2hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj1ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjn1ubjC)}(h void *datah](j)}(hvoidh]hvoid}(hj02hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,2ubj2)}(h h]h }(hj>2hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj,2ubj)}(hjh]h*}(hjL2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,2ubjI)}(hdatah]hdata}(hjY2hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj,2ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjn1ubjC)}(h size_t lenh](h)}(hhh]jI)}(hsize_th]hsize_t}(hju2hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjr2ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjw2modnameN classnameNjj )}j ]j1c.bdev_rw_virtasbuh1hhjn2ubj2)}(h h]h }(hj2hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjn2ubjI)}(hlenh]hlen}(hj2hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjn2ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjn1ubjC)}(henum req_op oph](j )}(hj#h]henum}(hj2hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj2ubj2)}(h h]h }(hj2hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj2ubh)}(hhh]jI)}(hreq_oph]hreq_op}(hj2hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj2ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj2modnameN classnameNjj )}j ]j1c.bdev_rw_virtasbuh1hhj2ubj2)}(h h]h }(hj2hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj2ubjI)}(hoph]hop}(hj3hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj2ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjn1ubeh}(h]h ]h"]h$]h&]j`jauh1j<hj51hhhjG1hMCubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj11hhhjG1hMCubah}(h]j,1ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjG1hMChj.1hhubjw)}(hhh]h)}(h3synchronously read into / write from kernel mappingh]h3synchronously read into / write from kernel mapping}(hj.3hhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMChj+3hhubah}(h]h ]h"]h$]h&]uh1jvhj.1hhhjG1hMCubeh}(h]h ](jfunctioneh"]h$]h&]jjjjF3jjF3jjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``struct block_device *bdev`` block device to access ``sector_t sector`` sector to access ``void *data`` data to read/write ``size_t len`` length in byte to read/write ``enum req_op op`` operation (e.g. REQ_OP_READ/REQ_OP_WRITE) **Description** Performs synchronous I/O to **bdev** for **data**/**len**. **data** must be in the kernel direct mapping and not a vmalloc address.h](h)}(h**Parameters**h]j)}(hjP3h]h Parameters}(hjR3hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjN3ubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMGhjJ3ubj)}(hhh](j)}(h5``struct block_device *bdev`` block device to access h](j)}(h``struct block_device *bdev``h]j)}(hjo3h]hstruct block_device *bdev}(hjq3hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjm3ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMDhji3ubj)}(hhh]h)}(hblock device to accessh]hblock device to access}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj3hMDhj3ubah}(h]h ]h"]h$]h&]uh1jhji3ubeh}(h]h ]h"]h$]h&]uh1jhj3hMDhjf3ubj)}(h%``sector_t sector`` sector to access h](j)}(h``sector_t sector``h]j)}(hj3h]hsector_t sector}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj3ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMEhj3ubj)}(hhh]h)}(hsector to accessh]hsector to access}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj3hMEhj3ubah}(h]h ]h"]h$]h&]uh1jhj3ubeh}(h]h ]h"]h$]h&]uh1jhj3hMEhjf3ubj)}(h"``void *data`` data to read/write h](j)}(h``void *data``h]j)}(hj3h]h void *data}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj3ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMFhj3ubj)}(hhh]h)}(hdata to read/writeh]hdata to read/write}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj3hMFhj3ubah}(h]h ]h"]h$]h&]uh1jhj3ubeh}(h]h ]h"]h$]h&]uh1jhj3hMFhjf3ubj)}(h,``size_t len`` length in byte to read/write h](j)}(h``size_t len``h]j)}(hj4h]h size_t len}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj4ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMGhj4ubj)}(hhh]h)}(hlength in byte to read/writeh]hlength in byte to read/write}(hj34hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/4hMGhj04ubah}(h]h ]h"]h$]h&]uh1jhj4ubeh}(h]h ]h"]h$]h&]uh1jhj/4hMGhjf3ubj)}(h=``enum req_op op`` operation (e.g. REQ_OP_READ/REQ_OP_WRITE) h](j)}(h``enum req_op op``h]j)}(hjS4h]henum req_op op}(hjU4hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjQ4ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMHhjM4ubj)}(hhh]h)}(h)operation (e.g. REQ_OP_READ/REQ_OP_WRITE)h]h)operation (e.g. REQ_OP_READ/REQ_OP_WRITE)}(hjl4hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjh4hMHhji4ubah}(h]h ]h"]h$]h&]uh1jhjM4ubeh}(h]h ]h"]h$]h&]uh1jhjh4hMHhjf3ubeh}(h]h ]h"]h$]h&]uh1jhjJ3ubh)}(h**Description**h]j)}(hj4h]h Description}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj4ubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMJhjJ3ubh)}(hPerforms synchronous I/O to **bdev** for **data**/**len**. **data** must be in the kernel direct mapping and not a vmalloc address.h](hPerforms synchronous I/O to }(hj4hhhNhNubj)}(h**bdev**h]hbdev}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj4ubh for }(hj4hhhNhNubj)}(h**data**h]hdata}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj4ubh/}(hj4hhhNhNubj)}(h**len**h]hlen}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj4ubh. }(hj4hhhNhNubj)}(h**data**h]hdata}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj4ubh@ must be in the kernel direct mapping and not a vmalloc address.}(hj4hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMIhjJ3ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j bio_copy_data (C function)c.bio_copy_datahNtauh1hhjOghhhNhNubj)}(hhh](j)}(h5void bio_copy_data (struct bio *dst, struct bio *src)h]j)}(h4void bio_copy_data(struct bio *dst, struct bio *src)h](j)}(hvoidh]hvoid}(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5hhhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMlubj2)}(h h]h }(hj*5hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj5hhhj)5hMlubjC)}(h bio_copy_datah]jI)}(h bio_copy_datah]h bio_copy_data}(hj<5hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj85ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj5hhhj)5hMlubj=)}(h"(struct bio *dst, struct bio *src)h](jC)}(hstruct bio *dsth](j )}(hjh]hstruct}(hjX5hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjT5ubj2)}(h h]h }(hje5hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjT5ubh)}(hhh]jI)}(hbioh]hbio}(hjv5hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjs5ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjx5modnameN classnameNjj )}j ]j)}jj>5sbc.bio_copy_dataasbuh1hhjT5ubj2)}(h h]h }(hj5hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjT5ubj)}(hjh]h*}(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjT5ubjI)}(hdsth]hdst}(hj5hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjT5ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjP5ubjC)}(hstruct bio *srch](j )}(hjh]hstruct}(hj5hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj5ubj2)}(h h]h }(hj5hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj5ubh)}(hhh]jI)}(hbioh]hbio}(hj5hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj5ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj5modnameN classnameNjj )}j ]j5c.bio_copy_dataasbuh1hhj5ubj2)}(h h]h }(hj6hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj5ubj)}(hjh]h*}(hj6hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5ubjI)}(hsrch]hsrc}(hj!6hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj5ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjP5ubeh}(h]h ]h"]h$]h&]j`jauh1j<hj5hhhj)5hMlubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj5hhhj)5hMlubah}(h]j5ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj)5hMlhj5hhubjw)}(hhh]h)}(h5copy contents of data buffers from one bio to anotherh]h5copy contents of data buffers from one bio to another}(hjK6hhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMlhjH6hhubah}(h]h ]h"]h$]h&]uh1jvhj5hhhj)5hMlubeh}(h]h ](jfunctioneh"]h$]h&]jjjjc6jjc6jjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``struct bio *dst`` destination bio ``struct bio *src`` source bio **Description** Stops when it reaches the end of either **src** or **dst** - that is, copies min(src->bi_size, dst->bi_size) bytes (or the equivalent for lists of bios).h](h)}(h**Parameters**h]j)}(hjm6h]h Parameters}(hjo6hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjk6ubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMphjg6ubj)}(hhh](j)}(h$``struct bio *dst`` destination bio h](j)}(h``struct bio *dst``h]j)}(hj6h]hstruct bio *dst}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj6ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMnhj6ubj)}(hhh]h)}(hdestination bioh]hdestination bio}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj6hMnhj6ubah}(h]h ]h"]h$]h&]uh1jhj6ubeh}(h]h ]h"]h$]h&]uh1jhj6hMnhj6ubj)}(h``struct bio *src`` source bio h](j)}(h``struct bio *src``h]j)}(hj6h]hstruct bio *src}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj6ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMmhj6ubj)}(hhh]h)}(h source bioh]h source bio}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj6hMmhj6ubah}(h]h ]h"]h$]h&]uh1jhj6ubeh}(h]h ]h"]h$]h&]uh1jhj6hMmhj6ubeh}(h]h ]h"]h$]h&]uh1jhjg6ubh)}(h**Description**h]j)}(hj7h]h Description}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj6ubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMohjg6ubh)}(hStops when it reaches the end of either **src** or **dst** - that is, copies min(src->bi_size, dst->bi_size) bytes (or the equivalent for lists of bios).h](h(Stops when it reaches the end of either }(hj7hhhNhNubj)}(h**src**h]hsrc}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj7ubh or }(hj7hhhNhNubj)}(h**dst**h]hdst}(hj07hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj7ubh_ - that is, copies min(src->bi_size, dst->bi_size) bytes (or the equivalent for lists of bios).}(hj7hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMohjg6ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j bio_endio (C function) c.bio_endiohNtauh1hhjOghhhNhNubj)}(hhh](j)}(h void bio_endio (struct bio *bio)h]j)}(hvoid bio_endio(struct bio *bio)h](j)}(hvoidh]hvoid}(hji7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhje7hhhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chM;ubj2)}(h h]h }(hjx7hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hje7hhhjw7hM;ubjC)}(h bio_endioh]jI)}(h bio_endioh]h bio_endio}(hj7hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj7ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhje7hhhjw7hM;ubj=)}(h(struct bio *bio)h]jC)}(hstruct bio *bioh](j )}(hjh]hstruct}(hj7hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj7ubj2)}(h h]h }(hj7hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj7ubh)}(hhh]jI)}(hbioh]hbio}(hj7hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj7ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj7modnameN classnameNjj )}j ]j)}jj7sb c.bio_endioasbuh1hhj7ubj2)}(h h]h }(hj7hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj7ubj)}(hjh]h*}(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7ubjI)}(hbioh]hbio}(hj7hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj7ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj7ubah}(h]h ]h"]h$]h&]j`jauh1j<hje7hhhjw7hM;ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhja7hhhjw7hM;ubah}(h]j\7ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjw7hM;hj^7hhubjw)}(hhh]h)}(hend I/O on a bioh]hend I/O on a bio}(hj)8hhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chM;hj&8hhubah}(h]h ]h"]h$]h&]uh1jvhj^7hhhjw7hM;ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjA8jjA8jjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``struct bio *bio`` bio **Description** bio_endio() will end I/O on the whole bio. bio_endio() is the preferred way to end I/O on a bio. No one should call bi_end_io() directly on a bio unless they own it and thus know that it has an end_io function. bio_endio() can be called several times on a bio that has been chained using bio_chain(). The ->bi_end_io() function will only be called the last time.h](h)}(h**Parameters**h]j)}(hjK8h]h Parameters}(hjM8hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjI8ubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chM?hjE8ubj)}(hhh]j)}(h``struct bio *bio`` bio h](j)}(h``struct bio *bio``h]j)}(hjj8h]hstruct bio *bio}(hjl8hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjh8ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chM<hjd8ubj)}(hhh]h)}(hbioh]hbio}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj8hM<hj8ubah}(h]h ]h"]h$]h&]uh1jhjd8ubeh}(h]h ]h"]h$]h&]uh1jhj8hM<hja8ubah}(h]h ]h"]h$]h&]uh1jhjE8ubh)}(h**Description**h]j)}(hj8h]h Description}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj8ubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chM>hjE8ubj)}(hXlbio_endio() will end I/O on the whole bio. bio_endio() is the preferred way to end I/O on a bio. No one should call bi_end_io() directly on a bio unless they own it and thus know that it has an end_io function. bio_endio() can be called several times on a bio that has been chained using bio_chain(). The ->bi_end_io() function will only be called the last time.h](h)}(hbio_endio() will end I/O on the whole bio. bio_endio() is the preferred way to end I/O on a bio. No one should call bi_end_io() directly on a bio unless they own it and thus know that it has an end_io function.h]hbio_endio() will end I/O on the whole bio. bio_endio() is the preferred way to end I/O on a bio. No one should call bi_end_io() directly on a bio unless they own it and thus know that it has an end_io function.}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chM>hj8ubh)}(hbio_endio() can be called several times on a bio that has been chained using bio_chain(). The ->bi_end_io() function will only be called the last time.h]hbio_endio() can be called several times on a bio that has been chained using bio_chain(). The ->bi_end_io() function will only be called the last time.}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMBhj8ubeh}(h]h ]h"]h$]h&]uh1jhj8hM>hjE8ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j bio_split (C function) c.bio_splithNtauh1hhjOghhhNhNubj)}(hhh](j)}(hTstruct bio * bio_split (struct bio *bio, int sectors, gfp_t gfp, struct bio_set *bs)h]j)}(hRstruct bio *bio_split(struct bio *bio, int sectors, gfp_t gfp, struct bio_set *bs)h](j )}(hjh]hstruct}(hj9hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj8hhhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMyubj2)}(h h]h }(hj9hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj8hhhj9hMyubh)}(hhh]jI)}(hbioh]hbio}(hj"9hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj9ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj$9modnameN classnameNjj )}j ]j)}j bio_splitsb c.bio_splitasbuh1hhj8hhhj9hMyubj2)}(h h]h }(hjC9hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj8hhhj9hMyubj)}(hjh]h*}(hjQ9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj8hhhj9hMyubjC)}(h bio_splith]jI)}(hj@9h]h bio_split}(hjb9hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj^9ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj8hhhj9hMyubj=)}(h=(struct bio *bio, int sectors, gfp_t gfp, struct bio_set *bs)h](jC)}(hstruct bio *bioh](j )}(hjh]hstruct}(hj}9hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjy9ubj2)}(h h]h }(hj9hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjy9ubh)}(hhh]jI)}(hbioh]hbio}(hj9hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj9ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj9modnameN classnameNjj )}j ]j>9 c.bio_splitasbuh1hhjy9ubj2)}(h h]h }(hj9hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjy9ubj)}(hjh]h*}(hj9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjy9ubjI)}(hbioh]hbio}(hj9hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjy9ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhju9ubjC)}(h int sectorsh](j)}(hinth]hint}(hj9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9ubj2)}(h h]h }(hj9hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj9ubjI)}(hsectorsh]hsectors}(hj :hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj9ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhju9ubjC)}(h gfp_t gfph](h)}(hhh]jI)}(hgfp_th]hgfp_t}(hj%:hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj":ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj':modnameN classnameNjj )}j ]j>9 c.bio_splitasbuh1hhj:ubj2)}(h h]h }(hjC:hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj:ubjI)}(hgfph]hgfp}(hjQ:hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj:ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhju9ubjC)}(hstruct bio_set *bsh](j )}(hjh]hstruct}(hjj:hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjf:ubj2)}(h h]h }(hjw:hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjf:ubh)}(hhh]jI)}(hbio_seth]hbio_set}(hj:hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj:ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj:modnameN classnameNjj )}j ]j>9 c.bio_splitasbuh1hhjf:ubj2)}(h h]h }(hj:hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjf:ubj)}(hjh]h*}(hj:hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjf:ubjI)}(hbsh]hbs}(hj:hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjf:ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhju9ubeh}(h]h ]h"]h$]h&]j`jauh1j<hj8hhhj9hMyubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj8hhhj9hMyubah}(h]j8ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj9hMyhj8hhubjw)}(hhh]h)}(h split a bioh]h split a bio}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMyhj:hhubah}(h]h ]h"]h$]h&]uh1jvhj8hhhj9hMyubeh}(h]h ](jfunctioneh"]h$]h&]jjjj;jj;jjjuh1jhhhjOghNhNubj)}(hX2**Parameters** ``struct bio *bio`` bio to split ``int sectors`` number of sectors to split from the front of **bio** ``gfp_t gfp`` gfp mask ``struct bio_set *bs`` bio set to allocate from **Description** Allocates and returns a new bio which represents **sectors** from the start of **bio**, and updates **bio** to represent the remaining sectors. Unless this is a discard request the newly allocated bio will point to **bio**'s bi_io_vec. It is the caller's responsibility to ensure that neither **bio** nor **bs** are freed before the split bio.h](h)}(h**Parameters**h]j)}(hj ;h]h Parameters}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ;ubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chM}hj;ubj)}(hhh](j)}(h!``struct bio *bio`` bio to split h](j)}(h``struct bio *bio``h]j)}(hj,;h]hstruct bio *bio}(hj.;hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj*;ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMzhj&;ubj)}(hhh]h)}(h bio to splith]h bio to split}(hjE;hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjA;hMzhjB;ubah}(h]h ]h"]h$]h&]uh1jhj&;ubeh}(h]h ]h"]h$]h&]uh1jhjA;hMzhj#;ubj)}(hE``int sectors`` number of sectors to split from the front of **bio** h](j)}(h``int sectors``h]j)}(hje;h]h int sectors}(hjg;hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjc;ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chM{hj_;ubj)}(hhh]h)}(h4number of sectors to split from the front of **bio**h](h-number of sectors to split from the front of }(hj~;hhhNhNubj)}(h**bio**h]hbio}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj~;ubeh}(h]h ]h"]h$]h&]uh1hhjz;hM{hj{;ubah}(h]h ]h"]h$]h&]uh1jhj_;ubeh}(h]h ]h"]h$]h&]uh1jhjz;hM{hj#;ubj)}(h``gfp_t gfp`` gfp mask h](j)}(h ``gfp_t gfp``h]j)}(hj;h]h gfp_t gfp}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj;ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chM|hj;ubj)}(hhh]h)}(hgfp maskh]hgfp mask}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj;hM|hj;ubah}(h]h ]h"]h$]h&]uh1jhj;ubeh}(h]h ]h"]h$]h&]uh1jhj;hM|hj#;ubj)}(h0``struct bio_set *bs`` bio set to allocate from h](j)}(h``struct bio_set *bs``h]j)}(hj;h]hstruct bio_set *bs}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj;ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chM}hj;ubj)}(hhh]h)}(hbio set to allocate fromh]hbio set to allocate from}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj;hM}hj;ubah}(h]h ]h"]h$]h&]uh1jhj;ubeh}(h]h ]h"]h$]h&]uh1jhj;hM}hj#;ubeh}(h]h ]h"]h$]h&]uh1jhj;ubh)}(h**Description**h]j)}(hj <h]h Description}(hj"<hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj<ubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhj;ubh)}(hAllocates and returns a new bio which represents **sectors** from the start of **bio**, and updates **bio** to represent the remaining sectors.h](h1Allocates and returns a new bio which represents }(hj6<hhhNhNubj)}(h **sectors**h]hsectors}(hj><hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj6<ubh from the start of }(hj6<hhhNhNubj)}(h**bio**h]hbio}(hjP<hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj6<ubh, and updates }(hj6<hhhNhNubj)}(h**bio**h]hbio}(hjb<hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj6<ubh$ to represent the remaining sectors.}(hj6<hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chM~hj;ubh)}(hUnless this is a discard request the newly allocated bio will point to **bio**'s bi_io_vec. It is the caller's responsibility to ensure that neither **bio** nor **bs** are freed before the split bio.h](hGUnless this is a discard request the newly allocated bio will point to }(hj{<hhhNhNubj)}(h**bio**h]hbio}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj{<ubhK’s bi_io_vec. It is the caller’s responsibility to ensure that neither }(hj{<hhhNhNubj)}(h**bio**h]hbio}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj{<ubh nor }(hj{<hhhNhNubj)}(h**bs**h]hbs}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj{<ubh are freed before the split bio.}(hj{<hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhj;ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j bio_trim (C function) c.bio_trimhNtauh1hhjOghhhNhNubj)}(hhh](j)}(h?void bio_trim (struct bio *bio, sector_t offset, sector_t size)h]j)}(h>void bio_trim(struct bio *bio, sector_t offset, sector_t size)h](j)}(hvoidh]hvoid}(hj<hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj<hhhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMubj2)}(h h]h }(hj<hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj<hhhj<hMubjC)}(hbio_trimh]jI)}(hbio_trimh]hbio_trim}(hj=hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj<ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj<hhhj<hMubj=)}(h1(struct bio *bio, sector_t offset, sector_t size)h](jC)}(hstruct bio *bioh](j )}(hjh]hstruct}(hj=hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj=ubj2)}(h h]h }(hj*=hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj=ubh)}(hhh]jI)}(hbioh]hbio}(hj;=hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj8=ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj==modnameN classnameNjj )}j ]j)}jj=sb c.bio_trimasbuh1hhj=ubj2)}(h h]h }(hj[=hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj=ubj)}(hjh]h*}(hji=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=ubjI)}(hbioh]hbio}(hjv=hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj=ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj=ubjC)}(hsector_t offseth](h)}(hhh]jI)}(hsector_th]hsector_t}(hj=hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj=ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj=modnameN classnameNjj )}j ]jW= c.bio_trimasbuh1hhj=ubj2)}(h h]h }(hj=hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj=ubjI)}(hoffseth]hoffset}(hj=hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj=ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj=ubjC)}(h sector_t sizeh](h)}(hhh]jI)}(hsector_th]hsector_t}(hj=hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj=ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj=modnameN classnameNjj )}j ]jW= c.bio_trimasbuh1hhj=ubj2)}(h h]h }(hj=hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj=ubjI)}(hsizeh]hsize}(hj>hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj=ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj=ubeh}(h]h ]h"]h$]h&]j`jauh1j<hj<hhhj<hMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj<hhhj<hMubah}(h]j<ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj<hMhj<hhubjw)}(hhh]h)}(h trim a bioh]h trim a bio}(hj0>hhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhj->hhubah}(h]h ]h"]h$]h&]uh1jvhj<hhhj<hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjH>jjH>jjjuh1jhhhjOghNhNubj)}(hX9**Parameters** ``struct bio *bio`` bio to trim ``sector_t offset`` number of sectors to trim from the front of **bio** ``sector_t size`` size we want to trim **bio** to, in sectors **Description** This function is typically used for bios that are cloned and submitted to the underlying device in parts.h](h)}(h**Parameters**h]j)}(hjR>h]h Parameters}(hjT>hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjP>ubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhjL>ubj)}(hhh](j)}(h ``struct bio *bio`` bio to trim h](j)}(h``struct bio *bio``h]j)}(hjq>h]hstruct bio *bio}(hjs>hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjo>ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhjk>ubj)}(hhh]h)}(h bio to trimh]h bio to trim}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj>hMhj>ubah}(h]h ]h"]h$]h&]uh1jhjk>ubeh}(h]h ]h"]h$]h&]uh1jhj>hMhjh>ubj)}(hH``sector_t offset`` number of sectors to trim from the front of **bio** h](j)}(h``sector_t offset``h]j)}(hj>h]hsector_t offset}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj>ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhj>ubj)}(hhh]h)}(h3number of sectors to trim from the front of **bio**h](h,number of sectors to trim from the front of }(hj>hhhNhNubj)}(h**bio**h]hbio}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj>ubeh}(h]h ]h"]h$]h&]uh1hhj>hMhj>ubah}(h]h ]h"]h$]h&]uh1jhj>ubeh}(h]h ]h"]h$]h&]uh1jhj>hMhjh>ubj)}(h>``sector_t size`` size we want to trim **bio** to, in sectors h](j)}(h``sector_t size``h]j)}(hj>h]h sector_t size}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj>ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhj>ubj)}(hhh]h)}(h+size we want to trim **bio** to, in sectorsh](hsize we want to trim }(hj ?hhhNhNubj)}(h**bio**h]hbio}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ?ubh to, in sectors}(hj ?hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj?hMhj?ubah}(h]h ]h"]h$]h&]uh1jhj>ubeh}(h]h ]h"]h$]h&]uh1jhj?hMhjh>ubeh}(h]h ]h"]h$]h&]uh1jhjL>ubh)}(h**Description**h]j)}(hj>?h]h Description}(hj@?hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh)}(hiThis function is typically used for bios that are cloned and submitted to the underlying device in parts.h]hiThis function is typically used for bios that are cloned and submitted to the underlying device in parts.}(hjT?hhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhjL>ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j bioset_init (C function) c.bioset_inithNtauh1hhjOghhhNhNubj)}(hhh](j)}(h_int bioset_init (struct bio_set *bs, unsigned int pool_size, unsigned int front_pad, int flags)h]j)}(h^int bioset_init(struct bio_set *bs, unsigned int pool_size, unsigned int front_pad, int flags)h](j)}(hinth]hint}(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?hhhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMubj2)}(h h]h }(hj?hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj?hhhj?hMubjC)}(h bioset_inith]jI)}(h bioset_inith]h bioset_init}(hj?hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj?ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj?hhhj?hMubj=)}(hO(struct bio_set *bs, unsigned int pool_size, unsigned int front_pad, int flags)h](jC)}(hstruct bio_set *bsh](j )}(hjh]hstruct}(hj?hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj?ubj2)}(h h]h }(hj?hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj?ubh)}(hhh]jI)}(hbio_seth]hbio_set}(hj?hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj?ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj?modnameN classnameNjj )}j ]j)}jj?sb c.bioset_initasbuh1hhj?ubj2)}(h h]h }(hj?hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj?ubj)}(hjh]h*}(hj @hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?ubjI)}(hbsh]hbs}(hj@hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj?ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj?ubjC)}(hunsigned int pool_sizeh](j)}(hunsignedh]hunsigned}(hj2@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj.@ubj2)}(h h]h }(hj@@hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj.@ubj)}(hinth]hint}(hjN@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj.@ubj2)}(h h]h }(hj\@hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj.@ubjI)}(h pool_sizeh]h pool_size}(hjj@hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj.@ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj?ubjC)}(hunsigned int front_padh](j)}(hunsignedh]hunsigned}(hj@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@ubj2)}(h h]h }(hj@hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj@ubj)}(hinth]hint}(hj@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@ubj2)}(h h]h }(hj@hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj@ubjI)}(h front_padh]h front_pad}(hj@hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj@ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj?ubjC)}(h int flagsh](j)}(hinth]hint}(hj@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@ubj2)}(h h]h }(hj@hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj@ubjI)}(hflagsh]hflags}(hj@hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj@ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj?ubeh}(h]h ]h"]h$]h&]j`jauh1j<hj?hhhj?hMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj{?hhhj?hMubah}(h]jv?ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj?hMhjx?hhubjw)}(hhh]h)}(hInitialize a bio_seth]hInitialize a bio_set}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhjAhhubah}(h]h ]h"]h$]h&]uh1jvhjx?hhhj?hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjj2Ajj2Ajjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``struct bio_set *bs`` pool to initialize ``unsigned int pool_size`` Number of bio and bio_vecs to cache in the mempool ``unsigned int front_pad`` Number of bytes to allocate in front of the returned bio ``int flags`` Flags to modify behavior, currently ``BIOSET_NEED_BVECS`` and ``BIOSET_NEED_RESCUER`` **Description** Set up a bio_set to be used with **bio_alloc_bioset**. Allows the caller to ask for a number of bytes to be allocated in front of the bio. Front pad allocation is useful for embedding the bio inside another structure, to avoid allocating extra data to go with the bio. Note that the bio must be embedded at the END of that structure always, or things will break badly. If ``BIOSET_NEED_BVECS`` is set in **flags**, a separate pool will be allocated for allocating iovecs. This pool is not needed e.g. for bio_init_clone(). If ``BIOSET_NEED_RESCUER`` is set, a workqueue is created which can be used to dispatch queued requests when the mempool runs out of space.h](h)}(h**Parameters**h]j)}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj:Aubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhj6Aubj)}(hhh](j)}(h*``struct bio_set *bs`` pool to initialize h](j)}(h``struct bio_set *bs``h]j)}(hj[Ah]hstruct bio_set *bs}(hj]AhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjYAubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhjUAubj)}(hhh]h)}(hpool to initializeh]hpool to initialize}(hjtAhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjpAhMhjqAubah}(h]h ]h"]h$]h&]uh1jhjUAubeh}(h]h ]h"]h$]h&]uh1jhjpAhMhjRAubj)}(hN``unsigned int pool_size`` Number of bio and bio_vecs to cache in the mempool h](j)}(h``unsigned int pool_size``h]j)}(hjAh]hunsigned int pool_size}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjAubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhjAubj)}(hhh]h)}(h2Number of bio and bio_vecs to cache in the mempoolh]h2Number of bio and bio_vecs to cache in the mempool}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjAhMhjAubah}(h]h ]h"]h$]h&]uh1jhjAubeh}(h]h ]h"]h$]h&]uh1jhjAhMhjRAubj)}(hT``unsigned int front_pad`` Number of bytes to allocate in front of the returned bio h](j)}(h``unsigned int front_pad``h]j)}(hjAh]hunsigned int front_pad}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjAubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhjAubj)}(hhh]h)}(h8Number of bytes to allocate in front of the returned bioh]h8Number of bytes to allocate in front of the returned bio}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjAhMhjAubah}(h]h ]h"]h$]h&]uh1jhjAubeh}(h]h ]h"]h$]h&]uh1jhjAhMhjRAubj)}(hd``int flags`` Flags to modify behavior, currently ``BIOSET_NEED_BVECS`` and ``BIOSET_NEED_RESCUER`` h](j)}(h ``int flags``h]j)}(hjBh]h int flags}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjBubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhjBubj)}(hhh]h)}(hUFlags to modify behavior, currently ``BIOSET_NEED_BVECS`` and ``BIOSET_NEED_RESCUER``h](h$Flags to modify behavior, currently }(hjBhhhNhNubj)}(h``BIOSET_NEED_BVECS``h]hBIOSET_NEED_BVECS}(hj'BhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjBubh and }(hjBhhhNhNubj)}(h``BIOSET_NEED_RESCUER``h]hBIOSET_NEED_RESCUER}(hj9BhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjBubeh}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhjBubah}(h]h ]h"]h$]h&]uh1jhjBubeh}(h]h ]h"]h$]h&]uh1jhjBhMhjRAubeh}(h]h ]h"]h$]h&]uh1jhj6Aubh)}(h**Description**h]j)}(hjbBh]h Description}(hjdBhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj`Bubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhj6Aubj)}(hXSet up a bio_set to be used with **bio_alloc_bioset**. Allows the caller to ask for a number of bytes to be allocated in front of the bio. Front pad allocation is useful for embedding the bio inside another structure, to avoid allocating extra data to go with the bio. Note that the bio must be embedded at the END of that structure always, or things will break badly. If ``BIOSET_NEED_BVECS`` is set in **flags**, a separate pool will be allocated for allocating iovecs. This pool is not needed e.g. for bio_init_clone(). If ``BIOSET_NEED_RESCUER`` is set, a workqueue is created which can be used to dispatch queued requests when the mempool runs out of space.h]h)}(hXSet up a bio_set to be used with **bio_alloc_bioset**. Allows the caller to ask for a number of bytes to be allocated in front of the bio. Front pad allocation is useful for embedding the bio inside another structure, to avoid allocating extra data to go with the bio. Note that the bio must be embedded at the END of that structure always, or things will break badly. If ``BIOSET_NEED_BVECS`` is set in **flags**, a separate pool will be allocated for allocating iovecs. This pool is not needed e.g. for bio_init_clone(). If ``BIOSET_NEED_RESCUER`` is set, a workqueue is created which can be used to dispatch queued requests when the mempool runs out of space.h](h!Set up a bio_set to be used with }(hj|BhhhNhNubj)}(h**bio_alloc_bioset**h]hbio_alloc_bioset}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj|BubhX?. Allows the caller to ask for a number of bytes to be allocated in front of the bio. Front pad allocation is useful for embedding the bio inside another structure, to avoid allocating extra data to go with the bio. Note that the bio must be embedded at the END of that structure always, or things will break badly. If }(hj|BhhhNhNubj)}(h``BIOSET_NEED_BVECS``h]hBIOSET_NEED_BVECS}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj|Bubh is set in }(hj|BhhhNhNubj)}(h **flags**h]hflags}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj|Bubhr, a separate pool will be allocated for allocating iovecs. This pool is not needed e.g. for bio_init_clone(). If }(hj|BhhhNhNubj)}(h``BIOSET_NEED_RESCUER``h]hBIOSET_NEED_RESCUER}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj|Bubhq is set, a workqueue is created which can be used to dispatch queued requests when the mempool runs out of space.}(hj|BhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:62: ./block/bio.chMhjxBubah}(h]h ]h"]h$]h&]uh1jhjBhMhj6Aubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j seq_open (C function) c.seq_openhNtauh1hhjOghhhNhNubj)}(hhh](j)}(hAint seq_open (struct file *file, const struct seq_operations *op)h]j)}(h@int seq_open(struct file *file, const struct seq_operations *op)h](j)}(hinth]hint}(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBhhhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chK+ubj2)}(h h]h }(hjChhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjBhhhjChK+ubjC)}(hseq_openh]jI)}(hseq_openh]hseq_open}(hjChhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjCubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjBhhhjChK+ubj=)}(h4(struct file *file, const struct seq_operations *op)h](jC)}(hstruct file *fileh](j )}(hjh]hstruct}(hj6ChhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj2Cubj2)}(h h]h }(hjCChhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj2Cubh)}(hhh]jI)}(hfileh]hfile}(hjTChhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjQCubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjVCmodnameN classnameNjj )}j ]j)}jjCsb c.seq_openasbuh1hhj2Cubj2)}(h h]h }(hjtChhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj2Cubj)}(hjh]h*}(hjChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2CubjI)}(hfileh]hfile}(hjChhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj2Cubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj.CubjC)}(hconst struct seq_operations *oph](j )}(hjJh]hconst}(hjChhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjCubj2)}(h h]h }(hjChhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjCubj )}(hjh]hstruct}(hjChhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjCubj2)}(h h]h }(hjChhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjCubh)}(hhh]jI)}(hseq_operationsh]hseq_operations}(hjChhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjCubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjCmodnameN classnameNjj )}j ]jpC c.seq_openasbuh1hhjCubj2)}(h h]h }(hjChhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjCubj)}(hjh]h*}(hj DhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCubjI)}(hoph]hop}(hjDhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjCubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj.Cubeh}(h]h ]h"]h$]h&]j`jauh1j<hjBhhhjChK+ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjBhhhjChK+ubah}(h]jBah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjChK+hjBhhubjw)}(hhh]h)}(hinitialize sequential fileh]hinitialize sequential file}(hjDDhhhNhNubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chK+hjADhhubah}(h]h ]h"]h$]h&]uh1jvhjBhhhjChK+ubeh}(h]h ](jfunctioneh"]h$]h&]jjjj\Djj\Djjjuh1jhhhjOghNhNubj)}(hXs**Parameters** ``struct file *file`` file we initialize ``const struct seq_operations *op`` method table describing the sequence **Description** seq_open() sets **file**, associating it with a sequence described by **op**. **op->start\(\)** sets the iterator up and returns the first element of sequence. **op->stop\(\)** shuts it down. **op->next\(\)** returns the next element of sequence. **op->show\(\)** prints element into the buffer. In case of error ->start() and ->next() return ERR_PTR(error). In the end of sequence they return ``NULL``. ->show() returns 0 in case of success and negative number in case of error. Returning SEQ_SKIP means "discard this element and move on". **Note** seq_open() will allocate a struct seq_file and store its pointer in **file->private_data**. This pointer should not be modified.h](h)}(h**Parameters**h]j)}(hjfDh]h Parameters}(hjhDhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjdDubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chK/hj`Dubj)}(hhh](j)}(h)``struct file *file`` file we initialize h](j)}(h``struct file *file``h]j)}(hjDh]hstruct file *file}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjDubah}(h]h ]h"]h$]h&]uh1jhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chK,hjDubj)}(hhh]h)}(hfile we initializeh]hfile we initialize}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjDhK,hjDubah}(h]h ]h"]h$]h&]uh1jhjDubeh}(h]h ]h"]h$]h&]uh1jhjDhK,hj|Dubj)}(hI``const struct seq_operations *op`` method table describing the sequence h](j)}(h#``const struct seq_operations *op``h]j)}(hjDh]hconst struct seq_operations *op}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjDubah}(h]h ]h"]h$]h&]uh1jhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chK-hjDubj)}(hhh]h)}(h$method table describing the sequenceh]h$method table describing the sequence}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjDhK-hjDubah}(h]h ]h"]h$]h&]uh1jhjDubeh}(h]h ]h"]h$]h&]uh1jhjDhK-hj|Dubeh}(h]h ]h"]h$]h&]uh1jhj`Dubh)}(h**Description**h]j)}(hjDh]h Description}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjDubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chK/hj`Dubj)}(hX"seq_open() sets **file**, associating it with a sequence described by **op**. **op->start\(\)** sets the iterator up and returns the first element of sequence. **op->stop\(\)** shuts it down. **op->next\(\)** returns the next element of sequence. **op->show\(\)** prints element into the buffer. In case of error ->start() and ->next() return ERR_PTR(error). In the end of sequence they return ``NULL``. ->show() returns 0 in case of success and negative number in case of error. Returning SEQ_SKIP means "discard this element and move on". h]h)}(hX!seq_open() sets **file**, associating it with a sequence described by **op**. **op->start\(\)** sets the iterator up and returns the first element of sequence. **op->stop\(\)** shuts it down. **op->next\(\)** returns the next element of sequence. **op->show\(\)** prints element into the buffer. In case of error ->start() and ->next() return ERR_PTR(error). In the end of sequence they return ``NULL``. ->show() returns 0 in case of success and negative number in case of error. Returning SEQ_SKIP means "discard this element and move on".h](hseq_open() sets }(hjEhhhNhNubj)}(h**file**h]hfile}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjEubh., associating it with a sequence described by }(hjEhhhNhNubj)}(h**op**h]hop}(hj-EhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjEubh. }(hjEhhhNhNubj)}(h**op->start\(\)**h]h op->start()}(hj?EhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjEubhA sets the iterator up and returns the first element of sequence. }(hjEhhhNhNubj)}(h**op->stop\(\)**h]h op->stop()}(hjQEhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjEubh shuts it down. }(hjEhhhNhNubj)}(h**op->next\(\)**h]h op->next()}(hjcEhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjEubh( returns the next element of sequence. }(hjEhhhNhNubj)}(h**op->show\(\)**h]h op->show()}(hjuEhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjEubh prints element into the buffer. In case of error ->start() and ->next() return ERR_PTR(error). In the end of sequence they return }(hjEhhhNhNubj)}(h``NULL``h]hNULL}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjEubh. ->show() returns 0 in case of success and negative number in case of error. Returning SEQ_SKIP means “discard this element and move on”.}(hjEhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chK.hjEubah}(h]h ]h"]h$]h&]uh1jhjEhK.hj`Dubh)}(h**Note**h]j)}(hjEh]hNote}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjEubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chK7hj`Dubj)}(hhh]j)}(hseq_open() will allocate a struct seq_file and store its pointer in **file->private_data**. This pointer should not be modified.h](j)}(h8seq_open() will allocate a struct seq_file and store itsh]h8seq_open() will allocate a struct seq_file and store its}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chK7hjEubj)}(hhh]h)}(hGpointer in **file->private_data**. This pointer should not be modified.h](h pointer in }(hjEhhhNhNubj)}(h**file->private_data**h]hfile->private_data}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjEubh&. This pointer should not be modified.}(hjEhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chK8hjEubah}(h]h ]h"]h$]h&]uh1jhjEubeh}(h]h ]h"]h$]h&]uh1jhjEhK7hjEubah}(h]h ]h"]h$]h&]uh1jhj`Dubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j seq_read (C function) c.seq_readhNtauh1hhjOghhhNhNubj)}(hhh](j)}(hQssize_t seq_read (struct file *file, char __user *buf, size_t size, loff_t *ppos)h]j)}(hPssize_t seq_read(struct file *file, char __user *buf, size_t size, loff_t *ppos)h](h)}(hhh]jI)}(hssize_th]hssize_t}(hj-FhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj*Fubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj/FmodnameN classnameNjj )}j ]j)}jseq_readsb c.seq_readasbuh1hhj&FhhhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chKubj2)}(h h]h }(hjOFhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj&FhhhjNFhKubjC)}(hseq_readh]jI)}(hjKFh]hseq_read}(hjaFhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj]Fubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj&FhhhjNFhKubj=)}(h@(struct file *file, char __user *buf, size_t size, loff_t *ppos)h](jC)}(hstruct file *fileh](j )}(hjh]hstruct}(hj|FhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjxFubj2)}(h h]h }(hjFhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjxFubh)}(hhh]jI)}(hfileh]hfile}(hjFhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjFubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjFmodnameN classnameNjj )}j ]jIF c.seq_readasbuh1hhjxFubj2)}(h h]h }(hjFhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjxFubj)}(hjh]h*}(hjFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjxFubjI)}(hfileh]hfile}(hjFhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjxFubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjtFubjC)}(hchar __user *bufh](j)}(hcharh]hchar}(hjFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFubj2)}(h h]h }(hjFhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjFubh__user}(hjFhhhNhNubj2)}(h h]h }(hj GhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjFubj)}(hjh]h*}(hjGhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFubjI)}(hbufh]hbuf}(hj'GhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjFubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjtFubjC)}(h size_t sizeh](h)}(hhh]jI)}(hsize_th]hsize_t}(hjCGhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj@Gubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjEGmodnameN classnameNjj )}j ]jIF c.seq_readasbuh1hhjah"]h$]h&]uh1j1hjah"]h$]h&]uh1j1hjGubj)}(hjh]h*}(hjGhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGubjI)}(hpposh]hppos}(hjGhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjGubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjtFubeh}(h]h ]h"]h$]h&]j`jauh1j<hj&FhhhjNFhKubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj"FhhhjNFhKubah}(h]jFah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjNFhKhjFhhubjw)}(hhh]h)}(h%->read() method for sequential files.h]h%->read() method for sequential files.}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chKhjGhhubah}(h]h ]h"]h$]h&]uh1jvhjFhhhjNFhKubeh}(h]h ](jfunctioneh"]h$]h&]jjjjHjjHjjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``struct file *file`` the file to read from ``char __user *buf`` the buffer to read to ``size_t size`` the maximum number of bytes to read ``loff_t *ppos`` the current position in the file **Description** Ready-made ->f_op->read()h](h)}(h**Parameters**h]j)}(hjHh]h Parameters}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjHubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chKhj Hubj)}(hhh](j)}(h,``struct file *file`` the file to read from h](j)}(h``struct file *file``h]j)}(hj/Hh]hstruct file *file}(hj1HhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj-Hubah}(h]h ]h"]h$]h&]uh1jhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chKhj)Hubj)}(hhh]h)}(hthe file to read fromh]hthe file to read from}(hjHHhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjDHhKhjEHubah}(h]h ]h"]h$]h&]uh1jhj)Hubeh}(h]h ]h"]h$]h&]uh1jhjDHhKhj&Hubj)}(h+``char __user *buf`` the buffer to read to h](j)}(h``char __user *buf``h]j)}(hjhHh]hchar __user *buf}(hjjHhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjfHubah}(h]h ]h"]h$]h&]uh1jhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chKhjbHubj)}(hhh]h)}(hthe buffer to read toh]hthe buffer to read to}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj}HhKhj~Hubah}(h]h ]h"]h$]h&]uh1jhjbHubeh}(h]h ]h"]h$]h&]uh1jhj}HhKhj&Hubj)}(h4``size_t size`` the maximum number of bytes to read h](j)}(h``size_t size``h]j)}(hjHh]h size_t size}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjHubah}(h]h ]h"]h$]h&]uh1jhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chKhjHubj)}(hhh]h)}(h#the maximum number of bytes to readh]h#the maximum number of bytes to read}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjHhKhjHubah}(h]h ]h"]h$]h&]uh1jhjHubeh}(h]h ]h"]h$]h&]uh1jhjHhKhj&Hubj)}(h2``loff_t *ppos`` the current position in the file h](j)}(h``loff_t *ppos``h]j)}(hjHh]h loff_t *ppos}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjHubah}(h]h ]h"]h$]h&]uh1jhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chKhjHubj)}(hhh]h)}(h the current position in the fileh]h the current position in the file}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjHhKhjHubah}(h]h ]h"]h$]h&]uh1jhjHubeh}(h]h ]h"]h$]h&]uh1jhjHhKhj&Hubeh}(h]h ]h"]h$]h&]uh1jhj Hubh)}(h**Description**h]j)}(hjIh]h Description}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjIubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chKhj Hubj)}(hReady-made ->f_op->read()h]h)}(hj-Ih]hReady-made ->f_op->read()}(hj/IhhhNhNubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chKhj+Iubah}(h]h ]h"]h$]h&]uh1jhjloff_t seq_lseek(struct file *file, loff_t offset, int whence)h](h)}(hhh]jI)}(hloff_th]hloff_t}(hjfIhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjcIubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjhImodnameN classnameNjj )}j ]j)}j seq_lseeksb c.seq_lseekasbuh1hhj_IhhhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chM.ubj2)}(h h]h }(hjIhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj_IhhhjIhM.ubjC)}(h seq_lseekh]jI)}(hjIh]h seq_lseek}(hjIhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjIubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj_IhhhjIhM.ubj=)}(h.(struct file *file, loff_t offset, int whence)h](jC)}(hstruct file *fileh](j )}(hjh]hstruct}(hjIhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjIubj2)}(h h]h }(hjIhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjIubh)}(hhh]jI)}(hfileh]hfile}(hjIhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjIubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjImodnameN classnameNjj )}j ]jI c.seq_lseekasbuh1hhjIubj2)}(h h]h }(hjIhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjIubj)}(hjh]h*}(hjIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIubjI)}(hfileh]hfile}(hj JhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjIubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjIubjC)}(h loff_t offseth](h)}(hhh]jI)}(hloff_th]hloff_t}(hj(JhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj%Jubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj*JmodnameN classnameNjj )}j ]jI c.seq_lseekasbuh1hhj!Jubj2)}(h h]h }(hjFJhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj!JubjI)}(hoffseth]hoffset}(hjTJhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj!Jubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjIubjC)}(h int whenceh](j)}(hinth]hint}(hjmJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjiJubj2)}(h h]h }(hj{JhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjiJubjI)}(hwhenceh]hwhence}(hjJhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjiJubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjIubeh}(h]h ]h"]h$]h&]j`jauh1j<hj_IhhhjIhM.ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj[IhhhjIhM.ubah}(h]jVIah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjIhM.hjXIhhubjw)}(hhh]h)}(h'->llseek() method for sequential files.h]h'->llseek() method for sequential files.}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chM.hjJhhubah}(h]h ]h"]h$]h&]uh1jvhjXIhhhjIhM.ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjJjjJjjjuh1jhhhjOghNhNubj)}(h**Parameters** ``struct file *file`` the file in question ``loff_t offset`` new position ``int whence`` 0 for absolute, 1 for relative position **Description** Ready-made ->f_op->llseek()h](h)}(h**Parameters**h]j)}(hjJh]h Parameters}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjJubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chM2hjJubj)}(hhh](j)}(h+``struct file *file`` the file in question h](j)}(h``struct file *file``h]j)}(hjJh]hstruct file *file}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjJubah}(h]h ]h"]h$]h&]uh1jhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chM/hjJubj)}(hhh]h)}(hthe file in questionh]hthe file in question}(hj KhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj KhM/hj Kubah}(h]h ]h"]h$]h&]uh1jhjJubeh}(h]h ]h"]h$]h&]uh1jhj KhM/hjJubj)}(h``loff_t offset`` new position h](j)}(h``loff_t offset``h]j)}(hj-Kh]h loff_t offset}(hj/KhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj+Kubah}(h]h ]h"]h$]h&]uh1jhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chM0hj'Kubj)}(hhh]h)}(h new positionh]h new position}(hjFKhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjBKhM0hjCKubah}(h]h ]h"]h$]h&]uh1jhj'Kubeh}(h]h ]h"]h$]h&]uh1jhjBKhM0hjJubj)}(h7``int whence`` 0 for absolute, 1 for relative position h](j)}(h``int whence``h]j)}(hjfKh]h int whence}(hjhKhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjdKubah}(h]h ]h"]h$]h&]uh1jhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chM1hj`Kubj)}(hhh]h)}(h'0 for absolute, 1 for relative positionh]h'0 for absolute, 1 for relative position}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj{KhM1hj|Kubah}(h]h ]h"]h$]h&]uh1jhj`Kubeh}(h]h ]h"]h$]h&]uh1jhj{KhM1hjJubeh}(h]h ]h"]h$]h&]uh1jhjJubh)}(h**Description**h]j)}(hjKh]h Description}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjKubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chM3hjJubj)}(hReady-made ->f_op->llseek()h]h)}(hjKh]hReady-made ->f_op->llseek()}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chM2hjKubah}(h]h ]h"]h$]h&]uh1jhjKhM2hjJubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j seq_release (C function) c.seq_releasehNtauh1hhjOghhhNhNubj)}(hhh](j)}(h8int seq_release (struct inode *inode, struct file *file)h]j)}(h7int seq_release(struct inode *inode, struct file *file)h](j)}(hinth]hint}(hjKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjKhhhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMZubj2)}(h h]h }(hjKhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjKhhhjKhMZubjC)}(h seq_releaseh]jI)}(h seq_releaseh]h seq_release}(hjLhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj Lubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjKhhhjKhMZubj=)}(h((struct inode *inode, struct file *file)h](jC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hj,LhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj(Lubj2)}(h h]h }(hj9LhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj(Lubh)}(hhh]jI)}(hinodeh]hinode}(hjJLhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjGLubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjLLmodnameN classnameNjj )}j ]j)}jjLsb c.seq_releaseasbuh1hhj(Lubj2)}(h h]h }(hjjLhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj(Lubj)}(hjh]h*}(hjxLhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(LubjI)}(hinodeh]hinode}(hjLhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj(Lubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj$LubjC)}(hstruct file *fileh](j )}(hjh]hstruct}(hjLhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjLubj2)}(h h]h }(hjLhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjLubh)}(hhh]jI)}(hfileh]hfile}(hjLhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjLubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjLmodnameN classnameNjj )}j ]jfL c.seq_releaseasbuh1hhjLubj2)}(h h]h }(hjLhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjLubj)}(hjh]h*}(hjLhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjLubjI)}(hfileh]hfile}(hjLhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjLubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj$Lubeh}(h]h ]h"]h$]h&]j`jauh1j<hjKhhhjKhMZubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjKhhhjKhMZubah}(h]jKah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjKhMZhjKhhubjw)}(hhh]h)}(h4free the structures associated with sequential file.h]h4free the structures associated with sequential file.}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMZhjMhhubah}(h]h ]h"]h$]h&]uh1jvhjKhhhjKhMZubeh}(h]h ](jfunctioneh"]h$]h&]jjjj7Mjj7Mjjjuh1jhhhjOghNhNubj)}(h**Parameters** ``struct inode *inode`` its inode ``struct file *file`` file in question **Description** Frees the structures associated with sequential file; can be used as ->f_op->release() if you don't have private data to destroy.h](h)}(h**Parameters**h]j)}(hjAMh]h Parameters}(hjCMhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj?Mubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chM^hj;Mubj)}(hhh](j)}(h"``struct inode *inode`` its inode h](j)}(h``struct inode *inode``h]j)}(hj`Mh]hstruct inode *inode}(hjbMhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj^Mubah}(h]h ]h"]h$]h&]uh1jhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chM[hjZMubj)}(hhh]h)}(h its inodeh]h its inode}(hjyMhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjuMhM[hjvMubah}(h]h ]h"]h$]h&]uh1jhjZMubeh}(h]h ]h"]h$]h&]uh1jhjuMhM[hjWMubj)}(h'``struct file *file`` file in question h](j)}(h``struct file *file``h]j)}(hjMh]hstruct file *file}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjMubah}(h]h ]h"]h$]h&]uh1jhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chM\hjMubj)}(hhh]h)}(hfile in questionh]hfile in question}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjMhM\hjMubah}(h]h ]h"]h$]h&]uh1jhjMubeh}(h]h ]h"]h$]h&]uh1jhjMhM\hjWMubeh}(h]h ]h"]h$]h&]uh1jhj;Mubh)}(h**Description**h]j)}(hjMh]h Description}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjMubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chM^hj;Mubj)}(hFrees the structures associated with sequential file; can be used as ->f_op->release() if you don't have private data to destroy.h]h)}(hFrees the structures associated with sequential file; can be used as ->f_op->release() if you don't have private data to destroy.h]hFrees the structures associated with sequential file; can be used as ->f_op->release() if you don’t have private data to destroy.}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chM]hjMubah}(h]h ]h"]h$]h&]uh1jhjMhM]hj;Mubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j seq_escape_mem (C function)c.seq_escape_memhNtauh1hhjOghhhNhNubj)}(hhh](j)}(hjvoid seq_escape_mem (struct seq_file *m, const char *src, size_t len, unsigned int flags, const char *esc)h]j)}(hivoid seq_escape_mem(struct seq_file *m, const char *src, size_t len, unsigned int flags, const char *esc)h](j)}(hvoidh]hvoid}(hj#NhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNhhhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMkubj2)}(h h]h }(hj2NhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjNhhhj1NhMkubjC)}(hseq_escape_memh]jI)}(hseq_escape_memh]hseq_escape_mem}(hjDNhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj@Nubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjNhhhj1NhMkubj=)}(hV(struct seq_file *m, const char *src, size_t len, unsigned int flags, const char *esc)h](jC)}(hstruct seq_file *mh](j )}(hjh]hstruct}(hj`NhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj\Nubj2)}(h h]h }(hjmNhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj\Nubh)}(hhh]jI)}(hseq_fileh]hseq_file}(hj~NhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj{Nubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjNmodnameN classnameNjj )}j ]j)}jjFNsbc.seq_escape_memasbuh1hhj\Nubj2)}(h h]h }(hjNhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj\Nubj)}(hjh]h*}(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\NubjI)}(hmh]hm}(hjNhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj\Nubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjXNubjC)}(hconst char *srch](j )}(hjJh]hconst}(hjNhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjNubj2)}(h h]h }(hjNhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjNubj)}(hcharh]hchar}(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubj2)}(h h]h }(hjNhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjNubj)}(hjh]h*}(hj OhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubjI)}(hsrch]hsrc}(hjOhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjNubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjXNubjC)}(h size_t lenh](h)}(hhh]jI)}(hsize_th]hsize_t}(hj2OhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj/Oubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj4OmodnameN classnameNjj )}j ]jNc.seq_escape_memasbuh1hhj+Oubj2)}(h h]h }(hjPOhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj+OubjI)}(hlenh]hlen}(hj^OhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj+Oubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjXNubjC)}(hunsigned int flagsh](j)}(hunsignedh]hunsigned}(hjwOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjsOubj2)}(h h]h }(hjOhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjsOubj)}(hinth]hint}(hjOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjsOubj2)}(h h]h }(hjOhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjsOubjI)}(hflagsh]hflags}(hjOhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjsOubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjXNubjC)}(hconst char *esch](j )}(hjJh]hconst}(hjOhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjOubj2)}(h h]h }(hjOhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjOubj)}(hcharh]hchar}(hjOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjOubj2)}(h h]h }(hjOhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjOubj)}(hjh]h*}(hjOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjOubjI)}(hesch]hesc}(hj PhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjOubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjXNubeh}(h]h ]h"]h$]h&]j`jauh1j<hjNhhhj1NhMkubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjNhhhj1NhMkubah}(h]jNah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj1NhMkhjNhhubjw)}(hhh]h)}(h0print data into buffer, escaping some charactersh]h0print data into buffer, escaping some characters}(hj6PhhhNhNubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMkhj3Phhubah}(h]h ]h"]h$]h&]uh1jvhjNhhhj1NhMkubeh}(h]h ](jfunctioneh"]h$]h&]jjjjNPjjNPjjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``struct seq_file *m`` target buffer ``const char *src`` source buffer ``size_t len`` size of source buffer ``unsigned int flags`` flags to pass to string_escape_mem() ``const char *esc`` set of characters that need escaping **Description** Puts data into buffer, replacing each occurrence of character from given class (defined by **flags** and **esc**) with printable escaped sequence. Use seq_has_overflowed() to check for errors.h](h)}(h**Parameters**h]j)}(hjXPh]h Parameters}(hjZPhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjVPubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMohjRPubj)}(hhh](j)}(h%``struct seq_file *m`` target buffer h](j)}(h``struct seq_file *m``h]j)}(hjwPh]hstruct seq_file *m}(hjyPhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjuPubah}(h]h ]h"]h$]h&]uh1jhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMlhjqPubj)}(hhh]h)}(h target bufferh]h target buffer}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjPhMlhjPubah}(h]h ]h"]h$]h&]uh1jhjqPubeh}(h]h ]h"]h$]h&]uh1jhjPhMlhjnPubj)}(h"``const char *src`` source buffer h](j)}(h``const char *src``h]j)}(hjPh]hconst char *src}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjPubah}(h]h ]h"]h$]h&]uh1jhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMmhjPubj)}(hhh]h)}(h source bufferh]h source buffer}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjPhMmhjPubah}(h]h ]h"]h$]h&]uh1jhjPubeh}(h]h ]h"]h$]h&]uh1jhjPhMmhjnPubj)}(h%``size_t len`` size of source buffer h](j)}(h``size_t len``h]j)}(hjPh]h size_t len}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjPubah}(h]h ]h"]h$]h&]uh1jhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMnhjPubj)}(hhh]h)}(hsize of source bufferh]hsize of source buffer}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjPhMnhjPubah}(h]h ]h"]h$]h&]uh1jhjPubeh}(h]h ]h"]h$]h&]uh1jhjPhMnhjnPubj)}(h<``unsigned int flags`` flags to pass to string_escape_mem() h](j)}(h``unsigned int flags``h]j)}(hj"Qh]hunsigned int flags}(hj$QhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj Qubah}(h]h ]h"]h$]h&]uh1jhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMohjQubj)}(hhh]h)}(h$flags to pass to string_escape_mem()h]h$flags to pass to string_escape_mem()}(hj;QhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj7QhMohj8Qubah}(h]h ]h"]h$]h&]uh1jhjQubeh}(h]h ]h"]h$]h&]uh1jhj7QhMohjnPubj)}(h9``const char *esc`` set of characters that need escaping h](j)}(h``const char *esc``h]j)}(hj[Qh]hconst char *esc}(hj]QhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjYQubah}(h]h ]h"]h$]h&]uh1jhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMphjUQubj)}(hhh]h)}(h$set of characters that need escapingh]h$set of characters that need escaping}(hjtQhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjpQhMphjqQubah}(h]h ]h"]h$]h&]uh1jhjUQubeh}(h]h ]h"]h$]h&]uh1jhjpQhMphjnPubeh}(h]h ]h"]h$]h&]uh1jhjRPubh)}(h**Description**h]j)}(hjQh]h Description}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjQubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMrhjRPubh)}(hPuts data into buffer, replacing each occurrence of character from given class (defined by **flags** and **esc**) with printable escaped sequence.h](h[Puts data into buffer, replacing each occurrence of character from given class (defined by }(hjQhhhNhNubj)}(h **flags**h]hflags}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjQubh and }(hjQhhhNhNubj)}(h**esc**h]hesc}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjQubh") with printable escaped sequence.}(hjQhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMqhjRPubh)}(h-Use seq_has_overflowed() to check for errors.h]h-Use seq_has_overflowed() to check for errors.}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMthjRPubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j seq_path (C function) c.seq_pathhNtauh1hhjOghhhNhNubj)}(hhh](j)}(hKint seq_path (struct seq_file *m, const struct path *path, const char *esc)h]j)}(hJint seq_path(struct seq_file *m, const struct path *path, const char *esc)h](j)}(hinth]hint}(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj RhhhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMubj2)}(h h]h }(hjRhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj RhhhjRhMubjC)}(hseq_pathh]jI)}(hseq_pathh]hseq_path}(hj/RhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj+Rubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj RhhhjRhMubj=)}(h>(struct seq_file *m, const struct path *path, const char *esc)h](jC)}(hstruct seq_file *mh](j )}(hjh]hstruct}(hjKRhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjGRubj2)}(h h]h }(hjXRhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjGRubh)}(hhh]jI)}(hseq_fileh]hseq_file}(hjiRhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjfRubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjkRmodnameN classnameNjj )}j ]j)}jj1Rsb c.seq_pathasbuh1hhjGRubj2)}(h h]h }(hjRhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjGRubj)}(hjh]h*}(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGRubjI)}(hjNh]hm}(hjRhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjGRubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjCRubjC)}(hconst struct path *pathh](j )}(hjJh]hconst}(hjRhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjRubj2)}(h h]h }(hjRhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjRubj )}(hjh]hstruct}(hjRhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjRubj2)}(h h]h }(hjRhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjRubh)}(hhh]jI)}(hpathh]hpath}(hjRhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjRubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjRmodnameN classnameNjj )}j ]jR c.seq_pathasbuh1hhjRubj2)}(h h]h }(hjShhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjRubj)}(hjh]h*}(hj!ShhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRubjI)}(hpathh]hpath}(hj.ShhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjRubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjCRubjC)}(hconst char *esch](j )}(hjJh]hconst}(hjGShhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjCSubj2)}(h h]h }(hjTShhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjCSubj)}(hcharh]hchar}(hjbShhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCSubj2)}(h h]h }(hjpShhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjCSubj)}(hjh]h*}(hj~ShhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCSubjI)}(hesch]hesc}(hjShhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjCSubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjCRubeh}(h]h ]h"]h$]h&]j`jauh1j<hj RhhhjRhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjRhhhjRhMubah}(h]jRah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjRhMhjRhhubjw)}(hhh]h)}(h&seq_file interface to print a pathnameh]h&seq_file interface to print a pathname}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMhjShhubah}(h]h ]h"]h$]h&]uh1jvhjRhhhjRhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjSjjSjjjuh1jhhhjOghNhNubj)}(hX***Parameters** ``struct seq_file *m`` the seq_file handle ``const struct path *path`` the struct path to print ``const char *esc`` set of characters to escape in the output **Description** return the absolute path of 'path', as represented by the dentry / mnt pair in the path parameter.h](h)}(h**Parameters**h]j)}(hjSh]h Parameters}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1jhjSubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMhjSubj)}(hhh](j)}(h+``struct seq_file *m`` the seq_file handle h](j)}(h``struct seq_file *m``h]j)}(hjSh]hstruct seq_file *m}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1jhjSubah}(h]h ]h"]h$]h&]uh1jhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMhjSubj)}(hhh]h)}(hthe seq_file handleh]hthe seq_file handle}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1hhj ThMhj Tubah}(h]h ]h"]h$]h&]uh1jhjSubeh}(h]h ]h"]h$]h&]uh1jhj ThMhjSubj)}(h5``const struct path *path`` the struct path to print h](j)}(h``const struct path *path``h]j)}(hj/Th]hconst struct path *path}(hj1ThhhNhNubah}(h]h ]h"]h$]h&]uh1jhj-Tubah}(h]h ]h"]h$]h&]uh1jhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMhj)Tubj)}(hhh]h)}(hthe struct path to printh]hthe struct path to print}(hjHThhhNhNubah}(h]h ]h"]h$]h&]uh1hhjDThMhjETubah}(h]h ]h"]h$]h&]uh1jhj)Tubeh}(h]h ]h"]h$]h&]uh1jhjDThMhjSubj)}(h>``const char *esc`` set of characters to escape in the output h](j)}(h``const char *esc``h]j)}(hjhTh]hconst char *esc}(hjjThhhNhNubah}(h]h ]h"]h$]h&]uh1jhjfTubah}(h]h ]h"]h$]h&]uh1jhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMhjbTubj)}(hhh]h)}(h)set of characters to escape in the outputh]h)set of characters to escape in the output}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1hhj}ThMhj~Tubah}(h]h ]h"]h$]h&]uh1jhjbTubeh}(h]h ]h"]h$]h&]uh1jhj}ThMhjSubeh}(h]h ]h"]h$]h&]uh1jhjSubh)}(h**Description**h]j)}(hjTh]h Description}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jhjTubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMhjSubh)}(hbreturn the absolute path of 'path', as represented by the dentry / mnt pair in the path parameter.h]hfreturn the absolute path of ‘path’, as represented by the dentry / mnt pair in the path parameter.}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMhjSubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j seq_file_path (C function)c.seq_file_pathhNtauh1hhjOghhhNhNubj)}(hhh](j)}(hJint seq_file_path (struct seq_file *m, struct file *file, const char *esc)h]j)}(hIint seq_file_path(struct seq_file *m, struct file *file, const char *esc)h](j)}(hinth]hint}(hjThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjThhhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMubj2)}(h h]h }(hjThhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjThhhjThMubjC)}(h seq_file_pathh]jI)}(h seq_file_pathh]h seq_file_path}(hj UhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjUubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjThhhjThMubj=)}(h8(struct seq_file *m, struct file *file, const char *esc)h](jC)}(hstruct seq_file *mh](j )}(hjh]hstruct}(hj%UhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj!Uubj2)}(h h]h }(hj2UhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj!Uubh)}(hhh]jI)}(hseq_fileh]hseq_file}(hjCUhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj@Uubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjEUmodnameN classnameNjj )}j ]j)}jj Usbc.seq_file_pathasbuh1hhj!Uubj2)}(h h]h }(hjcUhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj!Uubj)}(hjh]h*}(hjqUhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!UubjI)}(hjNh]hm}(hj~UhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj!Uubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjUubjC)}(hstruct file *fileh](j )}(hjh]hstruct}(hjUhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjUubj2)}(h h]h }(hjUhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjUubh)}(hhh]jI)}(hfileh]hfile}(hjUhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjUubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjUmodnameN classnameNjj )}j ]j_Uc.seq_file_pathasbuh1hhjUubj2)}(h h]h }(hjUhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjUubj)}(hjh]h*}(hjUhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjUubjI)}(hfileh]hfile}(hjUhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjUubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjUubjC)}(hconst char *esch](j )}(hjJh]hconst}(hjVhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjVubj2)}(h h]h }(hjVhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjVubj)}(hcharh]hchar}(hj!VhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVubj2)}(h h]h }(hj/VhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjVubj)}(hjh]h*}(hj=VhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVubjI)}(hesch]hesc}(hjJVhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjVubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjUubeh}(h]h ]h"]h$]h&]j`jauh1j<hjThhhjThMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjThhhjThMubah}(h]jTah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjThMhjThhubjw)}(hhh]h)}(h0seq_file interface to print a pathname of a fileh]h0seq_file interface to print a pathname of a file}(hjtVhhhNhNubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMhjqVhhubah}(h]h ]h"]h$]h&]uh1jvhjThhhjThMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjVjjVjjjuh1jhhhjOghNhNubj)}(h**Parameters** ``struct seq_file *m`` the seq_file handle ``struct file *file`` the struct file to print ``const char *esc`` set of characters to escape in the output **Description** return the absolute path to the file.h](h)}(h**Parameters**h]j)}(hjVh]h Parameters}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjVubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMhjVubj)}(hhh](j)}(h+``struct seq_file *m`` the seq_file handle h](j)}(h``struct seq_file *m``h]j)}(hjVh]hstruct seq_file *m}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjVubah}(h]h ]h"]h$]h&]uh1jhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMhjVubj)}(hhh]h)}(hthe seq_file handleh]hthe seq_file handle}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjVhMhjVubah}(h]h ]h"]h$]h&]uh1jhjVubeh}(h]h ]h"]h$]h&]uh1jhjVhMhjVubj)}(h/``struct file *file`` the struct file to print h](j)}(h``struct file *file``h]j)}(hjVh]hstruct file *file}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjVubah}(h]h ]h"]h$]h&]uh1jhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMhjVubj)}(hhh]h)}(hthe struct file to printh]hthe struct file to print}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjWhMhjWubah}(h]h ]h"]h$]h&]uh1jhjVubeh}(h]h ]h"]h$]h&]uh1jhjWhMhjVubj)}(h>``const char *esc`` set of characters to escape in the output h](j)}(h``const char *esc``h]j)}(hj'Wh]hconst char *esc}(hj)WhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj%Wubah}(h]h ]h"]h$]h&]uh1jhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMhj!Wubj)}(hhh]h)}(h)set of characters to escape in the outputh]h)set of characters to escape in the output}(hj@WhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjah"]h$]h&]uh1j1hjWhhhjWhM0ubjC)}(h seq_writeh]jI)}(h seq_writeh]h seq_write}(hjWhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjWubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjWhhhjWhM0ubj=)}(h4(struct seq_file *seq, const void *data, size_t len)h](jC)}(hstruct seq_file *seqh](j )}(hjh]hstruct}(hjWhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjWubj2)}(h h]h }(hjWhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjWubh)}(hhh]jI)}(hseq_fileh]hseq_file}(hjXhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjWubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjXmodnameN classnameNjj )}j ]j)}jjWsb c.seq_writeasbuh1hhjWubj2)}(h h]h }(hj"XhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjWubj)}(hjh]h*}(hj0XhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjWubjI)}(hseqh]hseq}(hj=XhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjWubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjWubjC)}(hconst void *datah](j )}(hjJh]hconst}(hjVXhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjRXubj2)}(h h]h }(hjcXhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjRXubj)}(hvoidh]hvoid}(hjqXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRXubj2)}(h h]h }(hjXhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjRXubj)}(hjh]h*}(hjXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRXubjI)}(hdatah]hdata}(hjXhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjRXubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjWubjC)}(h size_t lenh](h)}(hhh]jI)}(hsize_th]hsize_t}(hjXhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjXubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjXmodnameN classnameNjj )}j ]jX c.seq_writeasbuh1hhjXubj2)}(h h]h }(hjXhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjXubjI)}(hlenh]hlen}(hjXhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjXubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjWubeh}(h]h ]h"]h$]h&]j`jauh1j<hjWhhhjWhM0ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjWhhhjWhM0ubah}(h]jWah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjWhM0hjWhhubjw)}(hhh]h)}(hwrite arbitrary data to bufferh]hwrite arbitrary data to buffer}(hj YhhhNhNubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chM0hj Yhhubah}(h]h ]h"]h$]h&]uh1jvhjWhhhjWhM0ubeh}(h]h ](jfunctioneh"]h$]h&]jjjj$Yjj$Yjjjuh1jhhhjOghNhNubj)}(h**Parameters** ``struct seq_file *seq`` seq_file identifying the buffer to which data should be written ``const void *data`` data address ``size_t len`` number of bytes **Description** Return 0 on success, non-zero otherwise.h](h)}(h**Parameters**h]j)}(hj.Yh]h Parameters}(hj0YhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj,Yubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chM4hj(Yubj)}(hhh](j)}(hY``struct seq_file *seq`` seq_file identifying the buffer to which data should be written h](j)}(h``struct seq_file *seq``h]j)}(hjMYh]hstruct seq_file *seq}(hjOYhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjKYubah}(h]h ]h"]h$]h&]uh1jhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chM1hjGYubj)}(hhh]h)}(h?seq_file identifying the buffer to which data should be writtenh]h?seq_file identifying the buffer to which data should be written}(hjfYhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjbYhM1hjcYubah}(h]h ]h"]h$]h&]uh1jhjGYubeh}(h]h ]h"]h$]h&]uh1jhjbYhM1hjDYubj)}(h"``const void *data`` data address h](j)}(h``const void *data``h]j)}(hjYh]hconst void *data}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjYubah}(h]h ]h"]h$]h&]uh1jhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chM2hjYubj)}(hhh]h)}(h data addressh]h data address}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjYhM2hjYubah}(h]h ]h"]h$]h&]uh1jhjYubeh}(h]h ]h"]h$]h&]uh1jhjYhM2hjDYubj)}(h``size_t len`` number of bytes h](j)}(h``size_t len``h]j)}(hjYh]h size_t len}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjYubah}(h]h ]h"]h$]h&]uh1jhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chM3hjYubj)}(hhh]h)}(hnumber of bytesh]hnumber of bytes}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjYhM3hjYubah}(h]h ]h"]h$]h&]uh1jhjYubeh}(h]h ]h"]h$]h&]uh1jhjYhM3hjDYubeh}(h]h ]h"]h$]h&]uh1jhj(Yubh)}(h**Description**h]j)}(hjYh]h Description}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjYubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chM5hj(Yubh)}(h(Return 0 on success, non-zero otherwise.h]h(Return 0 on success, non-zero otherwise.}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chM4hj(Yubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j seq_pad (C function) c.seq_padhNtauh1hhjOghhhNhNubj)}(hhh](j)}(h)void seq_pad (struct seq_file *m, char c)h]j)}(h(void seq_pad(struct seq_file *m, char c)h](j)}(hvoidh]hvoid}(hj?ZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;ZhhhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMDubj2)}(h h]h }(hjNZhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj;ZhhhjMZhMDubjC)}(hseq_padh]jI)}(hseq_padh]hseq_pad}(hj`ZhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj\Zubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj;ZhhhjMZhMDubj=)}(h(struct seq_file *m, char c)h](jC)}(hstruct seq_file *mh](j )}(hjh]hstruct}(hj|ZhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjxZubj2)}(h h]h }(hjZhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjxZubh)}(hhh]jI)}(hseq_fileh]hseq_file}(hjZhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjZubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjZmodnameN classnameNjj )}j ]j)}jjbZsb c.seq_padasbuh1hhjxZubj2)}(h h]h }(hjZhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjxZubj)}(hjh]h*}(hjZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjxZubjI)}(hjNh]hm}(hjZhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjxZubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjtZubjC)}(hchar ch](j)}(hcharh]hchar}(hjZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZubj2)}(h h]h }(hjZhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjZubjI)}(hjh]hc}(hj [hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjZubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjtZubeh}(h]h ]h"]h$]h&]j`jauh1j<hj;ZhhhjMZhMDubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj7ZhhhjMZhMDubah}(h]j2Zah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjMZhMDhj4Zhhubjw)}(hhh]h)}(hwrite padding spaces to bufferh]hwrite padding spaces to buffer}(hj2[hhhNhNubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMDhj/[hhubah}(h]h ]h"]h$]h&]uh1jvhj4ZhhhjMZhMDubeh}(h]h ](jfunctioneh"]h$]h&]jjjjJ[jjJ[jjjuh1jhhhjOghNhNubj)}(h**Parameters** ``struct seq_file *m`` seq_file identifying the buffer to which data should be written ``char c`` the byte to append after padding if non-zeroh](h)}(h**Parameters**h]j)}(hjT[h]h Parameters}(hjV[hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjR[ubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMHhjN[ubj)}(hhh](j)}(hW``struct seq_file *m`` seq_file identifying the buffer to which data should be written h](j)}(h``struct seq_file *m``h]j)}(hjs[h]hstruct seq_file *m}(hju[hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjq[ubah}(h]h ]h"]h$]h&]uh1jhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMEhjm[ubj)}(hhh]h)}(h?seq_file identifying the buffer to which data should be writtenh]h?seq_file identifying the buffer to which data should be written}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj[hMEhj[ubah}(h]h ]h"]h$]h&]uh1jhjm[ubeh}(h]h ]h"]h$]h&]uh1jhj[hMEhjj[ubj)}(h7``char c`` the byte to append after padding if non-zeroh](j)}(h ``char c``h]j)}(hj[h]hchar c}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj[ubah}(h]h ]h"]h$]h&]uh1jhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMGhj[ubj)}(hhh]h)}(h,the byte to append after padding if non-zeroh]h,the byte to append after padding if non-zero}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMFhj[ubah}(h]h ]h"]h$]h&]uh1jhj[ubeh}(h]h ]h"]h$]h&]uh1jhj[hMGhjj[ubeh}(h]h ]h"]h$]h&]uh1jhjN[ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j seq_hlist_start (C function)c.seq_hlist_starthNtauh1hhjOghhhNhNubj)}(hhh](j)}(hIstruct hlist_node * seq_hlist_start (struct hlist_head *head, loff_t pos)h]j)}(hGstruct hlist_node *seq_hlist_start(struct hlist_head *head, loff_t pos)h](j )}(hjh]hstruct}(hj\hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj\hhhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMubj2)}(h h]h }(hj\hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj\hhhj\hMubh)}(hhh]jI)}(h hlist_nodeh]h hlist_node}(hj%\hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj"\ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj'\modnameN classnameNjj )}j ]j)}jseq_hlist_startsbc.seq_hlist_startasbuh1hhj\hhhj\hMubj2)}(h h]h }(hjF\hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj\hhhj\hMubj)}(hjh]h*}(hjT\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\hhhj\hMubjC)}(hseq_hlist_starth]jI)}(hjC\h]hseq_hlist_start}(hje\hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhja\ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj\hhhj\hMubj=)}(h%(struct hlist_head *head, loff_t pos)h](jC)}(hstruct hlist_head *headh](j )}(hjh]hstruct}(hj\hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj|\ubj2)}(h h]h }(hj\hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj|\ubh)}(hhh]jI)}(h hlist_headh]h hlist_head}(hj\hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj\ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj\modnameN classnameNjj )}j ]jA\c.seq_hlist_startasbuh1hhj|\ubj2)}(h h]h }(hj\hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj|\ubj)}(hjh]h*}(hj\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|\ubjI)}(hheadh]hhead}(hj\hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj|\ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjx\ubjC)}(h loff_t posh](h)}(hhh]jI)}(hloff_th]hloff_t}(hj\hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj\ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj\modnameN classnameNjj )}j ]jA\c.seq_hlist_startasbuh1hhj\ubj2)}(h h]h }(hj]hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj\ubjI)}(hposh]hpos}(hj]hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj\ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjx\ubeh}(h]h ]h"]h$]h&]j`jauh1j<hj\hhhj\hMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj[hhhj\hMubah}(h]j[ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj\hMhj[hhubjw)}(hhh]h)}(hstart an iteration of a hlisth]hstart an iteration of a hlist}(hjI]hhhNhNubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMhjF]hhubah}(h]h ]h"]h$]h&]uh1jvhj[hhhj\hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjja]jja]jjjuh1jhhhjOghNhNubj)}(h**Parameters** ``struct hlist_head *head`` the head of the hlist ``loff_t pos`` the start position of the sequence **Description** Called at seq_file->op->start().h](h)}(h**Parameters**h]j)}(hjk]h]h Parameters}(hjm]hhhNhNubah}(h]h ]h"]h$]h&]uh1jhji]ubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMhje]ubj)}(hhh](j)}(h2``struct hlist_head *head`` the head of the hlist h](j)}(h``struct hlist_head *head``h]j)}(hj]h]hstruct hlist_head *head}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj]ubah}(h]h ]h"]h$]h&]uh1jhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMhj]ubj)}(hhh]h)}(hthe head of the hlisth]hthe head of the hlist}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj]hMhj]ubah}(h]h ]h"]h$]h&]uh1jhj]ubeh}(h]h ]h"]h$]h&]uh1jhj]hMhj]ubj)}(h2``loff_t pos`` the start position of the sequence h](j)}(h``loff_t pos``h]j)}(hj]h]h loff_t pos}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj]ubah}(h]h ]h"]h$]h&]uh1jhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMhj]ubj)}(hhh]h)}(h"the start position of the sequenceh]h"the start position of the sequence}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj]hMhj]ubah}(h]h ]h"]h$]h&]uh1jhj]ubeh}(h]h ]h"]h$]h&]uh1jhj]hMhj]ubeh}(h]h ]h"]h$]h&]uh1jhje]ubh)}(h**Description**h]j)}(hj]h]h Description}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj]ubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMhje]ubh)}(h Called at seq_file->op->start().h]h Called at seq_file->op->start().}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMhje]ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j !seq_hlist_start_head (C function)c.seq_hlist_start_headhNtauh1hhjOghhhNhNubj)}(hhh](j)}(hNstruct hlist_node * seq_hlist_start_head (struct hlist_head *head, loff_t pos)h]j)}(hLstruct hlist_node *seq_hlist_start_head(struct hlist_head *head, loff_t pos)h](j )}(hjh]hstruct}(hjC^hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj?^hhhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMubj2)}(h h]h }(hjQ^hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj?^hhhjP^hMubh)}(hhh]jI)}(h hlist_nodeh]h hlist_node}(hjb^hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj_^ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjd^modnameN classnameNjj )}j ]j)}jseq_hlist_start_headsbc.seq_hlist_start_headasbuh1hhj?^hhhjP^hMubj2)}(h h]h }(hj^hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj?^hhhjP^hMubj)}(hjh]h*}(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?^hhhjP^hMubjC)}(hseq_hlist_start_headh]jI)}(hj^h]hseq_hlist_start_head}(hj^hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj^ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj?^hhhjP^hMubj=)}(h%(struct hlist_head *head, loff_t pos)h](jC)}(hstruct hlist_head *headh](j )}(hjh]hstruct}(hj^hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj^ubj2)}(h h]h }(hj^hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj^ubh)}(hhh]jI)}(h hlist_headh]h hlist_head}(hj^hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj^ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj^modnameN classnameNjj )}j ]j~^c.seq_hlist_start_headasbuh1hhj^ubj2)}(h h]h }(hj^hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj^ubj)}(hjh]h*}(hj_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^ubjI)}(hheadh]hhead}(hj_hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj^ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj^ubjC)}(h loff_t posh](h)}(hhh]jI)}(hloff_th]hloff_t}(hj0_hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj-_ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj2_modnameN classnameNjj )}j ]j~^c.seq_hlist_start_headasbuh1hhj)_ubj2)}(h h]h }(hjN_hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj)_ubjI)}(hposh]hpos}(hj\_hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj)_ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj^ubeh}(h]h ]h"]h$]h&]j`jauh1j<hj?^hhhjP^hMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj;^hhhjP^hMubah}(h]j6^ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjP^hMhj8^hhubjw)}(hhh]h)}(hstart an iteration of a hlisth]hstart an iteration of a hlist}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMhj_hhubah}(h]h ]h"]h$]h&]uh1jvhj8^hhhjP^hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjj_jj_jjjuh1jhhhjOghNhNubj)}(h**Parameters** ``struct hlist_head *head`` the head of the hlist ``loff_t pos`` the start position of the sequence **Description** Called at seq_file->op->start(). Call this function if you want to print a header at the top of the output.h](h)}(h**Parameters**h]j)}(hj_h]h Parameters}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj_ubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMhj_ubj)}(hhh](j)}(h2``struct hlist_head *head`` the head of the hlist h](j)}(h``struct hlist_head *head``h]j)}(hj_h]hstruct hlist_head *head}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj_ubah}(h]h ]h"]h$]h&]uh1jhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMhj_ubj)}(hhh]h)}(hthe head of the hlisth]hthe head of the hlist}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj_hMhj_ubah}(h]h ]h"]h$]h&]uh1jhj_ubeh}(h]h ]h"]h$]h&]uh1jhj_hMhj_ubj)}(h2``loff_t pos`` the start position of the sequence h](j)}(h``loff_t pos``h]j)}(hj`h]h loff_t pos}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj_ubah}(h]h ]h"]h$]h&]uh1jhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMhj_ubj)}(hhh]h)}(h"the start position of the sequenceh]h"the start position of the sequence}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj`hMhj`ubah}(h]h ]h"]h$]h&]uh1jhj_ubeh}(h]h ]h"]h$]h&]uh1jhj`hMhj_ubeh}(h]h ]h"]h$]h&]uh1jhj_ubh)}(h**Description**h]j)}(hj;`h]h Description}(hj=`hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj9`ubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMhj_ubh)}(hkCalled at seq_file->op->start(). Call this function if you want to print a header at the top of the output.h]hkCalled at seq_file->op->start(). Call this function if you want to print a header at the top of the output.}(hjQ`hhhNhNubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMhj_ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j seq_hlist_next (C function)c.seq_hlist_nexthNtauh1hhjOghhhNhNubj)}(hhh](j)}(hSstruct hlist_node * seq_hlist_next (void *v, struct hlist_head *head, loff_t *ppos)h]j)}(hQstruct hlist_node *seq_hlist_next(void *v, struct hlist_head *head, loff_t *ppos)h](j )}(hjh]hstruct}(hj`hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj|`hhhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMubj2)}(h h]h }(hj`hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj|`hhhj`hMubh)}(hhh]jI)}(h hlist_nodeh]h hlist_node}(hj`hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj`ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj`modnameN classnameNjj )}j ]j)}jseq_hlist_nextsbc.seq_hlist_nextasbuh1hhj|`hhhj`hMubj2)}(h h]h }(hj`hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj|`hhhj`hMubj)}(hjh]h*}(hj`hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|`hhhj`hMubjC)}(hseq_hlist_nexth]jI)}(hj`h]hseq_hlist_next}(hj`hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj`ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj|`hhhj`hMubj=)}(h0(void *v, struct hlist_head *head, loff_t *ppos)h](jC)}(hvoid *vh](j)}(hvoidh]hvoid}(hj`hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj`ubj2)}(h h]h }(hjahhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj`ubj)}(hjh]h*}(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj`ubjI)}(hvh]hv}(hj#ahhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj`ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj`ubjC)}(hstruct hlist_head *headh](j )}(hjh]hstruct}(hjah"]h$]h&]uh1j1hj8aubh)}(hhh]jI)}(h hlist_headh]h hlist_head}(hjZahhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjWaubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj\amodnameN classnameNjj )}j ]j`c.seq_hlist_nextasbuh1hhj8aubj2)}(h h]h }(hjxahhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj8aubj)}(hjh]h*}(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj8aubjI)}(hheadh]hhead}(hjahhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj8aubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj`ubjC)}(h loff_t *pposh](h)}(hhh]jI)}(hloff_th]hloff_t}(hjahhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjaubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjamodnameN classnameNjj )}j ]j`c.seq_hlist_nextasbuh1hhjaubj2)}(h h]h }(hjahhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjaubj)}(hjh]h*}(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubjI)}(hpposh]hppos}(hjahhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjaubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj`ubeh}(h]h ]h"]h$]h&]j`jauh1j<hj|`hhhj`hMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjx`hhhj`hMubah}(h]js`ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj`hMhju`hhubjw)}(hhh]h)}(h&move to the next position of the hlisth]h&move to the next position of the hlist}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMhjbhhubah}(h]h ]h"]h$]h&]uh1jvhju`hhhj`hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjj*bjj*bjjjuh1jhhhjOghNhNubj)}(h**Parameters** ``void *v`` the current iterator ``struct hlist_head *head`` the head of the hlist ``loff_t *ppos`` the current position **Description** Called at seq_file->op->next().h](h)}(h**Parameters**h]j)}(hj4bh]h Parameters}(hj6bhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj2bubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMhj.bubj)}(hhh](j)}(h!``void *v`` the current iterator h](j)}(h ``void *v``h]j)}(hjSbh]hvoid *v}(hjUbhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjQbubah}(h]h ]h"]h$]h&]uh1jhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMhjMbubj)}(hhh]h)}(hthe current iteratorh]hthe current iterator}(hjlbhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhbhMhjibubah}(h]h ]h"]h$]h&]uh1jhjMbubeh}(h]h ]h"]h$]h&]uh1jhjhbhMhjJbubj)}(h2``struct hlist_head *head`` the head of the hlist h](j)}(h``struct hlist_head *head``h]j)}(hjbh]hstruct hlist_head *head}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjbubah}(h]h ]h"]h$]h&]uh1jhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMhjbubj)}(hhh]h)}(hthe head of the hlisth]hthe head of the hlist}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjbhMhjbubah}(h]h ]h"]h$]h&]uh1jhjbubeh}(h]h ]h"]h$]h&]uh1jhjbhMhjJbubj)}(h&``loff_t *ppos`` the current position h](j)}(h``loff_t *ppos``h]j)}(hjbh]h loff_t *ppos}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjbubah}(h]h ]h"]h$]h&]uh1jhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMhjbubj)}(hhh]h)}(hthe current positionh]hthe current position}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjbhMhjbubah}(h]h ]h"]h$]h&]uh1jhjbubeh}(h]h ]h"]h$]h&]uh1jhjbhMhjJbubeh}(h]h ]h"]h$]h&]uh1jhj.bubh)}(h**Description**h]j)}(hjch]h Description}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jhjbubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMhj.bubh)}(hCalled at seq_file->op->next().h]hCalled at seq_file->op->next().}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMhj.bubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j  seq_hlist_start_rcu (C function)c.seq_hlist_start_rcuhNtauh1hhjOghhhNhNubj)}(hhh](j)}(hMstruct hlist_node * seq_hlist_start_rcu (struct hlist_head *head, loff_t pos)h]j)}(hKstruct hlist_node *seq_hlist_start_rcu(struct hlist_head *head, loff_t pos)h](j )}(hjh]hstruct}(hjEchhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjAchhhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMubj2)}(h h]h }(hjSchhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjAchhhjRchMubh)}(hhh]jI)}(h hlist_nodeh]h hlist_node}(hjdchhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjacubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjfcmodnameN classnameNjj )}j ]j)}jseq_hlist_start_rcusbc.seq_hlist_start_rcuasbuh1hhjAchhhjRchMubj2)}(h h]h }(hjchhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjAchhhjRchMubj)}(hjh]h*}(hjchhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjAchhhjRchMubjC)}(hseq_hlist_start_rcuh]jI)}(hjch]hseq_hlist_start_rcu}(hjchhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjcubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjAchhhjRchMubj=)}(h%(struct hlist_head *head, loff_t pos)h](jC)}(hstruct hlist_head *headh](j )}(hjh]hstruct}(hjchhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjcubj2)}(h h]h }(hjchhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjcubh)}(hhh]jI)}(h hlist_headh]h hlist_head}(hjchhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjcubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjcmodnameN classnameNjj )}j ]jcc.seq_hlist_start_rcuasbuh1hhjcubj2)}(h h]h }(hjchhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjcubj)}(hjh]h*}(hj dhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjcubjI)}(hheadh]hhead}(hjdhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjcubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjcubjC)}(h loff_t posh](h)}(hhh]jI)}(hloff_th]hloff_t}(hj2dhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj/dubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj4dmodnameN classnameNjj )}j ]jcc.seq_hlist_start_rcuasbuh1hhj+dubj2)}(h h]h }(hjPdhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj+dubjI)}(hposh]hpos}(hj^dhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj+dubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjcubeh}(h]h ]h"]h$]h&]j`jauh1j<hjAchhhjRchMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj=chhhjRchMubah}(h]j8cah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjRchMhj:chhubjw)}(hhh]h)}(h.start an iteration of a hlist protected by RCUh]h.start an iteration of a hlist protected by RCU}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMhjdhhubah}(h]h ]h"]h$]h&]uh1jvhj:chhhjRchMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjdjjdjjjuh1jhhhjOghNhNubj)}(hXb**Parameters** ``struct hlist_head *head`` the head of the hlist ``loff_t pos`` the start position of the sequence **Description** Called at seq_file->op->start(). This list-traversal primitive may safely run concurrently with the _rcu list-mutation primitives such as hlist_add_head_rcu() as long as the traversal is guarded by rcu_read_lock().h](h)}(h**Parameters**h]j)}(hjdh]h Parameters}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjdubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMhjdubj)}(hhh](j)}(h2``struct hlist_head *head`` the head of the hlist h](j)}(h``struct hlist_head *head``h]j)}(hjdh]hstruct hlist_head *head}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjdubah}(h]h ]h"]h$]h&]uh1jhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMhjdubj)}(hhh]h)}(hthe head of the hlisth]hthe head of the hlist}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjdhMhjdubah}(h]h ]h"]h$]h&]uh1jhjdubeh}(h]h ]h"]h$]h&]uh1jhjdhMhjdubj)}(h2``loff_t pos`` the start position of the sequence h](j)}(h``loff_t pos``h]j)}(hjeh]h loff_t pos}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1jhjeubah}(h]h ]h"]h$]h&]uh1jhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMhjdubj)}(hhh]h)}(h"the start position of the sequenceh]h"the start position of the sequence}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1hhjehMhjeubah}(h]h ]h"]h$]h&]uh1jhjdubeh}(h]h ]h"]h$]h&]uh1jhjehMhjdubeh}(h]h ]h"]h$]h&]uh1jhjdubh)}(h**Description**h]j)}(hj=eh]h Description}(hj?ehhhNhNubah}(h]h ]h"]h$]h&]uh1jhj;eubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMhjdubh)}(h Called at seq_file->op->start().h]h Called at seq_file->op->start().}(hjSehhhNhNubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMhjdubh)}(hThis list-traversal primitive may safely run concurrently with the _rcu list-mutation primitives such as hlist_add_head_rcu() as long as the traversal is guarded by rcu_read_lock().h]hThis list-traversal primitive may safely run concurrently with the _rcu list-mutation primitives such as hlist_add_head_rcu() as long as the traversal is guarded by rcu_read_lock().}(hjbehhhNhNubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMhjdubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j %seq_hlist_start_head_rcu (C function)c.seq_hlist_start_head_rcuhNtauh1hhjOghhhNhNubj)}(hhh](j)}(hRstruct hlist_node * seq_hlist_start_head_rcu (struct hlist_head *head, loff_t pos)h]j)}(hPstruct hlist_node *seq_hlist_start_head_rcu(struct hlist_head *head, loff_t pos)h](j )}(hjh]hstruct}(hjehhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjehhhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMubj2)}(h h]h }(hjehhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjehhhjehMubh)}(hhh]jI)}(h hlist_nodeh]h hlist_node}(hjehhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjeubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjemodnameN classnameNjj )}j ]j)}jseq_hlist_start_head_rcusbc.seq_hlist_start_head_rcuasbuh1hhjehhhjehMubj2)}(h h]h }(hjehhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjehhhjehMubj)}(hjh]h*}(hjehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjehhhjehMubjC)}(hseq_hlist_start_head_rcuh]jI)}(hjeh]hseq_hlist_start_head_rcu}(hjehhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjeubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjehhhjehMubj=)}(h%(struct hlist_head *head, loff_t pos)h](jC)}(hstruct hlist_head *headh](j )}(hjh]hstruct}(hj fhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjfubj2)}(h h]h }(hjfhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjfubh)}(hhh]jI)}(h hlist_headh]h hlist_head}(hj)fhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj&fubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj+fmodnameN classnameNjj )}j ]jec.seq_hlist_start_head_rcuasbuh1hhjfubj2)}(h h]h }(hjGfhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjfubj)}(hjh]h*}(hjUfhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjfubjI)}(hheadh]hhead}(hjbfhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjfubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjfubjC)}(h loff_t posh](h)}(hhh]jI)}(hloff_th]hloff_t}(hj~fhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj{fubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjfmodnameN classnameNjj )}j ]jec.seq_hlist_start_head_rcuasbuh1hhjwfubj2)}(h h]h }(hjfhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjwfubjI)}(hposh]hpos}(hjfhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjwfubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjfubeh}(h]h ]h"]h$]h&]j`jauh1j<hjehhhjehMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjehhhjehMubah}(h]jeah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjehMhjehhubjw)}(hhh]h)}(h.start an iteration of a hlist protected by RCUh]h.start an iteration of a hlist protected by RCU}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMhjfhhubah}(h]h ]h"]h$]h&]uh1jvhjehhhjehMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjfjjfjjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``struct hlist_head *head`` the head of the hlist ``loff_t pos`` the start position of the sequence **Description** Called at seq_file->op->start(). Call this function if you want to print a header at the top of the output. This list-traversal primitive may safely run concurrently with the _rcu list-mutation primitives such as hlist_add_head_rcu() as long as the traversal is guarded by rcu_read_lock().h](h)}(h**Parameters**h]j)}(hjfh]h Parameters}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjfubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMhjfubj)}(hhh](j)}(h2``struct hlist_head *head`` the head of the hlist h](j)}(h``struct hlist_head *head``h]j)}(hjgh]hstruct hlist_head *head}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1jhjgubah}(h]h ]h"]h$]h&]uh1jhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMhjgubj)}(hhh]h)}(hthe head of the hlisth]hthe head of the hlist}(hj.ghhhNhNubah}(h]h ]h"]h$]h&]uh1hhj*ghMhj+gubah}(h]h ]h"]h$]h&]uh1jhjgubeh}(h]h ]h"]h$]h&]uh1jhj*ghMhj gubj)}(h2``loff_t pos`` the start position of the sequence h](j)}(h``loff_t pos``h]j)}(hjNgh]h loff_t pos}(hjPghhhNhNubah}(h]h ]h"]h$]h&]uh1jhjLgubah}(h]h ]h"]h$]h&]uh1jhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMhjHgubj)}(hhh]h)}(h"the start position of the sequenceh]h"the start position of the sequence}(hjgghhhNhNubah}(h]h ]h"]h$]h&]uh1hhjcghMhjdgubah}(h]h ]h"]h$]h&]uh1jhjHgubeh}(h]h ]h"]h$]h&]uh1jhjcghMhj gubeh}(h]h ]h"]h$]h&]uh1jhjfubh)}(h**Description**h]j)}(hjgh]h Description}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1jhjgubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMhjfubh)}(hkCalled at seq_file->op->start(). Call this function if you want to print a header at the top of the output.h]hkCalled at seq_file->op->start(). Call this function if you want to print a header at the top of the output.}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMhjfubh)}(hThis list-traversal primitive may safely run concurrently with the _rcu list-mutation primitives such as hlist_add_head_rcu() as long as the traversal is guarded by rcu_read_lock().h]hThis list-traversal primitive may safely run concurrently with the _rcu list-mutation primitives such as hlist_add_head_rcu() as long as the traversal is guarded by rcu_read_lock().}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMhjfubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j seq_hlist_next_rcu (C function)c.seq_hlist_next_rcuhNtauh1hhjOghhhNhNubj)}(hhh](j)}(hWstruct hlist_node * seq_hlist_next_rcu (void *v, struct hlist_head *head, loff_t *ppos)h]j)}(hUstruct hlist_node *seq_hlist_next_rcu(void *v, struct hlist_head *head, loff_t *ppos)h](j )}(hjh]hstruct}(hjghhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjghhhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chM%ubj2)}(h h]h }(hjghhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjghhhjghM%ubh)}(hhh]jI)}(h hlist_nodeh]h hlist_node}(hjghhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjgubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjgmodnameN classnameNjj )}j ]j)}jseq_hlist_next_rcusbc.seq_hlist_next_rcuasbuh1hhjghhhjghM%ubj2)}(h h]h }(hjhhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjghhhjghM%ubj)}(hjh]h*}(hj+hhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjghhhjghM%ubjC)}(hseq_hlist_next_rcuh]jI)}(hjhh]hseq_hlist_next_rcu}(hjah"]h$]h&]uh1j1hjShubj)}(hjh]h*}(hjshhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjShubjI)}(hj%ah]hv}(hjhhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjShubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjOhubjC)}(hstruct hlist_head *headh](j )}(hjh]hstruct}(hjhhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjhubj2)}(h h]h }(hjhhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhubh)}(hhh]jI)}(h hlist_headh]h hlist_head}(hjhhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjhubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjhmodnameN classnameNjj )}j ]jhc.seq_hlist_next_rcuasbuh1hhjhubj2)}(h h]h }(hjhhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhubj)}(hjh]h*}(hjhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhubjI)}(hheadh]hhead}(hjhhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjhubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjOhubjC)}(h loff_t *pposh](h)}(hhh]jI)}(hloff_th]hloff_t}(hj ihhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjiubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj imodnameN classnameNjj )}j ]jhc.seq_hlist_next_rcuasbuh1hhjiubj2)}(h h]h }(hj)ihhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjiubj)}(hjh]h*}(hj7ihhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjiubjI)}(hpposh]hppos}(hjDihhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjiubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjOhubeh}(h]h ]h"]h$]h&]j`jauh1j<hjghhhjghM%ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjghhhjghM%ubah}(h]jgah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjghM%hjghhubjw)}(hhh]h)}(h7move to the next position of the hlist protected by RCUh]h7move to the next position of the hlist protected by RCU}(hjnihhhNhNubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chM%hjkihhubah}(h]h ]h"]h$]h&]uh1jvhjghhhjghM%ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjijjijjjuh1jhhhjOghNhNubj)}(hXy**Parameters** ``void *v`` the current iterator ``struct hlist_head *head`` the head of the hlist ``loff_t *ppos`` the current position **Description** Called at seq_file->op->next(). This list-traversal primitive may safely run concurrently with the _rcu list-mutation primitives such as hlist_add_head_rcu() as long as the traversal is guarded by rcu_read_lock().h](h)}(h**Parameters**h]j)}(hjih]h Parameters}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1jhjiubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chM)hjiubj)}(hhh](j)}(h!``void *v`` the current iterator h](j)}(h ``void *v``h]j)}(hjih]hvoid *v}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1jhjiubah}(h]h ]h"]h$]h&]uh1jhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chM&hjiubj)}(hhh]h)}(hthe current iteratorh]hthe current iterator}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1hhjihM&hjiubah}(h]h ]h"]h$]h&]uh1jhjiubeh}(h]h ]h"]h$]h&]uh1jhjihM&hjiubj)}(h2``struct hlist_head *head`` the head of the hlist h](j)}(h``struct hlist_head *head``h]j)}(hjih]hstruct hlist_head *head}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1jhjiubah}(h]h ]h"]h$]h&]uh1jhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chM'hjiubj)}(hhh]h)}(hthe head of the hlisth]hthe head of the hlist}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjihM'hjiubah}(h]h ]h"]h$]h&]uh1jhjiubeh}(h]h ]h"]h$]h&]uh1jhjihM'hjiubj)}(h&``loff_t *ppos`` the current position h](j)}(h``loff_t *ppos``h]j)}(hj!jh]h loff_t *ppos}(hj#jhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjjubah}(h]h ]h"]h$]h&]uh1jhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chM(hjjubj)}(hhh]h)}(hthe current positionh]hthe current position}(hj:jhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj6jhM(hj7jubah}(h]h ]h"]h$]h&]uh1jhjjubeh}(h]h ]h"]h$]h&]uh1jhj6jhM(hjiubeh}(h]h ]h"]h$]h&]uh1jhjiubh)}(h**Description**h]j)}(hj\jh]h Description}(hj^jhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjZjubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chM*hjiubh)}(hCalled at seq_file->op->next().h]hCalled at seq_file->op->next().}(hjrjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chM)hjiubh)}(hThis list-traversal primitive may safely run concurrently with the _rcu list-mutation primitives such as hlist_add_head_rcu() as long as the traversal is guarded by rcu_read_lock().h]hThis list-traversal primitive may safely run concurrently with the _rcu list-mutation primitives such as hlist_add_head_rcu() as long as the traversal is guarded by rcu_read_lock().}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chM+hjiubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j #seq_hlist_start_percpu (C function)c.seq_hlist_start_percpuhNtauh1hhjOghhhNhNubj)}(hhh](j)}(hcstruct hlist_node * seq_hlist_start_percpu (struct hlist_head __percpu *head, int *cpu, loff_t pos)h]j)}(hastruct hlist_node *seq_hlist_start_percpu(struct hlist_head __percpu *head, int *cpu, loff_t pos)h](j )}(hjh]hstruct}(hjjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjjhhhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chM?ubj2)}(h h]h }(hjjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjjhhhjjhM?ubh)}(hhh]jI)}(h hlist_nodeh]h hlist_node}(hjjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjjmodnameN classnameNjj )}j ]j)}jseq_hlist_start_percpusbc.seq_hlist_start_percpuasbuh1hhjjhhhjjhM?ubj2)}(h h]h }(hjjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjjhhhjjhM?ubj)}(hjh]h*}(hjjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjjhhhjjhM?ubjC)}(hseq_hlist_start_percpuh]jI)}(hjjh]hseq_hlist_start_percpu}(hjkhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj kubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjjhhhjjhM?ubj=)}(h8(struct hlist_head __percpu *head, int *cpu, loff_t pos)h](jC)}(h struct hlist_head __percpu *headh](j )}(hjh]hstruct}(hj*khhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj&kubj2)}(h h]h }(hj7khhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj&kubh)}(hhh]jI)}(h hlist_headh]h hlist_head}(hjHkhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjEkubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjJkmodnameN classnameNjj )}j ]jjc.seq_hlist_start_percpuasbuh1hhj&kubj2)}(h h]h }(hjfkhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj&kubh__percpu}(hj&khhhNhNubj2)}(h h]h }(hjxkhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj&kubj)}(hjh]h*}(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&kubjI)}(hheadh]hhead}(hjkhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj&kubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj"kubjC)}(hint *cpuh](j)}(hinth]hint}(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjkubj2)}(h h]h }(hjkhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjkubj)}(hjh]h*}(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjkubjI)}(hcpuh]hcpu}(hjkhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjkubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj"kubjC)}(h loff_t posh](h)}(hhh]jI)}(hloff_th]hloff_t}(hjkhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjkubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjkmodnameN classnameNjj )}j ]jjc.seq_hlist_start_percpuasbuh1hhjkubj2)}(h h]h }(hjlhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjkubjI)}(hposh]hpos}(hjlhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjkubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj"kubeh}(h]h ]h"]h$]h&]j`jauh1j<hjjhhhjjhM?ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjjhhhjjhM?ubah}(h]jjah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjjhM?hjjhhubjw)}(hhh]h)}(h*start an iteration of a percpu hlist arrayh]h*start an iteration of a percpu hlist array}(hjGlhhhNhNubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chM?hjDlhhubah}(h]h ]h"]h$]h&]uh1jvhjjhhhjjhM?ubeh}(h]h ](jfunctioneh"]h$]h&]jjjj_ljj_ljjjuh1jhhhjOghNhNubj)}(h**Parameters** ``struct hlist_head __percpu *head`` pointer to percpu array of struct hlist_heads ``int *cpu`` pointer to cpu "cursor" ``loff_t pos`` start position of sequence **Description** Called at seq_file->op->start().h](h)}(h**Parameters**h]j)}(hjilh]h Parameters}(hjklhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjglubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMChjclubj)}(hhh](j)}(hS``struct hlist_head __percpu *head`` pointer to percpu array of struct hlist_heads h](j)}(h$``struct hlist_head __percpu *head``h]j)}(hjlh]h struct hlist_head __percpu *head}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjlubah}(h]h ]h"]h$]h&]uh1jhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chM@hjlubj)}(hhh]h)}(h-pointer to percpu array of struct hlist_headsh]h-pointer to percpu array of struct hlist_heads}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjlhM@hjlubah}(h]h ]h"]h$]h&]uh1jhjlubeh}(h]h ]h"]h$]h&]uh1jhjlhM@hjlubj)}(h%``int *cpu`` pointer to cpu "cursor" h](j)}(h ``int *cpu``h]j)}(hjlh]hint *cpu}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjlubah}(h]h ]h"]h$]h&]uh1jhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMAhjlubj)}(hhh]h)}(hpointer to cpu "cursor"h]hpointer to cpu “cursor”}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjlhMAhjlubah}(h]h ]h"]h$]h&]uh1jhjlubeh}(h]h ]h"]h$]h&]uh1jhjlhMAhjlubj)}(h*``loff_t pos`` start position of sequence h](j)}(h``loff_t pos``h]j)}(hjlh]h loff_t pos}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjlubah}(h]h ]h"]h$]h&]uh1jhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMBhjlubj)}(hhh]h)}(hstart position of sequenceh]hstart position of sequence}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjmhMBhjmubah}(h]h ]h"]h$]h&]uh1jhjlubeh}(h]h ]h"]h$]h&]uh1jhjmhMBhjlubeh}(h]h ]h"]h$]h&]uh1jhjclubh)}(h**Description**h]j)}(hj5mh]h Description}(hj7mhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj3mubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMDhjclubh)}(h Called at seq_file->op->start().h]h Called at seq_file->op->start().}(hjKmhhhNhNubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMChjclubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j "seq_hlist_next_percpu (C function)c.seq_hlist_next_percpuhNtauh1hhjOghhhNhNubj)}(hhh](j)}(hlstruct hlist_node * seq_hlist_next_percpu (void *v, struct hlist_head __percpu *head, int *cpu, loff_t *pos)h]j)}(hjstruct hlist_node *seq_hlist_next_percpu(void *v, struct hlist_head __percpu *head, int *cpu, loff_t *pos)h](j )}(hjh]hstruct}(hjzmhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjvmhhhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMVubj2)}(h h]h }(hjmhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjvmhhhjmhMVubh)}(hhh]jI)}(h hlist_nodeh]h hlist_node}(hjmhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjmubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmmodnameN classnameNjj )}j ]j)}jseq_hlist_next_percpusbc.seq_hlist_next_percpuasbuh1hhjvmhhhjmhMVubj2)}(h h]h }(hjmhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjvmhhhjmhMVubj)}(hjh]h*}(hjmhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvmhhhjmhMVubjC)}(hseq_hlist_next_percpuh]jI)}(hjmh]hseq_hlist_next_percpu}(hjmhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjmubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjvmhhhjmhMVubj=)}(hB(void *v, struct hlist_head __percpu *head, int *cpu, loff_t *pos)h](jC)}(hvoid *vh](j)}(hvoidh]hvoid}(hjmhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmubj2)}(h h]h }(hjnhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjmubj)}(hjh]h*}(hjnhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmubjI)}(hj%ah]hv}(hjnhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjmubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjmubjC)}(h struct hlist_head __percpu *headh](j )}(hjh]hstruct}(hj5nhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj1nubj2)}(h h]h }(hjBnhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj1nubh)}(hhh]jI)}(h hlist_headh]h hlist_head}(hjSnhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjPnubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjUnmodnameN classnameNjj )}j ]jmc.seq_hlist_next_percpuasbuh1hhj1nubj2)}(h h]h }(hjqnhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj1nubh__percpu}(hj1nhhhNhNubj2)}(h h]h }(hjnhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj1nubj)}(hjh]h*}(hjnhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj1nubjI)}(hheadh]hhead}(hjnhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj1nubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjmubjC)}(hint *cpuh](j)}(hinth]hint}(hjnhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnubj2)}(h h]h }(hjnhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjnubj)}(hjh]h*}(hjnhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnubjI)}(hcpuh]hcpu}(hjnhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjnubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjmubjC)}(h loff_t *posh](h)}(hhh]jI)}(hloff_th]hloff_t}(hjnhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjnubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjnmodnameN classnameNjj )}j ]jmc.seq_hlist_next_percpuasbuh1hhjnubj2)}(h h]h }(hjohhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjnubj)}(hjh]h*}(hj(ohhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnubjI)}(hposh]hpos}(hj5ohhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjnubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjmubeh}(h]h ]h"]h$]h&]j`jauh1j<hjvmhhhjmhMVubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjrmhhhjmhMVubah}(h]jmmah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjmhMVhjomhhubjw)}(hhh]h)}(h3move to the next position of the percpu hlist arrayh]h3move to the next position of the percpu hlist array}(hj_ohhhNhNubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMVhj\ohhubah}(h]h ]h"]h$]h&]uh1jvhjomhhhjmhMVubeh}(h]h ](jfunctioneh"]h$]h&]jjjjwojjwojjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``void *v`` pointer to current hlist_node ``struct hlist_head __percpu *head`` pointer to percpu array of struct hlist_heads ``int *cpu`` pointer to cpu "cursor" ``loff_t *pos`` start position of sequence **Description** Called at seq_file->op->next().h](h)}(h**Parameters**h]j)}(hjoh]h Parameters}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1jhjoubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMZhj{oubj)}(hhh](j)}(h*``void *v`` pointer to current hlist_node h](j)}(h ``void *v``h]j)}(hjoh]hvoid *v}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1jhjoubah}(h]h ]h"]h$]h&]uh1jhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMWhjoubj)}(hhh]h)}(hpointer to current hlist_nodeh]hpointer to current hlist_node}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1hhjohMWhjoubah}(h]h ]h"]h$]h&]uh1jhjoubeh}(h]h ]h"]h$]h&]uh1jhjohMWhjoubj)}(hS``struct hlist_head __percpu *head`` pointer to percpu array of struct hlist_heads h](j)}(h$``struct hlist_head __percpu *head``h]j)}(hjoh]h struct hlist_head __percpu *head}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1jhjoubah}(h]h ]h"]h$]h&]uh1jhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMXhjoubj)}(hhh]h)}(h-pointer to percpu array of struct hlist_headsh]h-pointer to percpu array of struct hlist_heads}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1hhjohMXhjoubah}(h]h ]h"]h$]h&]uh1jhjoubeh}(h]h ]h"]h$]h&]uh1jhjohMXhjoubj)}(h%``int *cpu`` pointer to cpu "cursor" h](j)}(h ``int *cpu``h]j)}(hjph]hint *cpu}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1jhjpubah}(h]h ]h"]h$]h&]uh1jhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMYhj pubj)}(hhh]h)}(hpointer to cpu "cursor"h]hpointer to cpu “cursor”}(hj+phhhNhNubah}(h]h ]h"]h$]h&]uh1hhj'phMYhj(pubah}(h]h ]h"]h$]h&]uh1jhj pubeh}(h]h ]h"]h$]h&]uh1jhj'phMYhjoubj)}(h+``loff_t *pos`` start position of sequence h](j)}(h``loff_t *pos``h]j)}(hjKph]h loff_t *pos}(hjMphhhNhNubah}(h]h ]h"]h$]h&]uh1jhjIpubah}(h]h ]h"]h$]h&]uh1jhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chMZhjEpubj)}(hhh]h)}(hstart position of sequenceh]hstart position of sequence}(hjdphhhNhNubah}(h]h ]h"]h$]h&]uh1hhj`phMZhjapubah}(h]h ]h"]h$]h&]uh1jhjEpubeh}(h]h ]h"]h$]h&]uh1jhj`phMZhjoubeh}(h]h ]h"]h$]h&]uh1jhj{oubh)}(h**Description**h]j)}(hjph]h Description}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1jhjpubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chM\hj{oubh)}(hCalled at seq_file->op->next().h]hCalled at seq_file->op->next().}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:65: ./fs/seq_file.chM[hj{oubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j  register_filesystem (C function)c.register_filesystemhNtauh1hhjOghhhNhNubj)}(hhh](j)}(h5int register_filesystem (struct file_system_type *fs)h]j)}(h4int register_filesystem(struct file_system_type *fs)h](j)}(hinth]hint}(hjphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjphhhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:68: ./fs/filesystems.chKXubj2)}(h h]h }(hjphhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjphhhjphKXubjC)}(hregister_filesystemh]jI)}(hregister_filesystemh]hregister_filesystem}(hjphhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjpubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjphhhjphKXubj=)}(h(struct file_system_type *fs)h]jC)}(hstruct file_system_type *fsh](j )}(hjh]hstruct}(hjqhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjqubj2)}(h h]h }(hjqhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjqubh)}(hhh]jI)}(hfile_system_typeh]hfile_system_type}(hj&qhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj#qubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj(qmodnameN classnameNjj )}j ]j)}jjpsbc.register_filesystemasbuh1hhjqubj2)}(h h]h }(hjFqhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjqubj)}(hjh]h*}(hjTqhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjqubjI)}(hfsh]hfs}(hjaqhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjqubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjqubah}(h]h ]h"]h$]h&]j`jauh1j<hjphhhjphKXubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjphhhjphKXubah}(h]jpah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjphKXhjphhubjw)}(hhh]h)}(hregister a new filesystemh]hregister a new filesystem}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:68: ./fs/filesystems.chKXhjqhhubah}(h]h ]h"]h$]h&]uh1jvhjphhhjphKXubeh}(h]h ](jfunctioneh"]h$]h&]jjjjqjjqjjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``struct file_system_type *fs`` the file system structure **Description** Adds the file system passed to the list of file systems the kernel is aware of for mount and other syscalls. Returns 0 on success, or a negative errno code on an error. The :c:type:`struct file_system_type ` that is passed is linked into the kernel structures and must not be freed until the file system has been unregistered.h](h)}(h**Parameters**h]j)}(hjqh]h Parameters}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjqubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:68: ./fs/filesystems.chK\hjqubj)}(hhh]j)}(h:``struct file_system_type *fs`` the file system structure h](j)}(h``struct file_system_type *fs``h]j)}(hjqh]hstruct file_system_type *fs}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjqubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:68: ./fs/filesystems.chKYhjqubj)}(hhh]h)}(hthe file system structureh]hthe file system structure}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjqhKYhjqubah}(h]h ]h"]h$]h&]uh1jhjqubeh}(h]h ]h"]h$]h&]uh1jhjqhKYhjqubah}(h]h ]h"]h$]h&]uh1jhjqubh)}(h**Description**h]j)}(hjrh]h Description}(hj rhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjrubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:68: ./fs/filesystems.chK[hjqubj)}(hXYAdds the file system passed to the list of file systems the kernel is aware of for mount and other syscalls. Returns 0 on success, or a negative errno code on an error. The :c:type:`struct file_system_type ` that is passed is linked into the kernel structures and must not be freed until the file system has been unregistered.h](h)}(hAdds the file system passed to the list of file systems the kernel is aware of for mount and other syscalls. Returns 0 on success, or a negative errno code on an error.h]hAdds the file system passed to the list of file systems the kernel is aware of for mount and other syscalls. Returns 0 on success, or a negative errno code on an error.}(hj!rhhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:68: ./fs/filesystems.chKZhjrubh)}(hThe :c:type:`struct file_system_type ` that is passed is linked into the kernel structures and must not be freed until the file system has been unregistered.h](hThe }(hj0rhhhNhNubh)}(h4:c:type:`struct file_system_type `h]j)}(hj:rh]hstruct file_system_type}(hjah"]h$]h&]uh1j1hjrhhhjrhKwubjC)}(hunregister_filesystemh]jI)}(hunregister_filesystemh]hunregister_filesystem}(hjrhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjrubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjrhhhjrhKwubj=)}(h(struct file_system_type *fs)h]jC)}(hstruct file_system_type *fsh](j )}(hjh]hstruct}(hjrhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjrubj2)}(h h]h }(hjrhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjrubh)}(hhh]jI)}(hfile_system_typeh]hfile_system_type}(hjrhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjrubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjrmodnameN classnameNjj )}j ]j)}jjrsbc.unregister_filesystemasbuh1hhjrubj2)}(h h]h }(hjshhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjrubj)}(hjh]h*}(hjshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjrubjI)}(hfsh]hfs}(hjshhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjrubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjrubah}(h]h ]h"]h$]h&]j`jauh1j<hjrhhhjrhKwubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjrhhhjrhKwubah}(h]j{rah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjrhKwhj}rhhubjw)}(hhh]h)}(hunregister a file systemh]hunregister a file system}(hjHshhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:68: ./fs/filesystems.chKwhjEshhubah}(h]h ]h"]h$]h&]uh1jvhj}rhhhjrhKwubeh}(h]h ](jfunctioneh"]h$]h&]jjjj`sjj`sjjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``struct file_system_type *fs`` filesystem to unregister **Description** Remove a file system that was previously successfully registered with the kernel. An error is returned if the file system is not found. Zero is returned on a success. Once this function has returned the :c:type:`struct file_system_type ` structure may be freed or reused.h](h)}(h**Parameters**h]j)}(hjjsh]h Parameters}(hjlshhhNhNubah}(h]h ]h"]h$]h&]uh1jhjhsubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:68: ./fs/filesystems.chK{hjdsubj)}(hhh]j)}(h9``struct file_system_type *fs`` filesystem to unregister h](j)}(h``struct file_system_type *fs``h]j)}(hjsh]hstruct file_system_type *fs}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1jhjsubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:68: ./fs/filesystems.chKxhjsubj)}(hhh]h)}(hfilesystem to unregisterh]hfilesystem to unregister}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1hhjshKxhjsubah}(h]h ]h"]h$]h&]uh1jhjsubeh}(h]h ]h"]h$]h&]uh1jhjshKxhjsubah}(h]h ]h"]h$]h&]uh1jhjdsubh)}(h**Description**h]j)}(hjsh]h Description}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1jhjsubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:68: ./fs/filesystems.chKzhjdsubj)}(hX"Remove a file system that was previously successfully registered with the kernel. An error is returned if the file system is not found. Zero is returned on a success. Once this function has returned the :c:type:`struct file_system_type ` structure may be freed or reused.h](h)}(hRemove a file system that was previously successfully registered with the kernel. An error is returned if the file system is not found. Zero is returned on a success.h]hRemove a file system that was previously successfully registered with the kernel. An error is returned if the file system is not found. Zero is returned on a success.}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:68: ./fs/filesystems.chKyhjsubh)}(hzOnce this function has returned the :c:type:`struct file_system_type ` structure may be freed or reused.h](h$Once this function has returned the }(hjshhhNhNubh)}(h4:c:type:`struct file_system_type `h]j)}(hjsh]hstruct file_system_type}(hjshhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjsubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnjjjfile_system_typeuh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:68: ./fs/filesystems.chK}hjsubh" structure may be freed or reused.}(hjshhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjthK}hjsubeh}(h]h ]h"]h$]h&]uh1jhjshKyhjdsubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j (wbc_attach_fdatawrite_inode (C function)c.wbc_attach_fdatawrite_inodehNtauh1hhjOghhhNhNubj)}(hhh](j)}(hUvoid wbc_attach_fdatawrite_inode (struct writeback_control *wbc, struct inode *inode)h]j)}(hTvoid wbc_attach_fdatawrite_inode(struct writeback_control *wbc, struct inode *inode)h](j)}(hvoidh]hvoid}(hjEthhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjAthhhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chMjubj2)}(h h]h }(hjTthhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjAthhhjSthMjubjC)}(hwbc_attach_fdatawrite_inodeh]jI)}(hwbc_attach_fdatawrite_inodeh]hwbc_attach_fdatawrite_inode}(hjfthhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjbtubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjAthhhjSthMjubj=)}(h4(struct writeback_control *wbc, struct inode *inode)h](jC)}(hstruct writeback_control *wbch](j )}(hjh]hstruct}(hjthhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj~tubj2)}(h h]h }(hjthhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj~tubh)}(hhh]jI)}(hwriteback_controlh]hwriteback_control}(hjthhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjtubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjtmodnameN classnameNjj )}j ]j)}jjhtsbc.wbc_attach_fdatawrite_inodeasbuh1hhj~tubj2)}(h h]h }(hjthhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj~tubj)}(hjh]h*}(hjthhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~tubjI)}(hwbch]hwbc}(hjthhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj~tubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjztubjC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hjthhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjtubj2)}(h h]h }(hjuhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjtubh)}(hhh]jI)}(hinodeh]hinode}(hjuhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjuubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjumodnameN classnameNjj )}j ]jtc.wbc_attach_fdatawrite_inodeasbuh1hhjtubj2)}(h h]h }(hj0uhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjtubj)}(hjh]h*}(hj>uhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjtubjI)}(hinodeh]hinode}(hjKuhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjtubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjztubeh}(h]h ]h"]h$]h&]j`jauh1j<hjAthhhjSthMjubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj=thhhjSthMjubah}(h]j8tah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjSthMjhj:thhubjw)}(hhh]h)}(h&associate wbc and inode for fdatawriteh]h&associate wbc and inode for fdatawrite}(hjuuhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chMjhjruhhubah}(h]h ]h"]h$]h&]uh1jvhj:thhhjSthMjubeh}(h]h ](jfunctioneh"]h$]h&]jjjjujjujjjuh1jhhhjOghNhNubj)}(hXS**Parameters** ``struct writeback_control *wbc`` writeback_control of interest ``struct inode *inode`` target inode **Description** This function is to be used by filemap_writeback(), which is an alternative entry point into writeback code, and first ensures **inode** is associated with a bdi_writeback and attaches it to **wbc**.h](h)}(h**Parameters**h]j)}(hjuh]h Parameters}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjuubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chMnhjuubj)}(hhh](j)}(h@``struct writeback_control *wbc`` writeback_control of interest h](j)}(h!``struct writeback_control *wbc``h]j)}(hjuh]hstruct writeback_control *wbc}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjuubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chMkhjuubj)}(hhh]h)}(hwriteback_control of interesth]hwriteback_control of interest}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjuhMkhjuubah}(h]h ]h"]h$]h&]uh1jhjuubeh}(h]h ]h"]h$]h&]uh1jhjuhMkhjuubj)}(h%``struct inode *inode`` target inode h](j)}(h``struct inode *inode``h]j)}(hjuh]hstruct inode *inode}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjuubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chMlhjuubj)}(hhh]h)}(h target inodeh]h target inode}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjvhMlhjvubah}(h]h ]h"]h$]h&]uh1jhjuubeh}(h]h ]h"]h$]h&]uh1jhjvhMlhjuubeh}(h]h ]h"]h$]h&]uh1jhjuubh)}(h**Description**h]j)}(hj*vh]h Description}(hj,vhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj(vubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chMnhjuubh)}(hThis function is to be used by filemap_writeback(), which is an alternative entry point into writeback code, and first ensures **inode** is associated with a bdi_writeback and attaches it to **wbc**.h](hThis function is to be used by filemap_writeback(), which is an alternative entry point into writeback code, and first ensures }(hj@vhhhNhNubj)}(h **inode**h]hinode}(hjHvhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj@vubh7 is associated with a bdi_writeback and attaches it to }(hj@vhhhNhNubj)}(h**wbc**h]hwbc}(hjZvhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj@vubh.}(hj@vhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chMmhjuubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j wbc_detach_inode (C function)c.wbc_detach_inodehNtauh1hhjOghhhNhNubj)}(hhh](j)}(h5void wbc_detach_inode (struct writeback_control *wbc)h]j)}(h4void wbc_detach_inode(struct writeback_control *wbc)h](j)}(hvoidh]hvoid}(hjvhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvhhhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM|ubj2)}(h h]h }(hjvhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjvhhhjvhM|ubjC)}(hwbc_detach_inodeh]jI)}(hwbc_detach_inodeh]hwbc_detach_inode}(hjvhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjvubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjvhhhjvhM|ubj=)}(h(struct writeback_control *wbc)h]jC)}(hstruct writeback_control *wbch](j )}(hjh]hstruct}(hjvhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjvubj2)}(h h]h }(hjvhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjvubh)}(hhh]jI)}(hwriteback_controlh]hwriteback_control}(hjvhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjvubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjvmodnameN classnameNjj )}j ]j)}jjvsbc.wbc_detach_inodeasbuh1hhjvubj2)}(h h]h }(hjwhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjvubj)}(hjh]h*}(hjwhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvubjI)}(hwbch]hwbc}(hj)whhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjvubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjvubah}(h]h ]h"]h$]h&]j`jauh1j<hjvhhhjvhM|ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjvhhhjvhM|ubah}(h]jvah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjvhM|hjvhhubjw)}(hhh]h)}(h9disassociate wbc from inode and perform foreign detectionh]h9disassociate wbc from inode and perform foreign detection}(hjSwhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM|hjPwhhubah}(h]h ]h"]h$]h&]uh1jvhjvhhhjvhM|ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjkwjjkwjjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``struct writeback_control *wbc`` writeback_control of the just finished writeback **Description** To be called after a writeback attempt of an inode finishes and undoes wbc_attach_and_unlock_inode(). Can be called under any context. As concurrent write sharing of an inode is expected to be very rare and memcg only tracks page ownership on first-use basis severely confining the usefulness of such sharing, cgroup writeback tracks ownership per-inode. While the support for concurrent write sharing of an inode is deemed unnecessary, an inode being written to by different cgroups at different points in time is a lot more common, and, more importantly, charging only by first-use can too readily lead to grossly incorrect behaviors (single foreign page can lead to gigabytes of writeback to be incorrectly attributed). To resolve this issue, cgroup writeback detects the majority dirtier of an inode and transfers the ownership to it. To avoid unnecessary oscillation, the detection mechanism keeps track of history and gives out the switch verdict only if the foreign usage pattern is stable over a certain amount of time and/or writeback attempts. On each writeback attempt, **wbc** tries to detect the majority writer using Boyer-Moore majority vote algorithm. In addition to the byte count from the majority voting, it also counts the bytes written for the current wb and the last round's winner wb (max of last round's current wb, the winner from two rounds ago, and the last round's majority candidate). Keeping track of the historical winner helps the algorithm to semi-reliably detect the most active writer even when it's not the absolute majority. Once the winner of the round is determined, whether the winner is foreign or not and how much IO time the round consumed is recorded in inode->i_wb_frn_history. If the amount of recorded foreign IO time is over a certain threshold, the switch verdict is given.h](h)}(h**Parameters**h]j)}(hjuwh]h Parameters}(hjwwhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjswubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chMhjowubj)}(hhh]j)}(hS``struct writeback_control *wbc`` writeback_control of the just finished writeback h](j)}(h!``struct writeback_control *wbc``h]j)}(hjwh]hstruct writeback_control *wbc}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjwubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM}hjwubj)}(hhh]h)}(h0writeback_control of the just finished writebackh]h0writeback_control of the just finished writeback}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjwhM}hjwubah}(h]h ]h"]h$]h&]uh1jhjwubeh}(h]h ]h"]h$]h&]uh1jhjwhM}hjwubah}(h]h ]h"]h$]h&]uh1jhjowubh)}(h**Description**h]j)}(hjwh]h Description}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjwubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chMhjowubh)}(hTo be called after a writeback attempt of an inode finishes and undoes wbc_attach_and_unlock_inode(). Can be called under any context.h]hTo be called after a writeback attempt of an inode finishes and undoes wbc_attach_and_unlock_inode(). Can be called under any context.}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM~hjowubh)}(hXLAs concurrent write sharing of an inode is expected to be very rare and memcg only tracks page ownership on first-use basis severely confining the usefulness of such sharing, cgroup writeback tracks ownership per-inode. While the support for concurrent write sharing of an inode is deemed unnecessary, an inode being written to by different cgroups at different points in time is a lot more common, and, more importantly, charging only by first-use can too readily lead to grossly incorrect behaviors (single foreign page can lead to gigabytes of writeback to be incorrectly attributed).h]hXLAs concurrent write sharing of an inode is expected to be very rare and memcg only tracks page ownership on first-use basis severely confining the usefulness of such sharing, cgroup writeback tracks ownership per-inode. While the support for concurrent write sharing of an inode is deemed unnecessary, an inode being written to by different cgroups at different points in time is a lot more common, and, more importantly, charging only by first-use can too readily lead to grossly incorrect behaviors (single foreign page can lead to gigabytes of writeback to be incorrectly attributed).}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chMhjowubh)}(hXKTo resolve this issue, cgroup writeback detects the majority dirtier of an inode and transfers the ownership to it. To avoid unnecessary oscillation, the detection mechanism keeps track of history and gives out the switch verdict only if the foreign usage pattern is stable over a certain amount of time and/or writeback attempts.h]hXKTo resolve this issue, cgroup writeback detects the majority dirtier of an inode and transfers the ownership to it. To avoid unnecessary oscillation, the detection mechanism keeps track of history and gives out the switch verdict only if the foreign usage pattern is stable over a certain amount of time and/or writeback attempts.}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chMhjowubh)}(hXOn each writeback attempt, **wbc** tries to detect the majority writer using Boyer-Moore majority vote algorithm. In addition to the byte count from the majority voting, it also counts the bytes written for the current wb and the last round's winner wb (max of last round's current wb, the winner from two rounds ago, and the last round's majority candidate). Keeping track of the historical winner helps the algorithm to semi-reliably detect the most active writer even when it's not the absolute majority.h](hOn each writeback attempt, }(hjxhhhNhNubj)}(h**wbc**h]hwbc}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjxubhX tries to detect the majority writer using Boyer-Moore majority vote algorithm. In addition to the byte count from the majority voting, it also counts the bytes written for the current wb and the last round’s winner wb (max of last round’s current wb, the winner from two rounds ago, and the last round’s majority candidate). Keeping track of the historical winner helps the algorithm to semi-reliably detect the most active writer even when it’s not the absolute majority.}(hjxhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chMhjowubh)}(hXOnce the winner of the round is determined, whether the winner is foreign or not and how much IO time the round consumed is recorded in inode->i_wb_frn_history. If the amount of recorded foreign IO time is over a certain threshold, the switch verdict is given.h]hXOnce the winner of the round is determined, whether the winner is foreign or not and how much IO time the round consumed is recorded in inode->i_wb_frn_history. If the amount of recorded foreign IO time is over a certain threshold, the switch verdict is given.}(hj3xhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chMhjowubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j %wbc_account_cgroup_owner (C function)c.wbc_account_cgroup_ownerhNtauh1hhjOghhhNhNubj)}(hhh](j)}(h`void wbc_account_cgroup_owner (struct writeback_control *wbc, struct folio *folio, size_t bytes)h]j)}(h_void wbc_account_cgroup_owner(struct writeback_control *wbc, struct folio *folio, size_t bytes)h](j)}(hvoidh]hvoid}(hjbxhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^xhhhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chMubj2)}(h h]h }(hjqxhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj^xhhhjpxhMubjC)}(hwbc_account_cgroup_ownerh]jI)}(hwbc_account_cgroup_ownerh]hwbc_account_cgroup_owner}(hjxhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjxubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj^xhhhjpxhMubj=)}(hB(struct writeback_control *wbc, struct folio *folio, size_t bytes)h](jC)}(hstruct writeback_control *wbch](j )}(hjh]hstruct}(hjxhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjxubj2)}(h h]h }(hjxhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjxubh)}(hhh]jI)}(hwriteback_controlh]hwriteback_control}(hjxhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjxubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjxmodnameN classnameNjj )}j ]j)}jjxsbc.wbc_account_cgroup_ownerasbuh1hhjxubj2)}(h h]h }(hjxhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjxubj)}(hjh]h*}(hjxhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjxubjI)}(hwbch]hwbc}(hjxhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjxubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjxubjC)}(hstruct folio *folioh](j )}(hjh]hstruct}(hjyhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj yubj2)}(h h]h }(hjyhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj yubh)}(hhh]jI)}(hfolioh]hfolio}(hj/yhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj,yubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj1ymodnameN classnameNjj )}j ]jxc.wbc_account_cgroup_ownerasbuh1hhj yubj2)}(h h]h }(hjMyhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj yubj)}(hjh]h*}(hj[yhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj yubjI)}(hfolioh]hfolio}(hjhyhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj yubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjxubjC)}(h size_t bytesh](h)}(hhh]jI)}(hsize_th]hsize_t}(hjyhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjyubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjymodnameN classnameNjj )}j ]jxc.wbc_account_cgroup_ownerasbuh1hhj}yubj2)}(h h]h }(hjyhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj}yubjI)}(hbytesh]hbytes}(hjyhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj}yubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjxubeh}(h]h ]h"]h$]h&]j`jauh1j<hj^xhhhjpxhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjZxhhhjpxhMubah}(h]jUxah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjpxhMhjWxhhubjw)}(hhh]h)}(h2account writeback to update inode cgroup ownershiph]h2account writeback to update inode cgroup ownership}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chMhjyhhubah}(h]h ]h"]h$]h&]uh1jvhjWxhhhjpxhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjyjjyjjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``struct writeback_control *wbc`` writeback_control of the writeback in progress ``struct folio *folio`` folio being written out ``size_t bytes`` number of bytes being written out **Description** **bytes** from **folio** are about to written out during the writeback controlled by **wbc**. Keep the book for foreign inode detection. See wbc_detach_inode().h](h)}(h**Parameters**h]j)}(hjyh]h Parameters}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjyubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chMhjyubj)}(hhh](j)}(hQ``struct writeback_control *wbc`` writeback_control of the writeback in progress h](j)}(h!``struct writeback_control *wbc``h]j)}(hjzh]hstruct writeback_control *wbc}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjzubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chMhjzubj)}(hhh]h)}(h.writeback_control of the writeback in progressh]h.writeback_control of the writeback in progress}(hj4zhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj0zhMhj1zubah}(h]h ]h"]h$]h&]uh1jhjzubeh}(h]h ]h"]h$]h&]uh1jhj0zhMhjzubj)}(h0``struct folio *folio`` folio being written out h](j)}(h``struct folio *folio``h]j)}(hjTzh]hstruct folio *folio}(hjVzhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjRzubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chMhjNzubj)}(hhh]h)}(hfolio being written outh]hfolio being written out}(hjmzhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjizhMhjjzubah}(h]h ]h"]h$]h&]uh1jhjNzubeh}(h]h ]h"]h$]h&]uh1jhjizhMhjzubj)}(h3``size_t bytes`` number of bytes being written out h](j)}(h``size_t bytes``h]j)}(hjzh]h size_t bytes}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjzubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chMhjzubj)}(hhh]h)}(h!number of bytes being written outh]h!number of bytes being written out}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjzhMhjzubah}(h]h ]h"]h$]h&]uh1jhjzubeh}(h]h ]h"]h$]h&]uh1jhjzhMhjzubeh}(h]h ]h"]h$]h&]uh1jhjyubh)}(h**Description**h]j)}(hjzh]h Description}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjzubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chMhjyubh)}(h**bytes** from **folio** are about to written out during the writeback controlled by **wbc**. Keep the book for foreign inode detection. See wbc_detach_inode().h](j)}(h **bytes**h]hbytes}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjzubh from }(hjzhhhNhNubj)}(h **folio**h]hfolio}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjzubh= are about to written out during the writeback controlled by }(hjzhhhNhNubj)}(h**wbc**h]hwbc}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjzubhF. Keep the book for foreign inode detection. See wbc_detach_inode().}(hjzhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chMhjyubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j -filemap_dontcache_kick_writeback (C function)"c.filemap_dontcache_kick_writebackhNtauh1hhjOghhhNhNubj)}(hhh](j)}(hEvoid filemap_dontcache_kick_writeback (struct address_space *mapping)h]j)}(hDvoid filemap_dontcache_kick_writeback(struct address_space *mapping)h](j)}(hvoidh]hvoid}(hj?{hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;{hhhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM ubj2)}(h h]h }(hjN{hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj;{hhhjM{hM ubjC)}(h filemap_dontcache_kick_writebackh]jI)}(h filemap_dontcache_kick_writebackh]h filemap_dontcache_kick_writeback}(hj`{hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj\{ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj;{hhhjM{hM ubj=)}(h(struct address_space *mapping)h]jC)}(hstruct address_space *mappingh](j )}(hjh]hstruct}(hj|{hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjx{ubj2)}(h h]h }(hj{hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjx{ubh)}(hhh]jI)}(h address_spaceh]h address_space}(hj{hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj{ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj{modnameN classnameNjj )}j ]j)}jjb{sb"c.filemap_dontcache_kick_writebackasbuh1hhjx{ubj2)}(h h]h }(hj{hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjx{ubj)}(hjh]h*}(hj{hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjx{ubjI)}(hmappingh]hmapping}(hj{hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjx{ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjt{ubah}(h]h ]h"]h$]h&]j`jauh1j<hj;{hhhjM{hM ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj7{hhhjM{hM ubah}(h]j2{ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjM{hM hj4{hhubjw)}(hhh]h)}(h&kick flusher for IOCB_DONTCACHE writesh]h&kick flusher for IOCB_DONTCACHE writes}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM hj{hhubah}(h]h ]h"]h$]h&]uh1jvhj4{hhhjM{hM ubeh}(h]h ](jfunctioneh"]h$]h&]jjjj|jj|jjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``struct address_space *mapping`` address_space that was just written to **Description** Kick the writeback flusher thread to expedite writeback of dontcache dirty pages. Queue writeback for the inode's wb for as many pages as there are dontcache pages, but don't restrict writeback to dontcache pages only. This significantly improves performance over either writing all wb's pages or writing only dontcache pages. Although it doesn't guarantee quick writeback and reclaim of dontcache pages, it keeps the amount of dirty pages in check. Over longer term dontcache pages get written and reclaimed by background writeback even with this rough heuristic.h](h)}(h**Parameters**h]j)}(hj!|h]h Parameters}(hj#|hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj|ubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM hj|ubj)}(hhh]j)}(hI``struct address_space *mapping`` address_space that was just written to h](j)}(h!``struct address_space *mapping``h]j)}(hj@|h]hstruct address_space *mapping}(hjB|hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj>|ubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM hj:|ubj)}(hhh]h)}(h&address_space that was just written toh]h&address_space that was just written to}(hjY|hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjU|hM hjV|ubah}(h]h ]h"]h$]h&]uh1jhj:|ubeh}(h]h ]h"]h$]h&]uh1jhjU|hM hj7|ubah}(h]h ]h"]h$]h&]uh1jhj|ubh)}(h**Description**h]j)}(hj{|h]h Description}(hj}|hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjy|ubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM hj|ubh)}(hKick the writeback flusher thread to expedite writeback of dontcache dirty pages. Queue writeback for the inode's wb for as many pages as there are dontcache pages, but don't restrict writeback to dontcache pages only.h]hKick the writeback flusher thread to expedite writeback of dontcache dirty pages. Queue writeback for the inode’s wb for as many pages as there are dontcache pages, but don’t restrict writeback to dontcache pages only.}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM hj|ubh)}(hXZThis significantly improves performance over either writing all wb's pages or writing only dontcache pages. Although it doesn't guarantee quick writeback and reclaim of dontcache pages, it keeps the amount of dirty pages in check. Over longer term dontcache pages get written and reclaimed by background writeback even with this rough heuristic.h]hX^This significantly improves performance over either writing all wb’s pages or writing only dontcache pages. Although it doesn’t guarantee quick writeback and reclaim of dontcache pages, it keeps the amount of dirty pages in check. Over longer term dontcache pages get written and reclaimed by background writeback even with this rough heuristic.}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM hj|ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j __mark_inode_dirty (C function)c.__mark_inode_dirtyhNtauh1hhjOghhhNhNubj)}(hhh](j)}(h8void __mark_inode_dirty (struct inode *inode, int flags)h]j)}(h7void __mark_inode_dirty(struct inode *inode, int flags)h](j)}(hvoidh]hvoid}(hj|hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|hhhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM ubj2)}(h h]h }(hj|hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj|hhhj|hM ubjC)}(h__mark_inode_dirtyh]jI)}(h__mark_inode_dirtyh]h__mark_inode_dirty}(hj|hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj|ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj|hhhj|hM ubj=)}(h (struct inode *inode, int flags)h](jC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hj }hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj}ubj2)}(h h]h }(hj}hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj}ubh)}(hhh]jI)}(hinodeh]hinode}(hj*}hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj'}ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj,}modnameN classnameNjj )}j ]j)}jj|sbc.__mark_inode_dirtyasbuh1hhj}ubj2)}(h h]h }(hjJ}hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj}ubj)}(hjh]h*}(hjX}hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj}ubjI)}(hinodeh]hinode}(hje}hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj}ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj}ubjC)}(h int flagsh](j)}(hinth]hint}(hj~}hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjz}ubj2)}(h h]h }(hj}hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjz}ubjI)}(hflagsh]hflags}(hj}hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjz}ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj}ubeh}(h]h ]h"]h$]h&]j`jauh1j<hj|hhhj|hM ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj|hhhj|hM ubah}(h]j|ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj|hM hj|hhubjw)}(hhh]h)}(h(internal function to mark an inode dirtyh]h(internal function to mark an inode dirty}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM hj}hhubah}(h]h ]h"]h$]h&]uh1jvhj|hhhj|hM ubeh}(h]h ](jfunctioneh"]h$]h&]jjjj}jj}jjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``struct inode *inode`` inode to mark ``int flags`` what kind of dirty, e.g. I_DIRTY_SYNC. This can be a combination of multiple I_DIRTY_* flags, except that I_DIRTY_TIME can't be combined with I_DIRTY_PAGES. **Description** Mark an inode as dirty. We notify the filesystem, then update the inode's dirty flags. Then, if needed we add the inode to the appropriate dirty list. Most callers should use mark_inode_dirty() or mark_inode_dirty_sync() instead of calling this directly. CAREFUL! We only add the inode to the dirty list if it is hashed or if it refers to a blockdev. Unhashed inodes will never be added to the dirty list even if they are later hashed, as they will have been marked dirty already. In short, ensure you hash any inodes _before_ you start marking them dirty. Note that for blockdevs, inode->dirtied_when represents the dirtying time of the block-special inode (/dev/hda1) itself. And the ->dirtied_when field of the kernel-internal blockdev inode represents the dirtying time of the blockdev's pages. This is why for I_DIRTY_PAGES we always use page->mapping->host, so the page-dirtying time is recorded in the internal blockdev inode.h](h)}(h**Parameters**h]j)}(hj}h]h Parameters}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj}ubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM hj}ubj)}(hhh](j)}(h&``struct inode *inode`` inode to mark h](j)}(h``struct inode *inode``h]j)}(hj~h]hstruct inode *inode}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj~ubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM hj}ubj)}(hhh]h)}(h inode to markh]h inode to mark}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj~hM hj~ubah}(h]h ]h"]h$]h&]uh1jhj}ubeh}(h]h ]h"]h$]h&]uh1jhj~hM hj}ubj)}(h``int flags`` what kind of dirty, e.g. I_DIRTY_SYNC. This can be a combination of multiple I_DIRTY_* flags, except that I_DIRTY_TIME can't be combined with I_DIRTY_PAGES. h](j)}(h ``int flags``h]j)}(hj>~h]h int flags}(hj@~hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj<~ubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM hj8~ubj)}(hhh]h)}(hwhat kind of dirty, e.g. I_DIRTY_SYNC. This can be a combination of multiple I_DIRTY_* flags, except that I_DIRTY_TIME can't be combined with I_DIRTY_PAGES.h]hwhat kind of dirty, e.g. I_DIRTY_SYNC. This can be a combination of multiple I_DIRTY_* flags, except that I_DIRTY_TIME can’t be combined with I_DIRTY_PAGES.}(hjW~hhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM hjT~ubah}(h]h ]h"]h$]h&]uh1jhj8~ubeh}(h]h ]h"]h$]h&]uh1jhjS~hM hj}ubeh}(h]h ]h"]h$]h&]uh1jhj}ubh)}(h**Description**h]j)}(hjz~h]h Description}(hj|~hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjx~ubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM hj}ubh)}(hMark an inode as dirty. We notify the filesystem, then update the inode's dirty flags. Then, if needed we add the inode to the appropriate dirty list.h]hMark an inode as dirty. We notify the filesystem, then update the inode’s dirty flags. Then, if needed we add the inode to the appropriate dirty list.}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM hj}ubh)}(hgMost callers should use mark_inode_dirty() or mark_inode_dirty_sync() instead of calling this directly.h]hgMost callers should use mark_inode_dirty() or mark_inode_dirty_sync() instead of calling this directly.}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM hj}ubh)}(hCAREFUL! We only add the inode to the dirty list if it is hashed or if it refers to a blockdev. Unhashed inodes will never be added to the dirty list even if they are later hashed, as they will have been marked dirty already.h]hCAREFUL! We only add the inode to the dirty list if it is hashed or if it refers to a blockdev. Unhashed inodes will never be added to the dirty list even if they are later hashed, as they will have been marked dirty already.}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM hj}ubh)}(hKIn short, ensure you hash any inodes _before_ you start marking them dirty.h]hKIn short, ensure you hash any inodes _before_ you start marking them dirty.}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM hj}ubh)}(hXzNote that for blockdevs, inode->dirtied_when represents the dirtying time of the block-special inode (/dev/hda1) itself. And the ->dirtied_when field of the kernel-internal blockdev inode represents the dirtying time of the blockdev's pages. This is why for I_DIRTY_PAGES we always use page->mapping->host, so the page-dirtying time is recorded in the internal blockdev inode.h]hX|Note that for blockdevs, inode->dirtied_when represents the dirtying time of the block-special inode (/dev/hda1) itself. And the ->dirtied_when field of the kernel-internal blockdev inode represents the dirtying time of the blockdev’s pages. This is why for I_DIRTY_PAGES we always use page->mapping->host, so the page-dirtying time is recorded in the internal blockdev inode.}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM hj}ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j #writeback_inodes_sb_nr (C function)c.writeback_inodes_sb_nrhNtauh1hhjOghhhNhNubj)}(hhh](j)}(h]void writeback_inodes_sb_nr (struct super_block *sb, unsigned long nr, enum wb_reason reason)h]j)}(h\void writeback_inodes_sb_nr(struct super_block *sb, unsigned long nr, enum wb_reason reason)h](j)}(hvoidh]hvoid}(hj~hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~hhhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM ubj2)}(h h]h }(hj hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj~hhhj hM ubjC)}(hwriteback_inodes_sb_nrh]jI)}(hwriteback_inodes_sb_nrh]hwriteback_inodes_sb_nr}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj~hhhj hM ubj=)}(hA(struct super_block *sb, unsigned long nr, enum wb_reason reason)h](jC)}(hstruct super_block *sbh](j )}(hjh]hstruct}(hj8hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj4ubj2)}(h h]h }(hjEhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj4ubh)}(hhh]jI)}(h super_blockh]h super_block}(hjVhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjSubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjXmodnameN classnameNjj )}j ]j)}jjsbc.writeback_inodes_sb_nrasbuh1hhj4ubj2)}(h h]h }(hjvhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj4ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4ubjI)}(hsbh]hsb}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj4ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj0ubjC)}(hunsigned long nrh](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hnrh]hnr}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj0ubjC)}(henum wb_reason reasonh](j )}(hj#h]henum}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(h wb_reasonh]h wb_reason}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jrc.writeback_inodes_sb_nrasbuh1hhjubj2)}(h h]h }(hj7hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hreasonh]hreason}(hjEhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj0ubeh}(h]h ]h"]h$]h&]j`jauh1j<hj~hhhj hM ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj~hhhj hM ubah}(h]j~ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj hM hj~hhubjw)}(hhh]h)}(h-writeback dirty inodes from given super_blockh]h-writeback dirty inodes from given super_block}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM hjlhhubah}(h]h ]h"]h$]h&]uh1jvhj~hhhj hM ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjOghNhNubj)}(hX|**Parameters** ``struct super_block *sb`` the superblock ``unsigned long nr`` the number of pages to write ``enum wb_reason reason`` reason why some writeback work initiated **Description** Start writeback on some inodes on this super_block. No guarantees are made on how many (if any) will be written, and this function does not wait for IO completion of submitted IO.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM hjubj)}(hhh](j)}(h*``struct super_block *sb`` the superblock h](j)}(h``struct super_block *sb``h]j)}(hjh]hstruct super_block *sb}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM hjubj)}(hhh]h)}(hthe superblockh]hthe superblock}(hjɀhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjŀhM hjƀubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjŀhM hjubj)}(h2``unsigned long nr`` the number of pages to write h](j)}(h``unsigned long nr``h]j)}(hjh]hunsigned long nr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM hjubj)}(hhh]h)}(hthe number of pages to writeh]hthe number of pages to write}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hjubj)}(hC``enum wb_reason reason`` reason why some writeback work initiated h](j)}(h``enum wb_reason reason``h]j)}(hj"h]henum wb_reason reason}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM hjubj)}(hhh]h)}(h(reason why some writeback work initiatedh]h(reason why some writeback work initiated}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj7hM hj8ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj7hM hjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hj]h]h Description}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj[ubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM hjubh)}(hStart writeback on some inodes on this super_block. No guarantees are made on how many (if any) will be written, and this function does not wait for IO completion of submitted IO.h]hStart writeback on some inodes on this super_block. No guarantees are made on how many (if any) will be written, and this function does not wait for IO completion of submitted IO.}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j  writeback_inodes_sb (C function)c.writeback_inodes_sbhNtauh1hhjOghhhNhNubj)}(hhh](j)}(hHvoid writeback_inodes_sb (struct super_block *sb, enum wb_reason reason)h]j)}(hGvoid writeback_inodes_sb(struct super_block *sb, enum wb_reason reason)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhM ubjC)}(hwriteback_inodes_sbh]jI)}(hwriteback_inodes_sbh]hwriteback_inodes_sb}(hjÁhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhM ubj=)}(h/(struct super_block *sb, enum wb_reason reason)h](jC)}(hstruct super_block *sbh](j )}(hjh]hstruct}(hj߁hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjہubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjہubh)}(hhh]jI)}(h super_blockh]h super_block}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jjŁsbc.writeback_inodes_sbasbuh1hhjہubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjہubj)}(hjh]h*}(hj+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjہubjI)}(hsbh]hsb}(hj8hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjہubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjׁubjC)}(henum wb_reason reasonh](j )}(hj#h]henum}(hjQhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjMubj2)}(h h]h }(hj^hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjMubh)}(hhh]jI)}(h wb_reasonh]h wb_reason}(hjohhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjlubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjqmodnameN classnameNjj )}j ]jc.writeback_inodes_sbasbuh1hhjMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjMubjI)}(hreasonh]hreason}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjMubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjׁubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhM ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhM ubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhM hjhhubjw)}(hhh]h)}(h-writeback dirty inodes from given super_blockh]h-writeback dirty inodes from given super_block}(hjłhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM hj‚hhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhM ubeh}(h]h ](jfunctioneh"]h$]h&]jjjj݂jj݂jjjuh1jhhhjOghNhNubj)}(hXK**Parameters** ``struct super_block *sb`` the superblock ``enum wb_reason reason`` reason why some writeback work was initiated **Description** Start writeback on some inodes on this super_block. No guarantees are made on how many (if any) will be written, and this function does not wait for IO completion of submitted IO.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM hjubj)}(hhh](j)}(h*``struct super_block *sb`` the superblock h](j)}(h``struct super_block *sb``h]j)}(hjh]hstruct super_block *sb}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM hjubj)}(hhh]h)}(hthe superblockh]hthe superblock}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hjubj)}(hG``enum wb_reason reason`` reason why some writeback work was initiated h](j)}(h``enum wb_reason reason``h]j)}(hj?h]henum wb_reason reason}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj=ubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM hj9ubj)}(hhh]h)}(h,reason why some writeback work was initiatedh]h,reason why some writeback work was initiated}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjThM hjUubah}(h]h ]h"]h$]h&]uh1jhj9ubeh}(h]h ]h"]h$]h&]uh1jhjThM hjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjzh]h Description}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjxubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM hjubh)}(hStart writeback on some inodes on this super_block. No guarantees are made on how many (if any) will be written, and this function does not wait for IO completion of submitted IO.h]hStart writeback on some inodes on this super_block. No guarantees are made on how many (if any) will be written, and this function does not wait for IO completion of submitted IO.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j 'try_to_writeback_inodes_sb (C function)c.try_to_writeback_inodes_sbhNtauh1hhjOghhhNhNubj)}(hhh](j)}(hOvoid try_to_writeback_inodes_sb (struct super_block *sb, enum wb_reason reason)h]j)}(hNvoid try_to_writeback_inodes_sb(struct super_block *sb, enum wb_reason reason)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM ubj2)}(h h]h }(hj΃hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhj̓hM ubjC)}(htry_to_writeback_inodes_sbh]jI)}(htry_to_writeback_inodes_sbh]htry_to_writeback_inodes_sb}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj܃ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhj̓hM ubj=)}(h/(struct super_block *sb, enum wb_reason reason)h](jC)}(hstruct super_block *sbh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hj hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(h super_blockh]h super_block}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jjsbc.try_to_writeback_inodes_sbasbuh1hhjubj2)}(h h]h }(hj:hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjHhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hsbh]hsb}(hjUhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(henum wb_reason reasonh](j )}(hj#h]henum}(hjnhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjjubj2)}(h h]h }(hj{hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjjubh)}(hhh]jI)}(h wb_reasonh]h wb_reason}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j6c.try_to_writeback_inodes_sbasbuh1hhjjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjjubjI)}(hreasonh]hreason}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhj̓hM ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhj̓hM ubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj̓hM hjhhubjw)}(hhh]h)}(h'try to start writeback if none underwayh]h'try to start writeback if none underway}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM hj߄hhubah}(h]h ]h"]h$]h&]uh1jvhjhhhj̓hM ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjOghNhNubj)}(h**Parameters** ``struct super_block *sb`` the superblock ``enum wb_reason reason`` reason why some writeback work was initiated **Description** Invoke __writeback_inodes_sb_nr if no writeback is currently underway.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM hjubj)}(hhh](j)}(h*``struct super_block *sb`` the superblock h](j)}(h``struct super_block *sb``h]j)}(hj#h]hstruct super_block *sb}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj!ubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM hjubj)}(hhh]h)}(hthe superblockh]hthe superblock}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj8hM hj9ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj8hM hjubj)}(hG``enum wb_reason reason`` reason why some writeback work was initiated h](j)}(h``enum wb_reason reason``h]j)}(hj\h]henum wb_reason reason}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjZubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM hjVubj)}(hhh]h)}(h,reason why some writeback work was initiatedh]h,reason why some writeback work was initiated}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjqhM hjrubah}(h]h ]h"]h$]h&]uh1jhjVubeh}(h]h ]h"]h$]h&]uh1jhjqhM hjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM hjubh)}(hFInvoke __writeback_inodes_sb_nr if no writeback is currently underway.h]hFInvoke __writeback_inodes_sb_nr if no writeback is currently underway.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j sync_inodes_sb (C function)c.sync_inodes_sbhNtauh1hhjOghhhNhNubj)}(hhh](j)}(h,void sync_inodes_sb (struct super_block *sb)h]j)}(h+void sync_inodes_sb(struct super_block *sb)h](j)}(hvoidh]hvoid}(hj܅hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj؅hhhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj؅hhhjhM ubjC)}(hsync_inodes_sbh]jI)}(hsync_inodes_sbh]hsync_inodes_sb}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj؅hhhjhM ubj=)}(h(struct super_block *sb)h]jC)}(hstruct super_block *sbh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hj&hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(h super_blockh]h super_block}(hj7hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj4ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj9modnameN classnameNjj )}j ]j)}jjsbc.sync_inodes_sbasbuh1hhjubj2)}(h h]h }(hjWhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hsbh]hsb}(hjrhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubah}(h]h ]h"]h$]h&]j`jauh1j<hj؅hhhjhM ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjԅhhhjhM ubah}(h]jυah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhM hjхhhubjw)}(hhh]h)}(hsync sb inode pagesh]hsync sb inode pages}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM hjhhubah}(h]h ]h"]h$]h&]uh1jvhjхhhhjhM ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjOghNhNubj)}(h**Parameters** ``struct super_block *sb`` the superblock **Description** This function writes and waits on any dirty inode belonging to this super_block.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM hjubj)}(hhh]j)}(h*``struct super_block *sb`` the superblock h](j)}(h``struct super_block *sb``h]j)}(hj݆h]hstruct super_block *sb}(hj߆hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjۆubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM hj׆ubj)}(hhh]h)}(hthe superblockh]hthe superblock}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM hjubah}(h]h ]h"]h$]h&]uh1jhj׆ubeh}(h]h ]h"]h$]h&]uh1jhjhM hjԆubah}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM hjubh)}(hPThis function writes and waits on any dirty inode belonging to this super_block.h]hPThis function writes and waits on any dirty inode belonging to this super_block.}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j write_inode_now (C function)c.write_inode_nowhNtauh1hhjOghhhNhNubj)}(hhh](j)}(h3int write_inode_now (struct inode *inode, int sync)h]j)}(h2int write_inode_now(struct inode *inode, int sync)h](j)}(hinth]hint}(hj]hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjYhhhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM ubj2)}(h h]h }(hjlhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjYhhhjkhM ubjC)}(hwrite_inode_nowh]jI)}(hwrite_inode_nowh]hwrite_inode_now}(hj~hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjzubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjYhhhjkhM ubj=)}(h(struct inode *inode, int sync)h](jC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jjsbc.write_inode_nowasbuh1hhjubj2)}(h h]h }(hj؇hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hint synch](j)}(hinth]hint}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hsynch]hsync}(hj(hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjYhhhjkhM ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjUhhhjkhM ubah}(h]jPah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjkhM hjRhhubjw)}(hhh]h)}(hwrite an inode to diskh]hwrite an inode to disk}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM hjOhhubah}(h]h ]h"]h$]h&]uh1jvhjRhhhjkhM ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjjjuh1jhhhjOghNhNubj)}(hXE**Parameters** ``struct inode *inode`` inode to write to disk ``int sync`` whether the write should be synchronous or not **Description** This function commits an inode to disk immediately if it is dirty. This is primarily needed by knfsd. The caller must either have a ref on the inode or must have set I_WILL_FREE.h](h)}(h**Parameters**h]j)}(hjth]h Parameters}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjrubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM hjnubj)}(hhh](j)}(h/``struct inode *inode`` inode to write to disk h](j)}(h``struct inode *inode``h]j)}(hjh]hstruct inode *inode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM hjubj)}(hhh]h)}(hinode to write to diskh]hinode to write to disk}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hjubj)}(h<``int sync`` whether the write should be synchronous or not h](j)}(h ``int sync``h]j)}(hj̈h]hint sync}(hjΈhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjʈubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM hjƈubj)}(hhh]h)}(h.whether the write should be synchronous or noth]h.whether the write should be synchronous or not}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjƈubeh}(h]h ]h"]h$]h&]uh1jhjhM hjubeh}(h]h ]h"]h$]h&]uh1jhjnubh)}(h**Description**h]j)}(hjh]h Description}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM hjnubh)}(heThis function commits an inode to disk immediately if it is dirty. This is primarily needed by knfsd.h]heThis function commits an inode to disk immediately if it is dirty. This is primarily needed by knfsd.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM hjnubh)}(hLThe caller must either have a ref on the inode or must have set I_WILL_FREE.h]hLThe caller must either have a ref on the inode or must have set I_WILL_FREE.}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM hjnubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j  sync_inode_metadata (C function)c.sync_inode_metadatahNtauh1hhjOghhhNhNubj)}(hhh](j)}(h7int sync_inode_metadata (struct inode *inode, int wait)h]j)}(h6int sync_inode_metadata(struct inode *inode, int wait)h](j)}(hinth]hint}(hj[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjWhhhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM# ubj2)}(h h]h }(hjjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjWhhhjihM# ubjC)}(hsync_inode_metadatah]jI)}(hsync_inode_metadatah]hsync_inode_metadata}(hj|hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjxubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjWhhhjihM# ubj=)}(h(struct inode *inode, int wait)h](jC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jj~sbc.sync_inode_metadataasbuh1hhjubj2)}(h h]h }(hj։hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hint waith](j)}(hinth]hint}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hwaith]hwait}(hj&hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjWhhhjihM# ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjShhhjihM# ubah}(h]jNah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjihM# hjPhhubjw)}(hhh]h)}(hwrite an inode to diskh]hwrite an inode to disk}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM# hjMhhubah}(h]h ]h"]h$]h&]uh1jvhjPhhhjihM# ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjhjjhjjjuh1jhhhjOghNhNubj)}(hX **Parameters** ``struct inode *inode`` the inode to sync ``int wait`` wait for I/O to complete. **Description** Write an inode to disk and adjust its dirty state after completion. **Note** only writes the actual inode, no associated data or other metadata.h](h)}(h**Parameters**h]j)}(hjrh]h Parameters}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jhjpubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM' hjlubj)}(hhh](j)}(h*``struct inode *inode`` the inode to sync h](j)}(h``struct inode *inode``h]j)}(hjh]hstruct inode *inode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM$ hjubj)}(hhh]h)}(hthe inode to synch]hthe inode to sync}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM$ hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM$ hjubj)}(h'``int wait`` wait for I/O to complete. h](j)}(h ``int wait``h]j)}(hjʊh]hint wait}(hj̊hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjȊubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM% hjĊubj)}(hhh]h)}(hwait for I/O to complete.h]hwait for I/O to complete.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjߊhM% hjubah}(h]h ]h"]h$]h&]uh1jhjĊubeh}(h]h ]h"]h$]h&]uh1jhjߊhM% hjubeh}(h]h ]h"]h$]h&]uh1jhjlubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM' hjlubh)}(hCWrite an inode to disk and adjust its dirty state after completion.h]hCWrite an inode to disk and adjust its dirty state after completion.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM& hjlubh)}(h**Note**h]j)}(hj,h]hNote}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj*ubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM( hjlubh)}(hConly writes the actual inode, no associated data or other metadata.h]hConly writes the actual inode, no associated data or other metadata.}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:71: ./fs/fs-writeback.chM) hjlubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j anon_inode_getfile (C function)c.anon_inode_getfilehNtauh1hhjOghhhNhNubj)}(hhh](j)}(hnstruct file * anon_inode_getfile (const char *name, const struct file_operations *fops, void *priv, int flags)h]j)}(hlstruct file *anon_inode_getfile(const char *name, const struct file_operations *fops, void *priv, int flags)h](j )}(hjh]hstruct}(hjqhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjmhhhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:74: ./fs/anon_inodes.chKubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjmhhhj~hKubh)}(hhh]jI)}(hfileh]hfile}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}janon_inode_getfilesbc.anon_inode_getfileasbuh1hhjmhhhj~hKubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjmhhhj~hKubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmhhhj~hKubjC)}(hanon_inode_getfileh]jI)}(hjh]hanon_inode_getfile}(hjЋhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj̋ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjmhhhj~hKubj=)}(hM(const char *name, const struct file_operations *fops, void *priv, int flags)h](jC)}(hconst char *nameh](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hcharh]hchar}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hnameh]hname}(hj/hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h"const struct file_operations *fopsh](j )}(hjJh]hconst}(hjHhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjDubj2)}(h h]h }(hjUhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjDubj )}(hjh]hstruct}(hjchhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjDubj2)}(h h]h }(hjphhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjDubh)}(hhh]jI)}(hfile_operationsh]hfile_operations}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj~ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.anon_inode_getfileasbuh1hhjDubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjDubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjDubjI)}(hfopsh]hfops}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjDubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h void *privh](j)}(hvoidh]hvoid}(hjӌhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjόubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjόubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjόubjI)}(hprivh]hpriv}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjόubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h int flagsh](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hj#hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hflagsh]hflags}(hj1hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjmhhhj~hKubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjihhhj~hKubah}(h]jdah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj~hKhjfhhubjw)}(hhh]h)}(hvcreates a new file instance by hooking it up to an anonymous inode, and a dentry that describe the "class" of the fileh]hzcreates a new file instance by hooking it up to an anonymous inode, and a dentry that describe the “class” of the file}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:74: ./fs/anon_inodes.chKhjXhhubah}(h]h ]h"]h$]h&]uh1jvhjfhhhj~hKubeh}(h]h ](jfunctioneh"]h$]h&]jjjjsjjsjjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``const char *name`` [in] name of the "class" of the new file ``const struct file_operations *fops`` [in] file operations for the new file ``void *priv`` [in] private data for the new file (will be file's private_data) ``int flags`` [in] flags **Description** Creates a new file by hooking it on a single inode. This is useful for files that do not need to have a full-fledged inode in order to operate correctly. All the files created with anon_inode_getfile() will share a single inode, hence saving memory and avoiding code duplication for the file/inode/dentry setup. Returns the newly created file* or an error pointer.h](h)}(h**Parameters**h]j)}(hj}h]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj{ubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:74: ./fs/anon_inodes.chKhjwubj)}(hhh](j)}(hA``const char *name`` [in] name of the "class" of the new file h](j)}(h``const char *name``h]j)}(hjh]hconst char *name}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:74: ./fs/anon_inodes.chKhjubj)}(hhh]h)}(h+[in] name of the "class" of the new fileh]h/[in] name of the “class” of the new file}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubj)}(hP``const struct file_operations *fops`` [in] file operations for the new file h](j)}(h&``const struct file_operations *fops``h]j)}(hjՍh]h"const struct file_operations *fops}(hj׍hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjӍubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:74: ./fs/anon_inodes.chKhjύubj)}(hhh]h)}(h([in] file operations for the new fileh]h([in] file operations for the new file}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjύubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubj)}(hS``void *priv`` [in] private data for the new file (will be file's private_data) h](j)}(h``void *priv``h]j)}(hjh]h void *priv}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:74: ./fs/anon_inodes.chKhjubj)}(hhh]h)}(hC[in] private data for the new file (will be file's private_data)h]hE[in] private data for the new file (will be file’s private_data)}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj#hKhj$ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj#hKhjubj)}(h``int flags`` [in] flags h](j)}(h ``int flags``h]j)}(hjGh]h int flags}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjEubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:74: ./fs/anon_inodes.chKhjAubj)}(hhh]h)}(h [in] flagsh]h [in] flags}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj\hKhj]ubah}(h]h ]h"]h$]h&]uh1jhjAubeh}(h]h ]h"]h$]h&]uh1jhj\hKhjubeh}(h]h ]h"]h$]h&]uh1jhjwubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:74: ./fs/anon_inodes.chKhjwubh)}(hXmCreates a new file by hooking it on a single inode. This is useful for files that do not need to have a full-fledged inode in order to operate correctly. All the files created with anon_inode_getfile() will share a single inode, hence saving memory and avoiding code duplication for the file/inode/dentry setup. Returns the newly created file* or an error pointer.h]hXmCreates a new file by hooking it on a single inode. This is useful for files that do not need to have a full-fledged inode in order to operate correctly. All the files created with anon_inode_getfile() will share a single inode, hence saving memory and avoiding code duplication for the file/inode/dentry setup. Returns the newly created file* or an error pointer.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:74: ./fs/anon_inodes.chKhjwubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j %anon_inode_getfile_fmode (C function)c.anon_inode_getfile_fmodehNtauh1hhjOghhhNhNubj)}(hhh](j)}(hstruct file * anon_inode_getfile_fmode (const char *name, const struct file_operations *fops, void *priv, int flags, fmode_t f_mode)h]j)}(hstruct file *anon_inode_getfile_fmode(const char *name, const struct file_operations *fops, void *priv, int flags, fmode_t f_mode)h](j )}(hjh]hstruct}(hjǎhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjÎhhhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:74: ./fs/anon_inodes.chKubj2)}(h h]h }(hjՎhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjÎhhhjԎhKubh)}(hhh]jI)}(hfileh]hfile}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}janon_inode_getfile_fmodesbc.anon_inode_getfile_fmodeasbuh1hhjÎhhhjԎhKubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjÎhhhjԎhKubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjÎhhhjԎhKubjC)}(hanon_inode_getfile_fmodeh]jI)}(hjh]hanon_inode_getfile_fmode}(hj&hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj"ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjÎhhhjԎhKubj=)}(h](const char *name, const struct file_operations *fops, void *priv, int flags, fmode_t f_mode)h](jC)}(hconst char *nameh](j )}(hjJh]hconst}(hjAhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj=ubj2)}(h h]h }(hjNhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj=ubj)}(hcharh]hchar}(hj\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=ubj2)}(h h]h }(hjjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj=ubj)}(hjh]h*}(hjxhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=ubjI)}(hnameh]hname}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj=ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj9ubjC)}(h"const struct file_operations *fopsh](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjƏhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hfile_operationsh]hfile_operations}(hj׏hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjԏubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjُmodnameN classnameNjj )}j ]jc.anon_inode_getfile_fmodeasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hfopsh]hfops}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj9ubjC)}(h void *privh](j)}(hvoidh]hvoid}(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%ubj2)}(h h]h }(hj7hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj%ubj)}(hjh]h*}(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%ubjI)}(hprivh]hpriv}(hjRhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj%ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj9ubjC)}(h int flagsh](j)}(hinth]hint}(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubj2)}(h h]h }(hjyhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjgubjI)}(hflagsh]hflags}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjgubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj9ubjC)}(hfmode_t f_modeh](h)}(hhh]jI)}(hfmode_th]hfmode_t}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.anon_inode_getfile_fmodeasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hf_modeh]hf_mode}(hjϐhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj9ubeh}(h]h ]h"]h$]h&]j`jauh1j<hjÎhhhjԎhKubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjԎhKubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjԎhKhjhhubjw)}(hhh]h)}(hvcreates a new file instance by hooking it up to an anonymous inode, and a dentry that describe the "class" of the fileh]hzcreates a new file instance by hooking it up to an anonymous inode, and a dentry that describe the “class” of the file}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:74: ./fs/anon_inodes.chKhjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjԎhKubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``const char *name`` [in] name of the "class" of the new file ``const struct file_operations *fops`` [in] file operations for the new file ``void *priv`` [in] private data for the new file (will be file's private_data) ``int flags`` [in] flags ``fmode_t f_mode`` [in] fmode **Description** Creates a new file by hooking it on a single inode. This is useful for files that do not need to have a full-fledged inode in order to operate correctly. All the files created with anon_inode_getfile() will share a single inode, hence saving memory and avoiding code duplication for the file/inode/dentry setup. Allows setting the fmode. Returns the newly created file* or an error pointer.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:74: ./fs/anon_inodes.chKhjubj)}(hhh](j)}(hA``const char *name`` [in] name of the "class" of the new file h](j)}(h``const char *name``h]j)}(hj:h]hconst char *name}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj8ubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:74: ./fs/anon_inodes.chKhj4ubj)}(hhh]h)}(h+[in] name of the "class" of the new fileh]h/[in] name of the “class” of the new file}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1hhjOhKhjPubah}(h]h ]h"]h$]h&]uh1jhj4ubeh}(h]h ]h"]h$]h&]uh1jhjOhKhj1ubj)}(hP``const struct file_operations *fops`` [in] file operations for the new file h](j)}(h&``const struct file_operations *fops``h]j)}(hjsh]h"const struct file_operations *fops}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjqubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:74: ./fs/anon_inodes.chKhjmubj)}(hhh]h)}(h([in] file operations for the new fileh]h([in] file operations for the new file}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjmubeh}(h]h ]h"]h$]h&]uh1jhjhKhj1ubj)}(hS``void *priv`` [in] private data for the new file (will be file's private_data) h](j)}(h``void *priv``h]j)}(hjh]h void *priv}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:74: ./fs/anon_inodes.chKhjubj)}(hhh]h)}(hC[in] private data for the new file (will be file's private_data)h]hE[in] private data for the new file (will be file’s private_data)}(hjőhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhj‘ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhj1ubj)}(h``int flags`` [in] flags h](j)}(h ``int flags``h]j)}(hjh]h int flags}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:74: ./fs/anon_inodes.chKhjߑubj)}(hhh]h)}(h [in] flagsh]h [in] flags}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjߑubeh}(h]h ]h"]h$]h&]uh1jhjhKhj1ubj)}(h!``fmode_t f_mode`` [in] fmode h](j)}(h``fmode_t f_mode``h]j)}(hjh]hfmode_t f_mode}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:74: ./fs/anon_inodes.chKhjubj)}(hhh]h)}(h [in] fmodeh]h [in] fmode}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj3hKhj4ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj3hKhj1ubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjYh]h Description}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjWubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:74: ./fs/anon_inodes.chKhjubh)}(hXCreates a new file by hooking it on a single inode. This is useful for files that do not need to have a full-fledged inode in order to operate correctly. All the files created with anon_inode_getfile() will share a single inode, hence saving memory and avoiding code duplication for the file/inode/dentry setup. Allows setting the fmode. Returns the newly created file* or an error pointer.h]hXCreates a new file by hooking it on a single inode. This is useful for files that do not need to have a full-fledged inode in order to operate correctly. All the files created with anon_inode_getfile() will share a single inode, hence saving memory and avoiding code duplication for the file/inode/dentry setup. Allows setting the fmode. Returns the newly created file* or an error pointer.}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:74: ./fs/anon_inodes.chKhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j &anon_inode_create_getfile (C function)c.anon_inode_create_getfilehNtauh1hhjOghhhNhNubj)}(hhh](j)}(hstruct file * anon_inode_create_getfile (const char *name, const struct file_operations *fops, void *priv, int flags, const struct inode *context_inode)h]j)}(hstruct file *anon_inode_create_getfile(const char *name, const struct file_operations *fops, void *priv, int flags, const struct inode *context_inode)h](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjhhhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:74: ./fs/anon_inodes.chKubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhKubh)}(hhh]jI)}(hfileh]hfile}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}janon_inode_create_getfilesbc.anon_inode_create_getfileasbuh1hhjhhhjhKubj2)}(h h]h }(hjޒhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhKubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhKubjC)}(hanon_inode_create_getfileh]jI)}(hjےh]hanon_inode_create_getfile}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhKubj=)}(hp(const char *name, const struct file_operations *fops, void *priv, int flags, const struct inode *context_inode)h](jC)}(hconst char *nameh](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hj%hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hcharh]hchar}(hj3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjAhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hnameh]hname}(hj\hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h"const struct file_operations *fopsh](j )}(hjJh]hconst}(hjuhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjqubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjqubj )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjqubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjqubh)}(hhh]jI)}(hfile_operationsh]hfile_operations}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jْc.anon_inode_create_getfileasbuh1hhjqubj2)}(h h]h }(hj̓hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjqubj)}(hjh]h*}(hjړhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjqubjI)}(hfopsh]hfops}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjqubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h void *privh](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hprivh]hpriv}(hj)hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h int flagsh](j)}(hinth]hint}(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>ubj2)}(h h]h }(hjPhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj>ubjI)}(hflagsh]hflags}(hj^hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj>ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h!const struct inode *context_inodeh](j )}(hjJh]hconst}(hjwhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjsubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjsubj )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjsubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjsubh)}(hhh]jI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jْc.anon_inode_create_getfileasbuh1hhjsubj2)}(h h]h }(hjΔhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjsubj)}(hjh]h*}(hjܔhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjsubjI)}(h context_inodeh]h context_inode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjsubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhKubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhKubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhKhjhhubjw)}(hhh]h)}(hLike anon_inode_getfile(), but creates a new !S_PRIVATE anon inode rather than reuse the singleton anon inode and calls the inode_init_security_anon() LSM hook.h]hLike anon_inode_getfile(), but creates a new !S_PRIVATE anon inode rather than reuse the singleton anon inode and calls the inode_init_security_anon() LSM hook.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:74: ./fs/anon_inodes.chKhjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhKubeh}(h]h ](jfunctioneh"]h$]h&]jjjj+jj+jjjuh1jhhhjOghNhNubj)}(hXT**Parameters** ``const char *name`` [in] name of the "class" of the new file ``const struct file_operations *fops`` [in] file operations for the new file ``void *priv`` [in] private data for the new file (will be file's private_data) ``int flags`` [in] flags ``const struct inode *context_inode`` [in] the logical relationship with the new inode (optional) **Description** Create a new anonymous inode and file pair. This can be done for two reasons: - for the inode to have its own security context, so that LSMs can enforce policy on the inode's creation; - if the caller needs a unique inode, for example in order to customize the size returned by fstat() The LSM may use **context_inode** in inode_init_security_anon(), but a reference to it is not held. Returns the newly created file* or an error pointer.h](h)}(h**Parameters**h]j)}(hj5h]h Parameters}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj3ubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:74: ./fs/anon_inodes.chKhj/ubj)}(hhh](j)}(hA``const char *name`` [in] name of the "class" of the new file h](j)}(h``const char *name``h]j)}(hjTh]hconst char *name}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjRubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:74: ./fs/anon_inodes.chKhjNubj)}(hhh]h)}(h+[in] name of the "class" of the new fileh]h/[in] name of the “class” of the new file}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjihKhjjubah}(h]h ]h"]h$]h&]uh1jhjNubeh}(h]h ]h"]h$]h&]uh1jhjihKhjKubj)}(hP``const struct file_operations *fops`` [in] file operations for the new file h](j)}(h&``const struct file_operations *fops``h]j)}(hjh]h"const struct file_operations *fops}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:74: ./fs/anon_inodes.chKhjubj)}(hhh]h)}(h([in] file operations for the new fileh]h([in] file operations for the new file}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjKubj)}(hS``void *priv`` [in] private data for the new file (will be file's private_data) h](j)}(h``void *priv``h]j)}(hjƕh]h void *priv}(hjȕhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjĕubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:74: ./fs/anon_inodes.chKhjubj)}(hhh]h)}(hC[in] private data for the new file (will be file's private_data)h]hE[in] private data for the new file (will be file’s private_data)}(hjߕhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjەhKhjܕubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjەhKhjKubj)}(h``int flags`` [in] flags h](j)}(h ``int flags``h]j)}(hjh]h int flags}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:74: ./fs/anon_inodes.chKhjubj)}(hhh]h)}(h [in] flagsh]h [in] flags}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjKubj)}(he``const struct inode *context_inode`` [in] the logical relationship with the new inode (optional) h](j)}(h%``const struct inode *context_inode``h]j)}(hj8h]h!const struct inode *context_inode}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj6ubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:74: ./fs/anon_inodes.chKhj2ubj)}(hhh]h)}(h>[in] the logical relationship with the new inode (optional)h]h>[in] the logical relationship with the new inode (optional)}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjMhKhjNubah}(h]h ]h"]h$]h&]uh1jhj2ubeh}(h]h ]h"]h$]h&]uh1jhjMhKhjKubeh}(h]h ]h"]h$]h&]uh1jhj/ubh)}(h**Description**h]j)}(hjsh]h Description}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjqubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:74: ./fs/anon_inodes.chKhj/ubh)}(hNCreate a new anonymous inode and file pair. This can be done for two reasons:h]hNCreate a new anonymous inode and file pair. This can be done for two reasons:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:74: ./fs/anon_inodes.chKhj/ubjE)}(hhh](jE)}(hifor the inode to have its own security context, so that LSMs can enforce policy on the inode's creation; h]h)}(hhfor the inode to have its own security context, so that LSMs can enforce policy on the inode's creation;h]hjfor the inode to have its own security context, so that LSMs can enforce policy on the inode’s creation;}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:74: ./fs/anon_inodes.chKhjubah}(h]h ]h"]h$]h&]uh1jEhjubjE)}(hcif the caller needs a unique inode, for example in order to customize the size returned by fstat() h]h)}(hbif the caller needs a unique inode, for example in order to customize the size returned by fstat()h]hbif the caller needs a unique inode, for example in order to customize the size returned by fstat()}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:74: ./fs/anon_inodes.chMhjubah}(h]h ]h"]h$]h&]uh1jEhjubeh}(h]h ]h"]h$]h&]jEj2uh1jEhjhKhj/ubh)}(hcThe LSM may use **context_inode** in inode_init_security_anon(), but a reference to it is not held.h](hThe LSM may use }(hjӖhhhNhNubj)}(h**context_inode**h]h context_inode}(hjۖhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjӖubhB in inode_init_security_anon(), but a reference to it is not held.}(hjӖhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:74: ./fs/anon_inodes.chMhj/ubh)}(h4Returns the newly created file* or an error pointer.h]h4Returns the newly created file* or an error pointer.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:74: ./fs/anon_inodes.chMhj/ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j anon_inode_getfd (C function)c.anon_inode_getfdhNtauh1hhjOghhhNhNubj)}(hhh](j)}(hbint anon_inode_getfd (const char *name, const struct file_operations *fops, void *priv, int flags)h]j)}(haint anon_inode_getfd(const char *name, const struct file_operations *fops, void *priv, int flags)h](j)}(hinth]hint}(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:74: ./fs/anon_inodes.chMubj2)}(h h]h }(hj2hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhj1hMubjC)}(hanon_inode_getfdh]jI)}(hanon_inode_getfdh]hanon_inode_getfd}(hjDhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj@ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhj1hMubj=)}(hM(const char *name, const struct file_operations *fops, void *priv, int flags)h](jC)}(hconst char *nameh](j )}(hjJh]hconst}(hj`hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj\ubj2)}(h h]h }(hjmhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj\ubj)}(hcharh]hchar}(hj{hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj\ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\ubjI)}(hnameh]hname}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj\ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjXubjC)}(h"const struct file_operations *fopsh](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjʗhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj )}(hjh]hstruct}(hjؗhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hfile_operationsh]hfile_operations}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jjFsbc.anon_inode_getfdasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hfopsh]hfops}(hj1hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjXubjC)}(h void *privh](j)}(hvoidh]hvoid}(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFubj2)}(h h]h }(hjXhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjFubj)}(hjh]h*}(hjfhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFubjI)}(hprivh]hpriv}(hjshhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjFubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjXubjC)}(h int flagsh](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hflagsh]hflags}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjXubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhj1hMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhj1hMubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj1hMhjhhubjw)}(hhh]h)}(hucreates a new file instance by hooking it up to an anonymous inode and a dentry that describe the "class" of the fileh]hycreates a new file instance by hooking it up to an anonymous inode and a dentry that describe the “class” of the file}(hjҘhhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:74: ./fs/anon_inodes.chMhjϘhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhj1hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``const char *name`` [in] name of the "class" of the new file ``const struct file_operations *fops`` [in] file operations for the new file ``void *priv`` [in] private data for the new file (will be file's private_data) ``int flags`` [in] flags **Description** Creates a new file by hooking it on a single inode. This is useful for files that do not need to have a full-fledged inode in order to operate correctly. All the files created with anon_inode_getfd() will use the same singleton inode, reducing memory use and avoiding code duplication for the file/inode/dentry setup. Returns a newly created file descriptor or an error code.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:74: ./fs/anon_inodes.chM"hjubj)}(hhh](j)}(hA``const char *name`` [in] name of the "class" of the new file h](j)}(h``const char *name``h]j)}(hjh]hconst char *name}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:74: ./fs/anon_inodes.chM"hj ubj)}(hhh]h)}(h+[in] name of the "class" of the new fileh]h/[in] name of the “class” of the new file}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj(hM"hj)ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj(hM"hj ubj)}(hP``const struct file_operations *fops`` [in] file operations for the new file h](j)}(h&``const struct file_operations *fops``h]j)}(hjLh]h"const struct file_operations *fops}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjJubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:74: ./fs/anon_inodes.chM#hjFubj)}(hhh]h)}(h([in] file operations for the new fileh]h([in] file operations for the new file}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1hhjahM#hjbubah}(h]h ]h"]h$]h&]uh1jhjFubeh}(h]h ]h"]h$]h&]uh1jhjahM#hj ubj)}(hS``void *priv`` [in] private data for the new file (will be file's private_data) h](j)}(h``void *priv``h]j)}(hjh]h void *priv}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:74: ./fs/anon_inodes.chM$hjubj)}(hhh]h)}(hC[in] private data for the new file (will be file's private_data)h]hE[in] private data for the new file (will be file’s private_data)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM$hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM$hj ubj)}(h``int flags`` [in] flags h](j)}(h ``int flags``h]j)}(hjh]h int flags}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:74: ./fs/anon_inodes.chM%hjubj)}(hhh]h)}(h [in] flagsh]h [in] flags}(hjיhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjәhM%hjԙubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjәhM%hj ubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:74: ./fs/anon_inodes.chM'hjubh)}(hXyCreates a new file by hooking it on a single inode. This is useful for files that do not need to have a full-fledged inode in order to operate correctly. All the files created with anon_inode_getfd() will use the same singleton inode, reducing memory use and avoiding code duplication for the file/inode/dentry setup. Returns a newly created file descriptor or an error code.h]hXyCreates a new file by hooking it on a single inode. This is useful for files that do not need to have a full-fledged inode in order to operate correctly. All the files created with anon_inode_getfd() will use the same singleton inode, reducing memory use and avoiding code duplication for the file/inode/dentry setup. Returns a newly created file descriptor or an error code.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:74: ./fs/anon_inodes.chM&hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j %setattr_should_drop_sgid (C function)c.setattr_should_drop_sgidhNtauh1hhjOghhhNhNubj)}(hhh](j)}(hWint setattr_should_drop_sgid (const struct mnt_idmap *idmap, const struct inode *inode)h]j)}(hVint setattr_should_drop_sgid(const struct mnt_idmap *idmap, const struct inode *inode)h](j)}(hinth]hint}(hj>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:hhhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:77: ./fs/attr.chKubj2)}(h h]h }(hjMhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj:hhhjLhKubjC)}(hsetattr_should_drop_sgidh]jI)}(hsetattr_should_drop_sgidh]hsetattr_should_drop_sgid}(hj_hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj[ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj:hhhjLhKubj=)}(h:(const struct mnt_idmap *idmap, const struct inode *inode)h](jC)}(hconst struct mnt_idmap *idmaph](j )}(hjJh]hconst}(hj{hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjwubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjwubj )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjwubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjwubh)}(hhh]jI)}(h mnt_idmaph]h mnt_idmap}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jjasbc.setattr_should_drop_sgidasbuh1hhjwubj2)}(h h]h }(hjԚhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjwubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjwubjI)}(hidmaph]hidmap}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjwubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjsubjC)}(hconst struct inode *inodeh](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj )}(hjh]hstruct}(hj#hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hj0hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hinodeh]hinode}(hjAhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj>ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjCmodnameN classnameNjj )}j ]jКc.setattr_should_drop_sgidasbuh1hhjubj2)}(h h]h }(hj_hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjmhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hinodeh]hinode}(hjzhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjsubeh}(h]h ]h"]h$]h&]j`jauh1j<hj:hhhjLhKubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj6hhhjLhKubah}(h]j1ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjLhKhj3hhubjw)}(hhh]h)}(h4determine whether the setgid bit needs to be removedh]h4determine whether the setgid bit needs to be removed}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:77: ./fs/attr.chKhjhhubah}(h]h ]h"]h$]h&]uh1jvhj3hhhjLhKubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``const struct mnt_idmap *idmap`` idmap of the mount **inode** was found from ``const struct inode *inode`` inode to check **Description** This function determines whether the setgid bit needs to be removed. We retain backwards compatibility and require setgid bit to be removed unconditionally if S_IXGRP is set. Otherwise we have the exact same requirements as setattr_prepare() and setattr_copy(). **Return** ATTR_KILL_SGID if setgid bit needs to be removed, 0 otherwise.h](h)}(h**Parameters**h]j)}(hjƛh]h Parameters}(hjțhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjěubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:77: ./fs/attr.chKhjubj)}(hhh](j)}(hN``const struct mnt_idmap *idmap`` idmap of the mount **inode** was found from h](j)}(h!``const struct mnt_idmap *idmap``h]j)}(hjh]hconst struct mnt_idmap *idmap}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:77: ./fs/attr.chKhjߛubj)}(hhh]h)}(h+idmap of the mount **inode** was found fromh](hidmap of the mount }(hjhhhNhNubj)}(h **inode**h]hinode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh was found from}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjߛubeh}(h]h ]h"]h$]h&]uh1jhjhKhjܛubj)}(h-``const struct inode *inode`` inode to check h](j)}(h``const struct inode *inode``h]j)}(hj0h]hconst struct inode *inode}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj.ubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:77: ./fs/attr.chKhj*ubj)}(hhh]h)}(hinode to checkh]hinode to check}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjEhKhjFubah}(h]h ]h"]h$]h&]uh1jhj*ubeh}(h]h ]h"]h$]h&]uh1jhjEhKhjܛubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjkh]h Description}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjiubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:77: ./fs/attr.chKhjubh)}(hXThis function determines whether the setgid bit needs to be removed. We retain backwards compatibility and require setgid bit to be removed unconditionally if S_IXGRP is set. Otherwise we have the exact same requirements as setattr_prepare() and setattr_copy().h]hXThis function determines whether the setgid bit needs to be removed. We retain backwards compatibility and require setgid bit to be removed unconditionally if S_IXGRP is set. Otherwise we have the exact same requirements as setattr_prepare() and setattr_copy().}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:77: ./fs/attr.chKhjubh)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:77: ./fs/attr.chKhjubh)}(h>ATTR_KILL_SGID if setgid bit needs to be removed, 0 otherwise.h]h>ATTR_KILL_SGID if setgid bit needs to be removed, 0 otherwise.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:77: ./fs/attr.chKhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j (setattr_should_drop_suidgid (C function)c.setattr_should_drop_suidgidhNtauh1hhjOghhhNhNubj)}(hhh](j)}(hTint setattr_should_drop_suidgid (const struct mnt_idmap *idmap, struct inode *inode)h]j)}(hSint setattr_should_drop_suidgid(const struct mnt_idmap *idmap, struct inode *inode)h](j)}(hinth]hint}(hjלhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjӜhhhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:77: ./fs/attr.chK1ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjӜhhhjhK1ubjC)}(hsetattr_should_drop_suidgidh]jI)}(hsetattr_should_drop_suidgidh]hsetattr_should_drop_suidgid}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjӜhhhjhK1ubj=)}(h4(const struct mnt_idmap *idmap, struct inode *inode)h](jC)}(hconst struct mnt_idmap *idmaph](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hj!hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj )}(hjh]hstruct}(hj/hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hj<hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(h mnt_idmaph]h mnt_idmap}(hjMhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjJubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjOmodnameN classnameNjj )}j ]j)}jjsbc.setattr_should_drop_suidgidasbuh1hhjubj2)}(h h]h }(hjmhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj{hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hidmaph]hidmap}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj ubjC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jic.setattr_should_drop_suidgidasbuh1hhjubj2)}(h h]h }(hjݝhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj ubeh}(h]h ]h"]h$]h&]j`jauh1j<hjӜhhhjhK1ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjϜhhhjhK1ubah}(h]jʜah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhK1hj̜hhubjw)}(hhh]h)}(h8determine whether the set{g,u}id bit needs to be droppedh]h8determine whether the set{g,u}id bit needs to be dropped}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:77: ./fs/attr.chK1hjhhubah}(h]h ]h"]h$]h&]uh1jvhj̜hhhjhK1ubeh}(h]h ](jfunctioneh"]h$]h&]jjjj:jj:jjjuh1jhhhjOghNhNubj)}(hX.**Parameters** ``const struct mnt_idmap *idmap`` idmap of the mount **inode** was found from ``struct inode *inode`` inode to check **Description** This function determines whether the set{g,u}id bits need to be removed. If the setuid bit needs to be removed ATTR_KILL_SUID is returned. If the setgid bit needs to be removed ATTR_KILL_SGID is returned. If both set{g,u}id bits need to be removed the corresponding mask of both flags is returned. **Return** A mask of ATTR_KILL_S{G,U}ID indicating which - if any - setid bits to remove, 0 otherwise.h](h)}(h**Parameters**h]j)}(hjDh]h Parameters}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjBubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:77: ./fs/attr.chK5hj>ubj)}(hhh](j)}(hN``const struct mnt_idmap *idmap`` idmap of the mount **inode** was found from h](j)}(h!``const struct mnt_idmap *idmap``h]j)}(hjch]hconst struct mnt_idmap *idmap}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1jhjaubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:77: ./fs/attr.chK3hj]ubj)}(hhh]h)}(h+idmap of the mount **inode** was found fromh](hidmap of the mount }(hj|hhhNhNubj)}(h **inode**h]hinode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj|ubh was found from}(hj|hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjxhK3hjyubah}(h]h ]h"]h$]h&]uh1jhj]ubeh}(h]h ]h"]h$]h&]uh1jhjxhK3hjZubj)}(h'``struct inode *inode`` inode to check h](j)}(h``struct inode *inode``h]j)}(hjh]hstruct inode *inode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:77: ./fs/attr.chK4hjubj)}(hhh]h)}(hinode to checkh]hinode to check}(hjǞhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjÞhK4hjĞubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjÞhK4hjZubeh}(h]h ]h"]h$]h&]uh1jhj>ubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:77: ./fs/attr.chK6hj>ubh)}(hX)This function determines whether the set{g,u}id bits need to be removed. If the setuid bit needs to be removed ATTR_KILL_SUID is returned. If the setgid bit needs to be removed ATTR_KILL_SGID is returned. If both set{g,u}id bits need to be removed the corresponding mask of both flags is returned.h]hX)This function determines whether the set{g,u}id bits need to be removed. If the setuid bit needs to be removed ATTR_KILL_SUID is returned. If the setgid bit needs to be removed ATTR_KILL_SGID is returned. If both set{g,u}id bits need to be removed the corresponding mask of both flags is returned.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:77: ./fs/attr.chK5hj>ubh)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:77: ./fs/attr.chK;hj>ubh)}(h[A mask of ATTR_KILL_S{G,U}ID indicating which - if any - setid bits to remove, 0 otherwise.h]h[A mask of ATTR_KILL_S{G,U}ID indicating which - if any - setid bits to remove, 0 otherwise.}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:77: ./fs/attr.chKubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j setattr_prepare (C function)c.setattr_preparehNtauh1hhjOghhhNhNubj)}(hhh](j)}(h^int setattr_prepare (const struct mnt_idmap *idmap, struct dentry *dentry, struct iattr *attr)h]j)}(h]int setattr_prepare(const struct mnt_idmap *idmap, struct dentry *dentry, struct iattr *attr)h](j)}(hinth]hint}(hjUhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjQhhhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:77: ./fs/attr.chKubj2)}(h h]h }(hjdhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjQhhhjchKubjC)}(hsetattr_prepareh]jI)}(hsetattr_prepareh]hsetattr_prepare}(hjvhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjrubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjQhhhjchKubj=)}(hJ(const struct mnt_idmap *idmap, struct dentry *dentry, struct iattr *attr)h](jC)}(hconst struct mnt_idmap *idmaph](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(h mnt_idmaph]h mnt_idmap}(hj˟hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjȟubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj͟modnameN classnameNjj )}j ]j)}jjxsbc.setattr_prepareasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hidmaph]hidmap}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct dentry *dentryh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hj,hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hdentryh]hdentry}(hj=hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj:ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj?modnameN classnameNjj )}j ]jc.setattr_prepareasbuh1hhjubj2)}(h h]h }(hj[hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjihhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hdentryh]hdentry}(hjvhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct iattr *attrh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hiattrh]hiattr}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.setattr_prepareasbuh1hhjubj2)}(h h]h }(hjˠhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj٠hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hattrh]hattr}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjQhhhjchKubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjMhhhjchKubah}(h]jHah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjchKhjJhhubjw)}(hhh]h)}(h2check if attribute changes to a dentry are allowedh]h2check if attribute changes to a dentry are allowed}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:77: ./fs/attr.chKhj hhubah}(h]h ]h"]h$]h&]uh1jvhjJhhhjchKubeh}(h]h ](jfunctioneh"]h$]h&]jjjj(jj(jjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``const struct mnt_idmap *idmap`` idmap of the mount the inode was found from ``struct dentry *dentry`` dentry to check ``struct iattr *attr`` attributes to change **Description** Check if we are allowed to change the attributes contained in **attr** in the given dentry. This includes the normal unix access permission checks, as well as checks for rlimits and others. The function also clears SGID bit from mode if user is not allowed to set it. Also file capabilities and IMA extended attributes are cleared if ATTR_KILL_PRIV is set. If the inode has been found through an idmapped mount the idmap of the vfsmount must be passed through **idmap**. This function will then take care to map the inode according to **idmap** before checking permissions. On non-idmapped mounts or if permission checking is to be performed on the raw inode simply pass **nop_mnt_idmap**. Should be called as the first thing in ->setattr implementations, possibly after taking additional locks.h](h)}(h**Parameters**h]j)}(hj2h]h Parameters}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj0ubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:77: ./fs/attr.chKhj,ubj)}(hhh](j)}(hN``const struct mnt_idmap *idmap`` idmap of the mount the inode was found from h](j)}(h!``const struct mnt_idmap *idmap``h]j)}(hjQh]hconst struct mnt_idmap *idmap}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1jhjOubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:77: ./fs/attr.chKhjKubj)}(hhh]h)}(h+idmap of the mount the inode was found fromh]h+idmap of the mount the inode was found from}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjfhKhjgubah}(h]h ]h"]h$]h&]uh1jhjKubeh}(h]h ]h"]h$]h&]uh1jhjfhKhjHubj)}(h*``struct dentry *dentry`` dentry to check h](j)}(h``struct dentry *dentry``h]j)}(hjh]hstruct dentry *dentry}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:77: ./fs/attr.chKhjubj)}(hhh]h)}(hdentry to checkh]hdentry to check}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjHubj)}(h,``struct iattr *attr`` attributes to change h](j)}(h``struct iattr *attr``h]j)}(hjáh]hstruct iattr *attr}(hjšhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:77: ./fs/attr.chKhjubj)}(hhh]h)}(hattributes to changeh]hattributes to change}(hjܡhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjءhKhj١ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjءhKhjHubeh}(h]h ]h"]h$]h&]uh1jhj,ubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:77: ./fs/attr.chKhj,ubh)}(hXeCheck if we are allowed to change the attributes contained in **attr** in the given dentry. This includes the normal unix access permission checks, as well as checks for rlimits and others. The function also clears SGID bit from mode if user is not allowed to set it. Also file capabilities and IMA extended attributes are cleared if ATTR_KILL_PRIV is set.h](h>Check if we are allowed to change the attributes contained in }(hjhhhNhNubj)}(h**attr**h]hattr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhX in the given dentry. This includes the normal unix access permission checks, as well as checks for rlimits and others. The function also clears SGID bit from mode if user is not allowed to set it. Also file capabilities and IMA extended attributes are cleared if ATTR_KILL_PRIV is set.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:77: ./fs/attr.chKhj,ubh)}(hXLIf the inode has been found through an idmapped mount the idmap of the vfsmount must be passed through **idmap**. This function will then take care to map the inode according to **idmap** before checking permissions. On non-idmapped mounts or if permission checking is to be performed on the raw inode simply pass **nop_mnt_idmap**.h](hgIf the inode has been found through an idmapped mount the idmap of the vfsmount must be passed through }(hj5hhhNhNubj)}(h **idmap**h]hidmap}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj5ubhB. This function will then take care to map the inode according to }(hj5hhhNhNubj)}(h **idmap**h]hidmap}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj5ubh before checking permissions. On non-idmapped mounts or if permission checking is to be performed on the raw inode simply pass }(hj5hhhNhNubj)}(h**nop_mnt_idmap**h]h nop_mnt_idmap}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1jhj5ubh.}(hj5hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:77: ./fs/attr.chKhj,ubh)}(hiShould be called as the first thing in ->setattr implementations, possibly after taking additional locks.h]hiShould be called as the first thing in ->setattr implementations, possibly after taking additional locks.}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:77: ./fs/attr.chKhj,ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j inode_newsize_ok (C function)c.inode_newsize_okhNtauh1hhjOghhhNhNubj)}(hhh](j)}(h?int inode_newsize_ok (const struct inode *inode, loff_t offset)h]j)}(h>int inode_newsize_ok(const struct inode *inode, loff_t offset)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:77: ./fs/attr.chKubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhKubjC)}(hinode_newsize_okh]jI)}(hinode_newsize_okh]hinode_newsize_ok}(hjʢhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjƢubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhKubj=)}(h*(const struct inode *inode, loff_t offset)h](jC)}(hconst struct inode *inodeh](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj!modnameN classnameNjj )}j ]j)}jj̢sbc.inode_newsize_okasbuh1hhjubj2)}(h h]h }(hj?hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjMhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hinodeh]hinode}(hjZhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjޢubjC)}(h loff_t offseth](h)}(hhh]jI)}(hloff_th]hloff_t}(hjvhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjsubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjxmodnameN classnameNjj )}j ]j;c.inode_newsize_okasbuh1hhjoubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjoubjI)}(hoffseth]hoffset}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjoubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjޢubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhKubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhKubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhKhjhhubjw)}(hhh]h)}(h+may this inode be truncated to a given sizeh]h+may this inode be truncated to a given size}(hj̣hhhNhNubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:77: ./fs/attr.chKhjɣhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhKubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjOghNhNubj)}(hX}**Parameters** ``const struct inode *inode`` the inode to be truncated ``loff_t offset`` the new size to assign to the inode **Description** inode_newsize_ok must be called with i_rwsem held exclusively. inode_newsize_ok will check filesystem limits and ulimits to check that the new inode size is within limits. inode_newsize_ok will also send SIGXFSZ when necessary. Caller must not proceed with inode size change if failure is returned. **inode** must be a file (not directory), with appropriate permissions to allow truncate (inode_newsize_ok does NOT check these conditions). **Return** 0 on success, -ve errno on failureh](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:77: ./fs/attr.chKhjubj)}(hhh](j)}(h8``const struct inode *inode`` the inode to be truncated h](j)}(h``const struct inode *inode``h]j)}(hj h]hconst struct inode *inode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:77: ./fs/attr.chKhjubj)}(hhh]h)}(hthe inode to be truncatedh]hthe inode to be truncated}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj"hKhj#ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj"hKhjubj)}(h6``loff_t offset`` the new size to assign to the inode h](j)}(h``loff_t offset``h]j)}(hjFh]h loff_t offset}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjDubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:77: ./fs/attr.chKhj@ubj)}(hhh]h)}(h#the new size to assign to the inodeh]h#the new size to assign to the inode}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj[hKhj\ubah}(h]h ]h"]h$]h&]uh1jhj@ubeh}(h]h ]h"]h$]h&]uh1jhj[hKhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:77: ./fs/attr.chKhjubh)}(h>inode_newsize_ok must be called with i_rwsem held exclusively.h]h>inode_newsize_ok must be called with i_rwsem held exclusively.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:77: ./fs/attr.chKhjubh)}(hXxinode_newsize_ok will check filesystem limits and ulimits to check that the new inode size is within limits. inode_newsize_ok will also send SIGXFSZ when necessary. Caller must not proceed with inode size change if failure is returned. **inode** must be a file (not directory), with appropriate permissions to allow truncate (inode_newsize_ok does NOT check these conditions).h](hinode_newsize_ok will check filesystem limits and ulimits to check that the new inode size is within limits. inode_newsize_ok will also send SIGXFSZ when necessary. Caller must not proceed with inode size change if failure is returned. }(hjhhhNhNubj)}(h **inode**h]hinode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh must be a file (not directory), with appropriate permissions to allow truncate (inode_newsize_ok does NOT check these conditions).}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:77: ./fs/attr.chKhjubh)}(h **Return**h]j)}(hjɤh]hReturn}(hjˤhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjǤubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:77: ./fs/attr.chKhjubh)}(h"0 on success, -ve errno on failureh]h"0 on success, -ve errno on failure}(hjߤhhhNhNubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:77: ./fs/attr.chKhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j setattr_copy (C function)c.setattr_copyhNtauh1hhjOghhhNhNubj)}(hhh](j)}(h`void setattr_copy (const struct mnt_idmap *idmap, struct inode *inode, const struct iattr *attr)h]j)}(h_void setattr_copy(const struct mnt_idmap *idmap, struct inode *inode, const struct iattr *attr)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:77: ./fs/attr.chM>ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj hhhjhM>ubjC)}(h setattr_copyh]jI)}(h setattr_copyh]h setattr_copy}(hj/hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj+ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj hhhjhM>ubj=)}(hN(const struct mnt_idmap *idmap, struct inode *inode, const struct iattr *attr)h](jC)}(hconst struct mnt_idmap *idmaph](j )}(hjJh]hconst}(hjKhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjGubj2)}(h h]h }(hjXhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjGubj )}(hjh]hstruct}(hjfhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjGubj2)}(h h]h }(hjshhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjGubh)}(hhh]jI)}(h mnt_idmaph]h mnt_idmap}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jj1sbc.setattr_copyasbuh1hhjGubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjGubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGubjI)}(hidmaph]hidmap}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjGubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjCubjC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hjإhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjԥubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjԥubh)}(hhh]jI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.setattr_copyasbuh1hhjԥubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjԥubj)}(hjh]h*}(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjԥubjI)}(hinodeh]hinode}(hj/hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjԥubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjCubjC)}(hconst struct iattr *attrh](j )}(hjJh]hconst}(hjHhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjDubj2)}(h h]h }(hjUhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjDubj )}(hjh]hstruct}(hjchhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjDubj2)}(h h]h }(hjphhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjDubh)}(hhh]jI)}(hiattrh]hiattr}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj~ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.setattr_copyasbuh1hhjDubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjDubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjDubjI)}(hattrh]hattr}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjDubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjCubeh}(h]h ]h"]h$]h&]j`jauh1j<hj hhhjhM>ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhM>ubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhM>hjhhubjw)}(hhh]h)}(h3copy simple metadata updates into the generic inodeh]h3copy simple metadata updates into the generic inode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:77: ./fs/attr.chM>hjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhM>ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``const struct mnt_idmap *idmap`` idmap of the mount the inode was found from ``struct inode *inode`` the inode to be updated ``const struct iattr *attr`` the new attributes **Description** setattr_copy must be called with i_rwsem held exclusively. setattr_copy updates the inode's metadata with that specified in attr on idmapped mounts. Necessary permission checks to determine whether or not the S_ISGID property needs to be removed are performed with the correct idmapped mount permission helpers. Noticeably missing is inode size update, which is more complex as it requires pagecache updates. If the inode has been found through an idmapped mount the idmap of the vfsmount must be passed through **idmap**. This function will then take care to map the inode according to **idmap** before checking permissions. On non-idmapped mounts or if permission checking is to be performed on the raw inode simply pass **nop_mnt_idmap**. The inode is not marked as dirty after this operation. The rationale is that for "simple" filesystems, the struct inode is the inode storage. The caller is free to mark the inode dirty afterwards if needed.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:77: ./fs/attr.chMBhjubj)}(hhh](j)}(hN``const struct mnt_idmap *idmap`` idmap of the mount the inode was found from h](j)}(h!``const struct mnt_idmap *idmap``h]j)}(hj%h]hconst struct mnt_idmap *idmap}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj#ubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:77: ./fs/attr.chM?hjubj)}(hhh]h)}(h+idmap of the mount the inode was found fromh]h+idmap of the mount the inode was found from}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj:hM?hj;ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj:hM?hjubj)}(h0``struct inode *inode`` the inode to be updated h](j)}(h``struct inode *inode``h]j)}(hj^h]hstruct inode *inode}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj\ubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:77: ./fs/attr.chM@hjXubj)}(hhh]h)}(hthe inode to be updatedh]hthe inode to be updated}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjshM@hjtubah}(h]h ]h"]h$]h&]uh1jhjXubeh}(h]h ]h"]h$]h&]uh1jhjshM@hjubj)}(h0``const struct iattr *attr`` the new attributes h](j)}(h``const struct iattr *attr``h]j)}(hjh]hconst struct iattr *attr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:77: ./fs/attr.chMAhjubj)}(hhh]h)}(hthe new attributesh]hthe new attributes}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMAhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMAhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjҧh]h Description}(hjԧhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjЧubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:77: ./fs/attr.chMChjubh)}(h:setattr_copy must be called with i_rwsem held exclusively.h]h:setattr_copy must be called with i_rwsem held exclusively.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:77: ./fs/attr.chMBhjubh)}(hX]setattr_copy updates the inode's metadata with that specified in attr on idmapped mounts. Necessary permission checks to determine whether or not the S_ISGID property needs to be removed are performed with the correct idmapped mount permission helpers. Noticeably missing is inode size update, which is more complex as it requires pagecache updates.h]hX_setattr_copy updates the inode’s metadata with that specified in attr on idmapped mounts. Necessary permission checks to determine whether or not the S_ISGID property needs to be removed are performed with the correct idmapped mount permission helpers. Noticeably missing is inode size update, which is more complex as it requires pagecache updates.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:77: ./fs/attr.chMDhjubh)}(hXLIf the inode has been found through an idmapped mount the idmap of the vfsmount must be passed through **idmap**. This function will then take care to map the inode according to **idmap** before checking permissions. On non-idmapped mounts or if permission checking is to be performed on the raw inode simply pass **nop_mnt_idmap**.h](hgIf the inode has been found through an idmapped mount the idmap of the vfsmount must be passed through }(hjhhhNhNubj)}(h **idmap**h]hidmap}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhB. This function will then take care to map the inode according to }(hjhhhNhNubj)}(h **idmap**h]hidmap}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh before checking permissions. On non-idmapped mounts or if permission checking is to be performed on the raw inode simply pass }(hjhhhNhNubj)}(h**nop_mnt_idmap**h]h nop_mnt_idmap}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:77: ./fs/attr.chMKhjubh)}(hThe inode is not marked as dirty after this operation. The rationale is that for "simple" filesystems, the struct inode is the inode storage. The caller is free to mark the inode dirty afterwards if needed.h]hThe inode is not marked as dirty after this operation. The rationale is that for “simple” filesystems, the struct inode is the inode storage. The caller is free to mark the inode dirty afterwards if needed.}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:77: ./fs/attr.chMQhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j notify_change (C function)c.notify_changehNtauh1hhjOghhhNhNubj)}(hhh](j)}(hint notify_change (const struct mnt_idmap *idmap, struct dentry *dentry, struct iattr *attr, struct delegated_inode *delegated_inode)h]j)}(hint notify_change(const struct mnt_idmap *idmap, struct dentry *dentry, struct iattr *attr, struct delegated_inode *delegated_inode)h](j)}(hinth]hint}(hjzhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvhhhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:77: ./fs/attr.chMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjvhhhjhMubjC)}(h notify_changeh]jI)}(h notify_changeh]h notify_change}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjvhhhjhMubj=)}(hs(const struct mnt_idmap *idmap, struct dentry *dentry, struct iattr *attr, struct delegated_inode *delegated_inode)h](jC)}(hconst struct mnt_idmap *idmaph](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjĨhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj )}(hjh]hstruct}(hjҨhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjߨhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(h mnt_idmaph]h mnt_idmap}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jjsbc.notify_changeasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hidmaph]hidmap}(hj+hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct dentry *dentryh](j )}(hjh]hstruct}(hjDhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj@ubj2)}(h h]h }(hjQhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj@ubh)}(hhh]jI)}(hdentryh]hdentry}(hjbhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj_ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjdmodnameN classnameNjj )}j ]j c.notify_changeasbuh1hhj@ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj@ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@ubjI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj@ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct iattr *attrh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hiattrh]hiattr}(hjҩhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjϩubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjԩmodnameN classnameNjj )}j ]j c.notify_changeasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hattrh]hattr}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h'struct delegated_inode *delegated_inodeh](j )}(hjh]hstruct}(hj$hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj ubj2)}(h h]h }(hj1hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj ubh)}(hhh]jI)}(hdelegated_inodeh]hdelegated_inode}(hjBhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj?ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjDmodnameN classnameNjj )}j ]j c.notify_changeasbuh1hhj ubj2)}(h h]h }(hj`hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj ubj)}(hjh]h*}(hjnhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubjI)}(hdelegated_inodeh]hdelegated_inode}(hj{hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjvhhhjhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjrhhhjhMubah}(h]jmah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMhjohhubjw)}(hhh]h)}(h(modify attributes of a filesystem objecth]h(modify attributes of a filesystem object}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:77: ./fs/attr.chMhjhhubah}(h]h ]h"]h$]h&]uh1jvhjohhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``const struct mnt_idmap *idmap`` idmap of the mount the inode was found from ``struct dentry *dentry`` object affected ``struct iattr *attr`` new attributes ``struct delegated_inode *delegated_inode`` returns inode, if the inode is delegated **Description** The caller must hold the i_rwsem exclusively on the affected object. If notify_change discovers a delegation in need of breaking, it will return -EWOULDBLOCK and return a reference to the inode in delegated_inode. The caller should then break the delegation and retry. Because breaking a delegation may take a long time, the caller should drop the i_rwsem before doing so. Alternatively, a caller may pass NULL for delegated_inode. This may be appropriate for callers that expect the underlying filesystem not to be NFS exported. Also, passing NULL is fine for callers holding the file open for write, as there can be no conflicting delegation in that case. If the inode has been found through an idmapped mount the idmap of the vfsmount must be passed through **idmap**. This function will then take care to map the inode according to **idmap** before checking permissions. On non-idmapped mounts or if permission checking is to be performed on the raw inode simply pass **nop_mnt_idmap**.h](h)}(h**Parameters**h]j)}(hjǪh]h Parameters}(hjɪhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjŪubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:77: ./fs/attr.chMhjubj)}(hhh](j)}(hN``const struct mnt_idmap *idmap`` idmap of the mount the inode was found from h](j)}(h!``const struct mnt_idmap *idmap``h]j)}(hjh]hconst struct mnt_idmap *idmap}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:77: ./fs/attr.chMhjubj)}(hhh]h)}(h+idmap of the mount the inode was found fromh]h+idmap of the mount the inode was found from}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjݪubj)}(h*``struct dentry *dentry`` object affected h](j)}(h``struct dentry *dentry``h]j)}(hjh]hstruct dentry *dentry}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:77: ./fs/attr.chMhjubj)}(hhh]h)}(hobject affectedh]hobject affected}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj4hMhj5ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj4hMhjݪubj)}(h&``struct iattr *attr`` new attributes h](j)}(h``struct iattr *attr``h]j)}(hjXh]hstruct iattr *attr}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjVubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:77: ./fs/attr.chMhjRubj)}(hhh]h)}(hnew attributesh]hnew attributes}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjmhMhjnubah}(h]h ]h"]h$]h&]uh1jhjRubeh}(h]h ]h"]h$]h&]uh1jhjmhMhjݪubj)}(hU``struct delegated_inode *delegated_inode`` returns inode, if the inode is delegated h](j)}(h+``struct delegated_inode *delegated_inode``h]j)}(hjh]h'struct delegated_inode *delegated_inode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:77: ./fs/attr.chMhjubj)}(hhh]h)}(h(returns inode, if the inode is delegatedh]h(returns inode, if the inode is delegated}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjݪubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hj̫h]h Description}(hjΫhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjʫubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:77: ./fs/attr.chMhjubh)}(hDThe caller must hold the i_rwsem exclusively on the affected object.h]hDThe caller must hold the i_rwsem exclusively on the affected object.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:77: ./fs/attr.chMhjubh)}(hX1If notify_change discovers a delegation in need of breaking, it will return -EWOULDBLOCK and return a reference to the inode in delegated_inode. The caller should then break the delegation and retry. Because breaking a delegation may take a long time, the caller should drop the i_rwsem before doing so.h]hX1If notify_change discovers a delegation in need of breaking, it will return -EWOULDBLOCK and return a reference to the inode in delegated_inode. The caller should then break the delegation and retry. Because breaking a delegation may take a long time, the caller should drop the i_rwsem before doing so.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:77: ./fs/attr.chMhjubh)}(hXAlternatively, a caller may pass NULL for delegated_inode. This may be appropriate for callers that expect the underlying filesystem not to be NFS exported. Also, passing NULL is fine for callers holding the file open for write, as there can be no conflicting delegation in that case.h]hXAlternatively, a caller may pass NULL for delegated_inode. This may be appropriate for callers that expect the underlying filesystem not to be NFS exported. Also, passing NULL is fine for callers holding the file open for write, as there can be no conflicting delegation in that case.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:77: ./fs/attr.chMhjubh)}(hXLIf the inode has been found through an idmapped mount the idmap of the vfsmount must be passed through **idmap**. This function will then take care to map the inode according to **idmap** before checking permissions. On non-idmapped mounts or if permission checking is to be performed on the raw inode simply pass **nop_mnt_idmap**.h](hgIf the inode has been found through an idmapped mount the idmap of the vfsmount must be passed through }(hjhhhNhNubj)}(h **idmap**h]hidmap}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhB. This function will then take care to map the inode according to }(hjhhhNhNubj)}(h **idmap**h]hidmap}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh before checking permissions. On non-idmapped mounts or if permission checking is to be performed on the raw inode simply pass }(hjhhhNhNubj)}(h**nop_mnt_idmap**h]h nop_mnt_idmap}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:77: ./fs/attr.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j d_path (C function)c.d_pathhNtauh1hhjOghhhNhNubj)}(hhh](j)}(h>char * d_path (const struct path *path, char *buf, int buflen)h]j)}(hah"]h$]h&]uh1j1hjphhhjhKubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjphhhjhKubjC)}(hd_pathh]jI)}(hd_pathh]hd_path}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjphhhjhKubj=)}(h0(const struct path *path, char *buf, int buflen)h](jC)}(hconst struct path *pathh](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjˬhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj )}(hjh]hstruct}(hj٬hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hpathh]hpath}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jjsbc.d_pathasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hpathh]hpath}(hj2hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h char *bufh](j)}(hcharh]hchar}(hjKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGubj2)}(h h]h }(hjYhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjGubj)}(hjh]h*}(hjghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGubjI)}(hbufh]hbuf}(hjthhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjGubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h int buflenh](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hbuflenh]hbuflen}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjphhhjhKubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjlhhhjhKubah}(h]jgah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhKhjihhubjw)}(hhh]h)}(hreturn the path of a dentryh]hreturn the path of a dentry}(hjӭhhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:80: ./fs/d_path.chKhjЭhhubah}(h]h ]h"]h$]h&]uh1jvhjihhhjhKubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjOghNhNubj)}(hXK**Parameters** ``const struct path *path`` path to report ``char *buf`` buffer to return value in ``int buflen`` buffer length **Description** Convert a dentry into an ASCII path name. If the entry has been deleted the string " (deleted)" is appended. Note that this is ambiguous. Returns a pointer into the buffer or an error code if the path was too long. Note: Callers should use the returned pointer, not the passed in buffer, to use the name! The implementation often starts at an offset into the buffer, and may leave 0 bytes at the start. "buflen" should be positive.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:80: ./fs/d_path.chKhjubj)}(hhh](j)}(h+``const struct path *path`` path to report h](j)}(h``const struct path *path``h]j)}(hjh]hconst struct path *path}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:80: ./fs/d_path.chKhjubj)}(hhh]h)}(hpath to reporth]hpath to report}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj)hKhj*ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj)hKhj ubj)}(h(``char *buf`` buffer to return value in h](j)}(h ``char *buf``h]j)}(hjMh]h char *buf}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjKubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:80: ./fs/d_path.chKhjGubj)}(hhh]h)}(hbuffer to return value inh]hbuffer to return value in}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjbhKhjcubah}(h]h ]h"]h$]h&]uh1jhjGubeh}(h]h ]h"]h$]h&]uh1jhjbhKhj ubj)}(h``int buflen`` buffer length h](j)}(h``int buflen``h]j)}(hjh]h int buflen}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:80: ./fs/d_path.chKhjubj)}(hhh]h)}(h buffer lengthh]h buffer length}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhj ubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjîhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:80: ./fs/d_path.chKhjubh)}(hConvert a dentry into an ASCII path name. If the entry has been deleted the string " (deleted)" is appended. Note that this is ambiguous.h]hConvert a dentry into an ASCII path name. If the entry has been deleted the string “ (deleted)” is appended. Note that this is ambiguous.}(hj׮hhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:80: ./fs/d_path.chKhjubh)}(hXReturns a pointer into the buffer or an error code if the path was too long. Note: Callers should use the returned pointer, not the passed in buffer, to use the name! The implementation often starts at an offset into the buffer, and may leave 0 bytes at the start.h]hXReturns a pointer into the buffer or an error code if the path was too long. Note: Callers should use the returned pointer, not the passed in buffer, to use the name! The implementation often starts at an offset into the buffer, and may leave 0 bytes at the start.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:80: ./fs/d_path.chMhjubh)}(h"buflen" should be positive.h]h “buflen” should be positive.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:80: ./fs/d_path.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j "dax_folio_reset_order (C function)c.dax_folio_reset_orderhNtauh1hhjOghhhNhNubj)}(hhh](j)}(h/int dax_folio_reset_order (struct folio *folio)h]j)}(h.int dax_folio_reset_order(struct folio *folio)h](j)}(hinth]hint}(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhP/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:83: ./fs/dax.chM}ubj2)}(h h]h }(hj3hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj hhhj2hM}ubjC)}(hdax_folio_reset_orderh]jI)}(hdax_folio_reset_orderh]hdax_folio_reset_order}(hjEhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjAubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj hhhj2hM}ubj=)}(h(struct folio *folio)h]jC)}(hstruct folio *folioh](j )}(hjh]hstruct}(hjahhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj]ubj2)}(h h]h }(hjnhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj]ubh)}(hhh]jI)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj|ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jjGsbc.dax_folio_reset_orderasbuh1hhj]ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj]ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj]ubjI)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj]ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjYubah}(h]h ]h"]h$]h&]j`jauh1j<hj hhhj2hM}ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhj2hM}ubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj2hM}hjhhubjw)}(hhh]h)}(h+Reset a compound DAX folio to order-0 pagesh]h+Reset a compound DAX folio to order-0 pages}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:83: ./fs/dax.chM}hjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhj2hM}ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjOghNhNubj)}(h**Parameters** ``struct folio *folio`` The folio to reset **Description** Splits a compound folio back into individual order-0 pages, clearing compound state and restoring pgmap pointers. **Return** the original folio order (0 if already order-0)h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:83: ./fs/dax.chMhjubj)}(hhh]j)}(h+``struct folio *folio`` The folio to reset h](j)}(h``struct folio *folio``h]j)}(hj%h]hstruct folio *folio}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj#ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:83: ./fs/dax.chM~hjubj)}(hhh]h)}(hThe folio to reseth]hThe folio to reset}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj:hM~hj;ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj:hM~hjubah}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hj`h]h Description}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj^ubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:83: ./fs/dax.chMhjubh)}(hqSplits a compound folio back into individual order-0 pages, clearing compound state and restoring pgmap pointers.h]hqSplits a compound folio back into individual order-0 pages, clearing compound state and restoring pgmap pointers.}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:83: ./fs/dax.chMhjubh)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:83: ./fs/dax.chMhjubh)}(h/the original folio order (0 if already order-0)h]h/the original folio order (0 if already order-0)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:83: ./fs/dax.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j dax_iomap_rw (C function)c.dax_iomap_rwhNtauh1hhjOghhhNhNubj)}(hhh](j)}(h]ssize_t dax_iomap_rw (struct kiocb *iocb, struct iov_iter *iter, const struct iomap_ops *ops)h]j)}(h\ssize_t dax_iomap_rw(struct kiocb *iocb, struct iov_iter *iter, const struct iomap_ops *ops)h](h)}(hhh]jI)}(hssize_th]hssize_t}(hjϰhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj̰ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjѰmodnameN classnameNjj )}j ]j)}j dax_iomap_rwsbc.dax_iomap_rwasbuh1hhjȰhhhP/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:83: ./fs/dax.chMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjȰhhhjhMubjC)}(h dax_iomap_rwh]jI)}(hjh]h dax_iomap_rw}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjȰhhhjhMubj=)}(hH(struct kiocb *iocb, struct iov_iter *iter, const struct iomap_ops *ops)h](jC)}(hstruct kiocb *iocbh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hj+hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hkiocbh]hkiocb}(hj<hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj9ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj>modnameN classnameNjj )}j ]jc.dax_iomap_rwasbuh1hhjubj2)}(h h]h }(hjZhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hiocbh]hiocb}(hjuhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct iov_iter *iterh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hiov_iterh]hiov_iter}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.dax_iomap_rwasbuh1hhjubj2)}(h h]h }(hjʱhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjرhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hiterh]hiter}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hconst struct iomap_ops *opsh](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hj hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hj&hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(h iomap_opsh]h iomap_ops}(hj7hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj4ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj9modnameN classnameNjj )}j ]jc.dax_iomap_rwasbuh1hhjubj2)}(h h]h }(hjUhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjchhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hopsh]hops}(hjphhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjȰhhhjhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjİhhhjhMubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMhjhhubjw)}(hhh]h)}(hPerform I/O to a DAX fileh]hPerform I/O to a DAX file}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:83: ./fs/dax.chMhjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``struct kiocb *iocb`` The control block for this I/O ``struct iov_iter *iter`` The addresses to do I/O from or to ``const struct iomap_ops *ops`` iomap ops passed from the file system **Description** This function performs read and write operations to directly mapped persistent memory. The callers needs to take care of read/write exclusion and evicting any page cache pages in the region under I/O.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:83: ./fs/dax.chMhjubj)}(hhh](j)}(h6``struct kiocb *iocb`` The control block for this I/O h](j)}(h``struct kiocb *iocb``h]j)}(hj۲h]hstruct kiocb *iocb}(hjݲhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjٲubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:83: ./fs/dax.chMhjղubj)}(hhh]h)}(hThe control block for this I/Oh]hThe control block for this I/O}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjղubeh}(h]h ]h"]h$]h&]uh1jhjhMhjҲubj)}(h=``struct iov_iter *iter`` The addresses to do I/O from or to h](j)}(h``struct iov_iter *iter``h]j)}(hjh]hstruct iov_iter *iter}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:83: ./fs/dax.chMhjubj)}(hhh]h)}(h"The addresses to do I/O from or toh]h"The addresses to do I/O from or to}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj)hMhj*ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj)hMhjҲubj)}(hF``const struct iomap_ops *ops`` iomap ops passed from the file system h](j)}(h``const struct iomap_ops *ops``h]j)}(hjMh]hconst struct iomap_ops *ops}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjKubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:83: ./fs/dax.chMhjGubj)}(hhh]h)}(h%iomap ops passed from the file systemh]h%iomap ops passed from the file system}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjbhMhjcubah}(h]h ]h"]h$]h&]uh1jhjGubeh}(h]h ]h"]h$]h&]uh1jhjbhMhjҲubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:83: ./fs/dax.chMhjubh)}(hThis function performs read and write operations to directly mapped persistent memory. The callers needs to take care of read/write exclusion and evicting any page cache pages in the region under I/O.h]hThis function performs read and write operations to directly mapped persistent memory. The callers needs to take care of read/write exclusion and evicting any page cache pages in the region under I/O.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:83: ./fs/dax.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j dax_iomap_fault (C function)c.dax_iomap_faulthNtauh1hhjOghhhNhNubj)}(hhh](j)}(hvm_fault_t dax_iomap_fault (struct vm_fault *vmf, unsigned int order, unsigned long *pfnp, int *iomap_errp, const struct iomap_ops *ops)h]j)}(hvm_fault_t dax_iomap_fault(struct vm_fault *vmf, unsigned int order, unsigned long *pfnp, int *iomap_errp, const struct iomap_ops *ops)h](h)}(hhh]jI)}(h vm_fault_th]h vm_fault_t}(hjгhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjͳubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjҳmodnameN classnameNjj )}j ]j)}jdax_iomap_faultsbc.dax_iomap_faultasbuh1hhjɳhhhP/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:83: ./fs/dax.chM)ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjɳhhhjhM)ubjC)}(hdax_iomap_faulth]jI)}(hjh]hdax_iomap_fault}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjɳhhhjhM)ubj=)}(hm(struct vm_fault *vmf, unsigned int order, unsigned long *pfnp, int *iomap_errp, const struct iomap_ops *ops)h](jC)}(hstruct vm_fault *vmfh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hj,hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hvm_faulth]hvm_fault}(hj=hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj:ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj?modnameN classnameNjj )}j ]jc.dax_iomap_faultasbuh1hhjubj2)}(h h]h }(hj[hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjihhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hvmfh]hvmf}(hjvhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hunsigned int orderh](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(horderh]horder}(hjǴhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hunsigned long *pfnph](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjܴubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjܴubj)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjܴubj2)}(h h]h }(hj hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjܴubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjܴubjI)}(hpfnph]hpfnp}(hj%hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjܴubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hint *iomap_errph](j)}(hinth]hint}(hj>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:ubj2)}(h h]h }(hjLhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj:ubj)}(hjh]h*}(hjZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:ubjI)}(h iomap_errph]h iomap_errp}(hjghhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj:ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hconst struct iomap_ops *opsh](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj|ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj|ubj )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj|ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj|ubh)}(hhh]jI)}(h iomap_opsh]h iomap_ops}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.dax_iomap_faultasbuh1hhj|ubj2)}(h h]h }(hj׵hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj|ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|ubjI)}(hopsh]hops}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj|ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjɳhhhjhM)ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjųhhhjhM)ubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhM)hj³hhubjw)}(hhh]h)}(h!handle a page fault on a DAX fileh]h!handle a page fault on a DAX file}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:83: ./fs/dax.chM)hjhhubah}(h]h ]h"]h$]h&]uh1jvhj³hhhjhM)ubeh}(h]h ](jfunctioneh"]h$]h&]jjjj4jj4jjjuh1jhhhjOghNhNubj)}(hXH**Parameters** ``struct vm_fault *vmf`` The description of the fault ``unsigned int order`` Order of the page to fault in ``unsigned long *pfnp`` PFN to insert for synchronous faults if fsync is required ``int *iomap_errp`` Storage for detailed error code in case of error ``const struct iomap_ops *ops`` Iomap ops passed from the file system **Description** When a page fault occurs, filesystems may call this helper in their fault handler for DAX files. dax_iomap_fault() assumes the caller has done all the necessary locking for page fault to proceed successfully.h](h)}(h**Parameters**h]j)}(hj>h]h Parameters}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj<ubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:83: ./fs/dax.chM-hj8ubj)}(hhh](j)}(h6``struct vm_fault *vmf`` The description of the fault h](j)}(h``struct vm_fault *vmf``h]j)}(hj]h]hstruct vm_fault *vmf}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj[ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:83: ./fs/dax.chM*hjWubj)}(hhh]h)}(hThe description of the faulth]hThe description of the fault}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjrhM*hjsubah}(h]h ]h"]h$]h&]uh1jhjWubeh}(h]h ]h"]h$]h&]uh1jhjrhM*hjTubj)}(h5``unsigned int order`` Order of the page to fault in h](j)}(h``unsigned int order``h]j)}(hjh]hunsigned int order}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:83: ./fs/dax.chM+hjubj)}(hhh]h)}(hOrder of the page to fault inh]hOrder of the page to fault in}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM+hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM+hjTubj)}(hR``unsigned long *pfnp`` PFN to insert for synchronous faults if fsync is required h](j)}(h``unsigned long *pfnp``h]j)}(hj϶h]hunsigned long *pfnp}(hjѶhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjͶubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:83: ./fs/dax.chM,hjɶubj)}(hhh]h)}(h9PFN to insert for synchronous faults if fsync is requiredh]h9PFN to insert for synchronous faults if fsync is required}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM,hjubah}(h]h ]h"]h$]h&]uh1jhjɶubeh}(h]h ]h"]h$]h&]uh1jhjhM,hjTubj)}(hE``int *iomap_errp`` Storage for detailed error code in case of error h](j)}(h``int *iomap_errp``h]j)}(hjh]hint *iomap_errp}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:83: ./fs/dax.chM-hjubj)}(hhh]h)}(h0Storage for detailed error code in case of errorh]h0Storage for detailed error code in case of error}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM-hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM-hjTubj)}(hF``const struct iomap_ops *ops`` Iomap ops passed from the file system h](j)}(h``const struct iomap_ops *ops``h]j)}(hjAh]hconst struct iomap_ops *ops}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1jhj?ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:83: ./fs/dax.chM.hj;ubj)}(hhh]h)}(h%Iomap ops passed from the file systemh]h%Iomap ops passed from the file system}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjVhM.hjWubah}(h]h ]h"]h$]h&]uh1jhj;ubeh}(h]h ]h"]h$]h&]uh1jhjVhM.hjTubeh}(h]h ]h"]h$]h&]uh1jhj8ubh)}(h**Description**h]j)}(hj|h]h Description}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjzubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:83: ./fs/dax.chM0hj8ubh)}(hWhen a page fault occurs, filesystems may call this helper in their fault handler for DAX files. dax_iomap_fault() assumes the caller has done all the necessary locking for page fault to proceed successfully.h]hWhen a page fault occurs, filesystems may call this helper in their fault handler for DAX files. dax_iomap_fault() assumes the caller has done all the necessary locking for page fault to proceed successfully.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:83: ./fs/dax.chM/hj8ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j "dax_finish_sync_fault (C function)c.dax_finish_sync_faulthNtauh1hhjOghhhNhNubj)}(hhh](j)}(h^vm_fault_t dax_finish_sync_fault (struct vm_fault *vmf, unsigned int order, unsigned long pfn)h]j)}(h]vm_fault_t dax_finish_sync_fault(struct vm_fault *vmf, unsigned int order, unsigned long pfn)h](h)}(hhh]jI)}(h vm_fault_th]h vm_fault_t}(hjķhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjƷmodnameN classnameNjj )}j ]j)}jdax_finish_sync_faultsbc.dax_finish_sync_faultasbuh1hhjhhhP/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:83: ./fs/dax.chMsubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMsubjC)}(hdax_finish_sync_faulth]jI)}(hjh]hdax_finish_sync_fault}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhMsubj=)}(h=(struct vm_fault *vmf, unsigned int order, unsigned long pfn)h](jC)}(hstruct vm_fault *vmfh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hj hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hvm_faulth]hvm_fault}(hj1hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj.ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj3modnameN classnameNjj )}j ]jc.dax_finish_sync_faultasbuh1hhjubj2)}(h h]h }(hjOhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj]hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hvmfh]hvmf}(hjjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj ubjC)}(hunsigned int orderh](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(horderh]horder}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj ubjC)}(hunsigned long pfnh](j)}(hunsignedh]hunsigned}(hjԸhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjиubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjиubj)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjиubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjиubjI)}(hpfnh]hpfn}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjиubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj ubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhMsubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhMsubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMshjhhubjw)}(hhh]h)}(hfinish synchronous page faulth]hfinish synchronous page fault}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:83: ./fs/dax.chMshj3hhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhMsubeh}(h]h ](jfunctioneh"]h$]h&]jjjjNjjNjjjuh1jhhhjOghNhNubj)}(hXW**Parameters** ``struct vm_fault *vmf`` The description of the fault ``unsigned int order`` Order of entry to be inserted ``unsigned long pfn`` PFN to insert **Description** This function ensures that the file range touched by the page fault is stored persistently on the media and handles inserting of appropriate page table entry.h](h)}(h**Parameters**h]j)}(hjXh]h Parameters}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjVubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:83: ./fs/dax.chMwhjRubj)}(hhh](j)}(h6``struct vm_fault *vmf`` The description of the fault h](j)}(h``struct vm_fault *vmf``h]j)}(hjwh]hstruct vm_fault *vmf}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjuubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:83: ./fs/dax.chMthjqubj)}(hhh]h)}(hThe description of the faulth]hThe description of the fault}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMthjubah}(h]h ]h"]h$]h&]uh1jhjqubeh}(h]h ]h"]h$]h&]uh1jhjhMthjnubj)}(h5``unsigned int order`` Order of entry to be inserted h](j)}(h``unsigned int order``h]j)}(hjh]hunsigned int order}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:83: ./fs/dax.chMuhjubj)}(hhh]h)}(hOrder of entry to be insertedh]hOrder of entry to be inserted}(hjɹhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjŹhMuhjƹubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjŹhMuhjnubj)}(h$``unsigned long pfn`` PFN to insert h](j)}(h``unsigned long pfn``h]j)}(hjh]hunsigned long pfn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:83: ./fs/dax.chMvhjubj)}(hhh]h)}(h PFN to inserth]h PFN to insert}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMvhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMvhjnubeh}(h]h ]h"]h$]h&]uh1jhjRubh)}(h**Description**h]j)}(hj$h]h Description}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj"ubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:83: ./fs/dax.chMxhjRubh)}(hThis function ensures that the file range touched by the page fault is stored persistently on the media and handles inserting of appropriate page table entry.h]hThis function ensures that the file range touched by the page fault is stored persistently on the media and handles inserting of appropriate page table entry.}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:83: ./fs/dax.chMwhjRubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j $simple_rename_timestamp (C function)c.simple_rename_timestamphNtauh1hhjOghhhNhNubj)}(hhh](j)}(hvoid simple_rename_timestamp (struct inode *old_dir, struct dentry *old_dentry, struct inode *new_dir, struct dentry *new_dentry)h]j)}(hvoid simple_rename_timestamp(struct inode *old_dir, struct dentry *old_dentry, struct inode *new_dir, struct dentry *new_dentry)h](j)}(hvoidh]hvoid}(hjihhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjehhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chM9ubj2)}(h h]h }(hjxhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjehhhjwhM9ubjC)}(hsimple_rename_timestamph]jI)}(hsimple_rename_timestamph]hsimple_rename_timestamp}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjehhhjwhM9ubj=)}(hd(struct inode *old_dir, struct dentry *old_dentry, struct inode *new_dir, struct dentry *new_dentry)h](jC)}(hstruct inode *old_dirh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hinodeh]hinode}(hjĺhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjƺmodnameN classnameNjj )}j ]j)}jjsbc.simple_rename_timestampasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hold_dirh]hold_dir}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct dentry *old_dentryh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hj%hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hdentryh]hdentry}(hj6hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj3ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj8modnameN classnameNjj )}j ]jc.simple_rename_timestampasbuh1hhjubj2)}(h h]h }(hjThhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjbhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(h old_dentryh]h old_dentry}(hjohhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct inode *new_dirh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.simple_rename_timestampasbuh1hhjubj2)}(h h]h }(hjĻhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjһhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hnew_dirh]hnew_dir}(hj߻hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct dentry *new_dentryh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.simple_rename_timestampasbuh1hhjubj2)}(h h]h }(hj4hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(h new_dentryh]h new_dentry}(hjOhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjehhhjwhM9ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjahhhjwhM9ubah}(h]j\ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjwhM9hj^hhubjw)}(hhh]h)}(h.update the various inode timestamps for renameh]h.update the various inode timestamps for rename}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chM9hjvhhubah}(h]h ]h"]h$]h&]uh1jvhj^hhhjwhM9ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``struct inode *old_dir`` old parent directory ``struct dentry *old_dentry`` dentry that is being renamed ``struct inode *new_dir`` new parent directory ``struct dentry *new_dentry`` target for rename **Description** POSIX mandates that the old and new parent directories have their ctime and mtime updated, and that inodes of **old_dentry** and **new_dentry** (if any), have their ctime updated.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chM=hjubj)}(hhh](j)}(h/``struct inode *old_dir`` old parent directory h](j)}(h``struct inode *old_dir``h]j)}(hjh]hstruct inode *old_dir}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chM:hjubj)}(hhh]h)}(hold parent directoryh]hold parent directory}(hjӼhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjϼhM:hjмubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjϼhM:hjubj)}(h;``struct dentry *old_dentry`` dentry that is being renamed h](j)}(h``struct dentry *old_dentry``h]j)}(hjh]hstruct dentry *old_dentry}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chM;hjubj)}(hhh]h)}(hdentry that is being renamedh]hdentry that is being renamed}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM;hj ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM;hjubj)}(h/``struct inode *new_dir`` new parent directory h](j)}(h``struct inode *new_dir``h]j)}(hj,h]hstruct inode *new_dir}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj*ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chM<hj&ubj)}(hhh]h)}(hnew parent directoryh]hnew parent directory}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjAhM<hjBubah}(h]h ]h"]h$]h&]uh1jhj&ubeh}(h]h ]h"]h$]h&]uh1jhjAhM<hjubj)}(h0``struct dentry *new_dentry`` target for rename h](j)}(h``struct dentry *new_dentry``h]j)}(hjeh]hstruct dentry *new_dentry}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1jhjcubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chM=hj_ubj)}(hhh]h)}(htarget for renameh]htarget for rename}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjzhM=hj{ubah}(h]h ]h"]h$]h&]uh1jhj_ubeh}(h]h ]h"]h$]h&]uh1jhjzhM=hjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chM?hjubh)}(hPOSIX mandates that the old and new parent directories have their ctime and mtime updated, and that inodes of **old_dentry** and **new_dentry** (if any), have their ctime updated.h](hnPOSIX mandates that the old and new parent directories have their ctime and mtime updated, and that inodes of }(hjhhhNhNubj)}(h**old_dentry**h]h old_dentry}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh and }(hjhhhNhNubj)}(h**new_dentry**h]h new_dentry}(hjнhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh$ (if any), have their ctime updated.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chM>hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j simple_setattr (C function)c.simple_setattrhNtauh1hhjOghhhNhNubj)}(hhh](j)}(h^int simple_setattr (const struct mnt_idmap *idmap, struct dentry *dentry, struct iattr *iattr)h]j)}(h]int simple_setattr(const struct mnt_idmap *idmap, struct dentry *dentry, struct iattr *iattr)h](j)}(hinth]hint}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMubjC)}(hsimple_setattrh]jI)}(hsimple_setattrh]hsimple_setattr}(hj*hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj&ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhMubj=)}(hK(const struct mnt_idmap *idmap, struct dentry *dentry, struct iattr *iattr)h](jC)}(hconst struct mnt_idmap *idmaph](j )}(hjJh]hconst}(hjFhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjBubj2)}(h h]h }(hjShhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjBubj )}(hjh]hstruct}(hjahhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjBubj2)}(h h]h }(hjnhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjBubh)}(hhh]jI)}(h mnt_idmaph]h mnt_idmap}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj|ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jj,sbc.simple_setattrasbuh1hhjBubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjBubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubjI)}(hidmaph]hidmap}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjBubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj>ubjC)}(hstruct dentry *dentryh](j )}(hjh]hstruct}(hjӾhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjϾubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjϾubh)}(hhh]jI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.simple_setattrasbuh1hhjϾubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjϾubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjϾubjI)}(hdentryh]hdentry}(hj*hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjϾubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj>ubjC)}(hstruct iattr *iattrh](j )}(hjh]hstruct}(hjChhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj?ubj2)}(h h]h }(hjPhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj?ubh)}(hhh]jI)}(hiattrh]hiattr}(hjahhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj^ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjcmodnameN classnameNjj )}j ]jc.simple_setattrasbuh1hhj?ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj?ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?ubjI)}(hiattrh]hiattr}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj?ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj>ubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhMubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMhjhhubjw)}(hhh]h)}(hsetattr for simple filesystemh]hsetattr for simple filesystem}(hjĿhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjܿjjܿjjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``const struct mnt_idmap *idmap`` idmap of the target mount ``struct dentry *dentry`` dentry ``struct iattr *iattr`` iattr structure **Description** Returns 0 on success, -error on failure. simple_setattr is a simple ->setattr implementation without a proper implementation of size changes. It can either be used for in-memory filesystems or special files on simple regular filesystems. Anything that needs to change on-disk or wire state on size changes needs its own setattr method.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjubj)}(hhh](j)}(h<``const struct mnt_idmap *idmap`` idmap of the target mount h](j)}(h!``const struct mnt_idmap *idmap``h]j)}(hjh]hconst struct mnt_idmap *idmap}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjubj)}(hhh]h)}(hidmap of the target mounth]hidmap of the target mount}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h!``struct dentry *dentry`` dentry h](j)}(h``struct dentry *dentry``h]j)}(hj>h]hstruct dentry *dentry}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj<ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhj8ubj)}(hhh]h)}(hdentryh]hdentry}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjShMhjTubah}(h]h ]h"]h$]h&]uh1jhj8ubeh}(h]h ]h"]h$]h&]uh1jhjShMhjubj)}(h(``struct iattr *iattr`` iattr structure h](j)}(h``struct iattr *iattr``h]j)}(hjwh]hstruct iattr *iattr}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjuubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjqubj)}(hhh]h)}(hiattr structureh]hiattr structure}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjqubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjubh)}(h(Returns 0 on success, -error on failure.h]h(Returns 0 on success, -error on failure.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjubh)}(hdsimple_setattr is a simple ->setattr implementation without a proper implementation of size changes.h]hdsimple_setattr is a simple ->setattr implementation without a proper implementation of size changes.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjubh)}(hIt can either be used for in-memory filesystems or special files on simple regular filesystems. Anything that needs to change on-disk or wire state on size changes needs its own setattr method.h]hIt can either be used for in-memory filesystems or special files on simple regular filesystems. Anything that needs to change on-disk or wire state on size changes needs its own setattr method.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j $simple_read_from_buffer (C function)c.simple_read_from_bufferhNtauh1hhjOghhhNhNubj)}(hhh](j)}(hqssize_t simple_read_from_buffer (void __user *to, size_t count, loff_t *ppos, const void *from, size_t available)h]j)}(hpssize_t simple_read_from_buffer(void __user *to, size_t count, loff_t *ppos, const void *from, size_t available)h](h)}(hhh]jI)}(hssize_th]hssize_t}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jsimple_read_from_buffersbc.simple_read_from_bufferasbuh1hhjhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMlubj2)}(h h]h }(hj:hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhj9hMlubjC)}(hsimple_read_from_bufferh]jI)}(hj6h]hsimple_read_from_buffer}(hjLhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjHubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhj9hMlubj=)}(hQ(void __user *to, size_t count, loff_t *ppos, const void *from, size_t available)h](jC)}(hvoid __user *toh](j)}(hvoidh]hvoid}(hjghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjcubj2)}(h h]h }(hjuhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjcubh__user}(hjchhhNhNubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjcubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjcubjI)}(htoh]hto}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjcubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj_ubjC)}(h size_t counth](h)}(hhh]jI)}(hsize_th]hsize_t}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j4c.simple_read_from_bufferasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hcounth]hcount}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj_ubjC)}(h loff_t *pposh](h)}(hhh]jI)}(hloff_th]hloff_t}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j4c.simple_read_from_bufferasbuh1hhjubj2)}(h h]h }(hj$hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hpposh]hppos}(hj?hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj_ubjC)}(hconst void *fromh](j )}(hjJh]hconst}(hjXhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjTubj2)}(h h]h }(hjehhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjTubj)}(hvoidh]hvoid}(hjshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjTubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjTubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjTubjI)}(hfromh]hfrom}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjTubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj_ubjC)}(hsize_t availableh](h)}(hhh]jI)}(hsize_th]hsize_t}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j4c.simple_read_from_bufferasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(h availableh]h available}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj_ubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhj9hMlubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj hhhj9hMlubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj9hMlhj hhubjw)}(hhh]h)}(h'copy data from the buffer to user spaceh]h'copy data from the buffer to user space}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMlhj hhubah}(h]h ]h"]h$]h&]uh1jvhj hhhj9hMlubeh}(h]h ](jfunctioneh"]h$]h&]jjjj&jj&jjjuh1jhhhjOghNhNubj)}(hXS**Parameters** ``void __user *to`` the user space buffer to read to ``size_t count`` the maximum number of bytes to read ``loff_t *ppos`` the current position in the buffer ``const void *from`` the buffer to read from ``size_t available`` the size of the buffer **Description** The simple_read_from_buffer() function reads up to **count** bytes from the buffer **from** at offset **ppos** into the user space address starting at **to**. On success, the number of bytes read is returned and the offset **ppos** is advanced by this number, or negative value is returned on error.h](h)}(h**Parameters**h]j)}(hj0h]h Parameters}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj.ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMphj*ubj)}(hhh](j)}(h5``void __user *to`` the user space buffer to read to h](j)}(h``void __user *to``h]j)}(hjOh]hvoid __user *to}(hjQhh!hNhNubah}(h]h ]h"]h$]h&]uh1jhjMubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMmhjIubj)}(hhh]h)}(h the user space buffer to read toh]h the user space buffer to read to}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjdhMmhjeubah}(h]h ]h"]h$]h&]uh1jhjIubeh}(h]h ]h"]h$]h&]uh1jhjdhMmhjFubj)}(h5``size_t count`` the maximum number of bytes to read h](j)}(h``size_t count``h]j)}(hjh]h size_t count}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMnhjubj)}(hhh]h)}(h#the maximum number of bytes to readh]h#the maximum number of bytes to read}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMnhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMnhjFubj)}(h4``loff_t *ppos`` the current position in the buffer h](j)}(h``loff_t *ppos``h]j)}(hjh]h loff_t *ppos}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMohjubj)}(hhh]h)}(h"the current position in the bufferh]h"the current position in the buffer}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMohjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMohjFubj)}(h-``const void *from`` the buffer to read from h](j)}(h``const void *from``h]j)}(hjh]hconst void *from}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMphjubj)}(hhh]h)}(hthe buffer to read fromh]hthe buffer to read from}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMphjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMphjFubj)}(h,``size_t available`` the size of the buffer h](j)}(h``size_t available``h]j)}(hj3h]hsize_t available}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj1ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMqhj-ubj)}(hhh]h)}(hthe size of the bufferh]hthe size of the buffer}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjHhMqhjIubah}(h]h ]h"]h$]h&]uh1jhj-ubeh}(h]h ]h"]h$]h&]uh1jhjHhMqhjFubeh}(h]h ]h"]h$]h&]uh1jhj*ubh)}(h**Description**h]j)}(hjnh]h Description}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1jhjlubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMshj*ubh)}(hThe simple_read_from_buffer() function reads up to **count** bytes from the buffer **from** at offset **ppos** into the user space address starting at **to**.h](h3The simple_read_from_buffer() function reads up to }(hjhhhNhNubj)}(h **count**h]hcount}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh bytes from the buffer }(hjhhhNhNubj)}(h**from**h]hfrom}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh at offset }(hjhhhNhNubj)}(h**ppos**h]hppos}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh) into the user space address starting at }(hjhhhNhNubj)}(h**to**h]hto}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMrhj*ubh)}(hOn success, the number of bytes read is returned and the offset **ppos** is advanced by this number, or negative value is returned on error.h](h@On success, the number of bytes read is returned and the offset }(hjhhhNhNubj)}(h**ppos**h]hppos}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhD is advanced by this number, or negative value is returned on error.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMuhj*ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j #simple_write_to_buffer (C function)c.simple_write_to_bufferhNtauh1hhjOghhhNhNubj)}(hhh](j)}(hpssize_t simple_write_to_buffer (void *to, size_t available, loff_t *ppos, const void __user *from, size_t count)h]j)}(hossize_t simple_write_to_buffer(void *to, size_t available, loff_t *ppos, const void __user *from, size_t count)h](h)}(hhh]jI)}(hssize_th]hssize_t}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj!modnameN classnameNjj )}j ]j)}jsimple_write_to_buffersbc.simple_write_to_bufferasbuh1hhjhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMubj2)}(h h]h }(hjAhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhj@hMubjC)}(hsimple_write_to_bufferh]jI)}(hj=h]hsimple_write_to_buffer}(hjShhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjOubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhj@hMubj=)}(hQ(void *to, size_t available, loff_t *ppos, const void __user *from, size_t count)h](jC)}(hvoid *toh](j)}(hvoidh]hvoid}(hjnhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjjubj2)}(h h]h }(hj|hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjjubjI)}(htoh]hto}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjfubjC)}(hsize_t availableh](h)}(hhh]jI)}(hsize_th]hsize_t}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j;c.simple_write_to_bufferasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(h availableh]h available}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjfubjC)}(h loff_t *pposh](h)}(hhh]jI)}(hloff_th]hloff_t}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j;c.simple_write_to_bufferasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hpposh]hppos}(hj4hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjfubjC)}(hconst void __user *fromh](j )}(hjJh]hconst}(hjMhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjIubj2)}(h h]h }(hjZhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjIubj)}(hvoidh]hvoid}(hjhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIubj2)}(h h]h }(hjvhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjIubh__user}(hjIhhhNhNubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjIubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIubjI)}(hfromh]hfrom}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjIubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjfubjC)}(h size_t counth](h)}(hhh]jI)}(hsize_th]hsize_t}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j;c.simple_write_to_bufferasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hcounth]hcount}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjfubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhj@hMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhj@hMubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj@hMhjhhubjw)}(hhh]h)}(h'copy data from user space to the bufferh]h'copy data from user space to the buffer}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhj@hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjj-jj-jjjuh1jhhhjOghNhNubj)}(hXV**Parameters** ``void *to`` the buffer to write to ``size_t available`` the size of the buffer ``loff_t *ppos`` the current position in the buffer ``const void __user *from`` the user space buffer to read from ``size_t count`` the maximum number of bytes to read **Description** The simple_write_to_buffer() function reads up to **count** bytes from the user space address starting at **from** into the buffer **to** at offset **ppos**. On success, the number of bytes written is returned and the offset **ppos** is advanced by this number, or negative value is returned on error.h](h)}(h**Parameters**h]j)}(hj7h]h Parameters}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj5ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhj1ubj)}(hhh](j)}(h$``void *to`` the buffer to write to h](j)}(h ``void *to``h]j)}(hjVh]hvoid *to}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjTubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjPubj)}(hhh]h)}(hthe buffer to write toh]hthe buffer to write to}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1hhjkhMhjlubah}(h]h ]h"]h$]h&]uh1jhjPubeh}(h]h ]h"]h$]h&]uh1jhjkhMhjMubj)}(h,``size_t available`` the size of the buffer h](j)}(h``size_t available``h]j)}(hjh]hsize_t available}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjubj)}(hhh]h)}(hthe size of the bufferh]hthe size of the buffer}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjMubj)}(h4``loff_t *ppos`` the current position in the buffer h](j)}(h``loff_t *ppos``h]j)}(hjh]h loff_t *ppos}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjubj)}(hhh]h)}(h"the current position in the bufferh]h"the current position in the buffer}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjMubj)}(h?``const void __user *from`` the user space buffer to read from h](j)}(h``const void __user *from``h]j)}(hjh]hconst void __user *from}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjubj)}(hhh]h)}(h"the user space buffer to read fromh]h"the user space buffer to read from}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjMubj)}(h5``size_t count`` the maximum number of bytes to read h](j)}(h``size_t count``h]j)}(hj:h]h size_t count}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj8ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhj4ubj)}(hhh]h)}(h#the maximum number of bytes to readh]h#the maximum number of bytes to read}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1hhjOhMhjPubah}(h]h ]h"]h$]h&]uh1jhj4ubeh}(h]h ]h"]h$]h&]uh1jhjOhMhjMubeh}(h]h ]h"]h$]h&]uh1jhj1ubh)}(h**Description**h]j)}(hjuh]h Description}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjsubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhj1ubh)}(hThe simple_write_to_buffer() function reads up to **count** bytes from the user space address starting at **from** into the buffer **to** at offset **ppos**.h](h2The simple_write_to_buffer() function reads up to }(hjhhhNhNubj)}(h **count**h]hcount}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh/ bytes from the user space address starting at }(hjhhhNhNubj)}(h**from**h]hfrom}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh into the buffer }(hjhhhNhNubj)}(h**to**h]hto}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh at offset }(hjhhhNhNubj)}(h**ppos**h]hppos}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhj1ubh)}(hOn success, the number of bytes written is returned and the offset **ppos** is advanced by this number, or negative value is returned on error.h](hCOn success, the number of bytes written is returned and the offset }(hjhhhNhNubj)}(h**ppos**h]hppos}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhD is advanced by this number, or negative value is returned on error.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhj1ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j $memory_read_from_buffer (C function)c.memory_read_from_bufferhNtauh1hhjOghhhNhNubj)}(hhh](j)}(hjssize_t memory_read_from_buffer (void *to, size_t count, loff_t *ppos, const void *from, size_t available)h]j)}(hissize_t memory_read_from_buffer(void *to, size_t count, loff_t *ppos, const void *from, size_t available)h](h)}(hhh]jI)}(hssize_th]hssize_t}(hj&hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj#ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj(modnameN classnameNjj )}j ]j)}jmemory_read_from_buffersbc.memory_read_from_bufferasbuh1hhjhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMubj2)}(h h]h }(hjHhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjGhMubjC)}(hmemory_read_from_bufferh]jI)}(hjDh]hmemory_read_from_buffer}(hjZhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjVubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjGhMubj=)}(hJ(void *to, size_t count, loff_t *ppos, const void *from, size_t available)h](jC)}(hvoid *toh](j)}(hvoidh]hvoid}(hjuhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjqubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjqubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjqubjI)}(htoh]hto}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjqubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjmubjC)}(h size_t counth](h)}(hhh]jI)}(hsize_th]hsize_t}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jBc.memory_read_from_bufferasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hcounth]hcount}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjmubjC)}(h loff_t *pposh](h)}(hhh]jI)}(hloff_th]hloff_t}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jBc.memory_read_from_bufferasbuh1hhjubj2)}(h h]h }(hj hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hpposh]hppos}(hj;hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjmubjC)}(hconst void *fromh](j )}(hjJh]hconst}(hjThhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjPubj2)}(h h]h }(hjahhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjPubj)}(hvoidh]hvoid}(hjohhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjPubj2)}(h h]h }(hj}hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjPubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjPubjI)}(hfromh]hfrom}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjPubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjmubjC)}(hsize_t availableh](h)}(hhh]jI)}(hsize_th]hsize_t}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jBc.memory_read_from_bufferasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(h availableh]h available}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjmubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjGhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjGhMubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjGhMhjhhubjw)}(hhh]h)}(hcopy data from the bufferh]hcopy data from the buffer}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjGhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjj"jj"jjjuh1jhhhjOghNhNubj)}(hXP**Parameters** ``void *to`` the kernel space buffer to read to ``size_t count`` the maximum number of bytes to read ``loff_t *ppos`` the current position in the buffer ``const void *from`` the buffer to read from ``size_t available`` the size of the buffer **Description** The memory_read_from_buffer() function reads up to **count** bytes from the buffer **from** at offset **ppos** into the kernel space address starting at **to**. On success, the number of bytes read is returned and the offset **ppos** is advanced by this number, or negative value is returned on error.h](h)}(h**Parameters**h]j)}(hj,h]h Parameters}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj*ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhj&ubj)}(hhh](j)}(h0``void *to`` the kernel space buffer to read to h](j)}(h ``void *to``h]j)}(hjKh]hvoid *to}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjIubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjEubj)}(hhh]h)}(h"the kernel space buffer to read toh]h"the kernel space buffer to read to}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj`hMhjaubah}(h]h ]h"]h$]h&]uh1jhjEubeh}(h]h ]h"]h$]h&]uh1jhj`hMhjBubj)}(h5``size_t count`` the maximum number of bytes to read h](j)}(h``size_t count``h]j)}(hjh]h size_t count}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhj~ubj)}(hhh]h)}(h#the maximum number of bytes to readh]h#the maximum number of bytes to read}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhj~ubeh}(h]h ]h"]h$]h&]uh1jhjhMhjBubj)}(h4``loff_t *ppos`` the current position in the buffer h](j)}(h``loff_t *ppos``h]j)}(hjh]h loff_t *ppos}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjubj)}(hhh]h)}(h"the current position in the bufferh]h"the current position in the buffer}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjBubj)}(h-``const void *from`` the buffer to read from h](j)}(h``const void *from``h]j)}(hjh]hconst void *from}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjubj)}(hhh]h)}(hthe buffer to read fromh]hthe buffer to read from}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMhj ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj hMhjBubj)}(h,``size_t available`` the size of the buffer h](j)}(h``size_t available``h]j)}(hj/h]hsize_t available}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj-ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhj)ubj)}(hhh]h)}(hthe size of the bufferh]hthe size of the buffer}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjDhMhjEubah}(h]h ]h"]h$]h&]uh1jhj)ubeh}(h]h ]h"]h$]h&]uh1jhjDhMhjBubeh}(h]h ]h"]h$]h&]uh1jhj&ubh)}(h**Description**h]j)}(hjjh]h Description}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjhubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhj&ubh)}(hThe memory_read_from_buffer() function reads up to **count** bytes from the buffer **from** at offset **ppos** into the kernel space address starting at **to**.h](h3The memory_read_from_buffer() function reads up to }(hjhhhNhNubj)}(h **count**h]hcount}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh bytes from the buffer }(hjhhhNhNubj)}(h**from**h]hfrom}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh at offset }(hjhhhNhNubj)}(h**ppos**h]hppos}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh+ into the kernel space address starting at }(hjhhhNhNubj)}(h**to**h]hto}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhj&ubh)}(hOn success, the number of bytes read is returned and the offset **ppos** is advanced by this number, or negative value is returned on error.h](h@On success, the number of bytes read is returned and the offset }(hjhhhNhNubj)}(h**ppos**h]hppos}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhD is advanced by this number, or negative value is returned on error.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhj&ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j $generic_encode_ino32_fh (C function)c.generic_encode_ino32_fhhNtauh1hhjOghhhNhNubj)}(hhh](j)}(h`int generic_encode_ino32_fh (struct inode *inode, __u32 *fh, int *max_len, struct inode *parent)h]j)}(h_int generic_encode_ino32_fh(struct inode *inode, __u32 *fh, int *max_len, struct inode *parent)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMubj2)}(h h]h }(hj'hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhj&hMubjC)}(hgeneric_encode_ino32_fhh]jI)}(hgeneric_encode_ino32_fhh]hgeneric_encode_ino32_fh}(hj9hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj5ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhj&hMubj=)}(hD(struct inode *inode, __u32 *fh, int *max_len, struct inode *parent)h](jC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hjUhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjQubj2)}(h h]h }(hjbhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjQubh)}(hhh]jI)}(hinodeh]hinode}(hjshhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjpubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjumodnameN classnameNjj )}j ]j)}jj;sbc.generic_encode_ino32_fhasbuh1hhjQubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjQubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjQubjI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjQubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjMubjC)}(h __u32 *fhh](h)}(hhh]jI)}(h__u32h]h__u32}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.generic_encode_ino32_fhasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hfhh]hfh}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjMubjC)}(h int *max_lenh](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hj*hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj8hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hmax_lenh]hmax_len}(hjEhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjMubjC)}(hstruct inode *parenth](j )}(hjh]hstruct}(hj^hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjZubj2)}(h h]h }(hjkhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjZubh)}(hhh]jI)}(hinodeh]hinode}(hj|hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjyubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj~modnameN classnameNjj )}j ]jc.generic_encode_ino32_fhasbuh1hhjZubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjZubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZubjI)}(hparenth]hparent}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjZubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjMubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhj&hMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhj&hMubah}(h]j ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj&hMhj hhubjw)}(hhh]h)}(h-generic export_operations->encode_fh functionh]h-generic export_operations->encode_fh function}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjhhubah}(h]h ]h"]h$]h&]uh1jvhj hhhj&hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``struct inode *inode`` the object to encode ``__u32 *fh`` where to store the file handle fragment ``int *max_len`` maximum length to store there (in 4 byte units) ``struct inode *parent`` parent directory inode, if wanted **Description** This generic encode_fh function assumes that the 32 inode number is suitable for locating an inode, and that the generation number can be used to check that it is still valid. It places them in the filehandle fragment where export_decode_fh expects to find them.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjubj)}(hhh](j)}(h-``struct inode *inode`` the object to encode h](j)}(h``struct inode *inode``h]j)}(hj h]hstruct inode *inode}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjubj)}(hhh]h)}(hthe object to encodeh]hthe object to encode}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj5hMhj6ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj5hMhjubj)}(h6``__u32 *fh`` where to store the file handle fragment h](j)}(h ``__u32 *fh``h]j)}(hjYh]h __u32 *fh}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjWubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjSubj)}(hhh]h)}(h'where to store the file handle fragmenth]h'where to store the file handle fragment}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjnhMhjoubah}(h]h ]h"]h$]h&]uh1jhjSubeh}(h]h ]h"]h$]h&]uh1jhjnhMhjubj)}(hA``int *max_len`` maximum length to store there (in 4 byte units) h](j)}(h``int *max_len``h]j)}(hjh]h int *max_len}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjubj)}(hhh]h)}(h/maximum length to store there (in 4 byte units)h]h/maximum length to store there (in 4 byte units)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h;``struct inode *parent`` parent directory inode, if wanted h](j)}(h``struct inode *parent``h]j)}(hjh]hstruct inode *parent}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjubj)}(hhh]h)}(h!parent directory inode, if wantedh]h!parent directory inode, if wanted}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjubh)}(hXThis generic encode_fh function assumes that the 32 inode number is suitable for locating an inode, and that the generation number can be used to check that it is still valid. It places them in the filehandle fragment where export_decode_fh expects to find them.h]hXThis generic encode_fh function assumes that the 32 inode number is suitable for locating an inode, and that the generation number can be used to check that it is still valid. It places them in the filehandle fragment where export_decode_fh expects to find them.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j !generic_fh_to_dentry (C function)c.generic_fh_to_dentryhNtauh1hhjOghhhNhNubj)}(hhh](j)}(hstruct dentry * generic_fh_to_dentry (struct super_block *sb, struct fid *fid, int fh_len, int fh_type, struct inode *(*get_inode) (struct super_block *sb, u64 ino, u32 gen))h]j)}(hstruct dentry *generic_fh_to_dentry(struct super_block *sb, struct fid *fid, int fh_len, int fh_type, struct inode *(*get_inode)(struct super_block *sb, u64 ino, u32 gen))h](j )}(hjh]hstruct}(hjKhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjGhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMubj2)}(h h]h }(hjYhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjGhhhjXhMubh)}(hhh]jI)}(hdentryh]hdentry}(hjjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjgubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjlmodnameN classnameNjj )}j ]j)}jgeneric_fh_to_dentrysbc.generic_fh_to_dentryasbuh1hhjGhhhjXhMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjGhhhjXhMubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGhhhjXhMubjC)}(hgeneric_fh_to_dentryh]jI)}(hjh]hgeneric_fh_to_dentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjGhhhjXhMubj=)}(h(struct super_block *sb, struct fid *fid, int fh_len, int fh_type, struct inode *(*get_inode)(struct super_block *sb, u64 ino, u32 gen))h](jC)}(hstruct super_block *sbh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(h super_blockh]h super_block}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.generic_fh_to_dentryasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hsbh]hsb}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct fid *fidh](j )}(hjh]hstruct}(hj5hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj1ubj2)}(h h]h }(hjBhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj1ubh)}(hhh]jI)}(hfidh]hfid}(hjShhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjPubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjUmodnameN classnameNjj )}j ]jc.generic_fh_to_dentryasbuh1hhj1ubj2)}(h h]h }(hjqhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj1ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj1ubjI)}(hfidh]hfid}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj1ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h int fh_lenh](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hfh_lenh]hfh_len}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h int fh_typeh](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hfh_typeh]hfh_type}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hDstruct inode *(*get_inode)(struct super_block *sb, u64 ino, u32 gen)h](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj ubh)}(hhh]jI)}(hinodeh]hinode}(hj-hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj*ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj/modnameN classnameNjj )}j ]jc.generic_fh_to_dentryasbuh1hhj ubj2)}(h h]h }(hjKhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj ubj)}(hjh]h*}(hjYhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(hjʥh]h(}(hjfhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(hjh]h*}(hjshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubjI)}(h get_inodeh]h get_inode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubj)}(hjh]h)}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(hjʥh]h(}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj ubh)}(hhh]jI)}(h super_blockh]h super_block}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.generic_fh_to_dentryasbuh1hhj ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubjI)}(hsbh]hsb}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubj)}(hjWh]h,}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj ubh)}(hhh]jI)}(hu64h]hu64}(hj+hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj(ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj-modnameN classnameNjj )}j ]jc.generic_fh_to_dentryasbuh1hhj ubj2)}(h h]h }(hjIhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj ubjI)}(hinoh]hino}(hjWhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubj)}(hjWh]h,}(hjehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj2)}(h h]h }(hjrhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj ubh)}(hhh]jI)}(hu32h]hu32}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.generic_fh_to_dentryasbuh1hhj ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj ubjI)}(hgenh]hgen}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubj)}(hjh]h)}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjGhhhjXhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjChhhjXhMubah}(h]j>ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjXhMhj@hhubjw)}(hhh]h)}(h4generic helper for the fh_to_dentry export operationh]h4generic helper for the fh_to_dentry export operation}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjhhubah}(h]h ]h"]h$]h&]uh1jvhj@hhhjXhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjOghNhNubj)}(hX(**Parameters** ``struct super_block *sb`` filesystem to do the file handle conversion on ``struct fid *fid`` file handle to convert ``int fh_len`` length of the file handle in bytes ``int fh_type`` type of file handle ``struct inode *(*get_inode) (struct super_block *sb, u64 ino, u32 gen)`` filesystem callback to retrieve inode **Description** This function decodes **fid** as long as it has one of the well-known Linux filehandle types and calls **get_inode** on it to retrieve the inode for the object specified in the file handle.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjubj)}(hhh](j)}(hJ``struct super_block *sb`` filesystem to do the file handle conversion on h](j)}(h``struct super_block *sb``h]j)}(hj'h]hstruct super_block *sb}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj%ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhj!ubj)}(hhh]h)}(h.filesystem to do the file handle conversion onh]h.filesystem to do the file handle conversion on}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj<hMhj=ubah}(h]h ]h"]h$]h&]uh1jhj!ubeh}(h]h ]h"]h$]h&]uh1jhj<hMhjubj)}(h+``struct fid *fid`` file handle to convert h](j)}(h``struct fid *fid``h]j)}(hj`h]hstruct fid *fid}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj^ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjZubj)}(hhh]h)}(hfile handle to converth]hfile handle to convert}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjuhMhjvubah}(h]h ]h"]h$]h&]uh1jhjZubeh}(h]h ]h"]h$]h&]uh1jhjuhMhjubj)}(h2``int fh_len`` length of the file handle in bytes h](j)}(h``int fh_len``h]j)}(hjh]h int fh_len}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjubj)}(hhh]h)}(h"length of the file handle in bytesh]h"length of the file handle in bytes}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h$``int fh_type`` type of file handle h](j)}(h``int fh_type``h]j)}(hjh]h int fh_type}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjubj)}(hhh]h)}(htype of file handleh]htype of file handle}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(hp``struct inode *(*get_inode) (struct super_block *sb, u64 ino, u32 gen)`` filesystem callback to retrieve inode h](j)}(hI``struct inode *(*get_inode) (struct super_block *sb, u64 ino, u32 gen)``h]j)}(hj h]hEstruct inode *(*get_inode) (struct super_block *sb, u64 ino, u32 gen)}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjubj)}(hhh]h)}(h%filesystem callback to retrieve inodeh]h%filesystem callback to retrieve inode}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMhj!ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj hMhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjFh]h Description}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjDubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjubh)}(hThis function decodes **fid** as long as it has one of the well-known Linux filehandle types and calls **get_inode** on it to retrieve the inode for the object specified in the file handle.h](hThis function decodes }(hj\hhhNhNubj)}(h**fid**h]hfid}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj\ubhJ as long as it has one of the well-known Linux filehandle types and calls }(hj\hhhNhNubj)}(h **get_inode**h]h get_inode}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj\ubhI on it to retrieve the inode for the object specified in the file handle.}(hj\hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j !generic_fh_to_parent (C function)c.generic_fh_to_parenthNtauh1hhjOghhhNhNubj)}(hhh](j)}(hstruct dentry * generic_fh_to_parent (struct super_block *sb, struct fid *fid, int fh_len, int fh_type, struct inode *(*get_inode) (struct super_block *sb, u64 ino, u32 gen))h]j)}(hstruct dentry *generic_fh_to_parent(struct super_block *sb, struct fid *fid, int fh_len, int fh_type, struct inode *(*get_inode)(struct super_block *sb, u64 ino, u32 gen))h](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMubh)}(hhh]jI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jgeneric_fh_to_parentsbc.generic_fh_to_parentasbuh1hhjhhhjhMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubjC)}(hgeneric_fh_to_parenth]jI)}(hjh]hgeneric_fh_to_parent}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhMubj=)}(h(struct super_block *sb, struct fid *fid, int fh_len, int fh_type, struct inode *(*get_inode)(struct super_block *sb, u64 ino, u32 gen))h](jC)}(hstruct super_block *sbh](j )}(hjh]hstruct}(hj)hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj%ubj2)}(h h]h }(hj6hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj%ubh)}(hhh]jI)}(h super_blockh]h super_block}(hjGhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjDubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjImodnameN classnameNjj )}j ]jc.generic_fh_to_parentasbuh1hhj%ubj2)}(h h]h }(hjehhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj%ubj)}(hjh]h*}(hjshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%ubjI)}(hsbh]hsb}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj%ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj!ubjC)}(hstruct fid *fidh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hfidh]hfid}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.generic_fh_to_parentasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hfidh]hfid}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj!ubjC)}(h int fh_lenh](j)}(hinth]hint}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hfh_lenh]hfh_len}(hj%hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj!ubjC)}(h int fh_typeh](j)}(hinth]hint}(hj>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:ubj2)}(h h]h }(hjLhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj:ubjI)}(hfh_typeh]hfh_type}(hjZhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj:ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj!ubjC)}(hDstruct inode *(*get_inode)(struct super_block *sb, u64 ino, u32 gen)h](j )}(hjh]hstruct}(hjshhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjoubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjoubh)}(hhh]jI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.generic_fh_to_parentasbuh1hhjoubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjoubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjoubj)}(hjʥh]h(}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjoubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjoubjI)}(h get_inodeh]h get_inode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjoubj)}(hjh]h)}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjoubj)}(hjʥh]h(}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjoubj )}(hjh]hstruct}(hj hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjoubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjoubh)}(hhh]jI)}(h super_blockh]h super_block}(hj*hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj'ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj,modnameN classnameNjj )}j ]jc.generic_fh_to_parentasbuh1hhjoubj2)}(h h]h }(hjHhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjoubj)}(hjh]h*}(hjVhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjoubjI)}(hsbh]hsb}(hjchhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjoubj)}(hjWh]h,}(hjqhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjoubj2)}(h h]h }(hj~hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjoubh)}(hhh]jI)}(hu64h]hu64}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.generic_fh_to_parentasbuh1hhjoubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjoubjI)}(hinoh]hino}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjoubj)}(hjWh]h,}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjoubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjoubh)}(hhh]jI)}(hu32h]hu32}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.generic_fh_to_parentasbuh1hhjoubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjoubjI)}(hgenh]hgen}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjoubj)}(hjh]h)}(hj!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjoubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj!ubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhMubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMhjhhubjw)}(hhh]h)}(h4generic helper for the fh_to_parent export operationh]h4generic helper for the fh_to_parent export operation}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjGhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjbjjbjjjuh1jhhhjOghNhNubj)}(hXj**Parameters** ``struct super_block *sb`` filesystem to do the file handle conversion on ``struct fid *fid`` file handle to convert ``int fh_len`` length of the file handle in bytes ``int fh_type`` type of file handle ``struct inode *(*get_inode) (struct super_block *sb, u64 ino, u32 gen)`` filesystem callback to retrieve inode **Description** This function decodes **fid** as long as it has one of the well-known Linux filehandle types and calls **get_inode** on it to retrieve the inode for the _parent_ object specified in the file handle if it is specified in the file handle, or NULL otherwise.h](h)}(h**Parameters**h]j)}(hjlh]h Parameters}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjfubj)}(hhh](j)}(hJ``struct super_block *sb`` filesystem to do the file handle conversion on h](j)}(h``struct super_block *sb``h]j)}(hjh]hstruct super_block *sb}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjubj)}(hhh]h)}(h.filesystem to do the file handle conversion onh]h.filesystem to do the file handle conversion on}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h+``struct fid *fid`` file handle to convert h](j)}(h``struct fid *fid``h]j)}(hjh]hstruct fid *fid}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjubj)}(hhh]h)}(hfile handle to converth]hfile handle to convert}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h2``int fh_len`` length of the file handle in bytes h](j)}(h``int fh_len``h]j)}(hjh]h int fh_len}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjubj)}(hhh]h)}(h"length of the file handle in bytesh]h"length of the file handle in bytes}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h$``int fh_type`` type of file handle h](j)}(h``int fh_type``h]j)}(hj6h]h int fh_type}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj4ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhj0ubj)}(hhh]h)}(htype of file handleh]htype of file handle}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjKhMhjLubah}(h]h ]h"]h$]h&]uh1jhj0ubeh}(h]h ]h"]h$]h&]uh1jhjKhMhjubj)}(hp``struct inode *(*get_inode) (struct super_block *sb, u64 ino, u32 gen)`` filesystem callback to retrieve inode h](j)}(hI``struct inode *(*get_inode) (struct super_block *sb, u64 ino, u32 gen)``h]j)}(hjoh]hEstruct inode *(*get_inode) (struct super_block *sb, u64 ino, u32 gen)}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjmubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjiubj)}(hhh]h)}(h%filesystem callback to retrieve inodeh]h%filesystem callback to retrieve inode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjiubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubeh}(h]h ]h"]h$]h&]uh1jhjfubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjfubh)}(hThis function decodes **fid** as long as it has one of the well-known Linux filehandle types and calls **get_inode** on it to retrieve the inode for the _parent_ object specified in the file handle if it is specified in the file handle, or NULL otherwise.h](hThis function decodes }(hjhhhNhNubj)}(h**fid**h]hfid}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhJ as long as it has one of the well-known Linux filehandle types and calls }(hjhhhNhNubj)}(h **get_inode**h]h get_inode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh on it to retrieve the inode for the _parent_ object specified in the file handle if it is specified in the file handle, or NULL otherwise.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjfubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j !simple_fsync_noflush (C function)c.simple_fsync_noflushhNtauh1hhjOghhhNhNubj)}(hhh](j)}(hTint simple_fsync_noflush (struct file *file, loff_t start, loff_t end, int datasync)h]j)}(hSint simple_fsync_noflush(struct file *file, loff_t start, loff_t end, int datasync)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMubj2)}(h h]h }(hj"hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhj!hMubjC)}(hsimple_fsync_noflushh]jI)}(hsimple_fsync_noflushh]hsimple_fsync_noflush}(hj4hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj0ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhj!hMubj=)}(h;(struct file *file, loff_t start, loff_t end, int datasync)h](jC)}(hstruct file *fileh](j )}(hjh]hstruct}(hjPhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjLubj2)}(h h]h }(hj]hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjLubh)}(hhh]jI)}(hfileh]hfile}(hjnhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjkubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjpmodnameN classnameNjj )}j ]j)}jj6sbc.simple_fsync_noflushasbuh1hhjLubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjLubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjLubjI)}(hfileh]hfile}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjLubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjHubjC)}(h loff_t starth](h)}(hhh]jI)}(hloff_th]hloff_t}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.simple_fsync_noflushasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hstarth]hstart}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjHubjC)}(h loff_t endh](h)}(hhh]jI)}(hloff_th]hloff_t}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.simple_fsync_noflushasbuh1hhjubj2)}(h h]h }(hj+hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hendh]hend}(hj9hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjHubjC)}(h int datasynch](j)}(hinth]hint}(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubj2)}(h h]h }(hj`hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjNubjI)}(hdatasynch]hdatasync}(hjnhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjNubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjHubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhj!hMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj hhhj!hMubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj!hMhjhhubjw)}(hhh]h)}(h3generic fsync implementation for simple filesystemsh]h3generic fsync implementation for simple filesystems}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhj!hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjOghNhNubj)}(hXq**Parameters** ``struct file *file`` file to synchronize ``loff_t start`` start offset in bytes ``loff_t end`` end offset in bytes (inclusive) ``int datasync`` only synchronize essential metadata if true **Description** This function is an fsync handler for simple filesystems. It writes out dirty data, inode (if dirty), but does not issue a cache flush.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chM hjubj)}(hhh](j)}(h*``struct file *file`` file to synchronize h](j)}(h``struct file *file``h]j)}(hjh]hstruct file *file}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chM hjubj)}(hhh]h)}(hfile to synchronizeh]hfile to synchronize}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hjubj)}(h'``loff_t start`` start offset in bytes h](j)}(h``loff_t start``h]j)}(hjh]h loff_t start}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chM hj ubj)}(hhh]h)}(hstart offset in bytesh]hstart offset in bytes}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj'hM hj(ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj'hM hjubj)}(h/``loff_t end`` end offset in bytes (inclusive) h](j)}(h``loff_t end``h]j)}(hjKh]h loff_t end}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjIubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chM hjEubj)}(hhh]h)}(hend offset in bytes (inclusive)h]hend offset in bytes (inclusive)}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj`hM hjaubah}(h]h ]h"]h$]h&]uh1jhjEubeh}(h]h ]h"]h$]h&]uh1jhj`hM hjubj)}(h=``int datasync`` only synchronize essential metadata if true h](j)}(h``int datasync``h]j)}(hjh]h int datasync}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chM hj~ubj)}(hhh]h)}(h+only synchronize essential metadata if trueh]h+only synchronize essential metadata if true}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM hjubah}(h]h ]h"]h$]h&]uh1jhj~ubeh}(h]h ]h"]h$]h&]uh1jhjhM hjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjubh)}(hThis function is an fsync handler for simple filesystems. It writes out dirty data, inode (if dirty), but does not issue a cache flush.h]hThis function is an fsync handler for simple filesystems. It writes out dirty data, inode (if dirty), but does not issue a cache flush.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chM hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j simple_fsync (C function)c.simple_fsynchNtauh1hhjOghhhNhNubj)}(hhh](j)}(hLint simple_fsync (struct file *file, loff_t start, loff_t end, int datasync)h]j)}(hKint simple_fsync(struct file *file, loff_t start, loff_t end, int datasync)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chM/ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhM/ubjC)}(h simple_fsynch]jI)}(h simple_fsynch]h simple_fsync}(hj%hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj!ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhM/ubj=)}(h;(struct file *file, loff_t start, loff_t end, int datasync)h](jC)}(hstruct file *fileh](j )}(hjh]hstruct}(hjAhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj=ubj2)}(h h]h }(hjNhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj=ubh)}(hhh]jI)}(hfileh]hfile}(hj_hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj\ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjamodnameN classnameNjj )}j ]j)}jj'sbc.simple_fsyncasbuh1hhj=ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj=ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=ubjI)}(hfileh]hfile}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj=ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj9ubjC)}(h loff_t starth](h)}(hhh]jI)}(hloff_th]hloff_t}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j{c.simple_fsyncasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hstarth]hstart}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj9ubjC)}(h loff_t endh](h)}(hhh]jI)}(hloff_th]hloff_t}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j{c.simple_fsyncasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hendh]hend}(hj*hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj9ubjC)}(h int datasynch](j)}(hinth]hint}(hjChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?ubj2)}(h h]h }(hjQhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj?ubjI)}(hdatasynch]hdatasync}(hj_hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj?ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj9ubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhM/ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhM/ubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhM/hjhhubjw)}(hhh]h)}(h6fsync implementation for simple filesystems with flushh]h6fsync implementation for simple filesystems with flush}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chM/hjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhM/ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjOghNhNubj)}(hXi**Parameters** ``struct file *file`` file to synchronize ``loff_t start`` start offset in bytes ``loff_t end`` end offset in bytes (inclusive) ``int datasync`` only synchronize essential metadata if true **Description** This function is an fsync handler for simple filesystems. It writes out dirty data, inode (if dirty), and issues a cache flush.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chM3hjubj)}(hhh](j)}(h*``struct file *file`` file to synchronize h](j)}(h``struct file *file``h]j)}(hjh]hstruct file *file}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chM0hjubj)}(hhh]h)}(hfile to synchronizeh]hfile to synchronize}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM0hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM0hjubj)}(h'``loff_t start`` start offset in bytes h](j)}(h``loff_t start``h]j)}(hjh]h loff_t start}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chM1hjubj)}(hhh]h)}(hstart offset in bytesh]hstart offset in bytes}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM1hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM1hjubj)}(h/``loff_t end`` end offset in bytes (inclusive) h](j)}(h``loff_t end``h]j)}(hj<h]h loff_t end}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj:ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chM2hj6ubj)}(hhh]h)}(hend offset in bytes (inclusive)h]hend offset in bytes (inclusive)}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjQhM2hjRubah}(h]h ]h"]h$]h&]uh1jhj6ubeh}(h]h ]h"]h$]h&]uh1jhjQhM2hjubj)}(h=``int datasync`` only synchronize essential metadata if true h](j)}(h``int datasync``h]j)}(hjuh]h int datasync}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjsubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chM3hjoubj)}(hhh]h)}(h+only synchronize essential metadata if trueh]h+only synchronize essential metadata if true}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM3hjubah}(h]h ]h"]h$]h&]uh1jhjoubeh}(h]h ]h"]h$]h&]uh1jhjhM3hjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chM5hjubh)}(hThis function is an fsync handler for simple filesystems. It writes out dirty data, inode (if dirty), and issues a cache flush.h]hThis function is an fsync handler for simple filesystems. It writes out dirty data, inode (if dirty), and issues a cache flush.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chM4hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j &generic_check_addressable (C function)c.generic_check_addressablehNtauh1hhjOghhhNhNubj)}(hhh](j)}(hGint generic_check_addressable (unsigned blocksize_bits, u64 num_blocks)h]j)}(hFint generic_check_addressable(unsigned blocksize_bits, u64 num_blocks)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMEubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMEubjC)}(hgeneric_check_addressableh]jI)}(hgeneric_check_addressableh]hgeneric_check_addressable}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhMEubj=)}(h)(unsigned blocksize_bits, u64 num_blocks)h](jC)}(hunsigned blocksize_bitsh](j)}(hunsignedh]hunsigned}(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj.ubj2)}(h h]h }(hj@hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj.ubjI)}(hblocksize_bitsh]hblocksize_bits}(hjNhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj.ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj*ubjC)}(hu64 num_blocksh](h)}(hhh]jI)}(hu64h]hu64}(hjjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjgubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjlmodnameN classnameNjj )}j ]j)}jjsbc.generic_check_addressableasbuh1hhjcubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjcubjI)}(h num_blocksh]h num_blocks}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjcubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj*ubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhMEubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhMEubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMEhjhhubjw)}(hhh]h)}(h#Check addressability of file systemh]h#Check addressability of file system}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMEhjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhMEubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjOghNhNubj)}(hX]**Parameters** ``unsigned blocksize_bits`` log of file system block size ``u64 num_blocks`` number of blocks in file system **Description** Determine whether a file system with **num_blocks** blocks (and a block size of 2****blocksize_bits**) is addressable by the sector_t and page cache of the system. Return 0 if so and -EFBIG otherwise.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMIhjubj)}(hhh](j)}(h:``unsigned blocksize_bits`` log of file system block size h](j)}(h``unsigned blocksize_bits``h]j)}(hjh]hunsigned blocksize_bits}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMFhjubj)}(hhh]h)}(hlog of file system block sizeh]hlog of file system block size}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMFhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMFhjubj)}(h3``u64 num_blocks`` number of blocks in file system h](j)}(h``u64 num_blocks``h]j)}(hj<h]hu64 num_blocks}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj:ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMGhj6ubj)}(hhh]h)}(hnumber of blocks in file systemh]hnumber of blocks in file system}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjQhMGhjRubah}(h]h ]h"]h$]h&]uh1jhj6ubeh}(h]h ]h"]h$]h&]uh1jhjQhMGhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjwh]h Description}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjuubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMIhjubh)}(hDetermine whether a file system with **num_blocks** blocks (and a block size of 2****blocksize_bits**) is addressable by the sector_t and page cache of the system. Return 0 if so and -EFBIG otherwise.h](h%Determine whether a file system with }(hjhhhNhNubj)}(h**num_blocks**h]h num_blocks}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh blocks (and a block size of 2****blocksize_bits**) is addressable by the sector_t and page cache of the system. Return 0 if so and -EFBIG otherwise.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMHhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j simple_get_link (C function)c.simple_get_linkhNtauh1hhjOghhhNhNubj)}(hhh](j)}(hdconst char * simple_get_link (struct dentry *dentry, struct inode *inode, struct delayed_call *done)h]j)}(hbconst char *simple_get_link(struct dentry *dentry, struct inode *inode, struct delayed_call *done)h](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMubj)}(hcharh]hchar}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubjC)}(hsimple_get_linkh]jI)}(hsimple_get_linkh]hsimple_get_link}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhMubj=)}(hG(struct dentry *dentry, struct inode *inode, struct delayed_call *done)h](jC)}(hstruct dentry *dentryh](j )}(hjh]hstruct}(hj3hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj/ubj2)}(h h]h }(hj@hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj/ubh)}(hhh]jI)}(hdentryh]hdentry}(hjQhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjNubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjSmodnameN classnameNjj )}j ]j)}jjsbc.simple_get_linkasbuh1hhj/ubj2)}(h h]h }(hjqhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj/ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/ubjI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj/ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj+ubjC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jmc.simple_get_linkasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj+ubjC)}(hstruct delayed_call *doneh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hj"hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(h delayed_callh]h delayed_call}(hj3hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj0ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj5modnameN classnameNjj )}j ]jmc.simple_get_linkasbuh1hhjubj2)}(h h]h }(hjQhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hdoneh]hdone}(hjlhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj+ubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhMubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMhjhhubjw)}(hhh]h)}(h3generic helper to get the target of "fast" symlinksh]h7generic helper to get the target of “fast” symlinks}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjOghNhNubj)}(hX+**Parameters** ``struct dentry *dentry`` not used here ``struct inode *inode`` the symlink inode ``struct delayed_call *done`` not used here **Description** Generic helper for filesystems to use for symlink inodes where a pointer to the symlink target is stored in ->i_link. NOTE: this isn't normally called, since as an optimization the path lookup code uses any non-NULL ->i_link directly, without calling ->get_link(). But ->get_link() still must be set, to mark the inode_operations as being for a symlink. **Return** the symlink targeth](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjubj)}(hhh](j)}(h(``struct dentry *dentry`` not used here h](j)}(h``struct dentry *dentry``h]j)}(hjh]hstruct dentry *dentry}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjubj)}(hhh]h)}(h not used hereh]h not used here}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h*``struct inode *inode`` the symlink inode h](j)}(h``struct inode *inode``h]j)}(hjh]hstruct inode *inode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhj ubj)}(hhh]h)}(hthe symlink inodeh]hthe symlink inode}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj%hMhj&ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj%hMhjubj)}(h,``struct delayed_call *done`` not used here h](j)}(h``struct delayed_call *done``h]j)}(hjIh]hstruct delayed_call *done}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjGubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjCubj)}(hhh]h)}(h not used hereh]h not used here}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj^hMhj_ubah}(h]h ]h"]h$]h&]uh1jhjCubeh}(h]h ]h"]h$]h&]uh1jhj^hMhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjubh)}(hXcGeneric helper for filesystems to use for symlink inodes where a pointer to the symlink target is stored in ->i_link. NOTE: this isn't normally called, since as an optimization the path lookup code uses any non-NULL ->i_link directly, without calling ->get_link(). But ->get_link() still must be set, to mark the inode_operations as being for a symlink.h]hXeGeneric helper for filesystems to use for symlink inodes where a pointer to the symlink target is stored in ->i_link. NOTE: this isn’t normally called, since as an optimization the path lookup code uses any non-NULL ->i_link directly, without calling ->get_link(). But ->get_link() still must be set, to mark the inode_operations as being for a symlink.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjubh)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjubh)}(hthe symlink targeth]hthe symlink target}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j !generic_ci_d_compare (C function)c.generic_ci_d_comparehNtauh1hhjOghhhNhNubj)}(hhh](j)}(hrint generic_ci_d_compare (const struct dentry *dentry, unsigned int len, const char *str, const struct qstr *name)h]j)}(hqint generic_ci_d_compare(const struct dentry *dentry, unsigned int len, const char *str, const struct qstr *name)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMubjC)}(hgeneric_ci_d_compareh]jI)}(hgeneric_ci_d_compareh]hgeneric_ci_d_compare}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhMubj=)}(hY(const struct dentry *dentry, unsigned int len, const char *str, const struct qstr *name)h](jC)}(hconst struct dentry *dentryh](j )}(hjJh]hconst}(hj-hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj)ubj2)}(h h]h }(hj:hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj)ubj )}(hjh]hstruct}(hjHhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj)ubj2)}(h h]h }(hjUhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj)ubh)}(hhh]jI)}(hdentryh]hdentry}(hjfhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjcubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjhmodnameN classnameNjj )}j ]j)}jjsbc.generic_ci_d_compareasbuh1hhj)ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj)ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubjI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj)ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj%ubjC)}(hunsigned int lenh](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hlenh]hlen}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj%ubjC)}(hconst char *strh](j )}(hjJh]hconst}(hj hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hcharh]hchar}(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hj4hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hstrh]hstr}(hjOhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj%ubjC)}(hconst struct qstr *nameh](j )}(hjJh]hconst}(hjhhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjdubj2)}(h h]h }(hjuhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjdubj )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjdubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjdubh)}(hhh]jI)}(hqstrh]hqstr}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.generic_ci_d_compareasbuh1hhjdubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjdubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjdubjI)}(hnameh]hname}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjdubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj%ubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhMubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMhjhhubjw)}(hhh]h)}(hah"]h$]h&]uh1j1hjlhhhj~hM9ubjC)}(hgeneric_ci_d_hashh]jI)}(hgeneric_ci_d_hashh]hgeneric_ci_d_hash}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjlhhhj~hM9ubj=)}(h/(const struct dentry *dentry, struct qstr *str)h](jC)}(hconst struct dentry *dentryh](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jjsbc.generic_ci_d_hashasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hdentryh]hdentry}(hj!hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct qstr *strh](j )}(hjh]hstruct}(hj:hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj6ubj2)}(h h]h }(hjGhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj6ubh)}(hhh]jI)}(hqstrh]hqstr}(hjXhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjUubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjZmodnameN classnameNjj )}j ]jc.generic_ci_d_hashasbuh1hhj6ubj2)}(h h]h }(hjvhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj6ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj6ubjI)}(hstrh]hstr}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj6ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjlhhhj~hM9ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhhj~hM9ubah}(h]jcah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj~hM9hjehhubjw)}(hhh]h)}(h9generic d_hash implementation for casefolding filesystemsh]h9generic d_hash implementation for casefolding filesystems}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chM9hjhhubah}(h]h ]h"]h$]h&]uh1jvhjehhhj~hM9ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjOghNhNubj)}(h**Parameters** ``const struct dentry *dentry`` dentry of the parent directory ``struct qstr *str`` qstr of name whose hash we should fill in **Return** 0 if hash was successful or unchanged, and -EINVAL on errorh](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chM=hjubj)}(hhh](j)}(h?``const struct dentry *dentry`` dentry of the parent directory h](j)}(h``const struct dentry *dentry``h]j)}(hjh]hconst struct dentry *dentry}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chM:hjubj)}(hhh]h)}(hdentry of the parent directoryh]hdentry of the parent directory}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM:hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM:hjubj)}(h?``struct qstr *str`` qstr of name whose hash we should fill in h](j)}(h``struct qstr *str``h]j)}(hj5h]hstruct qstr *str}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj3ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chM;hj/ubj)}(hhh]h)}(h)qstr of name whose hash we should fill inh]h)qstr of name whose hash we should fill in}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjJhM;hjKubah}(h]h ]h"]h$]h&]uh1jhj/ubeh}(h]h ]h"]h$]h&]uh1jhjJhM;hjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h **Return**h]j)}(hjph]hReturn}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjnubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chM=hjubh)}(h;0 if hash was successful or unchanged, and -EINVAL on errorh]h;0 if hash was successful or unchanged, and -EINVAL on error}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chM=hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j generic_ci_match (C function)c.generic_ci_matchhNtauh1hhjOghhhNhNubj)}(hhh](j)}(hint generic_ci_match (const struct inode *parent, const struct qstr *name, const struct qstr *folded_name, const u8 *de_name, u32 de_name_len)h]j)}(hint generic_ci_match(const struct inode *parent, const struct qstr *name, const struct qstr *folded_name, const u8 *de_name, u32 de_name_len)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMYubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMYubjC)}(hgeneric_ci_matchh]jI)}(hgeneric_ci_matchh]hgeneric_ci_match}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhMYubj=)}(hy(const struct inode *parent, const struct qstr *name, const struct qstr *folded_name, const u8 *de_name, u32 de_name_len)h](jC)}(hconst struct inode *parenth](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj )}(hjh]hstruct}(hj hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hinodeh]hinode}(hj+hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj(ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj-modnameN classnameNjj )}j ]j)}jjsbc.generic_ci_matchasbuh1hhjubj2)}(h h]h }(hjKhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjYhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hparenth]hparent}(hjfhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hconst struct qstr *nameh](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj{ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj{ubj )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj{ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj{ubh)}(hhh]jI)}(hqstrh]hqstr}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jGc.generic_ci_matchasbuh1hhj{ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj{ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{ubjI)}(hnameh]hname}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj{ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hconst struct qstr *folded_nameh](j )}(hjJh]hconst}(hj hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj )}(hjh]hstruct}(hj%hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hj2hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hqstrh]hqstr}(hjChhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj@ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjEmodnameN classnameNjj )}j ]jGc.generic_ci_matchasbuh1hhjubj2)}(h h]h }(hjahhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjohhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(h folded_nameh]h folded_name}(hj|hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hconst u8 *de_nameh](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hu8h]hu8}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jGc.generic_ci_matchasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hde_nameh]hde_name}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hu32 de_name_lenh](h)}(hhh]jI)}(hu32h]hu32}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj modnameN classnameNjj )}j ]jGc.generic_ci_matchasbuh1hhjubj2)}(h h]h }(hj&hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(h de_name_lenh]h de_name_len}(hj4hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhMYubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhMYubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMYhjhhubjw)}(hhh]h)}(hMatch a name (case-insensitively) with a dirent. This is a filesystem helper for comparison with directory entries. generic_ci_d_compare should be used in VFS' ->d_compare instead.h]hMatch a name (case-insensitively) with a dirent. This is a filesystem helper for comparison with directory entries. generic_ci_d_compare should be used in VFS’ ->d_compare instead.}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMYhj[hhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhMYubeh}(h]h ](jfunctioneh"]h$]h&]jjjjvjjvjjjuh1jhhhjOghNhNubj)}(hXQ**Parameters** ``const struct inode *parent`` Inode of the parent of the dirent under comparison ``const struct qstr *name`` name under lookup. ``const struct qstr *folded_name`` Optional pre-folded name under lookup ``const u8 *de_name`` Dirent name. ``u32 de_name_len`` dirent name length. **Description** Test whether a case-insensitive directory entry matches the filename being searched. If **folded_name** is provided, it is used instead of recalculating the casefold of **name**. **Return** > 0 if the directory entry matches, 0 if it doesn't match, or < 0 on error.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj~ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chM]hjzubj)}(hhh](j)}(hR``const struct inode *parent`` Inode of the parent of the dirent under comparison h](j)}(h``const struct inode *parent``h]j)}(hjh]hconst struct inode *parent}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chM]hjubj)}(hhh]h)}(h2Inode of the parent of the dirent under comparisonh]h2Inode of the parent of the dirent under comparison}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM]hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM]hjubj)}(h/``const struct qstr *name`` name under lookup. h](j)}(h``const struct qstr *name``h]j)}(hjh]hconst struct qstr *name}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chM^hjubj)}(hhh]h)}(hname under lookup.h]hname under lookup.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM^hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM^hjubj)}(hI``const struct qstr *folded_name`` Optional pre-folded name under lookup h](j)}(h"``const struct qstr *folded_name``h]j)}(hjh]hconst struct qstr *folded_name}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chM_hj ubj)}(hhh]h)}(h%Optional pre-folded name under lookuph]h%Optional pre-folded name under lookup}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj&hM_hj'ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj&hM_hjubj)}(h#``const u8 *de_name`` Dirent name. h](j)}(h``const u8 *de_name``h]j)}(hjJh]hconst u8 *de_name}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjHubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chM`hjDubj)}(hhh]h)}(h Dirent name.h]h Dirent name.}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1hhj_hM`hj`ubah}(h]h ]h"]h$]h&]uh1jhjDubeh}(h]h ]h"]h$]h&]uh1jhj_hM`hjubj)}(h(``u32 de_name_len`` dirent name length. h](j)}(h``u32 de_name_len``h]j)}(hjh]hu32 de_name_len}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMahj}ubj)}(hhh]h)}(hdirent name length.h]hdirent name length.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMahjubah}(h]h ]h"]h$]h&]uh1jhj}ubeh}(h]h ]h"]h$]h&]uh1jhjhMahjubeh}(h]h ]h"]h$]h&]uh1jhjzubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMchjzubh)}(hTest whether a case-insensitive directory entry matches the filename being searched. If **folded_name** is provided, it is used instead of recalculating the casefold of **name**.h](hYTest whether a case-insensitive directory entry matches the filename being searched. If }(hjhhhNhNubj)}(h**folded_name**h]h folded_name}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhB is provided, it is used instead of recalculating the casefold of }(hjhhhNhNubj)}(h**name**h]hname}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMbhjzubh)}(h **Return**h]j)}(hj h]hReturn}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMfhjzubh)}(hK> 0 if the directory entry matches, 0 if it doesn't match, or < 0 on error.h]hM> 0 if the directory entry matches, 0 if it doesn’t match, or < 0 on error.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMghjzubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j !generic_set_sb_d_ops (C function)c.generic_set_sb_d_opshNtauh1hhjOghhhNhNubj)}(hhh](j)}(h2void generic_set_sb_d_ops (struct super_block *sb)h]j)}(h1void generic_set_sb_d_ops(struct super_block *sb)h](j)}(hvoidh]hvoid}(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMubj2)}(h h]h }(hj]hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjJhhhj\hMubjC)}(hgeneric_set_sb_d_opsh]jI)}(hgeneric_set_sb_d_opsh]hgeneric_set_sb_d_ops}(hjohhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjkubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjJhhhj\hMubj=)}(h(struct super_block *sb)h]jC)}(hstruct super_block *sbh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(h super_blockh]h super_block}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jjqsbc.generic_set_sb_d_opsasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hsbh]hsb}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubah}(h]h ]h"]h$]h&]j`jauh1j<hjJhhhj\hMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjFhhhj\hMubah}(h]jAah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj\hMhjChhubjw)}(hhh]h)}(hYhelper for choosing the set of filesystem-wide dentry operations for the enabled featuresh]hYhelper for choosing the set of filesystem-wide dentry operations for the enabled features}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhj hhubah}(h]h ]h"]h$]h&]uh1jvhjChhhj\hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjj&jj&jjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``struct super_block *sb`` superblock to be configured **Description** Filesystems supporting casefolding and/or fscrypt can call this helper at mount-time to configure default dentry_operations to the best set of dentry operations required for the enabled features. The helper must be called after these have been configured, but before the root dentry is created.h](h)}(h**Parameters**h]j)}(hj0h]h Parameters}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj.ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhj*ubj)}(hhh]j)}(h7``struct super_block *sb`` superblock to be configured h](j)}(h``struct super_block *sb``h]j)}(hjOh]hstruct super_block *sb}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjMubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjIubj)}(hhh]h)}(hsuperblock to be configuredh]hsuperblock to be configured}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjdhMhjeubah}(h]h ]h"]h$]h&]uh1jhjIubeh}(h]h ]h"]h$]h&]uh1jhjdhMhjFubah}(h]h ]h"]h$]h&]uh1jhj*ubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhj*ubh)}(hX&Filesystems supporting casefolding and/or fscrypt can call this helper at mount-time to configure default dentry_operations to the best set of dentry operations required for the enabled features. The helper must be called after these have been configured, but before the root dentry is created.h]hX&Filesystems supporting casefolding and/or fscrypt can call this helper at mount-time to configure default dentry_operations to the best set of dentry operations required for the enabled features. The helper must be called after these have been configured, but before the root dentry is created.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhj*ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j %inode_maybe_inc_iversion (C function)c.inode_maybe_inc_iversionhNtauh1hhjOghhhNhNubj)}(hhh](j)}(h?bool inode_maybe_inc_iversion (struct inode *inode, bool force)h]j)}(h>bool inode_maybe_inc_iversion(struct inode *inode, bool force)h](j)}(hjh]hbool}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMubjC)}(hinode_maybe_inc_iversionh]jI)}(hinode_maybe_inc_iversionh]hinode_maybe_inc_iversion}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhMubj=)}(h!(struct inode *inode, bool force)h](jC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hj hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hinodeh]hinode}(hj)hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj&ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj+modnameN classnameNjj )}j ]j)}jjsbc.inode_maybe_inc_iversionasbuh1hhjubj2)}(h h]h }(hjIhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjWhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hinodeh]hinode}(hjdhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h bool forceh](j)}(hjh]hbool}(hj}hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjyubjI)}(hforceh]hforce}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjyubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhMubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMhjhhubjw)}(hhh]h)}(hincrements i_versionh]hincrements i_version}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjOghNhNubj)}(hXT**Parameters** ``struct inode *inode`` inode with the i_version that should be updated ``bool force`` increment the counter even if it's not necessary? **Description** Every time the inode is modified, the i_version field must be seen to have changed by any observer. If "force" is set or the QUERIED flag is set, then ensure that we increment the value, and clear the queried flag. In the common case where neither is set, then we can return "false" without updating i_version. If this function returns false, and no other metadata has changed, then we can avoid logging the metadata.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjubj)}(hhh](j)}(hH``struct inode *inode`` inode with the i_version that should be updated h](j)}(h``struct inode *inode``h]j)}(hjh]hstruct inode *inode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjubj)}(hhh]h)}(h/inode with the i_version that should be updatedh]h/inode with the i_version that should be updated}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(hA``bool force`` increment the counter even if it's not necessary? h](j)}(h``bool force``h]j)}(hj<h]h bool force}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj:ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhj6ubj)}(hhh]h)}(h1increment the counter even if it's not necessary?h]h3increment the counter even if it’s not necessary?}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjQhMhjRubah}(h]h ]h"]h$]h&]uh1jhj6ubeh}(h]h ]h"]h$]h&]uh1jhjQhMhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjwh]h Description}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjuubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjubh)}(hcEvery time the inode is modified, the i_version field must be seen to have changed by any observer.h]hcEvery time the inode is modified, the i_version field must be seen to have changed by any observer.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjubh)}(hrIf "force" is set or the QUERIED flag is set, then ensure that we increment the value, and clear the queried flag.h]hvIf “force” is set or the QUERIED flag is set, then ensure that we increment the value, and clear the queried flag.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjubh)}(h_In the common case where neither is set, then we can return "false" without updating i_version.h]hcIn the common case where neither is set, then we can return “false” without updating i_version.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjubh)}(hjIf this function returns false, and no other metadata has changed, then we can avoid logging the metadata.h]hjIf this function returns false, and no other metadata has changed, then we can avoid logging the metadata.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j !inode_query_iversion (C function)c.inode_query_iversionhNtauh1hhjOghhhNhNubj)}(hhh](j)}(h.u64 inode_query_iversion (struct inode *inode)h]j)}(h-u64 inode_query_iversion(struct inode *inode)h](h)}(hhh]jI)}(hu64h]hu64}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jinode_query_iversionsbc.inode_query_iversionasbuh1hhjhhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhj hMubjC)}(hinode_query_iversionh]jI)}(hj h]hinode_query_iversion}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhj hMubj=)}(h(struct inode *inode)h]jC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hj;hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj7ubj2)}(h h]h }(hjHhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj7ubh)}(hhh]jI)}(hinodeh]hinode}(hjYhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjVubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj[modnameN classnameNjj )}j ]jc.inode_query_iversionasbuh1hhj7ubj2)}(h h]h }(hjwhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj7ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7ubjI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj7ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj3ubah}(h]h ]h"]h$]h&]j`jauh1j<hjhhhj hMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhj hMubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj hMhjhhubjw)}(hhh]h)}(hread i_version for later useh]hread i_version for later use}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhj hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjOghNhNubj)}(hX:**Parameters** ``struct inode *inode`` inode from which i_version should be read **Description** Read the inode i_version counter. This should be used by callers that wish to store the returned i_version for later comparison. This will guarantee that a later query of the i_version will result in a different value if anything has changed. In this implementation, we fetch the current value, set the QUERIED flag and then try to swap it into place with a cmpxchg, if it wasn't already set. If that fails, we try again with the newly fetched value from the cmpxchg.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjubj)}(hhh]j)}(hB``struct inode *inode`` inode from which i_version should be read h](j)}(h``struct inode *inode``h]j)}(hjh]hstruct inode *inode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjubj)}(hhh]h)}(h)inode from which i_version should be readh]h)inode from which i_version should be read}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hj8h]h Description}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj6ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjubh)}(hRead the inode i_version counter. This should be used by callers that wish to store the returned i_version for later comparison. This will guarantee that a later query of the i_version will result in a different value if anything has changed.h]hRead the inode i_version counter. This should be used by callers that wish to store the returned i_version for later comparison. This will guarantee that a later query of the i_version will result in a different value if anything has changed.}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjubh)}(hIn this implementation, we fetch the current value, set the QUERIED flag and then try to swap it into place with a cmpxchg, if it wasn't already set. If that fails, we try again with the newly fetched value from the cmpxchg.h]hIn this implementation, we fetch the current value, set the QUERIED flag and then try to swap it into place with a cmpxchg, if it wasn’t already set. If that fails, we try again with the newly fetched value from the cmpxchg.}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j !simple_inode_init_ts (C function)c.simple_inode_init_tshNtauh1hhjOghhhNhNubj)}(hhh](j)}(hah"]h$]h&]uh1j1hjhhhjhMIubh)}(hhh]jI)}(h timespec64h]h timespec64}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jsimple_inode_init_tssbc.simple_inode_init_tsasbuh1hhjhhhjhMIubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMIubjC)}(hsimple_inode_init_tsh]jI)}(hjh]hsimple_inode_init_ts}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhMIubj=)}(h(struct inode *inode)h]jC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.simple_inode_init_tsasbuh1hhjubj2)}(h h]h }(hj5hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hinodeh]hinode}(hjPhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubah}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhMIubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhMIubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMIhjhhubjw)}(hhh]h)}(h)initialize the timestamps for a new inodeh]h)initialize the timestamps for a new inode}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMIhjwhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhMIubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjOghNhNubj)}(h**Parameters** ``struct inode *inode`` inode to be initialized **Description** When a new inode is created, most filesystems set the timestamps to the current time. Add a helper to do this.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMMhjubj)}(hhh]j)}(h0``struct inode *inode`` inode to be initialized h](j)}(h``struct inode *inode``h]j)}(hjh]hstruct inode *inode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMJhjubj)}(hhh]h)}(hinode to be initializedh]hinode to be initialized}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMJhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMJhjubah}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMLhjubh)}(hnWhen a new inode is created, most filesystems set the timestamps to the current time. Add a helper to do this.h]hnWhen a new inode is created, most filesystems set the timestamps to the current time. Add a helper to do this.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMKhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j "simple_start_creating (C function)c.simple_start_creatinghNtauh1hhjOghhhNhNubj)}(hhh](j)}(hOstruct dentry * simple_start_creating (struct dentry *parent, const char *name)h]j)}(hMstruct dentry *simple_start_creating(struct dentry *parent, const char *name)h](j )}(hjh]hstruct}(hj;hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj7hhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMubj2)}(h h]h }(hjIhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj7hhhjHhMubh)}(hhh]jI)}(hdentryh]hdentry}(hjZhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjWubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj\modnameN classnameNjj )}j ]j)}jsimple_start_creatingsbc.simple_start_creatingasbuh1hhj7hhhjHhMubj2)}(h h]h }(hj{hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj7hhhjHhMubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7hhhjHhMubjC)}(hsimple_start_creatingh]jI)}(hjxh]hsimple_start_creating}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj7hhhjHhMubj=)}(h)(struct dentry *parent, const char *name)h](jC)}(hstruct dentry *parenth](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jvc.simple_start_creatingasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hparenth]hparent}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hconst char *nameh](j )}(hjJh]hconst}(hj%hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj!ubj2)}(h h]h }(hj2hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj!ubj)}(hcharh]hchar}(hj@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubj2)}(h h]h }(hjNhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj!ubj)}(hjh]h*}(hj\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubjI)}(hnameh]hname}(hjihhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj!ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hj7hhhjHhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj3hhhjHhMubah}(h]j.ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjHhMhj0hhubjw)}(hhh]h)}(hprepare to create a given nameh]hprepare to create a given name}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjhhubah}(h]h ]h"]h$]h&]uh1jvhj0hhhjHhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``struct dentry *parent`` directory in which to prepare to create the name ``const char *name`` the name to be created **Description** Required lock is taken and a lookup in performed prior to creating an object in a directory. No permission checking is performed. **Return** a negative dentry on which vfs_create() or similar may be attempted, or an error.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjubj)}(hhh](j)}(hK``struct dentry *parent`` directory in which to prepare to create the name h](j)}(h``struct dentry *parent``h]j)}(hjh]hstruct dentry *parent}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjubj)}(hhh]h)}(h0directory in which to prepare to create the nameh]h0directory in which to prepare to create the name}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h,``const char *name`` the name to be created h](j)}(h``const char *name``h]j)}(hj h]hconst char *name}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjubj)}(hhh]h)}(hthe name to be createdh]hthe name to be created}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj"hMhj#ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj"hMhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjHh]h Description}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjFubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjubh)}(hRequired lock is taken and a lookup in performed prior to creating an object in a directory. No permission checking is performed.h]hRequired lock is taken and a lookup in performed prior to creating an object in a directory. No permission checking is performed.}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjubh)}(h **Return**h]j)}(hjoh]hReturn}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjmubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjubh)}(hQa negative dentry on which vfs_create() or similar may be attempted, or an error.h]hQa negative dentry on which vfs_create() or similar may be attempted, or an error.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:86: ./fs/libfs.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j posix_acl_chmod (C function)c.posix_acl_chmodhNtauh1hhjOghhhNhNubj)}(hhh](j)}(hYint posix_acl_chmod (const struct mnt_idmap *idmap, struct dentry *dentry, umode_t mode)h]j)}(hWint posix_acl_chmod(const struct mnt_idmap *idmap, struct dentry *dentry, umode_t mode)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:89: ./fs/posix_acl.chMVubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMVubjC)}(hposix_acl_chmodh]jI)}(hposix_acl_chmodh]hposix_acl_chmod}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhMVubj=)}(hD(const struct mnt_idmap *idmap, struct dentry *dentry, umode_t mode)h](jC)}(hconst struct mnt_idmap *idmaph](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj )}(hjh]hstruct}(hj hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(h mnt_idmaph]h mnt_idmap}(hj*hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj'ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj,modnameN classnameNjj )}j ]j)}jjsbc.posix_acl_chmodasbuh1hhjubj2)}(h h]h }(hjJhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hidmaph]hidmap}(hjehhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct dentry *dentryh](j )}(hjh]hstruct}(hj~hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjzubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjzubh)}(hhh]jI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jFc.posix_acl_chmodasbuh1hhjzubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjzubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjzubjI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjzubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h umode_t modeh](h)}(hhh]jI)}(humode_th]humode_t}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jFc.posix_acl_chmodasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hmodeh]hmode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhMVubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhMVubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMVhjhhubjw)}(hhh]h)}(hchmod a posix aclh]hchmod a posix acl}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:89: ./fs/posix_acl.chMVhjDhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhMVubeh}(h]h ](jfunctioneh"]h$]h&]jjjj_jj_jjjuh1jhhhjOghNhNubj)}(hX)**Parameters** ``const struct mnt_idmap *idmap`` idmap of the mount **inode** was found from ``struct dentry *dentry`` dentry to check permissions on ``umode_t mode`` the new mode of **inode** **Description** If the dentry has been found through an idmapped mount the idmap of the vfsmount must be passed through **idmap**. This function will then take care to map the inode according to **idmap** before checking permissions. On non-idmapped mounts or if permission checking is to be performed on the raw inode simply pass **nop_mnt_idmap**.h](h)}(h**Parameters**h]j)}(hjih]h Parameters}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjgubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:89: ./fs/posix_acl.chMZhjcubj)}(hhh](j)}(hN``const struct mnt_idmap *idmap`` idmap of the mount **inode** was found from h](j)}(h!``const struct mnt_idmap *idmap``h]j)}(hjh]hconst struct mnt_idmap *idmap}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:89: ./fs/posix_acl.chMXhjubj)}(hhh]h)}(h+idmap of the mount **inode** was found fromh](hidmap of the mount }(hjhhhNhNubj)}(h **inode**h]hinode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh was found from}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhMXhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMXhjubj)}(h9``struct dentry *dentry`` dentry to check permissions on h](j)}(h``struct dentry *dentry``h]j)}(hjh]hstruct dentry *dentry}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:89: ./fs/posix_acl.chMYhjubj)}(hhh]h)}(hdentry to check permissions onh]hdentry to check permissions on}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMYhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMYhjubj)}(h+``umode_t mode`` the new mode of **inode** h](j)}(h``umode_t mode``h]j)}(hj h]h umode_t mode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:89: ./fs/posix_acl.chMZhjubj)}(hhh]h)}(hthe new mode of **inode**h](hthe new mode of }(hj%hhhNhNubj)}(h **inode**h]hinode}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj%ubeh}(h]h ]h"]h$]h&]uh1hhj!hMZhj"ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj!hMZhjubeh}(h]h ]h"]h$]h&]uh1jhjcubh)}(h**Description**h]j)}(hjUh]h Description}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjSubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:89: ./fs/posix_acl.chM\hjcubh)}(hXMIf the dentry has been found through an idmapped mount the idmap of the vfsmount must be passed through **idmap**. This function will then take care to map the inode according to **idmap** before checking permissions. On non-idmapped mounts or if permission checking is to be performed on the raw inode simply pass **nop_mnt_idmap**.h](hhIf the dentry has been found through an idmapped mount the idmap of the vfsmount must be passed through }(hjkhhhNhNubj)}(h **idmap**h]hidmap}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1jhjkubhB. This function will then take care to map the inode according to }(hjkhhhNhNubj)}(h **idmap**h]hidmap}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjkubh before checking permissions. On non-idmapped mounts or if permission checking is to be performed on the raw inode simply pass }(hjkhhhNhNubj)}(h**nop_mnt_idmap**h]h nop_mnt_idmap}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjkubh.}(hjkhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:89: ./fs/posix_acl.chM[hjcubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j "posix_acl_update_mode (C function)c.posix_acl_update_modehNtauh1hhjOghhhNhNubj)}(hhh](j)}(hwint posix_acl_update_mode (const struct mnt_idmap *idmap, struct inode *inode, umode_t *mode_p, struct posix_acl **acl)h]j)}(hvint posix_acl_update_mode(const struct mnt_idmap *idmap, struct inode *inode, umode_t *mode_p, struct posix_acl **acl)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:89: ./fs/posix_acl.chMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMubjC)}(hposix_acl_update_modeh]jI)}(hposix_acl_update_modeh]hposix_acl_update_mode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhMubj=)}(h](const struct mnt_idmap *idmap, struct inode *inode, umode_t *mode_p, struct posix_acl **acl)h](jC)}(hconst struct mnt_idmap *idmaph](j )}(hjJh]hconst}(hj hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj ubj )}(hjh]hstruct}(hj(hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj ubj2)}(h h]h }(hj5hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj ubh)}(hhh]jI)}(h mnt_idmaph]h mnt_idmap}(hjFhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjCubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjHmodnameN classnameNjj )}j ]j)}jjsbc.posix_acl_update_modeasbuh1hhj ubj2)}(h h]h }(hjfhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj ubj)}(hjh]h*}(hjthhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubjI)}(hidmaph]hidmap}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jbc.posix_acl_update_modeasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(humode_t *mode_ph](h)}(hhh]jI)}(humode_th]humode_t}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jbc.posix_acl_update_modeasbuh1hhjubj2)}(h h]h }(hj+hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hmode_ph]hmode_p}(hjFhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct posix_acl **aclh](j )}(hjh]hstruct}(hj_hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj[ubj2)}(h h]h }(hjlhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj[ubh)}(hhh]jI)}(h posix_aclh]h posix_acl}(hj}hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjzubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jbc.posix_acl_update_modeasbuh1hhj[ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj[ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj[ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj[ubjI)}(haclh]hacl}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj[ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhMubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMhjhhubjw)}(hhh]h)}(hupdate mode in set_aclh]hupdate mode in set_acl}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:89: ./fs/posix_acl.chMhjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``const struct mnt_idmap *idmap`` idmap of the mount **inode** was found from ``struct inode *inode`` target inode ``umode_t *mode_p`` mode (pointer) for update ``struct posix_acl **acl`` acl pointer **Description** Update the file mode when setting an ACL: compute the new file permission bits based on the ACL. In addition, if the ACL is equivalent to the new file mode, set ***acl** to NULL to indicate that no ACL should be set. As with chmod, clear the setgid bit if the caller is not in the owning group or capable of CAP_FSETID (see inode_change_ok). If the inode has been found through an idmapped mount the idmap of the vfsmount must be passed through **idmap**. This function will then take care to map the inode according to **idmap** before checking permissions. On non-idmapped mounts or if permission checking is to be performed on the raw inode simply pass **nop_mnt_idmap**. Called from set_acl inode operations.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:89: ./fs/posix_acl.chMhj ubj)}(hhh](j)}(hN``const struct mnt_idmap *idmap`` idmap of the mount **inode** was found from h](j)}(h!``const struct mnt_idmap *idmap``h]j)}(hj.h]hconst struct mnt_idmap *idmap}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj,ubah}(h]h ]h"]h$]h&]uh1jhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:89: ./fs/posix_acl.chMhj(ubj)}(hhh]h)}(h+idmap of the mount **inode** was found fromh](hidmap of the mount }(hjGhhhNhNubj)}(h **inode**h]hinode}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjGubh was found from}(hjGhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjChMhjDubah}(h]h ]h"]h$]h&]uh1jhj(ubeh}(h]h ]h"]h$]h&]uh1jhjChMhj%ubj)}(h%``struct inode *inode`` target inode h](j)}(h``struct inode *inode``h]j)}(hjyh]hstruct inode *inode}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjwubah}(h]h ]h"]h$]h&]uh1jhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:89: ./fs/posix_acl.chMhjsubj)}(hhh]h)}(h target inodeh]h target inode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjsubeh}(h]h ]h"]h$]h&]uh1jhjhMhj%ubj)}(h.``umode_t *mode_p`` mode (pointer) for update h](j)}(h``umode_t *mode_p``h]j)}(hjh]humode_t *mode_p}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:89: ./fs/posix_acl.chMhjubj)}(hhh]h)}(hmode (pointer) for updateh]hmode (pointer) for update}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhj%ubj)}(h'``struct posix_acl **acl`` acl pointer h](j)}(h``struct posix_acl **acl``h]j)}(hjh]hstruct posix_acl **acl}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:89: ./fs/posix_acl.chMhjubj)}(hhh]h)}(h acl pointerh]h acl pointer}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhj%ubeh}(h]h ]h"]h$]h&]uh1jhj ubh)}(h**Description**h]j)}(hj&h]h Description}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj$ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:89: ./fs/posix_acl.chMhj ubh)}(hUpdate the file mode when setting an ACL: compute the new file permission bits based on the ACL. In addition, if the ACL is equivalent to the new file mode, set ***acl** to NULL to indicate that no ACL should be set.h](hUpdate the file mode when setting an ACL: compute the new file permission bits based on the ACL. In addition, if the ACL is equivalent to the new file mode, set }(hj<hhhNhNubj)}(h***acl**h]h*acl}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj<ubh/ to NULL to indicate that no ACL should be set.}(hj<hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:89: ./fs/posix_acl.chMhj ubh)}(h|As with chmod, clear the setgid bit if the caller is not in the owning group or capable of CAP_FSETID (see inode_change_ok).h]h|As with chmod, clear the setgid bit if the caller is not in the owning group or capable of CAP_FSETID (see inode_change_ok).}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:89: ./fs/posix_acl.chMhj ubh)}(hXLIf the inode has been found through an idmapped mount the idmap of the vfsmount must be passed through **idmap**. This function will then take care to map the inode according to **idmap** before checking permissions. On non-idmapped mounts or if permission checking is to be performed on the raw inode simply pass **nop_mnt_idmap**.h](hgIf the inode has been found through an idmapped mount the idmap of the vfsmount must be passed through }(hjlhhhNhNubj)}(h **idmap**h]hidmap}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jhjlubhB. This function will then take care to map the inode according to }(hjlhhhNhNubj)}(h **idmap**h]hidmap}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjlubh before checking permissions. On non-idmapped mounts or if permission checking is to be performed on the raw inode simply pass }(hjlhhhNhNubj)}(h**nop_mnt_idmap**h]h nop_mnt_idmap}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjlubh.}(hjlhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:89: ./fs/posix_acl.chMhj ubh)}(h%Called from set_acl inode operations.h]h%Called from set_acl inode operations.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:89: ./fs/posix_acl.chMhj ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j !posix_acl_from_xattr (C function)c.posix_acl_from_xattrhNtauh1hhjOghhhNhNubj)}(hhh](j)}(hgstruct posix_acl * posix_acl_from_xattr (struct user_namespace *userns, const void *value, size_t size)h]j)}(hestruct posix_acl *posix_acl_from_xattr(struct user_namespace *userns, const void *value, size_t size)h](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjhhhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:89: ./fs/posix_acl.chMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMubh)}(hhh]jI)}(h posix_aclh]h posix_acl}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jposix_acl_from_xattrsbc.posix_acl_from_xattrasbuh1hhjhhhjhMubj2)}(h h]h }(hj hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMubj)}(hjh]h*}(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubjC)}(hposix_acl_from_xattrh]jI)}(hjh]hposix_acl_from_xattr}(hj?hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj;ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhMubj=)}(h?(struct user_namespace *userns, const void *value, size_t size)h](jC)}(hstruct user_namespace *usernsh](j )}(hjh]hstruct}(hjZhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjVubj2)}(h h]h }(hjghhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjVubh)}(hhh]jI)}(huser_namespaceh]huser_namespace}(hjxhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjuubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjzmodnameN classnameNjj )}j ]jc.posix_acl_from_xattrasbuh1hhjVubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjVubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVubjI)}(husernsh]huserns}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjVubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjRubjC)}(hconst void *valueh](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hvalueh]hvalue}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjRubjC)}(h size_t sizeh](h)}(hhh]jI)}(hsize_th]hsize_t}(hj*hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj'ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj,modnameN classnameNjj )}j ]jc.posix_acl_from_xattrasbuh1hhj#ubj2)}(h h]h }(hjHhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj#ubjI)}(hsizeh]hsize}(hjVhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj#ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjRubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhMubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMhjhhubjw)}(hhh]h)}(h3convert POSIX ACLs from backing store to VFS formath]h3convert POSIX ACLs from backing store to VFS format}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:89: ./fs/posix_acl.chMhj}hhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``struct user_namespace *userns`` the filesystem's idmapping ``const void *value`` the uapi representation of POSIX ACLs ``size_t size`` the size of **void** **Description** Filesystems that store POSIX ACLs in the unaltered uapi format should use posix_acl_from_xattr() when reading them from the backing store and converting them into the struct posix_acl VFS format. The helper is specifically intended to be called from the acl inode operation. The posix_acl_from_xattr() function will map the raw {g,u}id values stored in ACL_{GROUP,USER} entries into idmapping in **userns**. Note that posix_acl_from_xattr() does not take idmapped mounts into account. If it did it calling it from the get acl inode operation would return POSIX ACLs mapped according to an idmapped mount which would mean that the value couldn't be cached for the filesystem. Idmapped mounts are taken into account on the fly during permission checking or right at the VFS - userspace boundary before reporting them to the user. **Return** Allocated struct posix_acl on success, NULL for a valid header but without actual POSIX ACL entries, or ERR_PTR() encoded error code.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:89: ./fs/posix_acl.chMhjubj)}(hhh](j)}(h=``struct user_namespace *userns`` the filesystem's idmapping h](j)}(h!``struct user_namespace *userns``h]j)}(hjh]hstruct user_namespace *userns}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:89: ./fs/posix_acl.chMhjubj)}(hhh]h)}(hthe filesystem's idmappingh]hthe filesystem’s idmapping}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h<``const void *value`` the uapi representation of POSIX ACLs h](j)}(h``const void *value``h]j)}(hjh]hconst void *value}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:89: ./fs/posix_acl.chMhjubj)}(hhh]h)}(h%the uapi representation of POSIX ACLsh]h%the uapi representation of POSIX ACLs}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h%``size_t size`` the size of **void** h](j)}(h``size_t size``h]j)}(hj3h]h size_t size}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj1ubah}(h]h ]h"]h$]h&]uh1jhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:89: ./fs/posix_acl.chMhj-ubj)}(hhh]h)}(hthe size of **void**h](h the size of }(hjLhhhNhNubj)}(h**void**h]hvoid}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jhjLubeh}(h]h ]h"]h$]h&]uh1hhjHhMhjIubah}(h]h ]h"]h$]h&]uh1jhj-ubeh}(h]h ]h"]h$]h&]uh1jhjHhMhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hj|h]h Description}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjzubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:89: ./fs/posix_acl.chMhjubh)}(hXFilesystems that store POSIX ACLs in the unaltered uapi format should use posix_acl_from_xattr() when reading them from the backing store and converting them into the struct posix_acl VFS format. The helper is specifically intended to be called from the acl inode operation.h]hXFilesystems that store POSIX ACLs in the unaltered uapi format should use posix_acl_from_xattr() when reading them from the backing store and converting them into the struct posix_acl VFS format. The helper is specifically intended to be called from the acl inode operation.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:89: ./fs/posix_acl.chMhjubh)}(hThe posix_acl_from_xattr() function will map the raw {g,u}id values stored in ACL_{GROUP,USER} entries into idmapping in **userns**.h](hyThe posix_acl_from_xattr() function will map the raw {g,u}id values stored in ACL_{GROUP,USER} entries into idmapping in }(hjhhhNhNubj)}(h **userns**h]huserns}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:89: ./fs/posix_acl.chMhjubh)}(hXNote that posix_acl_from_xattr() does not take idmapped mounts into account. If it did it calling it from the get acl inode operation would return POSIX ACLs mapped according to an idmapped mount which would mean that the value couldn't be cached for the filesystem. Idmapped mounts are taken into account on the fly during permission checking or right at the VFS - userspace boundary before reporting them to the user.h]hXNote that posix_acl_from_xattr() does not take idmapped mounts into account. If it did it calling it from the get acl inode operation would return POSIX ACLs mapped according to an idmapped mount which would mean that the value couldn’t be cached for the filesystem. Idmapped mounts are taken into account on the fly during permission checking or right at the VFS - userspace boundary before reporting them to the user.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:89: ./fs/posix_acl.chMhjubh)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:89: ./fs/posix_acl.chMhjubh)}(hAllocated struct posix_acl on success, NULL for a valid header but without actual POSIX ACL entries, or ERR_PTR() encoded error code.h]hAllocated struct posix_acl on success, NULL for a valid header but without actual POSIX ACL entries, or ERR_PTR() encoded error code.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:89: ./fs/posix_acl.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j vfs_set_acl (C function) c.vfs_set_aclhNtauh1hhjOghhhNhNubj)}(hhh](j)}(htint vfs_set_acl (const struct mnt_idmap *idmap, struct dentry *dentry, const char *acl_name, struct posix_acl *kacl)h]j)}(hsint vfs_set_acl(const struct mnt_idmap *idmap, struct dentry *dentry, const char *acl_name, struct posix_acl *kacl)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:89: ./fs/posix_acl.chM;ubj2)}(h h]h }(hj'hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhj&hM;ubjC)}(h vfs_set_aclh]jI)}(h vfs_set_aclh]h vfs_set_acl}(hj9hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj5ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhj&hM;ubj=)}(hd(const struct mnt_idmap *idmap, struct dentry *dentry, const char *acl_name, struct posix_acl *kacl)h](jC)}(hconst struct mnt_idmap *idmaph](j )}(hjJh]hconst}(hjUhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjQubj2)}(h h]h }(hjbhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjQubj )}(hjh]hstruct}(hjphhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjQubj2)}(h h]h }(hj}hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjQubh)}(hhh]jI)}(h mnt_idmaph]h mnt_idmap}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jj;sb c.vfs_set_aclasbuh1hhjQubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjQubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjQubjI)}(hidmaph]hidmap}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjQubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjMubjC)}(hstruct dentry *dentryh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j c.vfs_set_aclasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hdentryh]hdentry}(hj9hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjMubjC)}(hconst char *acl_nameh](j )}(hjJh]hconst}(hjRhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjNubj2)}(h h]h }(hj_hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjNubj)}(hcharh]hchar}(hjmhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubj2)}(h h]h }(hj{hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjNubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubjI)}(hacl_nameh]hacl_name}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjNubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjMubjC)}(hstruct posix_acl *kaclh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(h posix_aclh]h posix_acl}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j c.vfs_set_aclasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hkaclh]hkacl}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjMubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhj&hM;ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhj&hM;ubah}(h]j ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj&hM;hj hhubjw)}(hhh]h)}(hset posix aclsh]hset posix acls}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:89: ./fs/posix_acl.chM;hj-hhubah}(h]h ]h"]h$]h&]uh1jvhj hhhj&hM;ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjHjjHjjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``const struct mnt_idmap *idmap`` idmap of the mount ``struct dentry *dentry`` the dentry based on which to set the posix acls ``const char *acl_name`` the name of the posix acl ``struct posix_acl *kacl`` the posix acls in the appropriate VFS format **Description** This function sets **kacl**. The caller must all posix_acl_release() on **kacl** afterwards. **Return** On success 0, on error negative errno.h](h)}(h**Parameters**h]j)}(hjRh]h Parameters}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jhjPubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:89: ./fs/posix_acl.chM?hjLubj)}(hhh](j)}(h5``const struct mnt_idmap *idmap`` idmap of the mount h](j)}(h!``const struct mnt_idmap *idmap``h]j)}(hjqh]hconst struct mnt_idmap *idmap}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1jhjoubah}(h]h ]h"]h$]h&]uh1jhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:89: ./fs/posix_acl.chM<hjkubj)}(hhh]h)}(hidmap of the mounth]hidmap of the mount}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM<hjubah}(h]h ]h"]h$]h&]uh1jhjkubeh}(h]h ]h"]h$]h&]uh1jhjhM<hjhubj)}(hJ``struct dentry *dentry`` the dentry based on which to set the posix acls h](j)}(h``struct dentry *dentry``h]j)}(hjh]hstruct dentry *dentry}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:89: ./fs/posix_acl.chM=hjubj)}(hhh]h)}(h/the dentry based on which to set the posix aclsh]h/the dentry based on which to set the posix acls}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM=hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM=hjhubj)}(h3``const char *acl_name`` the name of the posix acl h](j)}(h``const char *acl_name``h]j)}(hjh]hconst char *acl_name}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:89: ./fs/posix_acl.chM>hjubj)}(hhh]h)}(hthe name of the posix aclh]hthe name of the posix acl}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM>hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM>hjhubj)}(hH``struct posix_acl *kacl`` the posix acls in the appropriate VFS format h](j)}(h``struct posix_acl *kacl``h]j)}(hjh]hstruct posix_acl *kacl}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:89: ./fs/posix_acl.chM?hjubj)}(hhh]h)}(h,the posix acls in the appropriate VFS formath]h,the posix acls in the appropriate VFS format}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj1hM?hj2ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj1hM?hjhubeh}(h]h ]h"]h$]h&]uh1jhjLubh)}(h**Description**h]j)}(hjWh]h Description}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjUubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:89: ./fs/posix_acl.chMAhjLubh)}(h\This function sets **kacl**. The caller must all posix_acl_release() on **kacl** afterwards.h](hThis function sets }(hjmhhhNhNubj)}(h**kacl**h]hkacl}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjmubh-. The caller must all posix_acl_release() on }(hjmhhhNhNubj)}(h**kacl**h]hkacl}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjmubh afterwards.}(hjmhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:89: ./fs/posix_acl.chM@hjLubh)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:89: ./fs/posix_acl.chMChjLubh)}(h&On success 0, on error negative errno.h]h&On success 0, on error negative errno.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:89: ./fs/posix_acl.chMDhjLubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j vfs_get_acl (C function) c.vfs_get_aclhNtauh1hhjOghhhNhNubj)}(hhh](j)}(hkstruct posix_acl * vfs_get_acl (const struct mnt_idmap *idmap, struct dentry *dentry, const char *acl_name)h]j)}(histruct posix_acl *vfs_get_acl(const struct mnt_idmap *idmap, struct dentry *dentry, const char *acl_name)h](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjhhhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:89: ./fs/posix_acl.chMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMubh)}(hhh]jI)}(h posix_aclh]h posix_acl}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}j vfs_get_aclsb c.vfs_get_aclasbuh1hhjhhhjhMubj2)}(h h]h }(hj'hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMubj)}(hjh]h*}(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubjC)}(h vfs_get_aclh]jI)}(hj$h]h vfs_get_acl}(hjFhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjBubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhMubj=)}(hL(const struct mnt_idmap *idmap, struct dentry *dentry, const char *acl_name)h](jC)}(hconst struct mnt_idmap *idmaph](j )}(hjJh]hconst}(hjahhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj]ubj2)}(h h]h }(hjnhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj]ubj )}(hjh]hstruct}(hj|hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj]ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj]ubh)}(hhh]jI)}(h mnt_idmaph]h mnt_idmap}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j" c.vfs_get_aclasbuh1hhj]ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj]ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj]ubjI)}(hidmaph]hidmap}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj]ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjYubjC)}(hstruct dentry *dentryh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hdentryh]hdentry}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj modnameN classnameNjj )}j ]j" c.vfs_get_aclasbuh1hhjubj2)}(h h]h }(hj( hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj6 hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hdentryh]hdentry}(hjC hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjYubjC)}(hconst char *acl_nameh](j )}(hjJh]hconst}(hj\ hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjX ubj2)}(h h]h }(hji hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjX ubj)}(hcharh]hchar}(hjw hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjX ubj2)}(h h]h }(hj hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjX ubj)}(hjh]h*}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjX ubjI)}(hacl_nameh]hacl_name}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjX ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjYubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhMubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMhjhhubjw)}(hhh]h)}(hget posix aclsh]hget posix acls}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:89: ./fs/posix_acl.chMhj hhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjj jj jjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``const struct mnt_idmap *idmap`` idmap of the mount ``struct dentry *dentry`` the dentry based on which to retrieve the posix acls ``const char *acl_name`` the name of the posix acl **Description** This function retrieves **kacl** from the filesystem. The caller must all posix_acl_release() on **kacl**. **Return** On success POSIX ACLs in VFS format, on error negative errno.h](h)}(h**Parameters**h]j)}(hj h]h Parameters}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:89: ./fs/posix_acl.chMhj ubj)}(hhh](j)}(h5``const struct mnt_idmap *idmap`` idmap of the mount h](j)}(h!``const struct mnt_idmap *idmap``h]j)}(hj h]hconst struct mnt_idmap *idmap}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:89: ./fs/posix_acl.chMhj ubj)}(hhh]h)}(hidmap of the mounth]hidmap of the mount}(hj$ hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMhj! ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hMhj ubj)}(hO``struct dentry *dentry`` the dentry based on which to retrieve the posix acls h](j)}(h``struct dentry *dentry``h]j)}(hjD h]hstruct dentry *dentry}(hjF hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjB ubah}(h]h ]h"]h$]h&]uh1jhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:89: ./fs/posix_acl.chMhj> ubj)}(hhh]h)}(h4the dentry based on which to retrieve the posix aclsh]h4the dentry based on which to retrieve the posix acls}(hj] hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjY hMhjZ ubah}(h]h ]h"]h$]h&]uh1jhj> ubeh}(h]h ]h"]h$]h&]uh1jhjY hMhj ubj)}(h3``const char *acl_name`` the name of the posix acl h](j)}(h``const char *acl_name``h]j)}(hj} h]hconst char *acl_name}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj{ ubah}(h]h ]h"]h$]h&]uh1jhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:89: ./fs/posix_acl.chMhjw ubj)}(hhh]h)}(hthe name of the posix aclh]hthe name of the posix acl}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMhj ubah}(h]h ]h"]h$]h&]uh1jhjw ubeh}(h]h ]h"]h$]h&]uh1jhj hMhj ubeh}(h]h ]h"]h$]h&]uh1jhj ubh)}(h**Description**h]j)}(hj h]h Description}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:89: ./fs/posix_acl.chMhj ubh)}(hjThis function retrieves **kacl** from the filesystem. The caller must all posix_acl_release() on **kacl**.h](hThis function retrieves }(hj hhhNhNubj)}(h**kacl**h]hkacl}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubhA from the filesystem. The caller must all posix_acl_release() on }(hj hhhNhNubj)}(h**kacl**h]hkacl}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubh.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:89: ./fs/posix_acl.chMhj ubh)}(h **Return**h]j)}(hj h]hReturn}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:89: ./fs/posix_acl.chMhj ubh)}(h=On success POSIX ACLs in VFS format, on error negative errno.h]h=On success POSIX ACLs in VFS format, on error negative errno.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:89: ./fs/posix_acl.chMhj ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j vfs_remove_acl (C function)c.vfs_remove_aclhNtauh1hhjOghhhNhNubj)}(hhh](j)}(h_int vfs_remove_acl (const struct mnt_idmap *idmap, struct dentry *dentry, const char *acl_name)h]j)}(h^int vfs_remove_acl(const struct mnt_idmap *idmap, struct dentry *dentry, const char *acl_name)h](j)}(hinth]hint}(hjH hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjD hhhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:89: ./fs/posix_acl.chMubj2)}(h h]h }(hjW hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjD hhhjV hMubjC)}(hvfs_remove_aclh]jI)}(hvfs_remove_aclh]hvfs_remove_acl}(hji hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhje ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjD hhhjV hMubj=)}(hL(const struct mnt_idmap *idmap, struct dentry *dentry, const char *acl_name)h](jC)}(hconst struct mnt_idmap *idmaph](j )}(hjJh]hconst}(hj hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj ubj2)}(h h]h }(hj hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj ubj )}(hjh]hstruct}(hj hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj ubj2)}(h h]h }(hj hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj ubh)}(hhh]jI)}(h mnt_idmaph]h mnt_idmap}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj modnameN classnameNjj )}j ]j)}jjk sbc.vfs_remove_aclasbuh1hhj ubj2)}(h h]h }(hj hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj ubj)}(hjh]h*}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubjI)}(hidmaph]hidmap}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj} ubjC)}(hstruct dentry *dentryh](j )}(hjh]hstruct}(hj hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj ubj2)}(h h]h }(hj hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj ubh)}(hhh]jI)}(hdentryh]hdentry}(hj0 hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj- ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj2 modnameN classnameNjj )}j ]j c.vfs_remove_aclasbuh1hhj ubj2)}(h h]h }(hjN hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj ubj)}(hjh]h*}(hj\ hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubjI)}(hdentryh]hdentry}(hji hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj} ubjC)}(hconst char *acl_nameh](j )}(hjJh]hconst}(hj hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj~ ubj2)}(h h]h }(hj hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj~ ubj)}(hcharh]hchar}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~ ubj2)}(h h]h }(hj hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj~ ubj)}(hjh]h*}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~ ubjI)}(hacl_nameh]hacl_name}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj~ ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj} ubeh}(h]h ]h"]h$]h&]j`jauh1j<hjD hhhjV hMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj@ hhhjV hMubah}(h]j; ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjV hMhj= hhubjw)}(hhh]h)}(hremove posix aclsh]hremove posix acls}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:89: ./fs/posix_acl.chMhj hhubah}(h]h ]h"]h$]h&]uh1jvhj= hhhjV hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjj jj jjjuh1jhhhjOghNhNubj)}(hX6**Parameters** ``const struct mnt_idmap *idmap`` idmap of the mount ``struct dentry *dentry`` the dentry based on which to retrieve the posix acls ``const char *acl_name`` the name of the posix acl **Description** This function removes posix acls. **Return** On success 0, on error negative errno.h](h)}(h**Parameters**h]j)}(hj h]h Parameters}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:89: ./fs/posix_acl.chMhj ubj)}(hhh](j)}(h5``const struct mnt_idmap *idmap`` idmap of the mount h](j)}(h!``const struct mnt_idmap *idmap``h]j)}(hj1 h]hconst struct mnt_idmap *idmap}(hj3 hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj/ ubah}(h]h ]h"]h$]h&]uh1jhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:89: ./fs/posix_acl.chMhj+ ubj)}(hhh]h)}(hidmap of the mounth]hidmap of the mount}(hjJ hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjF hMhjG ubah}(h]h ]h"]h$]h&]uh1jhj+ ubeh}(h]h ]h"]h$]h&]uh1jhjF hMhj( ubj)}(hO``struct dentry *dentry`` the dentry based on which to retrieve the posix acls h](j)}(h``struct dentry *dentry``h]j)}(hjj h]hstruct dentry *dentry}(hjl hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjh ubah}(h]h ]h"]h$]h&]uh1jhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:89: ./fs/posix_acl.chMhjd ubj)}(hhh]h)}(h4the dentry based on which to retrieve the posix aclsh]h4the dentry based on which to retrieve the posix acls}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMhj ubah}(h]h ]h"]h$]h&]uh1jhjd ubeh}(h]h ]h"]h$]h&]uh1jhj hMhj( ubj)}(h3``const char *acl_name`` the name of the posix acl h](j)}(h``const char *acl_name``h]j)}(hj h]hconst char *acl_name}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:89: ./fs/posix_acl.chMhj ubj)}(hhh]h)}(hthe name of the posix aclh]hthe name of the posix acl}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hMhj( ubeh}(h]h ]h"]h$]h&]uh1jhj ubh)}(h**Description**h]j)}(hj h]h Description}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:89: ./fs/posix_acl.chMhj ubh)}(h!This function removes posix acls.h]h!This function removes posix acls.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:89: ./fs/posix_acl.chMhj ubh)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:89: ./fs/posix_acl.chMhj ubh)}(h&On success 0, on error negative errno.h]h&On success 0, on error negative errno.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:89: ./fs/posix_acl.chMhj ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j fill_mg_cmtime (C function)c.fill_mg_cmtimehNtauh1hhjOghhhNhNubj)}(hhh](j)}(hOvoid fill_mg_cmtime (struct kstat *stat, u32 request_mask, struct inode *inode)h]j)}(hNvoid fill_mg_cmtime(struct kstat *stat, u32 request_mask, struct inode *inode)h](j)}(hvoidh]hvoid}(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFhhhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:92: ./fs/stat.chK ubj2)}(h h]h }(hjYhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjFhhhjXhK ubjC)}(hfill_mg_cmtimeh]jI)}(hfill_mg_cmtimeh]hfill_mg_cmtime}(hjkhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjgubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjFhhhjXhK ubj=)}(h;(struct kstat *stat, u32 request_mask, struct inode *inode)h](jC)}(hstruct kstat *stath](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hkstath]hkstat}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jjmsbc.fill_mg_cmtimeasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hstath]hstat}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hu32 request_maskh](h)}(hhh]jI)}(hu32h]hu32}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.fill_mg_cmtimeasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(h request_maskh]h request_mask}(hj(hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hjAhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj=ubj2)}(h h]h }(hjNhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj=ubh)}(hhh]jI)}(hinodeh]hinode}(hj_hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj\ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjamodnameN classnameNjj )}j ]jc.fill_mg_cmtimeasbuh1hhj=ubj2)}(h h]h }(hj}hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj=ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=ubjI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj=ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjFhhhjXhK ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjBhhhjXhK ubah}(h]j=ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjXhK hj?hhubjw)}(hhh]h)}(h5Fill in the mtime and ctime and flag ctime as QUERIEDh]h5Fill in the mtime and ctime and flag ctime as QUERIED}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:92: ./fs/stat.chK hjhhubah}(h]h ]h"]h$]h&]uh1jvhj?hhhjXhK ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjOghNhNubj)}(hX<**Parameters** ``struct kstat *stat`` where to store the resulting values ``u32 request_mask`` STATX_* values requested ``struct inode *inode`` inode from which to grab the c/mtime **Description** Given **inode**, grab the ctime and mtime out if it and store the result in **stat**. When fetching the value, flag it as QUERIED (if not already) so the next write will record a distinct timestamp. NB: The QUERIED flag is tracked in the ctime, but we set it there even if only the mtime was requested, as that ensures that the next mtime change will be distinct.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:92: ./fs/stat.chK$hjubj)}(hhh](j)}(h;``struct kstat *stat`` where to store the resulting values h](j)}(h``struct kstat *stat``h]j)}(hjh]hstruct kstat *stat}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:92: ./fs/stat.chK!hjubj)}(hhh]h)}(h#where to store the resulting valuesh]h#where to store the resulting values}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhK!hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhK!hjubj)}(h.``u32 request_mask`` STATX_* values requested h](j)}(h``u32 request_mask``h]j)}(hj<h]hu32 request_mask}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj:ubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:92: ./fs/stat.chK"hj6ubj)}(hhh]h)}(hSTATX_* values requestedh]hSTATX_* values requested}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjQhK"hjRubah}(h]h ]h"]h$]h&]uh1jhj6ubeh}(h]h ]h"]h$]h&]uh1jhjQhK"hjubj)}(h=``struct inode *inode`` inode from which to grab the c/mtime h](j)}(h``struct inode *inode``h]j)}(hjuh]hstruct inode *inode}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjsubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:92: ./fs/stat.chK#hjoubj)}(hhh]h)}(h$inode from which to grab the c/mtimeh]h$inode from which to grab the c/mtime}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhK#hjubah}(h]h ]h"]h$]h&]uh1jhjoubeh}(h]h ]h"]h$]h&]uh1jhjhK#hjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:92: ./fs/stat.chK%hjubh)}(hGiven **inode**, grab the ctime and mtime out if it and store the result in **stat**. When fetching the value, flag it as QUERIED (if not already) so the next write will record a distinct timestamp.h](hGiven }(hjhhhNhNubj)}(h **inode**h]hinode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh=, grab the ctime and mtime out if it and store the result in }(hjhhhNhNubj)}(h**stat**h]hstat}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhr. When fetching the value, flag it as QUERIED (if not already) so the next write will record a distinct timestamp.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:92: ./fs/stat.chK$hjubh)}(hNB: The QUERIED flag is tracked in the ctime, but we set it there even if only the mtime was requested, as that ensures that the next mtime change will be distinct.h]hNB: The QUERIED flag is tracked in the ctime, but we set it there even if only the mtime was requested, as that ensures that the next mtime change will be distinct.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:92: ./fs/stat.chK(hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j generic_fillattr (C function)c.generic_fillattrhNtauh1hhjOghhhNhNubj)}(hhh](j)}(hpvoid generic_fillattr (const struct mnt_idmap *idmap, u32 request_mask, struct inode *inode, struct kstat *stat)h]j)}(hovoid generic_fillattr(const struct mnt_idmap *idmap, u32 request_mask, struct inode *inode, struct kstat *stat)h](j)}(hvoidh]hvoid}(hj(hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$hhhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:92: ./fs/stat.chKBubj2)}(h h]h }(hj7hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj$hhhj6hKBubjC)}(hgeneric_fillattrh]jI)}(hgeneric_fillattrh]hgeneric_fillattr}(hjIhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjEubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj$hhhj6hKBubj=)}(hZ(const struct mnt_idmap *idmap, u32 request_mask, struct inode *inode, struct kstat *stat)h](jC)}(hconst struct mnt_idmap *idmaph](j )}(hjJh]hconst}(hjehhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjaubj2)}(h h]h }(hjrhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjaubj )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjaubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjaubh)}(hhh]jI)}(h mnt_idmaph]h mnt_idmap}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jjKsbc.generic_fillattrasbuh1hhjaubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjaubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubjI)}(hidmaph]hidmap}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjaubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj]ubjC)}(hu32 request_maskh](h)}(hhh]jI)}(hu32h]hu32}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.generic_fillattrasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(h request_maskh]h request_mask}(hj!hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj]ubjC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hj:hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj6ubj2)}(h h]h }(hjGhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj6ubh)}(hhh]jI)}(hinodeh]hinode}(hjXhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjUubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjZmodnameN classnameNjj )}j ]jc.generic_fillattrasbuh1hhj6ubj2)}(h h]h }(hjvhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj6ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj6ubjI)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj6ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj]ubjC)}(hstruct kstat *stath](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hkstath]hkstat}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.generic_fillattrasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hstath]hstat}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj]ubeh}(h]h ]h"]h$]h&]j`jauh1j<hj$hhhj6hKBubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj hhhj6hKBubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj6hKBhjhhubjw)}(hhh]h)}(h2Fill in the basic attributes from the inode structh]h2Fill in the basic attributes from the inode struct}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:92: ./fs/stat.chKBhj(hhubah}(h]h ]h"]h$]h&]uh1jvhjhhhj6hKBubeh}(h]h ](jfunctioneh"]h$]h&]jjjjCjjCjjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``const struct mnt_idmap *idmap`` idmap of the mount the inode was found from ``u32 request_mask`` statx request_mask ``struct inode *inode`` Inode to use as the source ``struct kstat *stat`` Where to fill in the attributes **Description** Fill in the basic attributes in the kstat structure from data that's to be found on the VFS inode structure. This is the default if no getattr inode operation is supplied. If the inode has been found through an idmapped mount the idmap of the vfsmount must be passed through **idmap**. This function will then take care to map the inode according to **idmap** before filling in the uid and gid filds. On non-idmapped mounts or if permission checking is to be performed on the raw inode simply pass **nop_mnt_idmap**.h](h)}(h**Parameters**h]j)}(hjMh]h Parameters}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjKubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:92: ./fs/stat.chKFhjGubj)}(hhh](j)}(hN``const struct mnt_idmap *idmap`` idmap of the mount the inode was found from h](j)}(h!``const struct mnt_idmap *idmap``h]j)}(hjlh]hconst struct mnt_idmap *idmap}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjjubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:92: ./fs/stat.chKChjfubj)}(hhh]h)}(h+idmap of the mount the inode was found fromh]h+idmap of the mount the inode was found from}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKChjubah}(h]h ]h"]h$]h&]uh1jhjfubeh}(h]h ]h"]h$]h&]uh1jhjhKChjcubj)}(h(``u32 request_mask`` statx request_mask h](j)}(h``u32 request_mask``h]j)}(hjh]hu32 request_mask}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:92: ./fs/stat.chKDhjubj)}(hhh]h)}(hstatx request_maskh]hstatx request_mask}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKDhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKDhjcubj)}(h3``struct inode *inode`` Inode to use as the source h](j)}(h``struct inode *inode``h]j)}(hjh]hstruct inode *inode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:92: ./fs/stat.chKEhjubj)}(hhh]h)}(hInode to use as the sourceh]hInode to use as the source}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKEhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKEhjcubj)}(h7``struct kstat *stat`` Where to fill in the attributes h](j)}(h``struct kstat *stat``h]j)}(hjh]hstruct kstat *stat}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:92: ./fs/stat.chKFhjubj)}(hhh]h)}(hWhere to fill in the attributesh]hWhere to fill in the attributes}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj,hKFhj-ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj,hKFhjcubeh}(h]h ]h"]h$]h&]uh1jhjGubh)}(h**Description**h]j)}(hjRh]h Description}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jhjPubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:92: ./fs/stat.chKHhjGubh)}(hFill in the basic attributes in the kstat structure from data that's to be found on the VFS inode structure. This is the default if no getattr inode operation is supplied.h]hFill in the basic attributes in the kstat structure from data that’s to be found on the VFS inode structure. This is the default if no getattr inode operation is supplied.}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:92: ./fs/stat.chKGhjGubh)}(hXXIf the inode has been found through an idmapped mount the idmap of the vfsmount must be passed through **idmap**. This function will then take care to map the inode according to **idmap** before filling in the uid and gid filds. On non-idmapped mounts or if permission checking is to be performed on the raw inode simply pass **nop_mnt_idmap**.h](hgIf the inode has been found through an idmapped mount the idmap of the vfsmount must be passed through }(hjwhhhNhNubj)}(h **idmap**h]hidmap}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjwubhB. This function will then take care to map the inode according to }(hjwhhhNhNubj)}(h **idmap**h]hidmap}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjwubh before filling in the uid and gid filds. On non-idmapped mounts or if permission checking is to be performed on the raw inode simply pass }(hjwhhhNhNubj)}(h**nop_mnt_idmap**h]h nop_mnt_idmap}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjwubh.}(hjwhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:92: ./fs/stat.chKKhjGubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j $generic_fill_statx_attr (C function)c.generic_fill_statx_attrhNtauh1hhjOghhhNhNubj)}(hhh](j)}(hFvoid generic_fill_statx_attr (struct inode *inode, struct kstat *stat)h]j)}(hEvoid generic_fill_statx_attr(struct inode *inode, struct kstat *stat)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:92: ./fs/stat.chKuubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhKuubjC)}(hgeneric_fill_statx_attrh]jI)}(hgeneric_fill_statx_attrh]hgeneric_fill_statx_attr}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhKuubj=)}(h)(struct inode *inode, struct kstat *stat)h](jC)}(hstruct inode *inodeh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hj&hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hinodeh]hinode}(hj7hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj4ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj9modnameN classnameNjj )}j ]j)}jjsbc.generic_fill_statx_attrasbuh1hhjubj2)}(h h]h }(hjWhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hinodeh]hinode}(hjrhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct kstat *stath](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hkstath]hkstat}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jSc.generic_fill_statx_attrasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hstath]hstat}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhKuubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhKuubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhKuhjhhubjw)}(hhh]h)}(h1Fill in the statx attributes from the inode flagsh]h1Fill in the statx attributes from the inode flags}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:92: ./fs/stat.chKuhj hhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhKuubeh}(h]h ](jfunctioneh"]h$]h&]jjjj$jj$jjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``struct inode *inode`` Inode to use as the source ``struct kstat *stat`` Where to fill in the attribute flags **Description** Fill in the STATX_ATTR_* flags in the kstat structure for properties of the inode that are published on i_flags and enforced by the VFS.h](h)}(h**Parameters**h]j)}(hj.h]h Parameters}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj,ubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:92: ./fs/stat.chKyhj(ubj)}(hhh](j)}(h3``struct inode *inode`` Inode to use as the source h](j)}(h``struct inode *inode``h]j)}(hjMh]hstruct inode *inode}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjKubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:92: ./fs/stat.chKvhjGubj)}(hhh]h)}(hInode to use as the sourceh]hInode to use as the source}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjbhKvhjcubah}(h]h ]h"]h$]h&]uh1jhjGubeh}(h]h ]h"]h$]h&]uh1jhjbhKvhjDubj)}(h<``struct kstat *stat`` Where to fill in the attribute flags h](j)}(h``struct kstat *stat``h]j)}(hjh]hstruct kstat *stat}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:92: ./fs/stat.chKwhjubj)}(hhh]h)}(h$Where to fill in the attribute flagsh]h$Where to fill in the attribute flags}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKwhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKwhjDubeh}(h]h ]h"]h$]h&]uh1jhj(ubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:92: ./fs/stat.chKyhj(ubh)}(hFill in the STATX_ATTR_* flags in the kstat structure for properties of the inode that are published on i_flags and enforced by the VFS.h]hFill in the STATX_ATTR_* flags in the kstat structure for properties of the inode that are published on i_flags and enforced by the VFS.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:92: ./fs/stat.chKxhj(ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j -generic_fill_statx_atomic_writes (C function)"c.generic_fill_statx_atomic_writeshNtauh1hhjOghhhNhNubj)}(hhh](j)}(hvoid generic_fill_statx_atomic_writes (struct kstat *stat, unsigned int unit_min, unsigned int unit_max, unsigned int unit_max_opt)h]j)}(hvoid generic_fill_statx_atomic_writes(struct kstat *stat, unsigned int unit_min, unsigned int unit_max, unsigned int unit_max_opt)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:92: ./fs/stat.chKubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhKubjC)}(h generic_fill_statx_atomic_writesh]jI)}(h generic_fill_statx_atomic_writesh]h generic_fill_statx_atomic_writes}(hj'hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj#ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhKubj=)}(h](struct kstat *stat, unsigned int unit_min, unsigned int unit_max, unsigned int unit_max_opt)h](jC)}(hstruct kstat *stath](j )}(hjh]hstruct}(hjChhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj?ubj2)}(h h]h }(hjPhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj?ubh)}(hhh]jI)}(hkstath]hkstat}(hjahhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj^ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjcmodnameN classnameNjj )}j ]j)}jj)sb"c.generic_fill_statx_atomic_writesasbuh1hhj?ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj?ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?ubjI)}(hstath]hstat}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj?ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj;ubjC)}(hunsigned int unit_minh](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hunit_minh]hunit_min}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj;ubjC)}(hunsigned int unit_maxh](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hinth]hint}(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hj0hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hunit_maxh]hunit_max}(hj>hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj;ubjC)}(hunsigned int unit_max_opth](j)}(hunsignedh]hunsigned}(hjWhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSubj2)}(h h]h }(hjehhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjSubj)}(hinth]hint}(hjshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjSubjI)}(h unit_max_opth]h unit_max_opt}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjSubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj;ubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhKubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhKubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhKhjhhubjw)}(hhh]h)}(h&Fill in atomic writes statx attributesh]h&Fill in atomic writes statx attributes}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:92: ./fs/stat.chKhjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhKubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``struct kstat *stat`` Where to fill in the attribute flags ``unsigned int unit_min`` Minimum supported atomic write length in bytes ``unsigned int unit_max`` Maximum supported atomic write length in bytes ``unsigned int unit_max_opt`` Optimised maximum supported atomic write length in bytes **Description** Fill in the STATX{_ATTR}_WRITE_ATOMIC flags in the kstat structure from atomic write unit_min and unit_max values.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:92: ./fs/stat.chKhjubj)}(hhh](j)}(h<``struct kstat *stat`` Where to fill in the attribute flags h](j)}(h``struct kstat *stat``h]j)}(hjh]hstruct kstat *stat}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:92: ./fs/stat.chKhjubj)}(hhh]h)}(h$Where to fill in the attribute flagsh]h$Where to fill in the attribute flags}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubj)}(hI``unsigned int unit_min`` Minimum supported atomic write length in bytes h](j)}(h``unsigned int unit_min``h]j)}(hj3h]hunsigned int unit_min}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj1ubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:92: ./fs/stat.chKhj-ubj)}(hhh]h)}(h.Minimum supported atomic write length in bytesh]h.Minimum supported atomic write length in bytes}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjHhKhjIubah}(h]h ]h"]h$]h&]uh1jhj-ubeh}(h]h ]h"]h$]h&]uh1jhjHhKhjubj)}(hI``unsigned int unit_max`` Maximum supported atomic write length in bytes h](j)}(h``unsigned int unit_max``h]j)}(hjlh]hunsigned int unit_max}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjjubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:92: ./fs/stat.chKhjfubj)}(hhh]h)}(h.Maximum supported atomic write length in bytesh]h.Maximum supported atomic write length in bytes}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjfubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubj)}(hW``unsigned int unit_max_opt`` Optimised maximum supported atomic write length in bytes h](j)}(h``unsigned int unit_max_opt``h]j)}(hjh]hunsigned int unit_max_opt}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:92: ./fs/stat.chKhjubj)}(hhh]h)}(h8Optimised maximum supported atomic write length in bytesh]h8Optimised maximum supported atomic write length in bytes}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:92: ./fs/stat.chKhjubh)}(hrFill in the STATX{_ATTR}_WRITE_ATOMIC flags in the kstat structure from atomic write unit_min and unit_max values.h]hrFill in the STATX{_ATTR}_WRITE_ATOMIC flags in the kstat structure from atomic write unit_min and unit_max values.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:92: ./fs/stat.chKhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j vfs_getattr_nosec (C function)c.vfs_getattr_nosechNtauh1hhjOghhhNhNubj)}(hhh](j)}(hoint vfs_getattr_nosec (const struct path *path, struct kstat *stat, u32 request_mask, unsigned int query_flags)h]j)}(hnint vfs_getattr_nosec(const struct path *path, struct kstat *stat, u32 request_mask, unsigned int query_flags)h](j)}(hinth]hint}(hj%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!hhhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:92: ./fs/stat.chKubj2)}(h h]h }(hj4hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj!hhhj3hKubjC)}(hvfs_getattr_nosech]jI)}(hvfs_getattr_nosech]hvfs_getattr_nosec}(hjFhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjBubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj!hhhj3hKubj=)}(hY(const struct path *path, struct kstat *stat, u32 request_mask, unsigned int query_flags)h](jC)}(hconst struct path *pathh](j )}(hjJh]hconst}(hjbhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj^ubj2)}(h h]h }(hjohhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj^ubj )}(hjh]hstruct}(hj}hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj^ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj^ubh)}(hhh]jI)}(hpathh]hpath}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jjHsbc.vfs_getattr_nosecasbuh1hhj^ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj^ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^ubjI)}(hpathh]hpath}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj^ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjZubjC)}(hstruct kstat *stath](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hkstath]hkstat}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.vfs_getattr_nosecasbuh1hhjubj2)}(h h]h }(hj+hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hstath]hstat}(hjFhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjZubjC)}(hu32 request_maskh](h)}(hhh]jI)}(hu32h]hu32}(hjbhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj_ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjdmodnameN classnameNjj )}j ]jc.vfs_getattr_nosecasbuh1hhj[ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj[ubjI)}(h request_maskh]h request_mask}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj[ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjZubjC)}(hunsigned int query_flagsh](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(h query_flagsh]h query_flags}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjZubeh}(h]h ]h"]h$]h&]j`jauh1j<hj!hhhj3hKubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhj3hKubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj3hKhjhhubjw)}(hhh]h)}(hgetattr without security checksh]hgetattr without security checks}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:92: ./fs/stat.chKhjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhj3hKubeh}(h]h ](jfunctioneh"]h$]h&]jjjj!jj!jjjuh1jhhhjOghNhNubj)}(hX(**Parameters** ``const struct path *path`` file to get attributes from ``struct kstat *stat`` structure to return attributes in ``u32 request_mask`` STATX_xxx flags indicating what the caller wants ``unsigned int query_flags`` Query mode (AT_STATX_SYNC_TYPE) **Description** Get attributes without calling security_inode_getattr. Currently the only caller other than vfs_getattr is internal to the filehandle lookup code, which uses only the inode number and returns no attributes to any user. Any other code probably wants vfs_getattr.h](h)}(h**Parameters**h]j)}(hj+h]h Parameters}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj)ubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:92: ./fs/stat.chKhj%ubj)}(hhh](j)}(h8``const struct path *path`` file to get attributes from h](j)}(h``const struct path *path``h]j)}(hjJh]hconst struct path *path}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjHubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:92: ./fs/stat.chKhjDubj)}(hhh]h)}(hfile to get attributes fromh]hfile to get attributes from}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1hhj_hKhj`ubah}(h]h ]h"]h$]h&]uh1jhjDubeh}(h]h ]h"]h$]h&]uh1jhj_hKhjAubj)}(h9``struct kstat *stat`` structure to return attributes in h](j)}(h``struct kstat *stat``h]j)}(hjh]hstruct kstat *stat}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:92: ./fs/stat.chKhj}ubj)}(hhh]h)}(h!structure to return attributes inh]h!structure to return attributes in}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhj}ubeh}(h]h ]h"]h$]h&]uh1jhjhKhjAubj)}(hF``u32 request_mask`` STATX_xxx flags indicating what the caller wants h](j)}(h``u32 request_mask``h]j)}(hjh]hu32 request_mask}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:92: ./fs/stat.chKhjubj)}(hhh]h)}(h0STATX_xxx flags indicating what the caller wantsh]h0STATX_xxx flags indicating what the caller wants}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjAubj)}(h=``unsigned int query_flags`` Query mode (AT_STATX_SYNC_TYPE) h](j)}(h``unsigned int query_flags``h]j)}(hjh]hunsigned int query_flags}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:92: ./fs/stat.chKhjubj)}(hhh]h)}(hQuery mode (AT_STATX_SYNC_TYPE)h]hQuery mode (AT_STATX_SYNC_TYPE)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hKhj ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj hKhjAubeh}(h]h ]h"]h$]h&]uh1jhj%ubh)}(h**Description**h]j)}(hj0h]h Description}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj.ubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:92: ./fs/stat.chKhj%ubh)}(h6Get attributes without calling security_inode_getattr.h]h6Get attributes without calling security_inode_getattr.}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:92: ./fs/stat.chKhj%ubh)}(hCurrently the only caller other than vfs_getattr is internal to the filehandle lookup code, which uses only the inode number and returns no attributes to any user. Any other code probably wants vfs_getattr.h]hCurrently the only caller other than vfs_getattr is internal to the filehandle lookup code, which uses only the inode number and returns no attributes to any user. Any other code probably wants vfs_getattr.}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:92: ./fs/stat.chKhj%ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j vfs_fsync_range (C function)c.vfs_fsync_rangehNtauh1hhjOghhhNhNubj)}(hhh](j)}(hOint vfs_fsync_range (struct file *file, loff_t start, loff_t end, int datasync)h]j)}(hNint vfs_fsync_range(struct file *file, loff_t start, loff_t end, int datasync)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:95: ./fs/sync.chKubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhKubjC)}(hvfs_fsync_rangeh]jI)}(hvfs_fsync_rangeh]hvfs_fsync_range}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhKubj=)}(h;(struct file *file, loff_t start, loff_t end, int datasync)h](jC)}(hstruct file *fileh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hfileh]hfile}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jjsbc.vfs_fsync_rangeasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hfileh]hfile}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h loff_t starth](h)}(hhh]jI)}(hloff_th]hloff_t}(hj6hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj3ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj8modnameN classnameNjj )}j ]jc.vfs_fsync_rangeasbuh1hhj/ubj2)}(h h]h }(hjThhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj/ubjI)}(hstarth]hstart}(hjbhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj/ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h loff_t endh](h)}(hhh]jI)}(hloff_th]hloff_t}(hj~hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj{ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.vfs_fsync_rangeasbuh1hhjwubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjwubjI)}(hendh]hend}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjwubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h int datasynch](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hdatasynch]hdatasync}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhKubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj|hhhjhKubah}(h]jwah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhKhjyhhubjw)}(hhh]h)}(h1helper to sync a range of data & metadata to diskh]h1helper to sync a range of data & metadata to disk}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:95: ./fs/sync.chKhjhhubah}(h]h ]h"]h$]h&]uh1jvhjyhhhjhKubeh}(h]h ](jfunctioneh"]h$]h&]jjjj!jj!jjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``struct file *file`` file to sync ``loff_t start`` offset in bytes of the beginning of data range to sync ``loff_t end`` offset in bytes of the end of data range (inclusive) ``int datasync`` perform only datasync **Description** Write back data in range **start**..**end** and metadata for **file** to disk. If **datasync** is set only metadata needed to access modified file data is written.h](h)}(h**Parameters**h]j)}(hj+h]h Parameters}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj)ubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:95: ./fs/sync.chKhj%ubj)}(hhh](j)}(h#``struct file *file`` file to sync h](j)}(h``struct file *file``h]j)}(hjJh]hstruct file *file}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjHubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:95: ./fs/sync.chKhjDubj)}(hhh]h)}(h file to synch]h file to sync}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1hhj_hKhj`ubah}(h]h ]h"]h$]h&]uh1jhjDubeh}(h]h ]h"]h$]h&]uh1jhj_hKhjAubj)}(hH``loff_t start`` offset in bytes of the beginning of data range to sync h](j)}(h``loff_t start``h]j)}(hjh]h loff_t start}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:95: ./fs/sync.chKhj}ubj)}(hhh]h)}(h6offset in bytes of the beginning of data range to synch]h6offset in bytes of the beginning of data range to sync}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhj}ubeh}(h]h ]h"]h$]h&]uh1jhjhKhjAubj)}(hD``loff_t end`` offset in bytes of the end of data range (inclusive) h](j)}(h``loff_t end``h]j)}(hjh]h loff_t end}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:95: ./fs/sync.chKhjubj)}(hhh]h)}(h4offset in bytes of the end of data range (inclusive)h]h4offset in bytes of the end of data range (inclusive)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjAubj)}(h'``int datasync`` perform only datasync h](j)}(h``int datasync``h]j)}(hjh]h int datasync}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:95: ./fs/sync.chKhjubj)}(hhh]h)}(hperform only datasynch]hperform only datasync}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hKhj ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj hKhjAubeh}(h]h ]h"]h$]h&]uh1jhj%ubh)}(h**Description**h]j)}(hj0 h]h Description}(hj2 hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj. ubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:95: ./fs/sync.chKhj%ubh)}(hWrite back data in range **start**..**end** and metadata for **file** to disk. If **datasync** is set only metadata needed to access modified file data is written.h](hWrite back data in range }(hjF hhhNhNubj)}(h **start**h]hstart}(hjN hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjF ubh..**end** and metadata for }(hjF hhhNhNubj)}(h**file**h]hfile}(hj` hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjF ubh to disk. If }(hjF hhhNhNubj)}(h **datasync**h]hdatasync}(hjr hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjF ubhE is set only metadata needed to access modified file data is written.}(hjF hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:95: ./fs/sync.chKhj%ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j vfs_fsync (C function) c.vfs_fsynchNtauh1hhjOghhhNhNubj)}(hhh](j)}(h/int vfs_fsync (struct file *file, int datasync)h]j)}(h.int vfs_fsync(struct file *file, int datasync)h](j)}(hinth]hint}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:95: ./fs/sync.chKubj2)}(h h]h }(hj hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj hhhj hKubjC)}(h vfs_fsynch]jI)}(h vfs_fsynch]h vfs_fsync}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj hhhj hKubj=)}(h!(struct file *file, int datasync)h](jC)}(hstruct file *fileh](j )}(hjh]hstruct}(hj hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj ubj2)}(h h]h }(hj hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj ubh)}(hhh]jI)}(hfileh]hfile}(hj!hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj!ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj!modnameN classnameNjj )}j ]j)}jj sb c.vfs_fsyncasbuh1hhj ubj2)}(h h]h }(hj&!hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj ubj)}(hjh]h*}(hj4!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubjI)}(hfileh]hfile}(hjA!hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj ubjC)}(h int datasynch](j)}(hinth]hint}(hjZ!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjV!ubj2)}(h h]h }(hjh!hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjV!ubjI)}(hdatasynch]hdatasync}(hjv!hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjV!ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj ubeh}(h]h ]h"]h$]h&]j`jauh1j<hj hhhj hKubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj hhhj hKubah}(h]j ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj hKhj hhubjw)}(hhh]h)}(h&perform a fsync or fdatasync on a fileh]h&perform a fsync or fdatasync on a file}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:95: ./fs/sync.chKhj!hhubah}(h]h ]h"]h$]h&]uh1jvhj hhhj hKubeh}(h]h ](jfunctioneh"]h$]h&]jjjj!jj!jjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``struct file *file`` file to sync ``int datasync`` only perform a fdatasync operation **Description** Write back data and metadata for **file** to disk. If **datasync** is set only metadata needed to access modified file data is written.h](h)}(h**Parameters**h]j)}(hj!h]h Parameters}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj!ubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:95: ./fs/sync.chKhj!ubj)}(hhh](j)}(h#``struct file *file`` file to sync h](j)}(h``struct file *file``h]j)}(hj!h]hstruct file *file}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj!ubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:95: ./fs/sync.chKhj!ubj)}(hhh]h)}(h file to synch]h file to sync}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj!hKhj!ubah}(h]h ]h"]h$]h&]uh1jhj!ubeh}(h]h ]h"]h$]h&]uh1jhj!hKhj!ubj)}(h4``int datasync`` only perform a fdatasync operation h](j)}(h``int datasync``h]j)}(hj"h]h int datasync}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj"ubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:95: ./fs/sync.chKhj"ubj)}(hhh]h)}(h"only perform a fdatasync operationh]h"only perform a fdatasync operation}(hj3"hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/"hKhj0"ubah}(h]h ]h"]h$]h&]uh1jhj"ubeh}(h]h ]h"]h$]h&]uh1jhj/"hKhj!ubeh}(h]h ]h"]h$]h&]uh1jhj!ubh)}(h**Description**h]j)}(hjU"h]h Description}(hjW"hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjS"ubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:95: ./fs/sync.chKhj!ubh)}(hWrite back data and metadata for **file** to disk. If **datasync** is set only metadata needed to access modified file data is written.h](h!Write back data and metadata for }(hjk"hhhNhNubj)}(h**file**h]hfile}(hjs"hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjk"ubh to disk. If }(hjk"hhhNhNubj)}(h **datasync**h]hdatasync}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjk"ubhE is set only metadata needed to access modified file data is written.}(hjk"hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:95: ./fs/sync.chKhj!ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j "__vfs_setxattr_locked (C function)c.__vfs_setxattr_lockedhNtauh1hhjOghhhNhNubj)}(hhh](j)}(hint __vfs_setxattr_locked (const struct mnt_idmap *idmap, struct dentry *dentry, const char *name, const void *value, size_t size, int flags, struct delegated_inode *delegated_inode)h]j)}(hint __vfs_setxattr_locked(const struct mnt_idmap *idmap, struct dentry *dentry, const char *name, const void *value, size_t size, int flags, struct delegated_inode *delegated_inode)h](j)}(hinth]hint}(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"hhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:98: ./fs/xattr.chMubj2)}(h h]h }(hj"hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj"hhhj"hMubjC)}(h__vfs_setxattr_lockedh]jI)}(h__vfs_setxattr_lockedh]h__vfs_setxattr_locked}(hj"hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj"ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj"hhhj"hMubj=)}(h(const struct mnt_idmap *idmap, struct dentry *dentry, const char *name, const void *value, size_t size, int flags, struct delegated_inode *delegated_inode)h](jC)}(hconst struct mnt_idmap *idmaph](j )}(hjJh]hconst}(hj"hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj"ubj2)}(h h]h }(hj#hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj"ubj )}(hjh]hstruct}(hj#hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj"ubj2)}(h h]h }(hj##hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj"ubh)}(hhh]jI)}(h mnt_idmaph]h mnt_idmap}(hj4#hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj1#ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj6#modnameN classnameNjj )}j ]j)}jj"sbc.__vfs_setxattr_lockedasbuh1hhj"ubj2)}(h h]h }(hjT#hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj"ubj)}(hjh]h*}(hjb#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"ubjI)}(hidmaph]hidmap}(hjo#hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj"ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj"ubjC)}(hstruct dentry *dentryh](j )}(hjh]hstruct}(hj#hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj#ubj2)}(h h]h }(hj#hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj#ubh)}(hhh]jI)}(hdentryh]hdentry}(hj#hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj#ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj#modnameN classnameNjj )}j ]jP#c.__vfs_setxattr_lockedasbuh1hhj#ubj2)}(h h]h }(hj#hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj#ubj)}(hjh]h*}(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#ubjI)}(hdentryh]hdentry}(hj#hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj#ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj"ubjC)}(hconst char *nameh](j )}(hjJh]hconst}(hj#hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj#ubj2)}(h h]h }(hj$hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj#ubj)}(hcharh]hchar}(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#ubj2)}(h h]h }(hj!$hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj#ubj)}(hjh]h*}(hj/$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#ubjI)}(hnameh]hname}(hj<$hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj#ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj"ubjC)}(hconst void *valueh](j )}(hjJh]hconst}(hjU$hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjQ$ubj2)}(h h]h }(hjb$hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjQ$ubj)}(hvoidh]hvoid}(hjp$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjQ$ubj2)}(h h]h }(hj~$hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjQ$ubj)}(hjh]h*}(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjQ$ubjI)}(hvalueh]hvalue}(hj$hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjQ$ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj"ubjC)}(h size_t sizeh](h)}(hhh]jI)}(hsize_th]hsize_t}(hj$hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj$ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj$modnameN classnameNjj )}j ]jP#c.__vfs_setxattr_lockedasbuh1hhj$ubj2)}(h h]h }(hj$hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj$ubjI)}(hsizeh]hsize}(hj$hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj$ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj"ubjC)}(h int flagsh](j)}(hinth]hint}(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$ubj2)}(h h]h }(hj%hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj$ubjI)}(hflagsh]hflags}(hj%hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj$ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj"ubjC)}(h'struct delegated_inode *delegated_inodeh](j )}(hjh]hstruct}(hj/%hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj+%ubj2)}(h h]h }(hj<%hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj+%ubh)}(hhh]jI)}(hdelegated_inodeh]hdelegated_inode}(hjM%hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjJ%ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjO%modnameN classnameNjj )}j ]jP#c.__vfs_setxattr_lockedasbuh1hhj+%ubj2)}(h h]h }(hjk%hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj+%ubj)}(hjh]h*}(hjy%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+%ubjI)}(hdelegated_inodeh]hdelegated_inode}(hj%hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj+%ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj"ubeh}(h]h ]h"]h$]h&]j`jauh1j<hj"hhhj"hMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj"hhhj"hMubah}(h]j"ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj"hMhj"hhubjw)}(hhh]h)}(h6set an extended attribute while holding the inode lockh]h6set an extended attribute while holding the inode lock}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:98: ./fs/xattr.chMhj%hhubah}(h]h ]h"]h$]h&]uh1jvhj"hhhj"hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjj%jj%jjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``const struct mnt_idmap *idmap`` idmap of the mount of the target inode ``struct dentry *dentry`` object to perform setxattr on ``const char *name`` xattr name to set ``const void *value`` value to set **name** to ``size_t size`` size of **value** ``int flags`` flags to pass into filesystem operations ``struct delegated_inode *delegated_inode`` on return, will contain an inode pointer that a delegation was broken on, NULL if none.h](h)}(h**Parameters**h]j)}(hj%h]h Parameters}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj%ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:98: ./fs/xattr.chM!hj%ubj)}(hhh](j)}(hI``const struct mnt_idmap *idmap`` idmap of the mount of the target inode h](j)}(h!``const struct mnt_idmap *idmap``h]j)}(hj%h]hconst struct mnt_idmap *idmap}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj%ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:98: ./fs/xattr.chM hj%ubj)}(hhh]h)}(h&idmap of the mount of the target inodeh]h&idmap of the mount of the target inode}(hj &hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj&hM hj&ubah}(h]h ]h"]h$]h&]uh1jhj%ubeh}(h]h ]h"]h$]h&]uh1jhj&hM hj%ubj)}(h8``struct dentry *dentry`` object to perform setxattr on h](j)}(h``struct dentry *dentry``h]j)}(hj*&h]hstruct dentry *dentry}(hj,&hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj(&ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:98: ./fs/xattr.chM!hj$&ubj)}(hhh]h)}(hobject to perform setxattr onh]hobject to perform setxattr on}(hjC&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj?&hM!hj@&ubah}(h]h ]h"]h$]h&]uh1jhj$&ubeh}(h]h ]h"]h$]h&]uh1jhj?&hM!hj%ubj)}(h'``const char *name`` xattr name to set h](j)}(h``const char *name``h]j)}(hjc&h]hconst char *name}(hje&hhhNhNubah}(h]h ]h"]h$]h&]uh1jhja&ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:98: ./fs/xattr.chM"hj]&ubj)}(hhh]h)}(hxattr name to seth]hxattr name to set}(hj|&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjx&hM"hjy&ubah}(h]h ]h"]h$]h&]uh1jhj]&ubeh}(h]h ]h"]h$]h&]uh1jhjx&hM"hj%ubj)}(h/``const void *value`` value to set **name** to h](j)}(h``const void *value``h]j)}(hj&h]hconst void *value}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj&ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:98: ./fs/xattr.chM#hj&ubj)}(hhh]h)}(hvalue to set **name** toh](h value to set }(hj&hhhNhNubj)}(h**name**h]hname}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj&ubh to}(hj&hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj&hM#hj&ubah}(h]h ]h"]h$]h&]uh1jhj&ubeh}(h]h ]h"]h$]h&]uh1jhj&hM#hj%ubj)}(h"``size_t size`` size of **value** h](j)}(h``size_t size``h]j)}(hj&h]h size_t size}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj&ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:98: ./fs/xattr.chM$hj&ubj)}(hhh]h)}(hsize of **value**h](hsize of }(hj'hhhNhNubj)}(h **value**h]hvalue}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj'ubeh}(h]h ]h"]h$]h&]uh1hhj&hM$hj&ubah}(h]h ]h"]h$]h&]uh1jhj&ubeh}(h]h ]h"]h$]h&]uh1jhj&hM$hj%ubj)}(h7``int flags`` flags to pass into filesystem operations h](j)}(h ``int flags``h]j)}(hj.'h]h int flags}(hj0'hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj,'ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:98: ./fs/xattr.chM%hj('ubj)}(hhh]h)}(h(flags to pass into filesystem operationsh]h(flags to pass into filesystem operations}(hjG'hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjC'hM%hjD'ubah}(h]h ]h"]h$]h&]uh1jhj('ubeh}(h]h ]h"]h$]h&]uh1jhjC'hM%hj%ubj)}(h``struct delegated_inode *delegated_inode`` on return, will contain an inode pointer that a delegation was broken on, NULL if none.h](j)}(h+``struct delegated_inode *delegated_inode``h]j)}(hjg'h]h'struct delegated_inode *delegated_inode}(hji'hhhNhNubah}(h]h ]h"]h$]h&]uh1jhje'ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:98: ./fs/xattr.chM&hja'ubj)}(hhh]h)}(hWon return, will contain an inode pointer that a delegation was broken on, NULL if none.h]hWon return, will contain an inode pointer that a delegation was broken on, NULL if none.}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj|'hM&hj}'ubah}(h]h ]h"]h$]h&]uh1jhja'ubeh}(h]h ]h"]h$]h&]uh1jhj|'hM&hj%ubeh}(h]h ]h"]h$]h&]uh1jhj%ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j vfs_listxattr (C function)c.vfs_listxattrhNtauh1hhjOghhhNhNubj)}(hhh](j)}(hFssize_t vfs_listxattr (struct dentry *dentry, char *list, size_t size)h]j)}(hEssize_t vfs_listxattr(struct dentry *dentry, char *list, size_t size)h](h)}(hhh]jI)}(hssize_th]hssize_t}(hj'hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj'ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj'modnameN classnameNjj )}j ]j)}j vfs_listxattrsbc.vfs_listxattrasbuh1hhj'hhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:98: ./fs/xattr.chMubj2)}(h h]h }(hj'hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj'hhhj'hMubjC)}(h vfs_listxattrh]jI)}(hj'h]h vfs_listxattr}(hj'hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj'ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj'hhhj'hMubj=)}(h0(struct dentry *dentry, char *list, size_t size)h](jC)}(hstruct dentry *dentryh](j )}(hjh]hstruct}(hj(hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj(ubj2)}(h h]h }(hj(hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj(ubh)}(hhh]jI)}(hdentryh]hdentry}(hj0(hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj-(ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj2(modnameN classnameNjj )}j ]j'c.vfs_listxattrasbuh1hhj(ubj2)}(h h]h }(hjN(hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj(ubj)}(hjh]h*}(hj\(hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(ubjI)}(hdentryh]hdentry}(hji(hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj(ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj (ubjC)}(h char *listh](j)}(hcharh]hchar}(hj(hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~(ubj2)}(h h]h }(hj(hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj~(ubj)}(hjh]h*}(hj(hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~(ubjI)}(hlisth]hlist}(hj(hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj~(ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj (ubjC)}(h size_t sizeh](h)}(hhh]jI)}(hsize_th]hsize_t}(hj(hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj(ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj(modnameN classnameNjj )}j ]j'c.vfs_listxattrasbuh1hhj(ubj2)}(h h]h }(hj(hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj(ubjI)}(hsizeh]hsize}(hj(hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj(ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj (ubeh}(h]h ]h"]h$]h&]j`jauh1j<hj'hhhj'hMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj'hhhj'hMubah}(h]j'ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj'hMhj'hhubjw)}(hhh]h)}(h)retrieve \0 separated list of xattr namesh]h)retrieve 0 separated list of xattr names}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:98: ./fs/xattr.chMhj)hhubah}(h]h ]h"]h$]h&]uh1jvhj'hhhj'hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjj5)jj5)jjjuh1jhhhjOghNhNubj)}(hX0**Parameters** ``struct dentry *dentry`` the dentry from whose inode the xattr names are retrieved ``char *list`` buffer to store xattr names into ``size_t size`` size of the buffer **Description** This function returns the names of all xattrs associated with the inode of **dentry**. Note, for legacy reasons the vfs_listxattr() function lists POSIX ACLs as well. Since POSIX ACLs are decoupled from IOP_XATTR the vfs_listxattr() function doesn't check for this flag since a filesystem could implement POSIX ACLs without implementing any other xattrs. However, since all codepaths that remove IOP_XATTR also assign of inode operations that either don't implement or implement a stub ->listxattr() operation. **Return** On success, the size of the buffer that was used. On error a negative error code.h](h)}(h**Parameters**h]j)}(hj?)h]h Parameters}(hjA)hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj=)ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:98: ./fs/xattr.chMhj9)ubj)}(hhh](j)}(hT``struct dentry *dentry`` the dentry from whose inode the xattr names are retrieved h](j)}(h``struct dentry *dentry``h]j)}(hj^)h]hstruct dentry *dentry}(hj`)hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj\)ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:98: ./fs/xattr.chMhjX)ubj)}(hhh]h)}(h9the dentry from whose inode the xattr names are retrievedh]h9the dentry from whose inode the xattr names are retrieved}(hjw)hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjs)hMhjt)ubah}(h]h ]h"]h$]h&]uh1jhjX)ubeh}(h]h ]h"]h$]h&]uh1jhjs)hMhjU)ubj)}(h0``char *list`` buffer to store xattr names into h](j)}(h``char *list``h]j)}(hj)h]h char *list}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj)ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:98: ./fs/xattr.chMhj)ubj)}(hhh]h)}(h buffer to store xattr names intoh]h buffer to store xattr names into}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj)hMhj)ubah}(h]h ]h"]h$]h&]uh1jhj)ubeh}(h]h ]h"]h$]h&]uh1jhj)hMhjU)ubj)}(h#``size_t size`` size of the buffer h](j)}(h``size_t size``h]j)}(hj)h]h size_t size}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj)ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:98: ./fs/xattr.chMhj)ubj)}(hhh]h)}(hsize of the bufferh]hsize of the buffer}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj)hMhj)ubah}(h]h ]h"]h$]h&]uh1jhj)ubeh}(h]h ]h"]h$]h&]uh1jhj)hMhjU)ubeh}(h]h ]h"]h$]h&]uh1jhj9)ubh)}(h**Description**h]j)}(hj *h]h Description}(hj *hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj *ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:98: ./fs/xattr.chMhj9)ubh)}(hVThis function returns the names of all xattrs associated with the inode of **dentry**.h](hKThis function returns the names of all xattrs associated with the inode of }(hj!*hhhNhNubj)}(h **dentry**h]hdentry}(hj)*hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj!*ubh.}(hj!*hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:98: ./fs/xattr.chMhj9)ubh)}(hX Note, for legacy reasons the vfs_listxattr() function lists POSIX ACLs as well. Since POSIX ACLs are decoupled from IOP_XATTR the vfs_listxattr() function doesn't check for this flag since a filesystem could implement POSIX ACLs without implementing any other xattrs.h]hX Note, for legacy reasons the vfs_listxattr() function lists POSIX ACLs as well. Since POSIX ACLs are decoupled from IOP_XATTR the vfs_listxattr() function doesn’t check for this flag since a filesystem could implement POSIX ACLs without implementing any other xattrs.}(hjB*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:98: ./fs/xattr.chMhj9)ubh)}(hHowever, since all codepaths that remove IOP_XATTR also assign of inode operations that either don't implement or implement a stub ->listxattr() operation.h]hHowever, since all codepaths that remove IOP_XATTR also assign of inode operations that either don’t implement or implement a stub ->listxattr() operation.}(hjQ*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:98: ./fs/xattr.chMhj9)ubh)}(h **Return**h]j)}(hjb*h]hReturn}(hjd*hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj`*ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:98: ./fs/xattr.chMhj9)ubh)}(hQOn success, the size of the buffer that was used. On error a negative error code.h]hQOn success, the size of the buffer that was used. On error a negative error code.}(hjx*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:98: ./fs/xattr.chMhj9)ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j %__vfs_removexattr_locked (C function)c.__vfs_removexattr_lockedhNtauh1hhjOghhhNhNubj)}(hhh](j)}(hint __vfs_removexattr_locked (const struct mnt_idmap *idmap, struct dentry *dentry, const char *name, struct delegated_inode *delegated_inode)h]j)}(hint __vfs_removexattr_locked(const struct mnt_idmap *idmap, struct dentry *dentry, const char *name, struct delegated_inode *delegated_inode)h](j)}(hinth]hint}(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*hhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:98: ./fs/xattr.chM&ubj2)}(h h]h }(hj*hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj*hhhj*hM&ubjC)}(h__vfs_removexattr_lockedh]jI)}(h__vfs_removexattr_lockedh]h__vfs_removexattr_locked}(hj*hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj*ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj*hhhj*hM&ubj=)}(hq(const struct mnt_idmap *idmap, struct dentry *dentry, const char *name, struct delegated_inode *delegated_inode)h](jC)}(hconst struct mnt_idmap *idmaph](j )}(hjJh]hconst}(hj*hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj*ubj2)}(h h]h }(hj*hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj*ubj )}(hjh]hstruct}(hj*hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj*ubj2)}(h h]h }(hj +hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj*ubh)}(hhh]jI)}(h mnt_idmaph]h mnt_idmap}(hj+hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj+ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj+modnameN classnameNjj )}j ]j)}jj*sbc.__vfs_removexattr_lockedasbuh1hhj*ubj2)}(h h]h }(hj=+hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj*ubj)}(hjh]h*}(hjK+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*ubjI)}(hidmaph]hidmap}(hjX+hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj*ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj*ubjC)}(hstruct dentry *dentryh](j )}(hjh]hstruct}(hjq+hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjm+ubj2)}(h h]h }(hj~+hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjm+ubh)}(hhh]jI)}(hdentryh]hdentry}(hj+hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj+ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj+modnameN classnameNjj )}j ]j9+c.__vfs_removexattr_lockedasbuh1hhjm+ubj2)}(h h]h }(hj+hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjm+ubj)}(hjh]h*}(hj+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjm+ubjI)}(hdentryh]hdentry}(hj+hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjm+ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj*ubjC)}(hconst char *nameh](j )}(hjJh]hconst}(hj+hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj+ubj2)}(h h]h }(hj+hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj+ubj)}(hcharh]hchar}(hj+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubj2)}(h h]h }(hj ,hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj+ubj)}(hjh]h*}(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubjI)}(hnameh]hname}(hj%,hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj+ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj*ubjC)}(h'struct delegated_inode *delegated_inodeh](j )}(hjh]hstruct}(hj>,hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj:,ubj2)}(h h]h }(hjK,hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj:,ubh)}(hhh]jI)}(hdelegated_inodeh]hdelegated_inode}(hj\,hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjY,ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj^,modnameN classnameNjj )}j ]j9+c.__vfs_removexattr_lockedasbuh1hhj:,ubj2)}(h h]h }(hjz,hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj:,ubj)}(hjh]h*}(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:,ubjI)}(hdelegated_inodeh]hdelegated_inode}(hj,hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj:,ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj*ubeh}(h]h ]h"]h$]h&]j`jauh1j<hj*hhhj*hM&ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj*hhhj*hM&ubah}(h]j*ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj*hM&hj*hhubjw)}(hhh]h)}(h6set an extended attribute while holding the inode lockh]h6set an extended attribute while holding the inode lock}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:98: ./fs/xattr.chM&hj,hhubah}(h]h ]h"]h$]h&]uh1jvhj*hhhj*hM&ubeh}(h]h ](jfunctioneh"]h$]h&]jjjj,jj,jjjuh1jhhhjOghNhNubj)}(hXN**Parameters** ``const struct mnt_idmap *idmap`` idmap of the mount of the target inode ``struct dentry *dentry`` object to perform setxattr on ``const char *name`` name of xattr to remove ``struct delegated_inode *delegated_inode`` on return, will contain an inode pointer that a delegation was broken on, NULL if none.h](h)}(h**Parameters**h]j)}(hj,h]h Parameters}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj,ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:98: ./fs/xattr.chM*hj,ubj)}(hhh](j)}(hI``const struct mnt_idmap *idmap`` idmap of the mount of the target inode h](j)}(h!``const struct mnt_idmap *idmap``h]j)}(hj-h]hconst struct mnt_idmap *idmap}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj,ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:98: ./fs/xattr.chM)hj,ubj)}(hhh]h)}(h&idmap of the mount of the target inodeh]h&idmap of the mount of the target inode}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj-hM)hj-ubah}(h]h ]h"]h$]h&]uh1jhj,ubeh}(h]h ]h"]h$]h&]uh1jhj-hM)hj,ubj)}(h8``struct dentry *dentry`` object to perform setxattr on h](j)}(h``struct dentry *dentry``h]j)}(hj9-h]hstruct dentry *dentry}(hj;-hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj7-ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:98: ./fs/xattr.chM*hj3-ubj)}(hhh]h)}(hobject to perform setxattr onh]hobject to perform setxattr on}(hjR-hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjN-hM*hjO-ubah}(h]h ]h"]h$]h&]uh1jhj3-ubeh}(h]h ]h"]h$]h&]uh1jhjN-hM*hj,ubj)}(h-``const char *name`` name of xattr to remove h](j)}(h``const char *name``h]j)}(hjr-h]hconst char *name}(hjt-hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjp-ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:98: ./fs/xattr.chM+hjl-ubj)}(hhh]h)}(hname of xattr to removeh]hname of xattr to remove}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj-hM+hj-ubah}(h]h ]h"]h$]h&]uh1jhjl-ubeh}(h]h ]h"]h$]h&]uh1jhj-hM+hj,ubj)}(h``struct delegated_inode *delegated_inode`` on return, will contain an inode pointer that a delegation was broken on, NULL if none.h](j)}(h+``struct delegated_inode *delegated_inode``h]j)}(hj-h]h'struct delegated_inode *delegated_inode}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj-ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:98: ./fs/xattr.chM,hj-ubj)}(hhh]h)}(hWon return, will contain an inode pointer that a delegation was broken on, NULL if none.h]hWon return, will contain an inode pointer that a delegation was broken on, NULL if none.}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj-hM,hj-ubah}(h]h ]h"]h$]h&]uh1jhj-ubeh}(h]h ]h"]h$]h&]uh1jhj-hM,hj,ubeh}(h]h ]h"]h$]h&]uh1jhj,ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j generic_listxattr (C function)c.generic_listxattrhNtauh1hhjOghhhNhNubj)}(hhh](j)}(hSssize_t generic_listxattr (struct dentry *dentry, char *buffer, size_t buffer_size)h]j)}(hRssize_t generic_listxattr(struct dentry *dentry, char *buffer, size_t buffer_size)h](h)}(hhh]jI)}(hssize_th]hssize_t}(hj.hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj.ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj .modnameN classnameNjj )}j ]j)}jgeneric_listxattrsbc.generic_listxattrasbuh1hhj.hhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:98: ./fs/xattr.chMsubj2)}(h h]h }(hj).hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj.hhhj(.hMsubjC)}(hgeneric_listxattrh]jI)}(hj%.h]hgeneric_listxattr}(hj;.hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj7.ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj.hhhj(.hMsubj=)}(h9(struct dentry *dentry, char *buffer, size_t buffer_size)h](jC)}(hstruct dentry *dentryh](j )}(hjh]hstruct}(hjV.hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjR.ubj2)}(h h]h }(hjc.hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjR.ubh)}(hhh]jI)}(hdentryh]hdentry}(hjt.hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjq.ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjv.modnameN classnameNjj )}j ]j#.c.generic_listxattrasbuh1hhjR.ubj2)}(h h]h }(hj.hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjR.ubj)}(hjh]h*}(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjR.ubjI)}(hdentryh]hdentry}(hj.hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjR.ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjN.ubjC)}(h char *bufferh](j)}(hcharh]hchar}(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj.ubj2)}(h h]h }(hj.hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj.ubj)}(hjh]h*}(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj.ubjI)}(hbufferh]hbuffer}(hj.hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj.ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjN.ubjC)}(hsize_t buffer_sizeh](h)}(hhh]jI)}(hsize_th]hsize_t}(hj /hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj/ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj /modnameN classnameNjj )}j ]j#.c.generic_listxattrasbuh1hhj/ubj2)}(h h]h }(hj)/hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj/ubjI)}(h buffer_sizeh]h buffer_size}(hj7/hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj/ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjN.ubeh}(h]h ]h"]h$]h&]j`jauh1j<hj.hhhj(.hMsubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj-hhhj(.hMsubah}(h]j-ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj(.hMshj-hhubjw)}(hhh]h)}(h.run through a dentry's xattr list() operationsh]h0run through a dentry’s xattr list() operations}(hja/hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:98: ./fs/xattr.chMshj^/hhubah}(h]h ]h"]h$]h&]uh1jvhj-hhhj(.hMsubeh}(h]h ](jfunctioneh"]h$]h&]jjjjy/jjy/jjjuh1jhhhjOghNhNubj)}(hXD**Parameters** ``struct dentry *dentry`` dentry to list the xattrs ``char *buffer`` result buffer ``size_t buffer_size`` size of **buffer** **Description** Combine the results of the list() operation from every xattr_handler in the xattr_handler stack. Note that this will not include the entries for POSIX ACLs.h](h)}(h**Parameters**h]j)}(hj/h]h Parameters}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj/ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:98: ./fs/xattr.chMwhj}/ubj)}(hhh](j)}(h4``struct dentry *dentry`` dentry to list the xattrs h](j)}(h``struct dentry *dentry``h]j)}(hj/h]hstruct dentry *dentry}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj/ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:98: ./fs/xattr.chMthj/ubj)}(hhh]h)}(hdentry to list the xattrsh]hdentry to list the xattrs}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/hMthj/ubah}(h]h ]h"]h$]h&]uh1jhj/ubeh}(h]h ]h"]h$]h&]uh1jhj/hMthj/ubj)}(h``char *buffer`` result buffer h](j)}(h``char *buffer``h]j)}(hj/h]h char *buffer}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj/ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:98: ./fs/xattr.chMuhj/ubj)}(hhh]h)}(h result bufferh]h result buffer}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/hMuhj/ubah}(h]h ]h"]h$]h&]uh1jhj/ubeh}(h]h ]h"]h$]h&]uh1jhj/hMuhj/ubj)}(h*``size_t buffer_size`` size of **buffer** h](j)}(h``size_t buffer_size``h]j)}(hj0h]hsize_t buffer_size}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj0ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:98: ./fs/xattr.chMvhj0ubj)}(hhh]h)}(hsize of **buffer**h](hsize of }(hj-0hhhNhNubj)}(h **buffer**h]hbuffer}(hj50hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj-0ubeh}(h]h ]h"]h$]h&]uh1hhj)0hMvhj*0ubah}(h]h ]h"]h$]h&]uh1jhj0ubeh}(h]h ]h"]h$]h&]uh1jhj)0hMvhj/ubeh}(h]h ]h"]h$]h&]uh1jhj}/ubh)}(h**Description**h]j)}(hj]0h]h Description}(hj_0hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj[0ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:98: ./fs/xattr.chMxhj}/ubh)}(h`Combine the results of the list() operation from every xattr_handler in the xattr_handler stack.h]h`Combine the results of the list() operation from every xattr_handler in the xattr_handler stack.}(hjs0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:98: ./fs/xattr.chMwhj}/ubh)}(h;Note that this will not include the entries for POSIX ACLs.h]h;Note that this will not include the entries for POSIX ACLs.}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:98: ./fs/xattr.chMzhj}/ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j xattr_full_name (C function)c.xattr_full_namehNtauh1hhjOghhhNhNubj)}(hhh](j)}(hTconst char * xattr_full_name (const struct xattr_handler *handler, const char *name)h]j)}(hRconst char *xattr_full_name(const struct xattr_handler *handler, const char *name)h](j )}(hjJh]hconst}(hj0hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj0hhhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:98: ./fs/xattr.chMubj2)}(h h]h }(hj0hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj0hhhj0hMubj)}(hcharh]hchar}(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0hhhj0hMubj2)}(h h]h }(hj0hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj0hhhj0hMubj)}(hjh]h*}(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0hhhj0hMubjC)}(hxattr_full_nameh]jI)}(hxattr_full_nameh]hxattr_full_name}(hj0hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj0ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj0hhhj0hMubj=)}(h7(const struct xattr_handler *handler, const char *name)h](jC)}(h#const struct xattr_handler *handlerh](j )}(hjJh]hconst}(hj1hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj1ubj2)}(h h]h }(hj#1hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj1ubj )}(hjh]hstruct}(hj11hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj1ubj2)}(h h]h }(hj>1hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj1ubh)}(hhh]jI)}(h xattr_handlerh]h xattr_handler}(hjO1hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjL1ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjQ1modnameN classnameNjj )}j ]j)}jj0sbc.xattr_full_nameasbuh1hhj1ubj2)}(h h]h }(hjo1hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj1ubj)}(hjh]h*}(hj}1hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj1ubjI)}(hhandlerh]hhandler}(hj1hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj1ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj1ubjC)}(hconst char *nameh](j )}(hjJh]hconst}(hj1hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj1ubj2)}(h h]h }(hj1hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj1ubj)}(hcharh]hchar}(hj1hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj1ubj2)}(h h]h }(hj1hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj1ubj)}(hjh]h*}(hj1hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj1ubjI)}(hnameh]hname}(hj1hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj1ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj1ubeh}(h]h ]h"]h$]h&]j`jauh1j<hj0hhhj0hMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj0hhhj0hMubah}(h]j0ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj0hMhj0hhubjw)}(hhh]h)}(h'Compute full attribute name from suffixh]h'Compute full attribute name from suffix}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:98: ./fs/xattr.chMhj2hhubah}(h]h ]h"]h$]h&]uh1jvhj0hhhj0hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjj)2jj)2jjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``const struct xattr_handler *handler`` handler of the xattr_handler operation ``const char *name`` name passed to the xattr_handler operation **Description** The get and set xattr handler operations are called with the remainder of the attribute name after skipping the handler's prefix: for example, "foo" is passed to the get operation of a handler with prefix "user." to get attribute "user.foo". The full name is still "there" in the name though. **Note** the list xattr handler operation when called from the vfs is passed a NULL name; some file systems use this operation internally, with varying semantics.h](h)}(h**Parameters**h]j)}(hj32h]h Parameters}(hj52hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj12ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:98: ./fs/xattr.chMhj-2ubj)}(hhh](j)}(hO``const struct xattr_handler *handler`` handler of the xattr_handler operation h](j)}(h'``const struct xattr_handler *handler``h]j)}(hjR2h]h#const struct xattr_handler *handler}(hjT2hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjP2ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:98: ./fs/xattr.chMhjL2ubj)}(hhh]h)}(h&handler of the xattr_handler operationh]h&handler of the xattr_handler operation}(hjk2hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjg2hMhjh2ubah}(h]h ]h"]h$]h&]uh1jhjL2ubeh}(h]h ]h"]h$]h&]uh1jhjg2hMhjI2ubj)}(h@``const char *name`` name passed to the xattr_handler operation h](j)}(h``const char *name``h]j)}(hj2h]hconst char *name}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj2ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:98: ./fs/xattr.chMhj2ubj)}(hhh]h)}(h*name passed to the xattr_handler operationh]h*name passed to the xattr_handler operation}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj2hMhj2ubah}(h]h ]h"]h$]h&]uh1jhj2ubeh}(h]h ]h"]h$]h&]uh1jhj2hMhjI2ubeh}(h]h ]h"]h$]h&]uh1jhj-2ubh)}(h**Description**h]j)}(hj2h]h Description}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj2ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:98: ./fs/xattr.chMhj-2ubh)}(hX%The get and set xattr handler operations are called with the remainder of the attribute name after skipping the handler's prefix: for example, "foo" is passed to the get operation of a handler with prefix "user." to get attribute "user.foo". The full name is still "there" in the name though.h]hX7The get and set xattr handler operations are called with the remainder of the attribute name after skipping the handler’s prefix: for example, “foo” is passed to the get operation of a handler with prefix “user.” to get attribute “user.foo”. The full name is still “there” in the name though.}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:98: ./fs/xattr.chMhj-2ubh)}(h**Note**h]j)}(hj2h]hNote}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj2ubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:98: ./fs/xattr.chMhj-2ubh)}(hthe list xattr handler operation when called from the vfs is passed a NULL name; some file systems use this operation internally, with varying semantics.h]hthe list xattr handler operation when called from the vfs is passed a NULL name; some file systems use this operation internally, with varying semantics.}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1hhR/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:98: ./fs/xattr.chMhj-2ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j !mnt_get_write_access (C function)c.mnt_get_write_accesshNtauh1hhjOghhhNhNubj)}(hhh](j)}(h-int mnt_get_write_access (struct vfsmount *m)h]j)}(h,int mnt_get_write_access(struct vfsmount *m)h](j)}(hinth]hint}(hj23hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj.3hhhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chMubj2)}(h h]h }(hjA3hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj.3hhhj@3hMubjC)}(hmnt_get_write_accessh]jI)}(hmnt_get_write_accessh]hmnt_get_write_access}(hjS3hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjO3ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj.3hhhj@3hMubj=)}(h(struct vfsmount *m)h]jC)}(hstruct vfsmount *mh](j )}(hjh]hstruct}(hjo3hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjk3ubj2)}(h h]h }(hj|3hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjk3ubh)}(hhh]jI)}(hvfsmounth]hvfsmount}(hj3hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj3ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj3modnameN classnameNjj )}j ]j)}jjU3sbc.mnt_get_write_accessasbuh1hhjk3ubj2)}(h h]h }(hj3hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjk3ubj)}(hjh]h*}(hj3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjk3ubjI)}(hjNh]hm}(hj3hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjk3ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjg3ubah}(h]h ]h"]h$]h&]j`jauh1j<hj.3hhhj@3hMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj*3hhhj@3hMubah}(h]j%3ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj@3hMhj'3hhubjw)}(hhh]h)}(h5get write access to a mount without freeze protectionh]h5get write access to a mount without freeze protection}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chMhj3hhubah}(h]h ]h"]h$]h&]uh1jvhj'3hhhj@3hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjj 4jj 4jjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``struct vfsmount *m`` the mount on which to take a write **Description** This tells the low-level filesystem that a write is about to be performed to it, and makes sure that writes are allowed (mnt it read-write) before returning success. This operation does not protect against filesystem being frozen. When the write operation is finished, mnt_put_write_access() must be called. This is effectively a refcount.h](h)}(h**Parameters**h]j)}(hj4h]h Parameters}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj4ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chMhj 4ubj)}(hhh]j)}(h:``struct vfsmount *m`` the mount on which to take a write h](j)}(h``struct vfsmount *m``h]j)}(hj24h]hstruct vfsmount *m}(hj44hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj04ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chMhj,4ubj)}(hhh]h)}(h"the mount on which to take a writeh]h"the mount on which to take a write}(hjK4hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjG4hMhjH4ubah}(h]h ]h"]h$]h&]uh1jhj,4ubeh}(h]h ]h"]h$]h&]uh1jhjG4hMhj)4ubah}(h]h ]h"]h$]h&]uh1jhj 4ubh)}(h**Description**h]j)}(hjm4h]h Description}(hjo4hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjk4ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chMhj 4ubh)}(hXSThis tells the low-level filesystem that a write is about to be performed to it, and makes sure that writes are allowed (mnt it read-write) before returning success. This operation does not protect against filesystem being frozen. When the write operation is finished, mnt_put_write_access() must be called. This is effectively a refcount.h]hXSThis tells the low-level filesystem that a write is about to be performed to it, and makes sure that writes are allowed (mnt it read-write) before returning success. This operation does not protect against filesystem being frozen. When the write operation is finished, mnt_put_write_access() must be called. This is effectively a refcount.}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chMhj 4ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j mnt_want_write (C function)c.mnt_want_writehNtauh1hhjOghhhNhNubj)}(hhh](j)}(h'int mnt_want_write (struct vfsmount *m)h]j)}(h&int mnt_want_write(struct vfsmount *m)h](j)}(hinth]hint}(hj4hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4hhhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chMubj2)}(h h]h }(hj4hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj4hhhj4hMubjC)}(hmnt_want_writeh]jI)}(hmnt_want_writeh]hmnt_want_write}(hj4hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj4ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj4hhhj4hMubj=)}(h(struct vfsmount *m)h]jC)}(hstruct vfsmount *mh](j )}(hjh]hstruct}(hj4hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj4ubj2)}(h h]h }(hj4hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj4ubh)}(hhh]jI)}(hvfsmounth]hvfsmount}(hj 5hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj 5ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj5modnameN classnameNjj )}j ]j)}jj4sbc.mnt_want_writeasbuh1hhj4ubj2)}(h h]h }(hj-5hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj4ubj)}(hjh]h*}(hj;5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4ubjI)}(hjNh]hm}(hjH5hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj4ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj4ubah}(h]h ]h"]h$]h&]j`jauh1j<hj4hhhj4hMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj4hhhj4hMubah}(h]j4ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj4hMhj4hhubjw)}(hhh]h)}(hget write access to a mounth]hget write access to a mount}(hjq5hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chMhjn5hhubah}(h]h ]h"]h$]h&]uh1jvhj4hhhj4hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjj5jj5jjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``struct vfsmount *m`` the mount on which to take a write **Description** This tells the low-level filesystem that a write is about to be performed to it, and makes sure that writes are allowed (mount is read-write, filesystem is not frozen) before returning success. When the write operation is finished, mnt_drop_write() must be called. This is effectively a refcount.h](h)}(h**Parameters**h]j)}(hj5h]h Parameters}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj5ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chM hj5ubj)}(hhh]j)}(h:``struct vfsmount *m`` the mount on which to take a write h](j)}(h``struct vfsmount *m``h]j)}(hj5h]hstruct vfsmount *m}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj5ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chMhj5ubj)}(hhh]h)}(h"the mount on which to take a writeh]h"the mount on which to take a write}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj5hMhj5ubah}(h]h ]h"]h$]h&]uh1jhj5ubeh}(h]h ]h"]h$]h&]uh1jhj5hMhj5ubah}(h]h ]h"]h$]h&]uh1jhj5ubh)}(h**Description**h]j)}(hj5h]h Description}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj5ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chM hj5ubh)}(hX*This tells the low-level filesystem that a write is about to be performed to it, and makes sure that writes are allowed (mount is read-write, filesystem is not frozen) before returning success. When the write operation is finished, mnt_drop_write() must be called. This is effectively a refcount.h]hX*This tells the low-level filesystem that a write is about to be performed to it, and makes sure that writes are allowed (mount is read-write, filesystem is not frozen) before returning success. When the write operation is finished, mnt_drop_write() must be called. This is effectively a refcount.}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chM hj5ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j  mnt_want_write_file (C function)c.mnt_want_write_filehNtauh1hhjOghhhNhNubj)}(hhh](j)}(h+int mnt_want_write_file (struct file *file)h]j)}(h*int mnt_want_write_file(struct file *file)h](j)}(hinth]hint}(hj26hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj.6hhhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chM3ubj2)}(h h]h }(hjA6hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj.6hhhj@6hM3ubjC)}(hmnt_want_write_fileh]jI)}(hmnt_want_write_fileh]hmnt_want_write_file}(hjS6hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjO6ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj.6hhhj@6hM3ubj=)}(h(struct file *file)h]jC)}(hstruct file *fileh](j )}(hjh]hstruct}(hjo6hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjk6ubj2)}(h h]h }(hj|6hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjk6ubh)}(hhh]jI)}(hfileh]hfile}(hj6hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj6ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj6modnameN classnameNjj )}j ]j)}jjU6sbc.mnt_want_write_fileasbuh1hhjk6ubj2)}(h h]h }(hj6hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjk6ubj)}(hjh]h*}(hj6hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjk6ubjI)}(hfileh]hfile}(hj6hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjk6ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjg6ubah}(h]h ]h"]h$]h&]j`jauh1j<hj.6hhhj@6hM3ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj*6hhhj@6hM3ubah}(h]j%6ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj@6hM3hj'6hhubjw)}(hhh]h)}(h"get write access to a file's mounth]h$get write access to a file’s mount}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chM3hj6hhubah}(h]h ]h"]h$]h&]uh1jvhj'6hhhj@6hM3ubeh}(h]h ](jfunctioneh"]h$]h&]jjjj 7jj 7jjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``struct file *file`` the file who's mount on which to take a write **Description** This is like mnt_want_write, but if the file is already open for writing it skips incrementing mnt_writers (since the open file already has a reference) and instead only does the freeze protection and the check for emergency r/o remounts. This must be paired with mnt_drop_write_file.h](h)}(h**Parameters**h]j)}(hj7h]h Parameters}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj7ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chM7hj7ubj)}(hhh]j)}(hD``struct file *file`` the file who's mount on which to take a write h](j)}(h``struct file *file``h]j)}(hj37h]hstruct file *file}(hj57hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj17ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chM4hj-7ubj)}(hhh]h)}(h-the file who's mount on which to take a writeh]h/the file who’s mount on which to take a write}(hjL7hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjH7hM4hjI7ubah}(h]h ]h"]h$]h&]uh1jhj-7ubeh}(h]h ]h"]h$]h&]uh1jhjH7hM4hj*7ubah}(h]h ]h"]h$]h&]uh1jhj7ubh)}(h**Description**h]j)}(hjn7h]h Description}(hjp7hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjl7ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chM6hj7ubh)}(hXThis is like mnt_want_write, but if the file is already open for writing it skips incrementing mnt_writers (since the open file already has a reference) and instead only does the freeze protection and the check for emergency r/o remounts. This must be paired with mnt_drop_write_file.h]hXThis is like mnt_want_write, but if the file is already open for writing it skips incrementing mnt_writers (since the open file already has a reference) and instead only does the freeze protection and the check for emergency r/o remounts. This must be paired with mnt_drop_write_file.}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chM5hj7ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j !mnt_put_write_access (C function)c.mnt_put_write_accesshNtauh1hhjOghhhNhNubj)}(hhh](j)}(h0void mnt_put_write_access (struct vfsmount *mnt)h]j)}(h/void mnt_put_write_access(struct vfsmount *mnt)h](j)}(hvoidh]hvoid}(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7hhhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chMHubj2)}(h h]h }(hj7hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj7hhhj7hMHubjC)}(hmnt_put_write_accessh]jI)}(hmnt_put_write_accessh]hmnt_put_write_access}(hj7hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj7ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj7hhhj7hMHubj=)}(h(struct vfsmount *mnt)h]jC)}(hstruct vfsmount *mnth](j )}(hjh]hstruct}(hj7hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj7ubj2)}(h h]h }(hj7hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj7ubh)}(hhh]jI)}(hvfsmounth]hvfsmount}(hj8hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj 8ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj8modnameN classnameNjj )}j ]j)}jj7sbc.mnt_put_write_accessasbuh1hhj7ubj2)}(h h]h }(hj.8hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj7ubj)}(hjh]h*}(hj<8hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7ubjI)}(hmnth]hmnt}(hjI8hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj7ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj7ubah}(h]h ]h"]h$]h&]j`jauh1j<hj7hhhj7hMHubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj7hhhj7hMHubah}(h]j7ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj7hMHhj7hhubjw)}(hhh]h)}(hgive up write access to a mounth]hgive up write access to a mount}(hjs8hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chMHhjp8hhubah}(h]h ]h"]h$]h&]uh1jvhj7hhhj7hMHubeh}(h]h ](jfunctioneh"]h$]h&]jjjj8jj8jjjuh1jhhhjOghNhNubj)}(h**Parameters** ``struct vfsmount *mnt`` the mount on which to give up write access **Description** Tells the low-level filesystem that we are done performing writes to it. Must be matched with mnt_get_write_access() call above.h](h)}(h**Parameters**h]j)}(hj8h]h Parameters}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj8ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chMLhj8ubj)}(hhh]j)}(hD``struct vfsmount *mnt`` the mount on which to give up write access h](j)}(h``struct vfsmount *mnt``h]j)}(hj8h]hstruct vfsmount *mnt}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj8ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chMIhj8ubj)}(hhh]h)}(h*the mount on which to give up write accessh]h*the mount on which to give up write access}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj8hMIhj8ubah}(h]h ]h"]h$]h&]uh1jhj8ubeh}(h]h ]h"]h$]h&]uh1jhj8hMIhj8ubah}(h]h ]h"]h$]h&]uh1jhj8ubh)}(h**Description**h]j)}(hj8h]h Description}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj8ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chMKhj8ubh)}(hTells the low-level filesystem that we are done performing writes to it. Must be matched with mnt_get_write_access() call above.h]hTells the low-level filesystem that we are done performing writes to it. Must be matched with mnt_get_write_access() call above.}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chMJhj8ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j mnt_drop_write (C function)c.mnt_drop_writehNtauh1hhjOghhhNhNubj)}(hhh](j)}(h*void mnt_drop_write (struct vfsmount *mnt)h]j)}(h)void mnt_drop_write(struct vfsmount *mnt)h](j)}(hvoidh]hvoid}(hj49hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj09hhhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chMXubj2)}(h h]h }(hjC9hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj09hhhjB9hMXubjC)}(hmnt_drop_writeh]jI)}(hmnt_drop_writeh]hmnt_drop_write}(hjU9hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjQ9ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj09hhhjB9hMXubj=)}(h(struct vfsmount *mnt)h]jC)}(hstruct vfsmount *mnth](j )}(hjh]hstruct}(hjq9hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjm9ubj2)}(h h]h }(hj~9hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjm9ubh)}(hhh]jI)}(hvfsmounth]hvfsmount}(hj9hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj9ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj9modnameN classnameNjj )}j ]j)}jjW9sbc.mnt_drop_writeasbuh1hhjm9ubj2)}(h h]h }(hj9hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjm9ubj)}(hjh]h*}(hj9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjm9ubjI)}(hmnth]hmnt}(hj9hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjm9ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhji9ubah}(h]h ]h"]h$]h&]j`jauh1j<hj09hhhjB9hMXubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj,9hhhjB9hMXubah}(h]j'9ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjB9hMXhj)9hhubjw)}(hhh]h)}(hgive up write access to a mounth]hgive up write access to a mount}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chMXhj9hhubah}(h]h ]h"]h$]h&]uh1jvhj)9hhhjB9hMXubeh}(h]h ](jfunctioneh"]h$]h&]jjjj :jj :jjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``struct vfsmount *mnt`` the mount on which to give up write access **Description** Tells the low-level filesystem that we are done performing writes to it and also allows filesystem to be frozen again. Must be matched with mnt_want_write() call above.h](h)}(h**Parameters**h]j)}(hj:h]h Parameters}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj:ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chM\hj:ubj)}(hhh]j)}(hD``struct vfsmount *mnt`` the mount on which to give up write access h](j)}(h``struct vfsmount *mnt``h]j)}(hj5:h]hstruct vfsmount *mnt}(hj7:hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj3:ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chMYhj/:ubj)}(hhh]h)}(h*the mount on which to give up write accessh]h*the mount on which to give up write access}(hjN:hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjJ:hMYhjK:ubah}(h]h ]h"]h$]h&]uh1jhj/:ubeh}(h]h ]h"]h$]h&]uh1jhjJ:hMYhj,:ubah}(h]h ]h"]h$]h&]uh1jhj:ubh)}(h**Description**h]j)}(hjp:h]h Description}(hjr:hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjn:ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chM[hj:ubh)}(hTells the low-level filesystem that we are done performing writes to it and also allows filesystem to be frozen again. Must be matched with mnt_want_write() call above.h]hTells the low-level filesystem that we are done performing writes to it and also allows filesystem to be frozen again. Must be matched with mnt_want_write() call above.}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chMZhj:ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j vfs_create_mount (C function)c.vfs_create_mounthNtauh1hhjOghhhNhNubj)}(hhh](j)}(h:struct vfsmount * vfs_create_mount (struct fs_context *fc)h]j)}(h8struct vfsmount *vfs_create_mount(struct fs_context *fc)h](j )}(hjh]hstruct}(hj:hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj:hhhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chMubj2)}(h h]h }(hj:hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj:hhhj:hMubh)}(hhh]jI)}(hvfsmounth]hvfsmount}(hj:hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj:ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj:modnameN classnameNjj )}j ]j)}jvfs_create_mountsbc.vfs_create_mountasbuh1hhj:hhhj:hMubj2)}(h h]h }(hj:hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj:hhhj:hMubj)}(hjh]h*}(hj;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:hhhj:hMubjC)}(hvfs_create_mounth]jI)}(hj:h]hvfs_create_mount}(hj;hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj;ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj:hhhj:hMubj=)}(h(struct fs_context *fc)h]jC)}(hstruct fs_context *fch](j )}(hjh]hstruct}(hj/;hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj+;ubj2)}(h h]h }(hj<;hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj+;ubh)}(hhh]jI)}(h fs_contexth]h fs_context}(hjM;hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjJ;ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjO;modnameN classnameNjj )}j ]j:c.vfs_create_mountasbuh1hhj+;ubj2)}(h h]h }(hjk;hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj+;ubj)}(hjh]h*}(hjy;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+;ubjI)}(hfch]hfc}(hj;hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj+;ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj';ubah}(h]h ]h"]h$]h&]j`jauh1j<hj:hhhj:hMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj:hhhj:hMubah}(h]j:ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj:hMhj:hhubjw)}(hhh]h)}(h*Create a mount for a configured superblockh]h*Create a mount for a configured superblock}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chMhj;hhubah}(h]h ]h"]h$]h&]uh1jvhj:hhhj:hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjj;jj;jjjuh1jhhhjOghNhNubj)}(hX+**Parameters** ``struct fs_context *fc`` The configuration context with the superblock attached **Description** Create a mount to an already configured superblock. If necessary, the caller should invoke vfs_get_tree() before calling this. Note that this does not attach the mount to anything.h](h)}(h**Parameters**h]j)}(hj;h]h Parameters}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj;ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chMhj;ubj)}(hhh]j)}(hQ``struct fs_context *fc`` The configuration context with the superblock attached h](j)}(h``struct fs_context *fc``h]j)}(hj;h]hstruct fs_context *fc}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj;ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chMhj;ubj)}(hhh]h)}(h6The configuration context with the superblock attachedh]h6The configuration context with the superblock attached}(hj <hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj<hMhj<ubah}(h]h ]h"]h$]h&]uh1jhj;ubeh}(h]h ]h"]h$]h&]uh1jhj<hMhj;ubah}(h]h ]h"]h$]h&]uh1jhj;ubh)}(h**Description**h]j)}(hj,<h]h Description}(hj.<hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj*<ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chMhj;ubh)}(hCreate a mount to an already configured superblock. If necessary, the caller should invoke vfs_get_tree() before calling this.h]hCreate a mount to an already configured superblock. If necessary, the caller should invoke vfs_get_tree() before calling this.}(hjB<hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chMhj;ubh)}(h5Note that this does not attach the mount to anything.h]h5Note that this does not attach the mount to anything.}(hjQ<hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chMhj;ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j path_is_mountpoint (C function)c.path_is_mountpointhNtauh1hhjOghhhNhNubj)}(hhh](j)}(h1bool path_is_mountpoint (const struct path *path)h]j)}(h0bool path_is_mountpoint(const struct path *path)h](j)}(hjh]hbool}(hj<hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|<hhhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chMubj2)}(h h]h }(hj<hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj|<hhhj<hMubjC)}(hpath_is_mountpointh]jI)}(hpath_is_mountpointh]hpath_is_mountpoint}(hj<hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj<ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj|<hhhj<hMubj=)}(h(const struct path *path)h]jC)}(hconst struct path *pathh](j )}(hjJh]hconst}(hj<hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj<ubj2)}(h h]h }(hj<hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj<ubj )}(hjh]hstruct}(hj<hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj<ubj2)}(h h]h }(hj<hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj<ubh)}(hhh]jI)}(hpathh]hpath}(hj<hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj<ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj<modnameN classnameNjj )}j ]j)}jj<sbc.path_is_mountpointasbuh1hhj<ubj2)}(h h]h }(hj=hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj<ubj)}(hjh]h*}(hj#=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj<ubjI)}(hpathh]hpath}(hj0=hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj<ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj<ubah}(h]h ]h"]h$]h&]j`jauh1j<hj|<hhhj<hMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjx<hhhj<hMubah}(h]js<ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj<hMhju<hhubjw)}(hhh]h)}(h2Check if path is a mount in the current namespace.h]h2Check if path is a mount in the current namespace.}(hjZ=hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chMhjW=hhubah}(h]h ]h"]h$]h&]uh1jvhju<hhhj<hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjr=jjr=jjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``const struct path *path`` path to check **Description** d_mountpoint() can only be used reliably to establish if a dentry is not mounted in any namespace and that common case is handled inline. d_mountpoint() isn't aware of the possibility there may be multiple mounts using a given dentry in a different namespace. This function checks if the passed in path is a mountpoint rather than the dentry alone.h](h)}(h**Parameters**h]j)}(hj|=h]h Parameters}(hj~=hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjz=ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chMhjv=ubj)}(hhh]j)}(h*``const struct path *path`` path to check h](j)}(h``const struct path *path``h]j)}(hj=h]hconst struct path *path}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj=ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chMhj=ubj)}(hhh]h)}(h path to checkh]h path to check}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj=hMhj=ubah}(h]h ]h"]h$]h&]uh1jhj=ubeh}(h]h ]h"]h$]h&]uh1jhj=hMhj=ubah}(h]h ]h"]h$]h&]uh1jhjv=ubh)}(h**Description**h]j)}(hj=h]h Description}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj=ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chMhjv=ubj)}(hX\d_mountpoint() can only be used reliably to establish if a dentry is not mounted in any namespace and that common case is handled inline. d_mountpoint() isn't aware of the possibility there may be multiple mounts using a given dentry in a different namespace. This function checks if the passed in path is a mountpoint rather than the dentry alone.h]h)}(hX\d_mountpoint() can only be used reliably to establish if a dentry is not mounted in any namespace and that common case is handled inline. d_mountpoint() isn't aware of the possibility there may be multiple mounts using a given dentry in a different namespace. This function checks if the passed in path is a mountpoint rather than the dentry alone.h]hX^d_mountpoint() can only be used reliably to establish if a dentry is not mounted in any namespace and that common case is handled inline. d_mountpoint() isn’t aware of the possibility there may be multiple mounts using a given dentry in a different namespace. This function checks if the passed in path is a mountpoint rather than the dentry alone.}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chMhj=ubah}(h]h ]h"]h$]h&]uh1jhj=hMhjv=ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j may_umount_tree (C function)c.may_umount_treehNtauh1hhjOghhhNhNubj)}(hhh](j)}(h(int may_umount_tree (struct vfsmount *m)h]j)}(h'int may_umount_tree(struct vfsmount *m)h](j)}(hinth]hint}(hj%>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!>hhhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chMubj2)}(h h]h }(hj4>hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj!>hhhj3>hMubjC)}(hmay_umount_treeh]jI)}(hmay_umount_treeh]hmay_umount_tree}(hjF>hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjB>ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj!>hhhj3>hMubj=)}(h(struct vfsmount *m)h]jC)}(hstruct vfsmount *mh](j )}(hjh]hstruct}(hjb>hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj^>ubj2)}(h h]h }(hjo>hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj^>ubh)}(hhh]jI)}(hvfsmounth]hvfsmount}(hj>hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj}>ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj>modnameN classnameNjj )}j ]j)}jjH>sbc.may_umount_treeasbuh1hhj^>ubj2)}(h h]h }(hj>hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj^>ubj)}(hjh]h*}(hj>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^>ubjI)}(hjNh]hm}(hj>hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj^>ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjZ>ubah}(h]h ]h"]h$]h&]j`jauh1j<hj!>hhhj3>hMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj>hhhj3>hMubah}(h]j>ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj3>hMhj>hhubjw)}(hhh]h)}(hcheck if a mount tree is busyh]hcheck if a mount tree is busy}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chMhj>hhubah}(h]h ]h"]h$]h&]uh1jvhj>hhhj3>hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjj>jj>jjjuh1jhhhjOghNhNubj)}(h**Parameters** ``struct vfsmount *m`` root of mount tree **Description** This is called to check if a tree of mounts has any open files, pwds, chroots or sub mounts that are busy.h](h)}(h**Parameters**h]j)}(hj?h]h Parameters}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj?ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chMhj?ubj)}(hhh]j)}(h*``struct vfsmount *m`` root of mount tree h](j)}(h``struct vfsmount *m``h]j)}(hj%?h]hstruct vfsmount *m}(hj'?hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj#?ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chMhj?ubj)}(hhh]h)}(hroot of mount treeh]hroot of mount tree}(hj>?hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj:?hMhj;?ubah}(h]h ]h"]h$]h&]uh1jhj?ubeh}(h]h ]h"]h$]h&]uh1jhj:?hMhj?ubah}(h]h ]h"]h$]h&]uh1jhj?ubh)}(h**Description**h]j)}(hj`?h]h Description}(hjb?hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj^?ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chMhj?ubh)}(hjThis is called to check if a tree of mounts has any open files, pwds, chroots or sub mounts that are busy.h]hjThis is called to check if a tree of mounts has any open files, pwds, chroots or sub mounts that are busy.}(hjv?hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chMhj?ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j may_umount (C function) c.may_umounthNtauh1hhjOghhhNhNubj)}(hhh](j)}(h%int may_umount (struct vfsmount *mnt)h]j)}(h$int may_umount(struct vfsmount *mnt)h](j)}(hinth]hint}(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?hhhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chMubj2)}(h h]h }(hj?hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj?hhhj?hMubjC)}(h may_umounth]jI)}(h may_umounth]h may_umount}(hj?hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj?ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj?hhhj?hMubj=)}(h(struct vfsmount *mnt)h]jC)}(hstruct vfsmount *mnth](j )}(hjh]hstruct}(hj?hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj?ubj2)}(h h]h }(hj?hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj?ubh)}(hhh]jI)}(hvfsmounth]hvfsmount}(hj@hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj?ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj@modnameN classnameNjj )}j ]j)}jj?sb c.may_umountasbuh1hhj?ubj2)}(h h]h }(hj @hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj?ubj)}(hjh]h*}(hj.@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?ubjI)}(hmnth]hmnt}(hj;@hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj?ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj?ubah}(h]h ]h"]h$]h&]j`jauh1j<hj?hhhj?hMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj?hhhj?hMubah}(h]j?ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj?hMhj?hhubjw)}(hhh]h)}(hcheck if a mount point is busyh]hcheck if a mount point is busy}(hje@hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chMhjb@hhubah}(h]h ]h"]h$]h&]uh1jvhj?hhhj?hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjj}@jj}@jjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``struct vfsmount *mnt`` root of mount **Description** This is called to check if a mount point has any open files, pwds, chroots or sub mounts. If the mount has sub mounts this will return busy regardless of whether the sub mounts are busy. Doesn't take quota and stuff into account. IOW, in some cases it will give false negatives. The main reason why it's here is that we need a non-destructive way to look for easily umountable filesystems.h](h)}(h**Parameters**h]j)}(hj@h]h Parameters}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj@ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chMhj@ubj)}(hhh]j)}(h'``struct vfsmount *mnt`` root of mount h](j)}(h``struct vfsmount *mnt``h]j)}(hj@h]hstruct vfsmount *mnt}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj@ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chMhj@ubj)}(hhh]h)}(h root of mounth]h root of mount}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj@hMhj@ubah}(h]h ]h"]h$]h&]uh1jhj@ubeh}(h]h ]h"]h$]h&]uh1jhj@hMhj@ubah}(h]h ]h"]h$]h&]uh1jhj@ubh)}(h**Description**h]j)}(hj@h]h Description}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj@ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chMhj@ubh)}(hThis is called to check if a mount point has any open files, pwds, chroots or sub mounts. If the mount has sub mounts this will return busy regardless of whether the sub mounts are busy.h]hThis is called to check if a mount point has any open files, pwds, chroots or sub mounts. If the mount has sub mounts this will return busy regardless of whether the sub mounts are busy.}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chMhj@ubh)}(hDoesn't take quota and stuff into account. IOW, in some cases it will give false negatives. The main reason why it's here is that we need a non-destructive way to look for easily umountable filesystems.h]hDoesn’t take quota and stuff into account. IOW, in some cases it will give false negatives. The main reason why it’s here is that we need a non-destructive way to look for easily umountable filesystems.}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chMhj@ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j  clone_private_mount (C function)c.clone_private_mounthNtauh1hhjOghhhNhNubj)}(hhh](j)}(h?struct vfsmount * clone_private_mount (const struct path *path)h]j)}(h=struct vfsmount *clone_private_mount(const struct path *path)h](j )}(hjh]hstruct}(hj5AhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj1AhhhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chM ubj2)}(h h]h }(hjCAhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj1AhhhjBAhM ubh)}(hhh]jI)}(hvfsmounth]hvfsmount}(hjTAhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjQAubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjVAmodnameN classnameNjj )}j ]j)}jclone_private_mountsbc.clone_private_mountasbuh1hhj1AhhhjBAhM ubj2)}(h h]h }(hjuAhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj1AhhhjBAhM ubj)}(hjh]h*}(hjAhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj1AhhhjBAhM ubjC)}(hclone_private_mounth]jI)}(hjrAh]hclone_private_mount}(hjAhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjAubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj1AhhhjBAhM ubj=)}(h(const struct path *path)h]jC)}(hconst struct path *pathh](j )}(hjJh]hconst}(hjAhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjAubj2)}(h h]h }(hjAhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjAubj )}(hjh]hstruct}(hjAhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjAubj2)}(h h]h }(hjAhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjAubh)}(hhh]jI)}(hpathh]hpath}(hjAhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjAubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjAmodnameN classnameNjj )}j ]jpAc.clone_private_mountasbuh1hhjAubj2)}(h h]h }(hjBhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjAubj)}(hjh]h*}(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjAubjI)}(hpathh]hpath}(hj!BhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjAubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjAubah}(h]h ]h"]h$]h&]j`jauh1j<hj1AhhhjBAhM ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj-AhhhjBAhM ubah}(h]j(Aah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjBAhM hj*Ahhubjw)}(hhh]h)}(h create a private clone of a pathh]h create a private clone of a path}(hjKBhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chM hjHBhhubah}(h]h ]h"]h$]h&]uh1jvhj*AhhhjBAhM ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjcBjjcBjjjuh1jhhhjOghNhNubj)}(hX**Parameters** ``const struct path *path`` path to clone **Description** This creates a new vfsmount, which will be the clone of **path**. The new mount will not be attached anywhere in the namespace and will be private (i.e. changes to the originating mount won't be propagated into this). This assumes caller has called or done the equivalent of may_mount(). Release with mntput().h](h)}(h**Parameters**h]j)}(hjmBh]h Parameters}(hjoBhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjkBubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chM hjgBubj)}(hhh]j)}(h*``const struct path *path`` path to clone h](j)}(h``const struct path *path``h]j)}(hjBh]hconst struct path *path}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjBubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chM hjBubj)}(hhh]h)}(h path to cloneh]h path to clone}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjBhM hjBubah}(h]h ]h"]h$]h&]uh1jhjBubeh}(h]h ]h"]h$]h&]uh1jhjBhM hjBubah}(h]h ]h"]h$]h&]uh1jhjgBubh)}(h**Description**h]j)}(hjBh]h Description}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjBubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chM hjgBubh)}(hThis creates a new vfsmount, which will be the clone of **path**. The new mount will not be attached anywhere in the namespace and will be private (i.e. changes to the originating mount won't be propagated into this).h](h8This creates a new vfsmount, which will be the clone of }(hjBhhhNhNubj)}(h**path**h]hpath}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjBubh. The new mount will not be attached anywhere in the namespace and will be private (i.e. changes to the originating mount won’t be propagated into this).}(hjBhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chM hjgBubh)}(hEThis assumes caller has called or done the equivalent of may_mount().h]hEThis assumes caller has called or done the equivalent of may_mount().}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chM hjgBubh)}(hRelease with mntput().h]hRelease with mntput().}(hj ChhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chM hjgBubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j mnt_set_expiry (C function)c.mnt_set_expiryhNtauh1hhjOghhhNhNubj)}(hhh](j)}(hIvoid mnt_set_expiry (struct vfsmount *mnt, struct list_head *expiry_list)h]j)}(hHvoid mnt_set_expiry(struct vfsmount *mnt, struct list_head *expiry_list)h](j)}(hvoidh]hvoid}(hjah"]h$]h&]uh1j1hj8ChhhjJChMubjC)}(hmnt_set_expiryh]jI)}(hmnt_set_expiryh]hmnt_set_expiry}(hj]ChhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjYCubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj8ChhhjJChMubj=)}(h5(struct vfsmount *mnt, struct list_head *expiry_list)h](jC)}(hstruct vfsmount *mnth](j )}(hjh]hstruct}(hjyChhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjuCubj2)}(h h]h }(hjChhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjuCubh)}(hhh]jI)}(hvfsmounth]hvfsmount}(hjChhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjCubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjCmodnameN classnameNjj )}j ]j)}jj_Csbc.mnt_set_expiryasbuh1hhjuCubj2)}(h h]h }(hjChhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjuCubj)}(hjh]h*}(hjChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjuCubjI)}(hmnth]hmnt}(hjChhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjuCubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjqCubjC)}(hstruct list_head *expiry_listh](j )}(hjh]hstruct}(hjChhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjCubj2)}(h h]h }(hjChhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjCubh)}(hhh]jI)}(h list_headh]h list_head}(hj DhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjDubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj DmodnameN classnameNjj )}j ]jCc.mnt_set_expiryasbuh1hhjCubj2)}(h h]h }(hj'DhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjCubj)}(hjh]h*}(hj5DhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCubjI)}(h expiry_listh]h expiry_list}(hjBDhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjCubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjqCubeh}(h]h ]h"]h$]h&]j`jauh1j<hj8ChhhjJChMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj4ChhhjJChMubah}(h]j/Cah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjJChMhj1Chhubjw)}(hhh]h)}(h!Put a mount on an expiration listh]h!Put a mount on an expiration list}(hjlDhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chMhjiDhhubah}(h]h ]h"]h$]h&]uh1jvhj1ChhhjJChMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjDjjDjjjuh1jhhhjOghNhNubj)}(h**Parameters** ``struct vfsmount *mnt`` The mount to list. ``struct list_head *expiry_list`` The list to add the mount to.h](h)}(h**Parameters**h]j)}(hjDh]h Parameters}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjDubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chMhjDubj)}(hhh](j)}(h,``struct vfsmount *mnt`` The mount to list. h](j)}(h``struct vfsmount *mnt``h]j)}(hjDh]hstruct vfsmount *mnt}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjDubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chMhjDubj)}(hhh]h)}(hThe mount to list.h]hThe mount to list.}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjDhMhjDubah}(h]h ]h"]h$]h&]uh1jhjDubeh}(h]h ]h"]h$]h&]uh1jhjDhMhjDubj)}(h?``struct list_head *expiry_list`` The list to add the mount to.h](j)}(h!``struct list_head *expiry_list``h]j)}(hjDh]hstruct list_head *expiry_list}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjDubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chMhjDubj)}(hhh]h)}(hThe list to add the mount to.h]hThe list to add the mount to.}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:101: ./fs/namespace.chMhjDubah}(h]h ]h"]h$]h&]uh1jhjDubeh}(h]h ]h"]h$]h&]uh1jhjDhMhjDubeh}(h]h ]h"]h$]h&]uh1jhjDubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjOghhhNhNubeh}(h]other-functionsah ]h"]other functionsah$]h&]uh1hhhhhhhhK3ubeh}(h] the-linux-vfsah ]h"] the linux vfsah$]h&]uh1hhhhhhhhK ubh)}(hhh](h)}(hThe proc filesystemh]hThe proc filesystem}(hj:EhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj7EhhhhhKiubh)}(hhh](h)}(hsysctl interfaceh]hsysctl interface}(hjKEhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjHEhhhhhKlubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j proc_dostring (C function)c.proc_dostringhNtauh1hhjHEhhhNhNubj)}(hhh](j)}(hdint proc_dostring (const struct ctl_table *table, int dir, void *buffer, size_t *lenp, loff_t *ppos)h]j)}(hcint proc_dostring(const struct ctl_table *table, int dir, void *buffer, size_t *lenp, loff_t *ppos)h](j)}(hinth]hint}(hjrEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnEhhhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chKubj2)}(h h]h }(hjEhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjnEhhhjEhKubjC)}(h proc_dostringh]jI)}(h proc_dostringh]h proc_dostring}(hjEhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjEubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjnEhhhjEhKubj=)}(hR(const struct ctl_table *table, int dir, void *buffer, size_t *lenp, loff_t *ppos)h](jC)}(hconst struct ctl_table *tableh](j )}(hjJh]hconst}(hjEhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjEubj2)}(h h]h }(hjEhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjEubj )}(hjh]hstruct}(hjEhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjEubj2)}(h h]h }(hjEhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjEubh)}(hhh]jI)}(h ctl_tableh]h ctl_table}(hjEhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjEubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjEmodnameN classnameNjj )}j ]j)}jjEsbc.proc_dostringasbuh1hhjEubj2)}(h h]h }(hjFhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjEubj)}(hjh]h*}(hjFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEubjI)}(htableh]htable}(hj#FhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjEubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjEubjC)}(hint dirh](j)}(hinth]hint}(hjah"]h$]h&]uh1j1hj8FubjI)}(hdirh]hdir}(hjXFhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj8Fubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjEubjC)}(h void *bufferh](j)}(hvoidh]hvoid}(hjqFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmFubj2)}(h h]h }(hjFhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjmFubj)}(hjh]h*}(hjFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmFubjI)}(hbufferh]hbuffer}(hjFhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjmFubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjEubjC)}(h size_t *lenph](h)}(hhh]jI)}(hsize_th]hsize_t}(hjFhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjFubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjFmodnameN classnameNjj )}j ]jFc.proc_dostringasbuh1hhjFubj2)}(h h]h }(hjFhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjFubj)}(hjh]h*}(hjFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFubjI)}(hlenph]hlenp}(hjFhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjFubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjEubjC)}(h loff_t *pposh](h)}(hhh]jI)}(hloff_th]hloff_t}(hj GhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjGubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj GmodnameN classnameNjj )}j ]jFc.proc_dostringasbuh1hhjGubj2)}(h h]h }(hj)GhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjGubj)}(hjh]h*}(hj7GhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGubjI)}(hpposh]hppos}(hjDGhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjGubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjEubeh}(h]h ]h"]h$]h&]j`jauh1j<hjnEhhhjEhKubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjjEhhhjEhKubah}(h]jeEah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjEhKhjgEhhubjw)}(hhh]h)}(hread a string sysctlh]hread a string sysctl}(hjnGhhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chKhjkGhhubah}(h]h ]h"]h$]h&]uh1jvhjgEhhhjEhKubeh}(h]h ](jfunctioneh"]h$]h&]jjjjGjjGjjjuh1jhhhjHEhNhNubj)}(hXo**Parameters** ``const struct ctl_table *table`` the sysctl table ``int dir`` ``TRUE`` if this is a write to the sysctl file ``void *buffer`` the user buffer ``size_t *lenp`` the size of the user buffer ``loff_t *ppos`` file position **Description** Reads/writes a string from/to the user buffer. If the kernel buffer provided is not large enough to hold the string, the string is truncated. The copied string is ``NULL-terminated``. If the string is being read by the user process, it is copied and a newline '\n' is added. It is truncated if the buffer is not large enough. **Return** ``0`` on success.h](h)}(h**Parameters**h]j)}(hjGh]h Parameters}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjGubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chKhjGubj)}(hhh](j)}(h3``const struct ctl_table *table`` the sysctl table h](j)}(h!``const struct ctl_table *table``h]j)}(hjGh]hconst struct ctl_table *table}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjGubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chKhjGubj)}(hhh]h)}(hthe sysctl tableh]hthe sysctl table}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjGhKhjGubah}(h]h ]h"]h$]h&]uh1jhjGubeh}(h]h ]h"]h$]h&]uh1jhjGhKhjGubj)}(h;``int dir`` ``TRUE`` if this is a write to the sysctl file h](j)}(h ``int dir``h]j)}(hjGh]hint dir}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjGubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chKhjGubj)}(hhh]h)}(h.``TRUE`` if this is a write to the sysctl fileh](j)}(h``TRUE``h]hTRUE}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjHubh& if this is a write to the sysctl file}(hjHhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjGhKhjGubah}(h]h ]h"]h$]h&]uh1jhjGubeh}(h]h ]h"]h$]h&]uh1jhjGhKhjGubj)}(h!``void *buffer`` the user buffer h](j)}(h``void *buffer``h]j)}(hj/Hh]h void *buffer}(hj1HhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj-Hubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chKhj)Hubj)}(hhh]h)}(hthe user bufferh]hthe user buffer}(hjHHhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjDHhKhjEHubah}(h]h ]h"]h$]h&]uh1jhj)Hubeh}(h]h ]h"]h$]h&]uh1jhjDHhKhjGubj)}(h-``size_t *lenp`` the size of the user buffer h](j)}(h``size_t *lenp``h]j)}(hjhHh]h size_t *lenp}(hjjHhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjfHubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chKhjbHubj)}(hhh]h)}(hthe size of the user bufferh]hthe size of the user buffer}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj}HhKhj~Hubah}(h]h ]h"]h$]h&]uh1jhjbHubeh}(h]h ]h"]h$]h&]uh1jhj}HhKhjGubj)}(h``loff_t *ppos`` file position h](j)}(h``loff_t *ppos``h]j)}(hjHh]h loff_t *ppos}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjHubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chKhjHubj)}(hhh]h)}(h file positionh]h file position}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjHhKhjHubah}(h]h ]h"]h$]h&]uh1jhjHubeh}(h]h ]h"]h$]h&]uh1jhjHhKhjGubeh}(h]h ]h"]h$]h&]uh1jhjGubh)}(h**Description**h]j)}(hjHh]h Description}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjHubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chKhjGubh)}(hXEReads/writes a string from/to the user buffer. If the kernel buffer provided is not large enough to hold the string, the string is truncated. The copied string is ``NULL-terminated``. If the string is being read by the user process, it is copied and a newline '\n' is added. It is truncated if the buffer is not large enough.h](hReads/writes a string from/to the user buffer. If the kernel buffer provided is not large enough to hold the string, the string is truncated. The copied string is }(hjHhhhNhNubj)}(h``NULL-terminated``h]hNULL-terminated}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjHubh. If the string is being read by the user process, it is copied and a newline ‘n’ is added. It is truncated if the buffer is not large enough.}(hjHhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chKhjGubh)}(h **Return**h]j)}(hjIh]hReturn}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjIubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chKhjGubh)}(h``0`` on success.h](j)}(h``0``h]h0}(hj/IhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj+Iubh on success.}(hj+IhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chKhjGubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjHEhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j proc_dobool (C function) c.proc_doboolhNtauh1hhjHEhhhNhNubj)}(hhh](j)}(hbint proc_dobool (const struct ctl_table *table, int dir, void *buffer, size_t *lenp, loff_t *ppos)h]j)}(haint proc_dobool(const struct ctl_table *table, int dir, void *buffer, size_t *lenp, loff_t *ppos)h](j)}(hinth]hint}(hjhIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjdIhhhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMEubj2)}(h h]h }(hjwIhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjdIhhhjvIhMEubjC)}(h proc_doboolh]jI)}(h proc_doboolh]h proc_dobool}(hjIhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjIubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjdIhhhjvIhMEubj=)}(hR(const struct ctl_table *table, int dir, void *buffer, size_t *lenp, loff_t *ppos)h](jC)}(hconst struct ctl_table *tableh](j )}(hjJh]hconst}(hjIhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjIubj2)}(h h]h }(hjIhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjIubj )}(hjh]hstruct}(hjIhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjIubj2)}(h h]h }(hjIhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjIubh)}(hhh]jI)}(h ctl_tableh]h ctl_table}(hjIhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjIubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjImodnameN classnameNjj )}j ]j)}jjIsb c.proc_doboolasbuh1hhjIubj2)}(h h]h }(hjIhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjIubj)}(hjh]h*}(hj JhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIubjI)}(htableh]htable}(hjJhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjIubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjIubjC)}(hint dirh](j)}(hinth]hint}(hj2JhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj.Jubj2)}(h h]h }(hj@JhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj.JubjI)}(hdirh]hdir}(hjNJhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj.Jubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjIubjC)}(h void *bufferh](j)}(hvoidh]hvoid}(hjgJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjcJubj2)}(h h]h }(hjuJhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjcJubj)}(hjh]h*}(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjcJubjI)}(hbufferh]hbuffer}(hjJhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjcJubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjIubjC)}(h size_t *lenph](h)}(hhh]jI)}(hsize_th]hsize_t}(hjJhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjJubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjJmodnameN classnameNjj )}j ]jI c.proc_doboolasbuh1hhjJubj2)}(h h]h }(hjJhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjJubj)}(hjh]h*}(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJubjI)}(hlenph]hlenp}(hjJhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjJubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjIubjC)}(h loff_t *pposh](h)}(hhh]jI)}(hloff_th]hloff_t}(hjKhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjJubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjKmodnameN classnameNjj )}j ]jI c.proc_doboolasbuh1hhjJubj2)}(h h]h }(hjKhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjJubj)}(hjh]h*}(hj-KhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJubjI)}(hpposh]hppos}(hj:KhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjJubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjIubeh}(h]h ]h"]h$]h&]j`jauh1j<hjdIhhhjvIhMEubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj`IhhhjvIhMEubah}(h]j[Iah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjvIhMEhj]Ihhubjw)}(hhh]h)}(hread/write a boolh]hread/write a bool}(hjdKhhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMEhjaKhhubah}(h]h ]h"]h$]h&]uh1jvhj]IhhhjvIhMEubeh}(h]h ](jfunctioneh"]h$]h&]jjjj|Kjj|Kjjjuh1jhhhjHEhNhNubj)}(hX**Parameters** ``const struct ctl_table *table`` the sysctl table ``int dir`` ``TRUE`` if this is a write to the sysctl file ``void *buffer`` the user buffer ``size_t *lenp`` the size of the user buffer ``loff_t *ppos`` file position **Description** Reads/writes one integer value from/to the user buffer, treated as an ASCII string. table->data must point to a bool variable and table->maxlen must be sizeof(bool). **Return** ``0`` on success.h](h)}(h**Parameters**h]j)}(hjKh]h Parameters}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjKubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMIhjKubj)}(hhh](j)}(h3``const struct ctl_table *table`` the sysctl table h](j)}(h!``const struct ctl_table *table``h]j)}(hjKh]hconst struct ctl_table *table}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjKubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMFhjKubj)}(hhh]h)}(hthe sysctl tableh]hthe sysctl table}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjKhMFhjKubah}(h]h ]h"]h$]h&]uh1jhjKubeh}(h]h ]h"]h$]h&]uh1jhjKhMFhjKubj)}(h;``int dir`` ``TRUE`` if this is a write to the sysctl file h](j)}(h ``int dir``h]j)}(hjKh]hint dir}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjKubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMGhjKubj)}(hhh]h)}(h.``TRUE`` if this is a write to the sysctl fileh](j)}(h``TRUE``h]hTRUE}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjKubh& if this is a write to the sysctl file}(hjKhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjKhMGhjKubah}(h]h ]h"]h$]h&]uh1jhjKubeh}(h]h ]h"]h$]h&]uh1jhjKhMGhjKubj)}(h!``void *buffer`` the user buffer h](j)}(h``void *buffer``h]j)}(hj%Lh]h void *buffer}(hj'LhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj#Lubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMHhjLubj)}(hhh]h)}(hthe user bufferh]hthe user buffer}(hj>LhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj:LhMHhj;Lubah}(h]h ]h"]h$]h&]uh1jhjLubeh}(h]h ]h"]h$]h&]uh1jhj:LhMHhjKubj)}(h-``size_t *lenp`` the size of the user buffer h](j)}(h``size_t *lenp``h]j)}(hj^Lh]h size_t *lenp}(hj`LhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj\Lubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMIhjXLubj)}(hhh]h)}(hthe size of the user bufferh]hthe size of the user buffer}(hjwLhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjsLhMIhjtLubah}(h]h ]h"]h$]h&]uh1jhjXLubeh}(h]h ]h"]h$]h&]uh1jhjsLhMIhjKubj)}(h``loff_t *ppos`` file position h](j)}(h``loff_t *ppos``h]j)}(hjLh]h loff_t *ppos}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjLubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMJhjLubj)}(hhh]h)}(h file positionh]h file position}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjLhMJhjLubah}(h]h ]h"]h$]h&]uh1jhjLubeh}(h]h ]h"]h$]h&]uh1jhjLhMJhjKubeh}(h]h ]h"]h$]h&]uh1jhjKubh)}(h**Description**h]j)}(hjLh]h Description}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjLubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMLhjKubh)}(hSReads/writes one integer value from/to the user buffer, treated as an ASCII string.h]hSReads/writes one integer value from/to the user buffer, treated as an ASCII string.}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMKhjKubh)}(hQtable->data must point to a bool variable and table->maxlen must be sizeof(bool).h]hQtable->data must point to a bool variable and table->maxlen must be sizeof(bool).}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMNhjKubh)}(h **Return**h]j)}(hjMh]hReturn}(hj MhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjMubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMQhjKubh)}(h``0`` on success.h](j)}(h``0``h]h0}(hj"MhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjMubh on success.}(hjMhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMRhjKubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjHEhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j proc_dointvec (C function)c.proc_dointvechNtauh1hhjHEhhhNhNubj)}(hhh](j)}(hdint proc_dointvec (const struct ctl_table *table, int dir, void *buffer, size_t *lenp, loff_t *ppos)h]j)}(hcint proc_dointvec(const struct ctl_table *table, int dir, void *buffer, size_t *lenp, loff_t *ppos)h](j)}(hinth]hint}(hj[MhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjWMhhhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMmubj2)}(h h]h }(hjjMhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjWMhhhjiMhMmubjC)}(h proc_dointvech]jI)}(h proc_dointvech]h proc_dointvec}(hj|MhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjxMubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjWMhhhjiMhMmubj=)}(hR(const struct ctl_table *table, int dir, void *buffer, size_t *lenp, loff_t *ppos)h](jC)}(hconst struct ctl_table *tableh](j )}(hjJh]hconst}(hjMhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjMubj2)}(h h]h }(hjMhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjMubj )}(hjh]hstruct}(hjMhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjMubj2)}(h h]h }(hjMhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjMubh)}(hhh]jI)}(h ctl_tableh]h ctl_table}(hjMhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjMubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjMmodnameN classnameNjj )}j ]j)}jj~Msbc.proc_dointvecasbuh1hhjMubj2)}(h h]h }(hjMhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjMubj)}(hjh]h*}(hjMhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjMubjI)}(htableh]htable}(hj NhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjMubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjMubjC)}(hint dirh](j)}(hinth]hint}(hj%NhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!Nubj2)}(h h]h }(hj3NhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj!NubjI)}(hdirh]hdir}(hjANhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj!Nubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjMubjC)}(h void *bufferh](j)}(hvoidh]hvoid}(hjZNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVNubj2)}(h h]h }(hjhNhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjVNubj)}(hjh]h*}(hjvNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVNubjI)}(hbufferh]hbuffer}(hjNhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjVNubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjMubjC)}(h size_t *lenph](h)}(hhh]jI)}(hsize_th]hsize_t}(hjNhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjNubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjNmodnameN classnameNjj )}j ]jMc.proc_dointvecasbuh1hhjNubj2)}(h h]h }(hjNhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjNubj)}(hjh]h*}(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubjI)}(hlenph]hlenp}(hjNhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjNubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjMubjC)}(h loff_t *pposh](h)}(hhh]jI)}(hloff_th]hloff_t}(hjNhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjNubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjNmodnameN classnameNjj )}j ]jMc.proc_dointvecasbuh1hhjNubj2)}(h h]h }(hjOhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjNubj)}(hjh]h*}(hj OhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubjI)}(hpposh]hppos}(hj-OhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjNubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjMubeh}(h]h ]h"]h$]h&]j`jauh1j<hjWMhhhjiMhMmubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjSMhhhjiMhMmubah}(h]jNMah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjiMhMmhjPMhhubjw)}(hhh]h)}(hread a vector of integersh]hread a vector of integers}(hjWOhhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMmhjTOhhubah}(h]h ]h"]h$]h&]uh1jvhjPMhhhjiMhMmubeh}(h]h ](jfunctioneh"]h$]h&]jjjjoOjjoOjjjuh1jhhhjHEhNhNubj)}(hX**Parameters** ``const struct ctl_table *table`` the sysctl table ``int dir`` ``TRUE`` if this is a write to the sysctl file ``void *buffer`` the user buffer ``size_t *lenp`` the size of the user buffer ``loff_t *ppos`` file position **Description** Reads/writes up to table->maxlen/sizeof(unsigned int) integer values from/to the user buffer, treated as an ASCII string. **Return** ``0`` on success.h](h)}(h**Parameters**h]j)}(hjyOh]h Parameters}(hj{OhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjwOubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMqhjsOubj)}(hhh](j)}(h3``const struct ctl_table *table`` the sysctl table h](j)}(h!``const struct ctl_table *table``h]j)}(hjOh]hconst struct ctl_table *table}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjOubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMnhjOubj)}(hhh]h)}(hthe sysctl tableh]hthe sysctl table}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjOhMnhjOubah}(h]h ]h"]h$]h&]uh1jhjOubeh}(h]h ]h"]h$]h&]uh1jhjOhMnhjOubj)}(h;``int dir`` ``TRUE`` if this is a write to the sysctl file h](j)}(h ``int dir``h]j)}(hjOh]hint dir}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjOubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMohjOubj)}(hhh]h)}(h.``TRUE`` if this is a write to the sysctl fileh](j)}(h``TRUE``h]hTRUE}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjOubh& if this is a write to the sysctl file}(hjOhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjOhMohjOubah}(h]h ]h"]h$]h&]uh1jhjOubeh}(h]h ]h"]h$]h&]uh1jhjOhMohjOubj)}(h!``void *buffer`` the user buffer h](j)}(h``void *buffer``h]j)}(hjPh]h void *buffer}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjPubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMphjPubj)}(hhh]h)}(hthe user bufferh]hthe user buffer}(hj1PhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj-PhMphj.Pubah}(h]h ]h"]h$]h&]uh1jhjPubeh}(h]h ]h"]h$]h&]uh1jhj-PhMphjOubj)}(h-``size_t *lenp`` the size of the user buffer h](j)}(h``size_t *lenp``h]j)}(hjQPh]h size_t *lenp}(hjSPhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjOPubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMqhjKPubj)}(hhh]h)}(hthe size of the user bufferh]hthe size of the user buffer}(hjjPhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjfPhMqhjgPubah}(h]h ]h"]h$]h&]uh1jhjKPubeh}(h]h ]h"]h$]h&]uh1jhjfPhMqhjOubj)}(h``loff_t *ppos`` file position h](j)}(h``loff_t *ppos``h]j)}(hjPh]h loff_t *ppos}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjPubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMrhjPubj)}(hhh]h)}(h file positionh]h file position}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjPhMrhjPubah}(h]h ]h"]h$]h&]uh1jhjPubeh}(h]h ]h"]h$]h&]uh1jhjPhMrhjOubeh}(h]h ]h"]h$]h&]uh1jhjsOubh)}(h**Description**h]j)}(hjPh]h Description}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjPubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMthjsOubh)}(hyReads/writes up to table->maxlen/sizeof(unsigned int) integer values from/to the user buffer, treated as an ASCII string.h]hyReads/writes up to table->maxlen/sizeof(unsigned int) integer values from/to the user buffer, treated as an ASCII string.}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMshjsOubh)}(h **Return**h]j)}(hjPh]hReturn}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjPubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMvhjsOubh)}(h``0`` on success.h](j)}(h``0``h]h0}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjQubh on success.}(hjQhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMwhjsOubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjHEhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j proc_douintvec (C function)c.proc_douintvechNtauh1hhjHEhhhNhNubj)}(hhh](j)}(heint proc_douintvec (const struct ctl_table *table, int dir, void *buffer, size_t *lenp, loff_t *ppos)h]j)}(hdint proc_douintvec(const struct ctl_table *table, int dir, void *buffer, size_t *lenp, loff_t *ppos)h](j)}(hinth]hint}(hj?QhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;QhhhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMubj2)}(h h]h }(hjNQhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj;QhhhjMQhMubjC)}(hproc_douintvech]jI)}(hproc_douintvech]hproc_douintvec}(hj`QhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj\Qubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj;QhhhjMQhMubj=)}(hR(const struct ctl_table *table, int dir, void *buffer, size_t *lenp, loff_t *ppos)h](jC)}(hconst struct ctl_table *tableh](j )}(hjJh]hconst}(hj|QhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjxQubj2)}(h h]h }(hjQhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjxQubj )}(hjh]hstruct}(hjQhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjxQubj2)}(h h]h }(hjQhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjxQubh)}(hhh]jI)}(h ctl_tableh]h ctl_table}(hjQhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjQubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjQmodnameN classnameNjj )}j ]j)}jjbQsbc.proc_douintvecasbuh1hhjxQubj2)}(h h]h }(hjQhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjxQubj)}(hjh]h*}(hjQhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjxQubjI)}(htableh]htable}(hjQhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjxQubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjtQubjC)}(hint dirh](j)}(hinth]hint}(hj RhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRubj2)}(h h]h }(hjRhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjRubjI)}(hdirh]hdir}(hj%RhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjRubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjtQubjC)}(h void *bufferh](j)}(hvoidh]hvoid}(hj>RhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:Rubj2)}(h h]h }(hjLRhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj:Rubj)}(hjh]h*}(hjZRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:RubjI)}(hbufferh]hbuffer}(hjgRhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj:Rubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjtQubjC)}(h size_t *lenph](h)}(hhh]jI)}(hsize_th]hsize_t}(hjRhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjRubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjRmodnameN classnameNjj )}j ]jQc.proc_douintvecasbuh1hhj|Rubj2)}(h h]h }(hjRhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj|Rubj)}(hjh]h*}(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|RubjI)}(hlenph]hlenp}(hjRhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj|Rubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjtQubjC)}(h loff_t *pposh](h)}(hhh]jI)}(hloff_th]hloff_t}(hjRhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjRubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjRmodnameN classnameNjj )}j ]jQc.proc_douintvecasbuh1hhjRubj2)}(h h]h }(hjRhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjRubj)}(hjh]h*}(hjShhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRubjI)}(hpposh]hppos}(hjShhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjRubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjtQubeh}(h]h ]h"]h$]h&]j`jauh1j<hj;QhhhjMQhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj7QhhhjMQhMubah}(h]j2Qah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjMQhMhj4Qhhubjw)}(hhh]h)}(h"read a vector of unsigned integersh]h"read a vector of unsigned integers}(hj;ShhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMhj8Shhubah}(h]h ]h"]h$]h&]uh1jvhj4QhhhjMQhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjSSjjSSjjjuh1jhhhjHEhNhNubj)}(hX**Parameters** ``const struct ctl_table *table`` the sysctl table ``int dir`` ``TRUE`` if this is a write to the sysctl file ``void *buffer`` the user buffer ``size_t *lenp`` the size of the user buffer ``loff_t *ppos`` file position **Description** Reads/writes up to table->maxlen/sizeof(unsigned int) unsigned integer values from/to the user buffer, treated as an ASCII string. **Return** ``0`` on success.h](h)}(h**Parameters**h]j)}(hj]Sh]h Parameters}(hj_ShhhNhNubah}(h]h ]h"]h$]h&]uh1jhj[Subah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMhjWSubj)}(hhh](j)}(h3``const struct ctl_table *table`` the sysctl table h](j)}(h!``const struct ctl_table *table``h]j)}(hj|Sh]hconst struct ctl_table *table}(hj~ShhhNhNubah}(h]h ]h"]h$]h&]uh1jhjzSubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMhjvSubj)}(hhh]h)}(hthe sysctl tableh]hthe sysctl table}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1hhjShMhjSubah}(h]h ]h"]h$]h&]uh1jhjvSubeh}(h]h ]h"]h$]h&]uh1jhjShMhjsSubj)}(h;``int dir`` ``TRUE`` if this is a write to the sysctl file h](j)}(h ``int dir``h]j)}(hjSh]hint dir}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1jhjSubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMhjSubj)}(hhh]h)}(h.``TRUE`` if this is a write to the sysctl fileh](j)}(h``TRUE``h]hTRUE}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1jhjSubh& if this is a write to the sysctl file}(hjShhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjShMhjSubah}(h]h ]h"]h$]h&]uh1jhjSubeh}(h]h ]h"]h$]h&]uh1jhjShMhjsSubj)}(h!``void *buffer`` the user buffer h](j)}(h``void *buffer``h]j)}(hjSh]h void *buffer}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1jhjSubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMhjSubj)}(hhh]h)}(hthe user bufferh]hthe user buffer}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1hhjThMhjTubah}(h]h ]h"]h$]h&]uh1jhjSubeh}(h]h ]h"]h$]h&]uh1jhjThMhjsSubj)}(h-``size_t *lenp`` the size of the user buffer h](j)}(h``size_t *lenp``h]j)}(hj5Th]h size_t *lenp}(hj7ThhhNhNubah}(h]h ]h"]h$]h&]uh1jhj3Tubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMhj/Tubj)}(hhh]h)}(hthe size of the user bufferh]hthe size of the user buffer}(hjNThhhNhNubah}(h]h ]h"]h$]h&]uh1hhjJThMhjKTubah}(h]h ]h"]h$]h&]uh1jhj/Tubeh}(h]h ]h"]h$]h&]uh1jhjJThMhjsSubj)}(h``loff_t *ppos`` file position h](j)}(h``loff_t *ppos``h]j)}(hjnTh]h loff_t *ppos}(hjpThhhNhNubah}(h]h ]h"]h$]h&]uh1jhjlTubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMhjhTubj)}(hhh]h)}(h file positionh]h file position}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1hhjThMhjTubah}(h]h ]h"]h$]h&]uh1jhjhTubeh}(h]h ]h"]h$]h&]uh1jhjThMhjsSubeh}(h]h ]h"]h$]h&]uh1jhjWSubh)}(h**Description**h]j)}(hjTh]h Description}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jhjTubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMhjWSubh)}(hReads/writes up to table->maxlen/sizeof(unsigned int) unsigned integer values from/to the user buffer, treated as an ASCII string.h]hReads/writes up to table->maxlen/sizeof(unsigned int) unsigned integer values from/to the user buffer, treated as an ASCII string.}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMhjWSubh)}(h **Return**h]j)}(hjTh]hReturn}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jhjTubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMhjWSubh)}(h``0`` on success.h](j)}(h``0``h]h0}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jhjTubh on success.}(hjThhhNhNubeh}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMhjWSubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjHEhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j !proc_dointvec_minmax (C function)c.proc_dointvec_minmaxhNtauh1hhjHEhhhNhNubj)}(hhh](j)}(hkint proc_dointvec_minmax (const struct ctl_table *table, int dir, void *buffer, size_t *lenp, loff_t *ppos)h]j)}(hjint proc_dointvec_minmax(const struct ctl_table *table, int dir, void *buffer, size_t *lenp, loff_t *ppos)h](j)}(hinth]hint}(hj#UhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjUhhhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMubj2)}(h h]h }(hj2UhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjUhhhj1UhMubjC)}(hproc_dointvec_minmaxh]jI)}(hproc_dointvec_minmaxh]hproc_dointvec_minmax}(hjDUhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj@Uubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjUhhhj1UhMubj=)}(hR(const struct ctl_table *table, int dir, void *buffer, size_t *lenp, loff_t *ppos)h](jC)}(hconst struct ctl_table *tableh](j )}(hjJh]hconst}(hj`UhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj\Uubj2)}(h h]h }(hjmUhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj\Uubj )}(hjh]hstruct}(hj{UhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj\Uubj2)}(h h]h }(hjUhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj\Uubh)}(hhh]jI)}(h ctl_tableh]h ctl_table}(hjUhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjUubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjUmodnameN classnameNjj )}j ]j)}jjFUsbc.proc_dointvec_minmaxasbuh1hhj\Uubj2)}(h h]h }(hjUhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj\Uubj)}(hjh]h*}(hjUhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\UubjI)}(htableh]htable}(hjUhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj\Uubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjXUubjC)}(hint dirh](j)}(hinth]hint}(hjUhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjUubj2)}(h h]h }(hjUhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjUubjI)}(hdirh]hdir}(hj VhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjUubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjXUubjC)}(h void *bufferh](j)}(hvoidh]hvoid}(hj"VhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVubj2)}(h h]h }(hj0VhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjVubj)}(hjh]h*}(hj>VhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVubjI)}(hbufferh]hbuffer}(hjKVhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjVubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjXUubjC)}(h size_t *lenph](h)}(hhh]jI)}(hsize_th]hsize_t}(hjgVhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjdVubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjiVmodnameN classnameNjj )}j ]jUc.proc_dointvec_minmaxasbuh1hhj`Vubj2)}(h h]h }(hjVhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj`Vubj)}(hjh]h*}(hjVhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj`VubjI)}(hlenph]hlenp}(hjVhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj`Vubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjXUubjC)}(h loff_t *pposh](h)}(hhh]jI)}(hloff_th]hloff_t}(hjVhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjVubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjVmodnameN classnameNjj )}j ]jUc.proc_dointvec_minmaxasbuh1hhjVubj2)}(h h]h }(hjVhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjVubj)}(hjh]h*}(hjVhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVubjI)}(hpposh]hppos}(hjVhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjVubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjXUubeh}(h]h ]h"]h$]h&]j`jauh1j<hjUhhhj1UhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjUhhhj1UhMubah}(h]jUah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj1UhMhjUhhubjw)}(hhh]h)}(h-read a vector of integers with min/max valuesh]h-read a vector of integers with min/max values}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMhjWhhubah}(h]h ]h"]h$]h&]uh1jvhjUhhhj1UhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjj7Wjj7Wjjjuh1jhhhjHEhNhNubj)}(hXa**Parameters** ``const struct ctl_table *table`` the sysctl table ``int dir`` ``TRUE`` if this is a write to the sysctl file ``void *buffer`` the user buffer ``size_t *lenp`` the size of the user buffer ``loff_t *ppos`` file position **Description** Reads/writes up to table->maxlen/sizeof(unsigned int) integer values from/to the user buffer, treated as an ASCII string. This routine will ensure the values are within the range specified by table->extra1 (min) and table->extra2 (max). **Return** ``0`` on success or -EINVAL when the range check fails and SYSCTL_USER_TO_KERN(dir) == trueh](h)}(h**Parameters**h]j)}(hjAWh]h Parameters}(hjCWhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj?Wubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMhj;Wubj)}(hhh](j)}(h3``const struct ctl_table *table`` the sysctl table h](j)}(h!``const struct ctl_table *table``h]j)}(hj`Wh]hconst struct ctl_table *table}(hjbWhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj^Wubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMhjZWubj)}(hhh]h)}(hthe sysctl tableh]hthe sysctl table}(hjyWhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjuWhMhjvWubah}(h]h ]h"]h$]h&]uh1jhjZWubeh}(h]h ]h"]h$]h&]uh1jhjuWhMhjWWubj)}(h;``int dir`` ``TRUE`` if this is a write to the sysctl file h](j)}(h ``int dir``h]j)}(hjWh]hint dir}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjWubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMhjWubj)}(hhh]h)}(h.``TRUE`` if this is a write to the sysctl fileh](j)}(h``TRUE``h]hTRUE}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjWubh& if this is a write to the sysctl file}(hjWhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjWhMhjWubah}(h]h ]h"]h$]h&]uh1jhjWubeh}(h]h ]h"]h$]h&]uh1jhjWhMhjWWubj)}(h!``void *buffer`` the user buffer h](j)}(h``void *buffer``h]j)}(hjWh]h void *buffer}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjWubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMhjWubj)}(hhh]h)}(hthe user bufferh]hthe user buffer}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjWhMhjWubah}(h]h ]h"]h$]h&]uh1jhjWubeh}(h]h ]h"]h$]h&]uh1jhjWhMhjWWubj)}(h-``size_t *lenp`` the size of the user buffer h](j)}(h``size_t *lenp``h]j)}(hjXh]h size_t *lenp}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjXubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMhjXubj)}(hhh]h)}(hthe size of the user bufferh]hthe size of the user buffer}(hj2XhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj.XhMhj/Xubah}(h]h ]h"]h$]h&]uh1jhjXubeh}(h]h ]h"]h$]h&]uh1jhj.XhMhjWWubj)}(h``loff_t *ppos`` file position h](j)}(h``loff_t *ppos``h]j)}(hjRXh]h loff_t *ppos}(hjTXhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjPXubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMhjLXubj)}(hhh]h)}(h file positionh]h file position}(hjkXhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjgXhMhjhXubah}(h]h ]h"]h$]h&]uh1jhjLXubeh}(h]h ]h"]h$]h&]uh1jhjgXhMhjWWubeh}(h]h ]h"]h$]h&]uh1jhj;Wubh)}(h**Description**h]j)}(hjXh]h Description}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjXubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMhj;Wubh)}(hyReads/writes up to table->maxlen/sizeof(unsigned int) integer values from/to the user buffer, treated as an ASCII string.h]hyReads/writes up to table->maxlen/sizeof(unsigned int) integer values from/to the user buffer, treated as an ASCII string.}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMhj;Wubh)}(hrThis routine will ensure the values are within the range specified by table->extra1 (min) and table->extra2 (max).h]hrThis routine will ensure the values are within the range specified by table->extra1 (min) and table->extra2 (max).}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMhj;Wubh)}(h **Return**h]j)}(hjXh]hReturn}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjXubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMhj;Wubh)}(h[``0`` on success or -EINVAL when the range check fails and SYSCTL_USER_TO_KERN(dir) == trueh](j)}(h``0``h]h0}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjXubhV on success or -EINVAL when the range check fails and SYSCTL_USER_TO_KERN(dir) == true}(hjXhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMhj;Wubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjHEhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j "proc_douintvec_minmax (C function)c.proc_douintvec_minmaxhNtauh1hhjHEhhhNhNubj)}(hhh](j)}(hlint proc_douintvec_minmax (const struct ctl_table *table, int dir, void *buffer, size_t *lenp, loff_t *ppos)h]j)}(hkint proc_douintvec_minmax(const struct ctl_table *table, int dir, void *buffer, size_t *lenp, loff_t *ppos)h](j)}(hinth]hint}(hjYhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjYhhhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMubj2)}(h h]h }(hj%YhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjYhhhj$YhMubjC)}(hproc_douintvec_minmaxh]jI)}(hproc_douintvec_minmaxh]hproc_douintvec_minmax}(hj7YhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj3Yubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjYhhhj$YhMubj=)}(hR(const struct ctl_table *table, int dir, void *buffer, size_t *lenp, loff_t *ppos)h](jC)}(hconst struct ctl_table *tableh](j )}(hjJh]hconst}(hjSYhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjOYubj2)}(h h]h }(hj`YhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjOYubj )}(hjh]hstruct}(hjnYhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjOYubj2)}(h h]h }(hj{YhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjOYubh)}(hhh]jI)}(h ctl_tableh]h ctl_table}(hjYhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjYubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjYmodnameN classnameNjj )}j ]j)}jj9Ysbc.proc_douintvec_minmaxasbuh1hhjOYubj2)}(h h]h }(hjYhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjOYubj)}(hjh]h*}(hjYhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjOYubjI)}(htableh]htable}(hjYhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjOYubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjKYubjC)}(hint dirh](j)}(hinth]hint}(hjYhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjYubj2)}(h h]h }(hjYhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjYubjI)}(hdirh]hdir}(hjYhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjYubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjKYubjC)}(h void *bufferh](j)}(hvoidh]hvoid}(hjZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZubj2)}(h h]h }(hj#ZhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjZubj)}(hjh]h*}(hj1ZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZubjI)}(hbufferh]hbuffer}(hj>ZhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjZubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjKYubjC)}(h size_t *lenph](h)}(hhh]jI)}(hsize_th]hsize_t}(hjZZhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjWZubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj\ZmodnameN classnameNjj )}j ]jYc.proc_douintvec_minmaxasbuh1hhjSZubj2)}(h h]h }(hjxZhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjSZubj)}(hjh]h*}(hjZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSZubjI)}(hlenph]hlenp}(hjZhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjSZubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjKYubjC)}(h loff_t *pposh](h)}(hhh]jI)}(hloff_th]hloff_t}(hjZhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjZubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjZmodnameN classnameNjj )}j ]jYc.proc_douintvec_minmaxasbuh1hhjZubj2)}(h h]h }(hjZhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjZubj)}(hjh]h*}(hjZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZubjI)}(hpposh]hppos}(hjZhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjZubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjKYubeh}(h]h ]h"]h$]h&]j`jauh1j<hjYhhhj$YhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjYhhhj$YhMubah}(h]j Yah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj$YhMhj Yhhubjw)}(hhh]h)}(h2read a vector of unsigned ints with min/max valuesh]h2read a vector of unsigned ints with min/max values}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMhj[hhubah}(h]h ]h"]h$]h&]uh1jvhj Yhhhj$YhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjj*[jj*[jjjuh1jhhhjHEhNhNubj)}(hX**Parameters** ``const struct ctl_table *table`` the sysctl table ``int dir`` ``TRUE`` if this is a write to the sysctl file ``void *buffer`` the user buffer ``size_t *lenp`` the size of the user buffer ``loff_t *ppos`` file position **Description** Reads/writes up to table->maxlen/sizeof(unsigned int) unsigned integer values from/to the user buffer, treated as an ASCII string. Negative strings are not allowed. When changing the kernel variable, this routine will ensure the values are within the range specified by table->extra1 (min) and table->extra2 (max). And Check that the values are less than UINT_MAX to avoid having to support wrap around uses from userspace. **Return** ``0`` on success or -ERANGE when range check failes and SYSCTL_USER_TO_KERN(dir) == trueh](h)}(h**Parameters**h]j)}(hj4[h]h Parameters}(hj6[hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj2[ubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMhj.[ubj)}(hhh](j)}(h3``const struct ctl_table *table`` the sysctl table h](j)}(h!``const struct ctl_table *table``h]j)}(hjS[h]hconst struct ctl_table *table}(hjU[hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjQ[ubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMhjM[ubj)}(hhh]h)}(hthe sysctl tableh]hthe sysctl table}(hjl[hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjh[hMhji[ubah}(h]h ]h"]h$]h&]uh1jhjM[ubeh}(h]h ]h"]h$]h&]uh1jhjh[hMhjJ[ubj)}(h;``int dir`` ``TRUE`` if this is a write to the sysctl file h](j)}(h ``int dir``h]j)}(hj[h]hint dir}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj[ubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMhj[ubj)}(hhh]h)}(h.``TRUE`` if this is a write to the sysctl fileh](j)}(h``TRUE``h]hTRUE}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj[ubh& if this is a write to the sysctl file}(hj[hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj[hMhj[ubah}(h]h ]h"]h$]h&]uh1jhj[ubeh}(h]h ]h"]h$]h&]uh1jhj[hMhjJ[ubj)}(h!``void *buffer`` the user buffer h](j)}(h``void *buffer``h]j)}(hj[h]h void *buffer}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj[ubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMhj[ubj)}(hhh]h)}(hthe user bufferh]hthe user buffer}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj[hMhj[ubah}(h]h ]h"]h$]h&]uh1jhj[ubeh}(h]h ]h"]h$]h&]uh1jhj[hMhjJ[ubj)}(h-``size_t *lenp`` the size of the user buffer h](j)}(h``size_t *lenp``h]j)}(hj \h]h size_t *lenp}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj \ubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMhj\ubj)}(hhh]h)}(hthe size of the user bufferh]hthe size of the user buffer}(hj%\hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj!\hMhj"\ubah}(h]h ]h"]h$]h&]uh1jhj\ubeh}(h]h ]h"]h$]h&]uh1jhj!\hMhjJ[ubj)}(h``loff_t *ppos`` file position h](j)}(h``loff_t *ppos``h]j)}(hjE\h]h loff_t *ppos}(hjG\hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjC\ubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMhj?\ubj)}(hhh]h)}(h file positionh]h file position}(hj^\hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjZ\hMhj[\ubah}(h]h ]h"]h$]h&]uh1jhj?\ubeh}(h]h ]h"]h$]h&]uh1jhjZ\hMhjJ[ubeh}(h]h ]h"]h$]h&]uh1jhj.[ubh)}(h**Description**h]j)}(hj\h]h Description}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj~\ubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMhj.[ubh)}(hReads/writes up to table->maxlen/sizeof(unsigned int) unsigned integer values from/to the user buffer, treated as an ASCII string. Negative strings are not allowed.h]hReads/writes up to table->maxlen/sizeof(unsigned int) unsigned integer values from/to the user buffer, treated as an ASCII string. Negative strings are not allowed.}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMhj.[ubh)}(hXWhen changing the kernel variable, this routine will ensure the values are within the range specified by table->extra1 (min) and table->extra2 (max). And Check that the values are less than UINT_MAX to avoid having to support wrap around uses from userspace.h]hXWhen changing the kernel variable, this routine will ensure the values are within the range specified by table->extra1 (min) and table->extra2 (max). And Check that the values are less than UINT_MAX to avoid having to support wrap around uses from userspace.}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMhj.[ubh)}(h **Return**h]j)}(hj\h]hReturn}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj\ubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMhj.[ubh)}(hX``0`` on success or -ERANGE when range check failes and SYSCTL_USER_TO_KERN(dir) == trueh](j)}(h``0``h]h0}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj\ubhS on success or -ERANGE when range check failes and SYSCTL_USER_TO_KERN(dir) == true}(hj\hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMhj.[ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjHEhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j  proc_dou8vec_minmax (C function)c.proc_dou8vec_minmaxhNtauh1hhjHEhhhNhNubj)}(hhh](j)}(hjint proc_dou8vec_minmax (const struct ctl_table *table, int dir, void *buffer, size_t *lenp, loff_t *ppos)h]j)}(hiint proc_dou8vec_minmax(const struct ctl_table *table, int dir, void *buffer, size_t *lenp, loff_t *ppos)h](j)}(hinth]hint}(hj ]hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj]hhhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMubj2)}(h h]h }(hj]hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj]hhhj]hMubjC)}(hproc_dou8vec_minmaxh]jI)}(hproc_dou8vec_minmaxh]hproc_dou8vec_minmax}(hj*]hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj&]ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj]hhhj]hMubj=)}(hR(const struct ctl_table *table, int dir, void *buffer, size_t *lenp, loff_t *ppos)h](jC)}(hconst struct ctl_table *tableh](j )}(hjJh]hconst}(hjF]hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjB]ubj2)}(h h]h }(hjS]hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjB]ubj )}(hjh]hstruct}(hja]hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjB]ubj2)}(h h]h }(hjn]hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjB]ubh)}(hhh]jI)}(h ctl_tableh]h ctl_table}(hj]hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj|]ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj]modnameN classnameNjj )}j ]j)}jj,]sbc.proc_dou8vec_minmaxasbuh1hhjB]ubj2)}(h h]h }(hj]hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjB]ubj)}(hjh]h*}(hj]hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjB]ubjI)}(htableh]htable}(hj]hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjB]ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj>]ubjC)}(hint dirh](j)}(hinth]hint}(hj]hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj]ubj2)}(h h]h }(hj]hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj]ubjI)}(hdirh]hdir}(hj]hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj]ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj>]ubjC)}(h void *bufferh](j)}(hvoidh]hvoid}(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^ubj2)}(h h]h }(hj^hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj^ubj)}(hjh]h*}(hj$^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^ubjI)}(hbufferh]hbuffer}(hj1^hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj^ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj>]ubjC)}(h size_t *lenph](h)}(hhh]jI)}(hsize_th]hsize_t}(hjM^hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjJ^ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjO^modnameN classnameNjj )}j ]j]c.proc_dou8vec_minmaxasbuh1hhjF^ubj2)}(h h]h }(hjk^hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjF^ubj)}(hjh]h*}(hjy^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjF^ubjI)}(hlenph]hlenp}(hj^hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjF^ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj>]ubjC)}(h loff_t *pposh](h)}(hhh]jI)}(hloff_th]hloff_t}(hj^hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj^ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj^modnameN classnameNjj )}j ]j]c.proc_dou8vec_minmaxasbuh1hhj^ubj2)}(h h]h }(hj^hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj^ubj)}(hjh]h*}(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^ubjI)}(hpposh]hppos}(hj^hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj^ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj>]ubeh}(h]h ]h"]h$]h&]j`jauh1j<hj]hhhj]hMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj]hhhj]hMubah}(h]j\ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj]hMhj\hhubjw)}(hhh]h)}(h3read a vector of unsigned chars with min/max valuesh]h3read a vector of unsigned chars with min/max values}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMhj_hhubah}(h]h ]h"]h$]h&]uh1jvhj\hhhj]hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjj_jj_jjjuh1jhhhjHEhNhNubj)}(hX**Parameters** ``const struct ctl_table *table`` the sysctl table ``int dir`` ``TRUE`` if this is a write to the sysctl file ``void *buffer`` the user buffer ``size_t *lenp`` the size of the user buffer ``loff_t *ppos`` file position **Description** Reads/writes up to table->maxlen/sizeof(u8) unsigned chars values from/to the user buffer, treated as an ASCII string. Negative strings are not allowed. This routine will ensure the values are within the range specified by table->extra1 (min) and table->extra2 (max). **Return** ``0`` on success or an error on SYSCTL_USER_TO_KERN(dir) == true and the range check fails.h](h)}(h**Parameters**h]j)}(hj'_h]h Parameters}(hj)_hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj%_ubah}(h]h ]h"]h$]h&]uh1hh$X/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMhj!_ubj)}(hhh](j)}(h3``const struct ctl_table *table`` the sysctl table h](j)}(h!``const struct ctl_table *table``h]j)}(hjF_h]hconst struct ctl_table *table}(hjH_hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjD_ubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMhj@_ubj)}(hhh]h)}(hthe sysctl tableh]hthe sysctl table}(hj__hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj[_hMhj\_ubah}(h]h ]h"]h$]h&]uh1jhj@_ubeh}(h]h ]h"]h$]h&]uh1jhj[_hMhj=_ubj)}(h;``int dir`` ``TRUE`` if this is a write to the sysctl file h](j)}(h ``int dir``h]j)}(hj_h]hint dir}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj}_ubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMhjy_ubj)}(hhh]h)}(h.``TRUE`` if this is a write to the sysctl fileh](j)}(h``TRUE``h]hTRUE}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj_ubh& if this is a write to the sysctl file}(hj_hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj_hMhj_ubah}(h]h ]h"]h$]h&]uh1jhjy_ubeh}(h]h ]h"]h$]h&]uh1jhj_hMhj=_ubj)}(h!``void *buffer`` the user buffer h](j)}(h``void *buffer``h]j)}(hj_h]h void *buffer}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj_ubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMhj_ubj)}(hhh]h)}(hthe user bufferh]hthe user buffer}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj_hMhj_ubah}(h]h ]h"]h$]h&]uh1jhj_ubeh}(h]h ]h"]h$]h&]uh1jhj_hMhj=_ubj)}(h-``size_t *lenp`` the size of the user buffer h](j)}(h``size_t *lenp``h]j)}(hj_h]h size_t *lenp}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj_ubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMhj_ubj)}(hhh]h)}(hthe size of the user bufferh]hthe size of the user buffer}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj`hMhj`ubah}(h]h ]h"]h$]h&]uh1jhj_ubeh}(h]h ]h"]h$]h&]uh1jhj`hMhj=_ubj)}(h``loff_t *ppos`` file position h](j)}(h``loff_t *ppos``h]j)}(hj8`h]h loff_t *ppos}(hj:`hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj6`ubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMhj2`ubj)}(hhh]h)}(h file positionh]h file position}(hjQ`hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjM`hMhjN`ubah}(h]h ]h"]h$]h&]uh1jhj2`ubeh}(h]h ]h"]h$]h&]uh1jhjM`hMhj=_ubeh}(h]h ]h"]h$]h&]uh1jhj!_ubh)}(h**Description**h]j)}(hjs`h]h Description}(hju`hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjq`ubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMhj!_ubh)}(hReads/writes up to table->maxlen/sizeof(u8) unsigned chars values from/to the user buffer, treated as an ASCII string. Negative strings are not allowed.h]hReads/writes up to table->maxlen/sizeof(u8) unsigned chars values from/to the user buffer, treated as an ASCII string. Negative strings are not allowed.}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMhj!_ubh)}(hrThis routine will ensure the values are within the range specified by table->extra1 (min) and table->extra2 (max).h]hrThis routine will ensure the values are within the range specified by table->extra1 (min) and table->extra2 (max).}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMhj!_ubh)}(h **Return**h]j)}(hj`h]hReturn}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj`ubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMhj!_ubh)}(h[``0`` on success or an error on SYSCTL_USER_TO_KERN(dir) == true and the range check fails.h](j)}(h``0``h]h0}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj`ubhV on success or an error on SYSCTL_USER_TO_KERN(dir) == true and the range check fails.}(hj`hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMhj!_ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjHEhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j #proc_doulongvec_minmax (C function)c.proc_doulongvec_minmaxhNtauh1hhjHEhhhNhNubj)}(hhh](j)}(hmint proc_doulongvec_minmax (const struct ctl_table *table, int dir, void *buffer, size_t *lenp, loff_t *ppos)h]j)}(hlint proc_doulongvec_minmax(const struct ctl_table *table, int dir, void *buffer, size_t *lenp, loff_t *ppos)h](j)}(hinth]hint}(hj`hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj`hhhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMuubj2)}(h h]h }(hj ahhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj`hhhj ahMuubjC)}(hproc_doulongvec_minmaxh]jI)}(hproc_doulongvec_minmaxh]hproc_doulongvec_minmax}(hjahhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjaubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj`hhhj ahMuubj=)}(hR(const struct ctl_table *table, int dir, void *buffer, size_t *lenp, loff_t *ppos)h](jC)}(hconst struct ctl_table *tableh](j )}(hjJh]hconst}(hj9ahhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj5aubj2)}(h h]h }(hjFahhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj5aubj )}(hjh]hstruct}(hjTahhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj5aubj2)}(h h]h }(hjaahhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj5aubh)}(hhh]jI)}(h ctl_tableh]h ctl_table}(hjrahhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjoaubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjtamodnameN classnameNjj )}j ]j)}jjasbc.proc_doulongvec_minmaxasbuh1hhj5aubj2)}(h h]h }(hjahhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj5aubj)}(hjh]h*}(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5aubjI)}(htableh]htable}(hjahhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj5aubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj1aubjC)}(hint dirh](j)}(hinth]hint}(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubj2)}(h h]h }(hjahhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjaubjI)}(hdirh]hdir}(hjahhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjaubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj1aubjC)}(h void *bufferh](j)}(hvoidh]hvoid}(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubj2)}(h h]h }(hj bhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjaubj)}(hjh]h*}(hjbhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubjI)}(hbufferh]hbuffer}(hj$bhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjaubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj1aubjC)}(h size_t *lenph](h)}(hhh]jI)}(hsize_th]hsize_t}(hj@bhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj=bubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjBbmodnameN classnameNjj )}j ]jac.proc_doulongvec_minmaxasbuh1hhj9bubj2)}(h h]h }(hj^bhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj9bubj)}(hjh]h*}(hjlbhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9bubjI)}(hlenph]hlenp}(hjybhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj9bubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj1aubjC)}(h loff_t *pposh](h)}(hhh]jI)}(hloff_th]hloff_t}(hjbhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjbubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjbmodnameN classnameNjj )}j ]jac.proc_doulongvec_minmaxasbuh1hhjbubj2)}(h h]h }(hjbhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjbubj)}(hjh]h*}(hjbhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjbubjI)}(hpposh]hppos}(hjbhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjbubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj1aubeh}(h]h ]h"]h$]h&]j`jauh1j<hj`hhhj ahMuubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj`hhhj ahMuubah}(h]j`ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj ahMuhj`hhubjw)}(hhh]h)}(h2read a vector of long integers with min/max valuesh]h2read a vector of long integers with min/max values}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMuhjbhhubah}(h]h ]h"]h$]h&]uh1jvhj`hhhj ahMuubeh}(h]h ](jfunctioneh"]h$]h&]jjjjcjjcjjjuh1jhhhjHEhNhNubj)}(hX**Parameters** ``const struct ctl_table *table`` the sysctl table ``int dir`` ``TRUE`` if this is a write to the sysctl file ``void *buffer`` the user buffer ``size_t *lenp`` the size of the user buffer ``loff_t *ppos`` file position **Description** Reads/writes up to table->maxlen/sizeof(unsigned long) unsigned long values from/to the user buffer, treated as an ASCII string. This routine will ensure the values are within the range specified by table->extra1 (min) and table->extra2 (max). **Return** ``0`` on success.h](h)}(h**Parameters**h]j)}(hjch]h Parameters}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jhjcubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMyhjcubj)}(hhh](j)}(h3``const struct ctl_table *table`` the sysctl table h](j)}(h!``const struct ctl_table *table``h]j)}(hj9ch]hconst struct ctl_table *table}(hj;chhhNhNubah}(h]h ]h"]h$]h&]uh1jhj7cubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMvhj3cubj)}(hhh]h)}(hthe sysctl tableh]hthe sysctl table}(hjRchhhNhNubah}(h]h ]h"]h$]h&]uh1hhjNchMvhjOcubah}(h]h ]h"]h$]h&]uh1jhj3cubeh}(h]h ]h"]h$]h&]uh1jhjNchMvhj0cubj)}(h;``int dir`` ``TRUE`` if this is a write to the sysctl file h](j)}(h ``int dir``h]j)}(hjrch]hint dir}(hjtchhhNhNubah}(h]h ]h"]h$]h&]uh1jhjpcubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMwhjlcubj)}(hhh]h)}(h.``TRUE`` if this is a write to the sysctl fileh](j)}(h``TRUE``h]hTRUE}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jhjcubh& if this is a write to the sysctl file}(hjchhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjchMwhjcubah}(h]h ]h"]h$]h&]uh1jhjlcubeh}(h]h ]h"]h$]h&]uh1jhjchMwhj0cubj)}(h!``void *buffer`` the user buffer h](j)}(h``void *buffer``h]j)}(hjch]h void *buffer}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jhjcubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMxhjcubj)}(hhh]h)}(hthe user bufferh]hthe user buffer}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1hhjchMxhjcubah}(h]h ]h"]h$]h&]uh1jhjcubeh}(h]h ]h"]h$]h&]uh1jhjchMxhj0cubj)}(h-``size_t *lenp`` the size of the user buffer h](j)}(h``size_t *lenp``h]j)}(hjch]h size_t *lenp}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jhjcubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMyhjcubj)}(hhh]h)}(hthe size of the user bufferh]hthe size of the user buffer}(hj dhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjdhMyhjdubah}(h]h ]h"]h$]h&]uh1jhjcubeh}(h]h ]h"]h$]h&]uh1jhjdhMyhj0cubj)}(h``loff_t *ppos`` file position h](j)}(h``loff_t *ppos``h]j)}(hj+dh]h loff_t *ppos}(hj-dhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj)dubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMzhj%dubj)}(hhh]h)}(h file positionh]h file position}(hjDdhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj@dhMzhjAdubah}(h]h ]h"]h$]h&]uh1jhj%dubeh}(h]h ]h"]h$]h&]uh1jhj@dhMzhj0cubeh}(h]h ]h"]h$]h&]uh1jhjcubh)}(h**Description**h]j)}(hjfdh]h Description}(hjhdhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjddubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chM|hjcubh)}(hReads/writes up to table->maxlen/sizeof(unsigned long) unsigned long values from/to the user buffer, treated as an ASCII string.h]hReads/writes up to table->maxlen/sizeof(unsigned long) unsigned long values from/to the user buffer, treated as an ASCII string.}(hj|dhhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chM{hjcubh)}(hrThis routine will ensure the values are within the range specified by table->extra1 (min) and table->extra2 (max).h]hrThis routine will ensure the values are within the range specified by table->extra1 (min) and table->extra2 (max).}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chM~hjcubh)}(h **Return**h]j)}(hjdh]hReturn}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjdubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMhjcubh)}(h``0`` on success.h](j)}(h``0``h]h0}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjdubh on success.}(hjdhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMhjcubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjHEhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j !proc_do_large_bitmap (C function)c.proc_do_large_bitmaphNtauh1hhjHEhhhNhNubj)}(hhh](j)}(hkint proc_do_large_bitmap (const struct ctl_table *table, int dir, void *buffer, size_t *lenp, loff_t *ppos)h]j)}(hjint proc_do_large_bitmap(const struct ctl_table *table, int dir, void *buffer, size_t *lenp, loff_t *ppos)h](j)}(hinth]hint}(hjdhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjdhhhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMubj2)}(h h]h }(hjdhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjdhhhjdhMubjC)}(hproc_do_large_bitmaph]jI)}(hproc_do_large_bitmaph]hproc_do_large_bitmap}(hjehhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj eubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjdhhhjdhMubj=)}(hR(const struct ctl_table *table, int dir, void *buffer, size_t *lenp, loff_t *ppos)h](jC)}(hconst struct ctl_table *tableh](j )}(hjJh]hconst}(hj,ehhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj(eubj2)}(h h]h }(hj9ehhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj(eubj )}(hjh]hstruct}(hjGehhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj(eubj2)}(h h]h }(hjTehhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj(eubh)}(hhh]jI)}(h ctl_tableh]h ctl_table}(hjeehhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjbeubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjgemodnameN classnameNjj )}j ]j)}jjesbc.proc_do_large_bitmapasbuh1hhj(eubj2)}(h h]h }(hjehhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj(eubj)}(hjh]h*}(hjehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(eubjI)}(htableh]htable}(hjehhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj(eubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj$eubjC)}(hint dirh](j)}(hinth]hint}(hjehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubj2)}(h h]h }(hjehhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjeubjI)}(hdirh]hdir}(hjehhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjeubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj$eubjC)}(h void *bufferh](j)}(hvoidh]hvoid}(hjehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubj2)}(h h]h }(hjehhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjeubj)}(hjh]h*}(hj fhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubjI)}(hbufferh]hbuffer}(hjfhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjeubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj$eubjC)}(h size_t *lenph](h)}(hhh]jI)}(hsize_th]hsize_t}(hj3fhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj0fubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj5fmodnameN classnameNjj )}j ]jec.proc_do_large_bitmapasbuh1hhj,fubj2)}(h h]h }(hjQfhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj,fubj)}(hjh]h*}(hj_fhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,fubjI)}(hlenph]hlenp}(hjlfhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj,fubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj$eubjC)}(h loff_t *pposh](h)}(hhh]jI)}(hloff_th]hloff_t}(hjfhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjfubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjfmodnameN classnameNjj )}j ]jec.proc_do_large_bitmapasbuh1hhjfubj2)}(h h]h }(hjfhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjfubj)}(hjh]h*}(hjfhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjfubjI)}(hpposh]hppos}(hjfhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjfubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj$eubeh}(h]h ]h"]h$]h&]j`jauh1j<hjdhhhjdhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjdhhhjdhMubah}(h]jdah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjdhMhjdhhubjw)}(hhh]h)}(h!read/write from/to a large bitmaph]h!read/write from/to a large bitmap}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMhjfhhubah}(h]h ]h"]h$]h&]uh1jvhjdhhhjdhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjgjjgjjjuh1jhhhjHEhNhNubj)}(hXH**Parameters** ``const struct ctl_table *table`` the sysctl table ``int dir`` ``TRUE`` if this is a write to the sysctl file ``void *buffer`` the user buffer ``size_t *lenp`` the size of the user buffer ``loff_t *ppos`` file position **Description** The bitmap is stored at table->data and the bitmap length (in bits) in table->maxlen. We use a range comma separated format (e.g. 1,3-4,10-10) so that large bitmaps may be represented in a compact manner. Writing into the file will clear the bitmap then update it with the given input. **Return** ``0`` on success.h](h)}(h**Parameters**h]j)}(hj gh]h Parameters}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1jhj gubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMhjgubj)}(hhh](j)}(h3``const struct ctl_table *table`` the sysctl table h](j)}(h!``const struct ctl_table *table``h]j)}(hj,gh]hconst struct ctl_table *table}(hj.ghhhNhNubah}(h]h ]h"]h$]h&]uh1jhj*gubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMhj&gubj)}(hhh]h)}(hthe sysctl tableh]hthe sysctl table}(hjEghhhNhNubah}(h]h ]h"]h$]h&]uh1hhjAghMhjBgubah}(h]h ]h"]h$]h&]uh1jhj&gubeh}(h]h ]h"]h$]h&]uh1jhjAghMhj#gubj)}(h;``int dir`` ``TRUE`` if this is a write to the sysctl file h](j)}(h ``int dir``h]j)}(hjegh]hint dir}(hjgghhhNhNubah}(h]h ]h"]h$]h&]uh1jhjcgubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMhj_gubj)}(hhh]h)}(h.``TRUE`` if this is a write to the sysctl fileh](j)}(h``TRUE``h]hTRUE}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1jhj~gubh& if this is a write to the sysctl file}(hj~ghhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjzghMhj{gubah}(h]h ]h"]h$]h&]uh1jhj_gubeh}(h]h ]h"]h$]h&]uh1jhjzghMhj#gubj)}(h!``void *buffer`` the user buffer h](j)}(h``void *buffer``h]j)}(hjgh]h void *buffer}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1jhjgubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMhjgubj)}(hhh]h)}(hthe user bufferh]hthe user buffer}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1hhjghMhjgubah}(h]h ]h"]h$]h&]uh1jhjgubeh}(h]h ]h"]h$]h&]uh1jhjghMhj#gubj)}(h-``size_t *lenp`` the size of the user buffer h](j)}(h``size_t *lenp``h]j)}(hjgh]h size_t *lenp}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1jhjgubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMhjgubj)}(hhh]h)}(hthe size of the user bufferh]hthe size of the user buffer}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1hhjghMhjgubah}(h]h ]h"]h$]h&]uh1jhjgubeh}(h]h ]h"]h$]h&]uh1jhjghMhj#gubj)}(h``loff_t *ppos`` file position h](j)}(h``loff_t *ppos``h]j)}(hjhh]h loff_t *ppos}(hj hhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjhubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMhjhubj)}(hhh]h)}(h file positionh]h file position}(hj7hhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj3hhMhj4hubah}(h]h ]h"]h$]h&]uh1jhjhubeh}(h]h ]h"]h$]h&]uh1jhj3hhMhj#gubeh}(h]h ]h"]h$]h&]uh1jhjgubh)}(h**Description**h]j)}(hjYhh]h Description}(hj[hhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjWhubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMhjgubh)}(hUThe bitmap is stored at table->data and the bitmap length (in bits) in table->maxlen.h]hUThe bitmap is stored at table->data and the bitmap length (in bits) in table->maxlen.}(hjohhhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMhjgubh)}(hWe use a range comma separated format (e.g. 1,3-4,10-10) so that large bitmaps may be represented in a compact manner. Writing into the file will clear the bitmap then update it with the given input.h]hWe use a range comma separated format (e.g. 1,3-4,10-10) so that large bitmaps may be represented in a compact manner. Writing into the file will clear the bitmap then update it with the given input.}(hj~hhhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMhjgubh)}(h **Return**h]j)}(hjhh]hReturn}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjhubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMhjgubh)}(h``0`` on success.h](j)}(h``0``h]h0}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjhubh on success.}(hjhhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:110: ./kernel/sysctl.chMhjgubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjHEhhhNhNubeh}(h]sysctl-interfaceah ]h"]sysctl interfaceah$]h&]uh1hhj7EhhhhhKlubh)}(hhh](h)}(hproc filesystem interfaceh]hproc filesystem interface}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhhKrubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j proc_flush_pid (C function)c.proc_flush_pidhNtauh1hhjhhhhNhNubj)}(hhh](j)}(h%void proc_flush_pid (struct pid *pid)h]j)}(h$void proc_flush_pid(struct pid *pid)h](j)}(hvoidh]hvoid}(hjhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:116: ./fs/proc/base.chMn ubj2)}(h h]h }(hj ihhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhhj ihMn ubjC)}(hproc_flush_pidh]jI)}(hproc_flush_pidh]hproc_flush_pid}(hjihhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjiubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhhj ihMn ubj=)}(h(struct pid *pid)h]jC)}(hstruct pid *pidh](j )}(hjh]hstruct}(hj8ihhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj4iubj2)}(h h]h }(hjEihhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj4iubh)}(hhh]jI)}(hpidh]hpid}(hjVihhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjSiubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjXimodnameN classnameNjj )}j ]j)}jjisbc.proc_flush_pidasbuh1hhj4iubj2)}(h h]h }(hjvihhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj4iubj)}(hjh]h*}(hjihhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4iubjI)}(hpidh]hpid}(hjihhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj4iubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj0iubah}(h]h ]h"]h$]h&]j`jauh1j<hjhhhhj ihMn ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhhj ihMn ubah}(h]jhah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj ihMn hjhhhubjw)}(hhh]h)}(h8Remove dcache entries for **pid** from the /proc dcache.h](hRemove dcache entries for }(hjihhhNhNubj)}(h**pid**h]hpid}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1jhjiubh from the /proc dcache.}(hjihhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:116: ./fs/proc/base.chMn hjihhubah}(h]h ]h"]h$]h&]uh1jvhjhhhhj ihMn ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjijjijjjuh1jhhhjhhNhNubj)}(hX**Parameters** ``struct pid *pid`` pid that should be flushed. **Description** This function walks a list of inodes (that belong to any proc filesystem) that are attached to the pid and flushes them from the dentry cache. It is safe and reasonable to cache /proc entries for a task until that task exits. After that they just clog up the dcache with useless entries, possibly causing useful dcache entries to be flushed instead. This routine is provided to flush those useless dcache entries when a process is reaped. **NOTE** This routine is just an optimization so it does not guarantee that no dcache entries will exist after a process is reaped it just makes it very unlikely that any will persist.h](h)}(h**Parameters**h]j)}(hjih]h Parameters}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1jhjiubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:116: ./fs/proc/base.chMr hjiubj)}(hhh]j)}(h0``struct pid *pid`` pid that should be flushed. h](j)}(h``struct pid *pid``h]j)}(hjjh]hstruct pid *pid}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj jubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:116: ./fs/proc/base.chMo hjjubj)}(hhh]h)}(hpid that should be flushed.h]hpid that should be flushed.}(hj'jhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj#jhMo hj$jubah}(h]h ]h"]h$]h&]uh1jhjjubeh}(h]h ]h"]h$]h&]uh1jhj#jhMo hjjubah}(h]h ]h"]h$]h&]uh1jhjiubh)}(h**Description**h]j)}(hjIjh]h Description}(hjKjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjGjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:116: ./fs/proc/base.chMq hjiubh)}(hThis function walks a list of inodes (that belong to any proc filesystem) that are attached to the pid and flushes them from the dentry cache.h]hThis function walks a list of inodes (that belong to any proc filesystem) that are attached to the pid and flushes them from the dentry cache.}(hj_jhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:116: ./fs/proc/base.chMp hjiubh)}(hX)It is safe and reasonable to cache /proc entries for a task until that task exits. After that they just clog up the dcache with useless entries, possibly causing useful dcache entries to be flushed instead. This routine is provided to flush those useless dcache entries when a process is reaped.h]hX)It is safe and reasonable to cache /proc entries for a task until that task exits. After that they just clog up the dcache with useless entries, possibly causing useful dcache entries to be flushed instead. This routine is provided to flush those useless dcache entries when a process is reaped.}(hjnjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:116: ./fs/proc/base.chMt hjiubh)}(h**NOTE**h]j)}(hjjh]hNOTE}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj}jubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:116: ./fs/proc/base.chMz hjiubj)}(hhh]j)}(hThis routine is just an optimization so it does not guarantee that no dcache entries will exist after a process is reaped it just makes it very unlikely that any will persist.h](j)}(h=This routine is just an optimization so it does not guaranteeh]h=This routine is just an optimization so it does not guarantee}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:116: ./fs/proc/base.chM| hjjubj)}(hhh]h)}(hqthat no dcache entries will exist after a process is reaped it just makes it very unlikely that any will persist.h]hqthat no dcache entries will exist after a process is reaped it just makes it very unlikely that any will persist.}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjjhM| hjjubah}(h]h ]h"]h$]h&]uh1jhjjubeh}(h]h ]h"]h$]h&]uh1jhjjhM| hjjubah}(h]h ]h"]h$]h&]uh1jhjiubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhhNhNubeh}(h]proc-filesystem-interfaceah ]h"]proc filesystem interfaceah$]h&]uh1hhj7EhhhhhKrubeh}(h]the-proc-filesystemah ]h"]the proc filesystemah$]h&]uh1hhhhhhhhKiubh)}(hhh](h)}(h Events based on file descriptorsh]h Events based on file descriptors}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjjhhhhhKxubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j  eventfd_signal_mask (C function)c.eventfd_signal_maskhNtauh1hhjjhhhNhNubj)}(hhh](j)}(hAvoid eventfd_signal_mask (struct eventfd_ctx *ctx, __poll_t mask)h]j)}(h@void eventfd_signal_mask(struct eventfd_ctx *ctx, __poll_t mask)h](j)}(hvoidh]hvoid}(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj khhhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:122: ./fs/eventfd.chK/ubj2)}(h h]h }(hjkhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj khhhjkhK/ubjC)}(heventfd_signal_maskh]jI)}(heventfd_signal_maskh]heventfd_signal_mask}(hj0khhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj,kubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj khhhjkhK/ubj=)}(h((struct eventfd_ctx *ctx, __poll_t mask)h](jC)}(hstruct eventfd_ctx *ctxh](j )}(hjh]hstruct}(hjLkhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjHkubj2)}(h h]h }(hjYkhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjHkubh)}(hhh]jI)}(h eventfd_ctxh]h eventfd_ctx}(hjjkhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjgkubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjlkmodnameN classnameNjj )}j ]j)}jj2ksbc.eventfd_signal_maskasbuh1hhjHkubj2)}(h h]h }(hjkhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjHkubj)}(hjh]h*}(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHkubjI)}(hctxh]hctx}(hjkhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjHkubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjDkubjC)}(h __poll_t maskh](h)}(hhh]jI)}(h__poll_th]h__poll_t}(hjkhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjkubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjkmodnameN classnameNjj )}j ]jkc.eventfd_signal_maskasbuh1hhjkubj2)}(h h]h }(hjkhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjkubjI)}(hmaskh]hmask}(hjkhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjkubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjDkubeh}(h]h ]h"]h$]h&]j`jauh1j<hj khhhjkhK/ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjkhhhjkhK/ubah}(h]jkah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjkhK/hjkhhubjw)}(hhh]h)}(hIncrement the event counterh]hIncrement the event counter}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:122: ./fs/eventfd.chK/hjlhhubah}(h]h ]h"]h$]h&]uh1jvhjkhhhjkhK/ubeh}(h]h ](jfunctioneh"]h$]h&]jjjj/ljj/ljjjuh1jhhhjjhNhNubj)}(hXt**Parameters** ``struct eventfd_ctx *ctx`` [in] Pointer to the eventfd context. ``__poll_t mask`` [in] poll mask **Description** This function is supposed to be called by the kernel in paths that do not allow sleeping. In this function we allow the counter to reach the ULLONG_MAX value, and we signal this as overflow condition by returning a EPOLLERR to poll(2).h](h)}(h**Parameters**h]j)}(hj9lh]h Parameters}(hj;lhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj7lubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:122: ./fs/eventfd.chK3hj3lubj)}(hhh](j)}(hA``struct eventfd_ctx *ctx`` [in] Pointer to the eventfd context. h](j)}(h``struct eventfd_ctx *ctx``h]j)}(hjXlh]hstruct eventfd_ctx *ctx}(hjZlhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjVlubah}(h]h ]h"]h$]h&]uh1jhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:122: ./fs/eventfd.chK0hjRlubj)}(hhh]h)}(h$[in] Pointer to the eventfd context.h]h$[in] Pointer to the eventfd context.}(hjqlhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjmlhK0hjnlubah}(h]h ]h"]h$]h&]uh1jhjRlubeh}(h]h ]h"]h$]h&]uh1jhjmlhK0hjOlubj)}(h!``__poll_t mask`` [in] poll mask h](j)}(h``__poll_t mask``h]j)}(hjlh]h __poll_t mask}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjlubah}(h]h ]h"]h$]h&]uh1jhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:122: ./fs/eventfd.chK1hjlubj)}(hhh]h)}(h[in] poll maskh]h[in] poll mask}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjlhK1hjlubah}(h]h ]h"]h$]h&]uh1jhjlubeh}(h]h ]h"]h$]h&]uh1jhjlhK1hjOlubeh}(h]h ]h"]h$]h&]uh1jhj3lubh)}(h**Description**h]j)}(hjlh]h Description}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjlubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:122: ./fs/eventfd.chK3hj3lubh)}(hThis function is supposed to be called by the kernel in paths that do not allow sleeping. In this function we allow the counter to reach the ULLONG_MAX value, and we signal this as overflow condition by returning a EPOLLERR to poll(2).h]hThis function is supposed to be called by the kernel in paths that do not allow sleeping. In this function we allow the counter to reach the ULLONG_MAX value, and we signal this as overflow condition by returning a EPOLLERR to poll(2).}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:122: ./fs/eventfd.chK2hj3lubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j eventfd_ctx_put (C function)c.eventfd_ctx_puthNtauh1hhjjhhhNhNubj)}(hhh](j)}(h.void eventfd_ctx_put (struct eventfd_ctx *ctx)h]j)}(h-void eventfd_ctx_put(struct eventfd_ctx *ctx)h](j)}(hvoidh]hvoid}(hjmhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj mhhhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:122: ./fs/eventfd.chKaubj2)}(h h]h }(hj mhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj mhhhjmhKaubjC)}(heventfd_ctx_puth]jI)}(heventfd_ctx_puth]heventfd_ctx_put}(hj2mhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj.mubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj mhhhjmhKaubj=)}(h(struct eventfd_ctx *ctx)h]jC)}(hstruct eventfd_ctx *ctxh](j )}(hjh]hstruct}(hjNmhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjJmubj2)}(h h]h }(hj[mhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjJmubh)}(hhh]jI)}(h eventfd_ctxh]h eventfd_ctx}(hjlmhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjimubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjnmmodnameN classnameNjj )}j ]j)}jj4msbc.eventfd_ctx_putasbuh1hhjJmubj2)}(h h]h }(hjmhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjJmubj)}(hjh]h*}(hjmhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJmubjI)}(hctxh]hctx}(hjmhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjJmubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjFmubah}(h]h ]h"]h$]h&]j`jauh1j<hj mhhhjmhKaubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj mhhhjmhKaubah}(h]jmah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjmhKahjmhhubjw)}(hhh]h)}(h5Releases a reference to the internal eventfd context.h]h5Releases a reference to the internal eventfd context.}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:122: ./fs/eventfd.chKahjmhhubah}(h]h ]h"]h$]h&]uh1jvhjmhhhjmhKaubeh}(h]h ](jfunctioneh"]h$]h&]jjjjmjjmjjjuh1jhhhjjhNhNubj)}(h**Parameters** ``struct eventfd_ctx *ctx`` [in] Pointer to eventfd context. **Description** The eventfd context reference must have been previously acquired either with eventfd_ctx_fdget() or eventfd_ctx_fileget().h](h)}(h**Parameters**h]j)}(hjmh]h Parameters}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjmubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:122: ./fs/eventfd.chKehjmubj)}(hhh]j)}(h=``struct eventfd_ctx *ctx`` [in] Pointer to eventfd context. h](j)}(h``struct eventfd_ctx *ctx``h]j)}(hjnh]hstruct eventfd_ctx *ctx}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjnubah}(h]h ]h"]h$]h&]uh1jhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:122: ./fs/eventfd.chKbhj nubj)}(hhh]h)}(h [in] Pointer to eventfd context.h]h [in] Pointer to eventfd context.}(hj+nhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj'nhKbhj(nubah}(h]h ]h"]h$]h&]uh1jhj nubeh}(h]h ]h"]h$]h&]uh1jhj'nhKbhj nubah}(h]h ]h"]h$]h&]uh1jhjmubh)}(h**Description**h]j)}(hjMnh]h Description}(hjOnhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjKnubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:122: ./fs/eventfd.chKdhjmubh)}(hzThe eventfd context reference must have been previously acquired either with eventfd_ctx_fdget() or eventfd_ctx_fileget().h]hzThe eventfd context reference must have been previously acquired either with eventfd_ctx_fdget() or eventfd_ctx_fileget().}(hjcnhhhNhNubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:122: ./fs/eventfd.chKchjmubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j *eventfd_ctx_remove_wait_queue (C function)c.eventfd_ctx_remove_wait_queuehNtauh1hhjjhhhNhNubj)}(hhh](j)}(haint eventfd_ctx_remove_wait_queue (struct eventfd_ctx *ctx, wait_queue_entry_t *wait, __u64 *cnt)h]j)}(h`int eventfd_ctx_remove_wait_queue(struct eventfd_ctx *ctx, wait_queue_entry_t *wait, __u64 *cnt)h](j)}(hinth]hint}(hjnhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnhhhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:122: ./fs/eventfd.chKubj2)}(h h]h }(hjnhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjnhhhjnhKubjC)}(heventfd_ctx_remove_wait_queueh]jI)}(heventfd_ctx_remove_wait_queueh]heventfd_ctx_remove_wait_queue}(hjnhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjnubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjnhhhjnhKubj=)}(h?(struct eventfd_ctx *ctx, wait_queue_entry_t *wait, __u64 *cnt)h](jC)}(hstruct eventfd_ctx *ctxh](j )}(hjh]hstruct}(hjnhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjnubj2)}(h h]h }(hjnhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjnubh)}(hhh]jI)}(h eventfd_ctxh]h eventfd_ctx}(hjnhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjnubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjnmodnameN classnameNjj )}j ]j)}jjnsbc.eventfd_ctx_remove_wait_queueasbuh1hhjnubj2)}(h h]h }(hj ohhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjnubj)}(hjh]h*}(hjohhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnubjI)}(hctxh]hctx}(hj(ohhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjnubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjnubjC)}(hwait_queue_entry_t *waith](h)}(hhh]jI)}(hwait_queue_entry_th]hwait_queue_entry_t}(hjDohhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjAoubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjFomodnameN classnameNjj )}j ]j oc.eventfd_ctx_remove_wait_queueasbuh1hhj=oubj2)}(h h]h }(hjbohhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj=oubj)}(hjh]h*}(hjpohhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=oubjI)}(hwaith]hwait}(hj}ohhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj=oubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjnubjC)}(h __u64 *cnth](h)}(hhh]jI)}(h__u64h]h__u64}(hjohhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjoubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjomodnameN classnameNjj )}j ]j oc.eventfd_ctx_remove_wait_queueasbuh1hhjoubj2)}(h h]h }(hjohhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjoubj)}(hjh]h*}(hjohhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjoubjI)}(hcnth]hcnt}(hjohhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjoubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjnubeh}(h]h ]h"]h$]h&]j`jauh1j<hjnhhhjnhKubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjnhhhjnhKubah}(h]jnah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjnhKhjnhhubjw)}(hhh]h)}(h0Read the current counter and removes wait queue.h]h0Read the current counter and removes wait queue.}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:122: ./fs/eventfd.chKhjohhubah}(h]h ]h"]h$]h&]uh1jvhjnhhhjnhKubeh}(h]h ](jfunctioneh"]h$]h&]jjjjpjjpjjjuh1jhhhjjhNhNubj)}(hX**Parameters** ``struct eventfd_ctx *ctx`` [in] Pointer to eventfd context. ``wait_queue_entry_t *wait`` [in] Wait queue to be removed. ``__u64 *cnt`` [out] Pointer to the 64-bit counter value. **Description** Returns ``0`` if successful, or the following error codes: -EAGAIN : The operation would have blocked. This is used to atomically remove a wait queue entry from the eventfd wait queue head, and read/reset the counter value.h](h)}(h**Parameters**h]j)}(hjph]h Parameters}(hj phhhNhNubah}(h]h ]h"]h$]h&]uh1jhjpubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:122: ./fs/eventfd.chKhjpubj)}(hhh](j)}(h=``struct eventfd_ctx *ctx`` [in] Pointer to eventfd context. h](j)}(h``struct eventfd_ctx *ctx``h]j)}(hj=ph]hstruct eventfd_ctx *ctx}(hj?phhhNhNubah}(h]h ]h"]h$]h&]uh1jhj;pubah}(h]h ]h"]h$]h&]uh1jhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:122: ./fs/eventfd.chKhj7pubj)}(hhh]h)}(h [in] Pointer to eventfd context.h]h [in] Pointer to eventfd context.}(hjVphhhNhNubah}(h]h ]h"]h$]h&]uh1hhjRphKhjSpubah}(h]h ]h"]h$]h&]uh1jhj7pubeh}(h]h ]h"]h$]h&]uh1jhjRphKhj4pubj)}(h<``wait_queue_entry_t *wait`` [in] Wait queue to be removed. h](j)}(h``wait_queue_entry_t *wait``h]j)}(hjvph]hwait_queue_entry_t *wait}(hjxphhhNhNubah}(h]h ]h"]h$]h&]uh1jhjtpubah}(h]h ]h"]h$]h&]uh1jhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:122: ./fs/eventfd.chKhjppubj)}(hhh]h)}(h[in] Wait queue to be removed.h]h[in] Wait queue to be removed.}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1hhjphKhjpubah}(h]h ]h"]h$]h&]uh1jhjppubeh}(h]h ]h"]h$]h&]uh1jhjphKhj4pubj)}(h:``__u64 *cnt`` [out] Pointer to the 64-bit counter value. h](j)}(h``__u64 *cnt``h]j)}(hjph]h __u64 *cnt}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1jhjpubah}(h]h ]h"]h$]h&]uh1jhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:122: ./fs/eventfd.chKhjpubj)}(hhh]h)}(h*[out] Pointer to the 64-bit counter value.h]h*[out] Pointer to the 64-bit counter value.}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1hhjphKhjpubah}(h]h ]h"]h$]h&]uh1jhjpubeh}(h]h ]h"]h$]h&]uh1jhjphKhj4pubeh}(h]h ]h"]h$]h&]uh1jhjpubh)}(h**Description**h]j)}(hjph]h Description}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1jhjpubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:122: ./fs/eventfd.chKhjpubh)}(h:Returns ``0`` if successful, or the following error codes:h](hReturns }(hjqhhhNhNubj)}(h``0``h]h0}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjqubh- if successful, or the following error codes:}(hjqhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:122: ./fs/eventfd.chKhjpubh option_list)}(hhh]hoption_list_item)}(hhh](h option_group)}(hhh]hoption)}(h-EAGAINh](h option_string)}(h-Eh]h-E}hj8qsbah}(h]h ]h"]h$]h&]uh1j6qhj2qubhoption_argument)}(hAGAINh]hAGAIN}(hjHqhhhNhNubah}(h]h ]h"]h$]h&] delimiterhuh1jFqhj2qubeh}(h]h ]h"]h$]h&]uh1j0qhj-qubah}(h]h ]h"]h$]h&]uh1j+qhj(qubh description)}(h$: The operation would have blocked. h]h)}(h#: The operation would have blocked.h]h#: The operation would have blocked.}(hjiqhhhNhNubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:122: ./fs/eventfd.chKhjequbah}(h]h ]h"]h$]h&]uh1jcqhj(qubeh}(h]h ]h"]h$]h&]uh1j&qhj#qubah}(h]h ]h"]h$]h&]uh1j!qhjwqhKhjpubh)}(hxThis is used to atomically remove a wait queue entry from the eventfd wait queue head, and read/reset the counter value.h]hxThis is used to atomically remove a wait queue entry from the eventfd wait queue head, and read/reset the counter value.}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:122: ./fs/eventfd.chKhjpubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j eventfd_fget (C function)c.eventfd_fgethNtauh1hhjjhhhNhNubj)}(hhh](j)}(h#struct file * eventfd_fget (int fd)h]j)}(h!struct file *eventfd_fget(int fd)h](j )}(hjh]hstruct}(hjqhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjqhhhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:122: ./fs/eventfd.chM:ubj2)}(h h]h }(hjqhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjqhhhjqhM:ubh)}(hhh]jI)}(hfileh]hfile}(hjqhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjqubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjqmodnameN classnameNjj )}j ]j)}j eventfd_fgetsbc.eventfd_fgetasbuh1hhjqhhhjqhM:ubj2)}(h h]h }(hjqhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjqhhhjqhM:ubj)}(hjh]h*}(hjrhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjqhhhjqhM:ubjC)}(h eventfd_fgeth]jI)}(hjqh]h eventfd_fget}(hjrhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjrubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjqhhhjqhM:ubj=)}(h(int fd)h]jC)}(hint fdh](j)}(hinth]hint}(hj3rhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/rubj2)}(h h]h }(hjArhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj/rubjI)}(hfdh]hfd}(hjOrhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj/rubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj+rubah}(h]h ]h"]h$]h&]j`jauh1j<hjqhhhjqhM:ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjqhhhjqhM:ubah}(h]jqah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjqhM:hjqhhubjw)}(hhh]h)}(h2Acquire a reference of an eventfd file descriptor.h]h2Acquire a reference of an eventfd file descriptor.}(hjyrhhhNhNubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:122: ./fs/eventfd.chM:hjvrhhubah}(h]h ]h"]h$]h&]uh1jvhjqhhhjqhM:ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjrjjrjjjuh1jhhhjjhNhNubj)}(hX**Parameters** ``int fd`` [in] Eventfd file descriptor. **Description** Returns a pointer to the eventfd file structure in case of success, or the following error pointer: -EBADF : Invalid **fd** file descriptor. -EINVAL : The **fd** file descriptor is not an eventfd file.h](h)}(h**Parameters**h]j)}(hjrh]h Parameters}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjrubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:122: ./fs/eventfd.chM>hjrubj)}(hhh]j)}(h)``int fd`` [in] Eventfd file descriptor. h](j)}(h ``int fd``h]j)}(hjrh]hint fd}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjrubah}(h]h ]h"]h$]h&]uh1jhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:122: ./fs/eventfd.chM;hjrubj)}(hhh]h)}(h[in] Eventfd file descriptor.h]h[in] Eventfd file descriptor.}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjrhM;hjrubah}(h]h ]h"]h$]h&]uh1jhjrubeh}(h]h ]h"]h$]h&]uh1jhjrhM;hjrubah}(h]h ]h"]h$]h&]uh1jhjrubh)}(h**Description**h]j)}(hjrh]h Description}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjrubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:122: ./fs/eventfd.chM=hjrubh)}(hcReturns a pointer to the eventfd file structure in case of success, or the following error pointer:h]hcReturns a pointer to the eventfd file structure in case of success, or the following error pointer:}(hj shhhNhNubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:122: ./fs/eventfd.chM<hjrubj"q)}(hhh](j'q)}(hhh](j,q)}(hhh]j1q)}(h-EBADFh](j7q)}(h-Eh]h-E}hj'ssbah}(h]h ]h"]h$]h&]uh1j6qhj#subjGq)}(hBADFh]hBADF}(hj5shhhNhNubah}(h]h ]h"]h$]h&] delimiterhuh1jFqhj#subeh}(h]h ]h"]h$]h&]uh1j0qhj subah}(h]h ]h"]h$]h&]uh1j+qhjsubjdq)}(h!: Invalid **fd** file descriptor.h]h)}(hjRsh](h : Invalid }(hjTshhhNhNubj)}(h**fd**h]hfd}(hj[shhhNhNubah}(h]h ]h"]h$]h&]uh1jhjTsubh file descriptor.}(hjTshhhNhNubeh}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:122: ./fs/eventfd.chM?hjPsubah}(h]h ]h"]h$]h&]uh1jcqhjsubeh}(h]h ]h"]h$]h&]uh1j&qhjsubj'q)}(hhh](j,q)}(hhh]j1q)}(h-EINVALh](j7q)}(h-Eh]h-E}hjssbah}(h]h ]h"]h$]h&]uh1j6qhjsubjGq)}(hINVALh]hINVAL}(hjshhhNhNubah}(h]h ]h"]h$]h&] delimiterhuh1jFqhjsubeh}(h]h ]h"]h$]h&]uh1j0qhjsubah}(h]h ]h"]h$]h&]uh1j+qhjsubjdq)}(h4: The **fd** file descriptor is not an eventfd file.h]h)}(hjsh](h: The }(hjshhhNhNubj)}(h**fd**h]hfd}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1jhjsubh( file descriptor is not an eventfd file.}(hjshhhNhNubeh}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:122: ./fs/eventfd.chM@hjsubah}(h]h ]h"]h$]h&]uh1jcqhjsubeh}(h]h ]h"]h$]h&]uh1j&qhjsubeh}(h]h ]h"]h$]h&]uh1j!qhjsshM?hjrubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j eventfd_ctx_fdget (C function)c.eventfd_ctx_fdgethNtauh1hhjjhhhNhNubj)}(hhh](j)}(h/struct eventfd_ctx * eventfd_ctx_fdget (int fd)h]j)}(h-struct eventfd_ctx *eventfd_ctx_fdget(int fd)h](j )}(hjh]hstruct}(hj thhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjthhhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:122: ./fs/eventfd.chMTubj2)}(h h]h }(hjthhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjthhhjthMTubh)}(hhh]jI)}(h eventfd_ctxh]h eventfd_ctx}(hj(thhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj%tubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj*tmodnameN classnameNjj )}j ]j)}jeventfd_ctx_fdgetsbc.eventfd_ctx_fdgetasbuh1hhjthhhjthMTubj2)}(h h]h }(hjIthhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjthhhjthMTubj)}(hjh]h*}(hjWthhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjthhhjthMTubjC)}(heventfd_ctx_fdgeth]jI)}(hjFth]heventfd_ctx_fdget}(hjhthhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjdtubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjthhhjthMTubj=)}(h(int fd)h]jC)}(hint fdh](j)}(hinth]hint}(hjthhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjtubj2)}(h h]h }(hjthhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjtubjI)}(hfdh]hfd}(hjthhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjtubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj{tubah}(h]h ]h"]h$]h&]j`jauh1j<hjthhhjthMTubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjthhhjthMTubah}(h]jsah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjthMThjshhubjw)}(hhh]h)}(h5Acquires a reference to the internal eventfd context.h]h5Acquires a reference to the internal eventfd context.}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:122: ./fs/eventfd.chMThjthhubah}(h]h ]h"]h$]h&]uh1jvhjshhhjthMTubeh}(h]h ](jfunctioneh"]h$]h&]jjjjtjjtjjjuh1jhhhjjhNhNubj)}(h**Parameters** ``int fd`` [in] Eventfd file descriptor. **Description** Returns a pointer to the internal eventfd context, otherwise the error pointers returned by the following functions: eventfd_fgeth](h)}(h**Parameters**h]j)}(hjth]h Parameters}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jhjtubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:122: ./fs/eventfd.chMXhjtubj)}(hhh]j)}(h)``int fd`` [in] Eventfd file descriptor. h](j)}(h ``int fd``h]j)}(hj uh]hint fd}(hj uhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjuubah}(h]h ]h"]h$]h&]uh1jhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:122: ./fs/eventfd.chMUhjuubj)}(hhh]h)}(h[in] Eventfd file descriptor.h]h[in] Eventfd file descriptor.}(hj#uhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjuhMUhj uubah}(h]h ]h"]h$]h&]uh1jhjuubeh}(h]h ]h"]h$]h&]uh1jhjuhMUhjuubah}(h]h ]h"]h$]h&]uh1jhjtubh)}(h**Description**h]j)}(hjEuh]h Description}(hjGuhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjCuubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:122: ./fs/eventfd.chMWhjtubh)}(htReturns a pointer to the internal eventfd context, otherwise the error pointers returned by the following functions:h]htReturns a pointer to the internal eventfd context, otherwise the error pointers returned by the following functions:}(hj[uhhhNhNubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:122: ./fs/eventfd.chMVhjtubh)}(h eventfd_fgeth]h eventfd_fget}(hjjuhhhNhNubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:122: ./fs/eventfd.chMYhjtubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j  eventfd_ctx_fileget (C function)c.eventfd_ctx_filegethNtauh1hhjjhhhNhNubj)}(hhh](j)}(hah"]h$]h&]uh1j1hjuhhhjuhMfubh)}(hhh]jI)}(h eventfd_ctxh]h eventfd_ctx}(hjuhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjuubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjumodnameN classnameNjj )}j ]j)}jeventfd_ctx_filegetsbc.eventfd_ctx_filegetasbuh1hhjuhhhjuhMfubj2)}(h h]h }(hjuhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjuhhhjuhMfubj)}(hjh]h*}(hjuhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjuhhhjuhMfubjC)}(heventfd_ctx_filegeth]jI)}(hjuh]heventfd_ctx_fileget}(hjuhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjuubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjuhhhjuhMfubj=)}(h(struct file *file)h]jC)}(hstruct file *fileh](j )}(hjh]hstruct}(hjvhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjvubj2)}(h h]h }(hj vhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjvubh)}(hhh]jI)}(hfileh]hfile}(hj1vhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj.vubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj3vmodnameN classnameNjj )}j ]juc.eventfd_ctx_filegetasbuh1hhjvubj2)}(h h]h }(hjOvhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjvubj)}(hjh]h*}(hj]vhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvubjI)}(hfileh]hfile}(hjjvhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjvubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj vubah}(h]h ]h"]h$]h&]j`jauh1j<hjuhhhjuhMfubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjuhhhjuhMfubah}(h]juah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjuhMfhjuhhubjw)}(hhh]h)}(h5Acquires a reference to the internal eventfd context.h]h5Acquires a reference to the internal eventfd context.}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:122: ./fs/eventfd.chMfhjvhhubah}(h]h ]h"]h$]h&]uh1jvhjuhhhjuhMfubeh}(h]h ](jfunctioneh"]h$]h&]jjjjvjjvjjjuh1jhhhjjhNhNubj)}(h**Parameters** ``struct file *file`` [in] Eventfd file pointer. **Description** Returns a pointer to the internal eventfd context, otherwise the error pointer: -EINVAL : The **fd** file descriptor is not an eventfd file.h](h)}(h**Parameters**h]j)}(hjvh]h Parameters}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjvubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:122: ./fs/eventfd.chMjhjvubj)}(hhh]j)}(h1``struct file *file`` [in] Eventfd file pointer. h](j)}(h``struct file *file``h]j)}(hjvh]hstruct file *file}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjvubah}(h]h ]h"]h$]h&]uh1jhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:122: ./fs/eventfd.chMghjvubj)}(hhh]h)}(h[in] Eventfd file pointer.h]h[in] Eventfd file pointer.}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjvhMghjvubah}(h]h ]h"]h$]h&]uh1jhjvubeh}(h]h ]h"]h$]h&]uh1jhjvhMghjvubah}(h]h ]h"]h$]h&]uh1jhjvubh)}(h**Description**h]j)}(hjwh]h Description}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjwubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:122: ./fs/eventfd.chMihjvubh)}(hOReturns a pointer to the internal eventfd context, otherwise the error pointer:h]hOReturns a pointer to the internal eventfd context, otherwise the error pointer:}(hj&whhhNhNubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:122: ./fs/eventfd.chMhhjvubj"q)}(hhh]j'q)}(hhh](j,q)}(hhh]j1q)}(h-EINVALh](j7q)}(h-Eh]h-E}hjBwsbah}(h]h ]h"]h$]h&]uh1j6qhj>wubjGq)}(hINVALh]hINVAL}(hjPwhhhNhNubah}(h]h ]h"]h$]h&] delimiterhuh1jFqhj>wubeh}(h]h ]h"]h$]h&]uh1j0qhj;wubah}(h]h ]h"]h$]h&]uh1j+qhj8wubjdq)}(h4: The **fd** file descriptor is not an eventfd file.h]h)}(hjmwh](h: The }(hjowhhhNhNubj)}(h**fd**h]hfd}(hjvwhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjowubh( file descriptor is not an eventfd file.}(hjowhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:122: ./fs/eventfd.chMkhjkwubah}(h]h ]h"]h$]h&]uh1jcqhj8wubeh}(h]h ]h"]h$]h&]uh1j&qhj5wubah}(h]h ]h"]h$]h&]uh1j!qhjwhMkhjvubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjjhhhNhNubeh}(h] events-based-on-file-descriptorsah ]h"] events based on file descriptorsah$]h&]uh1hhhhhhhhKxubh)}(hhh](h)}(heventpoll (epoll) interfacesh]heventpoll (epoll) interfaces}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjwhhhhhK~ubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j !busy_loop_ep_timeout (C function)c.busy_loop_ep_timeouthNtauh1hhjwhhhNhNubj)}(hhh](j)}(hJbool busy_loop_ep_timeout (unsigned long start_time, struct eventpoll *ep)h]j)}(hIbool busy_loop_ep_timeout(unsigned long start_time, struct eventpoll *ep)h](j)}(hjh]hbool}(hjwhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjwhhhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:128: ./fs/eventpoll.chMqubj2)}(h h]h }(hjwhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjwhhhjwhMqubjC)}(hbusy_loop_ep_timeouth]jI)}(hbusy_loop_ep_timeouth]hbusy_loop_ep_timeout}(hjwhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjwubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjwhhhjwhMqubj=)}(h0(unsigned long start_time, struct eventpoll *ep)h](jC)}(hunsigned long start_timeh](j)}(hunsignedh]hunsigned}(hjxhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjxubj2)}(h h]h }(hj$xhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjxubj)}(hlongh]hlong}(hj2xhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjxubj2)}(h h]h }(hj@xhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjxubjI)}(h start_timeh]h start_time}(hjNxhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjxubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjxubjC)}(hstruct eventpoll *eph](j )}(hjh]hstruct}(hjgxhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjcxubj2)}(h h]h }(hjtxhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjcxubh)}(hhh]jI)}(h eventpollh]h eventpoll}(hjxhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjxubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjxmodnameN classnameNjj )}j ]j)}jjwsbc.busy_loop_ep_timeoutasbuh1hhjcxubj2)}(h h]h }(hjxhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjcxubj)}(hjh]h*}(hjxhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjcxubjI)}(heph]hep}(hjxhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjcxubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjxubeh}(h]h ]h"]h$]h&]j`jauh1j<hjwhhhjwhMqubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjwhhhjwhMqubah}(h]jwah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjwhMqhjwhhubjw)}(hhh]h)}(hcheck if busy poll has timed out. The timeout value from the epoll instance ep is preferred, but if it is not set fallback to the system-wide global via busy_loop_timeout.h]hcheck if busy poll has timed out. The timeout value from the epoll instance ep is preferred, but if it is not set fallback to the system-wide global via busy_loop_timeout.}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:128: ./fs/eventpoll.chMqhjxhhubah}(h]h ]h"]h$]h&]uh1jvhjwhhhjwhMqubeh}(h]h ](jfunctioneh"]h$]h&]jjjjyjjyjjjuh1jhhhjwhNhNubj)}(h**Parameters** ``unsigned long start_time`` The start time used to compute the remaining time until timeout. ``struct eventpoll *ep`` Pointer to the eventpoll context. **Return** true if the timeout has expired, false otherwise.h](h)}(h**Parameters**h]j)}(hj yh]h Parameters}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj yubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:128: ./fs/eventpoll.chMuhjyubj)}(hhh](j)}(h^``unsigned long start_time`` The start time used to compute the remaining time until timeout. h](j)}(h``unsigned long start_time``h]j)}(hj+yh]hunsigned long start_time}(hj-yhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj)yubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:128: ./fs/eventpoll.chMuhj%yubj)}(hhh]h)}(h@The start time used to compute the remaining time until timeout.h]h@The start time used to compute the remaining time until timeout.}(hjDyhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj@yhMuhjAyubah}(h]h ]h"]h$]h&]uh1jhj%yubeh}(h]h ]h"]h$]h&]uh1jhj@yhMuhj"yubj)}(h;``struct eventpoll *ep`` Pointer to the eventpoll context. h](j)}(h``struct eventpoll *ep``h]j)}(hjdyh]hstruct eventpoll *ep}(hjfyhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjbyubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:128: ./fs/eventpoll.chMvhj^yubj)}(hhh]h)}(h!Pointer to the eventpoll context.h]h!Pointer to the eventpoll context.}(hj}yhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjyyhMvhjzyubah}(h]h ]h"]h$]h&]uh1jhj^yubeh}(h]h ]h"]h$]h&]uh1jhjyyhMvhj"yubeh}(h]h ]h"]h$]h&]uh1jhjyubh)}(h **Return**h]j)}(hjyh]hReturn}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjyubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:128: ./fs/eventpoll.chMxhjyubh)}(h1true if the timeout has expired, false otherwise.h]h1true if the timeout has expired, false otherwise.}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:128: ./fs/eventpoll.chMxhjyubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjwhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j reverse_path_check (C function)c.reverse_path_checkhNtauh1hhjwhhhNhNubj)}(hhh](j)}(h/int reverse_path_check (struct ep_ctl_ctx *ctx)h]j)}(h.int reverse_path_check(struct ep_ctl_ctx *ctx)h](j)}(hinth]hint}(hjyhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyhhhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:128: ./fs/eventpoll.chMubj2)}(h h]h }(hjyhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjyhhhjyhMubjC)}(hreverse_path_checkh]jI)}(hreverse_path_checkh]hreverse_path_check}(hjzhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjzubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjyhhhjyhMubj=)}(h(struct ep_ctl_ctx *ctx)h]jC)}(hstruct ep_ctl_ctx *ctxh](j )}(hjh]hstruct}(hj!zhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjzubj2)}(h h]h }(hj.zhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjzubh)}(hhh]jI)}(h ep_ctl_ctxh]h ep_ctl_ctx}(hj?zhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjah"]h$]h&]uh1j1hjzubj)}(hjh]h*}(hjmzhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjzubjI)}(hctxh]hctx}(hjzzhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjzubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjzubah}(h]h ]h"]h$]h&]j`jauh1j<hjyhhhjyhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjyhhhjyhMubah}(h]jyah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjyhMhjyhhubjw)}(hhh]h)}(hctx->tfile_check_list is a list of epitems_head anchoring files with newly proposed links; make sure those links don't push any path-length bucket over its limit in path_limits[].h]hctx->tfile_check_list is a list of epitems_head anchoring files with newly proposed links; make sure those links don’t push any path-length bucket over its limit in path_limits[].}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:128: ./fs/eventpoll.chMhjzhhubah}(h]h ]h"]h$]h&]uh1jvhjyhhhjyhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjzjjzjjjuh1jhhhjwhNhNubj)}(h**Parameters** ``struct ep_ctl_ctx *ctx`` Per-do_epoll_ctl() scratch for the loop / path checks. **Return** ``zero`` if the proposed links don't create too many paths, ``-1`` otherwise.h](h)}(h**Parameters**h]j)}(hjzh]h Parameters}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjzubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:128: ./fs/eventpoll.chMhjzubj)}(hhh]j)}(hR``struct ep_ctl_ctx *ctx`` Per-do_epoll_ctl() scratch for the loop / path checks. h](j)}(h``struct ep_ctl_ctx *ctx``h]j)}(hjzh]hstruct ep_ctl_ctx *ctx}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjzubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:128: ./fs/eventpoll.chMhjzubj)}(hhh]h)}(h6Per-do_epoll_ctl() scratch for the loop / path checks.h]h6Per-do_epoll_ctl() scratch for the loop / path checks.}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjzhMhjzubah}(h]h ]h"]h$]h&]uh1jhjzubeh}(h]h ]h"]h$]h&]uh1jhjzhMhjzubah}(h]h ]h"]h$]h&]uh1jhjzubh)}(h **Return**h]j)}(hj {h]hReturn}(hj"{hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj{ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:128: ./fs/eventpoll.chMhjzubh)}(hM``zero`` if the proposed links don't create too many paths, ``-1`` otherwise.h](j)}(h``zero``h]hzero}(hj:{hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj6{ubh6 if the proposed links don’t create too many paths, }(hj6{hhhNhNubj)}(h``-1``h]h-1}(hjL{hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj6{ubh otherwise.}(hj6{hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:128: ./fs/eventpoll.chMhjzubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjwhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j ep_poll (C function) c.ep_pollhNtauh1hhjwhhhNhNubj)}(hhh](j)}(hpint ep_poll (struct eventpoll *ep, struct epoll_event __user *events, int maxevents, struct timespec64 *timeout)h]j)}(hoint ep_poll(struct eventpoll *ep, struct epoll_event __user *events, int maxevents, struct timespec64 *timeout)h](j)}(hinth]hint}(hj{hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{hhhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:128: ./fs/eventpoll.chMubj2)}(h h]h }(hj{hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj{hhhj{hMubjC)}(hep_pollh]jI)}(hep_pollh]hep_poll}(hj{hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj{ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj{hhhj{hMubj=)}(hd(struct eventpoll *ep, struct epoll_event __user *events, int maxevents, struct timespec64 *timeout)h](jC)}(hstruct eventpoll *eph](j )}(hjh]hstruct}(hj{hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj{ubj2)}(h h]h }(hj{hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj{ubh)}(hhh]jI)}(h eventpollh]h eventpoll}(hj{hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj{ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj{modnameN classnameNjj )}j ]j)}jj{sb c.ep_pollasbuh1hhj{ubj2)}(h h]h }(hj|hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj{ubj)}(hjh]h*}(hj|hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{ubjI)}(heph]hep}(hj|hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj{ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj{ubjC)}(h!struct epoll_event __user *eventsh](j )}(hjh]hstruct}(hj4|hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj0|ubj2)}(h h]h }(hjA|hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj0|ubh)}(hhh]jI)}(h epoll_eventh]h epoll_event}(hjR|hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjO|ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjT|modnameN classnameNjj )}j ]j{ c.ep_pollasbuh1hhj0|ubj2)}(h h]h }(hjp|hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj0|ubh__user}(hj0|hhhNhNubj2)}(h h]h }(hj|hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj0|ubj)}(hjh]h*}(hj|hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0|ubjI)}(heventsh]hevents}(hj|hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj0|ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj{ubjC)}(h int maxeventsh](j)}(hinth]hint}(hj|hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|ubj2)}(h h]h }(hj|hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj|ubjI)}(h maxeventsh]h maxevents}(hj|hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj|ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj{ubjC)}(hstruct timespec64 *timeouth](j )}(hjh]hstruct}(hj|hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj|ubj2)}(h h]h }(hj|hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj|ubh)}(hhh]jI)}(h timespec64h]h timespec64}(hj }hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj}ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj }modnameN classnameNjj )}j ]j{ c.ep_pollasbuh1hhj|ubj2)}(h h]h }(hj'}hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj|ubj)}(hjh]h*}(hj5}hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|ubjI)}(htimeouth]htimeout}(hjB}hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj|ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj{ubeh}(h]h ]h"]h$]h&]j`jauh1j<hj{hhhj{hMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj}{hhhj{hMubah}(h]jx{ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj{hMhjz{hhubjw)}(hhh]h)}(hNRetrieves ready events, and delivers them to the caller-supplied event buffer.h]hNRetrieves ready events, and delivers them to the caller-supplied event buffer.}(hjl}hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:128: ./fs/eventpoll.chMhji}hhubah}(h]h ]h"]h$]h&]uh1jvhjz{hhhj{hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjj}jj}jjjuh1jhhhjwhNhNubj)}(hX**Parameters** ``struct eventpoll *ep`` Pointer to the eventpoll context. ``struct epoll_event __user *events`` Pointer to the userspace buffer where the ready events should be stored. ``int maxevents`` Size (in terms of number of events) of the caller event buffer. ``struct timespec64 *timeout`` Maximum timeout for the ready events fetch operation, in timespec. If the timeout is zero, the function will not block, while if the **timeout** ptr is NULL, the function will block until at least one event has been retrieved (or an error occurred). **Return** the number of ready events which have been fetched, or an error code, in case of error.h](h)}(h**Parameters**h]j)}(hj}h]h Parameters}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj}ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:128: ./fs/eventpoll.chMhj}ubj)}(hhh](j)}(h;``struct eventpoll *ep`` Pointer to the eventpoll context. h](j)}(h``struct eventpoll *ep``h]j)}(hj}h]hstruct eventpoll *ep}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj}ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:128: ./fs/eventpoll.chMhj}ubj)}(hhh]h)}(h!Pointer to the eventpoll context.h]h!Pointer to the eventpoll context.}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj}hMhj}ubah}(h]h ]h"]h$]h&]uh1jhj}ubeh}(h]h ]h"]h$]h&]uh1jhj}hMhj}ubj)}(ho``struct epoll_event __user *events`` Pointer to the userspace buffer where the ready events should be stored. h](j)}(h%``struct epoll_event __user *events``h]j)}(hj}h]h!struct epoll_event __user *events}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj}ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:128: ./fs/eventpoll.chMhj}ubj)}(hhh]h)}(hHPointer to the userspace buffer where the ready events should be stored.h]hHPointer to the userspace buffer where the ready events should be stored.}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:128: ./fs/eventpoll.chMhj}ubah}(h]h ]h"]h$]h&]uh1jhj}ubeh}(h]h ]h"]h$]h&]uh1jhj}hMhj}ubj)}(hR``int maxevents`` Size (in terms of number of events) of the caller event buffer. h](j)}(h``int maxevents``h]j)}(hj ~h]h int maxevents}(hj"~hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj~ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:128: ./fs/eventpoll.chMhj~ubj)}(hhh]h)}(h?Size (in terms of number of events) of the caller event buffer.h]h?Size (in terms of number of events) of the caller event buffer.}(hj9~hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj5~hMhj6~ubah}(h]h ]h"]h$]h&]uh1jhj~ubeh}(h]h ]h"]h$]h&]uh1jhj5~hMhj}ubj)}(hX``struct timespec64 *timeout`` Maximum timeout for the ready events fetch operation, in timespec. If the timeout is zero, the function will not block, while if the **timeout** ptr is NULL, the function will block until at least one event has been retrieved (or an error occurred). h](j)}(h``struct timespec64 *timeout``h]j)}(hjY~h]hstruct timespec64 *timeout}(hj[~hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjW~ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:128: ./fs/eventpoll.chMhjS~ubj)}(hhh]h)}(hMaximum timeout for the ready events fetch operation, in timespec. If the timeout is zero, the function will not block, while if the **timeout** ptr is NULL, the function will block until at least one event has been retrieved (or an error occurred).h](hMaximum timeout for the ready events fetch operation, in timespec. If the timeout is zero, the function will not block, while if the }(hjr~hhhNhNubj)}(h **timeout**h]htimeout}(hjz~hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjr~ubhi ptr is NULL, the function will block until at least one event has been retrieved (or an error occurred).}(hjr~hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:128: ./fs/eventpoll.chMhjo~ubah}(h]h ]h"]h$]h&]uh1jhjS~ubeh}(h]h ]h"]h$]h&]uh1jhjn~hMhj}ubeh}(h]h ]h"]h$]h&]uh1jhj}ubh)}(h **Return**h]j)}(hj~h]hReturn}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj~ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:128: ./fs/eventpoll.chMhj}ubh)}(hWthe number of ready events which have been fetched, or an error code, in case of error.h]hWthe number of ready events which have been fetched, or an error code, in case of error.}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:128: ./fs/eventpoll.chMhj}ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjwhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j ep_loop_check_proc (C function)c.ep_loop_check_prochNtauh1hhjwhhhNhNubj)}(hhh](j)}(hPint ep_loop_check_proc (struct ep_ctl_ctx *ctx, struct eventpoll *ep, int depth)h]j)}(hOint ep_loop_check_proc(struct ep_ctl_ctx *ctx, struct eventpoll *ep, int depth)h](j)}(hinth]hint}(hj~hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~hhhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:128: ./fs/eventpoll.chMS ubj2)}(h h]h }(hj~hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj~hhhj~hMS ubjC)}(hep_loop_check_proch]jI)}(hep_loop_check_proch]hep_loop_check_proc}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj~hhhj~hMS ubj=)}(h9(struct ep_ctl_ctx *ctx, struct eventpoll *ep, int depth)h](jC)}(hstruct ep_ctl_ctx *ctxh](j )}(hjh]hstruct}(hj)hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj%ubj2)}(h h]h }(hj6hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj%ubh)}(hhh]jI)}(h ep_ctl_ctxh]h ep_ctl_ctx}(hjGhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjDubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjImodnameN classnameNjj )}j ]j)}jjsbc.ep_loop_check_procasbuh1hhj%ubj2)}(h h]h }(hjghhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj%ubj)}(hjh]h*}(hjuhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%ubjI)}(hctxh]hctx}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj%ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj!ubjC)}(hstruct eventpoll *eph](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(h eventpollh]h eventpoll}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jcc.ep_loop_check_procasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(heph]hep}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj!ubjC)}(h int depthh](j)}(hinth]hint}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hdepthh]hdepth}(hj'hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj!ubeh}(h]h ]h"]h$]h&]j`jauh1j<hj~hhhj~hMS ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj~hhhj~hMS ubah}(h]j~ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj~hMS hj~hhubjw)}(hhh]h)}(hverify that adding an epoll file **ep** inside another epoll file does not create closed loops, and determine the depth of the subtree starting at **ep**h](h!verify that adding an epoll file }(hjQhhhNhNubj)}(h**ep**h]hep}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjQubhl inside another epoll file does not create closed loops, and determine the depth of the subtree starting at }(hjQhhhNhNubj)}(h**ep**h]hep}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjQubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:128: ./fs/eventpoll.chMS hjNhhubah}(h]h ]h"]h$]h&]uh1jvhj~hhhj~hMS ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjwhNhNubj)}(hXi**Parameters** ``struct ep_ctl_ctx *ctx`` Per-do_epoll_ctl() scratch for the loop / path checks. ``struct eventpoll *ep`` the :c:type:`struct eventpoll ` to be currently checked. ``int depth`` Current depth of the path being checked. **Return** depth of the subtree, or a value bigger than EP_MAX_NESTS if we found a loop or went too deep.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:128: ./fs/eventpoll.chMW hjubj)}(hhh](j)}(hR``struct ep_ctl_ctx *ctx`` Per-do_epoll_ctl() scratch for the loop / path checks. h](j)}(h``struct ep_ctl_ctx *ctx``h]j)}(hjh]hstruct ep_ctl_ctx *ctx}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:128: ./fs/eventpoll.chMW hjubj)}(hhh]h)}(h6Per-do_epoll_ctl() scratch for the loop / path checks.h]h6Per-do_epoll_ctl() scratch for the loop / path checks.}(hjˀhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjǀhMW hjȀubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjǀhMW hjubj)}(h]``struct eventpoll *ep`` the :c:type:`struct eventpoll ` to be currently checked. h](j)}(h``struct eventpoll *ep``h]j)}(hjh]hstruct eventpoll *ep}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:128: ./fs/eventpoll.chMX hjubj)}(hhh]h)}(hCthe :c:type:`struct eventpoll ` to be currently checked.h](hthe }(hjhhhNhNubh)}(h&:c:type:`struct eventpoll `h]j)}(hjh]hstruct eventpoll}(hjhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnjjj eventpolluh1hhjhMX hjubh to be currently checked.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhMX hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMX hjubj)}(h7``int depth`` Current depth of the path being checked. h](j)}(h ``int depth``h]j)}(hjGh]h int depth}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjEubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:128: ./fs/eventpoll.chMY hjAubj)}(hhh]h)}(h(Current depth of the path being checked.h]h(Current depth of the path being checked.}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj\hMY hj]ubah}(h]h ]h"]h$]h&]uh1jhjAubeh}(h]h ]h"]h$]h&]uh1jhj\hMY hjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:128: ./fs/eventpoll.chM[ hjubh)}(h^depth of the subtree, or a value bigger than EP_MAX_NESTS if we found a loop or went too deep.h]h^depth of the subtree, or a value bigger than EP_MAX_NESTS if we found a loop or went too deep.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:128: ./fs/eventpoll.chM[ hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjwhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j ep_loop_check (C function)c.ep_loop_checkhNtauh1hhjwhhhNhNubj)}(hhh](j)}(hVint ep_loop_check (struct ep_ctl_ctx *ctx, struct eventpoll *ep, struct eventpoll *to)h]j)}(hUint ep_loop_check(struct ep_ctl_ctx *ctx, struct eventpoll *ep, struct eventpoll *to)h](j)}(hinth]hint}(hjǁhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjÁhhhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:128: ./fs/eventpoll.chM ubj2)}(h h]h }(hjցhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjÁhhhjՁhM ubjC)}(h ep_loop_checkh]jI)}(h ep_loop_checkh]h ep_loop_check}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjÁhhhjՁhM ubj=)}(hD(struct ep_ctl_ctx *ctx, struct eventpoll *ep, struct eventpoll *to)h](jC)}(hstruct ep_ctl_ctx *ctxh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(h ep_ctl_ctxh]h ep_ctl_ctx}(hj"hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj$modnameN classnameNjj )}j ]j)}jjsbc.ep_loop_checkasbuh1hhjubj2)}(h h]h }(hjBhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjPhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hctxh]hctx}(hj]hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct eventpoll *eph](j )}(hjh]hstruct}(hjvhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjrubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjrubh)}(hhh]jI)}(h eventpollh]h eventpoll}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j>c.ep_loop_checkasbuh1hhjrubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjrubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjrubjI)}(heph]hep}(hj͂hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjrubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct eventpoll *toh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(h eventpollh]h eventpoll}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j>c.ep_loop_checkasbuh1hhjubj2)}(h h]h }(hj"hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(htoh]hto}(hj=hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjÁhhhjՁhM ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjՁhM ubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjՁhM hjhhubjw)}(hhh]h)}(hPerforms a check to verify that adding an epoll file (**to**) into another epoll file (represented by **ep**) does not create closed loops or too deep chains.h](h6Performs a check to verify that adding an epoll file (}(hjghhhNhNubj)}(h**to**h]hto}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1jhjgubh*) into another epoll file (represented by }(hjghhhNhNubj)}(h**ep**h]hep}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjgubh2) does not create closed loops or too deep chains.}(hjghhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:128: ./fs/eventpoll.chM hjdhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjՁhM ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjwhNhNubj)}(hXT**Parameters** ``struct ep_ctl_ctx *ctx`` Per-CTL_ADD scratch context. ``struct eventpoll *ep`` Pointer to the epoll we are inserting into. ``struct eventpoll *to`` Pointer to the epoll to be inserted. **Return** ``zero`` if adding the epoll **to** inside the epoll **from** does not violate the constraints, or ``-1`` otherwise.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:128: ./fs/eventpoll.chM hjubj)}(hhh](j)}(h8``struct ep_ctl_ctx *ctx`` Per-CTL_ADD scratch context. h](j)}(h``struct ep_ctl_ctx *ctx``h]j)}(hj̃h]hstruct ep_ctl_ctx *ctx}(hj΃hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjʃubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:128: ./fs/eventpoll.chM hjƃubj)}(hhh]h)}(hPer-CTL_ADD scratch context.h]hPer-CTL_ADD scratch context.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjƃubeh}(h]h ]h"]h$]h&]uh1jhjhM hjÃubj)}(hE``struct eventpoll *ep`` Pointer to the epoll we are inserting into. h](j)}(h``struct eventpoll *ep``h]j)}(hjh]hstruct eventpoll *ep}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:128: ./fs/eventpoll.chM hjubj)}(hhh]h)}(h+Pointer to the epoll we are inserting into.h]h+Pointer to the epoll we are inserting into.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hjÃubj)}(h>``struct eventpoll *to`` Pointer to the epoll to be inserted. h](j)}(h``struct eventpoll *to``h]j)}(hj>h]hstruct eventpoll *to}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj<ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:128: ./fs/eventpoll.chM hj8ubj)}(hhh]h)}(h$Pointer to the epoll to be inserted.h]h$Pointer to the epoll to be inserted.}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjShM hjTubah}(h]h ]h"]h$]h&]uh1jhj8ubeh}(h]h ]h"]h$]h&]uh1jhjShM hjÃubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h **Return**h]j)}(hjyh]hReturn}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjwubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:128: ./fs/eventpoll.chM hjubh)}(ht``zero`` if adding the epoll **to** inside the epoll **from** does not violate the constraints, or ``-1`` otherwise.h](j)}(h``zero``h]hzero}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh if adding the epoll }(hjhhhNhNubj)}(h**to**h]hto}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh inside the epoll }(hjhhhNhNubj)}(h**from**h]hfrom}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh& does not violate the constraints, or }(hjhhhNhNubj)}(h``-1``h]h-1}(hjɄhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh otherwise.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:128: ./fs/eventpoll.chM hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjwhhhNhNubeh}(h]eventpoll-epoll-interfacesah ]h"]eventpoll (epoll) interfacesah$]h&]uh1hhhhhhhhK~ubh)}(hhh](h)}(h+The Filesystem for Exporting Kernel Objectsh]h+The Filesystem for Exporting Kernel Objects}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j !sysfs_create_file_ns (C function)c.sysfs_create_file_nshNtauh1hhjhhhNhNubj)}(hhh](j)}(hiint sysfs_create_file_ns (struct kobject *kobj, const struct attribute *attr, const struct ns_common *ns)h]j)}(hhint sysfs_create_file_ns(struct kobject *kobj, const struct attribute *attr, const struct ns_common *ns)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMjubj2)}(h h]h }(hj*hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhj)hMjubjC)}(hsysfs_create_file_nsh]jI)}(hsysfs_create_file_nsh]hsysfs_create_file_ns}(hj<hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj8ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhj)hMjubj=)}(hP(struct kobject *kobj, const struct attribute *attr, const struct ns_common *ns)h](jC)}(hstruct kobject *kobjh](j )}(hjh]hstruct}(hjXhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjTubj2)}(h h]h }(hjehhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjTubh)}(hhh]jI)}(hkobjecth]hkobject}(hjvhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjsubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjxmodnameN classnameNjj )}j ]j)}jj>sbc.sysfs_create_file_nsasbuh1hhjTubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjTubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjTubjI)}(hkobjh]hkobj}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjTubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjPubjC)}(hconst struct attribute *attrh](j )}(hjJh]hconst}(hjʅhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjƅubj2)}(h h]h }(hjׅhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjƅubj )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjƅubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjƅubh)}(hhh]jI)}(h attributeh]h attribute}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.sysfs_create_file_nsasbuh1hhjƅubj2)}(h h]h }(hj!hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjƅubj)}(hjh]h*}(hj/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjƅubjI)}(hattrh]hattr}(hj<hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjƅubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjPubjC)}(hconst struct ns_common *nsh](j )}(hjJh]hconst}(hjUhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjQubj2)}(h h]h }(hjbhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjQubj )}(hjh]hstruct}(hjphhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjQubj2)}(h h]h }(hj}hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjQubh)}(hhh]jI)}(h ns_commonh]h ns_common}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.sysfs_create_file_nsasbuh1hhjQubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjQubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjQubjI)}(hnsh]hns}(hjdžhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjQubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjPubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhj)hMjubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhj)hMjubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj)hMjhjhhubjw)}(hhh]h)}(h5create an attribute file for an object with custom nsh]h5create an attribute file for an object with custom ns}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMjhjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhj)hMjubeh}(h]h ](jfunctioneh"]h$]h&]jjjj jj jjjuh1jhhhjhNhNubj)}(h**Parameters** ``struct kobject *kobj`` object we're creating for ``const struct attribute *attr`` attribute descriptor ``const struct ns_common *ns`` namespace the new file should belong toh](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMnhj ubj)}(hhh](j)}(h3``struct kobject *kobj`` object we're creating for h](j)}(h``struct kobject *kobj``h]j)}(hj2h]hstruct kobject *kobj}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj0ubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMkhj,ubj)}(hhh]h)}(hobject we're creating forh]hobject we’re creating for}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjGhMkhjHubah}(h]h ]h"]h$]h&]uh1jhj,ubeh}(h]h ]h"]h$]h&]uh1jhjGhMkhj)ubj)}(h6``const struct attribute *attr`` attribute descriptor h](j)}(h ``const struct attribute *attr``h]j)}(hjkh]hconst struct attribute *attr}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjiubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMlhjeubj)}(hhh]h)}(hattribute descriptorh]hattribute descriptor}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMlhjubah}(h]h ]h"]h$]h&]uh1jhjeubeh}(h]h ]h"]h$]h&]uh1jhjhMlhj)ubj)}(hF``const struct ns_common *ns`` namespace the new file should belong toh](j)}(h``const struct ns_common *ns``h]j)}(hjh]hconst struct ns_common *ns}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMnhjubj)}(hhh]h)}(h'namespace the new file should belong toh]h'namespace the new file should belong to}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMmhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMnhj)ubeh}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j $sysfs_add_file_to_group (C function)c.sysfs_add_file_to_grouphNtauh1hhjhhhNhNubj)}(hhh](j)}(hcint sysfs_add_file_to_group (struct kobject *kobj, const struct attribute *attr, const char *group)h]j)}(hbint sysfs_add_file_to_group(struct kobject *kobj, const struct attribute *attr, const char *group)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMubj2)}(h h]h }(hj hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhj hMubjC)}(hsysfs_add_file_to_grouph]jI)}(hsysfs_add_file_to_grouph]hsysfs_add_file_to_group}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhj hMubj=)}(hG(struct kobject *kobj, const struct attribute *attr, const char *group)h](jC)}(hstruct kobject *kobjh](j )}(hjh]hstruct}(hj;hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj7ubj2)}(h h]h }(hjHhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj7ubh)}(hhh]jI)}(hkobjecth]hkobject}(hjYhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjVubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj[modnameN classnameNjj )}j ]j)}jj!sbc.sysfs_add_file_to_groupasbuh1hhj7ubj2)}(h h]h }(hjyhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj7ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7ubjI)}(hkobjh]hkobj}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj7ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj3ubjC)}(hconst struct attribute *attrh](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj )}(hjh]hstruct}(hjȈhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjՈhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(h attributeh]h attribute}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]juc.sysfs_add_file_to_groupasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hattrh]hattr}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj3ubjC)}(hconst char *grouph](j )}(hjJh]hconst}(hj8hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj4ubj2)}(h h]h }(hjEhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj4ubj)}(hcharh]hchar}(hjShhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4ubj2)}(h h]h }(hjahhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj4ubj)}(hjh]h*}(hjohhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4ubjI)}(hgrouph]hgroup}(hj|hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj4ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj3ubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhj hMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhj hMubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj hMhjhhubjw)}(hhh]h)}(h.add an attribute file to a pre-existing group.h]h.add an attribute file to a pre-existing group.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMhjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhj hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjhNhNubj)}(h**Parameters** ``struct kobject *kobj`` object we're acting for. ``const struct attribute *attr`` attribute descriptor. ``const char *group`` group name.h](h)}(h**Parameters**h]j)}(hjȉh]h Parameters}(hjʉhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjƉubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMhj‰ubj)}(hhh](j)}(h2``struct kobject *kobj`` object we're acting for. h](j)}(h``struct kobject *kobj``h]j)}(hjh]hstruct kobject *kobj}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMhjubj)}(hhh]h)}(hobject we're acting for.h]hobject we’re acting for.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjމubj)}(h7``const struct attribute *attr`` attribute descriptor. h](j)}(h ``const struct attribute *attr``h]j)}(hj h]hconst struct attribute *attr}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMhjubj)}(hhh]h)}(hattribute descriptor.h]hattribute descriptor.}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj5hMhj6ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj5hMhjމubj)}(h!``const char *group`` group name.h](j)}(h``const char *group``h]j)}(hjYh]hconst char *group}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjWubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMhjSubj)}(hhh]h)}(h group name.h]h group name.}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMhjoubah}(h]h ]h"]h$]h&]uh1jhjSubeh}(h]h ]h"]h$]h&]uh1jhjnhMhjމubeh}(h]h ]h"]h$]h&]uh1jhj‰ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j sysfs_chmod_file (C function)c.sysfs_chmod_filehNtauh1hhjhhhNhNubj)}(hhh](j)}(hWint sysfs_chmod_file (struct kobject *kobj, const struct attribute *attr, umode_t mode)h]j)}(hVint sysfs_chmod_file(struct kobject *kobj, const struct attribute *attr, umode_t mode)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMubj2)}(h h]h }(hjŠhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMubjC)}(hsysfs_chmod_fileh]jI)}(hsysfs_chmod_fileh]hsysfs_chmod_file}(hjԊhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjЊubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhMubj=)}(hB(struct kobject *kobj, const struct attribute *attr, umode_t mode)h](jC)}(hstruct kobject *kobjh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hkobjecth]hkobject}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jj֊sbc.sysfs_chmod_fileasbuh1hhjubj2)}(h h]h }(hj.hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj<hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hkobjh]hkobj}(hjIhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hconst struct attribute *attrh](j )}(hjJh]hconst}(hjbhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj^ubj2)}(h h]h }(hjohhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj^ubj )}(hjh]hstruct}(hj}hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj^ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj^ubh)}(hhh]jI)}(h attributeh]h attribute}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j*c.sysfs_chmod_fileasbuh1hhj^ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj^ubj)}(hjh]h*}(hjNjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^ubjI)}(hattrh]hattr}(hjԋhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj^ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h umode_t mode h](h)}(hhh]jI)}(humode_th]humode_t}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j*c.sysfs_chmod_fileasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hmodeh]hmode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhMubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMhjhhubjw)}(hhh]h)}(h6update the modified mode value on an object attribute.h]h6update the modified mode value on an object attribute.}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMhjChhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjj^jj^jjjuh1jhhhjhNhNubj)}(h**Parameters** ``struct kobject *kobj`` object we're acting for. ``const struct attribute *attr`` attribute descriptor. ``umode_t mode`` file permissions.h](h)}(h**Parameters**h]j)}(hjhh]h Parameters}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjfubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMhjbubj)}(hhh](j)}(h2``struct kobject *kobj`` object we're acting for. h](j)}(h``struct kobject *kobj``h]j)}(hjh]hstruct kobject *kobj}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMhjubj)}(hhh]h)}(hobject we're acting for.h]hobject we’re acting for.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhj~ubj)}(h7``const struct attribute *attr`` attribute descriptor. h](j)}(h ``const struct attribute *attr``h]j)}(hjh]hconst struct attribute *attr}(hjŒhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMhjubj)}(hhh]h)}(hattribute descriptor.h]hattribute descriptor.}(hjٌhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjՌhMhj֌ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjՌhMhj~ubj)}(h"``umode_t mode`` file permissions.h](j)}(h``umode_t mode``h]j)}(hjh]h umode_t mode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMhjubj)}(hhh]h)}(hfile permissions.h]hfile permissions.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhj~ubeh}(h]h ]h"]h$]h&]uh1jhjbubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j *sysfs_break_active_protection (C function)c.sysfs_break_active_protectionhNtauh1hhjhhhNhNubj)}(hhh](j)}(hgstruct kernfs_node * sysfs_break_active_protection (struct kobject *kobj, const struct attribute *attr)h]j)}(hestruct kernfs_node *sysfs_break_active_protection(struct kobject *kobj, const struct attribute *attr)h](j )}(hjh]hstruct}(hjShhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjOhhhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMubj2)}(h h]h }(hjahhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjOhhhj`hMubh)}(hhh]jI)}(h kernfs_nodeh]h kernfs_node}(hjrhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjoubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjtmodnameN classnameNjj )}j ]j)}jsysfs_break_active_protectionsbc.sysfs_break_active_protectionasbuh1hhjOhhhj`hMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjOhhhj`hMubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjOhhhj`hMubjC)}(hsysfs_break_active_protectionh]jI)}(hjh]hsysfs_break_active_protection}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjOhhhj`hMubj=)}(h4(struct kobject *kobj, const struct attribute *attr)h](jC)}(hstruct kobject *kobjh](j )}(hjh]hstruct}(hj͍hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjɍubj2)}(h h]h }(hjڍhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjɍubh)}(hhh]jI)}(hkobjecth]hkobject}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.sysfs_break_active_protectionasbuh1hhjɍubj2)}(h h]h }(hj hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjɍubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjɍubjI)}(hkobjh]hkobj}(hj$hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjɍubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjōubjC)}(hconst struct attribute *attrh](j )}(hjJh]hconst}(hj=hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj9ubj2)}(h h]h }(hjJhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj9ubj )}(hjh]hstruct}(hjXhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj9ubj2)}(h h]h }(hjehhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj9ubh)}(hhh]jI)}(h attributeh]h attribute}(hjvhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjsubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjxmodnameN classnameNjj )}j ]jc.sysfs_break_active_protectionasbuh1hhj9ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj9ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9ubjI)}(hattrh]hattr}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj9ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjōubeh}(h]h ]h"]h$]h&]j`jauh1j<hjOhhhj`hMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjKhhhj`hMubah}(h]jFah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj`hMhjHhhubjw)}(hhh]h)}(hbreak "active" protectionh]hbreak “active” protection}(hjَhhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMhj֎hhubah}(h]h ]h"]h$]h&]uh1jvhjHhhhj`hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjhNhNubj)}(hX**Parameters** ``struct kobject *kobj`` The kernel object **attr** is associated with. ``const struct attribute *attr`` The attribute to break the "active" protection for. **Description** With sysfs, just like kernfs, deletion of an attribute is postponed until all active .show() and .store() callbacks have finished unless this function is called. Hence this function is useful in methods that implement self deletion.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMhjubj)}(hhh](j)}(hH``struct kobject *kobj`` The kernel object **attr** is associated with. h](j)}(h``struct kobject *kobj``h]j)}(hjh]hstruct kobject *kobj}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMhjubj)}(hhh]h)}(h.The kernel object **attr** is associated with.h](hThe kernel object }(hj3hhhNhNubj)}(h**attr**h]hattr}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj3ubh is associated with.}(hj3hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj/hMhj0ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj/hMhjubj)}(hU``const struct attribute *attr`` The attribute to break the "active" protection for. h](j)}(h ``const struct attribute *attr``h]j)}(hjeh]hconst struct attribute *attr}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1jhjcubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMhj_ubj)}(hhh]h)}(h3The attribute to break the "active" protection for.h]h7The attribute to break the “active” protection for.}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjzhMhj{ubah}(h]h ]h"]h$]h&]uh1jhj_ubeh}(h]h ]h"]h$]h&]uh1jhjzhMhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMhjubh)}(hWith sysfs, just like kernfs, deletion of an attribute is postponed until all active .show() and .store() callbacks have finished unless this function is called. Hence this function is useful in methods that implement self deletion.h]hWith sysfs, just like kernfs, deletion of an attribute is postponed until all active .show() and .store() callbacks have finished unless this function is called. Hence this function is useful in methods that implement self deletion.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j ,sysfs_unbreak_active_protection (C function)!c.sysfs_unbreak_active_protectionhNtauh1hhjhhhNhNubj)}(hhh](j)}(h=void sysfs_unbreak_active_protection (struct kernfs_node *kn)h]j)}(hah"]h$]h&]uh1j1hjhhhjhMubjC)}(hsysfs_unbreak_active_protectionh]jI)}(hsysfs_unbreak_active_protectionh]hsysfs_unbreak_active_protection}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhMubj=)}(h(struct kernfs_node *kn)h]jC)}(hstruct kernfs_node *knh](j )}(hjh]hstruct}(hj"hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hj/hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(h kernfs_nodeh]h kernfs_node}(hj@hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj=ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjBmodnameN classnameNjj )}j ]j)}jjsb!c.sysfs_unbreak_active_protectionasbuh1hhjubj2)}(h h]h }(hj`hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjnhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hknh]hkn}(hj{hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubah}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjݏhhhjhMubah}(h]j؏ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMhjڏhhubjw)}(hhh]h)}(hrestore "active" protectionh]hrestore “active” protection}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMhjhhubah}(h]h ]h"]h$]h&]uh1jvhjڏhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjhNhNubj)}(hX**Parameters** ``struct kernfs_node *kn`` Pointer returned by sysfs_break_active_protection(). **Description** Undo the effects of sysfs_break_active_protection(). Since this function calls kernfs_put() on the kernfs node that corresponds to the 'attr' argument passed to sysfs_break_active_protection() that attribute may have been removed between the sysfs_break_active_protection() and sysfs_unbreak_active_protection() calls, it is not safe to access **kn** after this function has returned.h](h)}(h**Parameters**h]j)}(hjǐh]h Parameters}(hjɐhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjŐubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMhjubj)}(hhh]j)}(hP``struct kernfs_node *kn`` Pointer returned by sysfs_break_active_protection(). h](j)}(h``struct kernfs_node *kn``h]j)}(hjh]hstruct kernfs_node *kn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMhjubj)}(hhh]h)}(h4Pointer returned by sysfs_break_active_protection().h]h4Pointer returned by sysfs_break_active_protection().}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjݐubah}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hj!h]h Description}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMhjubh)}(hXUndo the effects of sysfs_break_active_protection(). Since this function calls kernfs_put() on the kernfs node that corresponds to the 'attr' argument passed to sysfs_break_active_protection() that attribute may have been removed between the sysfs_break_active_protection() and sysfs_unbreak_active_protection() calls, it is not safe to access **kn** after this function has returned.h](hX\Undo the effects of sysfs_break_active_protection(). Since this function calls kernfs_put() on the kernfs node that corresponds to the ‘attr’ argument passed to sysfs_break_active_protection() that attribute may have been removed between the sysfs_break_active_protection() and sysfs_unbreak_active_protection() calls, it is not safe to access }(hj7hhhNhNubj)}(h**kn**h]hkn}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj7ubh" after this function has returned.}(hj7hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j !sysfs_remove_file_ns (C function)c.sysfs_remove_file_nshNtauh1hhjhhhNhNubj)}(hhh](j)}(hjvoid sysfs_remove_file_ns (struct kobject *kobj, const struct attribute *attr, const struct ns_common *ns)h]j)}(hivoid sysfs_remove_file_ns(struct kobject *kobj, const struct attribute *attr, const struct ns_common *ns)h](j)}(hvoidh]hvoid}(hjxhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjthhhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjthhhjhMubjC)}(hsysfs_remove_file_nsh]jI)}(hsysfs_remove_file_nsh]hsysfs_remove_file_ns}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjthhhjhMubj=)}(hP(struct kobject *kobj, const struct attribute *attr, const struct ns_common *ns)h](jC)}(hstruct kobject *kobjh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hj‘hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hkobjecth]hkobject}(hjӑhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjБubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjՑmodnameN classnameNjj )}j ]j)}jjsbc.sysfs_remove_file_nsasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hkobjh]hkobj}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hconst struct attribute *attrh](j )}(hjJh]hconst}(hj'hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj#ubj2)}(h h]h }(hj4hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj#ubj )}(hjh]hstruct}(hjBhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj#ubj2)}(h h]h }(hjOhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj#ubh)}(hhh]jI)}(h attributeh]h attribute}(hj`hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj]ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjbmodnameN classnameNjj )}j ]jc.sysfs_remove_file_nsasbuh1hhj#ubj2)}(h h]h }(hj~hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj#ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#ubjI)}(hattrh]hattr}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj#ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hconst struct ns_common *nsh](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj )}(hjh]hstruct}(hj͒hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjڒhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(h ns_commonh]h ns_common}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.sysfs_remove_file_nsasbuh1hhjubj2)}(h h]h }(hj hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hnsh]hns}(hj$hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjthhhjhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjphhhjhMubah}(h]jkah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMhjmhhubjw)}(hhh]h)}(h/remove an object attribute with a custom ns tagh]h/remove an object attribute with a custom ns tag}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMhjKhhubah}(h]h ]h"]h$]h&]uh1jvhjmhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjfjjfjjjuh1jhhhjhNhNubj)}(hX**Parameters** ``struct kobject *kobj`` object we're acting for ``const struct attribute *attr`` attribute descriptor ``const struct ns_common *ns`` namespace tag of the file to remove **Description** Hash the attribute name and namespace tag and kill the victim.h](h)}(h**Parameters**h]j)}(hjph]h Parameters}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjnubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMhjjubj)}(hhh](j)}(h1``struct kobject *kobj`` object we're acting for h](j)}(h``struct kobject *kobj``h]j)}(hjh]hstruct kobject *kobj}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMhjubj)}(hhh]h)}(hobject we're acting forh]hobject we’re acting for}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h6``const struct attribute *attr`` attribute descriptor h](j)}(h ``const struct attribute *attr``h]j)}(hjȓh]hconst struct attribute *attr}(hjʓhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjƓubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMhj“ubj)}(hhh]h)}(hattribute descriptorh]hattribute descriptor}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjݓhMhjޓubah}(h]h ]h"]h$]h&]uh1jhj“ubeh}(h]h ]h"]h$]h&]uh1jhjݓhMhjubj)}(hC``const struct ns_common *ns`` namespace tag of the file to remove h](j)}(h``const struct ns_common *ns``h]j)}(hjh]hconst struct ns_common *ns}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMhjubj)}(hhh]h)}(h#namespace tag of the file to removeh]h#namespace tag of the file to remove}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubeh}(h]h ]h"]h$]h&]uh1jhjjubh)}(h**Description**h]j)}(hj<h]h Description}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj:ubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMhjjubh)}(h>Hash the attribute name and namespace tag and kill the victim.h]h>Hash the attribute name and namespace tag and kill the victim.}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMhjjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j #sysfs_remove_file_self (C function)c.sysfs_remove_file_selfhNtauh1hhjhhhNhNubj)}(hhh](j)}(hPbool sysfs_remove_file_self (struct kobject *kobj, const struct attribute *attr)h]j)}(hObool sysfs_remove_file_self(struct kobject *kobj, const struct attribute *attr)h](j)}(hjh]hbool}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj}hhhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj}hhhjhMubjC)}(hsysfs_remove_file_selfh]jI)}(hsysfs_remove_file_selfh]hsysfs_remove_file_self}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj}hhhjhMubj=)}(h4(struct kobject *kobj, const struct attribute *attr)h](jC)}(hstruct kobject *kobjh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjʔhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hkobjecth]hkobject}(hj۔hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjؔubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjݔmodnameN classnameNjj )}j ]j)}jjsbc.sysfs_remove_file_selfasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hkobjh]hkobj}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hconst struct attribute *attrh](j )}(hjJh]hconst}(hj/hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj+ubj2)}(h h]h }(hj<hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj+ubj )}(hjh]hstruct}(hjJhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj+ubj2)}(h h]h }(hjWhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj+ubh)}(hhh]jI)}(h attributeh]h attribute}(hjhhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjeubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjjmodnameN classnameNjj )}j ]jc.sysfs_remove_file_selfasbuh1hhj+ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj+ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubjI)}(hattrh]hattr}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj+ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hj}hhhjhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjyhhhjhMubah}(h]jtah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMhjvhhubjw)}(hhh]h)}(h.remove an object attribute from its own methodh]h.remove an object attribute from its own method}(hj˕hhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMhjȕhhubah}(h]h ]h"]h$]h&]uh1jvhjvhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjhNhNubj)}(h**Parameters** ``struct kobject *kobj`` object we're acting for ``const struct attribute *attr`` attribute descriptor **Description** See kernfs_remove_self() for details.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chM hjubj)}(hhh](j)}(h1``struct kobject *kobj`` object we're acting for h](j)}(h``struct kobject *kobj``h]j)}(hj h]hstruct kobject *kobj}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chM hjubj)}(hhh]h)}(hobject we're acting forh]hobject we’re acting for}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj!hM hj"ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj!hM hjubj)}(h6``const struct attribute *attr`` attribute descriptor h](j)}(h ``const struct attribute *attr``h]j)}(hjEh]hconst struct attribute *attr}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjCubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chM hj?ubj)}(hhh]h)}(hattribute descriptorh]hattribute descriptor}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjZhM hj[ubah}(h]h ]h"]h$]h&]uh1jhj?ubeh}(h]h ]h"]h$]h&]uh1jhjZhM hjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj~ubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chM hjubh)}(h%See kernfs_remove_self() for details.h]h%See kernfs_remove_self() for details.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chM hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j )sysfs_remove_file_from_group (C function)c.sysfs_remove_file_from_grouphNtauh1hhjhhhNhNubj)}(hhh](j)}(hivoid sysfs_remove_file_from_group (struct kobject *kobj, const struct attribute *attr, const char *group)h]j)}(hhvoid sysfs_remove_file_from_group(struct kobject *kobj, const struct attribute *attr, const char *group)h](j)}(hvoidh]hvoid}(hjŖhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chM)ubj2)}(h h]h }(hjԖhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjӖhM)ubjC)}(hsysfs_remove_file_from_grouph]jI)}(hsysfs_remove_file_from_grouph]hsysfs_remove_file_from_group}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjӖhM)ubj=)}(hG(struct kobject *kobj, const struct attribute *attr, const char *group)h](jC)}(hstruct kobject *kobjh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hkobjecth]hkobject}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj"modnameN classnameNjj )}j ]j)}jjsbc.sysfs_remove_file_from_groupasbuh1hhjubj2)}(h h]h }(hj@hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hkobjh]hkobj}(hj[hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hconst struct attribute *attrh](j )}(hjJh]hconst}(hjthhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjpubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjpubj )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjpubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjpubh)}(hhh]jI)}(h attributeh]h attribute}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j<c.sysfs_remove_file_from_groupasbuh1hhjpubj2)}(h h]h }(hj˗hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjpubj)}(hjh]h*}(hjٗhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpubjI)}(hattrh]hattr}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjpubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hconst char *grouph](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hj hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hcharh]hchar}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hj(hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj6hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hgrouph]hgroup}(hjChhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjӖhM)ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjӖhM)ubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjӖhM)hjhhubjw)}(hhh]h)}(h&remove an attribute file from a group.h]h&remove an attribute file from a group.}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chM)hjjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjӖhM)ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjhNhNubj)}(h**Parameters** ``struct kobject *kobj`` object we're acting for. ``const struct attribute *attr`` attribute descriptor. ``const char *group`` group name.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chM-hjubj)}(hhh](j)}(h2``struct kobject *kobj`` object we're acting for. h](j)}(h``struct kobject *kobj``h]j)}(hjh]hstruct kobject *kobj}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chM*hjubj)}(hhh]h)}(hobject we're acting for.h]hobject we’re acting for.}(hjǘhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjØhM*hjĘubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjØhM*hjubj)}(h7``const struct attribute *attr`` attribute descriptor. h](j)}(h ``const struct attribute *attr``h]j)}(hjh]hconst struct attribute *attr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chM+hjubj)}(hhh]h)}(hattribute descriptor.h]hattribute descriptor.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM+hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM+hjubj)}(h!``const char *group`` group name.h](j)}(h``const char *group``h]j)}(hj h]hconst char *group}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chM-hjubj)}(hhh]h)}(h group name.h]h group name.}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chM,hj6ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj5hM-hjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j "sysfs_create_bin_file (C function)c.sysfs_create_bin_filehNtauh1hhjhhhNhNubj)}(hhh](j)}(hRint sysfs_create_bin_file (struct kobject *kobj, const struct bin_attribute *attr)h]j)}(hQint sysfs_create_bin_file(struct kobject *kobj, const struct bin_attribute *attr)h](j)}(hinth]hint}(hjzhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvhhhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMBubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjvhhhjhMBubjC)}(hsysfs_create_bin_fileh]jI)}(hsysfs_create_bin_fileh]hsysfs_create_bin_file}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjvhhhjhMBubj=)}(h8(struct kobject *kobj, const struct bin_attribute *attr)h](jC)}(hstruct kobject *kobjh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjęhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hkobjecth]hkobject}(hjՙhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjҙubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjיmodnameN classnameNjj )}j ]j)}jjsbc.sysfs_create_bin_fileasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hkobjh]hkobj}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h const struct bin_attribute *attrh](j )}(hjJh]hconst}(hj)hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj%ubj2)}(h h]h }(hj6hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj%ubj )}(hjh]hstruct}(hjDhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj%ubj2)}(h h]h }(hjQhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj%ubh)}(hhh]jI)}(h bin_attributeh]h bin_attribute}(hjbhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj_ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjdmodnameN classnameNjj )}j ]jc.sysfs_create_bin_fileasbuh1hhj%ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj%ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%ubjI)}(hattrh]hattr}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj%ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjvhhhjhMBubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjrhhhjhMBubah}(h]jmah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMBhjohhubjw)}(hhh]h)}(hcreate binary file for object.h]hcreate binary file for object.}(hjŚhhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMBhjšhhubah}(h]h ]h"]h$]h&]uh1jvhjohhhjhMBubeh}(h]h ](jfunctioneh"]h$]h&]jjjjݚjjݚjjjuh1jhhhjhNhNubj)}(hp**Parameters** ``struct kobject *kobj`` object. ``const struct bin_attribute *attr`` attribute descriptor.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMFhjubj)}(hhh](j)}(h!``struct kobject *kobj`` object. h](j)}(h``struct kobject *kobj``h]j)}(hjh]hstruct kobject *kobj}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMChjubj)}(hhh]h)}(hobject.h]hobject.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMChjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMChjubj)}(h:``const struct bin_attribute *attr`` attribute descriptor.h](j)}(h$``const struct bin_attribute *attr``h]j)}(hj?h]h const struct bin_attribute *attr}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj=ubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMEhj9ubj)}(hhh]h)}(hattribute descriptor.h]hattribute descriptor.}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMDhjUubah}(h]h ]h"]h$]h&]uh1jhj9ubeh}(h]h ]h"]h$]h&]uh1jhjThMEhjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j "sysfs_remove_bin_file (C function)c.sysfs_remove_bin_filehNtauh1hhjhhhNhNubj)}(hhh](j)}(hSvoid sysfs_remove_bin_file (struct kobject *kobj, const struct bin_attribute *attr)h]j)}(hRvoid sysfs_remove_bin_file(struct kobject *kobj, const struct bin_attribute *attr)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMVubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMVubjC)}(hsysfs_remove_bin_fileh]jI)}(hsysfs_remove_bin_fileh]hsysfs_remove_bin_file}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhMVubj=)}(h8(struct kobject *kobj, const struct bin_attribute *attr)h](jC)}(hstruct kobject *kobjh](j )}(hjh]hstruct}(hj֛hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjқubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjқubh)}(hhh]jI)}(hkobjecth]hkobject}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jjsbc.sysfs_remove_bin_fileasbuh1hhjқubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjқubj)}(hjh]h*}(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjқubjI)}(hkobjh]hkobj}(hj/hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjқubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjΛubjC)}(h const struct bin_attribute *attrh](j )}(hjJh]hconst}(hjHhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjDubj2)}(h h]h }(hjUhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjDubj )}(hjh]hstruct}(hjchhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjDubj2)}(h h]h }(hjphhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjDubh)}(hhh]jI)}(h bin_attributeh]h bin_attribute}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj~ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.sysfs_remove_bin_fileasbuh1hhjDubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjDubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjDubjI)}(hattrh]hattr}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjDubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjΛubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhMVubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhMVubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMVhjhhubjw)}(hhh]h)}(hremove binary file for object.h]hremove binary file for object.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMVhjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhMVubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjhNhNubj)}(hp**Parameters** ``struct kobject *kobj`` object. ``const struct bin_attribute *attr`` attribute descriptor.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMZhjubj)}(hhh](j)}(h!``struct kobject *kobj`` object. h](j)}(h``struct kobject *kobj``h]j)}(hj%h]hstruct kobject *kobj}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj#ubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMWhjubj)}(hhh]h)}(hobject.h]hobject.}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj:hMWhj;ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj:hMWhjubj)}(h:``const struct bin_attribute *attr`` attribute descriptor.h](j)}(h$``const struct bin_attribute *attr``h]j)}(hj^h]h const struct bin_attribute *attr}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj\ubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMYhjXubj)}(hhh]h)}(hattribute descriptor.h]hattribute descriptor.}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMXhjtubah}(h]h ]h"]h$]h&]uh1jhjXubeh}(h]h ]h"]h$]h&]uh1jhjshMYhjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j sysfs_emit (C function) c.sysfs_emithNtauh1hhjhhhNhNubj)}(hhh](j)}(h0int sysfs_emit (char *buf, const char *fmt, ...)h]j)}(h/int sysfs_emit(char *buf, const char *fmt, ...)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMubj2)}(h h]h }(hjǝhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjƝhMubjC)}(h sysfs_emith]jI)}(h sysfs_emith]h sysfs_emit}(hjٝhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj՝ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjƝhMubj=)}(h!(char *buf, const char *fmt, ...)h](jC)}(h char *bufh](j)}(hcharh]hchar}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hbufh]hbuf}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hconst char *fmth](j )}(hjJh]hconst}(hj7hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj3ubj2)}(h h]h }(hjDhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj3ubj)}(hcharh]hchar}(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3ubj2)}(h h]h }(hj`hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj3ubj)}(hjh]h*}(hjnhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3ubjI)}(hfmth]hfmt}(hj{hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj3ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h...h]j)}(h...h]h...}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjƝhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjƝhMubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjƝhMhjhhubjw)}(hhh]h)}(h0scnprintf equivalent, aware of PAGE_SIZE buffer.h]h0scnprintf equivalent, aware of PAGE_SIZE buffer.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMhjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjƝhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjj֞jj֞jjjuh1jhhhjhNhNubj)}(h**Parameters** ``char *buf`` start of PAGE_SIZE buffer. ``const char *fmt`` format ``...`` optional arguments to **format** **Description** Returns number of characters written to **buf**.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjޞubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMhjڞubj)}(hhh](j)}(h)``char *buf`` start of PAGE_SIZE buffer. h](j)}(h ``char *buf``h]j)}(hjh]h char *buf}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMhjubj)}(hhh]h)}(hstart of PAGE_SIZE buffer.h]hstart of PAGE_SIZE buffer.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h``const char *fmt`` format h](j)}(h``const char *fmt``h]j)}(hj8h]hconst char *fmt}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj6ubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMhj2ubj)}(hhh]h)}(hformath]hformat}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjMhMhjNubah}(h]h ]h"]h$]h&]uh1jhj2ubeh}(h]h ]h"]h$]h&]uh1jhjMhMhjubj)}(h)``...`` optional arguments to **format** h](j)}(h``...``h]j)}(hjqh]h...}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1jhjoubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMhjkubj)}(hhh]h)}(h optional arguments to **format**h](hoptional arguments to }(hjhhhNhNubj)}(h **format**h]hformat}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjkubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubeh}(h]h ]h"]h$]h&]uh1jhjڞubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMhjڞubh)}(h0Returns number of characters written to **buf**.h](h(Returns number of characters written to }(hjПhhhNhNubj)}(h**buf**h]hbuf}(hj؟hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjПubh.}(hjПhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMhjڞubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j sysfs_emit_at (C function)c.sysfs_emit_athNtauh1hhjhhhNhNubj)}(hhh](j)}(h;int sysfs_emit_at (char *buf, int at, const char *fmt, ...)h]j)}(h:int sysfs_emit_at(char *buf, int at, const char *fmt, ...)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMubj2)}(h h]h }(hj hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj hhhjhMubjC)}(h sysfs_emit_ath]jI)}(h sysfs_emit_ath]h sysfs_emit_at}(hj2hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj.ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj hhhjhMubj=)}(h)(char *buf, int at, const char *fmt, ...)h](jC)}(h char *bufh](j)}(hcharh]hchar}(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJubj2)}(h h]h }(hj\hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjJubj)}(hjh]h*}(hjjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJubjI)}(hbufh]hbuf}(hjwhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjJubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjFubjC)}(hint ath](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hath]hat}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjFubjC)}(hconst char *fmth](j )}(hjJh]hconst}(hjŠhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjҠhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hcharh]hchar}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hfmth]hfmt}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjFubjC)}(h...h]j)}(hjh]h...}(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]noemphj`jauh1jBhjFubeh}(h]h ]h"]h$]h&]j`jauh1j<hj hhhjhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj hhhjhMubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMhjhhubjw)}(hhh]h)}(h0scnprintf equivalent, aware of PAGE_SIZE buffer.h]h0scnprintf equivalent, aware of PAGE_SIZE buffer.}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMhjHhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjcjjcjjjuh1jhhhjhNhNubj)}(hX3**Parameters** ``char *buf`` start of PAGE_SIZE buffer. ``int at`` offset in **buf** to start write in bytes **at** must be >= 0 && < PAGE_SIZE ``const char *fmt`` format ``...`` optional arguments to **fmt** **Description** Returns number of characters written starting at &**buf**[**at**].h](h)}(h**Parameters**h]j)}(hjmh]h Parameters}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1jhjkubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMhjgubj)}(hhh](j)}(h)``char *buf`` start of PAGE_SIZE buffer. h](j)}(h ``char *buf``h]j)}(hjh]h char *buf}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMhjubj)}(hhh]h)}(hstart of PAGE_SIZE buffer.h]hstart of PAGE_SIZE buffer.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(hX``int at`` offset in **buf** to start write in bytes **at** must be >= 0 && < PAGE_SIZE h](j)}(h ``int at``h]j)}(hjšh]hint at}(hjǡhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjáubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMhjubj)}(hhh]h)}(hLoffset in **buf** to start write in bytes **at** must be >= 0 && < PAGE_SIZEh](h offset in }(hjޡhhhNhNubj)}(h**buf**h]hbuf}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjޡubh to start write in bytes }(hjޡhhhNhNubj)}(h**at**h]hat}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjޡubh must be >= 0 && < PAGE_SIZE}(hjޡhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMhjۡubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjڡhMhjubj)}(h``const char *fmt`` format h](j)}(h``const char *fmt``h]j)}(hj#h]hconst char *fmt}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj!ubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMhjubj)}(hhh]h)}(hformath]hformat}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj8hMhj9ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj8hMhjubj)}(h&``...`` optional arguments to **fmt** h](j)}(h``...``h]j)}(hj\h]h...}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjZubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMhjVubj)}(hhh]h)}(hoptional arguments to **fmt**h](hoptional arguments to }(hjuhhhNhNubj)}(h**fmt**h]hfmt}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjuubeh}(h]h ]h"]h$]h&]uh1hhjqhMhjrubah}(h]h ]h"]h$]h&]uh1jhjVubeh}(h]h ]h"]h$]h&]uh1jhjqhMhjubeh}(h]h ]h"]h$]h&]uh1jhjgubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMhjgubh)}(hBReturns number of characters written starting at &**buf**[**at**].h](h:Returns number of characters written starting at &**buf**[}(hjhhhNhNubj)}(h**at**h]hat}(hjâhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh].}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMhjgubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j 'sysfs_bin_attr_simple_read (C function)c.sysfs_bin_attr_simple_readhNtauh1hhjhhhNhNubj)}(hhh](j)}(hssize_t sysfs_bin_attr_simple_read (struct file *file, struct kobject *kobj, const struct bin_attribute *attr, char *buf, loff_t off, size_t count)h]j)}(hssize_t sysfs_bin_attr_simple_read(struct file *file, struct kobject *kobj, const struct bin_attribute *attr, char *buf, loff_t off, size_t count)h](h)}(hhh]jI)}(hssize_th]hssize_t}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jsysfs_bin_attr_simple_readsbc.sysfs_bin_attr_simple_readasbuh1hhjhhhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMubj2)}(h h]h }(hj!hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhj hMubjC)}(hsysfs_bin_attr_simple_readh]jI)}(hjh]hsysfs_bin_attr_simple_read}(hj3hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj/ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhj hMubj=)}(hp(struct file *file, struct kobject *kobj, const struct bin_attribute *attr, char *buf, loff_t off, size_t count)h](jC)}(hstruct file *fileh](j )}(hjh]hstruct}(hjNhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjJubj2)}(h h]h }(hj[hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjJubh)}(hhh]jI)}(hfileh]hfile}(hjlhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjiubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjnmodnameN classnameNjj )}j ]jc.sysfs_bin_attr_simple_readasbuh1hhjJubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjJubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJubjI)}(hfileh]hfile}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjJubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjFubjC)}(hstruct kobject *kobjh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjˣhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hkobjecth]hkobject}(hjܣhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj٣ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjޣmodnameN classnameNjj )}j ]jc.sysfs_bin_attr_simple_readasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hkobjh]hkobj}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjFubjC)}(h const struct bin_attribute *attrh](j )}(hjJh]hconst}(hj.hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj*ubj2)}(h h]h }(hj;hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj*ubj )}(hjh]hstruct}(hjIhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj*ubj2)}(h h]h }(hjVhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj*ubh)}(hhh]jI)}(h bin_attributeh]h bin_attribute}(hjghhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjdubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjimodnameN classnameNjj )}j ]jc.sysfs_bin_attr_simple_readasbuh1hhj*ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj*ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*ubjI)}(hattrh]hattr}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj*ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjFubjC)}(h char *bufh](j)}(hcharh]hchar}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjǤhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjդhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hbufh]hbuf}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjFubjC)}(h loff_t offh](h)}(hhh]jI)}(hloff_th]hloff_t}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.sysfs_bin_attr_simple_readasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hoffh]hoff}(hj*hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjFubjC)}(h size_t counth](h)}(hhh]jI)}(hsize_th]hsize_t}(hjFhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjCubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjHmodnameN classnameNjj )}j ]jc.sysfs_bin_attr_simple_readasbuh1hhj?ubj2)}(h h]h }(hjdhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj?ubjI)}(hcounth]hcount}(hjrhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj?ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjFubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhj hMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhj hMubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj hMhjhhubjw)}(hhh]h)}(h)read callback to simply copy from memory.h]h)read callback to simply copy from memory.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMhjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhj hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjhNhNubj)}(hX**Parameters** ``struct file *file`` attribute file which is being read. ``struct kobject *kobj`` object to which the attribute belongs. ``const struct bin_attribute *attr`` attribute descriptor. ``char *buf`` destination buffer. ``loff_t off`` offset in bytes from which to read. ``size_t count`` maximum number of bytes to read. **Description** Simple ->read() callback for bin_attributes backed by a buffer in memory. The **private** and **size** members in struct bin_attribute must be set to the buffer's location and size before the bin_attribute is created in sysfs. Bounds check for **off** and **count** is done in sysfs_kf_bin_read(). Negative value check for **off** is done in vfs_setpos() and default_llseek(). Returns number of bytes written to **buf**.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chM!hjubj)}(hhh](j)}(h:``struct file *file`` attribute file which is being read. h](j)}(h``struct file *file``h]j)}(hjݥh]hstruct file *file}(hjߥhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjۥubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMhjץubj)}(hhh]h)}(h#attribute file which is being read.h]h#attribute file which is being read.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjץubeh}(h]h ]h"]h$]h&]uh1jhjhMhjԥubj)}(h@``struct kobject *kobj`` object to which the attribute belongs. h](j)}(h``struct kobject *kobj``h]j)}(hjh]hstruct kobject *kobj}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chMhjubj)}(hhh]h)}(h&object to which the attribute belongs.h]h&object to which the attribute belongs.}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj+hMhj,ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj+hMhjԥubj)}(h;``const struct bin_attribute *attr`` attribute descriptor. h](j)}(h$``const struct bin_attribute *attr``h]j)}(hjOh]h const struct bin_attribute *attr}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjMubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chM hjIubj)}(hhh]h)}(hattribute descriptor.h]hattribute descriptor.}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjdhM hjeubah}(h]h ]h"]h$]h&]uh1jhjIubeh}(h]h ]h"]h$]h&]uh1jhjdhM hjԥubj)}(h"``char *buf`` destination buffer. h](j)}(h ``char *buf``h]j)}(hjh]h char *buf}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chM!hjubj)}(hhh]h)}(hdestination buffer.h]hdestination buffer.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM!hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM!hjԥubj)}(h3``loff_t off`` offset in bytes from which to read. h](j)}(h``loff_t off``h]j)}(hjh]h loff_t off}(hjæhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chM"hjubj)}(hhh]h)}(h#offset in bytes from which to read.h]h#offset in bytes from which to read.}(hjڦhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj֦hM"hjצubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj֦hM"hjԥubj)}(h2``size_t count`` maximum number of bytes to read. h](j)}(h``size_t count``h]j)}(hjh]h size_t count}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chM#hjubj)}(hhh]h)}(h maximum number of bytes to read.h]h maximum number of bytes to read.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM#hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM#hjԥubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hj5h]h Description}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj3ubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chM%hjubh)}(hSimple ->read() callback for bin_attributes backed by a buffer in memory. The **private** and **size** members in struct bin_attribute must be set to the buffer's location and size before the bin_attribute is created in sysfs.h](hNSimple ->read() callback for bin_attributes backed by a buffer in memory. The }(hjKhhhNhNubj)}(h **private**h]hprivate}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1jhjKubh and }(hjKhhhNhNubj)}(h**size**h]hsize}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1jhjKubh~ members in struct bin_attribute must be set to the buffer’s location and size before the bin_attribute is created in sysfs.}(hjKhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chM$hjubh)}(hBounds check for **off** and **count** is done in sysfs_kf_bin_read(). Negative value check for **off** is done in vfs_setpos() and default_llseek().h](hBounds check for }(hj~hhhNhNubj)}(h**off**h]hoff}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj~ubh and }(hj~hhhNhNubj)}(h **count**h]hcount}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj~ubh: is done in sysfs_kf_bin_read(). Negative value check for }(hj~hhhNhNubj)}(h**off**h]hoff}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj~ubh. is done in vfs_setpos() and default_llseek().}(hj~hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chM(hjubh)}(h+Returns number of bytes written to **buf**.h](h#Returns number of bytes written to }(hjçhhhNhNubj)}(h**buf**h]hbuf}(hj˧hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjçubh.}(hjçhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:134: ./fs/sysfs/file.chM+hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j sysfs_create_link (C function)c.sysfs_create_linkhNtauh1hhjhhhNhNubj)}(hhh](j)}(hVint sysfs_create_link (struct kobject *kobj, struct kobject *target, const char *name)h]j)}(hUint sysfs_create_link(struct kobject *kobj, struct kobject *target, const char *name)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:137: ./fs/sysfs/symlink.chKTubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhKTubjC)}(hsysfs_create_linkh]jI)}(hsysfs_create_linkh]hsysfs_create_link}(hj%hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj!ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhKTubj=)}(h@(struct kobject *kobj, struct kobject *target, const char *name)h](jC)}(hstruct kobject *kobjh](j )}(hjh]hstruct}(hjAhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj=ubj2)}(h h]h }(hjNhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj=ubh)}(hhh]jI)}(hkobjecth]hkobject}(hj_hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj\ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjamodnameN classnameNjj )}j ]j)}jj'sbc.sysfs_create_linkasbuh1hhj=ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj=ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=ubjI)}(hkobjh]hkobj}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj=ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj9ubjC)}(hstruct kobject *targeth](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hkobjecth]hkobject}(hjѨhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjΨubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjӨmodnameN classnameNjj )}j ]j{c.sysfs_create_linkasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(htargeth]htarget}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj9ubjC)}(hconst char *nameh](j )}(hjJh]hconst}(hj#hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hj0hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hcharh]hchar}(hj>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjLhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hnameh]hname}(hjghhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj9ubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhKTubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhKTubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhKThjhhubjw)}(hhh]h)}(h#create symlink between two objects.h]h#create symlink between two objects.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:137: ./fs/sysfs/symlink.chKThjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhKTubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjhNhNubj)}(h**Parameters** ``struct kobject *kobj`` object whose directory we're creating the link in. ``struct kobject *target`` object we're pointing to. ``const char *name`` name of the symlink.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:137: ./fs/sysfs/symlink.chKXhjubj)}(hhh](j)}(hL``struct kobject *kobj`` object whose directory we're creating the link in. h](j)}(h``struct kobject *kobj``h]j)}(hjҩh]hstruct kobject *kobj}(hjԩhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjЩubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:137: ./fs/sysfs/symlink.chKUhj̩ubj)}(hhh]h)}(h2object whose directory we're creating the link in.h]h4object whose directory we’re creating the link in.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKUhjubah}(h]h ]h"]h$]h&]uh1jhj̩ubeh}(h]h ]h"]h$]h&]uh1jhjhKUhjɩubj)}(h5``struct kobject *target`` object we're pointing to. h](j)}(h``struct kobject *target``h]j)}(hj h]hstruct kobject *target}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:137: ./fs/sysfs/symlink.chKVhjubj)}(hhh]h)}(hobject we're pointing to.h]hobject we’re pointing to.}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hKVhj!ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj hKVhjɩubj)}(h)``const char *name`` name of the symlink.h](j)}(h``const char *name``h]j)}(hjDh]hconst char *name}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjBubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:137: ./fs/sysfs/symlink.chKXhj>ubj)}(hhh]h)}(hname of the symlink.h]hname of the symlink.}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:137: ./fs/sysfs/symlink.chKWhjZubah}(h]h ]h"]h$]h&]uh1jhj>ubeh}(h]h ]h"]h$]h&]uh1jhjYhKXhjɩubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j %sysfs_create_link_nowarn (C function)c.sysfs_create_link_nowarnhNtauh1hhjhhhNhNubj)}(hhh](j)}(h]int sysfs_create_link_nowarn (struct kobject *kobj, struct kobject *target, const char *name)h]j)}(h\int sysfs_create_link_nowarn(struct kobject *kobj, struct kobject *target, const char *name)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:137: ./fs/sysfs/symlink.chKaubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhKaubjC)}(hsysfs_create_link_nowarnh]jI)}(hsysfs_create_link_nowarnh]hsysfs_create_link_nowarn}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhKaubj=)}(h@(struct kobject *kobj, struct kobject *target, const char *name)h](jC)}(hstruct kobject *kobjh](j )}(hjh]hstruct}(hj۪hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjתubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjתubh)}(hhh]jI)}(hkobjecth]hkobject}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jjsbc.sysfs_create_link_nowarnasbuh1hhjתubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjתubj)}(hjh]h*}(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjתubjI)}(hkobjh]hkobj}(hj4hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjתubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjӪubjC)}(hstruct kobject *targeth](j )}(hjh]hstruct}(hjMhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjIubj2)}(h h]h }(hjZhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjIubh)}(hhh]jI)}(hkobjecth]hkobject}(hjkhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjhubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmmodnameN classnameNjj )}j ]jc.sysfs_create_link_nowarnasbuh1hhjIubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjIubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIubjI)}(htargeth]htarget}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjIubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjӪubjC)}(hconst char *nameh](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjʫhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hcharh]hchar}(hjثhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hnameh]hname}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjӪubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhKaubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhKaubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhKahjhhubjw)}(hhh]h)}(h#create symlink between two objects.h]h#create symlink between two objects.}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:137: ./fs/sysfs/symlink.chKahj(hhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhKaubeh}(h]h ](jfunctioneh"]h$]h&]jjjjCjjCjjjuh1jhhhjhNhNubj)}(hXB**Parameters** ``struct kobject *kobj`` object whose directory we're creating the link in. ``struct kobject *target`` object we're pointing to. ``const char *name`` name of the symlink. **Description** This function does the same as sysfs_create_link(), but it doesn't warn if the link already exists.h](h)}(h**Parameters**h]j)}(hjMh]h Parameters}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjKubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:137: ./fs/sysfs/symlink.chKehjGubj)}(hhh](j)}(hL``struct kobject *kobj`` object whose directory we're creating the link in. h](j)}(h``struct kobject *kobj``h]j)}(hjlh]hstruct kobject *kobj}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjjubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:137: ./fs/sysfs/symlink.chKbhjfubj)}(hhh]h)}(h2object whose directory we're creating the link in.h]h4object whose directory we’re creating the link in.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKbhjubah}(h]h ]h"]h$]h&]uh1jhjfubeh}(h]h ]h"]h$]h&]uh1jhjhKbhjcubj)}(h5``struct kobject *target`` object we're pointing to. h](j)}(h``struct kobject *target``h]j)}(hjh]hstruct kobject *target}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:137: ./fs/sysfs/symlink.chKchjubj)}(hhh]h)}(hobject we're pointing to.h]hobject we’re pointing to.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKchjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKchjcubj)}(h*``const char *name`` name of the symlink. h](j)}(h``const char *name``h]j)}(hjެh]hconst char *name}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjܬubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:137: ./fs/sysfs/symlink.chKdhjجubj)}(hhh]h)}(hname of the symlink.h]hname of the symlink.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKdhjubah}(h]h ]h"]h$]h&]uh1jhjجubeh}(h]h ]h"]h$]h&]uh1jhjhKdhjcubeh}(h]h ]h"]h$]h&]uh1jhjGubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:137: ./fs/sysfs/symlink.chKfhjGubj)}(hcThis function does the same as sysfs_create_link(), but it doesn't warn if the link already exists.h]h)}(hcThis function does the same as sysfs_create_link(), but it doesn't warn if the link already exists.h]heThis function does the same as sysfs_create_link(), but it doesn’t warn if the link already exists.}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:137: ./fs/sysfs/symlink.chKehj/ubah}(h]h ]h"]h$]h&]uh1jhjAhKehjGubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j sysfs_remove_link (C function)c.sysfs_remove_linkhNtauh1hhjhhhNhNubj)}(hhh](j)}(h?void sysfs_remove_link (struct kobject *kobj, const char *name)h]j)}(h>void sysfs_remove_link(struct kobject *kobj, const char *name)h](j)}(hvoidh]hvoid}(hjhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjdhhh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:137: ./fs/sysfs/symlink.chKubj2)}(h h]h }(hjwhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjdhhhjvhKubjC)}(hsysfs_remove_linkh]jI)}(hsysfs_remove_linkh]hsysfs_remove_link}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjdhhhjvhKubj=)}(h((struct kobject *kobj, const char *name)h](jC)}(hstruct kobject *kobjh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hkobjecth]hkobject}(hjíhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjŭmodnameN classnameNjj )}j ]j)}jjsbc.sysfs_remove_linkasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hkobjh]hkobj}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hconst char *nameh](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hj$hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hcharh]hchar}(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hj@hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hnameh]hname}(hj[hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjdhhhjvhKubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj`hhhjvhKubah}(h]j[ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjvhKhj]hhubjw)}(hhh]h)}(h%remove symlink in object's directory.h]h'remove symlink in object’s directory.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:137: ./fs/sysfs/symlink.chKhjhhubah}(h]h ]h"]h$]h&]uh1jvhj]hhhjvhKubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjhNhNubj)}(hz**Parameters** ``struct kobject *kobj`` object we're acting for. ``const char *name`` name of the symlink to remove.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:137: ./fs/sysfs/symlink.chKhjubj)}(hhh](j)}(h2``struct kobject *kobj`` object we're acting for. h](j)}(h``struct kobject *kobj``h]j)}(hjƮh]hstruct kobject *kobj}(hjȮhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjĮubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:137: ./fs/sysfs/symlink.chKhjubj)}(hhh]h)}(hobject we're acting for.h]hobject we’re acting for.}(hj߮hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjۮhKhjܮubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjۮhKhjubj)}(h3``const char *name`` name of the symlink to remove.h](j)}(h``const char *name``h]j)}(hjh]hconst char *name}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:137: ./fs/sysfs/symlink.chKhjubj)}(hhh]h)}(hname of the symlink to remove.h]hname of the symlink to remove.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:137: ./fs/sysfs/symlink.chKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j !sysfs_rename_link_ns (C function)c.sysfs_rename_link_nshNtauh1hhjhhhNhNubj)}(hhh](j)}(hint sysfs_rename_link_ns (struct kobject *kobj, struct kobject *targ, const char *old, const char *new, const struct ns_common *new_ns)h]j)}(hint sysfs_rename_link_ns(struct kobject *kobj, struct kobject *targ, const char *old, const char *new, const struct ns_common *new_ns)h](j)}(hinth]hint}(hjYhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjUhhh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:137: ./fs/sysfs/symlink.chKubj2)}(h h]h }(hjhhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjUhhhjghKubjC)}(hsysfs_rename_link_nsh]jI)}(hsysfs_rename_link_nsh]hsysfs_rename_link_ns}(hjzhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjvubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjUhhhjghKubj=)}(hn(struct kobject *kobj, struct kobject *targ, const char *old, const char *new, const struct ns_common *new_ns)h](jC)}(hstruct kobject *kobjh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hkobjecth]hkobject}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jj|sbc.sysfs_rename_link_nsasbuh1hhjubj2)}(h h]h }(hjԯhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hkobjh]hkobj}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct kobject *targh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hkobjecth]hkobject}(hj&hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj#ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj(modnameN classnameNjj )}j ]jЯc.sysfs_rename_link_nsasbuh1hhjubj2)}(h h]h }(hjDhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(htargh]htarg}(hj_hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hconst char *oldh](j )}(hjJh]hconst}(hjxhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjtubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjtubj)}(hcharh]hchar}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjtubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjtubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjtubjI)}(holdh]hold}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjtubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hconst char *newh](j )}(hjJh]hconst}(hjհhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjѰubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjѰubj)}(hcharh]hchar}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjѰubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjѰubj)}(hjh]h*}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjѰubjI)}(hnewh]hnew}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjѰubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hconst struct ns_common *new_nsh](j )}(hjJh]hconst}(hj2hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj.ubj2)}(h h]h }(hj?hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj.ubj )}(hjh]hstruct}(hjMhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj.ubj2)}(h h]h }(hjZhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj.ubh)}(hhh]jI)}(h ns_commonh]h ns_common}(hjkhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjhubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmmodnameN classnameNjj )}j ]jЯc.sysfs_rename_link_nsasbuh1hhj.ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj.ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj.ubjI)}(hnew_nsh]hnew_ns}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj.ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjUhhhjghKubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjQhhhjghKubah}(h]jLah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjghKhjNhhubjw)}(hhh]h)}(h%rename symlink in object's directory.h]h'rename symlink in object’s directory.}(hjαhhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:137: ./fs/sysfs/symlink.chKhj˱hhubah}(h]h ]h"]h$]h&]uh1jvhjNhhhjghKubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjhNhNubj)}(hXp**Parameters** ``struct kobject *kobj`` object we're acting for. ``struct kobject *targ`` object we're pointing to. ``const char *old`` previous name of the symlink. ``const char *new`` new name of the symlink. ``const struct ns_common *new_ns`` new namespace of the symlink. **Description** A helper function for the common rename symlink idiom.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:137: ./fs/sysfs/symlink.chKhjubj)}(hhh](j)}(h2``struct kobject *kobj`` object we're acting for. h](j)}(h``struct kobject *kobj``h]j)}(hjh]hstruct kobject *kobj}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:137: ./fs/sysfs/symlink.chKhj ubj)}(hhh]h)}(hobject we're acting for.h]hobject we’re acting for.}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj$hKhj%ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj$hKhjubj)}(h3``struct kobject *targ`` object we're pointing to. h](j)}(h``struct kobject *targ``h]j)}(hjHh]hstruct kobject *targ}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjFubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:137: ./fs/sysfs/symlink.chKhjBubj)}(hhh]h)}(hobject we're pointing to.h]hobject we’re pointing to.}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1hhj]hKhj^ubah}(h]h ]h"]h$]h&]uh1jhjBubeh}(h]h ]h"]h$]h&]uh1jhj]hKhjubj)}(h2``const char *old`` previous name of the symlink. h](j)}(h``const char *old``h]j)}(hjh]hconst char *old}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:137: ./fs/sysfs/symlink.chKhj{ubj)}(hhh]h)}(hprevious name of the symlink.h]hprevious name of the symlink.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhj{ubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubj)}(h-``const char *new`` new name of the symlink. h](j)}(h``const char *new``h]j)}(hjh]hconst char *new}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:137: ./fs/sysfs/symlink.chKhjubj)}(hhh]h)}(hnew name of the symlink.h]hnew name of the symlink.}(hjӲhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjϲhKhjвubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjϲhKhjubj)}(hA``const struct ns_common *new_ns`` new namespace of the symlink. h](j)}(h"``const struct ns_common *new_ns``h]j)}(hjh]hconst struct ns_common *new_ns}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:137: ./fs/sysfs/symlink.chKhjubj)}(hhh]h)}(hnew namespace of the symlink.h]hnew namespace of the symlink.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhj ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hj.h]h Description}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj,ubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:137: ./fs/sysfs/symlink.chKhjubj)}(h6A helper function for the common rename symlink idiom.h]h)}(hjFh]h6A helper function for the common rename symlink idiom.}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:137: ./fs/sysfs/symlink.chKhjDubah}(h]h ]h"]h$]h&]uh1jhjUhKhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubeh}(h]+the-filesystem-for-exporting-kernel-objectsah ]h"]+the filesystem for exporting kernel objectsah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(hThe debugfs filesystemh]hThe debugfs filesystem}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjkhhhhhKubh)}(hhh](h)}(hdebugfs interfaceh]hdebugfs interface}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj|hhhhhKubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j debugfs_lookup (C function)c.debugfs_lookuphNtauh1hhj|hhhNhNubj)}(hhh](j)}(hHstruct dentry * debugfs_lookup (const char *name, struct dentry *parent)h]j)}(hFstruct dentry *debugfs_lookup(const char *name, struct dentry *parent)h](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjhhh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMNubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMNubh)}(hhh]jI)}(hdentryh]hdentry}(hjųhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj³ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjdzmodnameN classnameNjj )}j ]j)}jdebugfs_lookupsbc.debugfs_lookupasbuh1hhjhhhjhMNubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMNubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMNubjC)}(hdebugfs_lookuph]jI)}(hjh]hdebugfs_lookup}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhMNubj=)}(h)(const char *name, struct dentry *parent)h](jC)}(hconst char *nameh](j )}(hjJh]hconst}(hj hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hj-hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hcharh]hchar}(hj;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjIhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjWhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hnameh]hname}(hjdhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct dentry *parenth](j )}(hjh]hstruct}(hj}hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjyubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjyubh)}(hhh]jI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.debugfs_lookupasbuh1hhjyubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjyubj)}(hjh]h*}(hjǴhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyubjI)}(hparenth]hparent}(hjԴhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjyubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhMNubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhMNubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMNhjhhubjw)}(hhh]h)}(h look up an existing debugfs fileh]h look up an existing debugfs file}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMNhjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhMNubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhj|hNhNubj)}(hX**Parameters** ``const char *name`` a pointer to a string containing the name of the file to look up. ``struct dentry *parent`` a pointer to the parent dentry of the file. **Description** This function will return a pointer to a dentry if it succeeds. If the file doesn't exist or an error occurs, ``NULL`` will be returned. The returned dentry must be passed to dput() when it is no longer needed. If debugfs is not enabled in the kernel, the value -``ENODEV`` will be returned.h](h)}(h**Parameters**h]j)}(hj h]h Parameters}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMRhjubj)}(hhh](j)}(hW``const char *name`` a pointer to a string containing the name of the file to look up. h](j)}(h``const char *name``h]j)}(hj?h]hconst char *name}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj=ubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMOhj9ubj)}(hhh]h)}(hAa pointer to a string containing the name of the file to look up.h]hAa pointer to a string containing the name of the file to look up.}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjThMOhjUubah}(h]h ]h"]h$]h&]uh1jhj9ubeh}(h]h ]h"]h$]h&]uh1jhjThMOhj6ubj)}(hF``struct dentry *parent`` a pointer to the parent dentry of the file. h](j)}(h``struct dentry *parent``h]j)}(hjxh]hstruct dentry *parent}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjvubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMPhjrubj)}(hhh]h)}(h+a pointer to the parent dentry of the file.h]h+a pointer to the parent dentry of the file.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMPhjubah}(h]h ]h"]h$]h&]uh1jhjrubeh}(h]h ]h"]h$]h&]uh1jhjhMPhj6ubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMRhjubh)}(hThis function will return a pointer to a dentry if it succeeds. If the file doesn't exist or an error occurs, ``NULL`` will be returned. The returned dentry must be passed to dput() when it is no longer needed.h](hqThis function will return a pointer to a dentry if it succeeds. If the file doesn’t exist or an error occurs, }(hjɵhhhNhNubj)}(h``NULL``h]hNULL}(hjѵhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjɵubh] will be returned. The returned dentry must be passed to dput() when it is no longer needed.}(hjɵhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMQhjubh)}(hPIf debugfs is not enabled in the kernel, the value -``ENODEV`` will be returned.h](h4If debugfs is not enabled in the kernel, the value -}(hjhhhNhNubj)}(h ``ENODEV``h]hENODEV}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh will be returned.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMUhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj|hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j 'debugfs_create_file_unsafe (C function)c.debugfs_create_file_unsafehNtauh1hhj|hhhNhNubj)}(hhh](j)}(hstruct dentry * debugfs_create_file_unsafe (const char *name, umode_t mode, struct dentry *parent, void *data, const struct file_operations *fops)h]j)}(hstruct dentry *debugfs_create_file_unsafe(const char *name, umode_t mode, struct dentry *parent, void *data, const struct file_operations *fops)h](j )}(hjh]hstruct}(hj+hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj'hhh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMubj2)}(h h]h }(hj9hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj'hhhj8hMubh)}(hhh]jI)}(hdentryh]hdentry}(hjJhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjGubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjLmodnameN classnameNjj )}j ]j)}jdebugfs_create_file_unsafesbc.debugfs_create_file_unsafeasbuh1hhj'hhhj8hMubj2)}(h h]h }(hjkhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj'hhhj8hMubj)}(hjh]h*}(hjyhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj'hhhj8hMubjC)}(hdebugfs_create_file_unsafeh]jI)}(hjhh]hdebugfs_create_file_unsafe}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj'hhhj8hMubj=)}(hg(const char *name, umode_t mode, struct dentry *parent, void *data, const struct file_operations *fops)h](jC)}(hconst char *nameh](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hcharh]hchar}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjζhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjܶhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hnameh]hname}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h umode_t modeh](h)}(hhh]jI)}(humode_th]humode_t}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jfc.debugfs_create_file_unsafeasbuh1hhjubj2)}(h h]h }(hj#hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hmodeh]hmode}(hj1hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct dentry *parenth](j )}(hjh]hstruct}(hjJhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjFubj2)}(h h]h }(hjWhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjFubh)}(hhh]jI)}(hdentryh]hdentry}(hjhhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjeubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjjmodnameN classnameNjj )}j ]jfc.debugfs_create_file_unsafeasbuh1hhjFubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjFubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFubjI)}(hparenth]hparent}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjFubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h void *datah](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjȷhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjַhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hdatah]hdata}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h"const struct file_operations *fopsh](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hj hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hj$hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hfile_operationsh]hfile_operations}(hj5hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj2ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj7modnameN classnameNjj )}j ]jfc.debugfs_create_file_unsafeasbuh1hhjubj2)}(h h]h }(hjShhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hfopsh]hfops}(hjnhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hj'hhhj8hMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj#hhhj8hMubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj8hMhj hhubjw)}(hhh]h)}(h'create a file in the debugfs filesystemh]h'create a file in the debugfs filesystem}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMhjhhubah}(h]h ]h"]h$]h&]uh1jvhj hhhj8hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhj|hNhNubj)}(hX**Parameters** ``const char *name`` a pointer to a string containing the name of the file to create. ``umode_t mode`` the permission that the file should have. ``struct dentry *parent`` a pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is NULL, then the file will be created in the root of the debugfs filesystem. ``void *data`` a pointer to something that the caller will want to get to later on. The inode.i_private pointer will point to this value on the open() call. ``const struct file_operations *fops`` a pointer to a struct file_operations that should be used for this file. **Description** debugfs_create_file_unsafe() is completely analogous to debugfs_create_file(), the only difference being that the fops handed it will not get protected against file removals by the debugfs core. It is your responsibility to protect your struct file_operation methods against file removals by means of debugfs_file_get() and debugfs_file_put(). ->open() is still protected by debugfs though. Any struct file_operations defined by means of DEFINE_DEBUGFS_ATTRIBUTE() is protected against file removals and thus, may be used here.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMhjubj)}(hhh](j)}(hV``const char *name`` a pointer to a string containing the name of the file to create. h](j)}(h``const char *name``h]j)}(hjٸh]hconst char *name}(hj۸hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj׸ubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMhjӸubj)}(hhh]h)}(h@a pointer to a string containing the name of the file to create.h]h@a pointer to a string containing the name of the file to create.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjӸubeh}(h]h ]h"]h$]h&]uh1jhjhMhjиubj)}(h;``umode_t mode`` the permission that the file should have. h](j)}(h``umode_t mode``h]j)}(hjh]h umode_t mode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMhj ubj)}(hhh]h)}(h)the permission that the file should have.h]h)the permission that the file should have.}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj'hMhj(ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj'hMhjиubj)}(h``struct dentry *parent`` a pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is NULL, then the file will be created in the root of the debugfs filesystem. h](j)}(h``struct dentry *parent``h]j)}(hjKh]hstruct dentry *parent}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjIubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMhjEubj)}(hhh]h)}(ha pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is NULL, then the file will be created in the root of the debugfs filesystem.h]ha pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is NULL, then the file will be created in the root of the debugfs filesystem.}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMhjaubah}(h]h ]h"]h$]h&]uh1jhjEubeh}(h]h ]h"]h$]h&]uh1jhj`hMhjиubj)}(h``void *data`` a pointer to something that the caller will want to get to later on. The inode.i_private pointer will point to this value on the open() call. h](j)}(h``void *data``h]j)}(hjh]h void *data}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMhjubj)}(hhh]h)}(ha pointer to something that the caller will want to get to later on. The inode.i_private pointer will point to this value on the open() call.h]ha pointer to something that the caller will want to get to later on. The inode.i_private pointer will point to this value on the open() call.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjиubj)}(hp``const struct file_operations *fops`` a pointer to a struct file_operations that should be used for this file. h](j)}(h&``const struct file_operations *fops``h]j)}(hjh]h"const struct file_operations *fops}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMhjubj)}(hhh]h)}(hHa pointer to a struct file_operations that should be used for this file.h]hHa pointer to a struct file_operations that should be used for this file.}(hjعhhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMhjչubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjԹhMhjиubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMhjubh)}(hdebugfs_create_file_unsafe() is completely analogous to debugfs_create_file(), the only difference being that the fops handed it will not get protected against file removals by the debugfs core.h]hdebugfs_create_file_unsafe() is completely analogous to debugfs_create_file(), the only difference being that the fops handed it will not get protected against file removals by the debugfs core.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMhjubh)}(hIt is your responsibility to protect your struct file_operation methods against file removals by means of debugfs_file_get() and debugfs_file_put(). ->open() is still protected by debugfs though.h]hIt is your responsibility to protect your struct file_operation methods against file removals by means of debugfs_file_get() and debugfs_file_put(). ->open() is still protected by debugfs though.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMhjubh)}(hAny struct file_operations defined by means of DEFINE_DEBUGFS_ATTRIBUTE() is protected against file removals and thus, may be used here.h]hAny struct file_operations defined by means of DEFINE_DEBUGFS_ATTRIBUTE() is protected against file removals and thus, may be used here.}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj|hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j %debugfs_create_file_size (C function)c.debugfs_create_file_sizehNtauh1hhj|hhhNhNubj)}(hhh](j)}(hvoid debugfs_create_file_size (const char *name, umode_t mode, struct dentry *parent, void *data, const struct file_operations *fops, loff_t file_size)h]j)}(hvoid debugfs_create_file_size(const char *name, umode_t mode, struct dentry *parent, void *data, const struct file_operations *fops, loff_t file_size)h](j)}(hvoidh]hvoid}(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZhhh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMubj2)}(h h]h }(hjmhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjZhhhjlhMubjC)}(hdebugfs_create_file_sizeh]jI)}(hdebugfs_create_file_sizeh]hdebugfs_create_file_size}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj{ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjZhhhjlhMubj=)}(hy(const char *name, umode_t mode, struct dentry *parent, void *data, const struct file_operations *fops, loff_t file_size)h](jC)}(hconst char *nameh](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hcharh]hchar}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjĺhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjҺhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hnameh]hname}(hjߺhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h umode_t modeh](h)}(hhh]jI)}(humode_th]humode_t}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jjsbc.debugfs_create_file_sizeasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hmodeh]hmode}(hj)hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct dentry *parenth](j )}(hjh]hstruct}(hjBhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj>ubj2)}(h h]h }(hjOhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj>ubh)}(hhh]jI)}(hdentryh]hdentry}(hj`hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj]ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjbmodnameN classnameNjj )}j ]jc.debugfs_create_file_sizeasbuh1hhj>ubj2)}(h h]h }(hj~hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj>ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>ubjI)}(hparenth]hparent}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj>ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h void *datah](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjλhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hdatah]hdata}(hjۻhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h"const struct file_operations *fopsh](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hfile_operationsh]hfile_operations}(hj-hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj*ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj/modnameN classnameNjj )}j ]jc.debugfs_create_file_sizeasbuh1hhjubj2)}(h h]h }(hjKhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjYhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hfopsh]hfops}(hjfhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hloff_t file_sizeh](h)}(hhh]jI)}(hloff_th]hloff_t}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.debugfs_create_file_sizeasbuh1hhj{ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj{ubjI)}(h file_sizeh]h file_size}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj{ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjZhhhjlhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjVhhhjlhMubah}(h]jQah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjlhMhjShhubjw)}(hhh]h)}(h'create a file in the debugfs filesystemh]h'create a file in the debugfs filesystem}(hjؼhhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMhjռhhubah}(h]h ]h"]h$]h&]uh1jvhjShhhjlhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhj|hNhNubj)}(hX**Parameters** ``const char *name`` a pointer to a string containing the name of the file to create. ``umode_t mode`` the permission that the file should have. ``struct dentry *parent`` a pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is NULL, then the file will be created in the root of the debugfs filesystem. ``void *data`` a pointer to something that the caller will want to get to later on. The inode.i_private pointer will point to this value on the open() call. ``const struct file_operations *fops`` a pointer to a struct file_operations that should be used for this file. ``loff_t file_size`` initial file size **Description** This is the basic "create a file" function for debugfs. It allows for a wide range of flexibility in creating a file, or a directory (if you want to create a directory, the debugfs_create_dir() function is recommended to be used instead.)h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chM hjubj)}(hhh](j)}(hV``const char *name`` a pointer to a string containing the name of the file to create. h](j)}(h``const char *name``h]j)}(hjh]hconst char *name}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMhjubj)}(hhh]h)}(h@a pointer to a string containing the name of the file to create.h]h@a pointer to a string containing the name of the file to create.}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj.hMhj/ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj.hMhjubj)}(h;``umode_t mode`` the permission that the file should have. h](j)}(h``umode_t mode``h]j)}(hjRh]h umode_t mode}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jhjPubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chM hjLubj)}(hhh]h)}(h)the permission that the file should have.h]h)the permission that the file should have.}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjghM hjhubah}(h]h ]h"]h$]h&]uh1jhjLubeh}(h]h ]h"]h$]h&]uh1jhjghM hjubj)}(h``struct dentry *parent`` a pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is NULL, then the file will be created in the root of the debugfs filesystem. h](j)}(h``struct dentry *parent``h]j)}(hjh]hstruct dentry *parent}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chM hjubj)}(hhh]h)}(ha pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is NULL, then the file will be created in the root of the debugfs filesystem.h]ha pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is NULL, then the file will be created in the root of the debugfs filesystem.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hjubj)}(h``void *data`` a pointer to something that the caller will want to get to later on. The inode.i_private pointer will point to this value on the open() call. h](j)}(h``void *data``h]j)}(hjŽh]h void *data}(hjǽhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjýubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMhjubj)}(hhh]h)}(ha pointer to something that the caller will want to get to later on. The inode.i_private pointer will point to this value on the open() call.h]ha pointer to something that the caller will want to get to later on. The inode.i_private pointer will point to this value on the open() call.}(hj޽hhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chM hj۽ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjڽhMhjubj)}(hp``const struct file_operations *fops`` a pointer to a struct file_operations that should be used for this file. h](j)}(h&``const struct file_operations *fops``h]j)}(hjh]h"const struct file_operations *fops}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMhjubj)}(hhh]h)}(hHa pointer to a struct file_operations that should be used for this file.h]hHa pointer to a struct file_operations that should be used for this file.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h'``loff_t file_size`` initial file size h](j)}(h``loff_t file_size``h]j)}(hj9h]hloff_t file_size}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj7ubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMhj3ubj)}(hhh]h)}(hinitial file sizeh]hinitial file size}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjNhMhjOubah}(h]h ]h"]h$]h&]uh1jhj3ubeh}(h]h ]h"]h$]h&]uh1jhjNhMhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjth]h Description}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjrubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMhjubh)}(hThis is the basic "create a file" function for debugfs. It allows for a wide range of flexibility in creating a file, or a directory (if you want to create a directory, the debugfs_create_dir() function is recommended to be used instead.)h]hThis is the basic “create a file” function for debugfs. It allows for a wide range of flexibility in creating a file, or a directory (if you want to create a directory, the debugfs_create_dir() function is recommended to be used instead.)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj|hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j debugfs_create_dir (C function)c.debugfs_create_dirhNtauh1hhj|hhhNhNubj)}(hhh](j)}(hLstruct dentry * debugfs_create_dir (const char *name, struct dentry *parent)h]j)}(hJstruct dentry *debugfs_create_dir(const char *name, struct dentry *parent)h](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjhhh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chM&ubj2)}(h h]h }(hjǾhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjƾhM&ubh)}(hhh]jI)}(hdentryh]hdentry}(hjؾhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjվubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjھmodnameN classnameNjj )}j ]j)}jdebugfs_create_dirsbc.debugfs_create_dirasbuh1hhjhhhjƾhM&ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjƾhM&ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjƾhM&ubjC)}(hdebugfs_create_dirh]jI)}(hjh]hdebugfs_create_dir}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjƾhM&ubj=)}(h)(const char *name, struct dentry *parent)h](jC)}(hconst char *nameh](j )}(hjJh]hconst}(hj3hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj/ubj2)}(h h]h }(hj@hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj/ubj)}(hcharh]hchar}(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/ubj2)}(h h]h }(hj\hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj/ubj)}(hjh]h*}(hjjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/ubjI)}(hnameh]hname}(hjwhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj/ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj+ubjC)}(hstruct dentry *parenth](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.debugfs_create_dirasbuh1hhjubj2)}(h h]h }(hj̿hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjڿhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hparenth]hparent}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj+ubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjƾhM&ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjƾhM&ubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjƾhM&hjhhubjw)}(hhh]h)}(h,create a directory in the debugfs filesystemh]h,create a directory in the debugfs filesystem}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chM&hjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjƾhM&ubeh}(h]h ](jfunctioneh"]h$]h&]jjjj)jj)jjjuh1jhhhj|hNhNubj)}(hXF**Parameters** ``const char *name`` a pointer to a string containing the name of the directory to create. ``struct dentry *parent`` a pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is NULL, then the directory will be created in the root of the debugfs filesystem. **Description** This function creates a directory in debugfs with the given name. This function will return a pointer to a dentry if it succeeds. This pointer must be passed to the debugfs_remove() function when the file is to be removed (no automatic cleanup happens if your module is unloaded, you are responsible here.) If an error occurs, ERR_PTR(-ERROR) will be returned. If debugfs is not enabled in the kernel, the value -``ENODEV`` will be returned. **NOTE** it's expected that most callers should _ignore_ the errors returned by this function. Other debugfs functions handle the fact that the "dentry" passed to them could be an error and they don't crash in that case. Drivers should generally work fine even if debugfs fails to init anyway.h](h)}(h**Parameters**h]j)}(hj3h]h Parameters}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj1ubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chM*hj-ubj)}(hhh](j)}(h[``const char *name`` a pointer to a string containing the name of the directory to create. h](j)}(h``const char *name``h]j)}(hjRh]hconst char *name}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jhjPubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chM(hjLubj)}(hhh]h)}(hEa pointer to a string containing the name of the directory to create.h]hEa pointer to a string containing the name of the directory to create.}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chM'hjhubah}(h]h ]h"]h$]h&]uh1jhjLubeh}(h]h ]h"]h$]h&]uh1jhjghM(hjIubj)}(h``struct dentry *parent`` a pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is NULL, then the directory will be created in the root of the debugfs filesystem. h](j)}(h``struct dentry *parent``h]j)}(hjh]hstruct dentry *parent}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chM+hjubj)}(hhh]h)}(ha pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is NULL, then the directory will be created in the root of the debugfs filesystem.h]ha pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is NULL, then the directory will be created in the root of the debugfs filesystem.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chM)hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM+hjIubeh}(h]h ]h"]h$]h&]uh1jhj-ubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chM-hj-ubh)}(hAThis function creates a directory in debugfs with the given name.h]hAThis function creates a directory in debugfs with the given name.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chM,hj-ubh)}(hX(This function will return a pointer to a dentry if it succeeds. This pointer must be passed to the debugfs_remove() function when the file is to be removed (no automatic cleanup happens if your module is unloaded, you are responsible here.) If an error occurs, ERR_PTR(-ERROR) will be returned.h]hX(This function will return a pointer to a dentry if it succeeds. This pointer must be passed to the debugfs_remove() function when the file is to be removed (no automatic cleanup happens if your module is unloaded, you are responsible here.) If an error occurs, ERR_PTR(-ERROR) will be returned.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chM.hj-ubh)}(hPIf debugfs is not enabled in the kernel, the value -``ENODEV`` will be returned.h](h4If debugfs is not enabled in the kernel, the value -}(hjhhhNhNubj)}(h ``ENODEV``h]hENODEV}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh will be returned.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chM4hj-ubh)}(h**NOTE**h]j)}(hjh]hNOTE}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chM7hj-ubh)}(hXit's expected that most callers should _ignore_ the errors returned by this function. Other debugfs functions handle the fact that the "dentry" passed to them could be an error and they don't crash in that case. Drivers should generally work fine even if debugfs fails to init anyway.h]hX$it’s expected that most callers should _ignore_ the errors returned by this function. Other debugfs functions handle the fact that the “dentry” passed to them could be an error and they don’t crash in that case. Drivers should generally work fine even if debugfs fails to init anyway.}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chM8hj-ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj|hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j %debugfs_create_automount (C function)c.debugfs_create_automounthNtauh1hhj|hhhNhNubj)}(hhh](j)}(hustruct dentry * debugfs_create_automount (const char *name, struct dentry *parent, debugfs_automount_t f, void *data)h]j)}(hsstruct dentry *debugfs_create_automount(const char *name, struct dentry *parent, debugfs_automount_t f, void *data)h](j )}(hjh]hstruct}(hjdhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj`hhh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMZubj2)}(h h]h }(hjrhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj`hhhjqhMZubh)}(hhh]jI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jdebugfs_create_automountsbc.debugfs_create_automountasbuh1hhj`hhhjqhMZubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj`hhhjqhMZubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj`hhhjqhMZubjC)}(hdebugfs_create_automounth]jI)}(hjh]hdebugfs_create_automount}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj`hhhjqhMZubj=)}(hL(const char *name, struct dentry *parent, debugfs_automount_t f, void *data)h](jC)}(hconst char *nameh](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hcharh]hchar}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hnameh]hname}(hj"hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct dentry *parenth](j )}(hjh]hstruct}(hj;hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj7ubj2)}(h h]h }(hjHhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj7ubh)}(hhh]jI)}(hdentryh]hdentry}(hjYhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjVubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj[modnameN classnameNjj )}j ]jc.debugfs_create_automountasbuh1hhj7ubj2)}(h h]h }(hjwhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj7ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7ubjI)}(hparenth]hparent}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj7ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hdebugfs_automount_t fh](h)}(hhh]jI)}(hdebugfs_automount_th]hdebugfs_automount_t}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.debugfs_create_automountasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hjph]hf}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h void *datah](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hdatah]hdata}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hj`hhhjqhMZubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj\hhhjqhMZubah}(h]jWah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjqhMZhjYhhubjw)}(hhh]h)}(h0create automount point in the debugfs filesystemh]h0create automount point in the debugfs filesystem}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMZhjBhhubah}(h]h ]h"]h$]h&]uh1jvhjYhhhjqhMZubeh}(h]h ](jfunctioneh"]h$]h&]jjjj]jj]jjjuh1jhhhj|hNhNubj)}(hX**Parameters** ``const char *name`` a pointer to a string containing the name of the file to create. ``struct dentry *parent`` a pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is NULL, then the file will be created in the root of the debugfs filesystem. ``debugfs_automount_t f`` function to be called when pathname resolution steps on that one. ``void *data`` opaque argument to pass to f(). **Description** **f** should return what ->d_automount() would.h](h)}(h**Parameters**h]j)}(hjgh]h Parameters}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1jhjeubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chM^hjaubj)}(hhh](j)}(hV``const char *name`` a pointer to a string containing the name of the file to create. h](j)}(h``const char *name``h]j)}(hjh]hconst char *name}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chM[hjubj)}(hhh]h)}(h@a pointer to a string containing the name of the file to create.h]h@a pointer to a string containing the name of the file to create.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM[hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM[hj}ubj)}(h``struct dentry *parent`` a pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is NULL, then the file will be created in the root of the debugfs filesystem. h](j)}(h``struct dentry *parent``h]j)}(hjh]hstruct dentry *parent}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chM^hjubj)}(hhh]h)}(ha pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is NULL, then the file will be created in the root of the debugfs filesystem.h]ha pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is NULL, then the file will be created in the root of the debugfs filesystem.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chM\hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM^hj}ubj)}(h\``debugfs_automount_t f`` function to be called when pathname resolution steps on that one. h](j)}(h``debugfs_automount_t f``h]j)}(hjh]hdebugfs_automount_t f}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chM_hjubj)}(hhh]h)}(hAfunction to be called when pathname resolution steps on that one.h]hAfunction to be called when pathname resolution steps on that one.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM_hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM_hj}ubj)}(h/``void *data`` opaque argument to pass to f(). h](j)}(h``void *data``h]j)}(hj2h]h void *data}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj0ubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chM`hj,ubj)}(hhh]h)}(hopaque argument to pass to f().h]hopaque argument to pass to f().}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjGhM`hjHubah}(h]h ]h"]h$]h&]uh1jhj,ubeh}(h]h ]h"]h$]h&]uh1jhjGhM`hj}ubeh}(h]h ]h"]h$]h&]uh1jhjaubh)}(h**Description**h]j)}(hjmh]h Description}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1jhjkubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMbhjaubh)}(h/**f** should return what ->d_automount() would.h](j)}(h**f**h]hf}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh* should return what ->d_automount() would.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMahjaubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj|hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j #debugfs_create_symlink (C function)c.debugfs_create_symlinkhNtauh1hhj|hhhNhNubj)}(hhh](j)}(hdstruct dentry * debugfs_create_symlink (const char *name, struct dentry *parent, const char *target)h]j)}(hbstruct dentry *debugfs_create_symlink(const char *name, struct dentry *parent, const char *target)h](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjhhh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMubh)}(hhh]jI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jdebugfs_create_symlinksbc.debugfs_create_symlinkasbuh1hhjhhhjhMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubjC)}(hdebugfs_create_symlinkh]jI)}(hjh]hdebugfs_create_symlink}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhMubj=)}(h=(const char *name, struct dentry *parent, const char *target)h](jC)}(hconst char *nameh](j )}(hjJh]hconst}(hj:hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj6ubj2)}(h h]h }(hjGhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj6ubj)}(hcharh]hchar}(hjUhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj6ubj2)}(h h]h }(hjchhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj6ubj)}(hjh]h*}(hjqhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj6ubjI)}(hnameh]hname}(hj~hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj6ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj2ubjC)}(hstruct dentry *parenth](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.debugfs_create_symlinkasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hparenth]hparent}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj2ubjC)}(hconst char *targeth](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hcharh]hchar}(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hj0hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(htargeth]htarget}(hjKhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj2ubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhMubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMhjhhubjw)}(hhh]h)}(h0create a symbolic link in the debugfs filesystemh]h0create a symbolic link in the debugfs filesystem}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMhjrhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhj|hNhNubj)}(hX**Parameters** ``const char *name`` a pointer to a string containing the name of the symbolic link to create. ``struct dentry *parent`` a pointer to the parent dentry for this symbolic link. This should be a directory dentry if set. If this parameter is NULL, then the symbolic link will be created in the root of the debugfs filesystem. ``const char *target`` a pointer to a string containing the path to the target of the symbolic link. **Description** This function creates a symbolic link with the given name in debugfs that links to the given target path. This function will return a pointer to a dentry if it succeeds. This pointer must be passed to the debugfs_remove() function when the symbolic link is to be removed (no automatic cleanup happens if your module is unloaded, you are responsible here.) If an error occurs, ERR_PTR(-ERROR) will be returned. If debugfs is not enabled in the kernel, the value -``ENODEV`` will be returned.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMhjubj)}(hhh](j)}(h_``const char *name`` a pointer to a string containing the name of the symbolic link to create. h](j)}(h``const char *name``h]j)}(hjh]hconst char *name}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMhjubj)}(hhh]h)}(hIa pointer to a string containing the name of the symbolic link to create.h]hIa pointer to a string containing the name of the symbolic link to create.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h``struct dentry *parent`` a pointer to the parent dentry for this symbolic link. This should be a directory dentry if set. If this parameter is NULL, then the symbolic link will be created in the root of the debugfs filesystem. h](j)}(h``struct dentry *parent``h]j)}(hjh]hstruct dentry *parent}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMhjubj)}(hhh]h)}(ha pointer to the parent dentry for this symbolic link. This should be a directory dentry if set. If this parameter is NULL, then the symbolic link will be created in the root of the debugfs filesystem.h]ha pointer to the parent dentry for this symbolic link. This should be a directory dentry if set. If this parameter is NULL, then the symbolic link will be created in the root of the debugfs filesystem.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(he``const char *target`` a pointer to a string containing the path to the target of the symbolic link. h](j)}(h``const char *target``h]j)}(hj*h]hconst char *target}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj(ubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMhj$ubj)}(hhh]h)}(hMa pointer to a string containing the path to the target of the symbolic link.h]hMa pointer to a string containing the path to the target of the symbolic link.}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMhj@ubah}(h]h ]h"]h$]h&]uh1jhj$ubeh}(h]h ]h"]h$]h&]uh1jhj?hMhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjfh]h Description}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjdubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMhjubh)}(hiThis function creates a symbolic link with the given name in debugfs that links to the given target path.h]hiThis function creates a symbolic link with the given name in debugfs that links to the given target path.}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMhjubh)}(hX1This function will return a pointer to a dentry if it succeeds. This pointer must be passed to the debugfs_remove() function when the symbolic link is to be removed (no automatic cleanup happens if your module is unloaded, you are responsible here.) If an error occurs, ERR_PTR(-ERROR) will be returned.h]hX1This function will return a pointer to a dentry if it succeeds. This pointer must be passed to the debugfs_remove() function when the symbolic link is to be removed (no automatic cleanup happens if your module is unloaded, you are responsible here.) If an error occurs, ERR_PTR(-ERROR) will be returned.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMhjubh)}(hPIf debugfs is not enabled in the kernel, the value -``ENODEV`` will be returned.h](h4If debugfs is not enabled in the kernel, the value -}(hjhhhNhNubj)}(h ``ENODEV``h]hENODEV}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh will be returned.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj|hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j debugfs_remove (C function)c.debugfs_removehNtauh1hhj|hhhNhNubj)}(hhh](j)}(h+void debugfs_remove (struct dentry *dentry)h]j)}(h*void debugfs_remove(struct dentry *dentry)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMubjC)}(hdebugfs_removeh]jI)}(hdebugfs_removeh]hdebugfs_remove}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhMubj=)}(h(struct dentry *dentry)h]jC)}(hstruct dentry *dentryh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hj%hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hdentryh]hdentry}(hj6hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj3ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj8modnameN classnameNjj )}j ]j)}jjsbc.debugfs_removeasbuh1hhjubj2)}(h h]h }(hjVhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjdhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hdentryh]hdentry}(hjqhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubah}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhMubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMhjhhubjw)}(hhh]h)}(hrecursively removes a directoryh]hrecursively removes a directory}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMhjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhj|hNhNubj)}(hX**Parameters** ``struct dentry *dentry`` a pointer to a the dentry of the directory to be removed. If this parameter is NULL or an error value, nothing will be done. **Description** This function recursively removes a directory tree in debugfs that was previously created with a call to another debugfs function (like debugfs_create_file() or variants thereof.) This function is required to be called in order for the file to be removed, no automatic cleanup of files will happen when a module is removed, you are responsible here.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMhjubj)}(hhh]j)}(h``struct dentry *dentry`` a pointer to a the dentry of the directory to be removed. If this parameter is NULL or an error value, nothing will be done. h](j)}(h``struct dentry *dentry``h]j)}(hjh]hstruct dentry *dentry}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMhjubj)}(hhh]h)}(h}a pointer to a the dentry of the directory to be removed. If this parameter is NULL or an error value, nothing will be done.h]h}a pointer to a the dentry of the directory to be removed. If this parameter is NULL or an error value, nothing will be done.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMhjubh)}(hThis function recursively removes a directory tree in debugfs that was previously created with a call to another debugfs function (like debugfs_create_file() or variants thereof.)h]hThis function recursively removes a directory tree in debugfs that was previously created with a call to another debugfs function (like debugfs_create_file() or variants thereof.)}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMhjubh)}(hThis function is required to be called in order for the file to be removed, no automatic cleanup of files will happen when a module is removed, you are responsible here.h]hThis function is required to be called in order for the file to be removed, no automatic cleanup of files will happen when a module is removed, you are responsible here.}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj|hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j &debugfs_lookup_and_remove (C function)c.debugfs_lookup_and_removehNtauh1hhj|hhhNhNubj)}(hhh](j)}(hHvoid debugfs_lookup_and_remove (const char *name, struct dentry *parent)h]j)}(hGvoid debugfs_lookup_and_remove(const char *name, struct dentry *parent)h](j)}(hvoidh]hvoid}(hjlhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMubj2)}(h h]h }(hj{hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhhjzhMubjC)}(hdebugfs_lookup_and_removeh]jI)}(hdebugfs_lookup_and_removeh]hdebugfs_lookup_and_remove}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhhjzhMubj=)}(h)(const char *name, struct dentry *parent)h](jC)}(hconst char *nameh](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hcharh]hchar}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hnameh]hname}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct dentry *parenth](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hdentryh]hdentry}(hj$hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj!ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj&modnameN classnameNjj )}j ]j)}jjsbc.debugfs_lookup_and_removeasbuh1hhjubj2)}(h h]h }(hjDhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hparenth]hparent}(hj_hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhhjzhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjdhhhjzhMubah}(h]j_ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjzhMhjahhubjw)}(hhh]h)}(h4lookup a directory or file and recursively remove ith]h4lookup a directory or file and recursively remove it}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMhjhhubah}(h]h ]h"]h$]h&]uh1jvhjahhhjzhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhj|hNhNubj)}(hXf**Parameters** ``const char *name`` a pointer to a string containing the name of the item to look up. ``struct dentry *parent`` a pointer to the parent dentry of the item. **Description** This is the equlivant of doing something like debugfs_remove(debugfs_lookup(..)) but with the proper reference counting handled for the directory being looked up.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMhjubj)}(hhh](j)}(hW``const char *name`` a pointer to a string containing the name of the item to look up. h](j)}(h``const char *name``h]j)}(hjh]hconst char *name}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMhjubj)}(hhh]h)}(hAa pointer to a string containing the name of the item to look up.h]hAa pointer to a string containing the name of the item to look up.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(hF``struct dentry *parent`` a pointer to the parent dentry of the item. h](j)}(h``struct dentry *parent``h]j)}(hjh]hstruct dentry *parent}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMhjubj)}(hhh]h)}(h+a pointer to the parent dentry of the item.h]h+a pointer to the parent dentry of the item.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hj>h]h Description}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj<ubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMhjubh)}(hThis is the equlivant of doing something like debugfs_remove(debugfs_lookup(..)) but with the proper reference counting handled for the directory being looked up.h]hThis is the equlivant of doing something like debugfs_remove(debugfs_lookup(..)) but with the proper reference counting handled for the directory being looked up.}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj|hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j  debugfs_change_name (C function)c.debugfs_change_namehNtauh1hhj|hhhNhNubj)}(hhh](j)}(hFint debugfs_change_name (struct dentry *dentry, const char *fmt, ...)h]j)}(hDint debugfs_change_name(struct dentry *dentry, const char *fmt, ...)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chM,ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhM,ubjC)}(hdebugfs_change_nameh]jI)}(hdebugfs_change_nameh]hdebugfs_change_name}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhM,ubj=)}(h-(struct dentry *dentry, const char *fmt, ...)h](jC)}(hstruct dentry *dentryh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jjsbc.debugfs_change_nameasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hconst char *fmth](j )}(hjJh]hconst}(hj2hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj.ubj2)}(h h]h }(hj?hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj.ubj)}(hcharh]hchar}(hjMhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj.ubj2)}(h h]h }(hj[hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj.ubj)}(hjh]h*}(hjihhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj.ubjI)}(hfmth]hfmt}(hjvhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj.ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h...h]j)}(hjh]h...}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhM,ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj{hhhjhM,ubah}(h]jvah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhM,hjxhhubjw)}(hhh]h)}(h1rename a file/directory in the debugfs filesystemh]h1rename a file/directory in the debugfs filesystem}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chM,hjhhubah}(h]h ]h"]h$]h&]uh1jvhjxhhhjhM,ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhj|hNhNubj)}(hX**Parameters** ``struct dentry *dentry`` dentry of an object to be renamed. ``const char *fmt`` format for new name ``...`` variable arguments **Description** This function renames a file/directory in debugfs. The target must not exist for rename to succeed. This function will return 0 on success and -E... on failure. If debugfs is not enabled in the kernel, the value -``ENODEV`` will be returned.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chM0hjubj)}(hhh](j)}(h=``struct dentry *dentry`` dentry of an object to be renamed. h](j)}(h``struct dentry *dentry``h]j)}(hjh]hstruct dentry *dentry}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chM-hjubj)}(hhh]h)}(h"dentry of an object to be renamed.h]h"dentry of an object to be renamed.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM-hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM-hjubj)}(h(``const char *fmt`` format for new name h](j)}(h``const char *fmt``h]j)}(hj2h]hconst char *fmt}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj0ubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chM.hj,ubj)}(hhh]h)}(hformat for new nameh]hformat for new name}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjGhM.hjHubah}(h]h ]h"]h$]h&]uh1jhj,ubeh}(h]h ]h"]h$]h&]uh1jhjGhM.hjubj)}(h``...`` variable arguments h](j)}(h``...``h]j)}(hjkh]h...}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjiubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chKhjeubj)}(hhh]h)}(hvariable argumentsh]hvariable arguments}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjeubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chKhjubh)}(hdThis function renames a file/directory in debugfs. The target must not exist for rename to succeed.h]hdThis function renames a file/directory in debugfs. The target must not exist for rename to succeed.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chM/hjubh)}(hah"]h$]h&]uh1j1hjhhhj(hMmubjC)}(hdebugfs_initializedh]jI)}(hdebugfs_initializedh]hdebugfs_initialized}(hj;hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj7ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhj(hMmubj=)}(h(void)h]jC)}(hvoidh]j)}(hvoidh]hvoid}(hjWhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSubah}(h]h ]h"]h$]h&]noemphj`jauh1jBhjOubah}(h]h ]h"]h$]h&]j`jauh1j<hjhhhj(hMmubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhj(hMmubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj(hMmhjhhubjw)}(hhh]h)}(h)Tells whether debugfs has been registeredh]h)Tells whether debugfs has been registered}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMmhj~hhubah}(h]h ]h"]h$]h&]uh1jvhjhhhj(hMmubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhj|hNhNubj)}(h'**Parameters** ``void`` no argumentsh](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMqhjubj)}(hhh]j)}(h``void`` no argumentsh](j)}(h``void``h]j)}(hjh]hvoid}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chMshjubj)}(hhh]h)}(h no argumentsh]h no arguments}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:146: ./fs/debugfs/inode.chKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMshjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj|hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j debugfs_file_get (C function)c.debugfs_file_gethNtauh1hhj|hhhNhNubj)}(hhh](j)}(h,int debugfs_file_get (struct dentry *dentry)h]j)}(h+int debugfs_file_get(struct dentry *dentry)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chKubj2)}(h h]h }(hj+hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhj*hKubjC)}(hdebugfs_file_geth]jI)}(hdebugfs_file_geth]hdebugfs_file_get}(hj=hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj9ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhj*hKubj=)}(h(struct dentry *dentry)h]jC)}(hstruct dentry *dentryh](j )}(hjh]hstruct}(hjYhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjUubj2)}(h h]h }(hjfhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjUubh)}(hhh]jI)}(hdentryh]hdentry}(hjwhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjtubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjymodnameN classnameNjj )}j ]j)}jj?sbc.debugfs_file_getasbuh1hhjUubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjUubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjUubjI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjUubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjQubah}(h]h ]h"]h$]h&]j`jauh1j<hjhhhj*hKubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhj*hKubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj*hKhjhhubjw)}(hhh]h)}(h&mark the beginning of file data accessh]h&mark the beginning of file data access}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chKhjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhj*hKubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhj|hNhNubj)}(hX**Parameters** ``struct dentry *dentry`` the dentry object whose data is being accessed. **Description** Up to a matching call to debugfs_file_put(), any successive call into the file removing functions debugfs_remove() and debugfs_remove_recursive() will block. Since associated private file data may only get freed after a successful return of any of the removal functions, you may safely access it after a successful call to debugfs_file_get() without worrying about lifetime issues. If -``EIO`` is returned, the file has already been removed and thus, it is not safe to access any of its data. If, on the other hand, it is allowed to access the file data, zero is returned.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chKhjubj)}(hhh]j)}(hJ``struct dentry *dentry`` the dentry object whose data is being accessed. h](j)}(h``struct dentry *dentry``h]j)}(hjh]hstruct dentry *dentry}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chKhjubj)}(hhh]h)}(h/the dentry object whose data is being accessed.h]h/the dentry object whose data is being accessed.}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj2hKhj3ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj2hKhjubah}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjXh]h Description}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjVubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chKhjubh)}(hX}Up to a matching call to debugfs_file_put(), any successive call into the file removing functions debugfs_remove() and debugfs_remove_recursive() will block. Since associated private file data may only get freed after a successful return of any of the removal functions, you may safely access it after a successful call to debugfs_file_get() without worrying about lifetime issues.h]hX}Up to a matching call to debugfs_file_put(), any successive call into the file removing functions debugfs_remove() and debugfs_remove_recursive() will block. Since associated private file data may only get freed after a successful return of any of the removal functions, you may safely access it after a successful call to debugfs_file_get() without worrying about lifetime issues.}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chKhjubh)}(hIf -``EIO`` is returned, the file has already been removed and thus, it is not safe to access any of its data. If, on the other hand, it is allowed to access the file data, zero is returned.h](hIf -}(hj}hhhNhNubj)}(h``EIO``h]hEIO}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj}ubh is returned, the file has already been removed and thus, it is not safe to access any of its data. If, on the other hand, it is allowed to access the file data, zero is returned.}(hj}hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chKhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj|hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j debugfs_file_put (C function)c.debugfs_file_puthNtauh1hhj|hhhNhNubj)}(hhh](j)}(h-void debugfs_file_put (struct dentry *dentry)h]j)}(h,void debugfs_file_put(struct dentry *dentry)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chKubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhKubjC)}(hdebugfs_file_puth]jI)}(hdebugfs_file_puth]hdebugfs_file_put}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhKubj=)}(h(struct dentry *dentry)h]jC)}(hstruct dentry *dentryh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jjsbc.debugfs_file_putasbuh1hhjubj2)}(h h]h }(hj9hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjGhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hdentryh]hdentry}(hjThhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubah}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhKubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhKubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhKhjhhubjw)}(hhh]h)}(h mark the end of file data accessh]h mark the end of file data access}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chKhj{hhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhKubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhj|hNhNubj)}(hX"**Parameters** ``struct dentry *dentry`` the dentry object formerly passed to debugfs_file_get(). **Description** Allow any ongoing concurrent call into debugfs_remove() or debugfs_remove_recursive() blocked by a former call to debugfs_file_get() to proceed and return to its caller.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chKhjubj)}(hhh]j)}(hS``struct dentry *dentry`` the dentry object formerly passed to debugfs_file_get(). h](j)}(h``struct dentry *dentry``h]j)}(hjh]hstruct dentry *dentry}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chKhjubj)}(hhh]h)}(h8the dentry object formerly passed to debugfs_file_get().h]h8the dentry object formerly passed to debugfs_file_get().}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chKhjubh)}(hAllow any ongoing concurrent call into debugfs_remove() or debugfs_remove_recursive() blocked by a former call to debugfs_file_get() to proceed and return to its caller.h]hAllow any ongoing concurrent call into debugfs_remove() or debugfs_remove_recursive() blocked by a former call to debugfs_file_get() to proceed and return to its caller.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chKhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj|hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j 'debugfs_enter_cancellation (C function)c.debugfs_enter_cancellationhNtauh1hhj|hhhNhNubj)}(hhh](j)}(h^void debugfs_enter_cancellation (struct file *file, struct debugfs_cancellation *cancellation)h]j)}(h]void debugfs_enter_cancellation(struct file *file, struct debugfs_cancellation *cancellation)h](j)}(hvoidh]hvoid}(hj@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj<hhhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chKubj2)}(h h]h }(hjOhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj<hhhjNhKubjC)}(hdebugfs_enter_cancellationh]jI)}(hdebugfs_enter_cancellationh]hdebugfs_enter_cancellation}(hjahhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj]ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj<hhhjNhKubj=)}(h>(struct file *file, struct debugfs_cancellation *cancellation)h](jC)}(hstruct file *fileh](j )}(hjh]hstruct}(hj}hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjyubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjyubh)}(hhh]jI)}(hfileh]hfile}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jjcsbc.debugfs_enter_cancellationasbuh1hhjyubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjyubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyubjI)}(hfileh]hfile}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjyubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjuubjC)}(h)struct debugfs_cancellation *cancellationh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hdebugfs_cancellationh]hdebugfs_cancellation}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.debugfs_enter_cancellationasbuh1hhjubj2)}(h h]h }(hj+hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(h cancellationh]h cancellation}(hjFhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjuubeh}(h]h ]h"]h$]h&]j`jauh1j<hj<hhhjNhKubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj8hhhjNhKubah}(h]j3ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjNhKhj5hhubjw)}(hhh]h)}(henter a debugfs cancellationh]henter a debugfs cancellation}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chKhjmhhubah}(h]h ]h"]h$]h&]uh1jvhj5hhhjNhKubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhj|hNhNubj)}(hX**Parameters** ``struct file *file`` the file being accessed ``struct debugfs_cancellation *cancellation`` the cancellation object, the cancel callback inside of it must be initialized **Description** When a debugfs file is removed it needs to wait for all active operations to complete. However, the operation itself may need to wait for hardware or completion of some asynchronous process or similar. As such, it may need to be cancelled to avoid long waits or even deadlocks. This function can be used inside a debugfs handler that may need to be cancelled. As soon as this function is called, the cancellation's 'cancel' callback may be called, at which point the caller should proceed to call debugfs_leave_cancellation() and leave the debugfs handler function as soon as possible. Note that the 'cancel' callback is only ever called in the context of some kind of debugfs_remove(). This function must be paired with debugfs_leave_cancellation().h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chKhjubj)}(hhh](j)}(h.``struct file *file`` the file being accessed h](j)}(h``struct file *file``h]j)}(hjh]hstruct file *file}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chKhjubj)}(hhh]h)}(hthe file being accessedh]hthe file being accessed}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubj)}(h|``struct debugfs_cancellation *cancellation`` the cancellation object, the cancel callback inside of it must be initialized h](j)}(h-``struct debugfs_cancellation *cancellation``h]j)}(hjh]h)struct debugfs_cancellation *cancellation}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chKhjubj)}(hhh]h)}(hMthe cancellation object, the cancel callback inside of it must be initializedh]hMthe cancellation object, the cancel callback inside of it must be initialized}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hj&h]h Description}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj$ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chKhjubh)}(hXWhen a debugfs file is removed it needs to wait for all active operations to complete. However, the operation itself may need to wait for hardware or completion of some asynchronous process or similar. As such, it may need to be cancelled to avoid long waits or even deadlocks.h]hXWhen a debugfs file is removed it needs to wait for all active operations to complete. However, the operation itself may need to wait for hardware or completion of some asynchronous process or similar. As such, it may need to be cancelled to avoid long waits or even deadlocks.}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chKhjubh)}(hXThis function can be used inside a debugfs handler that may need to be cancelled. As soon as this function is called, the cancellation's 'cancel' callback may be called, at which point the caller should proceed to call debugfs_leave_cancellation() and leave the debugfs handler function as soon as possible. Note that the 'cancel' callback is only ever called in the context of some kind of debugfs_remove().h]hXThis function can be used inside a debugfs handler that may need to be cancelled. As soon as this function is called, the cancellation’s ‘cancel’ callback may be called, at which point the caller should proceed to call debugfs_leave_cancellation() and leave the debugfs handler function as soon as possible. Note that the ‘cancel’ callback is only ever called in the context of some kind of debugfs_remove().}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chKhjubh)}(h?This function must be paired with debugfs_leave_cancellation().h]h?This function must be paired with debugfs_leave_cancellation().}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chKhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj|hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j 'debugfs_leave_cancellation (C function)c.debugfs_leave_cancellationhNtauh1hhj|hhhNhNubj)}(hhh](j)}(h^void debugfs_leave_cancellation (struct file *file, struct debugfs_cancellation *cancellation)h]j)}(h]void debugfs_leave_cancellation(struct file *file, struct debugfs_cancellation *cancellation)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chKubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhKubjC)}(hdebugfs_leave_cancellationh]jI)}(hdebugfs_leave_cancellationh]hdebugfs_leave_cancellation}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhKubj=)}(h>(struct file *file, struct debugfs_cancellation *cancellation)h](jC)}(hstruct file *fileh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hfileh]hfile}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jjsbc.debugfs_leave_cancellationasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hfileh]hfile}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h)struct debugfs_cancellation *cancellationh](j )}(hjh]hstruct}(hj8hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj4ubj2)}(h h]h }(hjEhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj4ubh)}(hhh]jI)}(hdebugfs_cancellationh]hdebugfs_cancellation}(hjVhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjSubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjXmodnameN classnameNjj )}j ]jc.debugfs_leave_cancellationasbuh1hhj4ubj2)}(h h]h }(hjthhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj4ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4ubjI)}(h cancellationh]h cancellation}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj4ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhKubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhKubah}(h]j|ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhKhj~hhubjw)}(hhh]h)}(hleave cancellation sectionh]hleave cancellation section}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chKhjhhubah}(h]h ]h"]h$]h&]uh1jvhj~hhhjhKubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhj|hNhNubj)}(hX**Parameters** ``struct file *file`` the file being accessed ``struct debugfs_cancellation *cancellation`` the cancellation previously registered with debugfs_enter_cancellation() **Description** See the documentation of debugfs_enter_cancellation().h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chKhjubj)}(hhh](j)}(h.``struct file *file`` the file being accessed h](j)}(h``struct file *file``h]j)}(hjh]hstruct file *file}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chKhjubj)}(hhh]h)}(hthe file being accessedh]hthe file being accessed}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubj)}(hw``struct debugfs_cancellation *cancellation`` the cancellation previously registered with debugfs_enter_cancellation() h](j)}(h-``struct debugfs_cancellation *cancellation``h]j)}(hj3h]h)struct debugfs_cancellation *cancellation}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj1ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chKhj-ubj)}(hhh]h)}(hHthe cancellation previously registered with debugfs_enter_cancellation()h]hHthe cancellation previously registered with debugfs_enter_cancellation()}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chKhjIubah}(h]h ]h"]h$]h&]uh1jhj-ubeh}(h]h ]h"]h$]h&]uh1jhjHhKhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjoh]h Description}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjmubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chKhjubh)}(h6See the documentation of debugfs_enter_cancellation().h]h6See the documentation of debugfs_enter_cancellation().}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chKhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj|hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j debugfs_create_u8 (C function)c.debugfs_create_u8hNtauh1hhj|hhhNhNubj)}(hhh](j)}(hYvoid debugfs_create_u8 (const char *name, umode_t mode, struct dentry *parent, u8 *value)h]j)}(hXvoid debugfs_create_u8(const char *name, umode_t mode, struct dentry *parent, u8 *value)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMRubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMRubjC)}(hdebugfs_create_u8h]jI)}(hdebugfs_create_u8h]hdebugfs_create_u8}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhMRubj=)}(hB(const char *name, umode_t mode, struct dentry *parent, u8 *value)h](jC)}(hconst char *nameh](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hcharh]hchar}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj(hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hnameh]hname}(hj5hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h umode_t modeh](h)}(hhh]jI)}(humode_th]humode_t}(hjQhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjNubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjSmodnameN classnameNjj )}j ]j)}jjsbc.debugfs_create_u8asbuh1hhjJubj2)}(h h]h }(hjqhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjJubjI)}(hmodeh]hmode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjJubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct dentry *parenth](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jmc.debugfs_create_u8asbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hparenth]hparent}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h u8 *valueh](h)}(hhh]jI)}(hu8h]hu8}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj modnameN classnameNjj )}j ]jmc.debugfs_create_u8asbuh1hhjubj2)}(h h]h }(hj)hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hvalueh]hvalue}(hjDhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhMRubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhMRubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMRhjhhubjw)}(hhh]h)}(hLcreate a debugfs file that is used to read and write an unsigned 8-bit valueh]hLcreate a debugfs file that is used to read and write an unsigned 8-bit value}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMRhjkhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhMRubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhj|hNhNubj)}(hX**Parameters** ``const char *name`` a pointer to a string containing the name of the file to create. ``umode_t mode`` the permission that the file should have ``struct dentry *parent`` a pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is ``NULL``, then the file will be created in the root of the debugfs filesystem. ``u8 *value`` a pointer to the variable that the file should read to and write from. **Description** This function creates a file in debugfs with the given name that contains the value of the variable **value**. If the **mode** variable is so set, it can be read from, and written to.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMVhjubj)}(hhh](j)}(hV``const char *name`` a pointer to a string containing the name of the file to create. h](j)}(h``const char *name``h]j)}(hjh]hconst char *name}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMShjubj)}(hhh]h)}(h@a pointer to a string containing the name of the file to create.h]h@a pointer to a string containing the name of the file to create.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMShjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMShjubj)}(h:``umode_t mode`` the permission that the file should have h](j)}(h``umode_t mode``h]j)}(hjh]h umode_t mode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMThjubj)}(hhh]h)}(h(the permission that the file should haveh]h(the permission that the file should have}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMThjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMThjubj)}(h``struct dentry *parent`` a pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is ``NULL``, then the file will be created in the root of the debugfs filesystem. h](j)}(h``struct dentry *parent``h]j)}(hj!h]hstruct dentry *parent}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMWhjubj)}(hhh]h)}(ha pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is ``NULL``, then the file will be created in the root of the debugfs filesystem.h](hoa pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is }(hj:hhhNhNubj)}(h``NULL``h]hNULL}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj:ubhF, then the file will be created in the root of the debugfs filesystem.}(hj:hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMUhj7ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj6hMWhjubj)}(hU``u8 *value`` a pointer to the variable that the file should read to and write from. h](j)}(h ``u8 *value``h]j)}(hjmh]h u8 *value}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1jhjkubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMYhjgubj)}(hhh]h)}(hFa pointer to the variable that the file should read to and write from.h]hFa pointer to the variable that the file should read to and write from.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMXhjubah}(h]h ]h"]h$]h&]uh1jhjgubeh}(h]h ]h"]h$]h&]uh1jhjhMYhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chM[hjubh)}(hThis function creates a file in debugfs with the given name that contains the value of the variable **value**. If the **mode** variable is so set, it can be read from, and written to.h](hdThis function creates a file in debugfs with the given name that contains the value of the variable }(hjhhhNhNubj)}(h **value**h]hvalue}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh . If the }(hjhhhNhNubj)}(h**mode**h]hmode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh9 variable is so set, it can be read from, and written to.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMZhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj|hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j debugfs_create_u16 (C function)c.debugfs_create_u16hNtauh1hhj|hhhNhNubj)}(hhh](j)}(h[void debugfs_create_u16 (const char *name, umode_t mode, struct dentry *parent, u16 *value)h]j)}(hZvoid debugfs_create_u16(const char *name, umode_t mode, struct dentry *parent, u16 *value)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMvubj2)}(h h]h }(hj!hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhj hMvubjC)}(hdebugfs_create_u16h]jI)}(hdebugfs_create_u16h]hdebugfs_create_u16}(hj3hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj/ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhj hMvubj=)}(hC(const char *name, umode_t mode, struct dentry *parent, u16 *value)h](jC)}(hconst char *nameh](j )}(hjJh]hconst}(hjOhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjKubj2)}(h h]h }(hj\hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjKubj)}(hcharh]hchar}(hjjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjKubj2)}(h h]h }(hjxhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjKubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjKubjI)}(hnameh]hname}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjKubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjGubjC)}(h umode_t modeh](h)}(hhh]jI)}(humode_th]humode_t}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jj5sbc.debugfs_create_u16asbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hmodeh]hmode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjGubjC)}(hstruct dentry *parenth](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.debugfs_create_u16asbuh1hhjubj2)}(h h]h }(hj2hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hparenth]hparent}(hjMhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjGubjC)}(h u16 *valueh](h)}(hhh]jI)}(hu16h]hu16}(hjihhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjfubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjkmodnameN classnameNjj )}j ]jc.debugfs_create_u16asbuh1hhjbubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjbubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjbubjI)}(hvalueh]hvalue}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjbubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjGubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhj hMvubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj hhhj hMvubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj hMvhjhhubjw)}(hhh]h)}(hMcreate a debugfs file that is used to read and write an unsigned 16-bit valueh]hMcreate a debugfs file that is used to read and write an unsigned 16-bit value}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMvhjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhj hMvubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhj|hNhNubj)}(hX**Parameters** ``const char *name`` a pointer to a string containing the name of the file to create. ``umode_t mode`` the permission that the file should have ``struct dentry *parent`` a pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is ``NULL``, then the file will be created in the root of the debugfs filesystem. ``u16 *value`` a pointer to the variable that the file should read to and write from. **Description** This function creates a file in debugfs with the given name that contains the value of the variable **value**. If the **mode** variable is so set, it can be read from, and written to.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMzhjubj)}(hhh](j)}(hV``const char *name`` a pointer to a string containing the name of the file to create. h](j)}(h``const char *name``h]j)}(hj h]hconst char *name}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMwhjubj)}(hhh]h)}(h@a pointer to a string containing the name of the file to create.h]h@a pointer to a string containing the name of the file to create.}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj"hMwhj#ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj"hMwhjubj)}(h:``umode_t mode`` the permission that the file should have h](j)}(h``umode_t mode``h]j)}(hjFh]h umode_t mode}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjDubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMxhj@ubj)}(hhh]h)}(h(the permission that the file should haveh]h(the permission that the file should have}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj[hMxhj\ubah}(h]h ]h"]h$]h&]uh1jhj@ubeh}(h]h ]h"]h$]h&]uh1jhj[hMxhjubj)}(h``struct dentry *parent`` a pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is ``NULL``, then the file will be created in the root of the debugfs filesystem. h](j)}(h``struct dentry *parent``h]j)}(hjh]hstruct dentry *parent}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj}ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chM{hjyubj)}(hhh]h)}(ha pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is ``NULL``, then the file will be created in the root of the debugfs filesystem.h](hoa pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is }(hjhhhNhNubj)}(h``NULL``h]hNULL}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhF, then the file will be created in the root of the debugfs filesystem.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMyhjubah}(h]h ]h"]h$]h&]uh1jhjyubeh}(h]h ]h"]h$]h&]uh1jhjhM{hjubj)}(hV``u16 *value`` a pointer to the variable that the file should read to and write from. h](j)}(h``u16 *value``h]j)}(hjh]h u16 *value}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chM}hjubj)}(hhh]h)}(hFa pointer to the variable that the file should read to and write from.h]hFa pointer to the variable that the file should read to and write from.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chM|hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM}hjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhjubh)}(hThis function creates a file in debugfs with the given name that contains the value of the variable **value**. If the **mode** variable is so set, it can be read from, and written to.h](hdThis function creates a file in debugfs with the given name that contains the value of the variable }(hjhhhNhNubj)}(h **value**h]hvalue}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh . If the }(hjhhhNhNubj)}(h**mode**h]hmode}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh9 variable is so set, it can be read from, and written to.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chM~hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj|hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j debugfs_create_u32 (C function)c.debugfs_create_u32hNtauh1hhj|hhhNhNubj)}(hhh](j)}(h[void debugfs_create_u32 (const char *name, umode_t mode, struct dentry *parent, u32 *value)h]j)}(hZvoid debugfs_create_u32(const char *name, umode_t mode, struct dentry *parent, u32 *value)h](j)}(hvoidh]hvoid}(hjphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjlhhhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjlhhhj~hMubjC)}(hdebugfs_create_u32h]jI)}(hdebugfs_create_u32h]hdebugfs_create_u32}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjlhhhj~hMubj=)}(hC(const char *name, umode_t mode, struct dentry *parent, u32 *value)h](jC)}(hconst char *nameh](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hcharh]hchar}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hnameh]hname}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h umode_t modeh](h)}(hhh]jI)}(humode_th]humode_t}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jjsbc.debugfs_create_u32asbuh1hhjubj2)}(h h]h }(hj-hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hmodeh]hmode}(hj;hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct dentry *parenth](j )}(hjh]hstruct}(hjThhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjPubj2)}(h h]h }(hjahhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjPubh)}(hhh]jI)}(hdentryh]hdentry}(hjrhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjoubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjtmodnameN classnameNjj )}j ]j)c.debugfs_create_u32asbuh1hhjPubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjPubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjPubjI)}(hparenth]hparent}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjPubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h u32 *valueh](h)}(hhh]jI)}(hu32h]hu32}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)c.debugfs_create_u32asbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hvalueh]hvalue}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjlhhhj~hMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhhj~hMubah}(h]jcah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj~hMhjehhubjw)}(hhh]h)}(hMcreate a debugfs file that is used to read and write an unsigned 32-bit valueh]hMcreate a debugfs file that is used to read and write an unsigned 32-bit value}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhj'hhubah}(h]h ]h"]h$]h&]uh1jvhjehhhj~hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjBjjBjjjuh1jhhhj|hNhNubj)}(hX**Parameters** ``const char *name`` a pointer to a string containing the name of the file to create. ``umode_t mode`` the permission that the file should have ``struct dentry *parent`` a pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is ``NULL``, then the file will be created in the root of the debugfs filesystem. ``u32 *value`` a pointer to the variable that the file should read to and write from. **Description** This function creates a file in debugfs with the given name that contains the value of the variable **value**. If the **mode** variable is so set, it can be read from, and written to.h](h)}(h**Parameters**h]j)}(hjLh]h Parameters}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjJubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhjFubj)}(hhh](j)}(hV``const char *name`` a pointer to a string containing the name of the file to create. h](j)}(h``const char *name``h]j)}(hjkh]hconst char *name}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjiubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhjeubj)}(hhh]h)}(h@a pointer to a string containing the name of the file to create.h]h@a pointer to a string containing the name of the file to create.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjeubeh}(h]h ]h"]h$]h&]uh1jhjhMhjbubj)}(h:``umode_t mode`` the permission that the file should have h](j)}(h``umode_t mode``h]j)}(hjh]h umode_t mode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhjubj)}(hhh]h)}(h(the permission that the file should haveh]h(the permission that the file should have}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjbubj)}(h``struct dentry *parent`` a pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is ``NULL``, then the file will be created in the root of the debugfs filesystem. h](j)}(h``struct dentry *parent``h]j)}(hjh]hstruct dentry *parent}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhjubj)}(hhh]h)}(ha pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is ``NULL``, then the file will be created in the root of the debugfs filesystem.h](hoa pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is }(hjhhhNhNubj)}(h``NULL``h]hNULL}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhF, then the file will be created in the root of the debugfs filesystem.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjbubj)}(hV``u32 *value`` a pointer to the variable that the file should read to and write from. h](j)}(h``u32 *value``h]j)}(hj)h]h u32 *value}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj'ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhj#ubj)}(hhh]h)}(hFa pointer to the variable that the file should read to and write from.h]hFa pointer to the variable that the file should read to and write from.}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhj?ubah}(h]h ]h"]h$]h&]uh1jhj#ubeh}(h]h ]h"]h$]h&]uh1jhj>hMhjbubeh}(h]h ]h"]h$]h&]uh1jhjFubh)}(h**Description**h]j)}(hjeh]h Description}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1jhjcubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhjFubh)}(hThis function creates a file in debugfs with the given name that contains the value of the variable **value**. If the **mode** variable is so set, it can be read from, and written to.h](hdThis function creates a file in debugfs with the given name that contains the value of the variable }(hj{hhhNhNubj)}(h **value**h]hvalue}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj{ubh . If the }(hj{hhhNhNubj)}(h**mode**h]hmode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj{ubh9 variable is so set, it can be read from, and written to.}(hj{hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhjFubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj|hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j debugfs_create_u64 (C function)c.debugfs_create_u64hNtauh1hhj|hhhNhNubj)}(hhh](j)}(h[void debugfs_create_u64 (const char *name, umode_t mode, struct dentry *parent, u64 *value)h]j)}(hZvoid debugfs_create_u64(const char *name, umode_t mode, struct dentry *parent, u64 *value)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMubj2)}(h h]h }(hjhBhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMubjC)}(hdebugfs_create_u64h]jI)}(hdebugfs_create_u64h]hdebugfs_create_u64}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhMubj=)}(hC(const char *name, umode_t mode, struct dentry *parent, u64 *value)h](jC)}(hconst char *nameh](j )}(hjJh]hconst}(hj hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hcharh]hchar}(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hj4hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hnameh]hname}(hjOhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h umode_t modeh](h)}(hhh]jI)}(humode_th]humode_t}(hjkhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjhubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmmodnameN classnameNjj )}j ]j)}jjsbc.debugfs_create_u64asbuh1hhjdubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjdubjI)}(hmodeh]hmode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjdubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct dentry *parenth](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.debugfs_create_u64asbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hparenth]hparent}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h u64 *valueh](h)}(hhh]jI)}(hu64h]hu64}(hj%hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj"ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj'modnameN classnameNjj )}j ]jc.debugfs_create_u64asbuh1hhjubj2)}(h h]h }(hjChhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjQhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hvalueh]hvalue}(hj^hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhMubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMhjhhubjw)}(hhh]h)}(hMcreate a debugfs file that is used to read and write an unsigned 64-bit valueh]hMcreate a debugfs file that is used to read and write an unsigned 64-bit value}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhj|hNhNubj)}(hX**Parameters** ``const char *name`` a pointer to a string containing the name of the file to create. ``umode_t mode`` the permission that the file should have ``struct dentry *parent`` a pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is ``NULL``, then the file will be created in the root of the debugfs filesystem. ``u64 *value`` a pointer to the variable that the file should read to and write from. **Description** This function creates a file in debugfs with the given name that contains the value of the variable **value**. If the **mode** variable is so set, it can be read from, and written to.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhjubj)}(hhh](j)}(hV``const char *name`` a pointer to a string containing the name of the file to create. h](j)}(h``const char *name``h]j)}(hjh]hconst char *name}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhjubj)}(hhh]h)}(h@a pointer to a string containing the name of the file to create.h]h@a pointer to a string containing the name of the file to create.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h:``umode_t mode`` the permission that the file should have h](j)}(h``umode_t mode``h]j)}(hjh]h umode_t mode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhjubj)}(hhh]h)}(h(the permission that the file should haveh]h(the permission that the file should have}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h``struct dentry *parent`` a pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is ``NULL``, then the file will be created in the root of the debugfs filesystem. h](j)}(h``struct dentry *parent``h]j)}(hj;h]hstruct dentry *parent}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj9ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhj5ubj)}(hhh]h)}(ha pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is ``NULL``, then the file will be created in the root of the debugfs filesystem.h](hoa pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is }(hjThhhNhNubj)}(h``NULL``h]hNULL}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjTubhF, then the file will be created in the root of the debugfs filesystem.}(hjThhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhjQubah}(h]h ]h"]h$]h&]uh1jhj5ubeh}(h]h ]h"]h$]h&]uh1jhjPhMhjubj)}(hV``u64 *value`` a pointer to the variable that the file should read to and write from. h](j)}(h``u64 *value``h]j)}(hjh]h u64 *value}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhjubj)}(hhh]h)}(hFa pointer to the variable that the file should read to and write from.h]hFa pointer to the variable that the file should read to and write from.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhjubh)}(hThis function creates a file in debugfs with the given name that contains the value of the variable **value**. If the **mode** variable is so set, it can be read from, and written to.h](hdThis function creates a file in debugfs with the given name that contains the value of the variable }(hjhhhNhNubj)}(h **value**h]hvalue}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh . If the }(hjhhhNhNubj)}(h**mode**h]hmode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh9 variable is so set, it can be read from, and written to.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj|hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j !debugfs_create_ulong (C function)c.debugfs_create_ulonghNtauh1hhj|hhhNhNubj)}(hhh](j)}(hgvoid debugfs_create_ulong (const char *name, umode_t mode, struct dentry *parent, unsigned long *value)h]j)}(hfvoid debugfs_create_ulong(const char *name, umode_t mode, struct dentry *parent, unsigned long *value)h](j)}(hvoidh]hvoid}(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(hhhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMubj2)}(h h]h }(hj;hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj(hhhj:hMubjC)}(hdebugfs_create_ulongh]jI)}(hdebugfs_create_ulongh]hdebugfs_create_ulong}(hjMhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjIubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj(hhhj:hMubj=)}(hM(const char *name, umode_t mode, struct dentry *parent, unsigned long *value)h](jC)}(hconst char *nameh](j )}(hjJh]hconst}(hjihhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjeubj2)}(h h]h }(hjvhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjeubj)}(hcharh]hchar}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjeubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubjI)}(hnameh]hname}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjeubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjaubjC)}(h umode_t modeh](h)}(hhh]jI)}(humode_th]humode_t}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jjOsbc.debugfs_create_ulongasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hmodeh]hmode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjaubjC)}(hstruct dentry *parenth](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj ubh)}(hhh]jI)}(hdentryh]hdentry}(hj.hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj+ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj0modnameN classnameNjj )}j ]jc.debugfs_create_ulongasbuh1hhj ubj2)}(h h]h }(hjLhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj ubj)}(hjh]h*}(hjZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubjI)}(hparenth]hparent}(hjghhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjaubjC)}(hunsigned long *valueh](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj|ubj)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj|ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|ubjI)}(hvalueh]hvalue}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj|ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjaubeh}(h]h ]h"]h$]h&]j`jauh1j<hj(hhhj:hMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj$hhhj:hMubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj:hMhj!hhubjw)}(hhh]h)}(hLcreate a debugfs file that is used to read and write an unsigned long value.h]hLcreate a debugfs file that is used to read and write an unsigned long value.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhjhhubah}(h]h ]h"]h$]h&]uh1jvhj!hhhj:hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhj|hNhNubj)}(hX**Parameters** ``const char *name`` a pointer to a string containing the name of the file to create. ``umode_t mode`` the permission that the file should have ``struct dentry *parent`` a pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is ``NULL``, then the file will be created in the root of the debugfs filesystem. ``unsigned long *value`` a pointer to the variable that the file should read to and write from. **Description** This function creates a file in debugfs with the given name that contains the value of the variable **value**. If the **mode** variable is so set, it can be read from, and written to.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhj ubj)}(hhh](j)}(hV``const char *name`` a pointer to a string containing the name of the file to create. h](j)}(h``const char *name``h]j)}(hj0h]hconst char *name}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj.ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhj*ubj)}(hhh]h)}(h@a pointer to a string containing the name of the file to create.h]h@a pointer to a string containing the name of the file to create.}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjEhMhjFubah}(h]h ]h"]h$]h&]uh1jhj*ubeh}(h]h ]h"]h$]h&]uh1jhjEhMhj'ubj)}(h:``umode_t mode`` the permission that the file should have h](j)}(h``umode_t mode``h]j)}(hjih]h umode_t mode}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjgubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhjcubj)}(hhh]h)}(h(the permission that the file should haveh]h(the permission that the file should have}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj~hMhjubah}(h]h ]h"]h$]h&]uh1jhjcubeh}(h]h ]h"]h$]h&]uh1jhj~hMhj'ubj)}(h``struct dentry *parent`` a pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is ``NULL``, then the file will be created in the root of the debugfs filesystem. h](j)}(h``struct dentry *parent``h]j)}(hjh]hstruct dentry *parent}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhjubj)}(hhh]h)}(ha pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is ``NULL``, then the file will be created in the root of the debugfs filesystem.h](hoa pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is }(hjhhhNhNubj)}(h``NULL``h]hNULL}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhF, then the file will be created in the root of the debugfs filesystem.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhj'ubj)}(h```unsigned long *value`` a pointer to the variable that the file should read to and write from. h](j)}(h``unsigned long *value``h]j)}(hjh]hunsigned long *value}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhjubj)}(hhh]h)}(hFa pointer to the variable that the file should read to and write from.h]hFa pointer to the variable that the file should read to and write from.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhj'ubeh}(h]h ]h"]h$]h&]uh1jhj ubh)}(h**Description**h]j)}(hj*h]h Description}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj(ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhj ubh)}(hThis function creates a file in debugfs with the given name that contains the value of the variable **value**. If the **mode** variable is so set, it can be read from, and written to.h](hdThis function creates a file in debugfs with the given name that contains the value of the variable }(hj@hhhNhNubj)}(h **value**h]hvalue}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj@ubh . If the }(hj@hhhNhNubj)}(h**mode**h]hmode}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj@ubh9 variable is so set, it can be read from, and written to.}(hj@hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhj ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj|hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j debugfs_create_x8 (C function)c.debugfs_create_x8hNtauh1hhj|hhhNhNubj)}(hhh](j)}(hYvoid debugfs_create_x8 (const char *name, umode_t mode, struct dentry *parent, u8 *value)h]j)}(hXvoid debugfs_create_x8(const char *name, umode_t mode, struct dentry *parent, u8 *value)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMubjC)}(hdebugfs_create_x8h]jI)}(hdebugfs_create_x8h]hdebugfs_create_x8}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhMubj=)}(hB(const char *name, umode_t mode, struct dentry *parent, u8 *value)h](jC)}(hconst char *nameh](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hcharh]hchar}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hnameh]hname}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h umode_t modeh](h)}(hhh]jI)}(humode_th]humode_t}(hj0hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj-ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj2modnameN classnameNjj )}j ]j)}jjsbc.debugfs_create_x8asbuh1hhj)ubj2)}(h h]h }(hjPhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj)ubjI)}(hmodeh]hmode}(hj^hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj)ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct dentry *parenth](j )}(hjh]hstruct}(hjwhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjsubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjsubh)}(hhh]jI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jLc.debugfs_create_x8asbuh1hhjsubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjsubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjsubjI)}(hparenth]hparent}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjsubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h u8 *valueh](h)}(hhh]jI)}(hu8h]hu8}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jLc.debugfs_create_x8asbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hvalueh]hvalue}(hj#hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhMubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMhjhhubjw)}(hhh]h)}(hLcreate a debugfs file that is used to read and write an unsigned 8-bit valueh]hLcreate a debugfs file that is used to read and write an unsigned 8-bit value}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhjJhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjejjejjjuh1jhhhj|hNhNubj)}(hX**Parameters** ``const char *name`` a pointer to a string containing the name of the file to create. ``umode_t mode`` the permission that the file should have ``struct dentry *parent`` a pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is ``NULL``, then the file will be created in the root of the debugfs filesystem. ``u8 *value`` a pointer to the variable that the file should read to and write from.h](h)}(h**Parameters**h]j)}(hjoh]h Parameters}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjmubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhjiubj)}(hhh](j)}(hV``const char *name`` a pointer to a string containing the name of the file to create. h](j)}(h``const char *name``h]j)}(hjh]hconst char *name}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhjubj)}(hhh]h)}(h@a pointer to a string containing the name of the file to create.h]h@a pointer to a string containing the name of the file to create.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h:``umode_t mode`` the permission that the file should have h](j)}(h``umode_t mode``h]j)}(hjh]h umode_t mode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhjubj)}(hhh]h)}(h(the permission that the file should haveh]h(the permission that the file should have}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h``struct dentry *parent`` a pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is ``NULL``, then the file will be created in the root of the debugfs filesystem. h](j)}(h``struct dentry *parent``h]j)}(hjh]hstruct dentry *parent}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhjubj)}(hhh]h)}(ha pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is ``NULL``, then the file will be created in the root of the debugfs filesystem.h](hoa pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is }(hjhhhNhNubj)}(h``NULL``h]hNULL}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhF, then the file will be created in the root of the debugfs filesystem.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(hT``u8 *value`` a pointer to the variable that the file should read to and write from.h](j)}(h ``u8 *value``h]j)}(hjLh]h u8 *value}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjJubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhjFubj)}(hhh]h)}(hFa pointer to the variable that the file should read to and write from.h]hFa pointer to the variable that the file should read to and write from.}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1hhjahMhjbubah}(h]h ]h"]h$]h&]uh1jhjFubeh}(h]h ]h"]h$]h&]uh1jhjahMhjubeh}(h]h ]h"]h$]h&]uh1jhjiubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj|hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j debugfs_create_x16 (C function)c.debugfs_create_x16hNtauh1hhj|hhhNhNubj)}(hhh](j)}(h[void debugfs_create_x16 (const char *name, umode_t mode, struct dentry *parent, u16 *value)h]j)}(hZvoid debugfs_create_x16(const char *name, umode_t mode, struct dentry *parent, u16 *value)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chM)ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhM)ubjC)}(hdebugfs_create_x16h]jI)}(hdebugfs_create_x16h]hdebugfs_create_x16}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhM)ubj=)}(hC(const char *name, umode_t mode, struct dentry *parent, u16 *value)h](jC)}(hconst char *nameh](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hcharh]hchar}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hj hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hnameh]hname}(hj&hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h umode_t modeh](h)}(hhh]jI)}(humode_th]humode_t}(hjBhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj?ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjDmodnameN classnameNjj )}j ]j)}jjsbc.debugfs_create_x16asbuh1hhj;ubj2)}(h h]h }(hjbhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj;ubjI)}(hmodeh]hmode}(hjphhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj;ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct dentry *parenth](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j^c.debugfs_create_x16asbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hparenth]hparent}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h u16 *valueh](h)}(hhh]jI)}(hu16h]hu16}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j^c.debugfs_create_x16asbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj(hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hvalueh]hvalue}(hj5hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhM)ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhM)ubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhM)hjhhubjw)}(hhh]h)}(hMcreate a debugfs file that is used to read and write an unsigned 16-bit valueh]hMcreate a debugfs file that is used to read and write an unsigned 16-bit value}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chM)hj\hhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhM)ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjwjjwjjjuh1jhhhj|hNhNubj)}(hX**Parameters** ``const char *name`` a pointer to a string containing the name of the file to create. ``umode_t mode`` the permission that the file should have ``struct dentry *parent`` a pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is ``NULL``, then the file will be created in the root of the debugfs filesystem. ``u16 *value`` a pointer to the variable that the file should read to and write from.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chM-hj{ubj)}(hhh](j)}(hV``const char *name`` a pointer to a string containing the name of the file to create. h](j)}(h``const char *name``h]j)}(hjh]hconst char *name}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chM*hjubj)}(hhh]h)}(h@a pointer to a string containing the name of the file to create.h]h@a pointer to a string containing the name of the file to create.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM*hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM*hjubj)}(h:``umode_t mode`` the permission that the file should have h](j)}(h``umode_t mode``h]j)}(hjh]h umode_t mode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chM+hjubj)}(hhh]h)}(h(the permission that the file should haveh]h(the permission that the file should have}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM+hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM+hjubj)}(h``struct dentry *parent`` a pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is ``NULL``, then the file will be created in the root of the debugfs filesystem. h](j)}(h``struct dentry *parent``h]j)}(hjh]hstruct dentry *parent}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chM.hj ubj)}(hhh]h)}(ha pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is ``NULL``, then the file will be created in the root of the debugfs filesystem.h](hoa pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is }(hj+hhhNhNubj)}(h``NULL``h]hNULL}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj+ubhF, then the file will be created in the root of the debugfs filesystem.}(hj+hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chM,hj(ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj'hM.hjubj)}(hU``u16 *value`` a pointer to the variable that the file should read to and write from.h](j)}(h``u16 *value``h]j)}(hj^h]h u16 *value}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj\ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chM/hjXubj)}(hhh]h)}(hFa pointer to the variable that the file should read to and write from.h]hFa pointer to the variable that the file should read to and write from.}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjshM/hjtubah}(h]h ]h"]h$]h&]uh1jhjXubeh}(h]h ]h"]h$]h&]uh1jhjshM/hjubeh}(h]h ]h"]h$]h&]uh1jhj{ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj|hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j debugfs_create_x32 (C function)c.debugfs_create_x32hNtauh1hhj|hhhNhNubj)}(hhh](j)}(h[void debugfs_create_x32 (const char *name, umode_t mode, struct dentry *parent, u32 *value)h]j)}(hZvoid debugfs_create_x32(const char *name, umode_t mode, struct dentry *parent, u32 *value)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chM;ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhM;ubjC)}(hdebugfs_create_x32h]jI)}(hdebugfs_create_x32h]hdebugfs_create_x32}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhM;ubj=)}(hC(const char *name, umode_t mode, struct dentry *parent, u32 *value)h](jC)}(hconst char *nameh](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hcharh]hchar}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hnameh]hname}(hj8hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h umode_t modeh](h)}(hhh]jI)}(humode_th]humode_t}(hjThhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjQubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjVmodnameN classnameNjj )}j ]j)}jjsbc.debugfs_create_x32asbuh1hhjMubj2)}(h h]h }(hjthhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjMubjI)}(hmodeh]hmode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjMubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct dentry *parenth](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jpc.debugfs_create_x32asbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hparenth]hparent}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h u32 *valueh](h)}(hhh]jI)}(hu32h]hu32}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jpc.debugfs_create_x32asbuh1hhjubj2)}(h h]h }(hj,hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj:hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hvalueh]hvalue}(hjGhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhM;ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhM;ubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhM;hjhhubjw)}(hhh]h)}(hMcreate a debugfs file that is used to read and write an unsigned 32-bit valueh]hMcreate a debugfs file that is used to read and write an unsigned 32-bit value}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chM;hjnhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhM;ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhj|hNhNubj)}(hX**Parameters** ``const char *name`` a pointer to a string containing the name of the file to create. ``umode_t mode`` the permission that the file should have ``struct dentry *parent`` a pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is ``NULL``, then the file will be created in the root of the debugfs filesystem. ``u32 *value`` a pointer to the variable that the file should read to and write from.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chM?hjubj)}(hhh](j)}(hV``const char *name`` a pointer to a string containing the name of the file to create. h](j)}(h``const char *name``h]j)}(hjh]hconst char *name}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chM<hjubj)}(hhh]h)}(h@a pointer to a string containing the name of the file to create.h]h@a pointer to a string containing the name of the file to create.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM<hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM<hjubj)}(h:``umode_t mode`` the permission that the file should have h](j)}(h``umode_t mode``h]j)}(hjh]h umode_t mode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chM=hjubj)}(hhh]h)}(h(the permission that the file should haveh]h(the permission that the file should have}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM=hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM=hjubj)}(h``struct dentry *parent`` a pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is ``NULL``, then the file will be created in the root of the debugfs filesystem. h](j)}(h``struct dentry *parent``h]j)}(hj$h]hstruct dentry *parent}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj"ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chM@hjubj)}(hhh]h)}(ha pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is ``NULL``, then the file will be created in the root of the debugfs filesystem.h](hoa pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is }(hj=hhhNhNubj)}(h``NULL``h]hNULL}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj=ubhF, then the file will be created in the root of the debugfs filesystem.}(hj=hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chM>hj:ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj9hM@hjubj)}(hU``u32 *value`` a pointer to the variable that the file should read to and write from.h](j)}(h``u32 *value``h]j)}(hjph]h u32 *value}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjnubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMAhjjubj)}(hhh]h)}(hFa pointer to the variable that the file should read to and write from.h]hFa pointer to the variable that the file should read to and write from.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMAhjubah}(h]h ]h"]h$]h&]uh1jhjjubeh}(h]h ]h"]h$]h&]uh1jhjhMAhjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj|hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j debugfs_create_x64 (C function)c.debugfs_create_x64hNtauh1hhj|hhhNhNubj)}(hhh](j)}(h[void debugfs_create_x64 (const char *name, umode_t mode, struct dentry *parent, u64 *value)h]j)}(hZvoid debugfs_create_x64(const char *name, umode_t mode, struct dentry *parent, u64 *value)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMMubjC)}(hdebugfs_create_x64h]jI)}(hdebugfs_create_x64h]hdebugfs_create_x64}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhMMubj=)}(hC(const char *name, umode_t mode, struct dentry *parent, u64 *value)h](jC)}(hconst char *nameh](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hcharh]hchar}(hj!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hj/hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hnameh]hname}(hjJhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h umode_t modeh](h)}(hhh]jI)}(humode_th]humode_t}(hjfhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjcubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjhmodnameN classnameNjj )}j ]j)}jjsbc.debugfs_create_x64asbuh1hhj_ubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj_ubjI)}(hmodeh]hmode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj_ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct dentry *parenth](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.debugfs_create_x64asbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hparenth]hparent}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h u64 *valueh](h)}(hhh]jI)}(hu64h]hu64}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj"modnameN classnameNjj )}j ]jc.debugfs_create_x64asbuh1hhjubj2)}(h h]h }(hj>hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjLhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hvalueh]hvalue}(hjYhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhMMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhMMubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMMhjhhubjw)}(hhh]h)}(hMcreate a debugfs file that is used to read and write an unsigned 64-bit valueh]hMcreate a debugfs file that is used to read and write an unsigned 64-bit value}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMMhjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhMMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhj|hNhNubj)}(hX**Parameters** ``const char *name`` a pointer to a string containing the name of the file to create. ``umode_t mode`` the permission that the file should have ``struct dentry *parent`` a pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is ``NULL``, then the file will be created in the root of the debugfs filesystem. ``u64 *value`` a pointer to the variable that the file should read to and write from.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMQhjubj)}(hhh](j)}(hV``const char *name`` a pointer to a string containing the name of the file to create. h](j)}(h``const char *name``h]j)}(hjh]hconst char *name}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMNhjubj)}(hhh]h)}(h@a pointer to a string containing the name of the file to create.h]h@a pointer to a string containing the name of the file to create.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMNhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMNhjubj)}(h:``umode_t mode`` the permission that the file should have h](j)}(h``umode_t mode``h]j)}(hjh]h umode_t mode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMOhjubj)}(hhh]h)}(h(the permission that the file should haveh]h(the permission that the file should have}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMOhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMOhjubj)}(h``struct dentry *parent`` a pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is ``NULL``, then the file will be created in the root of the debugfs filesystem. h](j)}(h``struct dentry *parent``h]j)}(hj6h]hstruct dentry *parent}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj4ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMRhj0ubj)}(hhh]h)}(ha pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is ``NULL``, then the file will be created in the root of the debugfs filesystem.h](hoa pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is }(hjOhhhNhNubj)}(h``NULL``h]hNULL}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjOubhF, then the file will be created in the root of the debugfs filesystem.}(hjOhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMPhjLubah}(h]h ]h"]h$]h&]uh1jhj0ubeh}(h]h ]h"]h$]h&]uh1jhjKhMRhjubj)}(hU``u64 *value`` a pointer to the variable that the file should read to and write from.h](j)}(h``u64 *value``h]j)}(hjh]h u64 *value}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMShj|ubj)}(hhh]h)}(hFa pointer to the variable that the file should read to and write from.h]hFa pointer to the variable that the file should read to and write from.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMShjubah}(h]h ]h"]h$]h&]uh1jhj|ubeh}(h]h ]h"]h$]h&]uh1jhjhMShjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj|hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j "debugfs_create_size_t (C function)c.debugfs_create_size_thNtauh1hhj|hhhNhNubj)}(hhh](j)}(havoid debugfs_create_size_t (const char *name, umode_t mode, struct dentry *parent, size_t *value)h]j)}(h`void debugfs_create_size_t(const char *name, umode_t mode, struct dentry *parent, size_t *value)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMoubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMoubjC)}(hdebugfs_create_size_th]jI)}(hdebugfs_create_size_th]hdebugfs_create_size_t}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhMoubj=)}(hF(const char *name, umode_t mode, struct dentry *parent, size_t *value)h](jC)}(hconst char *nameh](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hj%hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hcharh]hchar}(hj3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjAhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hnameh]hname}(hj\hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h umode_t modeh](h)}(hhh]jI)}(humode_th]humode_t}(hjxhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjuubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjzmodnameN classnameNjj )}j ]j)}jjsbc.debugfs_create_size_tasbuh1hhjqubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjqubjI)}(hmodeh]hmode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjqubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct dentry *parenth](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.debugfs_create_size_tasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hparenth]hparent}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h size_t *valueh](h)}(hhh]jI)}(hsize_th]hsize_t}(hj2hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj/ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj4modnameN classnameNjj )}j ]jc.debugfs_create_size_tasbuh1hhj+ubj2)}(h h]h }(hjPhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj+ubj)}(hjh]h*}(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubjI)}(hvalueh]hvalue}(hjkhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj+ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhMoubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhMoubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMohjhhubjw)}(hhh]h)}(hDcreate a debugfs file that is used to read and write an size_t valueh]hDcreate a debugfs file that is used to read and write an size_t value}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMohjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhMoubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhj|hNhNubj)}(hX**Parameters** ``const char *name`` a pointer to a string containing the name of the file to create. ``umode_t mode`` the permission that the file should have ``struct dentry *parent`` a pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is ``NULL``, then the file will be created in the root of the debugfs filesystem. ``size_t *value`` a pointer to the variable that the file should read to and write from.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMshjubj)}(hhh](j)}(hV``const char *name`` a pointer to a string containing the name of the file to create. h](j)}(h``const char *name``h]j)}(hjh]hconst char *name}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMphjubj)}(hhh]h)}(h@a pointer to a string containing the name of the file to create.h]h@a pointer to a string containing the name of the file to create.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMphjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMphjubj)}(h:``umode_t mode`` the permission that the file should have h](j)}(h``umode_t mode``h]j)}(hjh]h umode_t mode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMqhj ubj)}(hhh]h)}(h(the permission that the file should haveh]h(the permission that the file should have}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj$hMqhj%ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj$hMqhjubj)}(h``struct dentry *parent`` a pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is ``NULL``, then the file will be created in the root of the debugfs filesystem. h](j)}(h``struct dentry *parent``h]j)}(hjHh]hstruct dentry *parent}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjFubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMthjBubj)}(hhh]h)}(ha pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is ``NULL``, then the file will be created in the root of the debugfs filesystem.h](hoa pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is }(hjahhhNhNubj)}(h``NULL``h]hNULL}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1jhjaubhF, then the file will be created in the root of the debugfs filesystem.}(hjahhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMrhj^ubah}(h]h ]h"]h$]h&]uh1jhjBubeh}(h]h ]h"]h$]h&]uh1jhj]hMthjubj)}(hX``size_t *value`` a pointer to the variable that the file should read to and write from.h](j)}(h``size_t *value``h]j)}(hjh]h size_t *value}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMuhjubj)}(hhh]h)}(hFa pointer to the variable that the file should read to and write from.h]hFa pointer to the variable that the file should read to and write from.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMuhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMuhjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj|hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j $debugfs_create_atomic_t (C function)c.debugfs_create_atomic_thNtauh1hhj|hhhNhNubj)}(hhh](j)}(hevoid debugfs_create_atomic_t (const char *name, umode_t mode, struct dentry *parent, atomic_t *value)h]j)}(hdvoid debugfs_create_atomic_t(const char *name, umode_t mode, struct dentry *parent, atomic_t *value)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMubjC)}(hdebugfs_create_atomic_th]jI)}(hdebugfs_create_atomic_th]hdebugfs_create_atomic_t}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhMubj=)}(hH(const char *name, umode_t mode, struct dentry *parent, atomic_t *value)h](jC)}(hconst char *nameh](j )}(hjJh]hconst}(hj*hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj&ubj2)}(h h]h }(hj7hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj&ubj)}(hcharh]hchar}(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubj2)}(h h]h }(hjShhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj&ubj)}(hjh]h*}(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubjI)}(hnameh]hname}(hjnhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj&ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj"ubjC)}(h umode_t modeh](h)}(hhh]jI)}(humode_th]humode_t}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jjsbc.debugfs_create_atomic_tasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hmodeh]hmode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj"ubjC)}(hstruct dentry *parenth](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.debugfs_create_atomic_tasbuh1hhjubj2)}(h h]h }(hj hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hparenth]hparent}(hj(hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj"ubjC)}(hatomic_t *valueh](h)}(hhh]jI)}(hatomic_th]hatomic_t}(hjDhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjAubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjFmodnameN classnameNjj )}j ]jc.debugfs_create_atomic_tasbuh1hhj=ubj2)}(h h]h }(hjbhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj=ubj)}(hjh]h*}(hjphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=ubjI)}(hvalueh]hvalue}(hj}hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj=ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj"ubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhMubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMhjhhubjw)}(hhh]h)}(hFcreate a debugfs file that is used to read and write an atomic_t valueh]hFcreate a debugfs file that is used to read and write an atomic_t value}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhj|hNhNubj)}(hX**Parameters** ``const char *name`` a pointer to a string containing the name of the file to create. ``umode_t mode`` the permission that the file should have ``struct dentry *parent`` a pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is ``NULL``, then the file will be created in the root of the debugfs filesystem. ``atomic_t *value`` a pointer to the variable that the file should read to and write from.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhjubj)}(hhh](j)}(hV``const char *name`` a pointer to a string containing the name of the file to create. h](j)}(h``const char *name``h]j)}(hjh]hconst char *name}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhjubj)}(hhh]h)}(h@a pointer to a string containing the name of the file to create.h]h@a pointer to a string containing the name of the file to create.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h:``umode_t mode`` the permission that the file should have h](j)}(h``umode_t mode``h]j)}(hj!h]h umode_t mode}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhjubj)}(hhh]h)}(h(the permission that the file should haveh]h(the permission that the file should have}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj6hMhj7ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj6hMhjubj)}(h``struct dentry *parent`` a pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is ``NULL``, then the file will be created in the root of the debugfs filesystem. h](j)}(h``struct dentry *parent``h]j)}(hjZh]hstruct dentry *parent}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjXubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhjTubj)}(hhh]h)}(ha pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is ``NULL``, then the file will be created in the root of the debugfs filesystem.h](hoa pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is }(hjshhhNhNubj)}(h``NULL``h]hNULL}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjsubhF, then the file will be created in the root of the debugfs filesystem.}(hjshhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhjpubah}(h]h ]h"]h$]h&]uh1jhjTubeh}(h]h ]h"]h$]h&]uh1jhjohMhjubj)}(hZ``atomic_t *value`` a pointer to the variable that the file should read to and write from.h](j)}(h``atomic_t *value``h]j)}(hjh]hatomic_t *value}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhjubj)}(hhh]h)}(hFa pointer to the variable that the file should read to and write from.h]hFa pointer to the variable that the file should read to and write from.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj|hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j  debugfs_create_bool (C function)c.debugfs_create_boolhNtauh1hhj|hhhNhNubj)}(hhh](j)}(h]void debugfs_create_bool (const char *name, umode_t mode, struct dentry *parent, bool *value)h]j)}(h\void debugfs_create_bool(const char *name, umode_t mode, struct dentry *parent, bool *value)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhj hMubjC)}(hdebugfs_create_boolh]jI)}(hdebugfs_create_boolh]hdebugfs_create_bool}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhj hMubj=)}(hD(const char *name, umode_t mode, struct dentry *parent, bool *value)h](jC)}(hconst char *nameh](j )}(hjJh]hconst}(hj<hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj8ubj2)}(h h]h }(hjIhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj8ubj)}(hcharh]hchar}(hjWhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj8ubj2)}(h h]h }(hjehhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj8ubj)}(hjh]h*}(hjshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj8ubjI)}(hnameh]hname}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj8ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj4ubjC)}(h umode_t modeh](h)}(hhh]jI)}(humode_th]humode_t}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jj"sbc.debugfs_create_boolasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hmodeh]hmode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj4ubjC)}(hstruct dentry *parenth](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.debugfs_create_boolasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hparenth]hparent}(hj:hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj4ubjC)}(h bool *valueh](j)}(hjh]hbool}(hjShhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjOubj2)}(h h]h }(hj`hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjOubj)}(hjh]h*}(hjnhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjOubjI)}(hvalueh]hvalue}(hj{hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjOubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj4ubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhj hMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhj hMubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj hMhjhhubjw)}(hhh]h)}(hDcreate a debugfs file that is used to read and write a boolean valueh]hDcreate a debugfs file that is used to read and write a boolean value}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhj hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhj|hNhNubj)}(hX**Parameters** ``const char *name`` a pointer to a string containing the name of the file to create. ``umode_t mode`` the permission that the file should have ``struct dentry *parent`` a pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is ``NULL``, then the file will be created in the root of the debugfs filesystem. ``bool *value`` a pointer to the variable that the file should read to and write from. **Description** This function creates a file in debugfs with the given name that contains the value of the variable **value**. If the **mode** variable is so set, it can be read from, and written to.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhjubj)}(hhh](j)}(hV``const char *name`` a pointer to a string containing the name of the file to create. h](j)}(h``const char *name``h]j)}(hjh]hconst char *name}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhjubj)}(hhh]h)}(h@a pointer to a string containing the name of the file to create.h]h@a pointer to a string containing the name of the file to create.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h:``umode_t mode`` the permission that the file should have h](j)}(h``umode_t mode``h]j)}(hjh]h umode_t mode}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhjubj)}(hhh]h)}(h(the permission that the file should haveh]h(the permission that the file should have}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj4hMhj5ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj4hMhjubj)}(h``struct dentry *parent`` a pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is ``NULL``, then the file will be created in the root of the debugfs filesystem. h](j)}(h``struct dentry *parent``h]j)}(hjXh]hstruct dentry *parent}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjVubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhjRubj)}(hhh]h)}(ha pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is ``NULL``, then the file will be created in the root of the debugfs filesystem.h](hoa pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is }(hjqhhhNhNubj)}(h``NULL``h]hNULL}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjqubhF, then the file will be created in the root of the debugfs filesystem.}(hjqhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhjnubah}(h]h ]h"]h$]h&]uh1jhjRubeh}(h]h ]h"]h$]h&]uh1jhjmhMhjubj)}(hW``bool *value`` a pointer to the variable that the file should read to and write from. h](j)}(h``bool *value``h]j)}(hjh]h bool *value}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhjubj)}(hhh]h)}(hFa pointer to the variable that the file should read to and write from.h]hFa pointer to the variable that the file should read to and write from.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhjubh)}(hThis function creates a file in debugfs with the given name that contains the value of the variable **value**. If the **mode** variable is so set, it can be read from, and written to.h](hdThis function creates a file in debugfs with the given name that contains the value of the variable }(hjhhhNhNubj)}(h **value**h]hvalue}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh . If the }(hjhhhNhNubj)}(h**mode**h]hmode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh9 variable is so set, it can be read from, and written to.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj|hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j debugfs_create_str (C function)c.debugfs_create_strhNtauh1hhj|hhhNhNubj)}(hhh](j)}(h]void debugfs_create_str (const char *name, umode_t mode, struct dentry *parent, char **value)h]j)}(h\void debugfs_create_str(const char *name, umode_t mode, struct dentry *parent, char **value)h](j)}(hvoidh]hvoid}(hjIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEhhhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chM#ubj2)}(h h]h }(hjXhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjEhhhjWhM#ubjC)}(hdebugfs_create_strh]jI)}(hdebugfs_create_strh]hdebugfs_create_str}(hjjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjfubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjEhhhjWhM#ubj=)}(hE(const char *name, umode_t mode, struct dentry *parent, char **value)h](jC)}(hconst char *nameh](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hcharh]hchar}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hnameh]hname}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj~ubjC)}(h umode_t modeh](h)}(hhh]jI)}(humode_th]humode_t}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jjlsbc.debugfs_create_strasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hmodeh]hmode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj~ubjC)}(hstruct dentry *parenth](j )}(hjh]hstruct}(hj-hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj)ubj2)}(h h]h }(hj:hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj)ubh)}(hhh]jI)}(hdentryh]hdentry}(hjKhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjHubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjMmodnameN classnameNjj )}j ]jc.debugfs_create_strasbuh1hhj)ubj2)}(h h]h }(hjihhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj)ubj)}(hjh]h*}(hjwhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubjI)}(hparenth]hparent}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj)ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj~ubjC)}(h char **valueh](j)}(hcharh]hchar}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hvalueh]hvalue}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj~ubeh}(h]h ]h"]h$]h&]j`jauh1j<hjEhhhjWhM#ubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjAhhhjWhM#ubah}(h]j<ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjWhM#hj>hhubjw)}(hhh]h)}(h9create a debugfs file that is used to read a string valueh]h9create a debugfs file that is used to read a string value}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chM#hjhhubah}(h]h ]h"]h$]h&]uh1jvhj>hhhjWhM#ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhj|hNhNubj)}(hX**Parameters** ``const char *name`` a pointer to a string containing the name of the file to create. ``umode_t mode`` the permission that the file should have ``struct dentry *parent`` a pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is ``NULL``, then the file will be created in the root of the debugfs filesystem. ``char **value`` a pointer to the variable that the file should read from. This pointer and the string it points to must not be ``NULL``. **Description** This function creates a file in debugfs with the given name that contains the value of the variable **value**. The file can be read from. Writable files are not supported; if **mode** contains write permission bits, no file is created.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chM'hjubj)}(hhh](j)}(hV``const char *name`` a pointer to a string containing the name of the file to create. h](j)}(h``const char *name``h]j)}(hj>h]hconst char *name}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj<ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chM$hj8ubj)}(hhh]h)}(h@a pointer to a string containing the name of the file to create.h]h@a pointer to a string containing the name of the file to create.}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjShM$hjTubah}(h]h ]h"]h$]h&]uh1jhj8ubeh}(h]h ]h"]h$]h&]uh1jhjShM$hj5ubj)}(h:``umode_t mode`` the permission that the file should have h](j)}(h``umode_t mode``h]j)}(hjwh]h umode_t mode}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjuubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chM%hjqubj)}(hhh]h)}(h(the permission that the file should haveh]h(the permission that the file should have}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM%hjubah}(h]h ]h"]h$]h&]uh1jhjqubeh}(h]h ]h"]h$]h&]uh1jhjhM%hj5ubj)}(h``struct dentry *parent`` a pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is ``NULL``, then the file will be created in the root of the debugfs filesystem. h](j)}(h``struct dentry *parent``h]j)}(hjh]hstruct dentry *parent}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chM(hjubj)}(hhh]h)}(ha pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is ``NULL``, then the file will be created in the root of the debugfs filesystem.h](hoa pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is }(hjhhhNhNubj)}(h``NULL``h]hNULL}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhF, then the file will be created in the root of the debugfs filesystem.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chM&hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM(hj5ubj)}(h``char **value`` a pointer to the variable that the file should read from. This pointer and the string it points to must not be ``NULL``. h](j)}(h``char **value``h]j)}(hjh]h char **value}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chM*hjubj)}(hhh]h)}(hxa pointer to the variable that the file should read from. This pointer and the string it points to must not be ``NULL``.h](hoa pointer to the variable that the file should read from. This pointer and the string it points to must not be }(hjhhhNhNubj)}(h``NULL``h]hNULL}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chM)hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM*hj5ubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjJh]h Description}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjHubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chM,hjubh)}(hThis function creates a file in debugfs with the given name that contains the value of the variable **value**. The file can be read from. Writable files are not supported; if **mode** contains write permission bits, no file is created.h](hdThis function creates a file in debugfs with the given name that contains the value of the variable }(hj`hhhNhNubj)}(h **value**h]hvalue}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj`ubhC. The file can be read from. Writable files are not supported; if }(hj`hhhNhNubj)}(h**mode**h]hmode}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj`ubh4 contains write permission bits, no file is created.}(hj`hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chM+hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj|hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j  debugfs_create_blob (C function)c.debugfs_create_blobhNtauh1hhj|hhhNhNubj)}(hhh](j)}(h~struct dentry * debugfs_create_blob (const char *name, umode_t mode, struct dentry *parent, struct debugfs_blob_wrapper *blob)h]j)}(h|struct dentry *debugfs_create_blob(const char *name, umode_t mode, struct dentry *parent, struct debugfs_blob_wrapper *blob)h](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjhhhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMgubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMgubh)}(hhh]jI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j)}jdebugfs_create_blobsbc.debugfs_create_blobasbuh1hhjhhhjhMgubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMgubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMgubjC)}(hdebugfs_create_blobh]jI)}(hjh]hdebugfs_create_blob}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhMgubj=)}(hZ(const char *name, umode_t mode, struct dentry *parent, struct debugfs_blob_wrapper *blob)h](jC)}(hconst char *nameh](j )}(hjJh]hconst}(hj-hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj)ubj2)}(h h]h }(hj:hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj)ubj)}(hcharh]hchar}(hjHhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubj2)}(h h]h }(hjVhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj)ubj)}(hjh]h*}(hjdhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubjI)}(hnameh]hname}(hjqhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj)ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj%ubjC)}(h umode_t modeh](h)}(hhh]jI)}(humode_th]humode_t}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.debugfs_create_blobasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hmodeh]hmode}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj%ubjC)}(hstruct dentry *parenth](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.debugfs_create_blobasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hparenth]hparent}(hj)hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj%ubjC)}(h!struct debugfs_blob_wrapper *blobh](j )}(hjh]hstruct}(hjBhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj>ubj2)}(h h]h }(hjOhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj>ubh)}(hhh]jI)}(hdebugfs_blob_wrapperh]hdebugfs_blob_wrapper}(hj`hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj]ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjbmodnameN classnameNjj )}j ]jc.debugfs_create_blobasbuh1hhj>ubj2)}(h h]h }(hj~hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj>ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>ubjI)}(hblobh]hblob}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj>ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj%ubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhMgubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhjhMgubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMghjhhubjw)}(hhh]h)}(hBcreate a debugfs file that is used to read and write a binary blobh]hBcreate a debugfs file that is used to read and write a binary blob}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMghjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhjhMgubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhj|hNhNubj)}(hXa**Parameters** ``const char *name`` a pointer to a string containing the name of the file to create. ``umode_t mode`` the permission that the file should have ``struct dentry *parent`` a pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is ``NULL``, then the file will be created in the root of the debugfs filesystem. ``struct debugfs_blob_wrapper *blob`` a pointer to a struct debugfs_blob_wrapper which contains a pointer to the blob data and the size of the data. **Description** This function creates a file in debugfs with the given name that exports **blob->data** as a binary blob. If the **mode** variable is so set it can be read from and written to. This function will return a pointer to a dentry if it succeeds. This pointer must be passed to the debugfs_remove() function when the file is to be removed (no automatic cleanup happens if your module is unloaded, you are responsible here.) If an error occurs, ERR_PTR(-ERROR) will be returned. If debugfs is not enabled in the kernel, the value ERR_PTR(-ENODEV) will be returned.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMkhjubj)}(hhh](j)}(hV``const char *name`` a pointer to a string containing the name of the file to create. h](j)}(h``const char *name``h]j)}(hjh]hconst char *name}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMihjubj)}(hhh]h)}(h@a pointer to a string containing the name of the file to create.h]h@a pointer to a string containing the name of the file to create.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMihjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMihjubj)}(h:``umode_t mode`` the permission that the file should have h](j)}(h``umode_t mode``h]j)}(hj=h]h umode_t mode}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj;ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMjhj7ubj)}(hhh]h)}(h(the permission that the file should haveh]h(the permission that the file should have}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjRhMjhjSubah}(h]h ]h"]h$]h&]uh1jhj7ubeh}(h]h ]h"]h$]h&]uh1jhjRhMjhjubj)}(h``struct dentry *parent`` a pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is ``NULL``, then the file will be created in the root of the debugfs filesystem. h](j)}(h``struct dentry *parent``h]j)}(hjvh]hstruct dentry *parent}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjtubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMmhjpubj)}(hhh]h)}(ha pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is ``NULL``, then the file will be created in the root of the debugfs filesystem.h](hoa pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is }(hjhhhNhNubj)}(h``NULL``h]hNULL}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhF, then the file will be created in the root of the debugfs filesystem.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMkhjubah}(h]h ]h"]h$]h&]uh1jhjpubeh}(h]h ]h"]h$]h&]uh1jhjhMmhjubj)}(h``struct debugfs_blob_wrapper *blob`` a pointer to a struct debugfs_blob_wrapper which contains a pointer to the blob data and the size of the data. h](j)}(h%``struct debugfs_blob_wrapper *blob``h]j)}(hjh]h!struct debugfs_blob_wrapper *blob}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMohjubj)}(hhh]h)}(hna pointer to a struct debugfs_blob_wrapper which contains a pointer to the blob data and the size of the data.h]hna pointer to a struct debugfs_blob_wrapper which contains a pointer to the blob data and the size of the data.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMnhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMohjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMqhjubh)}(hThis function creates a file in debugfs with the given name that exports **blob->data** as a binary blob. If the **mode** variable is so set it can be read from and written to.h](hIThis function creates a file in debugfs with the given name that exports }(hjhhhNhNubj)}(h**blob->data**h]h blob->data}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh as a binary blob. If the }(hjhhhNhNubj)}(h**mode**h]hmode}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh7 variable is so set it can be read from and written to.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMphjubh)}(hX(This function will return a pointer to a dentry if it succeeds. This pointer must be passed to the debugfs_remove() function when the file is to be removed (no automatic cleanup happens if your module is unloaded, you are responsible here.) If an error occurs, ERR_PTR(-ERROR) will be returned.h]hX(This function will return a pointer to a dentry if it succeeds. This pointer must be passed to the debugfs_remove() function when the file is to be removed (no automatic cleanup happens if your module is unloaded, you are responsible here.) If an error occurs, ERR_PTR(-ERROR) will be returned.}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMthjubh)}(hUIf debugfs is not enabled in the kernel, the value ERR_PTR(-ENODEV) will be returned.h]hUIf debugfs is not enabled in the kernel, the value ERR_PTR(-ENODEV) will be returned.}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMzhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj|hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j %debugfs_create_u32_array (C function)c.debugfs_create_u32_arrayhNtauh1hhj|hhhNhNubj)}(hhh](j)}(hvvoid debugfs_create_u32_array (const char *name, umode_t mode, struct dentry *parent, struct debugfs_u32_array *array)h]j)}(huvoid debugfs_create_u32_array(const char *name, umode_t mode, struct dentry *parent, struct debugfs_u32_array *array)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhjhMubjC)}(hdebugfs_create_u32_arrayh]jI)}(hdebugfs_create_u32_arrayh]hdebugfs_create_u32_array}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhjhMubj=)}(hX(const char *name, umode_t mode, struct dentry *parent, struct debugfs_u32_array *array)h](jC)}(hconst char *nameh](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hcharh]hchar}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hnameh]hname}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(h umode_t modeh](h)}(hhh]jI)}(humode_th]humode_t}(hj"hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj$modnameN classnameNjj )}j ]j)}jjsbc.debugfs_create_u32_arrayasbuh1hhjubj2)}(h h]h }(hjBhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubjI)}(hmodeh]hmode}(hjPhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct dentry *parenth](j )}(hjh]hstruct}(hjihhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjeubj2)}(h h]h }(hjvhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjeubh)}(hhh]jI)}(hdentryh]hdentry}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j>c.debugfs_create_u32_arrayasbuh1hhjeubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjeubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubjI)}(hparenth]hparent}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjeubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubjC)}(hstruct debugfs_u32_array *arrayh](j )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hdebugfs_u32_arrayh]hdebugfs_u32_array}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]j>c.debugfs_create_u32_arrayasbuh1hhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(harrayh]harray}(hj0hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhjhMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj}hhhjhMubah}(h]jxah ](jnjoeh"]h$]h&]jsjt)juhuh1jhjhMhjzhhubjw)}(hhh]h)}(h5create a debugfs file that is used to read u32 array.h]h5create a debugfs file that is used to read u32 array.}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhjWhhubah}(h]h ]h"]h$]h&]uh1jvhjzhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjrjjrjjjuh1jhhhj|hNhNubj)}(hX**Parameters** ``const char *name`` a pointer to a string containing the name of the file to create. ``umode_t mode`` the permission that the file should have. ``struct dentry *parent`` a pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is ``NULL``, then the file will be created in the root of the debugfs filesystem. ``struct debugfs_u32_array *array`` wrapper struct containing data pointer and size of the array. **Description** This function creates a file in debugfs with the given name that exports **array** as data. If the **mode** variable is so set it can be read from. Writing is not supported. Seek within the file is also not supported. Once array is created its size can not be changed.h](h)}(h**Parameters**h]j)}(hj|h]h Parameters}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjzubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhjvubj)}(hhh](j)}(hV``const char *name`` a pointer to a string containing the name of the file to create. h](j)}(h``const char *name``h]j)}(hjh]hconst char *name}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhjubj)}(hhh]h)}(h@a pointer to a string containing the name of the file to create.h]h@a pointer to a string containing the name of the file to create.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h;``umode_t mode`` the permission that the file should have. h](j)}(h``umode_t mode``h]j)}(hjh]h umode_t mode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhjubj)}(hhh]h)}(h)the permission that the file should have.h]h)the permission that the file should have.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h``struct dentry *parent`` a pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is ``NULL``, then the file will be created in the root of the debugfs filesystem. h](j)}(h``struct dentry *parent``h]j)}(hj h]hstruct dentry *parent}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhjubj)}(hhh]h)}(ha pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is ``NULL``, then the file will be created in the root of the debugfs filesystem.h](hoa pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is }(hj&hhhNhNubj)}(h``NULL``h]hNULL}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj&ubhF, then the file will be created in the root of the debugfs filesystem.}(hj&hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhj#ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj"hMhjubj)}(hb``struct debugfs_u32_array *array`` wrapper struct containing data pointer and size of the array. h](j)}(h#``struct debugfs_u32_array *array``h]j)}(hjYh]hstruct debugfs_u32_array *array}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjWubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhjSubj)}(hhh]h)}(h=wrapper struct containing data pointer and size of the array.h]h=wrapper struct containing data pointer and size of the array.}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjnhMhjoubah}(h]h ]h"]h$]h&]uh1jhjSubeh}(h]h ]h"]h$]h&]uh1jhjnhMhjubeh}(h]h ]h"]h$]h&]uh1jhjvubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhjvubh)}(hX This function creates a file in debugfs with the given name that exports **array** as data. If the **mode** variable is so set it can be read from. Writing is not supported. Seek within the file is also not supported. Once array is created its size can not be changed.h](hIThis function creates a file in debugfs with the given name that exports }(hjhhhNhNubj)}(h **array**h]harray}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh as data. If the }(hjhhhNhNubj)}(h**mode**h]hmode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh variable is so set it can be read from. Writing is not supported. Seek within the file is also not supported. Once array is created its size can not be changed.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhjvubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj|hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j !debugfs_print_regs32 (C function)c.debugfs_print_regs32hNtauh1hhj|hhhNhNubj)}(hhh](j)}(h}void debugfs_print_regs32 (struct seq_file *s, const struct debugfs_reg32 *regs, int nregs, void __iomem *base, char *prefix)h]j)}(h|void debugfs_print_regs32(struct seq_file *s, const struct debugfs_reg32 *regs, int nregs, void __iomem *base, char *prefix)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMubj2)}(h h]h }(hj hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhj hMubjC)}(hdebugfs_print_regs32h]jI)}(hdebugfs_print_regs32h]hdebugfs_print_regs32}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhj hMubj=)}(hc(struct seq_file *s, const struct debugfs_reg32 *regs, int nregs, void __iomem *base, char *prefix)h](jC)}(hstruct seq_file *sh](j )}(hjh]hstruct}(hj:hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj6ubj2)}(h h]h }(hjGhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj6ubh)}(hhh]jI)}(hseq_fileh]hseq_file}(hjXhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjUubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjZmodnameN classnameNjj )}j ]j)}jj sbc.debugfs_print_regs32asbuh1hhj6ubj2)}(h h]h }(hjxhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj6ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj6ubjI)}(hj9h]hs}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj6ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj2ubjC)}(h const struct debugfs_reg32 *regsh](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(h debugfs_reg32h]h debugfs_reg32}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jtc.debugfs_print_regs32asbuh1hhjubj2)}(h h]h }(hj hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hregsh]hregs}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj2ubjC)}(h int nregsh](j)}(hinth]hint}(hj6 hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2 ubj2)}(h h]h }(hjD hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj2 ubjI)}(hnregsh]hnregs}(hjR hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj2 ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj2ubjC)}(hvoid __iomem *baseh](j)}(hvoidh]hvoid}(hjk hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjg ubj2)}(h h]h }(hjy hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjg ubh__iomem}(hjg hhhNhNubj2)}(h h]h }(hj hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjg ubj)}(hjh]h*}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjg ubjI)}(hbaseh]hbase}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjg ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj2ubjC)}(h char *prefixh](j)}(hcharh]hchar}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj2)}(h h]h }(hj hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj ubj)}(hjh]h*}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubjI)}(hprefixh]hprefix}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj2ubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhj hMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhj hMubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj hMhjhhubjw)}(hhh]h)}(h,use seq_print to describe a set of registersh]h,use seq_print to describe a set of registers}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhj hhubah}(h]h ]h"]h$]h&]uh1jvhjhhhj hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjj* jj* jjjuh1jhhhj|hNhNubj)}(hX**Parameters** ``struct seq_file *s`` the seq_file structure being used to generate output ``const struct debugfs_reg32 *regs`` an array if struct debugfs_reg32 structures ``int nregs`` the length of the above array ``void __iomem *base`` the base address to be used in reading the registers ``char *prefix`` a string to be prefixed to every output line **Description** This function outputs a text block describing the current values of some 32-bit hardware registers. It is meant to be used within debugfs files based on seq_file that need to show registers, intermixed with other information. The prefix argument may be used to specify a leading string, because some peripherals have several blocks of identical registers, for example configuration of dma channelsh](h)}(h**Parameters**h]j)}(hj4 h]h Parameters}(hj6 hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj2 ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhj. ubj)}(hhh](j)}(hL``struct seq_file *s`` the seq_file structure being used to generate output h](j)}(h``struct seq_file *s``h]j)}(hjS h]hstruct seq_file *s}(hjU hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjQ ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhjM ubj)}(hhh]h)}(h4the seq_file structure being used to generate outputh]h4the seq_file structure being used to generate output}(hjl hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjh hMhji ubah}(h]h ]h"]h$]h&]uh1jhjM ubeh}(h]h ]h"]h$]h&]uh1jhjh hMhjJ ubj)}(hQ``const struct debugfs_reg32 *regs`` an array if struct debugfs_reg32 structures h](j)}(h$``const struct debugfs_reg32 *regs``h]j)}(hj h]h const struct debugfs_reg32 *regs}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhj ubj)}(hhh]h)}(h+an array if struct debugfs_reg32 structuresh]h+an array if struct debugfs_reg32 structures}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hMhjJ ubj)}(h,``int nregs`` the length of the above array h](j)}(h ``int nregs``h]j)}(hj h]h int nregs}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhj ubj)}(hhh]h)}(hthe length of the above arrayh]hthe length of the above array}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hMhjJ ubj{})}(hL``void __iomem *base`` the base address to be used in reading the registers h](j)}(h``void __iomem *base``h]j)}(hj h]hvoid __iomem *base}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhj ubj)}(hhh]h)}(h4the base address to be used in reading the registersh]h4the base address to be used in reading the registers}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hMhjJ ubj)}(h>``char *prefix`` a string to be prefixed to every output line h](j)}(h``char *prefix``h]j)}(hj7 h]h char *prefix}(hj9 hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj5 ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhj1 ubj)}(hhh]h)}(h,a string to be prefixed to every output lineh]h,a string to be prefixed to every output line}(hjP hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjL hMhjM ubah}(h]h ]h"]h$]h&]uh1jhj1 ubeh}(h]h ]h"]h$]h&]uh1jhjL hMhjJ ubeh}(h]h ]h"]h$]h&]uh1jhj. ubh)}(h**Description**h]j)}(hjr h]h Description}(hjt hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjp ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhj. ubh)}(hXThis function outputs a text block describing the current values of some 32-bit hardware registers. It is meant to be used within debugfs files based on seq_file that need to show registers, intermixed with other information. The prefix argument may be used to specify a leading string, because some peripherals have several blocks of identical registers, for example configuration of dma channelsh]hXThis function outputs a text block describing the current values of some 32-bit hardware registers. It is meant to be used within debugfs files based on seq_file that need to show registers, intermixed with other information. The prefix argument may be used to specify a leading string, because some peripherals have several blocks of identical registers, for example configuration of dma channels}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhj. ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj|hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j $debugfs_create_regset32 (C function)c.debugfs_create_regset32hNtauh1hhj|hhhNhNubj)}(hhh](j)}(huvoid debugfs_create_regset32 (const char *name, umode_t mode, struct dentry *parent, struct debugfs_regset32 *regset)h]j)}(htvoid debugfs_create_regset32(const char *name, umode_t mode, struct dentry *parent, struct debugfs_regset32 *regset)h](j)}(hvoidh]hvoid}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMubj2)}(h h]h }(hj hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj hhhj hMubjC)}(hdebugfs_create_regset32h]jI)}(hdebugfs_create_regset32h]hdebugfs_create_regset32}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhj hhhj hMubj=)}(hX(const char *name, umode_t mode, struct dentry *parent, struct debugfs_regset32 *regset)h](jC)}(hconst char *nameh](j )}(hjJh]hconst}(hj hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj ubj2)}(h h]h }(hj hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj ubj)}(hcharh]hchar}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj2)}(h h]h }(hj hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj ubj)}(hjh]h*}(hj+ hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubjI)}(hnameh]hname}(hj8 hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj ubjC)}(h umode_t modeh](h)}(hhh]jI)}(humode_th]humode_t}(hjT hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjQ ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjV modnameN classnameNjj )}j ]j)}jj sbc.debugfs_create_regset32asbuh1hhjM ubj2)}(h h]h }(hjt hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjM ubjI)}(hmodeh]hmode}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjM ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj ubjC)}(hstruct dentry *parenth](j )}(hjh]hstruct}(hj hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj ubj2)}(h h]h }(hj hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj ubh)}(hhh]jI)}(hdentryh]hdentry}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj modnameN classnameNjj )}j ]jp c.debugfs_create_regset32asbuh1hhj ubj2)}(h h]h }(hj hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj ubj)}(hjh]h*}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubjI)}(hparenth]hparent}(hj hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj ubjC)}(hstruct debugfs_regset32 *regseth](j )}(hjh]hstruct}(hj hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj ubj2)}(h h]h }(hj hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj ubh)}(hhh]jI)}(hdebugfs_regset32h]hdebugfs_regset32}(hj) hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj& ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj+ modnameN classnameNjj )}j ]jp c.debugfs_create_regset32asbuh1hhj ubj2)}(h h]h }(hjG hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj ubj)}(hjh]h*}(hjU hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubjI)}(hregseth]hregset}(hjb hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhj ubeh}(h]h ]h"]h$]h&]j`jauh1j<hj hhhj hMubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhj hhhj hMubah}(h]j ah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj hMhj hhubjw)}(hhh]h)}(h2create a debugfs file that returns register valuesh]h2create a debugfs file that returns register values}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhj hhubah}(h]h ]h"]h$]h&]uh1jvhj hhhj hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjj jj jjjuh1jhhhj|hNhNubj)}(hX@**Parameters** ``const char *name`` a pointer to a string containing the name of the file to create. ``umode_t mode`` the permission that the file should have ``struct dentry *parent`` a pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is ``NULL``, then the file will be created in the root of the debugfs filesystem. ``struct debugfs_regset32 *regset`` a pointer to a struct debugfs_regset32, which contains a pointer to an array of register definitions, the array size and the base address where the register bank is to be found. **Description** This function creates a file in debugfs with the given name that reports the names and values of a set of 32-bit registers. If the **mode** variable is so set it can be read from. Writing is not supported.h](h)}(h**Parameters**h]j)}(hj h]h Parameters}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhj ubj)}(hhh](j)}(hV``const char *name`` a pointer to a string containing the name of the file to create. h](j)}(h``const char *name``h]j)}(hj h]hconst char *name}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhj ubj)}(hhh]h)}(h@a pointer to a string containing the name of the file to create.h]h@a pointer to a string containing the name of the file to create.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hMhj ubj)}(h:``umode_t mode`` the permission that the file should have h](j)}(h``umode_t mode``h]j)}(hjh]h umode_t mode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhjubj)}(hhh]h)}(h(the permission that the file should haveh]h(the permission that the file should have}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhj ubj)}(h``struct dentry *parent`` a pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is ``NULL``, then the file will be created in the root of the debugfs filesystem. h](j)}(h``struct dentry *parent``h]j)}(hj?h]hstruct dentry *parent}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj=ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhj9ubj)}(hhh]h)}(ha pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is ``NULL``, then the file will be created in the root of the debugfs filesystem.h](hoa pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is }(hjXhhhNhNubj)}(h``NULL``h]hNULL}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjXubhF, then the file will be created in the root of the debugfs filesystem.}(hjXhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhjUubah}(h]h ]h"]h$]h&]uh1jhj9ubeh}(h]h ]h"]h$]h&]uh1jhjThMhj ubj)}(h``struct debugfs_regset32 *regset`` a pointer to a struct debugfs_regset32, which contains a pointer to an array of register definitions, the array size and the base address where the register bank is to be found. h](j)}(h#``struct debugfs_regset32 *regset``h]j)}(hjh]hstruct debugfs_regset32 *regset}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhjubj)}(hhh]h)}(ha pointer to a struct debugfs_regset32, which contains a pointer to an array of register definitions, the array size and the base address where the register bank is to be found.h]ha pointer to a struct debugfs_regset32, which contains a pointer to an array of register definitions, the array size and the base address where the register bank is to be found.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhj ubeh}(h]h ]h"]h$]h&]uh1jhj ubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chM hj ubh)}(hThis function creates a file in debugfs with the given name that reports the names and values of a set of 32-bit registers. If the **mode** variable is so set it can be read from. Writing is not supported.h](hThis function creates a file in debugfs with the given name that reports the names and values of a set of 32-bit registers. If the }(hjhhhNhNubj)}(h**mode**h]hmode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhB variable is so set it can be read from. Writing is not supported.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMhj ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj|hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](j (debugfs_create_devm_seqfile (C function)c.debugfs_create_devm_seqfilehNtauh1hhj|hhhNhNubj)}(hhh](j)}(hvoid debugfs_create_devm_seqfile (struct device *dev, const char *name, struct dentry *parent, int (*read_fn)(struct seq_file *s, void *data))h]j)}(hvoid debugfs_create_devm_seqfile(struct device *dev, const char *name, struct dentry *parent, int (*read_fn)(struct seq_file *s, void *data))h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMCubj2)}(h h]h }(hj-hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjhhhj,hMCubjC)}(hdebugfs_create_devm_seqfileh]jI)}(hdebugfs_create_devm_seqfileh]hdebugfs_create_devm_seqfile}(hj?hhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj;ubah}(h]h ](j[j\eh"]h$]h&]j`jauh1jBhjhhhj,hMCubj=)}(hm(struct device *dev, const char *name, struct dentry *parent, int (*read_fn)(struct seq_file *s, void *data))h](jC)}(hstruct device *devh](j )}(hjh]hstruct}(hj[hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjWubj2)}(h h]h }(hjhhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjWubh)}(hhh]jI)}(hdeviceh]hdevice}(hjyhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjvubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj{modnameN classnameNjj )}j ]j)}jjAsbc.debugfs_create_devm_seqfileasbuh1hhjWubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjWubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjWubjI)}(hdevh]hdev}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjWubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjSubjC)}(hconst char *nameh](j )}(hjJh]hconst}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hcharh]hchar}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hnameh]hname}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjSubjC)}(hstruct dentry *parenth](j )}(hjh]hstruct}(hj*hhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhj&ubj2)}(h h]h }(hj7hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj&ubh)}(hhh]jI)}(hdentryh]hdentry}(hjHhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjEubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjJmodnameN classnameNjj )}j ]jc.debugfs_create_devm_seqfileasbuh1hhj&ubj2)}(h h]h }(hjfhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hj&ubj)}(hjh]h*}(hjthhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubjI)}(hparenth]hparent}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhj&ubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjSubjC)}(h.int (*read_fn)(struct seq_file *s, void *data)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjʥh]h(}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hread_fnh]hread_fn}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubj)}(hjh]h)}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjʥh]h(}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj )}(hjh]hstruct}(hjhhhNhNubah}(h]h ]j,ah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubh)}(hhh]jI)}(hseq_fileh]hseq_file}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj )}j ]jc.debugfs_create_devm_seqfileasbuh1hhjubj2)}(h h]h }(hj4hhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hj9h]hs}(hjOhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubj)}(hjWh]h,}(hj\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjihhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hvoidh]hvoid}(hjwhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj2)}(h h]h }(hjhhhNhNubah}(h]h ]j>ah"]h$]h&]uh1j1hjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjI)}(hdatah]hdata}(hjhhhNhNubah}(h]h ]jTah"]h$]h&]uh1jHhjubj)}(hjh]h)}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphj`jauh1jBhjSubeh}(h]h ]h"]h$]h&]j`jauh1j<hjhhhj,hMCubeh}(h]h ]h"]h$]h&]j`jajhuh1jjijjhjhhhj,hMCubah}(h]jah ](jnjoeh"]h$]h&]jsjt)juhuh1jhj,hMChjhhubjw)}(hhh]h)}(h.create a debugfs file that is bound to device.h]h.create a debugfs file that is bound to device.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMChjhhubah}(h]h ]h"]h$]h&]uh1jvhjhhhj,hMCubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhj|hNhNubj)}(hX**Parameters** ``struct device *dev`` device related to this debugfs file. ``const char *name`` name of the debugfs file. ``struct dentry *parent`` a pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is ``NULL``, then the file will be created in the root of the debugfs filesystem. ``int (*read_fn)(struct seq_file *s, void *data)`` function pointer called to print the seq_file content.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMGhjubj)}(hhh](j)}(h<``struct device *dev`` device related to this debugfs file. h](j)}(h``struct device *dev``h]j)}(hjh]hstruct device *dev}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMEhjubj)}(hhh]h)}(h$device related to this debugfs file.h]h$device related to this debugfs file.}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj-hMEhj.ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj-hMEhjubj)}(h/``const char *name`` name of the debugfs file. h](j)}(h``const char *name``h]j)}(hjQh]hconst char *name}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1jhjOubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMFhjKubj)}(hhh]h)}(hname of the debugfs file.h]hname of the debugfs file.}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjfhMFhjgubah}(h]h ]h"]h$]h&]uh1jhjKubeh}(h]h ]h"]h$]h&]uh1jhjfhMFhjubj)}(h``struct dentry *parent`` a pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is ``NULL``, then the file will be created in the root of the debugfs filesystem. h](j)}(h``struct dentry *parent``h]j)}(hjh]hstruct dentry *parent}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMIhjubj)}(hhh]h)}(ha pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is ``NULL``, then the file will be created in the root of the debugfs filesystem.h](hoa pointer to the parent dentry for this file. This should be a directory dentry if set. If this parameter is }(hjhhhNhNubj)}(h``NULL``h]hNULL}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhF, then the file will be created in the root of the debugfs filesystem.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMGhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMIhjubj)}(hi``int (*read_fn)(struct seq_file *s, void *data)`` function pointer called to print the seq_file content.h](j)}(h2``int (*read_fn)(struct seq_file *s, void *data)``h]j)}(hjh]h.int (*read_fn)(struct seq_file *s, void *data)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMKhjubj)}(hhh]h)}(h6function pointer called to print the seq_file content.h]h6function pointer called to print the seq_file content.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/api-summary:149: ./fs/debugfs/file.chMJhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMKhjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj|hhhNhNubeh}(h]debugfs-interfaceah ]h"]debugfs interfaceah$]h&]uh1hhjkhhhhhKubeh}(h]the-debugfs-filesystemah ]h"]the debugfs filesystemah$]h&]uh1hhhhhhhhKubeh}(h]linux-filesystems-api-summaryah ]h"]linux filesystems api summaryah$]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_handlerjRerror_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,j)j4Ej1EjEjEjjjtjqj@4j=4jLgjIgj,Ej)Ejjjjjhjhjjjjjwjwjjjhjej$j!jju nametypes}(j,j4EjEjjtj@4jLgj,Ejjjhjjjwjjhj$juh}(j)hj1EhjEhj jjjj\jajjjjjsjxjjjj!jjj jjF"jK"j$j$j'j'j)j)j{,j,j.j.j/j/j2j2j3j3j+5j05j#7j(7j8j8j%:j*:j;j;j'=j,=j?j?jE@jJ@jAjAjGCjLCjjEjEjFjGjGjJjJjLjLjNjNjPj PjQjQjRjSjUjUjWjWj)Zj.Zj9\j>\jI^jN^juajzajdjdjlgjqgjhjhjnjjsjjHmjMmj=pjBpjyrj~rj(uj-ujQwjVwjyj$yj8{j={j|j|j~j~jLjQj́jҁjNjSj%j*jjjjjIjNjqjj9j>jjjwj|jjjjjjjߗjjjjwj|jjjjÞj?jDjijnjmjrj jjjjjjHjMjvj{jѺjֺjjjj jWj\jjjojtjEjJjjj:j?jjjNjSjjjjj[j`jjjjjjjajfjj jjjjjjj%j*jpjujjjjjqjvjjj=4jwjjj.j3jjjdjijjj| j jjjcjhj jjjj^jcj-!j2!ji#jn#j%j%j)j#)j+j+jh-jm-j1j$1jIgjC4j`4je4j6j6jY8j^8j;;j@;j<j<j>j>jAj AjjCjjjj jjjjjjjjjcjhjjjAjFjjjjjjj.j3jjjjjjj jjjj; j@ j=jBjj jjjjjjjwj|j j j"j"j'j'j*j*j-j-j0j0j%3j*3j4j4j%6j*6j7j7j'9j,9j:j:js<jx<j>j>j?j?j(Aj-Aj/Cj4Cjjj7EjhjHEjeEjjEj[Ij`IjNMjSMj2Qj7QjUjUj YjYj\j]j`j`jdjdjjjhjhjhjwjjjkjkjmj mjnjnjqjqjsjtjujujjwjwjwjyjyjx{j}{j~j~jjjejjjjjjjjFjKj؏jݏjkjpjtjyjjjmjrjjjjjj jjjjjjj[j`jLjQj!jkjj|jjjj#jQjVjjjWj\jjjjj_jdjvj{jjjjjjj3j8j|jjjjj jcjhjjjj$jjjjjjjjjjjjjjj<jAjjjxj}jjj j jju 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.