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/core-api/mm-apimodnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Traditional)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget#/translations/zh_TW/core-api/mm-apimodnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget#/translations/it_IT/core-api/mm-apimodnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget#/translations/ja_JP/core-api/mm-apimodnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget#/translations/ko_KR/core-api/mm-apimodnameN classnameN refexplicituh1hhh ubh)}(hhh]hPortuguese (Brazilian)}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget#/translations/pt_BR/core-api/mm-apimodnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget#/translations/sp_SP/core-api/mm-apimodnameN classnameN refexplicituh1hhh ubeh}(h]h ]h"]h$]h&]current_languageEnglishuh1h hh _documenthsourceNlineNubhsection)}(hhh](htitle)}(hMemory Management APIsh]hMemory Management APIs}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhh=/var/lib/git/docbuild/linux/Documentation/core-api/mm-api.rsthKubh)}(hhh](h)}(hUser Space Memory Accessh]hUser Space Memory Access}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhhhKubhindex)}(hhh]h}(h]h ]h"]h$]h&]entries](singleget_user (C macro) c.get_userhNtauh1hhhhhhNhNubhdesc)}(hhh](hdesc_signature)}(hget_userh]hdesc_signature_line)}(hget_userh]h desc_name)}(hget_userh]h desc_sig_name)}(hhh]hget_user}(hjhhhNhNubah}(h]h ]nah"]h$]h&]uh1jhjubah}(h]h ](sig-namedescnameeh"]h$]h&] xml:spacepreserveuh1hhhhhh]/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:8: ./arch/x86/include/asm/uaccess.hhKVubah}(h]h ]h"]h$]h&]jj add_permalinkuh1hsphinx_line_type declaratorhhhhhjhKVubah}(h]hah ](sig sig-objecteh"]h$]h&] is_multiline _toc_parts) _toc_namehuh1hhjhKVhhhhubh desc_content)}(hhh]h}(h]h ]h"]h$]h&]uh1j3hhhhhjhKVubeh}(h]h ](cmacroeh"]h$]h&]domainjAobjtypejBdesctypejBnoindex noindexentrynocontentsentryuh1hhhhhhNhNubh paragraph)}(h``get_user (x, ptr)``h]hliteral)}(hjPh]hget_user (x, ptr)}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjNubah}(h]h ]h"]h$]h&]uh1jLh]/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:8: ./arch/x86/include/asm/uaccess.hhKXhhhhubh block_quote)}(h'Get a simple variable from user space. h]jM)}(h&Get a simple variable from user space.h]h&Get a simple variable from user space.}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1jLh]/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:8: ./arch/x86/include/asm/uaccess.hhKVhjjubah}(h]h ]h"]h$]h&]uh1jhhj|hKVhhhhubh container)}(hXW**Parameters** ``x`` Variable to store result. ``ptr`` Source address, in user space. **Context** User context only. This function may sleep if pagefaults are enabled. **Description** This macro copies a single simple variable from user space to kernel space. It supports simple types like char and int, but not larger data types like structures or arrays. **ptr** must have pointer-to-simple-variable type, and the result of dereferencing **ptr** must be assignable to **x** without a cast. **Return** zero on success, or -EFAULT on error. On error, the variable **x** is set to zero.h](jM)}(h**Parameters**h]hstrong)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLh]/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:8: ./arch/x86/include/asm/uaccess.hhKZhjubhdefinition_list)}(hhh](hdefinition_list_item)}(h ``x`` Variable to store result. h](hterm)}(h``x``h]jS)}(hjh]hx}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:8: ./arch/x86/include/asm/uaccess.hhKWhjubh definition)}(hhh]jM)}(hVariable to store result.h]hVariable to store result.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhKWhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKWhjubj)}(h'``ptr`` Source address, in user space. h](j)}(h``ptr``h]jS)}(hjh]hptr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:8: ./arch/x86/include/asm/uaccess.hhKXhjubj)}(hhh]jM)}(hSource address, in user space.h]hSource address, in user space.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhKXhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKXhjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h **Context**h]j)}(hj(h]hContext}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj&ubah}(h]h ]h"]h$]h&]uh1jLh]/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:8: ./arch/x86/include/asm/uaccess.hhKZhjubjM)}(hEUser context only. This function may sleep if pagefaults are enabled.h]hEUser context only. This function may sleep if pagefaults are enabled.}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jLh]/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:8: ./arch/x86/include/asm/uaccess.hhKZhjubjM)}(h**Description**h]j)}(hjOh]h Description}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjMubah}(h]h ]h"]h$]h&]uh1jLh]/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:8: ./arch/x86/include/asm/uaccess.hhK]hjubjM)}(hThis macro copies a single simple variable from user space to kernel space. It supports simple types like char and int, but not larger data types like structures or arrays.h]hThis macro copies a single simple variable from user space to kernel space. It supports simple types like char and int, but not larger data types like structures or arrays.}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1jLh]/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:8: ./arch/x86/include/asm/uaccess.hhK\hjubjM)}(h**ptr** must have pointer-to-simple-variable type, and the result of dereferencing **ptr** must be assignable to **x** without a cast.h](j)}(h**ptr**h]hptr}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjtubhL must have pointer-to-simple-variable type, and the result of dereferencing }(hjthhhNhNubj)}(h**ptr**h]hptr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjtubh must be assignable to }(hjthhhNhNubj)}(h**x**h]hx}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjtubh without a cast.}(hjthhhNhNubeh}(h]h ]h"]h$]h&]uh1jLh]/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:8: ./arch/x86/include/asm/uaccess.hhK`hjubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLh]/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:8: ./arch/x86/include/asm/uaccess.hhKchjubjM)}(hRzero on success, or -EFAULT on error. On error, the variable **x** is set to zero.h](h=zero on success, or -EFAULT on error. On error, the variable }(hjhhhNhNubj)}(h**x**h]hx}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh is set to zero.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLh]/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:8: ./arch/x86/include/asm/uaccess.hhKdhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hput_user (C macro) c.put_userhNtauh1hhhhhhNhNubh)}(hhh](h)}(hput_userh]h)}(hput_userh]h)}(hput_userh]j)}(hjh]hput_user}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhj hhh]/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:8: ./arch/x86/include/asm/uaccess.hhKubah}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhj%hKubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj%hKhjhhubj4)}(hhh]h}(h]h ]h"]h$]h&]uh1j3hjhhhj%hKubeh}(h]h ](jAmacroeh"]h$]h&]jFjAjGj>jHj>jIjJjKuh1hhhhhhNhNubjM)}(h``put_user (x, ptr)``h]jS)}(hjDh]hput_user (x, ptr)}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjBubah}(h]h ]h"]h$]h&]uh1jLh]/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:8: ./arch/x86/include/asm/uaccess.hhKhhhhubji)}(h&Write a simple value into user space. h]jM)}(h%Write a simple value into user space.h]h%Write a simple value into user space.}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1jLh]/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:8: ./arch/x86/include/asm/uaccess.hhKhjZubah}(h]h ]h"]h$]h&]uh1jhhjlhKhhhhubj)}(hX **Parameters** ``x`` Value to copy to user space. ``ptr`` Destination address, in user space. **Context** User context only. This function may sleep if pagefaults are enabled. **Description** This macro copies a single simple value from kernel space to user space. It supports simple types like char and int, but not larger data types like structures or arrays. **ptr** must have pointer-to-simple-variable type, and **x** must be assignable to the result of dereferencing **ptr**. **Return** zero on success, or -EFAULT on error.h](jM)}(h**Parameters**h]j)}(hjyh]h Parameters}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjwubah}(h]h ]h"]h$]h&]uh1jLh]/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:8: ./arch/x86/include/asm/uaccess.hhKhjsubj)}(hhh](j)}(h#``x`` Value to copy to user space. h](j)}(h``x``h]jS)}(hjh]hx}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:8: ./arch/x86/include/asm/uaccess.hhKhjubj)}(hhh]jM)}(hValue to copy to user space.h]hValue to copy to user space.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubj)}(h,``ptr`` Destination address, in user space. h](j)}(h``ptr``h]jS)}(hjh]hptr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:8: ./arch/x86/include/asm/uaccess.hhKhjubj)}(hhh]jM)}(h#Destination address, in user space.h]h#Destination address, in user space.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubeh}(h]h ]h"]h$]h&]uh1jhjsubjM)}(h **Context**h]j)}(hj h]hContext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jLh]/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:8: ./arch/x86/include/asm/uaccess.hhKhjsubjM)}(hEUser context only. This function may sleep if pagefaults are enabled.h]hEUser context only. This function may sleep if pagefaults are enabled.}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jLh]/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:8: ./arch/x86/include/asm/uaccess.hhKhjsubjM)}(h**Description**h]j)}(hj3h]h Description}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj1ubah}(h]h ]h"]h$]h&]uh1jLh]/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:8: ./arch/x86/include/asm/uaccess.hhKhjsubjM)}(hThis macro copies a single simple value from kernel space to user space. It supports simple types like char and int, but not larger data types like structures or arrays.h]hThis macro copies a single simple value from kernel space to user space. It supports simple types like char and int, but not larger data types like structures or arrays.}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1jLh]/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:8: ./arch/x86/include/asm/uaccess.hhKhjsubjM)}(hw**ptr** must have pointer-to-simple-variable type, and **x** must be assignable to the result of dereferencing **ptr**.h](j)}(h**ptr**h]hptr}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjXubh0 must have pointer-to-simple-variable type, and }(hjXhhhNhNubj)}(h**x**h]hx}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjXubh3 must be assignable to the result of dereferencing }(hjXhhhNhNubj)}(h**ptr**h]hptr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjXubh.}(hjXhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLh]/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:8: ./arch/x86/include/asm/uaccess.hhKhjsubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLh]/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:8: ./arch/x86/include/asm/uaccess.hhKhjsubjM)}(h%zero on success, or -EFAULT on error.h]h%zero on success, or -EFAULT on error.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLh]/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:8: ./arch/x86/include/asm/uaccess.hhKhjsubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h$__copy_to_user_inatomic (C function)c.__copy_to_user_inatomichNtauh1hhhhhhNhNubh)}(hhh](h)}(hZunsigned long __copy_to_user_inatomic (void __user *to, const void *from, unsigned long n)h]h)}(hYunsigned long __copy_to_user_inatomic(void __user *to, const void *from, unsigned long n)h](hdesc_sig_keyword_type)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]ktah"]h$]h&]uh1jhjhhhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhK~ubhdesc_sig_space)}(h h]h }(hjhhhNhNubah}(h]h ]wah"]h$]h&]uh1jhjhhhjhK~ubj)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhK~ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhK~ubh)}(h__copy_to_user_inatomich]j)}(h__copy_to_user_inatomich]h__copy_to_user_inatomic}(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhK~ubhdesc_parameterlist)}(h4(void __user *to, const void *from, unsigned long n)h](hdesc_parameter)}(hvoid __user *toh](j)}(hvoidh]hvoid}(hjChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?ubj)}(h h]h }(hjQhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?ubh__user}(hj?hhhNhNubj)}(h h]h }(hjchhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?ubhdesc_sig_punctuation)}(h*h]h*}(hjshhhNhNubah}(h]h ]pah"]h$]h&]uh1jqhj?ubj)}(htoh]hto}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj9ubj>)}(hconst void *fromh](hdesc_sig_keyword)}(hconsth]hconst}(hjhhhNhNubah}(h]h ]kah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hfromh]hfrom}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj9ubj>)}(hunsigned long nh](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]hn}(hj4hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj9ubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhK~ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhK~ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhK~hjhhubj4)}(hhh]h bullet_list)}(hhh]h list_item)}(h9Copy a block of data into user space, with less checking.h]jM)}(hjfh]h9Copy a block of data into user space, with less checking.}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhK~hjdubah}(h]h ]h"]h$]h&]uh1jbhj_hhhjuhNubah}(h]h ]h"]h$]h&]bullet-uh1j]hjuhK~hjZhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhK~ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhhhNhNubj)}(hX**Parameters** ``void __user *to`` Destination address, in user space. ``const void *from`` Source address, in kernel space. ``unsigned long n`` Number of bytes to copy. **Context** User context only. **Description** Copy data from kernel space to user space. Caller must check the specified block with access_ok() before calling this function. The caller should also make sure he pins the user space address so that we don't result in page fault and sleep.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhKhjubj)}(hhh](j)}(h8``void __user *to`` Destination address, in user space. h](j)}(h``void __user *to``h]jS)}(hjh]hvoid __user *to}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhKhjubj)}(hhh]jM)}(h#Destination address, in user space.h]h#Destination address, in user space.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubj)}(h6``const void *from`` Source address, in kernel space. h](j)}(h``const void *from``h]jS)}(hjh]hconst void *from}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhKhjubj)}(hhh]jM)}(h Source address, in kernel space.h]h Source address, in kernel space.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubj)}(h-``unsigned long n`` Number of bytes to copy. h](j)}(h``unsigned long n``h]jS)}(hj(h]hunsigned long n}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj&ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhKhj"ubj)}(hhh]jM)}(hNumber of bytes to copy.h]hNumber of bytes to copy.}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj=hKhj>ubah}(h]h ]h"]h$]h&]uh1jhj"ubeh}(h]h ]h"]h$]h&]uh1jhj=hKhjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h **Context**h]j)}(hjch]hContext}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1jhjaubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhKhjubjM)}(hUser context only.h]hUser context only.}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhKhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhKhjubjM)}(hCopy data from kernel space to user space. Caller must check the specified block with access_ok() before calling this function. The caller should also make sure he pins the user space address so that we don't result in page fault and sleep.h]hCopy data from kernel space to user space. Caller must check the specified block with access_ok() before calling this function. The caller should also make sure he pins the user space address so that we don’t result in page fault and sleep.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhKhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h$probe_subpage_writeable (C function)c.probe_subpage_writeablehNtauh1hhhhhhNhNubh)}(hhh](h)}(h@size_t probe_subpage_writeable (char __user *uaddr, size_t size)h]h)}(h?size_t probe_subpage_writeable(char __user *uaddr, size_t size)h](h)}(hhh]j)}(hsize_th]hsize_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftype identifier reftargetjmodnameN classnameN c:parent_keysphinx.domains.c LookupKey)}data]j ASTIdentifier)}jprobe_subpage_writeablesbc.probe_subpage_writeableasbuh1hhjhhhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhM4ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM4ubh)}(hprobe_subpage_writeableh]j)}(hjh]hprobe_subpage_writeable}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhM4ubj8)}(h!(char __user *uaddr, size_t size)h](j>)}(hchar __user *uaddrh](j)}(hcharh]hchar}(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%ubj)}(h h]h }(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%ubh__user}(hj%hhhNhNubj)}(h h]h }(hjIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%ubjr)}(hjuh]h*}(hjWhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj%ubj)}(huaddrh]huaddr}(hjdhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj!ubj>)}(h size_t sizeh](h)}(hhh]j)}(hsize_th]hsize_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj}ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.probe_subpage_writeableasbuh1hhjyubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyubj)}(hsizeh]hsize}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj!ubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhM4ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhM4ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhM4hjhhubj4)}(hhh]jM)}(hNprobe the user range for write faults at sub-page granularity (e.g. arm64 MTE)h]hNprobe the user range for write faults at sub-page granularity (e.g. arm64 MTE)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhM4hjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhM4ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhhhNhNubj)}(hX**Parameters** ``char __user *uaddr`` start of address range ``size_t size`` size of address range **Description** Returns 0 on success, the number of bytes not probed on fault. It is expected that the caller checked for the write permission of each page in the range either by put_user() or GUP. The architecture port can implement a more efficient get_user() probing if the same sub-page faults are triggered by either a read or a write.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhM8hjubj)}(hhh](j)}(h.``char __user *uaddr`` start of address range h](j)}(h``char __user *uaddr``h]jS)}(hj h]hchar __user *uaddr}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhM6hj ubj)}(hhh]jM)}(hstart of address rangeh]hstart of address range}(hj0 hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj, hM6hj- ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj, hM6hj ubj)}(h&``size_t size`` size of address range h](j)}(h``size_t size``h]jS)}(hjP h]h size_t size}(hjR hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjN ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhM7hjJ ubj)}(hhh]jM)}(hsize of address rangeh]hsize of address range}(hji hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhje hM7hjf ubah}(h]h ]h"]h$]h&]uh1jhjJ ubeh}(h]h ]h"]h$]h&]uh1jhje hM7hj ubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hj h]h Description}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhM9hjubjM)}(h>Returns 0 on success, the number of bytes not probed on fault.h]h>Returns 0 on success, the number of bytes not probed on fault.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhM8hjubjM)}(hXIt is expected that the caller checked for the write permission of each page in the range either by put_user() or GUP. The architecture port can implement a more efficient get_user() probing if the same sub-page faults are triggered by either a read or a write.h]hXIt is expected that the caller checked for the write permission of each page in the range either by put_user() or GUP. The architecture port can implement a more efficient get_user() probing if the same sub-page faults are triggered by either a read or a write.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhM:hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h"copy_struct_from_user (C function)c.copy_struct_from_userhNtauh1hhhhhhNhNubh)}(hhh](h)}(hYint copy_struct_from_user (void *dst, size_t ksize, const void __user *src, size_t usize)h]h)}(hXint copy_struct_from_user(void *dst, size_t ksize, const void __user *src, size_t usize)h](j)}(hinth]hint}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMZubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhj hMZubh)}(hcopy_struct_from_userh]j)}(hcopy_struct_from_userh]hcopy_struct_from_user}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj hhhj hMZubj8)}(h?(void *dst, size_t ksize, const void __user *src, size_t usize)h](j>)}(h void *dsth](j)}(hvoidh]hvoid}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h h]h }(hj* hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubjr)}(hjuh]h*}(hj8 hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj ubj)}(hdsth]hdst}(hjE hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj ubj>)}(h size_t ksizeh](h)}(hhh]j)}(hsize_th]hsize_t}(hja hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^ ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjc modnameN classnameNjj)}j]j)}jj sbc.copy_struct_from_userasbuh1hhjZ ubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZ ubj)}(hksizeh]hksize}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZ ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj ubj>)}(hconst void __user *srch](j)}(hjh]hconst}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(hvoidh]hvoid}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubh__user}(hj hhhNhNubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubjr)}(hjuh]h*}(hj hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj ubj)}(hsrch]hsrc}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj ubj>)}(h size_t usizeh](h)}(hhh]j)}(hsize_th]hsize_t}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj modnameN classnameNjj)}j]j} c.copy_struct_from_userasbuh1hhj ubj)}(h h]h }(hj8 hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(husizeh]husize}(hjF hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj ubeh}(h]h ]h"]h$]h&]jjuh1j7hj hhhj hMZubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj hhhj hMZubah}(h]j ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj hMZhj hhubj4)}(hhh]jM)}(hcopy a struct from userspaceh]hcopy a struct from userspace}(hjp hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMZhjm hhubah}(h]h ]h"]h$]h&]uh1j3hj hhhj hMZubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj jHj jIjJjKuh1hhhhhhNhNubj)}(hX**Parameters** ``void *dst`` Destination address, in kernel space. This buffer must be **ksize** bytes long. ``size_t ksize`` Size of **dst** struct. ``const void __user *src`` Source address, in userspace. ``size_t usize`` (Alleged) size of **src** struct. **Description** Copies a struct from userspace to kernel space, in a way that guarantees backwards-compatibility for struct syscall arguments (as long as future struct extensions are made such that all new fields are *appended* to the old struct, and zeroed-out new fields have the same meaning as the old struct). **ksize** is just sizeof(*dst), and **usize** should've been passed by userspace. The recommended usage is something like the following:: SYSCALL_DEFINE2(foobar, const struct foo __user *, uarg, size_t, usize) { int err; struct foo karg = {}; if (usize > PAGE_SIZE) return -E2BIG; if (usize < FOO_SIZE_VER0) return -EINVAL; err = copy_struct_from_user(&karg, sizeof(karg), uarg, usize); if (err) return err; // ... } There are three cases to consider: * If **usize** == **ksize**, then it's copied verbatim. * If **usize** < **ksize**, then the userspace has passed an old struct to a newer kernel. The rest of the trailing bytes in **dst** (**ksize** - **usize**) are to be zero-filled. * If **usize** > **ksize**, then the userspace has passed a new struct to an older kernel. The trailing bytes unknown to the kernel (**usize** - **ksize**) are checked to ensure they are zeroed, otherwise -E2BIG is returned. Returns (in all cases, some data may have been copied): * -E2BIG: (**usize** > **ksize**) and there are non-zero trailing bytes in **src**. * -EFAULT: access to userspace failed.h](jM)}(h**Parameters**h]j)}(hj h]h Parameters}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhM^hj ubj)}(hhh](j)}(h^``void *dst`` Destination address, in kernel space. This buffer must be **ksize** bytes long. h](j)}(h ``void *dst``h]jS)}(hj h]h void *dst}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhM\hj ubj)}(hhh]jM)}(hODestination address, in kernel space. This buffer must be **ksize** bytes long.h](h:Destination address, in kernel space. This buffer must be }(hj hhhNhNubj)}(h **ksize**h]hksize}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubh bytes long.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhM[hj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hM\hj ubj)}(h)``size_t ksize`` Size of **dst** struct. h](j)}(h``size_t ksize``h]jS)}(hj h]h size_t ksize}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhM]hj ubj)}(hhh]jM)}(hSize of **dst** struct.h](hSize of }(hj hhhNhNubj)}(h**dst**h]hdst}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubh struct.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhj hM]hj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hM]hj ubj)}(h9``const void __user *src`` Source address, in userspace. h](j)}(h``const void __user *src``h]jS)}(hjH h]hconst void __user *src}(hjJ hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjF ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhM^hjB ubj)}(hhh]jM)}(hSource address, in userspace.h]hSource address, in userspace.}(hja hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj] hM^hj^ ubah}(h]h ]h"]h$]h&]uh1jhjB ubeh}(h]h ]h"]h$]h&]uh1jhj] hM^hj ubj)}(h3``size_t usize`` (Alleged) size of **src** struct. h](j)}(h``size_t usize``h]jS)}(hj h]h size_t usize}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhM_hj{ ubj)}(hhh]jM)}(h!(Alleged) size of **src** struct.h](h(Alleged) size of }(hj hhhNhNubj)}(h**src**h]hsrc}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubh struct.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhj 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 ubjM)}(h**Description**h]j)}(hj h]h Description}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMahj ubjM)}(hX*Copies a struct from userspace to kernel space, in a way that guarantees backwards-compatibility for struct syscall arguments (as long as future struct extensions are made such that all new fields are *appended* to the old struct, and zeroed-out new fields have the same meaning as the old struct).h](hCopies a struct from userspace to kernel space, in a way that guarantees backwards-compatibility for struct syscall arguments (as long as future struct extensions are made such that all new fields are }(hj hhhNhNubhemphasis)}(h *appended*h]happended}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j hj ubhW to the old struct, and zeroed-out new fields have the same meaning as the old struct).}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhM`hj ubjM)}(h**ksize** is just sizeof(*dst), and **usize** should've been passed by userspace. The recommended usage is something like the following::h](j)}(h **ksize**h]hksize}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubh is just sizeof(}(hj hhhNhNubj )}(h*dst), and **usize**h]hdst), and **usize*}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j hj ubh] should’ve been passed by userspace. The recommended usage is something like the following:}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMfhj ubh literal_block)}(hX=SYSCALL_DEFINE2(foobar, const struct foo __user *, uarg, size_t, usize) { int err; struct foo karg = {}; if (usize > PAGE_SIZE) return -E2BIG; if (usize < FOO_SIZE_VER0) return -EINVAL; err = copy_struct_from_user(&karg, sizeof(karg), uarg, usize); if (err) return err; // ... }h]hX=SYSCALL_DEFINE2(foobar, const struct foo __user *, uarg, size_t, usize) { int err; struct foo karg = {}; if (usize > PAGE_SIZE) return -E2BIG; if (usize < FOO_SIZE_VER0) return -EINVAL; err = copy_struct_from_user(&karg, sizeof(karg), uarg, usize); if (err) return err; // ... }}hj8 sbah}(h]h ]h"]h$]h&]jjuh1j6 hW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMihj ubj)}(hhh](j)}(hXThere are three cases to consider: * If **usize** == **ksize**, then it's copied verbatim. * If **usize** < **ksize**, then the userspace has passed an old struct to a newer kernel. The rest of the trailing bytes in **dst** (**ksize** - **usize**) are to be zero-filled. * If **usize** > **ksize**, then the userspace has passed a new struct to an older kernel. The trailing bytes unknown to the kernel (**usize** - **ksize**) are checked to ensure they are zeroed, otherwise -E2BIG is returned. h](j)}(h"There are three cases to consider:h]h"There are three cases to consider:}(hjN hhhNhNubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMhjJ ubj)}(hhh]j^)}(hhh](jc)}(h5If **usize** == **ksize**, then it's copied verbatim.h]jM)}(hje h](hIf }(hjg hhhNhNubj)}(h **usize**h]husize}(hjn hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjg ubh == }(hjg hhhNhNubj)}(h **ksize**h]hksize}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjg ubh, then it’s copied verbatim.}(hjg hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhM{hjc ubah}(h]h ]h"]h$]h&]uh1jbhj` ubjc)}(hIf **usize** < **ksize**, then the userspace has passed an old struct to a newer kernel. The rest of the trailing bytes in **dst** (**ksize** - **usize**) are to be zero-filled.h]jM)}(hIf **usize** < **ksize**, then the userspace has passed an old struct to a newer kernel. The rest of the trailing bytes in **dst** (**ksize** - **usize**) are to be zero-filled.h](hIf }(hj hhhNhNubj)}(h **usize**h]husize}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubh < }(hj hhhNhNubj)}(h **ksize**h]hksize}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubhc, then the userspace has passed an old struct to a newer kernel. The rest of the trailing bytes in }(hj hhhNhNubj)}(h**dst**h]hdst}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubh (}(hj hhhNhNubj)}(h **ksize**h]hksize}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubh - }(hj hhhNhNubj)}(h **usize**h]husize}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubh) are to be zero-filled.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhM|hj ubah}(h]h ]h"]h$]h&]uh1jbhj` ubjc)}(hIf **usize** > **ksize**, then the userspace has passed a new struct to an older kernel. The trailing bytes unknown to the kernel (**usize** - **ksize**) are checked to ensure they are zeroed, otherwise -E2BIG is returned. h]jM)}(hIf **usize** > **ksize**, then the userspace has passed a new struct to an older kernel. The trailing bytes unknown to the kernel (**usize** - **ksize**) are checked to ensure they are zeroed, otherwise -E2BIG is returned.h](hIf }(hjhhhNhNubj)}(h **usize**h]husize}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh > }(hjhhhNhNubj)}(h **ksize**h]hksize}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhk, then the userspace has passed a new struct to an older kernel. The trailing bytes unknown to the kernel (}(hjhhhNhNubj)}(h **usize**h]husize}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh - }(hjhhhNhNubj)}(h **ksize**h]hksize}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhF) are checked to ensure they are zeroed, otherwise -E2BIG is returned.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMhjubah}(h]h ]h"]h$]h&]uh1jbhj` ubeh}(h]h ]h"]h$]h&]jjuuh1j]hj hM{hj] ubah}(h]h ]h"]h$]h&]uh1jhjJ ubeh}(h]h ]h"]h$]h&]uh1jhj\ hMhjG ubj)}(hReturns (in all cases, some data may have been copied): * -E2BIG: (**usize** > **ksize**) and there are non-zero trailing bytes in **src**. * -EFAULT: access to userspace failed.h](j)}(h7Returns (in all cases, some data may have been copied):h]h7Returns (in all cases, some data may have been copied):}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMhjubj)}(hhh]j^)}(hhh](jc)}(hR-E2BIG: (**usize** > **ksize**) and there are non-zero trailing bytes in **src**.h]jM)}(hjh](h -E2BIG: (}(hjhhhNhNubj)}(h **usize**h]husize}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh > }(hjhhhNhNubj)}(h **ksize**h]hksize}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh+) and there are non-zero trailing bytes in }(hjhhhNhNubj)}(h**src**h]hsrc}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jbhjubjc)}(h$-EFAULT: access to userspace failed.h]jM)}(hjh]h$-EFAULT: access to userspace failed.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMhjubah}(h]h ]h"]h$]h&]uh1jbhjubeh}(h]h ]h"]h$]h&]jjuuh1j]hjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjG ubeh}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h copy_struct_to_user (C function)c.copy_struct_to_userhNtauh1hhhhhhNhNubh)}(hhh](h)}(hoint copy_struct_to_user (void __user *dst, size_t usize, const void *src, size_t ksize, bool *ignored_trailing)h]h)}(hnint copy_struct_to_user(void __user *dst, size_t usize, const void *src, size_t ksize, bool *ignored_trailing)h](j)}(hinth]hint}(hj;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7hhhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMubj)}(h h]h }(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7hhhjIhMubh)}(hcopy_struct_to_userh]j)}(hcopy_struct_to_userh]hcopy_struct_to_user}(hj\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjXubah}(h]h ](jjeh"]h$]h&]jjuh1hhj7hhhjIhMubj8)}(hW(void __user *dst, size_t usize, const void *src, size_t ksize, bool *ignored_trailing)h](j>)}(hvoid __user *dsth](j)}(hvoidh]hvoid}(hjxhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjtubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjtubh__user}(hjthhhNhNubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjtubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjtubj)}(hdsth]hdst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjtubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjpubj>)}(h size_t usizeh](h)}(hhh]j)}(hsize_th]hsize_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jj^sbc.copy_struct_to_userasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(husizeh]husize}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjpubj>)}(hconst void *srch](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hvoidh]hvoid}(hj1hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjMhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hsrch]hsrc}(hjZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjpubj>)}(h size_t ksizeh](h)}(hhh]j)}(hsize_th]hsize_t}(hjvhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjsubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjxmodnameN classnameNjj)}j]jc.copy_struct_to_userasbuh1hhjoubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjoubj)}(hksizeh]hksize}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjoubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjpubj>)}(hbool *ignored_trailingh](j)}(hboolh]hbool}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hignored_trailingh]hignored_trailing}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjpubeh}(h]h ]h"]h$]h&]jjuh1j7hj7hhhjIhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj3hhhjIhMubah}(h]j.ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjIhMhj0hhubj4)}(hhh]jM)}(hcopy a struct to userspaceh]hcopy a struct to userspace}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMhj hhubah}(h]h ]h"]h$]h&]uh1j3hj0hhhjIhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj&jHj&jIjJjKuh1hhhhhhNhNubj)}(hXM **Parameters** ``void __user *dst`` Destination address, in userspace. This buffer must be **ksize** bytes long. ``size_t usize`` (Alleged) size of **dst** struct. ``const void *src`` Source address, in kernel space. ``size_t ksize`` Size of **src** struct. ``bool *ignored_trailing`` Set to ``true`` if there was a non-zero byte in **src** that userspace cannot see because they are using an smaller struct. **Description** Copies a struct from kernel space to userspace, in a way that guarantees backwards-compatibility for struct syscall arguments (as long as future struct extensions are made such that all new fields are *appended* to the old struct, and zeroed-out new fields have the same meaning as the old struct). Some syscalls may wish to make sure that userspace knows about everything in the struct, and if there is a non-zero value that userspce doesn't know about, they want to return an error (such as -EMSGSIZE) or have some other fallback (such as adding a "you're missing some information" flag). If **ignored_trailing** is non-``NULL``, it will be set to ``true`` if there was a non-zero byte that could not be copied to userspace (ie. was past **usize**). While unconditionally returning an error in this case is the simplest solution, for maximum backward compatibility you should try to only return -EMSGSIZE if the user explicitly requested the data that couldn't be copied. Note that structure sizes can change due to header changes and simple recompilations without code changes(!), so if you care about **ignored_trailing** you probably want to make sure that any new field data is associated with a flag. Otherwise you might assume that a program knows about data it does not. **ksize** is just sizeof(*src), and **usize** should've been passed by userspace. The recommended usage is something like the following:: SYSCALL_DEFINE2(foobar, struct foo __user *, uarg, size_t, usize) { int err; bool ignored_trailing; struct foo karg = {}; if (usize > PAGE_SIZE) return -E2BIG; if (usize < FOO_SIZE_VER0) return -EINVAL; // ... modify karg somehow ... err = copy_struct_to_user(uarg, usize, &karg, sizeof(karg), &ignored_trailing); if (err) return err; if (ignored_trailing) return -EMSGSIZE: // ... } There are three cases to consider: * If **usize** == **ksize**, then it's copied verbatim. * If **usize** < **ksize**, then the kernel is trying to pass userspace a newer struct than it supports. Thus we only copy the interoperable portions (**usize**) and ignore the rest (but **ignored_trailing** is set to ``true`` if any of the trailing (**ksize** - **usize**) bytes are non-zero). * If **usize** > **ksize**, then the kernel is trying to pass userspace an older struct than userspace supports. In order to make sure the unknown-to-the-kernel fields don't contain garbage values, we zero the trailing (**usize** - **ksize**) bytes. Returns (in all cases, some data may have been copied): * -EFAULT: access to userspace failed.h](jM)}(h**Parameters**h]j)}(hj0h]h Parameters}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj.ubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMhj*ubj)}(hhh](j)}(hb``void __user *dst`` Destination address, in userspace. This buffer must be **ksize** bytes long. h](j)}(h``void __user *dst``h]jS)}(hjOh]hvoid __user *dst}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjMubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMhjIubj)}(hhh]jM)}(hLDestination address, in userspace. This buffer must be **ksize** bytes long.h](h7Destination address, in userspace. This buffer must be }(hjhhhhNhNubj)}(h **ksize**h]hksize}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1jhjhubh bytes long.}(hjhhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMhjeubah}(h]h ]h"]h$]h&]uh1jhjIubeh}(h]h ]h"]h$]h&]uh1jhjdhMhjFubj)}(h3``size_t usize`` (Alleged) size of **dst** struct. h](j)}(h``size_t usize``h]jS)}(hjh]h size_t usize}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMhjubj)}(hhh]jM)}(h!(Alleged) size of **dst** struct.h](h(Alleged) size of }(hjhhhNhNubj)}(h**dst**h]hdst}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh struct.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjFubj)}(h5``const void *src`` Source address, in kernel space. h](j)}(h``const void *src``h]jS)}(hjh]hconst void *src}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMhjubj)}(hhh]jM)}(h Source address, in kernel space.h]h Source address, in kernel space.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjFubj)}(h)``size_t ksize`` Size of **src** struct. h](j)}(h``size_t ksize``h]jS)}(hjh]h size_t ksize}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMhjubj)}(hhh]jM)}(hSize of **src** struct.h](hSize of }(hj8hhhNhNubj)}(h**src**h]hsrc}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj8ubh struct.}(hj8hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhj4hMhj5ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj4hMhjFubj)}(h``bool *ignored_trailing`` Set to ``true`` if there was a non-zero byte in **src** that userspace cannot see because they are using an smaller struct. h](j)}(h``bool *ignored_trailing``h]jS)}(hjjh]hbool *ignored_trailing}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjhubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMhjdubj)}(hhh]jM)}(h{Set to ``true`` if there was a non-zero byte in **src** that userspace cannot see because they are using an smaller struct.h](hSet to }(hjhhhNhNubjS)}(h``true``h]htrue}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubh! if there was a non-zero byte in }(hjhhhNhNubj)}(h**src**h]hsrc}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhD that userspace cannot see because they are using an smaller struct.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMhjubah}(h]h ]h"]h$]h&]uh1jhjdubeh}(h]h ]h"]h$]h&]uh1jhjhMhjFubeh}(h]h ]h"]h$]h&]uh1jhj*ubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMhj*ubjM)}(hX*Copies a struct from kernel space to userspace, in a way that guarantees backwards-compatibility for struct syscall arguments (as long as future struct extensions are made such that all new fields are *appended* to the old struct, and zeroed-out new fields have the same meaning as the old struct).h](hCopies a struct from kernel space to userspace, in a way that guarantees backwards-compatibility for struct syscall arguments (as long as future struct extensions are made such that all new fields are }(hjhhhNhNubj )}(h *appended*h]happended}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j hjubhW to the old struct, and zeroed-out new fields have the same meaning as the old struct).}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMhj*ubjM)}(hXSome syscalls may wish to make sure that userspace knows about everything in the struct, and if there is a non-zero value that userspce doesn't know about, they want to return an error (such as -EMSGSIZE) or have some other fallback (such as adding a "you're missing some information" flag). If **ignored_trailing** is non-``NULL``, it will be set to ``true`` if there was a non-zero byte that could not be copied to userspace (ie. was past **usize**).h](hX/Some syscalls may wish to make sure that userspace knows about everything in the struct, and if there is a non-zero value that userspce doesn’t know about, they want to return an error (such as -EMSGSIZE) or have some other fallback (such as adding a “you’re missing some information” flag). If }(hjhhhNhNubj)}(h**ignored_trailing**h]hignored_trailing}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh is non-}(hjhhhNhNubjS)}(h``NULL``h]hNULL}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubh, it will be set to }(hjhhhNhNubjS)}(h``true``h]htrue}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubhR if there was a non-zero byte that could not be copied to userspace (ie. was past }(hjhhhNhNubj)}(h **usize**h]husize}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh).}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMhj*ubjM)}(hXWhile unconditionally returning an error in this case is the simplest solution, for maximum backward compatibility you should try to only return -EMSGSIZE if the user explicitly requested the data that couldn't be copied. Note that structure sizes can change due to header changes and simple recompilations without code changes(!), so if you care about **ignored_trailing** you probably want to make sure that any new field data is associated with a flag. Otherwise you might assume that a program knows about data it does not.h](hXcWhile unconditionally returning an error in this case is the simplest solution, for maximum backward compatibility you should try to only return -EMSGSIZE if the user explicitly requested the data that couldn’t be copied. Note that structure sizes can change due to header changes and simple recompilations without code changes(!), so if you care about }(hjXhhhNhNubj)}(h**ignored_trailing**h]hignored_trailing}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjXubh you probably want to make sure that any new field data is associated with a flag. Otherwise you might assume that a program knows about data it does not.}(hjXhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMhj*ubjM)}(h**ksize** is just sizeof(*src), and **usize** should've been passed by userspace. The recommended usage is something like the following::h](j)}(h **ksize**h]hksize}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjyubh is just sizeof(}(hjyhhhNhNubj )}(h*src), and **usize**h]hsrc), and **usize*}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j hjyubh] should’ve been passed by userspace. The recommended usage is something like the following:}(hjyhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMhj*ubj7 )}(hXSYSCALL_DEFINE2(foobar, struct foo __user *, uarg, size_t, usize) { int err; bool ignored_trailing; struct foo karg = {}; if (usize > PAGE_SIZE) return -E2BIG; if (usize < FOO_SIZE_VER0) return -EINVAL; // ... modify karg somehow ... err = copy_struct_to_user(uarg, usize, &karg, sizeof(karg), &ignored_trailing); if (err) return err; if (ignored_trailing) return -EMSGSIZE: // ... }h]hXSYSCALL_DEFINE2(foobar, struct foo __user *, uarg, size_t, usize) { int err; bool ignored_trailing; struct foo karg = {}; if (usize > PAGE_SIZE) return -E2BIG; if (usize < FOO_SIZE_VER0) return -EINVAL; // ... modify karg somehow ... err = copy_struct_to_user(uarg, usize, &karg, sizeof(karg), &ignored_trailing); if (err) return err; if (ignored_trailing) return -EMSGSIZE: // ... }}hjsbah}(h]h ]h"]h$]h&]jjuh1j6 hW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMhj*ubj)}(hhh](j)}(hXThere are three cases to consider: * If **usize** == **ksize**, then it's copied verbatim. * If **usize** < **ksize**, then the kernel is trying to pass userspace a newer struct than it supports. Thus we only copy the interoperable portions (**usize**) and ignore the rest (but **ignored_trailing** is set to ``true`` if any of the trailing (**ksize** - **usize**) bytes are non-zero). * If **usize** > **ksize**, then the kernel is trying to pass userspace an older struct than userspace supports. In order to make sure the unknown-to-the-kernel fields don't contain garbage values, we zero the trailing (**usize** - **ksize**) bytes. h](j)}(h"There are three cases to consider:h]h"There are three cases to consider:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMhjubj)}(hhh]j^)}(hhh](jc)}(h5If **usize** == **ksize**, then it's copied verbatim.h]jM)}(hjh](hIf }(hjhhhNhNubj)}(h **usize**h]husize}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh == }(hjhhhNhNubj)}(h **ksize**h]hksize}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh, then it’s copied verbatim.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMhjubah}(h]h ]h"]h$]h&]uh1jbhjubjc)}(hX$If **usize** < **ksize**, then the kernel is trying to pass userspace a newer struct than it supports. Thus we only copy the interoperable portions (**usize**) and ignore the rest (but **ignored_trailing** is set to ``true`` if any of the trailing (**ksize** - **usize**) bytes are non-zero).h]jM)}(hX$If **usize** < **ksize**, then the kernel is trying to pass userspace a newer struct than it supports. Thus we only copy the interoperable portions (**usize**) and ignore the rest (but **ignored_trailing** is set to ``true`` if any of the trailing (**ksize** - **usize**) bytes are non-zero).h](hIf }(hjhhhNhNubj)}(h **usize**h]husize}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh < }(hjhhhNhNubj)}(h **ksize**h]hksize}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh}, then the kernel is trying to pass userspace a newer struct than it supports. Thus we only copy the interoperable portions (}(hjhhhNhNubj)}(h **usize**h]husize}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh) and ignore the rest (but }(hjhhhNhNubj)}(h**ignored_trailing**h]hignored_trailing}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh is set to }(hjhhhNhNubjS)}(h``true``h]htrue}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubh if any of the trailing (}(hjhhhNhNubj)}(h **ksize**h]hksize}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh - }(hjhhhNhNubj)}(h **usize**h]husize}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh) bytes are non-zero).}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMhjubah}(h]h ]h"]h$]h&]uh1jbhjubjc)}(hIf **usize** > **ksize**, then the kernel is trying to pass userspace an older struct than userspace supports. In order to make sure the unknown-to-the-kernel fields don't contain garbage values, we zero the trailing (**usize** - **ksize**) bytes. h]jM)}(hIf **usize** > **ksize**, then the kernel is trying to pass userspace an older struct than userspace supports. In order to make sure the unknown-to-the-kernel fields don't contain garbage values, we zero the trailing (**usize** - **ksize**) bytes.h](hIf }(hjhhhNhNubj)}(h **usize**h]husize}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh > }(hjhhhNhNubj)}(h **ksize**h]hksize}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh, then the kernel is trying to pass userspace an older struct than userspace supports. In order to make sure the unknown-to-the-kernel fields don’t contain garbage values, we zero the trailing (}(hjhhhNhNubj)}(h **usize**h]husize}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh - }(hjhhhNhNubj)}(h **ksize**h]hksize}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh) bytes.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMhjubah}(h]h ]h"]h$]h&]uh1jbhjubeh}(h]h ]h"]h$]h&]jjuuh1j]hjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h^Returns (in all cases, some data may have been copied): * -EFAULT: access to userspace failed.h](j)}(h7Returns (in all cases, some data may have been copied):h]h7Returns (in all cases, some data may have been copied):}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMhjubj)}(hhh]j^)}(hhh]jc)}(h$-EFAULT: access to userspace failed.h]jM)}(hj4h]h$-EFAULT: access to userspace failed.}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMhj2ubah}(h]h ]h"]h$]h&]uh1jbhj/ubah}(h]h ]h"]h$]h&]jjuuh1j]hjChMhj,ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj+hMhjubeh}(h]h ]h"]h$]h&]uh1jhj*ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hget_kernel_nofault (C macro)c.get_kernel_nofaulthNtauh1hhhhhhNhNubh)}(hhh](h)}(hget_kernel_nofaulth]h)}(hget_kernel_nofaulth]h)}(hget_kernel_nofaulth]j)}(hj|h]hget_kernel_nofault}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhj~hhhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMubah}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjzhhhjhMubah}(h]juah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjwhhubj4)}(hhh]h}(h]h ]h"]h$]h&]uh1j3hjwhhhjhMubeh}(h]h ](jAmacroeh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhhhNhNubjM)}(h!``get_kernel_nofault (val, ptr)``h]jS)}(hjh]hget_kernel_nofault (val, ptr)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMhhhhubji)}(h'safely attempt to read from a location h]jM)}(h&safely attempt to read from a locationh]h&safely attempt to read from a location}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMhjubah}(h]h ]h"]h$]h&]uh1jhhjhMhhhhubj)}(h**Parameters** ``val`` read into this variable ``ptr`` address to read from **Description** Returns 0 on success, or -EFAULT.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMhjubj)}(hhh](j)}(h ``val`` read into this variable h](j)}(h``val``h]jS)}(hj h]hval}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMhjubj)}(hhh]jM)}(hread into this variableh]hread into this variable}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj!hMhj"ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj!hMhjubj)}(h``ptr`` address to read from h](j)}(h``ptr``h]jS)}(hjEh]hptr}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjCubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMhj?ubj)}(hhh]jM)}(haddress to read fromh]haddress to read from}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjZhMhj[ubah}(h]h ]h"]h$]h&]uh1jhj?ubeh}(h]h ]h"]h$]h&]uh1jhjZhMhjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj~ubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMhjubjM)}(h!Returns 0 on success, or -EFAULT.h]h!Returns 0 on success, or -EFAULT.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h$__scoped_user_access_begin (C macro)c.__scoped_user_access_beginhNtauh1hhhhhhNhNubh)}(hhh](h)}(h__scoped_user_access_beginh]h)}(h__scoped_user_access_beginh]h)}(h__scoped_user_access_beginh]j)}(hjh]h__scoped_user_access_begin}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMubah}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]h}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAmacroeh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhhhNhNubjM)}(h7``__scoped_user_access_begin (mode, uptr, size, elbl)``h]jS)}(hjh]h3__scoped_user_access_begin (mode, uptr, size, elbl)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMhhhhubji)}(hStart a scoped user access h]jM)}(hStart a scoped user accessh]hStart a scoped user access}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMhjubah}(h]h ]h"]h$]h&]uh1jhhj#hMhhhhubj)}(hX1**Parameters** ``mode`` The mode of the access class (read, write, rw) ``uptr`` The pointer to access user space memory ``size`` Size of the access ``elbl`` Error label to goto when the access region is rejected **Description** Internal helper for __scoped_user_access(). Don't use directly.h](jM)}(h**Parameters**h]j)}(hj0h]h Parameters}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj.ubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMhj*ubj)}(hhh](j)}(h8``mode`` The mode of the access class (read, write, rw) h](j)}(h``mode``h]jS)}(hjOh]hmode}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjMubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMhjIubj)}(hhh]jM)}(h.The mode of the access class (read, write, rw)h]h.The mode of the access class (read, write, rw)}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjdhMhjeubah}(h]h ]h"]h$]h&]uh1jhjIubeh}(h]h ]h"]h$]h&]uh1jhjdhMhjFubj)}(h1``uptr`` The pointer to access user space memory h](j)}(h``uptr``h]jS)}(hjh]huptr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMhjubj)}(hhh]jM)}(h'The pointer to access user space memoryh]h'The pointer to access user space memory}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjFubj)}(h``size`` Size of the access h](j)}(h``size``h]jS)}(hjh]hsize}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMhjubj)}(hhh]jM)}(hSize of the accessh]hSize of the access}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjFubj)}(h@``elbl`` Error label to goto when the access region is rejected h](j)}(h``elbl``h]jS)}(hjh]helbl}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMhjubj)}(hhh]jM)}(h6Error label to goto when the access region is rejectedh]h6Error label to goto when the access region is rejected}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjFubeh}(h]h ]h"]h$]h&]uh1jhj*ubjM)}(h**Description**h]j)}(hj5h]h Description}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj3ubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMhj*ubjM)}(h?Internal helper for __scoped_user_access(). Don't use directly.h]hAInternal helper for __scoped_user_access(). Don’t use directly.}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMhj*ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h__scoped_user_access (C macro)c.__scoped_user_accesshNtauh1hhhhhhNhNubh)}(hhh](h)}(h__scoped_user_accessh]h)}(h__scoped_user_accessh]h)}(h__scoped_user_accessh]j)}(hjth]h__scoped_user_access}(hj~hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjzubah}(h]h ](jjeh"]h$]h&]jjuh1hhjvhhhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMubah}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjrhhhjhMubah}(h]jmah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjohhubj4)}(hhh]h}(h]h ]h"]h$]h&]uh1j3hjohhhjhMubeh}(h]h ](jAmacroeh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhhhNhNubjM)}(h1``__scoped_user_access (mode, uptr, size, elbl)``h]jS)}(hjh]h-__scoped_user_access (mode, uptr, size, elbl)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMhhhhubji)}(hOpen a scope for user access h]jM)}(hOpen a scope for user accessh]hOpen a scope for user access}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMhjubah}(h]h ]h"]h$]h&]uh1jhhjhMhhhhubj)}(hX**Parameters** ``mode`` The mode of the access class (read, write, rw) ``uptr`` The pointer to access user space memory ``size`` Size of the access ``elbl`` Error label to goto when the access region is rejected. It must be placed outside the scope **Description** If the user access function inside the scope requires a fault label, it can use **elbl** or a different label outside the scope, which requires that user access which is implemented with ASM GOTO has been properly wrapped. See unsafe_get_user() for reference:: scoped_user_rw_access(ptr, efault) { unsafe_get_user(rval, &ptr->rval, efault); unsafe_put_user(wval, &ptr->wval, efault); } return 0; efault: return -EFAULT; The scope is internally implemented as a autoterminating nested for() loop, which can be left with 'return', 'break' and 'goto' at any point. When the scope is left user_##**_mode**##_access_end() is automatically invoked. When the architecture supports masked user access and the access region which is determined by **uptr** and **size** is not a valid user space address, i.e. < TASK_SIZE, the scope sets the pointer to a faulting user space address and does not terminate early. This optimizes for the good case and lets the performance uncritical bad case go through the fault. The eventual modification of the pointer is limited to the scope. Outside of the scope the original pointer value is unmodified, so that the original pointer value is available for diagnostic purposes in an out of scope fault path. Nesting scoped user access into a user access scope is invalid and fails the build. Nesting into other guards, e.g. pagefault is safe. The masked variant does not check the size of the access and relies on a mapping hole (e.g. guard page) to catch an out of range pointer, the first access to user memory inside the scope has to be within **uptr** ... **uptr** + PAGE_SIZE - 1 Don't use directly. Use scoped_masked_user_$MODE_access() instead.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMhjubj)}(hhh](j)}(h8``mode`` The mode of the access class (read, write, rw) h](j)}(h``mode``h]jS)}(hjh]hmode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMhjubj)}(hhh]jM)}(h.The mode of the access class (read, write, rw)h]h.The mode of the access class (read, write, rw)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h1``uptr`` The pointer to access user space memory h](j)}(h``uptr``h]jS)}(hj=h]huptr}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj;ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMhj7ubj)}(hhh]jM)}(h'The pointer to access user space memoryh]h'The pointer to access user space memory}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjRhMhjSubah}(h]h ]h"]h$]h&]uh1jhj7ubeh}(h]h ]h"]h$]h&]uh1jhjRhMhjubj)}(h``size`` Size of the access h](j)}(h``size``h]jS)}(hjvh]hsize}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjtubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMhjpubj)}(hhh]jM)}(hSize of the accessh]hSize of the access}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjpubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(he``elbl`` Error label to goto when the access region is rejected. It must be placed outside the scope h](j)}(h``elbl``h]jS)}(hjh]helbl}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMhjubj)}(hhh]jM)}(h[Error label to goto when the access region is rejected. It must be placed outside the scopeh]h[Error label to goto when the access region is rejected. It must be placed outside the scope}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMhjubjM)}(hXIf the user access function inside the scope requires a fault label, it can use **elbl** or a different label outside the scope, which requires that user access which is implemented with ASM GOTO has been properly wrapped. See unsafe_get_user() for reference::h](hPIf the user access function inside the scope requires a fault label, it can use }(hjhhhNhNubj)}(h**elbl**h]helbl}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh or a different label outside the scope, which requires that user access which is implemented with ASM GOTO has been properly wrapped. See unsafe_get_user() for reference:}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMhjubj7 )}(h scoped_user_rw_access(ptr, efault) { unsafe_get_user(rval, &ptr->rval, efault); unsafe_put_user(wval, &ptr->wval, efault); } return 0; efault: return -EFAULT;h]h scoped_user_rw_access(ptr, efault) { unsafe_get_user(rval, &ptr->rval, efault); unsafe_put_user(wval, &ptr->wval, efault); } return 0; efault: return -EFAULT;}hj"sbah}(h]h ]h"]h$]h&]jjuh1j6 hW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMhjubjM)}(hThe scope is internally implemented as a autoterminating nested for() loop, which can be left with 'return', 'break' and 'goto' at any point.h]hThe scope is internally implemented as a autoterminating nested for() loop, which can be left with ‘return’, ‘break’ and ‘goto’ at any point.}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMhjubjM)}(hPWhen the scope is left user_##**_mode**##_access_end() is automatically invoked.h]hPWhen the scope is left user_##**_mode**##_access_end() is automatically invoked.}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMhjubjM)}(hXgWhen the architecture supports masked user access and the access region which is determined by **uptr** and **size** is not a valid user space address, i.e. < TASK_SIZE, the scope sets the pointer to a faulting user space address and does not terminate early. This optimizes for the good case and lets the performance uncritical bad case go through the fault.h](h_When the architecture supports masked user access and the access region which is determined by }(hjOhhhNhNubj)}(h**uptr**h]huptr}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjOubh and }(hjOhhhNhNubj)}(h**size**h]hsize}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1jhjOubh is not a valid user space address, i.e. < TASK_SIZE, the scope sets the pointer to a faulting user space address and does not terminate early. This optimizes for the good case and lets the performance uncritical bad case go through the fault.}(hjOhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMhjubjM)}(hThe eventual modification of the pointer is limited to the scope. Outside of the scope the original pointer value is unmodified, so that the original pointer value is available for diagnostic purposes in an out of scope fault path.h]hThe eventual modification of the pointer is limited to the scope. Outside of the scope the original pointer value is unmodified, so that the original pointer value is available for diagnostic purposes in an out of scope fault path.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMhjubjM)}(hNesting scoped user access into a user access scope is invalid and fails the build. Nesting into other guards, e.g. pagefault is safe.h]hNesting scoped user access into a user access scope is invalid and fails the build. Nesting into other guards, e.g. pagefault is safe.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhM hjubjM)}(hThe masked variant does not check the size of the access and relies on a mapping hole (e.g. guard page) to catch an out of range pointer, the first access to user memory inside the scope has to be within **uptr** ... **uptr** + PAGE_SIZE - 1h](hThe masked variant does not check the size of the access and relies on a mapping hole (e.g. guard page) to catch an out of range pointer, the first access to user memory inside the scope has to be within }(hjhhhNhNubj)}(h**uptr**h]huptr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh ... }(hjhhhNhNubj)}(h**uptr**h]huptr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh + PAGE_SIZE - 1}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhM#hjubjM)}(hBDon't use directly. Use scoped_masked_user_$MODE_access() instead.h]hDDon’t use directly. Use scoped_masked_user_$MODE_access() instead.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhM(hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h&scoped_user_read_access_size (C macro)c.scoped_user_read_access_sizehNtauh1hhhhhhNhNubh)}(hhh](h)}(hscoped_user_read_access_sizeh]h)}(hscoped_user_read_access_sizeh]h)}(hscoped_user_read_access_sizeh]j)}(hjh]hscoped_user_read_access_size}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhM4ubah}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhM4ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhM4hjhhubj4)}(hhh]h}(h]h ]h"]h$]h&]uh1j3hjhhhjhM4ubeh}(h]h ](jAmacroeh"]h$]h&]jFjAjGj2jHj2jIjJjKuh1hhhhhhNhNubjM)}(h3``scoped_user_read_access_size (usrc, size, elbl)``h]jS)}(hj8h]h/scoped_user_read_access_size (usrc, size, elbl)}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj6ubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhM6hhhhubji)}(h0Start a scoped user read access with given size h]jM)}(h/Start a scoped user read access with given sizeh]h/Start a scoped user read access with given size}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhM4hjNubah}(h]h ]h"]h$]h&]uh1jhhj`hM4hhhhubj)}(hX**Parameters** ``usrc`` Pointer to the user space address to read from ``size`` Size of the access starting from **usrc** ``elbl`` Error label to goto when the access region is rejected **Description** For further information see __scoped_user_access() above.h](jM)}(h**Parameters**h]j)}(hjmh]h Parameters}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1jhjkubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhM8hjgubj)}(hhh](j)}(h8``usrc`` Pointer to the user space address to read from h](j)}(h``usrc``h]jS)}(hjh]husrc}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhM5hjubj)}(hhh]jM)}(h.Pointer to the user space address to read fromh]h.Pointer to the user space address to read from}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM5hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM5hjubj)}(h3``size`` Size of the access starting from **usrc** h](j)}(h``size``h]jS)}(hjh]hsize}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhM6hjubj)}(hhh]jM)}(h)Size of the access starting from **usrc**h](h!Size of the access starting from }(hjhhhNhNubj)}(h**usrc**h]husrc}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jLhjhM6hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM6hjubj)}(h@``elbl`` Error label to goto when the access region is rejected h](j)}(h``elbl``h]jS)}(hj h]helbl}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhM7hjubj)}(hhh]jM)}(h6Error label to goto when the access region is rejectedh]h6Error label to goto when the access region is rejected}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj!hM7hj"ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj!hM7hjubeh}(h]h ]h"]h$]h&]uh1jhjgubjM)}(h**Description**h]j)}(hjGh]h Description}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjEubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhM9hjgubjM)}(h9For further information see __scoped_user_access() above.h]h9For further information see __scoped_user_access() above.}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhM8hjgubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h!scoped_user_read_access (C macro)c.scoped_user_read_accesshNtauh1hhhhhhNhNubh)}(hhh](h)}(hscoped_user_read_accessh]h)}(hscoped_user_read_accessh]h)}(hscoped_user_read_accessh]j)}(hjh]hscoped_user_read_access}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhM?ubah}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhM?ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhM?hjhhubj4)}(hhh]h}(h]h ]h"]h$]h&]uh1j3hjhhhjhM?ubeh}(h]h ](jAmacroeh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhhhNhNubjM)}(h(``scoped_user_read_access (usrc, elbl)``h]jS)}(hjh]h$scoped_user_read_access (usrc, elbl)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMAhhhhubji)}(h Start a scoped user read access h]jM)}(hStart a scoped user read accessh]hStart a scoped user read access}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhM?hjubah}(h]h ]h"]h$]h&]uh1jhhjhM?hhhhubj)}(hX-**Parameters** ``usrc`` Pointer to the user space address to read from ``elbl`` Error label to goto when the access region is rejected **Description** The size of the access starting from **usrc** is determined via sizeof(***usrc**)). For further information see __scoped_user_access() above.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMChjubj)}(hhh](j)}(h8``usrc`` Pointer to the user space address to read from h](j)}(h``usrc``h]jS)}(hjh]husrc}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhM@hjubj)}(hhh]jM)}(h.Pointer to the user space address to read fromh]h.Pointer to the user space address to read from}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj+hM@hj,ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj+hM@hj ubj)}(h@``elbl`` Error label to goto when the access region is rejected h](j)}(h``elbl``h]jS)}(hjOh]helbl}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjMubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMAhjIubj)}(hhh]jM)}(h6Error label to goto when the access region is rejectedh]h6Error label to goto when the access region is rejected}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjdhMAhjeubah}(h]h ]h"]h$]h&]uh1jhjIubeh}(h]h ]h"]h$]h&]uh1jhjdhMAhj ubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMChjubjM)}(hSThe size of the access starting from **usrc** is determined via sizeof(***usrc**)).h](h%The size of the access starting from }(hjhhhNhNubj)}(h**usrc**h]husrc}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh is determined via sizeof(}(hjhhhNhNubj)}(h ***usrc**h]h*usrc}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh)).}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMBhjubjM)}(h9For further information see __scoped_user_access() above.h]h9For further information see __scoped_user_access() above.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMDhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h'scoped_user_write_access_size (C macro)c.scoped_user_write_access_sizehNtauh1hhhhhhNhNubh)}(hhh](h)}(hscoped_user_write_access_sizeh]h)}(hscoped_user_write_access_sizeh]h)}(hscoped_user_write_access_sizeh]j)}(hjh]hscoped_user_write_access_size}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMKubah}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMKubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMKhjhhubj4)}(hhh]h}(h]h ]h"]h$]h&]uh1j3hjhhhjhMKubeh}(h]h ](jAmacroeh"]h$]h&]jFjAjGj2jHj2jIjJjKuh1hhhhhhNhNubjM)}(h4``scoped_user_write_access_size (udst, size, elbl)``h]jS)}(hj8h]h0scoped_user_write_access_size (udst, size, elbl)}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj6ubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMMhhhhubji)}(h1Start a scoped user write access with given size h]jM)}(h0Start a scoped user write access with given sizeh]h0Start a scoped user write access with given size}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMKhjNubah}(h]h ]h"]h$]h&]uh1jhhj`hMKhhhhubj)}(hX **Parameters** ``udst`` Pointer to the user space address to write to ``size`` Size of the access starting from **udst** ``elbl`` Error label to goto when the access region is rejected **Description** For further information see __scoped_user_access() above.h](jM)}(h**Parameters**h]j)}(hjmh]h Parameters}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1jhjkubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMOhjgubj)}(hhh](j)}(h7``udst`` Pointer to the user space address to write to h](j)}(h``udst``h]jS)}(hjh]hudst}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMLhjubj)}(hhh]jM)}(h-Pointer to the user space address to write toh]h-Pointer to the user space address to write to}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMLhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMLhjubj)}(h3``size`` Size of the access starting from **udst** h](j)}(h``size``h]jS)}(hjh]hsize}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMMhjubj)}(hhh]jM)}(h)Size of the access starting from **udst**h](h!Size of the access starting from }(hjhhhNhNubj)}(h**udst**h]hudst}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jLhjhMMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMMhjubj)}(h@``elbl`` Error label to goto when the access region is rejected h](j)}(h``elbl``h]jS)}(hj h]helbl}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMNhjubj)}(hhh]jM)}(h6Error label to goto when the access region is rejectedh]h6Error label to goto when the access region is rejected}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj!hMNhj"ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj!hMNhjubeh}(h]h ]h"]h$]h&]uh1jhjgubjM)}(h**Description**h]j)}(hjGh]h Description}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjEubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMPhjgubjM)}(h9For further information see __scoped_user_access() above.h]h9For further information see __scoped_user_access() above.}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMOhjgubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h"scoped_user_write_access (C macro)c.scoped_user_write_accesshNtauh1hhhhhhNhNubh)}(hhh](h)}(hscoped_user_write_accessh]h)}(hscoped_user_write_accessh]h)}(hscoped_user_write_accessh]j)}(hjh]hscoped_user_write_access}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMVubah}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMVubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMVhjhhubj4)}(hhh]h}(h]h ]h"]h$]h&]uh1j3hjhhhjhMVubeh}(h]h ](jAmacroeh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhhhNhNubjM)}(h)``scoped_user_write_access (udst, elbl)``h]jS)}(hjh]h%scoped_user_write_access (udst, elbl)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMXhhhhubji)}(h!Start a scoped user write access h]jM)}(h Start a scoped user write accessh]h Start a scoped user write access}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMVhjubah}(h]h ]h"]h$]h&]uh1jhhjhMVhhhhubj)}(hX,**Parameters** ``udst`` Pointer to the user space address to write to ``elbl`` Error label to goto when the access region is rejected **Description** The size of the access starting from **udst** is determined via sizeof(***udst**)). For further information see __scoped_user_access() above.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMZhjubj)}(hhh](j)}(h7``udst`` Pointer to the user space address to write to h](j)}(h``udst``h]jS)}(hj h]hudst}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMWhj ubj)}(hhh]jM)}(h-Pointer to the user space address to write toh]h-Pointer to the user space address to write to}(hj/ hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj+ hMWhj, ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj+ hMWhj ubj)}(h@``elbl`` Error label to goto when the access region is rejected h](j)}(h``elbl``h]jS)}(hjO h]helbl}(hjQ hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjM ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMXhjI ubj)}(hhh]jM)}(h6Error label to goto when the access region is rejectedh]h6Error label to goto when the access region is rejected}(hjh hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjd hMXhje ubah}(h]h ]h"]h$]h&]uh1jhjI ubeh}(h]h ]h"]h$]h&]uh1jhjd hMXhj ubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hj h]h Description}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMZhjubjM)}(hSThe size of the access starting from **udst** is determined via sizeof(***udst**)).h](h%The size of the access starting from }(hj hhhNhNubj)}(h**udst**h]hudst}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubh is determined via sizeof(}(hj hhhNhNubj)}(h ***udst**h]h*udst}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubh)).}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMYhjubjM)}(h9For further information see __scoped_user_access() above.h]h9For further information see __scoped_user_access() above.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhM[hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h$scoped_user_rw_access_size (C macro)c.scoped_user_rw_access_sizehNtauh1hhhhhhNhNubh)}(hhh](h)}(hscoped_user_rw_access_sizeh]h)}(hscoped_user_rw_access_sizeh]h)}(hscoped_user_rw_access_sizeh]j)}(hj h]hscoped_user_rw_access_size}(hj!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj hhhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMbubah}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj hhhj!hMbubah}(h]j ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj!hMbhj hhubj4)}(hhh]h}(h]h ]h"]h$]h&]uh1j3hj hhhj!hMbubeh}(h]h ](jAmacroeh"]h$]h&]jFjAjGj2!jHj2!jIjJjKuh1hhhhhhNhNubjM)}(h1``scoped_user_rw_access_size (uptr, size, elbl)``h]jS)}(hj8!h]h-scoped_user_rw_access_size (uptr, size, elbl)}(hj:!hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj6!ubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMdhhhhubji)}(h6Start a scoped user read/write access with given size h]jM)}(h5Start a scoped user read/write access with given sizeh]h5Start a scoped user read/write access with given size}(hjR!hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMbhjN!ubah}(h]h ]h"]h$]h&]uh1jhhj`!hMbhhhhubj)}(hX**Parameters** ``uptr`` Pointer to the user space address to read from and write to ``size`` Size of the access starting from **uptr** ``elbl`` Error label to goto when the access region is rejected **Description** For further information see __scoped_user_access() above.h](jM)}(h**Parameters**h]j)}(hjm!h]h Parameters}(hjo!hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjk!ubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMfhjg!ubj)}(hhh](j)}(hE``uptr`` Pointer to the user space address to read from and write to h](j)}(h``uptr``h]jS)}(hj!h]huptr}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj!ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMchj!ubj)}(hhh]jM)}(h;Pointer to the user space address to read from and write toh]h;Pointer to the user space address to read from and write to}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj!hMchj!ubah}(h]h ]h"]h$]h&]uh1jhj!ubeh}(h]h ]h"]h$]h&]uh1jhj!hMchj!ubj)}(h3``size`` Size of the access starting from **uptr** h](j)}(h``size``h]jS)}(hj!h]hsize}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj!ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMdhj!ubj)}(hhh]jM)}(h)Size of the access starting from **uptr**h](h!Size of the access starting from }(hj!hhhNhNubj)}(h**uptr**h]huptr}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj!ubeh}(h]h ]h"]h$]h&]uh1jLhj!hMdhj!ubah}(h]h ]h"]h$]h&]uh1jhj!ubeh}(h]h ]h"]h$]h&]uh1jhj!hMdhj!ubj)}(h@``elbl`` Error label to goto when the access region is rejected h](j)}(h``elbl``h]jS)}(hj "h]helbl}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj "ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMehj"ubj)}(hhh]jM)}(h6Error label to goto when the access region is rejectedh]h6Error label to goto when the access region is rejected}(hj%"hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj!"hMehj""ubah}(h]h ]h"]h$]h&]uh1jhj"ubeh}(h]h ]h"]h$]h&]uh1jhj!"hMehj!ubeh}(h]h ]h"]h$]h&]uh1jhjg!ubjM)}(h**Description**h]j)}(hjG"h]h Description}(hjI"hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjE"ubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMghjg!ubjM)}(h9For further information see __scoped_user_access() above.h]h9For further information see __scoped_user_access() above.}(hj]"hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMfhjg!ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hscoped_user_rw_access (C macro)c.scoped_user_rw_accesshNtauh1hhhhhhNhNubh)}(hhh](h)}(hscoped_user_rw_accessh]h)}(hscoped_user_rw_accessh]h)}(hscoped_user_rw_accessh]j)}(hj"h]hscoped_user_rw_access}(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj"hhhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMmubah}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj"hhhj"hMmubah}(h]j"ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj"hMmhj"hhubj4)}(hhh]h}(h]h ]h"]h$]h&]uh1j3hj"hhhj"hMmubeh}(h]h ](jAmacroeh"]h$]h&]jFjAjGj"jHj"jIjJjKuh1hhhhhhNhNubjM)}(h&``scoped_user_rw_access (uptr, elbl)``h]jS)}(hj"h]h"scoped_user_rw_access (uptr, elbl)}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj"ubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMohhhhubji)}(h&Start a scoped user read/write access h]jM)}(h%Start a scoped user read/write accessh]h%Start a scoped user read/write access}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMmhj"ubah}(h]h ]h"]h$]h&]uh1jhhj"hMmhhhhubj)}(hX:**Parameters** ``uptr`` Pointer to the user space address to read from and write to ``elbl`` Error label to goto when the access region is rejected **Description** The size of the access starting from **uptr** is determined via sizeof(***uptr**)). For further information see __scoped_user_access() above.h](jM)}(h**Parameters**h]j)}(hj"h]h Parameters}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj"ubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMqhj"ubj)}(hhh](j)}(hE``uptr`` Pointer to the user space address to read from and write to h](j)}(h``uptr``h]jS)}(hj#h]huptr}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj#ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMnhj#ubj)}(hhh]jM)}(h;Pointer to the user space address to read from and write toh]h;Pointer to the user space address to read from and write to}(hj/#hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj+#hMnhj,#ubah}(h]h ]h"]h$]h&]uh1jhj#ubeh}(h]h ]h"]h$]h&]uh1jhj+#hMnhj #ubj)}(h@``elbl`` Error label to goto when the access region is rejected h](j)}(h``elbl``h]jS)}(hjO#h]helbl}(hjQ#hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjM#ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMohjI#ubj)}(hhh]jM)}(h6Error label to goto when the access region is rejectedh]h6Error label to goto when the access region is rejected}(hjh#hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjd#hMohje#ubah}(h]h ]h"]h$]h&]uh1jhjI#ubeh}(h]h ]h"]h$]h&]uh1jhjd#hMohj #ubeh}(h]h ]h"]h$]h&]uh1jhj"ubjM)}(h**Description**h]j)}(hj#h]h Description}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj#ubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMqhj"ubjM)}(hSThe size of the access starting from **uptr** is determined via sizeof(***uptr**)).h](h%The size of the access starting from }(hj#hhhNhNubj)}(h**uptr**h]huptr}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj#ubh is determined via sizeof(}(hj#hhhNhNubj)}(h ***uptr**h]h*uptr}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj#ubh)).}(hj#hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMphj"ubjM)}(h9For further information see __scoped_user_access() above.h]h9For further information see __scoped_user_access() above.}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMrhj"ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hget_user_inline (C macro)c.get_user_inlinehNtauh1hhhhhhNhNubh)}(hhh](h)}(hget_user_inlineh]h)}(hget_user_inlineh]h)}(hget_user_inlineh]j)}(hj#h]hget_user_inline}(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj#hhhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMyubah}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj#hhhj$hMyubah}(h]j#ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj$hMyhj#hhubj4)}(hhh]h}(h]h ]h"]h$]h&]uh1j3hj#hhhj$hMyubeh}(h]h ](jAmacroeh"]h$]h&]jFjAjGj2$jHj2$jIjJjKuh1hhhhhhNhNubjM)}(h``get_user_inline (val, usrc)``h]jS)}(hj8$h]hget_user_inline (val, usrc)}(hj:$hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj6$ubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhM{hhhhubji)}(hRead user data inlined h]jM)}(hRead user data inlinedh]hRead user data inlined}(hjR$hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMyhjN$ubah}(h]h ]h"]h$]h&]uh1jhhj`$hMyhhhhubj)}(hX'**Parameters** ``val`` The variable to store the value read from user memory ``usrc`` Pointer to the user space memory to read from **Return** 0 if successful, -EFAULT when faulted **Description** Inlined variant of get_user(). Only use when there is a demonstrable performance reason.h](jM)}(h**Parameters**h]j)}(hjm$h]h Parameters}(hjo$hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjk$ubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhM}hjg$ubj)}(hhh](j)}(h>``val`` The variable to store the value read from user memory h](j)}(h``val``h]jS)}(hj$h]hval}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj$ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMzhj$ubj)}(hhh]jM)}(h5The variable to store the value read from user memoryh]h5The variable to store the value read from user memory}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj$hMzhj$ubah}(h]h ]h"]h$]h&]uh1jhj$ubeh}(h]h ]h"]h$]h&]uh1jhj$hMzhj$ubj)}(h7``usrc`` Pointer to the user space memory to read from h](j)}(h``usrc``h]jS)}(hj$h]husrc}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj$ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhM{hj$ubj)}(hhh]jM)}(h-Pointer to the user space memory to read fromh]h-Pointer to the user space memory to read from}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj$hM{hj$ubah}(h]h ]h"]h$]h&]uh1jhj$ubeh}(h]h ]h"]h$]h&]uh1jhj$hM{hj$ubeh}(h]h ]h"]h$]h&]uh1jhjg$ubjM)}(h **Return**h]j)}(hj%h]hReturn}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj$ubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhM}hjg$ubjM)}(h%0 if successful, -EFAULT when faultedh]h%0 if successful, -EFAULT when faulted}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhM}hjg$ubjM)}(h**Description**h]j)}(hj'%h]h Description}(hj)%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj%%ubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMhjg$ubjM)}(hXInlined variant of get_user(). Only use when there is a demonstrable performance reason.h]hXInlined variant of get_user(). Only use when there is a demonstrable performance reason.}(hj=%hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhM~hjg$ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hput_user_inline (C macro)c.put_user_inlinehNtauh1hhhhhhNhNubh)}(hhh](h)}(hput_user_inlineh]h)}(hput_user_inlineh]h)}(hput_user_inlineh]j)}(hjf%h]hput_user_inline}(hjp%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjl%ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjh%hhhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMubah}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjd%hhhj%hMubah}(h]j_%ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj%hMhja%hhubj4)}(hhh]h}(h]h ]h"]h$]h&]uh1j3hja%hhhj%hMubeh}(h]h ](jAmacroeh"]h$]h&]jFjAjGj%jHj%jIjJjKuh1hhhhhhNhNubjM)}(h``put_user_inline (val, udst)``h]jS)}(hj%h]hput_user_inline (val, udst)}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj%ubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMhhhhubji)}(hWrite to user memory inlined h]jM)}(hWrite to user memory inlinedh]hWrite to user memory inlined}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMhj%ubah}(h]h ]h"]h$]h&]uh1jhhj%hMhhhhubj)}(hX**Parameters** ``val`` The value to write ``udst`` Pointer to the user space memory to write to **Return** 0 if successful, -EFAULT when faulted **Description** Inlined variant of put_user(). Only use when there is a demonstrable performance reason.h](jM)}(h**Parameters**h]j)}(hj%h]h Parameters}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj%ubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMhj%ubj)}(hhh](j)}(h``val`` The value to write h](j)}(h``val``h]jS)}(hj%h]hval}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj%ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMhj%ubj)}(hhh]jM)}(hThe value to writeh]hThe value to write}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj &hMhj &ubah}(h]h ]h"]h$]h&]uh1jhj%ubeh}(h]h ]h"]h$]h&]uh1jhj &hMhj%ubj)}(h6``udst`` Pointer to the user space memory to write to h](j)}(h``udst``h]jS)}(hj/&h]hudst}(hj1&hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj-&ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMhj)&ubj)}(hhh]jM)}(h,Pointer to the user space memory to write toh]h,Pointer to the user space memory to write to}(hjH&hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjD&hMhjE&ubah}(h]h ]h"]h$]h&]uh1jhj)&ubeh}(h]h ]h"]h$]h&]uh1jhjD&hMhj%ubeh}(h]h ]h"]h$]h&]uh1jhj%ubjM)}(h **Return**h]j)}(hjj&h]hReturn}(hjl&hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjh&ubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMhj%ubjM)}(h%0 if successful, -EFAULT when faultedh]h%0 if successful, -EFAULT when faulted}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMhj%ubjM)}(h**Description**h]j)}(hj&h]h Description}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj&ubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMhj%ubjM)}(hXInlined variant of put_user(). Only use when there is a demonstrable performance reason.h]hXInlined variant of put_user(). Only use when there is a demonstrable performance reason.}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:11: ./include/linux/uaccess.hhMhj%ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hclear_user (C function) c.clear_userhNtauh1hhhhhhNhNubh)}(hhh](h)}(h;unsigned long clear_user (void __user *to, unsigned long n)h]h)}(h:unsigned long clear_user(void __user *to, unsigned long n)h](j)}(hunsignedh]hunsigned}(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&hhhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:14: ./arch/x86/lib/usercopy_32.chK4ubj)}(h h]h }(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&hhhj&hK4ubj)}(hlongh]hlong}(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&hhhj&hK4ubj)}(h h]h }(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&hhhj&hK4ubh)}(h clear_userh]j)}(h clear_userh]h clear_user}(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj'ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj&hhhj&hK4ubj8)}(h"(void __user *to, unsigned long n)h](j>)}(hvoid __user *toh](j)}(hvoidh]hvoid}(hj/'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+'ubj)}(h h]h }(hj='hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+'ubh__user}(hj+'hhhNhNubj)}(h h]h }(hjO'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+'ubjr)}(hjuh]h*}(hj]'hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj+'ubj)}(htoh]hto}(hjj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+'ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj''ubj>)}(hunsigned long nh](j)}(hunsignedh]hunsigned}(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj'ubj)}(h h]h }(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj'ubj)}(hlongh]hlong}(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj'ubj)}(h h]h }(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj'ubj)}(hjh]hn}(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj'ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj''ubeh}(h]h ]h"]h$]h&]jjuh1j7hj&hhhj&hK4ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj&hhhj&hK4ubah}(h]j&ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj&hK4hj&hhubj4)}(hhh]jM)}(h%Zero a block of memory in user space.h]h%Zero a block of memory in user space.}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:14: ./arch/x86/lib/usercopy_32.chK4hj'hhubah}(h]h ]h"]h$]h&]uh1j3hj&hhhj&hK4ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj'jHj'jIjJjKuh1hhhhhhNhNubj)}(hX**Parameters** ``void __user *to`` Destination address, in user space. ``unsigned long n`` Number of bytes to zero. **Description** Zero a block of memory in user space. **Return** number of bytes that could not be cleared. On success, this will be zero.h](jM)}(h**Parameters**h]j)}(hj(h]h Parameters}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj(ubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:14: ./arch/x86/lib/usercopy_32.chK8hj(ubj)}(hhh](j)}(h8``void __user *to`` Destination address, in user space. h](j)}(h``void __user *to``h]jS)}(hj%(h]hvoid __user *to}(hj'(hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj#(ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:14: ./arch/x86/lib/usercopy_32.chK5hj(ubj)}(hhh]jM)}(h#Destination address, in user space.h]h#Destination address, in user space.}(hj>(hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj:(hK5hj;(ubah}(h]h ]h"]h$]h&]uh1jhj(ubeh}(h]h ]h"]h$]h&]uh1jhj:(hK5hj(ubj)}(h-``unsigned long n`` Number of bytes to zero. h](j)}(h``unsigned long n``h]jS)}(hj^(h]hunsigned long n}(hj`(hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj\(ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:14: ./arch/x86/lib/usercopy_32.chK6hjX(ubj)}(hhh]jM)}(hNumber of bytes to zero.h]hNumber of bytes to zero.}(hjw(hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjs(hK6hjt(ubah}(h]h ]h"]h$]h&]uh1jhjX(ubeh}(h]h ]h"]h$]h&]uh1jhjs(hK6hj(ubeh}(h]h ]h"]h$]h&]uh1jhj(ubjM)}(h**Description**h]j)}(hj(h]h Description}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj(ubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:14: ./arch/x86/lib/usercopy_32.chK8hj(ubjM)}(h%Zero a block of memory in user space.h]h%Zero a block of memory in user space.}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:14: ./arch/x86/lib/usercopy_32.chK7hj(ubjM)}(h **Return**h]j)}(hj(h]hReturn}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj(ubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:14: ./arch/x86/lib/usercopy_32.chK9hj(ubjM)}(hInumber of bytes that could not be cleared. On success, this will be zero.h]hInumber of bytes that could not be cleared. On success, this will be zero.}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:14: ./arch/x86/lib/usercopy_32.chK:hj(ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h__clear_user (C function)c.__clear_userhNtauh1hhhhhhNhNubh)}(hhh](h)}(h=unsigned long __clear_user (void __user *to, unsigned long n)h]h)}(h)ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj)hhhj)hKHubj8)}(h"(void __user *to, unsigned long n)h](j>)}(hvoid __user *toh](j)}(hvoidh]hvoid}(hj^)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZ)ubj)}(h h]h }(hjl)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZ)ubh__user}(hjZ)hhhNhNubj)}(h h]h }(hj~)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZ)ubjr)}(hjuh]h*}(hj)hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjZ)ubj)}(htoh]hto}(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZ)ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjV)ubj>)}(hunsigned long nh](j)}(hunsignedh]hunsigned}(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubj)}(h h]h }(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubj)}(hlongh]hlong}(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubj)}(h h]h }(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubj)}(hjh]hn}(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjV)ubeh}(h]h ]h"]h$]h&]jjuh1j7hj)hhhj)hKHubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj(hhhj)hKHubah}(h]j(ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj)hKHhj(hhubj4)}(hhh]jM)}(h9Zero a block of memory in user space, with less checking.h]h9Zero a block of memory in user space, with less checking.}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:14: ./arch/x86/lib/usercopy_32.chKHhj*hhubah}(h]h ]h"]h$]h&]uh1j3hj(hhhj)hKHubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj+*jHj+*jIjJjKuh1hhhhhhNhNubj)}(hX^**Parameters** ``void __user *to`` Destination address, in user space. ``unsigned long n`` Number of bytes to zero. **Description** Zero a block of memory in user space. Caller must check the specified block with access_ok() before calling this function. **Return** number of bytes that could not be cleared. On success, this will be zero.h](jM)}(h**Parameters**h]j)}(hj5*h]h Parameters}(hj7*hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj3*ubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:14: ./arch/x86/lib/usercopy_32.chKLhj/*ubj)}(hhh](j)}(h8``void __user *to`` Destination address, in user space. h](j)}(h``void __user *to``h]jS)}(hjT*h]hvoid __user *to}(hjV*hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjR*ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:14: ./arch/x86/lib/usercopy_32.chKIhjN*ubj)}(hhh]jM)}(h#Destination address, in user space.h]h#Destination address, in user space.}(hjm*hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhji*hKIhjj*ubah}(h]h ]h"]h$]h&]uh1jhjN*ubeh}(h]h ]h"]h$]h&]uh1jhji*hKIhjK*ubj)}(h-``unsigned long n`` Number of bytes to zero. h](j)}(h``unsigned long n``h]jS)}(hj*h]hunsigned long n}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj*ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:14: ./arch/x86/lib/usercopy_32.chKJhj*ubj)}(hhh]jM)}(hNumber of bytes to zero.h]hNumber of bytes to zero.}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj*hKJhj*ubah}(h]h ]h"]h$]h&]uh1jhj*ubeh}(h]h ]h"]h$]h&]uh1jhj*hKJhjK*ubeh}(h]h ]h"]h$]h&]uh1jhj/*ubjM)}(h**Description**h]j)}(hj*h]h Description}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj*ubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:14: ./arch/x86/lib/usercopy_32.chKLhj/*ubjM)}(h{Zero a block of memory in user space. Caller must check the specified block with access_ok() before calling this function.h]h{Zero a block of memory in user space. Caller must check the specified block with access_ok() before calling this function.}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:14: ./arch/x86/lib/usercopy_32.chKKhj/*ubjM)}(h **Return**h]j)}(hj*h]hReturn}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj*ubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:14: ./arch/x86/lib/usercopy_32.chKNhj/*ubjM)}(hInumber of bytes that could not be cleared. On success, this will be zero.h]hInumber of bytes that could not be cleared. On success, this will be zero.}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:14: ./arch/x86/lib/usercopy_32.chKOhj/*ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h get_user_pages_fast (C function)c.get_user_pages_fasthNtauh1hhhhhhNhNubh)}(hhh](h)}(hhint get_user_pages_fast (unsigned long start, int nr_pages, unsigned int gup_flags, struct page **pages)h]h)}(hgint get_user_pages_fast(unsigned long start, int nr_pages, unsigned int gup_flags, struct page **pages)h](j)}(hinth]hint}(hj4+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0+hhhH/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:17: ./mm/gup.chM ubj)}(h h]h }(hjC+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0+hhhjB+hM ubh)}(hget_user_pages_fasth]j)}(hget_user_pages_fasth]hget_user_pages_fast}(hjU+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjQ+ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj0+hhhjB+hM ubj8)}(hP(unsigned long start, int nr_pages, unsigned int gup_flags, struct page **pages)h](j>)}(hunsigned long starth](j)}(hunsignedh]hunsigned}(hjq+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjm+ubj)}(h h]h }(hj+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjm+ubj)}(hlongh]hlong}(hj+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjm+ubj)}(h h]h }(hj+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjm+ubj)}(hstarth]hstart}(hj+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjm+ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hji+ubj>)}(h int nr_pagesh](j)}(hinth]hint}(hj+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubj)}(h h]h }(hj+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubj)}(hnr_pagesh]hnr_pages}(hj+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hji+ubj>)}(hunsigned int gup_flagsh](j)}(hunsignedh]hunsigned}(hj+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubj)}(h h]h }(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubj)}(hinth]hint}(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubj)}(h h]h }(hj!,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubj)}(h gup_flagsh]h gup_flags}(hj/,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hji+ubj>)}(hstruct page **pagesh](j)}(hstructh]hstruct}(hjH,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjD,ubj)}(h h]h }(hjV,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjD,ubh)}(hhh]j)}(hpageh]hpage}(hjg,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjd,ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetji,modnameN classnameNjj)}j]j)}jjW+sbc.get_user_pages_fastasbuh1hhjD,ubj)}(h h]h }(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjD,ubjr)}(hjuh]h*}(hj,hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjD,ubjr)}(hjuh]h*}(hj,hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjD,ubj)}(hpagesh]hpages}(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjD,ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hji+ubeh}(h]h ]h"]h$]h&]jjuh1j7hj0+hhhjB+hM ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj,+hhhjB+hM ubah}(h]j'+ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjB+hM hj)+hhubj4)}(hhh]jM)}(hpin user pages in memoryh]hpin user pages in memory}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhH/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:17: ./mm/gup.chM hj,hhubah}(h]h ]h"]h$]h&]uh1j3hj)+hhhjB+hM ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj,jHj,jIjJjKuh1hhhhhhNhNubj)}(hXl**Parameters** ``unsigned long start`` starting user address ``int nr_pages`` number of pages from start to pin ``unsigned int gup_flags`` flags modifying pin behaviour ``struct page **pages`` array that receives pointers to the pages pinned. Should be at least nr_pages long. **Description** Attempt to pin user pages in memory without taking mm->mmap_lock. If not successful, it will fall back to taking the lock and calling get_user_pages(). Returns number of pages pinned. This may be fewer than the number requested. If nr_pages is 0 or negative, returns 0. If no pages were pinned, returns -errno.h](jM)}(h**Parameters**h]j)}(hj,h]h Parameters}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj,ubah}(h]h ]h"]h$]h&]uh1jLhH/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:17: ./mm/gup.chM hj,ubj)}(hhh](j)}(h.``unsigned long start`` starting user address h](j)}(h``unsigned long start``h]jS)}(hj-h]hunsigned long start}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj-ubah}(h]h ]h"]h$]h&]uh1jhH/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:17: ./mm/gup.chM hj-ubj)}(hhh]jM)}(hstarting user addressh]hstarting user address}(hj3-hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj/-hM hj0-ubah}(h]h ]h"]h$]h&]uh1jhj-ubeh}(h]h ]h"]h$]h&]uh1jhj/-hM hj-ubj)}(h3``int nr_pages`` number of pages from start to pin h](j)}(h``int nr_pages``h]jS)}(hjS-h]h int nr_pages}(hjU-hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjQ-ubah}(h]h ]h"]h$]h&]uh1jhH/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:17: ./mm/gup.chM hjM-ubj)}(hhh]jM)}(h!number of pages from start to pinh]h!number of pages from start to pin}(hjl-hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjh-hM hji-ubah}(h]h ]h"]h$]h&]uh1jhjM-ubeh}(h]h ]h"]h$]h&]uh1jhjh-hM hj-ubj)}(h9``unsigned int gup_flags`` flags modifying pin behaviour h](j)}(h``unsigned int gup_flags``h]jS)}(hj-h]hunsigned int gup_flags}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj-ubah}(h]h ]h"]h$]h&]uh1jhH/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:17: ./mm/gup.chM hj-ubj)}(hhh]jM)}(hflags modifying pin behaviourh]hflags modifying pin behaviour}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj-hM hj-ubah}(h]h ]h"]h$]h&]uh1jhj-ubeh}(h]h ]h"]h$]h&]uh1jhj-hM hj-ubj)}(hl``struct page **pages`` array that receives pointers to the pages pinned. Should be at least nr_pages long. h](j)}(h``struct page **pages``h]jS)}(hj-h]hstruct page **pages}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj-ubah}(h]h ]h"]h$]h&]uh1jhH/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:17: ./mm/gup.chM hj-ubj)}(hhh]jM)}(hSarray that receives pointers to the pages pinned. Should be at least nr_pages long.h]hSarray that receives pointers to the pages pinned. Should be at least nr_pages long.}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhH/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:17: ./mm/gup.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,ubjM)}(h**Description**h]j)}(hj.h]h Description}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj-ubah}(h]h ]h"]h$]h&]uh1jLhH/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:17: ./mm/gup.chM hj,ubjM)}(hAttempt to pin user pages in memory without taking mm->mmap_lock. If not successful, it will fall back to taking the lock and calling get_user_pages().h]hAttempt to pin user pages in memory without taking mm->mmap_lock. If not successful, it will fall back to taking the lock and calling get_user_pages().}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhH/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:17: ./mm/gup.chM hj,ubjM)}(hReturns number of pages pinned. This may be fewer than the number requested. If nr_pages is 0 or negative, returns 0. If no pages were pinned, returns -errno.h]hReturns number of pages pinned. This may be fewer than the number requested. If nr_pages is 0 or negative, returns 0. If no pages were pinned, returns -errno.}(hj&.hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhH/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:17: ./mm/gup.chM hj,ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubhtarget)}(h.. _mm-api-gfp-flags:h]h}(h]h ]h"]h$]h&]refidmm-api-gfp-flagsuh1j<.hKhhhhhhubeh}(h]user-space-memory-accessah ]h"]user space memory accessah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(hMemory Allocation Controlsh]hMemory Allocation Controls}(hjU.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjR.hhhhhKubh)}(hhh](h)}(h!Page mobility and placement hintsh]h!Page mobility and placement hints}(hjf.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjc.hNhNubjM)}(hThese flags provide hints about how mobile the page is. Pages with similar mobility are placed within the same pageblocks to minimise problems due to external fragmentation.h]hThese flags provide hints about how mobile the page is. Pages with similar mobility are placed within the same pageblocks to minimise problems due to external fragmentation.}(hjt.hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:25: ./include/linux/gfp_types.hhKthjc.ubjM)}(h``__GFP_MOVABLE`` (also a zone modifier) indicates that the page can be moved by page migration during memory compaction or can be reclaimed.h](jS)}(h``__GFP_MOVABLE``h]h __GFP_MOVABLE}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj.ubh| (also a zone modifier) indicates that the page can be moved by page migration during memory compaction or can be reclaimed.}(hj.hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:25: ./include/linux/gfp_types.hhKxhjc.ubjM)}(h``__GFP_RECLAIMABLE`` is used for slab allocations that specify SLAB_RECLAIM_ACCOUNT and whose pages can be freed via shrinkers.h](jS)}(h``__GFP_RECLAIMABLE``h]h__GFP_RECLAIMABLE}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj.ubhk is used for slab allocations that specify SLAB_RECLAIM_ACCOUNT and whose pages can be freed via shrinkers.}(hj.hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:25: ./include/linux/gfp_types.hhK{hjc.ubjM)}(h``__GFP_WRITE`` indicates the caller intends to dirty the page. Where possible, these pages will be spread between local zones to avoid all the dirty pages being in one zone (fair zone allocation policy).h](jS)}(h``__GFP_WRITE``h]h __GFP_WRITE}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj.ubh indicates the caller intends to dirty the page. Where possible, these pages will be spread between local zones to avoid all the dirty pages being in one zone (fair zone allocation policy).}(hj.hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:25: ./include/linux/gfp_types.hhK~hjc.ubjM)}(h@``__GFP_HARDWALL`` enforces the cpuset memory allocation policy.h](jS)}(h``__GFP_HARDWALL``h]h__GFP_HARDWALL}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj.ubh. enforces the cpuset memory allocation policy.}(hj.hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:25: ./include/linux/gfp_types.hhKhjc.ubjM)}(h``__GFP_THISNODE`` forces the allocation to be satisfied from the requested node with no fallbacks or placement policy enforcements.h](jS)}(h``__GFP_THISNODE``h]h__GFP_THISNODE}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj.ubhr forces the allocation to be satisfied from the requested node with no fallbacks or placement policy enforcements.}(hj.hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:25: ./include/linux/gfp_types.hhKhjc.ubjM)}(hU``__GFP_ACCOUNT`` causes the allocation to be accounted to the active cgroup context.h](jS)}(h``__GFP_ACCOUNT``h]h __GFP_ACCOUNT}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj/ubhD causes the allocation to be accounted to the active cgroup context.}(hj/hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:25: ./include/linux/gfp_types.hhKhjc.ubeh}(h]!page-mobility-and-placement-hintsah ]h"]!page mobility and placement hintsah$]h&]uh1hhjR.hhhNhNubh)}(hhh](h)}(h ``PAGE_ALLOC_COSTLY_ORDER``). !costly allocations are too essential to fail so they are implicitly non-failing by default (with some exceptions like OOM victims might fail so the caller still has to check for failures) while costly requests try to be not disruptive and back off even without invoking the OOM killer. The following three modifiers might be used to override some of these implicit rules. Please note that all of them must be used along with ``__GFP_DIRECT_RECLAIM`` flag.h](h|The default allocator behavior depends on the request size. We have a concept of so-called costly allocations (with order > }(hj0hhhNhNubjS)}(h``PAGE_ALLOC_COSTLY_ORDER``h]hPAGE_ALLOC_COSTLY_ORDER}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj0ubhX). !costly allocations are too essential to fail so they are implicitly non-failing by default (with some exceptions like OOM victims might fail so the caller still has to check for failures) while costly requests try to be not disruptive and back off even without invoking the OOM killer. The following three modifiers might be used to override some of these implicit rules. Please note that all of them must be used along with }(hj0hhhNhNubjS)}(h``__GFP_DIRECT_RECLAIM``h]h__GFP_DIRECT_RECLAIM}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj0ubh flag.}(hj0hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:31: ./include/linux/gfp_types.hhKhj/ubjM)}(hX``__GFP_NORETRY``: The VM implementation will try only very lightweight memory direct reclaim to get some memory under memory pressure (thus it can sleep). It will avoid disruptive actions like OOM killer. The caller must handle the failure which is quite likely to happen under heavy memory pressure. The flag is suitable when failure can easily be handled at small cost, such as reduced throughput.h](jS)}(h``__GFP_NORETRY``h]h __GFP_NORETRY}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj0ubhX: The VM implementation will try only very lightweight memory direct reclaim to get some memory under memory pressure (thus it can sleep). It will avoid disruptive actions like OOM killer. The caller must handle the failure which is quite likely to happen under heavy memory pressure. The flag is suitable when failure can easily be handled at small cost, such as reduced throughput.}(hj0hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:31: ./include/linux/gfp_types.hhKhj/ubjM)}(hX``__GFP_RETRY_MAYFAIL``: The VM implementation will retry memory reclaim procedures that have previously failed if there is some indication that progress has been made elsewhere. It can wait for other tasks to attempt high-level approaches to freeing memory such as compaction (which removes fragmentation) and page-out. There is still a definite limit to the number of retries, but it is a larger limit than with ``__GFP_NORETRY``. Allocations with this flag may fail, but only when there is genuinely little unused memory. While these allocations do not directly trigger the OOM killer, their failure indicates that the system is likely to need to use the OOM killer soon. The caller must handle failure, but can reasonably do so by failing a higher-level request, or completing it only in a much less efficient manner. If the allocation does fail, and the caller is in a position to free some non-essential memory, doing so could benefit the system as a whole.h](jS)}(h``__GFP_RETRY_MAYFAIL``h]h__GFP_RETRY_MAYFAIL}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj0ubhX: The VM implementation will retry memory reclaim procedures that have previously failed if there is some indication that progress has been made elsewhere. It can wait for other tasks to attempt high-level approaches to freeing memory such as compaction (which removes fragmentation) and page-out. There is still a definite limit to the number of retries, but it is a larger limit than with }(hj0hhhNhNubjS)}(h``__GFP_NORETRY``h]h __GFP_NORETRY}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj0ubhX. Allocations with this flag may fail, but only when there is genuinely little unused memory. While these allocations do not directly trigger the OOM killer, their failure indicates that the system is likely to need to use the OOM killer soon. The caller must handle failure, but can reasonably do so by failing a higher-level request, or completing it only in a much less efficient manner. If the allocation does fail, and the caller is in a position to free some non-essential memory, doing so could benefit the system as a whole.}(hj0hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:31: ./include/linux/gfp_types.hhKhj/ubjM)}(hX``__GFP_NOFAIL``: The VM implementation _must_ retry infinitely: the caller cannot handle allocation failures. The allocation could block indefinitely but will never return with failure. Testing for failure is pointless. It _must_ be blockable and used together with __GFP_DIRECT_RECLAIM. It should _never_ be used in non-sleepable contexts. New users should be evaluated carefully (and the flag should be used only when there is no reasonable failure policy) but it is definitely preferable to use the flag rather than opencode endless loop around allocator. Allocating pages from the buddy with __GFP_NOFAIL and order > 1 is discouraged. Please consider using kvmalloc() instead if possible.h](jS)}(h``__GFP_NOFAIL``h]h __GFP_NOFAIL}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj1ubhX: The VM implementation _must_ retry infinitely: the caller cannot handle allocation failures. The allocation could block indefinitely but will never return with failure. Testing for failure is pointless. It _must_ be blockable and used together with __GFP_DIRECT_RECLAIM. It should _never_ be used in non-sleepable contexts. New users should be evaluated carefully (and the flag should be used only when there is no reasonable failure policy) but it is definitely preferable to use the flag rather than opencode endless loop around allocator. Allocating pages from the buddy with __GFP_NOFAIL and order > 1 is discouraged. Please consider using kvmalloc() instead if possible.}(hj1hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:31: ./include/linux/gfp_types.hhKhj/ubeh}(h]reclaim-modifiersah ]h"]reclaim modifiersah$]h&]uh1hhjR.hhhNhNubh)}(hhh](h)}(hUseful GFP flag combinationsh]hUseful GFP flag combinations}(hj71hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj41hNhNubjM)}(hUseful GFP flag combinations that are commonly used. It is recommended that subsystems start with one of these combinations and then set/clear ``__GFP_FOO`` flags as necessary.h](hUseful GFP flag combinations that are commonly used. It is recommended that subsystems start with one of these combinations and then set/clear }(hjE1hhhNhNubjS)}(h ``__GFP_FOO``h]h __GFP_FOO}(hjM1hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjE1ubh flags as necessary.}(hjE1hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:34: ./include/linux/gfp_types.hhM,hj41ubjM)}(hX``GFP_ATOMIC`` users can not sleep and need the allocation to succeed. A lower watermark is applied to allow access to "atomic reserves". The current implementation doesn't support NMI, nor contexts that disable preemption under PREEMPT_RT. This includes raw_spin_lock() and plain preempt_disable() - see "Memory allocation" in Documentation/core-api/real-time/differences.rst for more info.h](jS)}(h``GFP_ATOMIC``h]h GFP_ATOMIC}(hjj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjf1ubhX users can not sleep and need the allocation to succeed. A lower watermark is applied to allow access to “atomic reserves”. The current implementation doesn’t support NMI, nor contexts that disable preemption under PREEMPT_RT. This includes raw_spin_lock() and plain preempt_disable() - see “Memory allocation” in Documentation/core-api/real-time/differences.rst for more info.}(hjf1hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:34: ./include/linux/gfp_types.hhM0hj41ubjM)}(h``GFP_KERNEL`` is typical for kernel-internal allocations. The caller requires ``ZONE_NORMAL`` or a lower zone for direct access but can direct reclaim.h](jS)}(h``GFP_KERNEL``h]h GFP_KERNEL}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj1ubhA is typical for kernel-internal allocations. The caller requires }(hj1hhhNhNubjS)}(h``ZONE_NORMAL``h]h ZONE_NORMAL}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj1ubh: or a lower zone for direct access but can direct reclaim.}(hj1hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:34: ./include/linux/gfp_types.hhM7hj41ubjM)}(hr``GFP_KERNEL_ACCOUNT`` is the same as GFP_KERNEL, except the allocation is accounted to the active cgroup context.h](jS)}(h``GFP_KERNEL_ACCOUNT``h]hGFP_KERNEL_ACCOUNT}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj1ubh\ is the same as GFP_KERNEL, except the allocation is accounted to the active cgroup context.}(hj1hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:34: ./include/linux/gfp_types.hhM:hj41ubjM)}(hX``GFP_NOWAIT`` is for kernel allocations that should not stall for direct reclaim, start physical IO or use any filesystem callback. It is very likely to fail to allocate memory, even for very small allocations. The same restrictions on calling contexts apply as for ``GFP_ATOMIC``.h](jS)}(h``GFP_NOWAIT``h]h GFP_NOWAIT}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj1ubh is for kernel allocations that should not stall for direct reclaim, start physical IO or use any filesystem callback. It is very likely to fail to allocate memory, even for very small allocations. The same restrictions on calling contexts apply as for }(hj1hhhNhNubjS)}(h``GFP_ATOMIC``h]h GFP_ATOMIC}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj1ubh.}(hj1hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:34: ./include/linux/gfp_types.hhM=hj41ubjM)}(hXd``GFP_NOIO`` will use direct reclaim to discard clean pages or slab pages that do not require the starting of any physical IO. Please try to avoid using this flag directly and instead use memalloc_noio_{save,restore} to mark the whole scope which cannot perform any IO with a short explanation why. All allocation requests will inherit GFP_NOIO implicitly.h](jS)}(h ``GFP_NOIO``h]hGFP_NOIO}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj1ubhXX will use direct reclaim to discard clean pages or slab pages that do not require the starting of any physical IO. Please try to avoid using this flag directly and instead use memalloc_noio_{save,restore} to mark the whole scope which cannot perform any IO with a short explanation why. All allocation requests will inherit GFP_NOIO implicitly.}(hj1hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:34: ./include/linux/gfp_types.hhMBhj41ubjM)}(hXK``GFP_NOFS`` will use direct reclaim but will not use any filesystem interfaces. Please try to avoid using this flag directly and instead use memalloc_nofs_{save,restore} to mark the whole scope which cannot/shouldn't recurse into the FS layer with a short explanation why. All allocation requests will inherit GFP_NOFS implicitly.h](jS)}(h ``GFP_NOFS``h]hGFP_NOFS}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj2ubhXA will use direct reclaim but will not use any filesystem interfaces. Please try to avoid using this flag directly and instead use memalloc_nofs_{save,restore} to mark the whole scope which cannot/shouldn’t recurse into the FS layer with a short explanation why. All allocation requests will inherit GFP_NOFS implicitly.}(hj2hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:34: ./include/linux/gfp_types.hhMIhj41ubjM)}(hX``GFP_USER`` is for userspace allocations that also need to be directly accessibly by the kernel or hardware. It is typically used by hardware for buffers that are mapped to userspace (e.g. graphics) that hardware still must DMA to. cpuset limits are enforced for these allocations.h](jS)}(h ``GFP_USER``h]hGFP_USER}(hj<2hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj82ubhX is for userspace allocations that also need to be directly accessibly by the kernel or hardware. It is typically used by hardware for buffers that are mapped to userspace (e.g. graphics) that hardware still must DMA to. cpuset limits are enforced for these allocations.}(hj82hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:34: ./include/linux/gfp_types.hhMOhj41ubjM)}(hX``GFP_DMA`` exists for historical reasons and should be avoided where possible. The flags indicates that the caller requires that the lowest zone be used (``ZONE_DMA`` or 16M on x86-64). Ideally, this would be removed but it would require careful auditing as some users really require it and others use the flag to avoid lowmem reserves in ``ZONE_DMA`` and treat the lowest zone as a type of emergency reserve.h](jS)}(h ``GFP_DMA``h]hGFP_DMA}(hjY2hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjU2ubh exists for historical reasons and should be avoided where possible. The flags indicates that the caller requires that the lowest zone be used (}(hjU2hhhNhNubjS)}(h ``ZONE_DMA``h]hZONE_DMA}(hjk2hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjU2ubh or 16M on x86-64). Ideally, this would be removed but it would require careful auditing as some users really require it and others use the flag to avoid lowmem reserves in }(hjU2hhhNhNubjS)}(h ``ZONE_DMA``h]hZONE_DMA}(hj}2hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjU2ubh: and treat the lowest zone as a type of emergency reserve.}(hjU2hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:34: ./include/linux/gfp_types.hhMThj41ubjM)}(h``GFP_DMA32`` is similar to ``GFP_DMA`` except that the caller requires a 32-bit address. Note that kmalloc(..., GFP_DMA32) does not return DMA32 memory because the DMA32 kmalloc cache array is not implemented. (Reason: there is no such user in kernel).h](jS)}(h ``GFP_DMA32``h]h GFP_DMA32}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj2ubh is similar to }(hj2hhhNhNubjS)}(h ``GFP_DMA``h]hGFP_DMA}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj2ubh except that the caller requires a 32-bit address. Note that kmalloc(..., GFP_DMA32) does not return DMA32 memory because the DMA32 kmalloc cache array is not implemented. (Reason: there is no such user in kernel).}(hj2hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:34: ./include/linux/gfp_types.hhM[hj41ubjM)}(hX``GFP_HIGHUSER`` is for userspace allocations that may be mapped to userspace, do not need to be directly accessible by the kernel but that cannot move once in use. An example may be a hardware allocation that maps data directly into userspace but has no addressing limitations.h](jS)}(h``GFP_HIGHUSER``h]h GFP_HIGHUSER}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj2ubhX is for userspace allocations that may be mapped to userspace, do not need to be directly accessible by the kernel but that cannot move once in use. An example may be a hardware allocation that maps data directly into userspace but has no addressing limitations.}(hj2hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:34: ./include/linux/gfp_types.hhM`hj41ubjM)}(hX'``GFP_HIGHUSER_MOVABLE`` is for userspace allocations that the kernel does not need direct access to but can use kmap() when access is required. They are expected to be movable via page reclaim or page migration. Typically, pages on the LRU would also be allocated with ``GFP_HIGHUSER_MOVABLE``.h](jS)}(h``GFP_HIGHUSER_MOVABLE``h]hGFP_HIGHUSER_MOVABLE}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj2ubh is for userspace allocations that the kernel does not need direct access to but can use kmap() when access is required. They are expected to be movable via page reclaim or page migration. Typically, pages on the LRU would also be allocated with }(hj2hhhNhNubjS)}(h``GFP_HIGHUSER_MOVABLE``h]hGFP_HIGHUSER_MOVABLE}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj2ubh.}(hj2hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:34: ./include/linux/gfp_types.hhMehj41ubjM)}(hXh``GFP_TRANSHUGE`` and ``GFP_TRANSHUGE_LIGHT`` are used for THP allocations. They are compound allocations that will generally fail quickly if memory is not available and will not wake kswapd/kcompactd on failure. The _LIGHT version does not attempt reclaim/compaction at all and is by default used in page fault path, while the non-light is used by khugepaged.h](jS)}(h``GFP_TRANSHUGE``h]h GFP_TRANSHUGE}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj3ubh and }(hj3hhhNhNubjS)}(h``GFP_TRANSHUGE_LIGHT``h]hGFP_TRANSHUGE_LIGHT}(hj'3hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj3ubhX; are used for THP allocations. They are compound allocations that will generally fail quickly if memory is not available and will not wake kswapd/kcompactd on failure. The _LIGHT version does not attempt reclaim/compaction at all and is by default used in page fault path, while the non-light is used by khugepaged.}(hj3hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:34: ./include/linux/gfp_types.hhMjhj41ubeh}(h]useful-gfp-flag-combinationsah ]h"]useful gfp flag combinationsah$]h&]uh1hhjR.hhhNhNubeh}(h](memory-allocation-controlsjI.eh ]h"](memory allocation controlsmm-api-gfp-flagseh$]h&]uh1hhhhhhhhKexpect_referenced_by_name}jN3j>.sexpect_referenced_by_id}jI.j>.subh)}(hhh](h)}(hThe Slab Cacheh]hThe Slab Cache}(hjX3hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjU3hhhhhK&ubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hSLAB_HWCACHE_ALIGN (C macro)c.SLAB_HWCACHE_ALIGNhNtauh1hhjU3hhhNhNubh)}(hhh](h)}(hSLAB_HWCACHE_ALIGNh]h)}(hSLAB_HWCACHE_ALIGNh]h)}(hSLAB_HWCACHE_ALIGNh]j)}(hjy3h]hSLAB_HWCACHE_ALIGN}(hj3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj{3hhhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhKXubah}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjw3hhhj3hKXubah}(h]jr3ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj3hKXhjt3hhubj4)}(hhh]h}(h]h ]h"]h$]h&]uh1j3hjt3hhhj3hKXubeh}(h]h ](jAmacroeh"]h$]h&]jFjAjGj3jHj3jIjJjKuh1hhhhjU3hNhNubjM)}(h``SLAB_HWCACHE_ALIGN``h]jS)}(hj3h]hSLAB_HWCACHE_ALIGN}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj3ubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhKZhjU3hhubji)}(hX Align objects on cache line boundaries. **Description** Sufficiently large objects are aligned on cache line boundary. For object size smaller than a half of cache line size, the alignment is on the half of cache line size. In general, if object size is smaller than 1/2^n of cache line size, the alignment is adjusted to 1/2^n. If explicit alignment is also requested by the respective :c:type:`struct kmem_cache_args ` field, the greater of both is alignments is applied. h](ji)}(h(Align objects on cache line boundaries. h]jM)}(h'Align objects on cache line boundaries.h]h'Align objects on cache line boundaries.}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhKXhj3ubah}(h]h ]h"]h$]h&]uh1jhhj3hKXhj3ubjM)}(h**Description**h]j)}(hj3h]h Description}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj3ubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhKZhj3ubjM)}(hXSufficiently large objects are aligned on cache line boundary. For object size smaller than a half of cache line size, the alignment is on the half of cache line size. In general, if object size is smaller than 1/2^n of cache line size, the alignment is adjusted to 1/2^n.h]hXSufficiently large objects are aligned on cache line boundary. For object size smaller than a half of cache line size, the alignment is on the half of cache line size. In general, if object size is smaller than 1/2^n of cache line size, the alignment is adjusted to 1/2^n.}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhKYhj3ubjM)}(hIf explicit alignment is also requested by the respective :c:type:`struct kmem_cache_args ` field, the greater of both is alignments is applied.h](h:If explicit alignment is also requested by the respective }(hj4hhhNhNubh)}(h2:c:type:`struct kmem_cache_args `h]jS)}(hj4h]hstruct kmem_cache_args}(hj4hhhNhNubah}(h]h ](xrefjAc-typeeh"]h$]h&]uh1jRhj4ubah}(h]h ]h"]h$]h&]refdoccore-api/mm-api refdomainjAreftypetype refexplicitrefwarnjj)}j]sb reftargetkmem_cache_argsuh1hhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhK^hj4ubh5 field, the greater of both is alignments is applied.}(hj4hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhj<4hK^hj3ubeh}(h]h ]h"]h$]h&]uh1jhhj3hKXhjU3hhubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hSLAB_TYPESAFE_BY_RCU (C macro)c.SLAB_TYPESAFE_BY_RCUhNtauh1hhjU3hhhNhNubh)}(hhh](h)}(hSLAB_TYPESAFE_BY_RCUh]h)}(hSLAB_TYPESAFE_BY_RCUh]h)}(hSLAB_TYPESAFE_BY_RCUh]j)}(hj`4h]hSLAB_TYPESAFE_BY_RCU}(hjj4hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjf4ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjb4hhhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhKlubah}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj^4hhhj}4hKlubah}(h]jY4ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj}4hKlhj[4hhubj4)}(hhh]h}(h]h ]h"]h$]h&]uh1j3hj[4hhhj}4hKlubeh}(h]h ](jAmacroeh"]h$]h&]jFjAjGj4jHj4jIjJ jKuh1hhhhjU3hNhNubjM)}(h``SLAB_TYPESAFE_BY_RCU``h]jS)}(hj4h]hSLAB_TYPESAFE_BY_RCU}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj4ubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhKnhjU3hhubji)}(hX **WARNING** READ THIS! **Description** This delays freeing the SLAB page by a grace period, it does _NOT_ delay object freeing. This means that if you do kmem_cache_free() that memory location is free to be reused at any time. Thus it may be possible to see another object there in the same RCU grace period. This feature only ensures the memory location backing the object stays valid, the trick to using this is relying on an independent object validation pass. Something like: :: begin: rcu_read_lock(); obj = lockless_lookup(key); if (obj) { if (!try_get_ref(obj)) // might fail for free objects rcu_read_unlock(); goto begin; if (obj->key != key) { // not the object we expected put_ref(obj); rcu_read_unlock(); goto begin; } } rcu_read_unlock(); This is useful if we need to approach a kernel structure obliquely, from its address obtained without the usual locking. We can lock the structure to stabilize it and check it's still at the given address, only if we can be sure that the memory has not been meanwhile reused for some other kind of object (which our subsystem's lock might corrupt). rcu_read_lock before reading the address, then rcu_read_unlock after taking the spinlock within the structure expected at that address. Note that object identity check has to be done *after* acquiring a reference, therefore user has to ensure proper ordering for loads. Similarly, when initializing objects allocated with SLAB_TYPESAFE_BY_RCU, the newly allocated object has to be fully initialized *before* its refcount gets initialized and proper ordering for stores is required. refcount_{add|inc}_not_zero_acquire() and refcount_set_release() are designed with the proper fences required for reference counting objects allocated with SLAB_TYPESAFE_BY_RCU. Note that it is not possible to acquire a lock within a structure allocated with SLAB_TYPESAFE_BY_RCU without first acquiring a reference as described above. The reason is that SLAB_TYPESAFE_BY_RCU pages are not zeroed before being given to the slab, which means that any locks must be initialized after each and every kmem_struct_alloc(). Alternatively, make the ctor passed to kmem_cache_create() initialize the locks at page-allocation time, as is done in __i915_request_ctor(), sighand_ctor(), and anon_vma_ctor(). Such a ctor permits readers to safely acquire those ctor-initialized locks under rcu_read_lock() protection. Note that SLAB_TYPESAFE_BY_RCU was originally named SLAB_DESTROY_BY_RCU. h](ji)}(h**WARNING** READ THIS! h]jM)}(h**WARNING** READ THIS!h](j)}(h **WARNING**h]hWARNING}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj4ubh READ THIS!}(hj4hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhKlhj4ubah}(h]h ]h"]h$]h&]uh1jhhj4hKlhj4ubjM)}(h**Description**h]j)}(hj4h]h Description}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj4ubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhKnhj4ubjM)}(hX This delays freeing the SLAB page by a grace period, it does _NOT_ delay object freeing. This means that if you do kmem_cache_free() that memory location is free to be reused at any time. Thus it may be possible to see another object there in the same RCU grace period.h]hX This delays freeing the SLAB page by a grace period, it does _NOT_ delay object freeing. This means that if you do kmem_cache_free() that memory location is free to be reused at any time. Thus it may be possible to see another object there in the same RCU grace period.}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhKmhj4ubjM)}(hThis feature only ensures the memory location backing the object stays valid, the trick to using this is relying on an independent object validation pass. Something like:h]hThis feature only ensures the memory location backing the object stays valid, the trick to using this is relying on an independent object validation pass. Something like:}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhKrhj4ubj7 )}(hX3begin: rcu_read_lock(); obj = lockless_lookup(key); if (obj) { if (!try_get_ref(obj)) // might fail for free objects rcu_read_unlock(); goto begin; if (obj->key != key) { // not the object we expected put_ref(obj); rcu_read_unlock(); goto begin; } } rcu_read_unlock();h]hX3begin: rcu_read_lock(); obj = lockless_lookup(key); if (obj) { if (!try_get_ref(obj)) // might fail for free objects rcu_read_unlock(); goto begin; if (obj->key != key) { // not the object we expected put_ref(obj); rcu_read_unlock(); goto begin; } } rcu_read_unlock();}hj5sbah}(h]h ]h"]h$]h&]jjuh1j6 hT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhKxhj4ubjM)}(hX\This is useful if we need to approach a kernel structure obliquely, from its address obtained without the usual locking. We can lock the structure to stabilize it and check it's still at the given address, only if we can be sure that the memory has not been meanwhile reused for some other kind of object (which our subsystem's lock might corrupt).h]hX`This is useful if we need to approach a kernel structure obliquely, from its address obtained without the usual locking. We can lock the structure to stabilize it and check it’s still at the given address, only if we can be sure that the memory has not been meanwhile reused for some other kind of object (which our subsystem’s lock might corrupt).}(hj"5hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhKhj4ubjM)}(hrcu_read_lock before reading the address, then rcu_read_unlock after taking the spinlock within the structure expected at that address.h]hrcu_read_lock before reading the address, then rcu_read_unlock after taking the spinlock within the structure expected at that address.}(hj15hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhKhj4ubjM)}(hX Note that object identity check has to be done *after* acquiring a reference, therefore user has to ensure proper ordering for loads. Similarly, when initializing objects allocated with SLAB_TYPESAFE_BY_RCU, the newly allocated object has to be fully initialized *before* its refcount gets initialized and proper ordering for stores is required. refcount_{add|inc}_not_zero_acquire() and refcount_set_release() are designed with the proper fences required for reference counting objects allocated with SLAB_TYPESAFE_BY_RCU.h](h/Note that object identity check has to be done }(hj@5hhhNhNubj )}(h*after*h]hafter}(hjH5hhhNhNubah}(h]h ]h"]h$]h&]uh1j hj@5ubh acquiring a reference, therefore user has to ensure proper ordering for loads. Similarly, when initializing objects allocated with SLAB_TYPESAFE_BY_RCU, the newly allocated object has to be fully initialized }(hj@5hhhNhNubj )}(h*before*h]hbefore}(hjZ5hhhNhNubah}(h]h ]h"]h$]h&]uh1j hj@5ubh its refcount gets initialized and proper ordering for stores is required. refcount_{add|inc}_not_zero_acquire() and refcount_set_release() are designed with the proper fences required for reference counting objects allocated with SLAB_TYPESAFE_BY_RCU.}(hj@5hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhKhj4ubjM)}(hXuNote that it is not possible to acquire a lock within a structure allocated with SLAB_TYPESAFE_BY_RCU without first acquiring a reference as described above. The reason is that SLAB_TYPESAFE_BY_RCU pages are not zeroed before being given to the slab, which means that any locks must be initialized after each and every kmem_struct_alloc(). Alternatively, make the ctor passed to kmem_cache_create() initialize the locks at page-allocation time, as is done in __i915_request_ctor(), sighand_ctor(), and anon_vma_ctor(). Such a ctor permits readers to safely acquire those ctor-initialized locks under rcu_read_lock() protection.h]hXuNote that it is not possible to acquire a lock within a structure allocated with SLAB_TYPESAFE_BY_RCU without first acquiring a reference as described above. The reason is that SLAB_TYPESAFE_BY_RCU pages are not zeroed before being given to the slab, which means that any locks must be initialized after each and every kmem_struct_alloc(). Alternatively, make the ctor passed to kmem_cache_create() initialize the locks at page-allocation time, as is done in __i915_request_ctor(), sighand_ctor(), and anon_vma_ctor(). Such a ctor permits readers to safely acquire those ctor-initialized locks under rcu_read_lock() protection.}(hjs5hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhKhj4ubjM)}(hHNote that SLAB_TYPESAFE_BY_RCU was originally named SLAB_DESTROY_BY_RCU.h]hHNote that SLAB_TYPESAFE_BY_RCU was originally named SLAB_DESTROY_BY_RCU.}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhKhj4ubeh}(h]h ]h"]h$]h&]uh1jhhj4hKlhjU3hhubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hSLAB_ACCOUNT (C macro)c.SLAB_ACCOUNThNtauh1hhjU3hhhNhNubh)}(hhh](h)}(h SLAB_ACCOUNTh]h)}(h SLAB_ACCOUNTh]h)}(h SLAB_ACCOUNTh]j)}(hj5h]h SLAB_ACCOUNT}(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj5hhhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhKubah}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj5hhhj5hKubah}(h]j5ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj5hKhj5hhubj4)}(hhh]h}(h]h ]h"]h$]h&]uh1j3hj5hhhj5hKubeh}(h]h ](jAmacroeh"]h$]h&]jFjAjGj5jHj5jIjJjKuh1hhhhjU3hNhNubjM)}(h``SLAB_ACCOUNT``h]jS)}(hj5h]h SLAB_ACCOUNT}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj5ubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhKhjU3hhubji)}(h Account allocations to memcg. **Description** All object allocations from this cache will be memcg accounted, regardless of __GFP_ACCOUNT being or not being passed to individual allocations. h](ji)}(hAccount allocations to memcg. h]jM)}(hAccount allocations to memcg.h]hAccount allocations to memcg.}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhKhj6ubah}(h]h ]h"]h$]h&]uh1jhhj6hKhj5ubjM)}(h**Description**h]j)}(hj6h]h Description}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj6ubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhKhj5ubjM)}(hAll object allocations from this cache will be memcg accounted, regardless of __GFP_ACCOUNT being or not being passed to individual allocations.h]hAll object allocations from this cache will be memcg accounted, regardless of __GFP_ACCOUNT being or not being passed to individual allocations.}(hj16hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhKhj5ubeh}(h]h ]h"]h$]h&]uh1jhhj6hKhjU3hhubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hSLAB_RECLAIM_ACCOUNT (C macro)c.SLAB_RECLAIM_ACCOUNThNtauh1hhjU3hhhNhNubh)}(hhh](h)}(hSLAB_RECLAIM_ACCOUNTh]h)}(hSLAB_RECLAIM_ACCOUNTh]h)}(hSLAB_RECLAIM_ACCOUNTh]j)}(hjY6h]hSLAB_RECLAIM_ACCOUNT}(hjc6hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj_6ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj[6hhhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhKubah}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjW6hhhjv6hKubah}(h]jR6ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjv6hKhjT6hhubj4)}(hhh]h}(h]h ]h"]h$]h&]uh1j3hjT6hhhjv6hKubeh}(h]h ](jAmacroeh"]h$]h&]jFjAjGj6jHj6jIjJjKuh1hhhhjU3hNhNubjM)}(h``SLAB_RECLAIM_ACCOUNT``h]jS)}(hj6h]hSLAB_RECLAIM_ACCOUNT}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj6ubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhKhjU3hhubji)}(hX  Objects are reclaimable. **Description** Use this flag for caches that have an associated shrinker. As a result, slab pages are allocated with __GFP_RECLAIMABLE, which affects grouping pages by mobility, and are accounted in SReclaimable counter in /proc/meminfo h](ji)}(hObjects are reclaimable. h]jM)}(hObjects are reclaimable.h]hObjects are reclaimable.}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhKhj6ubah}(h]h ]h"]h$]h&]uh1jhhj6hKhj6ubjM)}(h**Description**h]j)}(hj6h]h Description}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj6ubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhKhj6ubjM)}(hUse this flag for caches that have an associated shrinker. As a result, slab pages are allocated with __GFP_RECLAIMABLE, which affects grouping pages by mobility, and are accounted in SReclaimable counter in /proc/meminfoh]hUse this flag for caches that have an associated shrinker. As a result, slab pages are allocated with __GFP_RECLAIMABLE, which affects grouping pages by mobility, and are accounted in SReclaimable counter in /proc/meminfo}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhKhj6ubeh}(h]h ]h"]h$]h&]uh1jhhj6hKhjU3hhubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hkmem_cache_args (C struct)c.kmem_cache_argshNtauh1hhjU3hhhNhNubh)}(hhh](h)}(hkmem_cache_argsh]h)}(hstruct kmem_cache_argsh](j)}(hjJ,h]hstruct}(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj 7hhhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhKubj)}(h h]h }(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj 7hhhj7hKubh)}(hkmem_cache_argsh]j)}(hj7h]hkmem_cache_args}(hj.7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*7ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj 7hhhj7hKubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj7hhhj7hKubah}(h]j7ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj7hKhj7hhubj4)}(hhh]jM)}(h-Less common arguments for kmem_cache_create()h]h-Less common arguments for kmem_cache_create()}(hjP7hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhjM7hhubah}(h]h ]h"]h$]h&]uh1j3hj7hhhj7hKubeh}(h]h ](jAstructeh"]h$]h&]jFjAjGjh7jHjh7jIjJjKuh1hhhhjU3hNhNubj)}(hX **Definition**:: struct kmem_cache_args { unsigned int align; unsigned int useroffset; unsigned int usersize; unsigned int freeptr_offset; bool use_freeptr_offset; void (*ctor)(void *); unsigned int sheaf_capacity; }; **Members** ``align`` The required alignment for the objects. ``0`` means no specific alignment is requested. ``useroffset`` Usercopy region offset. ``0`` is a valid offset, when **usersize** is non-``0`` ``usersize`` Usercopy region size. ``0`` means no usercopy region is specified. ``freeptr_offset`` Custom offset for the free pointer in caches with :c:type:`SLAB_TYPESAFE_BY_RCU` or **ctor** By default, :c:type:`SLAB_TYPESAFE_BY_RCU` and **ctor** caches place the free pointer outside of the object. This might cause the object to grow in size. Cache creators that have a reason to avoid this can specify a custom free pointer offset in their data structure where the free pointer will be placed. For caches with :c:type:`SLAB_TYPESAFE_BY_RCU`, the caller must ensure that the free pointer does not overlay fields required to guard against object recycling (See :c:type:`SLAB_TYPESAFE_BY_RCU` for details). For caches with **ctor**, the caller must ensure that the free pointer does not overlay fields initialized by the constructor. Currently, only caches with :c:type:`SLAB_TYPESAFE_BY_RCU` or **ctor** may specify **freeptr_offset**. Using ``0`` as a value for **freeptr_offset** is valid. If **freeptr_offset** is specified, **use_freeptr_offset** must be set ``true``. ``use_freeptr_offset`` Whether a **freeptr_offset** is used. ``ctor`` A constructor for the objects. The constructor is invoked for each object in a newly allocated slab page. It is the cache user's responsibility to free object in the same state as after calling the constructor, or deal appropriately with any differences between a freshly constructed and a reallocated object. ``NULL`` means no constructor. ``sheaf_capacity`` Enable sheaves of given capacity for the cache. With a non-zero value, allocations from the cache go through caching arrays called sheaves. Each cpu has a main sheaf that's always present, and a spare sheaf that may be not present. When both become empty, there's an attempt to replace an empty sheaf with a full sheaf from the per-node barn. When no full sheaf is available, and gfp flags allow blocking, a sheaf is allocated and filled from slab(s) using bulk allocation. Otherwise the allocation falls back to the normal operation allocating a single object from a slab. Analogically when freeing and both percpu sheaves are full, the barn may replace it with an empty sheaf, unless it's over capacity. In that case a sheaf is bulk freed to slab pages. The sheaves do not enforce NUMA placement of objects, so allocations via kmem_cache_alloc_node() with a node specified other than NUMA_NO_NODE will bypass them. Bulk allocation and free operations also try to use the cpu sheaves and barn, but fallback to using slab pages directly. When slub_debug is enabled for the cache, the sheaf_capacity argument is ignored. ``0`` means no sheaves will be created.h](jM)}(h**Definition**::h](j)}(h**Definition**h]h Definition}(hjt7hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjp7ubh:}(hjp7hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhM"hjl7ubj7 )}(hstruct kmem_cache_args { unsigned int align; unsigned int useroffset; unsigned int usersize; unsigned int freeptr_offset; bool use_freeptr_offset; void (*ctor)(void *); unsigned int sheaf_capacity; };h]hstruct kmem_cache_args { unsigned int align; unsigned int useroffset; unsigned int usersize; unsigned int freeptr_offset; bool use_freeptr_offset; void (*ctor)(void *); unsigned int sheaf_capacity; };}hj7sbah}(h]h ]h"]h$]h&]jjuh1j6 hT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhM$hjl7ubjM)}(h **Members**h]j)}(hj7h]hMembers}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj7ubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhM.hjl7ubj)}(hhh](j)}(hc``align`` The required alignment for the objects. ``0`` means no specific alignment is requested. h](j)}(h ``align``h]jS)}(hj7h]halign}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj7ubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhM.hj7ubj)}(hhh](jM)}(h'The required alignment for the objects.h]h'The required alignment for the objects.}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhM,hj7ubjM)}(h/``0`` means no specific alignment is requested.h](jS)}(h``0``h]h0}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj7ubh* means no specific alignment is requested.}(hj7hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhj7hM.hj7ubeh}(h]h ]h"]h$]h&]uh1jhj7ubeh}(h]h ]h"]h$]h&]uh1jhj7hM.hj7ubj)}(h```useroffset`` Usercopy region offset. ``0`` is a valid offset, when **usersize** is non-``0`` h](j)}(h``useroffset``h]jS)}(hj8h]h useroffset}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj8ubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhM4hj 8ubj)}(hhh](jM)}(hUsercopy region offset.h]hUsercopy region offset.}(hj,8hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhM2hj)8ubjM)}(h7``0`` is a valid offset, when **usersize** is non-``0``h](jS)}(h``0``h]h0}(hj?8hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj;8ubh is a valid offset, when }(hj;8hhhNhNubj)}(h **usersize**h]husersize}(hjQ8hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj;8ubh is non-}(hj;8hhhNhNubjS)}(h``0``h]h0}(hjc8hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj;8ubeh}(h]h ]h"]h$]h&]uh1jLhj(8hM4hj)8ubeh}(h]h ]h"]h$]h&]uh1jhj 8ubeh}(h]h ]h"]h$]h&]uh1jhj(8hM4hj7ubj)}(hQ``usersize`` Usercopy region size. ``0`` means no usercopy region is specified. h](j)}(h ``usersize``h]jS)}(hj8h]husersize}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj8ubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhM:hj8ubj)}(hhh](jM)}(hUsercopy region size.h]hUsercopy region size.}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhM8hj8ubjM)}(h,``0`` means no usercopy region is specified.h](jS)}(h``0``h]h0}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj8ubh' means no usercopy region is specified.}(hj8hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhj8hM:hj8ubeh}(h]h ]h"]h$]h&]uh1jhj8ubeh}(h]h ]h"]h$]h&]uh1jhj8hM:hj7ubj)}(hX``freeptr_offset`` Custom offset for the free pointer in caches with :c:type:`SLAB_TYPESAFE_BY_RCU` or **ctor** By default, :c:type:`SLAB_TYPESAFE_BY_RCU` and **ctor** caches place the free pointer outside of the object. This might cause the object to grow in size. Cache creators that have a reason to avoid this can specify a custom free pointer offset in their data structure where the free pointer will be placed. For caches with :c:type:`SLAB_TYPESAFE_BY_RCU`, the caller must ensure that the free pointer does not overlay fields required to guard against object recycling (See :c:type:`SLAB_TYPESAFE_BY_RCU` for details). For caches with **ctor**, the caller must ensure that the free pointer does not overlay fields initialized by the constructor. Currently, only caches with :c:type:`SLAB_TYPESAFE_BY_RCU` or **ctor** may specify **freeptr_offset**. Using ``0`` as a value for **freeptr_offset** is valid. If **freeptr_offset** is specified, **use_freeptr_offset** must be set ``true``. h](j)}(h``freeptr_offset``h]jS)}(hj8h]hfreeptr_offset}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj8ubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMRhj8ubj)}(hhh](jM)}(h\Custom offset for the free pointer in caches with :c:type:`SLAB_TYPESAFE_BY_RCU` or **ctor**h](h2Custom offset for the free pointer in caches with }(hj8hhhNhNubh)}(h:c:type:`SLAB_TYPESAFE_BY_RCU`h]jS)}(hj9h]hSLAB_TYPESAFE_BY_RCU}(hj9hhhNhNubah}(h]h ](j%4jAc-typeeh"]h$]h&]uh1jRhj9ubah}(h]h ]h"]h$]h&]refdocj14 refdomainjAreftypetype refexplicitrefwarnjj74j:4SLAB_TYPESAFE_BY_RCUuh1hhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhM>hj8ubh or }(hj8hhhNhNubj)}(h**ctor**h]hctor}(hj$9hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj8ubeh}(h]h ]h"]h$]h&]uh1jLhj9hM>hj8ubjM)}(hX1By default, :c:type:`SLAB_TYPESAFE_BY_RCU` and **ctor** caches place the free pointer outside of the object. This might cause the object to grow in size. Cache creators that have a reason to avoid this can specify a custom free pointer offset in their data structure where the free pointer will be placed.h](h By default, }(hj89hhhNhNubh)}(h:c:type:`SLAB_TYPESAFE_BY_RCU`h]jS)}(hjB9h]hSLAB_TYPESAFE_BY_RCU}(hjD9hhhNhNubah}(h]h ](j%4jAc-typeeh"]h$]h&]uh1jRhj@9ubah}(h]h ]h"]h$]h&]refdocj14 refdomainjAreftypetype refexplicitrefwarnjj74j:4SLAB_TYPESAFE_BY_RCUuh1hhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMAhj89ubh and }(hj89hhhNhNubj)}(h**ctor**h]hctor}(hjd9hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj89ubh caches place the free pointer outside of the object. This might cause the object to grow in size. Cache creators that have a reason to avoid this can specify a custom free pointer offset in their data structure where the free pointer will be placed.}(hj89hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhj_9hMAhj8ubjM)}(hFor caches with :c:type:`SLAB_TYPESAFE_BY_RCU`, the caller must ensure that the free pointer does not overlay fields required to guard against object recycling (See :c:type:`SLAB_TYPESAFE_BY_RCU` for details).h](hFor caches with }(hj|9hhhNhNubh)}(h:c:type:`SLAB_TYPESAFE_BY_RCU`h]jS)}(hj9h]hSLAB_TYPESAFE_BY_RCU}(hj9hhhNhNubah}(h]h ](j%4jAc-typeeh"]h$]h&]uh1jRhj9ubah}(h]h ]h"]h$]h&]refdocj14 refdomainjAreftypetype refexplicitrefwarnjj74j:4SLAB_TYPESAFE_BY_RCUuh1hhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMGhj|9ubhw, the caller must ensure that the free pointer does not overlay fields required to guard against object recycling (See }(hj|9hhhNhNubh)}(h:c:type:`SLAB_TYPESAFE_BY_RCU`h]jS)}(hj9h]hSLAB_TYPESAFE_BY_RCU}(hj9hhhNhNubah}(h]h ](j%4jAc-typeeh"]h$]h&]uh1jRhj9ubah}(h]h ]h"]h$]h&]refdocj14 refdomainjAreftypetype refexplicitrefwarnjj74j:4SLAB_TYPESAFE_BY_RCUuh1hhj9hMGhj|9ubh for details).}(hj|9hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhj9hMGhj8ubjM)}(h~For caches with **ctor**, the caller must ensure that the free pointer does not overlay fields initialized by the constructor.h](hFor caches with }(hj9hhhNhNubj)}(h**ctor**h]hctor}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj9ubhf, the caller must ensure that the free pointer does not overlay fields initialized by the constructor.}(hj9hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMKhj8ubjM)}(hfCurrently, only caches with :c:type:`SLAB_TYPESAFE_BY_RCU` or **ctor** may specify **freeptr_offset**.h](hCurrently, only caches with }(hj9hhhNhNubh)}(h:c:type:`SLAB_TYPESAFE_BY_RCU`h]jS)}(hj9h]hSLAB_TYPESAFE_BY_RCU}(hj9hhhNhNubah}(h]h ](j%4jAc-typeeh"]h$]h&]uh1jRhj9ubah}(h]h ]h"]h$]h&]refdocj14 refdomainjAreftypetype refexplicitrefwarnjj74j:4SLAB_TYPESAFE_BY_RCUuh1hhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMNhj9ubh or }(hj9hhhNhNubj)}(h**ctor**h]hctor}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj9ubh may specify }(hj9hhhNhNubj)}(h**freeptr_offset**h]hfreeptr_offset}(hj0:hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj9ubh.}(hj9hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhj:hMNhj8ubjM)}(hUsing ``0`` as a value for **freeptr_offset** is valid. If **freeptr_offset** is specified, **use_freeptr_offset** must be set ``true``.h](hUsing }(hjH:hhhNhNubjS)}(h``0``h]h0}(hjP:hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjH:ubh as a value for }(hjH:hhhNhNubj)}(h**freeptr_offset**h]hfreeptr_offset}(hjb:hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjH:ubh is valid. If }(hjH:hhhNhNubj)}(h**freeptr_offset**h]hfreeptr_offset}(hjt:hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjH:ubh is specified, }(hjH:hhhNhNubj)}(h**use_freeptr_offset**h]huse_freeptr_offset}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjH:ubh must be set }(hjH:hhhNhNubjS)}(h``true``h]htrue}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjH:ubh.}(hjH:hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMQhj8ubeh}(h]h ]h"]h$]h&]uh1jhj8ubeh}(h]h ]h"]h$]h&]uh1jhj8hMRhj7ubj)}(h=``use_freeptr_offset`` Whether a **freeptr_offset** is used. h](j)}(h``use_freeptr_offset``h]jS)}(hj:h]huse_freeptr_offset}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj:ubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMVhj:ubj)}(hhh]jM)}(h%Whether a **freeptr_offset** is used.h](h Whether a }(hj:hhhNhNubj)}(h**freeptr_offset**h]hfreeptr_offset}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj:ubh is used.}(hj:hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhj:hMVhj:ubah}(h]h ]h"]h$]h&]uh1jhj:ubeh}(h]h ]h"]h$]h&]uh1jhj:hMVhj7ubj)}(hX```ctor`` A constructor for the objects. The constructor is invoked for each object in a newly allocated slab page. It is the cache user's responsibility to free object in the same state as after calling the constructor, or deal appropriately with any differences between a freshly constructed and a reallocated object. ``NULL`` means no constructor. h](j)}(h``ctor``h]jS)}(hj;h]hctor}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj ;ubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMbhj;ubj)}(hhh](jM)}(hA constructor for the objects.h]hA constructor for the objects.}(hj';hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMZhj$;ubjM)}(hXThe constructor is invoked for each object in a newly allocated slab page. It is the cache user's responsibility to free object in the same state as after calling the constructor, or deal appropriately with any differences between a freshly constructed and a reallocated object.h]hXThe constructor is invoked for each object in a newly allocated slab page. It is the cache user’s responsibility to free object in the same state as after calling the constructor, or deal appropriately with any differences between a freshly constructed and a reallocated object.}(hj6;hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhM\hj$;ubjM)}(h``NULL`` means no constructor.h](jS)}(h``NULL``h]hNULL}(hjI;hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjE;ubh means no constructor.}(hjE;hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhj#;hMbhj$;ubeh}(h]h ]h"]h$]h&]uh1jhj;ubeh}(h]h ]h"]h$]h&]uh1jhj#;hMbhj7ubj)}(hX``sheaf_capacity`` Enable sheaves of given capacity for the cache. With a non-zero value, allocations from the cache go through caching arrays called sheaves. Each cpu has a main sheaf that's always present, and a spare sheaf that may be not present. When both become empty, there's an attempt to replace an empty sheaf with a full sheaf from the per-node barn. When no full sheaf is available, and gfp flags allow blocking, a sheaf is allocated and filled from slab(s) using bulk allocation. Otherwise the allocation falls back to the normal operation allocating a single object from a slab. Analogically when freeing and both percpu sheaves are full, the barn may replace it with an empty sheaf, unless it's over capacity. In that case a sheaf is bulk freed to slab pages. The sheaves do not enforce NUMA placement of objects, so allocations via kmem_cache_alloc_node() with a node specified other than NUMA_NO_NODE will bypass them. Bulk allocation and free operations also try to use the cpu sheaves and barn, but fallback to using slab pages directly. When slub_debug is enabled for the cache, the sheaf_capacity argument is ignored. ``0`` means no sheaves will be created.h](j)}(h``sheaf_capacity``h]jS)}(hjs;h]hsheaf_capacity}(hju;hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjq;ubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhjm;ubj)}(hhh](jM)}(h/Enable sheaves of given capacity for the cache.h]h/Enable sheaves of given capacity for the cache.}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMfhj;ubjM)}(hX&With a non-zero value, allocations from the cache go through caching arrays called sheaves. Each cpu has a main sheaf that's always present, and a spare sheaf that may be not present. When both become empty, there's an attempt to replace an empty sheaf with a full sheaf from the per-node barn.h]hX*With a non-zero value, allocations from the cache go through caching arrays called sheaves. Each cpu has a main sheaf that’s always present, and a spare sheaf that may be not present. When both become empty, there’s an attempt to replace an empty sheaf with a full sheaf from the per-node barn.}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhhj;ubjM)}(hWhen no full sheaf is available, and gfp flags allow blocking, a sheaf is allocated and filled from slab(s) using bulk allocation. Otherwise the allocation falls back to the normal operation allocating a single object from a slab.h]hWhen no full sheaf is available, and gfp flags allow blocking, a sheaf is allocated and filled from slab(s) using bulk allocation. Otherwise the allocation falls back to the normal operation allocating a single object from a slab.}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMnhj;ubjM)}(hAnalogically when freeing and both percpu sheaves are full, the barn may replace it with an empty sheaf, unless it's over capacity. In that case a sheaf is bulk freed to slab pages.h]hAnalogically when freeing and both percpu sheaves are full, the barn may replace it with an empty sheaf, unless it’s over capacity. In that case a sheaf is bulk freed to slab pages.}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMshj;ubjM)}(hThe sheaves do not enforce NUMA placement of objects, so allocations via kmem_cache_alloc_node() with a node specified other than NUMA_NO_NODE will bypass them.h]hThe sheaves do not enforce NUMA placement of objects, so allocations via kmem_cache_alloc_node() with a node specified other than NUMA_NO_NODE will bypass them.}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMwhj;ubjM)}(hxBulk allocation and free operations also try to use the cpu sheaves and barn, but fallback to using slab pages directly.h]hxBulk allocation and free operations also try to use the cpu sheaves and barn, but fallback to using slab pages directly.}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhM{hj;ubjM)}(hQWhen slub_debug is enabled for the cache, the sheaf_capacity argument is ignored.h]hQWhen slub_debug is enabled for the cache, the sheaf_capacity argument is ignored.}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhM~hj;ubjM)}(h'``0`` means no sheaves will be created.h](jS)}(h``0``h]h0}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj;ubh" means no sheaves will be created.}(hj;hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhj;ubeh}(h]h ]h"]h$]h&]uh1jhjm;ubeh}(h]h ]h"]h$]h&]uh1jhj;hMhj7ubeh}(h]h ]h"]h$]h&]uh1jhjl7ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjU3hhhNhNubjM)}(h**Description**h]j)}(hj-<h]h Description}(hj/<hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj+<ubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhjU3hhubjM)}(hX4Any uninitialized fields of the structure are interpreted as unused. The exception is **freeptr_offset** where ``0`` is a valid value, so **use_freeptr_offset** must be also set to ``true`` in order to interpret the field as used. For **useroffset** ``0`` is also valid, but only with non-``0`` **usersize**.h](hVAny uninitialized fields of the structure are interpreted as unused. The exception is }(hjC<hhhNhNubj)}(h**freeptr_offset**h]hfreeptr_offset}(hjK<hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjC<ubh where }(hjC<hhhNhNubjS)}(h``0``h]h0}(hj]<hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjC<ubh is a valid value, so }(hjC<hhhNhNubj)}(h**use_freeptr_offset**h]huse_freeptr_offset}(hjo<hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjC<ubh must be also set to }(hjC<hhhNhNubjS)}(h``true``h]htrue}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjC<ubh. in order to interpret the field as used. For }(hjC<hhhNhNubj)}(h**useroffset**h]h useroffset}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjC<ubh }(hjC<hhhNhNubjS)}(h``0``h]h0}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjC<ubh" is also valid, but only with non-}(hjC<hhhNhNubjS)}(h``0``h]h0}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjC<ubh }(hjC<hhhNhNubj)}(h **usersize**h]husersize}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjC<ubh.}(hjC<hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhjU3hhubjM)}(h[When ``NULL`` args is passed to kmem_cache_create(), it is equivalent to all fields unused.h](hWhen }(hj<hhhNhNubjS)}(h``NULL``h]hNULL}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj<ubhN args is passed to kmem_cache_create(), it is equivalent to all fields unused.}(hj<hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhM%hjU3hhubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h'kmem_cache_create_usercopy (C function)c.kmem_cache_create_usercopyhNtauh1hhjU3hhhNhNubh)}(hhh](h)}(hstruct kmem_cache * kmem_cache_create_usercopy (const char *name, unsigned int size, unsigned int align, slab_flags_t flags, unsigned int useroffset, unsigned int usersize, void (*ctor)(void *))h]h)}(hstruct kmem_cache *kmem_cache_create_usercopy(const char *name, unsigned int size, unsigned int align, slab_flags_t flags, unsigned int useroffset, unsigned int usersize, void (*ctor)(void*))h](j)}(hjJ,h]hstruct}(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=hhhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMubj)}(h h]h }(hj*=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=hhhj)=hMubh)}(hhh]j)}(h kmem_cacheh]h kmem_cache}(hj;=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj8=ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj==modnameN classnameNjj)}j]j)}jkmem_cache_create_usercopysbc.kmem_cache_create_usercopyasbuh1hhj=hhhj)=hMubj)}(h h]h }(hj\=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=hhhj)=hMubjr)}(hjuh]h*}(hjj=hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj=hhhj)=hMubh)}(hkmem_cache_create_usercopyh]j)}(hjY=h]hkmem_cache_create_usercopy}(hj{=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjw=ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj=hhhj)=hMubj8)}(h(const char *name, unsigned int size, unsigned int align, slab_flags_t flags, unsigned int useroffset, unsigned int usersize, void (*ctor)(void*))h](j>)}(hconst char *nameh](j)}(hjh]hconst}(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=ubj)}(h h]h }(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=ubj)}(hcharh]hchar}(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=ubj)}(h h]h }(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=ubjr)}(hjuh]h*}(hj=hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj=ubj)}(hnameh]hname}(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj=ubj>)}(hunsigned int sizeh](j)}(hunsignedh]hunsigned}(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=ubj)}(h h]h }(hj>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=ubj)}(hinth]hint}(hj>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=ubj)}(h h]h }(hj>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=ubj)}(hsizeh]hsize}(hj+>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj=ubj>)}(hunsigned int alignh](j)}(hunsignedh]hunsigned}(hjD>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@>ubj)}(h h]h }(hjR>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@>ubj)}(hinth]hint}(hj`>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@>ubj)}(h h]h }(hjn>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@>ubj)}(halignh]halign}(hj|>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@>ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj=ubj>)}(hslab_flags_t flagsh](h)}(hhh]j)}(h slab_flags_th]h slab_flags_t}(hj>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj>modnameN classnameNjj)}j]jW=c.kmem_cache_create_usercopyasbuh1hhj>ubj)}(h h]h }(hj>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>ubj)}(hflagsh]hflags}(hj>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj=ubj>)}(hunsigned int useroffseth](j)}(hunsignedh]hunsigned}(hj>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>ubj)}(h h]h }(hj>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>ubj)}(hinth]hint}(hj>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>ubj)}(h h]h }(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>ubj)}(h useroffseth]h useroffset}(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj=ubj>)}(hunsigned int usersizeh](j)}(hunsignedh]hunsigned}(hj.?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*?ubj)}(h h]h }(hj)}(hvoid (*ctor)(void*)h](j)}(hvoidh]hvoid}(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{?ubj)}(h h]h }(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{?ubjr)}(h(h]h(}(hj?hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj{?ubjr)}(hjuh]h*}(hj?hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj{?ubj)}(hctorh]hctor}(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{?ubjr)}(h)h]h)}(hj?hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj{?ubjr)}(hj?h]h(}(hj?hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj{?ubj)}(hvoidh]hvoid}(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{?ubjr)}(hjuh]h*}(hj?hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj{?ubjr)}(hj?h]h)}(hj?hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj{?ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj=ubeh}(h]h ]h"]h$]h&]jjuh1j7hj=hhhj)=hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj=hhhj)=hMubah}(h]j=ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj)=hMhj=hhubj4)}(hhh]jM)}(hDCreate a kmem cache with a region suitable for copying to userspace.h]hDCreate a kmem cache with a region suitable for copying to userspace.}(hj#@hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhj @hhubah}(h]h ]h"]h$]h&]uh1j3hj=hhhj)=hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj;@jHj;@jIjJjKuh1hhhhjU3hNhNubj)}(hX **Parameters** ``const char *name`` A string which is used in /proc/slabinfo to identify this cache. ``unsigned int size`` The size of objects to be created in this cache. ``unsigned int align`` The required alignment for the objects. ``slab_flags_t flags`` SLAB flags ``unsigned int useroffset`` Usercopy region offset ``unsigned int usersize`` Usercopy region size ``void (*ctor)(void *)`` A constructor for the objects, or ``NULL``. **Description** This is a legacy wrapper, new code should use either KMEM_CACHE_USERCOPY() if whitelisting a single field is sufficient, or kmem_cache_create() with the necessary parameters passed via the args parameter (see :c:type:`struct kmem_cache_args `) **Return** a pointer to the cache on success, NULL on failure.h](jM)}(h**Parameters**h]j)}(hjE@h]h Parameters}(hjG@hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjC@ubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhj?@ubj)}(hhh](j)}(hV``const char *name`` A string which is used in /proc/slabinfo to identify this cache. h](j)}(h``const char *name``h]jS)}(hjd@h]hconst char *name}(hjf@hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjb@ubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhj^@ubj)}(hhh]jM)}(h@A string which is used in /proc/slabinfo to identify this cache.h]h@A string which is used in /proc/slabinfo to identify this cache.}(hj}@hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjy@hMhjz@ubah}(h]h ]h"]h$]h&]uh1jhj^@ubeh}(h]h ]h"]h$]h&]uh1jhjy@hMhj[@ubj)}(hG``unsigned int size`` The size of objects to be created in this cache. h](j)}(h``unsigned int size``h]jS)}(hj@h]hunsigned int size}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj@ubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhj@ubj)}(hhh]jM)}(h0The size of objects to be created in this cache.h]h0The size of objects to be created in this cache.}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj@hMhj@ubah}(h]h ]h"]h$]h&]uh1jhj@ubeh}(h]h ]h"]h$]h&]uh1jhj@hMhj[@ubj)}(h?``unsigned int align`` The required alignment for the objects. h](j)}(h``unsigned int align``h]jS)}(hj@h]hunsigned int align}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj@ubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhj@ubj)}(hhh]jM)}(h'The required alignment for the objects.h]h'The required alignment for the objects.}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj@hMhj@ubah}(h]h ]h"]h$]h&]uh1jhj@ubeh}(h]h ]h"]h$]h&]uh1jhj@hMhj[@ubj)}(h"``slab_flags_t flags`` SLAB flags h](j)}(h``slab_flags_t flags``h]jS)}(hjAh]hslab_flags_t flags}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj Aubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhj Aubj)}(hhh]jM)}(h SLAB flagsh]h SLAB flags}(hj(AhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj$AhMhj%Aubah}(h]h ]h"]h$]h&]uh1jhj Aubeh}(h]h ]h"]h$]h&]uh1jhj$AhMhj[@ubj)}(h3``unsigned int useroffset`` Usercopy region offset h](j)}(h``unsigned int useroffset``h]jS)}(hjHAh]hunsigned int useroffset}(hjJAhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjFAubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhjBAubj)}(hhh]jM)}(hUsercopy region offseth]hUsercopy region offset}(hjaAhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj]AhMhj^Aubah}(h]h ]h"]h$]h&]uh1jhjBAubeh}(h]h ]h"]h$]h&]uh1jhj]AhMhj[@ubj)}(h/``unsigned int usersize`` Usercopy region size h](j)}(h``unsigned int usersize``h]jS)}(hjAh]hunsigned int usersize}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjAubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhj{Aubj)}(hhh]jM)}(hUsercopy region sizeh]hUsercopy region size}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjAhMhjAubah}(h]h ]h"]h$]h&]uh1jhj{Aubeh}(h]h ]h"]h$]h&]uh1jhjAhMhj[@ubj)}(hE``void (*ctor)(void *)`` A constructor for the objects, or ``NULL``. h](j)}(h``void (*ctor)(void *)``h]jS)}(hjAh]hvoid (*ctor)(void *)}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjAubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhjAubj)}(hhh]jM)}(h+A constructor for the objects, or ``NULL``.h](h"A constructor for the objects, or }(hjAhhhNhNubjS)}(h``NULL``h]hNULL}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjAubh.}(hjAhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhjAhMhjAubah}(h]h ]h"]h$]h&]uh1jhjAubeh}(h]h ]h"]h$]h&]uh1jhjAhMhj[@ubeh}(h]h ]h"]h$]h&]uh1jhj?@ubjM)}(h**Description**h]j)}(hjBh]h Description}(hj BhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjBubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhj?@ubjM)}(hXThis is a legacy wrapper, new code should use either KMEM_CACHE_USERCOPY() if whitelisting a single field is sufficient, or kmem_cache_create() with the necessary parameters passed via the args parameter (see :c:type:`struct kmem_cache_args `)h](hThis is a legacy wrapper, new code should use either KMEM_CACHE_USERCOPY() if whitelisting a single field is sufficient, or kmem_cache_create() with the necessary parameters passed via the args parameter (see }(hjBhhhNhNubh)}(h2:c:type:`struct kmem_cache_args `h]jS)}(hj'Bh]hstruct kmem_cache_args}(hj)BhhhNhNubah}(h]h ](j%4jAc-typeeh"]h$]h&]uh1jRhj%Bubah}(h]h ]h"]h$]h&]refdocj14 refdomainjAreftypetype refexplicitrefwarnjj74j:4kmem_cache_argsuh1hhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhjBubh)}(hjBhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhjDBhMhj?@ubjM)}(h **Return**h]j)}(hjQBh]hReturn}(hjSBhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjOBubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhj?@ubjM)}(h3a pointer to the cache on success, NULL on failure.h]h3a pointer to the cache on success, NULL on failure.}(hjgBhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhj?@ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjU3hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hkmem_cache_create (C macro)c.kmem_cache_createhNtauh1hhjU3hhhNhNubh)}(hhh](h)}(hkmem_cache_createh]h)}(hkmem_cache_createh]h)}(hkmem_cache_createh]j)}(hjBh]hkmem_cache_create}(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubah}(h]h ](jjeh"]h$]h&]jjuh1hhjBhhhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMubah}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjBhhhjBhMubah}(h]jBah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjBhMhjBhhubj4)}(hhh]h}(h]h ]h"]h$]h&]uh1j3hjBhhhjBhMubeh}(h]h ](jAmacroeh"]h$]h&]jFjAjGjBjHjBjIjJjKuh1hhhhjU3hNhNubjM)}(h:``kmem_cache_create (__name, __object_size, __args, ...)``h]jS)}(hjBh]h6kmem_cache_create (__name, __object_size, __args, ...)}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjBubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhjU3hhubji)}(hCreate a kmem cache. h]jM)}(hCreate a kmem cache.h]hCreate a kmem cache.}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhjBubah}(h]h ]h"]h$]h&]uh1jhhjBhMhjU3hhubj)}(hX**Parameters** ``__name`` A string which is used in /proc/slabinfo to identify this cache. ``__object_size`` The size of objects to be created in this cache. ``__args`` Optional arguments, see :c:type:`struct kmem_cache_args `. Passing ``NULL`` means defaults will be used for all the arguments. ``...`` variable arguments **Description** This is currently implemented as a macro using ``_Generic()`` to call either the new variant of the function, or a legacy one. The new variant has 4 parameters: ``kmem_cache_create(name, object_size, args, flags)`` See __kmem_cache_create_args() which implements this. The legacy variant has 5 parameters: ``kmem_cache_create(name, object_size, align, flags, ctor)`` The align and ctor parameters map to the respective fields of :c:type:`struct kmem_cache_args ` **Context** Cannot be called within a interrupt, but can be interrupted. **Return** a pointer to the cache on success, NULL on failure.h](jM)}(h**Parameters**h]j)}(hjCh]h Parameters}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1jhjBubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhjBubj)}(hhh](j)}(hL``__name`` A string which is used in /proc/slabinfo to identify this cache. h](j)}(h ``__name``h]jS)}(hj Ch]h__name}(hj"ChhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjCubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhjCubj)}(hhh]jM)}(h@A string which is used in /proc/slabinfo to identify this cache.h]h@A string which is used in /proc/slabinfo to identify this cache.}(hj9ChhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj5ChMhj6Cubah}(h]h ]h"]h$]h&]uh1jhjCubeh}(h]h ]h"]h$]h&]uh1jhj5ChMhjCubj)}(hC``__object_size`` The size of objects to be created in this cache. h](j)}(h``__object_size``h]jS)}(hjYCh]h __object_size}(hj[ChhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjWCubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhjSCubj)}(hhh]jM)}(h0The size of objects to be created in this cache.h]h0The size of objects to be created in this cache.}(hjrChhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjnChMhjoCubah}(h]h ]h"]h$]h&]uh1jhjSCubeh}(h]h ]h"]h$]h&]uh1jhjnChMhjCubj)}(h``__args`` Optional arguments, see :c:type:`struct kmem_cache_args `. Passing ``NULL`` means defaults will be used for all the arguments. h](j)}(h ``__args``h]jS)}(hjCh]h__args}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjCubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhjCubj)}(hhh]jM)}(hOptional arguments, see :c:type:`struct kmem_cache_args `. Passing ``NULL`` means defaults will be used for all the arguments.h](hOptional arguments, see }(hjChhhNhNubh)}(h2:c:type:`struct kmem_cache_args `h]jS)}(hjCh]hstruct kmem_cache_args}(hjChhhNhNubah}(h]h ](j%4jAc-typeeh"]h$]h&]uh1jRhjCubah}(h]h ]h"]h$]h&]refdocj14 refdomainjAreftypetype refexplicitrefwarnjj74j:4kmem_cache_argsuh1hhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhjCubh . Passing }(hjChhhNhNubjS)}(h``NULL``h]hNULL}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjCubh3 means defaults will be used for all the arguments.}(hjChhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhjChMhjCubah}(h]h ]h"]h$]h&]uh1jhjCubeh}(h]h ]h"]h$]h&]uh1jhjChMhjCubj)}(h``...`` variable arguments h](j)}(h``...``h]jS)}(hjDh]h...}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjCubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhKhjCubj)}(hhh]jM)}(hvariable argumentsh]hvariable arguments}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjDhKhjDubah}(h]h ]h"]h$]h&]uh1jhjCubeh}(h]h ]h"]h$]h&]uh1jhjDhKhjCubeh}(h]h ]h"]h$]h&]uh1jhjBubjM)}(h**Description**h]j)}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj:Dubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhKhjBubjM)}(h~This is currently implemented as a macro using ``_Generic()`` to call either the new variant of the function, or a legacy one.h](h/This is currently implemented as a macro using }(hjRDhhhNhNubjS)}(h``_Generic()``h]h _Generic()}(hjZDhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjRDubhA to call either the new variant of the function, or a legacy one.}(hjRDhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhjBubjM)}(hWThe new variant has 4 parameters: ``kmem_cache_create(name, object_size, args, flags)``h](h"The new variant has 4 parameters: }(hjsDhhhNhNubjS)}(h5``kmem_cache_create(name, object_size, args, flags)``h]h1kmem_cache_create(name, object_size, args, flags)}(hj{DhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjsDubeh}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhjBubjM)}(h5See __kmem_cache_create_args() which implements this.h]h5See __kmem_cache_create_args() which implements this.}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhjBubjM)}(haThe legacy variant has 5 parameters: ``kmem_cache_create(name, object_size, align, flags, ctor)``h](h%The legacy variant has 5 parameters: }(hjDhhhNhNubjS)}(h<``kmem_cache_create(name, object_size, align, flags, ctor)``h]h8kmem_cache_create(name, object_size, align, flags, ctor)}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjDubeh}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhjBubjM)}(hpThe align and ctor parameters map to the respective fields of :c:type:`struct kmem_cache_args `h](h>The align and ctor parameters map to the respective fields of }(hjDhhhNhNubh)}(h2:c:type:`struct kmem_cache_args `h]jS)}(hjDh]hstruct kmem_cache_args}(hjDhhhNhNubah}(h]h ](j%4jAc-typeeh"]h$]h&]uh1jRhjDubah}(h]h ]h"]h$]h&]refdocj14 refdomainjAreftypetype refexplicitrefwarnjj74j:4kmem_cache_argsuh1hhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhjDubeh}(h]h ]h"]h$]h&]uh1jLhjDhMhjBubjM)}(h **Context**h]j)}(hjDh]hContext}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjDubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhjBubjM)}(h)}(h const void *ph](j)}(hjh]hconst}(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEubj)}(h h]h }(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEubj)}(hvoidh]hvoid}(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEubj)}(h h]h }(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEubjr)}(hjuh]h*}(hjEhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjEubj)}(hj~h]hp}(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjEubj>)}(hsize_t new_sizeh](h)}(hhh]j)}(hsize_th]hsize_t}(hjFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjFmodnameN classnameNjj)}j]j)}jjEsbc.krealloc_node_alignasbuh1hhjEubj)}(h h]h }(hj!FhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEubj)}(hnew_sizeh]hnew_size}(hj/FhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjEubj>)}(hunsigned long alignh](j)}(hunsignedh]hunsigned}(hjHFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjDFubj)}(h h]h }(hjVFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjDFubj)}(hlongh]hlong}(hjdFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjDFubj)}(h h]h }(hjrFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjDFubj)}(halignh]halign}(hjFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjDFubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjEubj>)}(h gfp_t flagsh](h)}(hhh]j)}(hgfp_th]hgfp_t}(hjFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjFmodnameN classnameNjj)}j]jFc.krealloc_node_alignasbuh1hhjFubj)}(h h]h }(hjFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFubj)}(hflagsh]hflags}(hjFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjEubj>)}(hint nidh](j)}(hinth]hint}(hjFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFubj)}(h h]h }(hjFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFubj)}(hnidh]hnid}(hjFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjEubeh}(h]h ]h"]h$]h&]jjuh1j7hjTEhhhjfEhM'ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjPEhhhjfEhM'ubah}(h]jKEah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjfEhM'hjMEhhubj4)}(hhh]jM)}(h6reallocate memory. The contents will remain unchanged.h]h6reallocate memory. The contents will remain unchanged.}(hj'GhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhM'hj$Ghhubah}(h]h ]h"]h$]h&]uh1j3hjMEhhhjfEhM'ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj?GjHj?GjIjJjKuh1hhhhjU3hNhNubj)}(hX+**Parameters** ``const void *p`` object to reallocate memory for. ``size_t new_size`` how many bytes of memory are required. ``unsigned long align`` desired alignment. ``gfp_t flags`` the type of memory to allocate. ``int nid`` NUMA node or NUMA_NO_NODE **Description** If **p** is ``NULL``, krealloc() behaves exactly like kmalloc(). If **new_size** is 0 and **p** is not a ``NULL`` pointer, the object pointed to is freed. Only alignments up to those guaranteed by kmalloc() will be honored. Please see Documentation/core-api/memory-allocation.rst for more details. If __GFP_ZERO logic is requested, callers must ensure that, starting with the initial memory allocation, every subsequent call to this API for the same memory allocation is flagged with __GFP_ZERO. Otherwise, it is possible that __GFP_ZERO is not fully honored by this API. When slub_debug_orig_size() is off, krealloc() only knows about the bucket size of an allocation (but not the exact size it was allocated with) and hence implements the following semantics for shrinking and growing buffers with __GFP_ZERO:: new bucket 0 size size |--------|----------------| | keep | zero | Otherwise, the original allocation size 'orig_size' could be used to precisely clear the requested size, and the new size will also be stored as the new 'orig_size'. In any case, the contents of the object pointed to are preserved up to the lesser of the new and old sizes. **Return** pointer to the allocated memory or ``NULL`` in case of errorh](jM)}(h**Parameters**h]j)}(hjIGh]h Parameters}(hjKGhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjGGubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhM+hjCGubj)}(hhh](j)}(h3``const void *p`` object to reallocate memory for. h](j)}(h``const void *p``h]jS)}(hjhGh]h const void *p}(hjjGhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjfGubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhM(hjbGubj)}(hhh]jM)}(h object to reallocate memory for.h]h object to reallocate memory for.}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj}GhM(hj~Gubah}(h]h ]h"]h$]h&]uh1jhjbGubeh}(h]h ]h"]h$]h&]uh1jhj}GhM(hj_Gubj)}(h;``size_t new_size`` how many bytes of memory are required. h](j)}(h``size_t new_size``h]jS)}(hjGh]hsize_t new_size}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjGubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhM)hjGubj)}(hhh]jM)}(h&how many bytes of memory are required.h]h&how many bytes of memory are required.}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjGhM)hjGubah}(h]h ]h"]h$]h&]uh1jhjGubeh}(h]h ]h"]h$]h&]uh1jhjGhM)hj_Gubj)}(h+``unsigned long align`` desired alignment. h](j)}(h``unsigned long align``h]jS)}(hjGh]hunsigned long align}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjGubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhM*hjGubj)}(hhh]jM)}(hdesired alignment.h]hdesired alignment.}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjGhM*hjGubah}(h]h ]h"]h$]h&]uh1jhjGubeh}(h]h ]h"]h$]h&]uh1jhjGhM*hj_Gubj)}(h0``gfp_t flags`` the type of memory to allocate. h](j)}(h``gfp_t flags``h]jS)}(hjHh]h gfp_t flags}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjHubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhM+hj Hubj)}(hhh]jM)}(hthe type of memory to allocate.h]hthe type of memory to allocate.}(hj,HhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj(HhM+hj)Hubah}(h]h ]h"]h$]h&]uh1jhj Hubeh}(h]h ]h"]h$]h&]uh1jhj(HhM+hj_Gubj)}(h&``int nid`` NUMA node or NUMA_NO_NODE h](j)}(h ``int nid``h]jS)}(hjLHh]hint nid}(hjNHhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjJHubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhM,hjFHubj)}(hhh]jM)}(hNUMA node or NUMA_NO_NODEh]hNUMA node or NUMA_NO_NODE}(hjeHhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjaHhM,hjbHubah}(h]h ]h"]h$]h&]uh1jhjFHubeh}(h]h ]h"]h$]h&]uh1jhjaHhM,hj_Gubeh}(h]h ]h"]h$]h&]uh1jhjCGubjM)}(h**Description**h]j)}(hjHh]h Description}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjHubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhM.hjCGubjM)}(hIf **p** is ``NULL``, krealloc() behaves exactly like kmalloc(). If **new_size** is 0 and **p** is not a ``NULL`` pointer, the object pointed to is freed.h](hIf }(hjHhhhNhNubj)}(h**p**h]hp}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjHubh is }(hjHhhhNhNubjS)}(h``NULL``h]hNULL}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjHubh1, krealloc() behaves exactly like kmalloc(). If }(hjHhhhNhNubj)}(h **new_size**h]hnew_size}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjHubh is 0 and }(hjHhhhNhNubj)}(h**p**h]hp}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjHubh is not a }(hjHhhhNhNubjS)}(h``NULL``h]hNULL}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjHubh) pointer, the object pointed to is freed.}(hjHhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhM-hjCGubjM)}(hOnly alignments up to those guaranteed by kmalloc() will be honored. Please see Documentation/core-api/memory-allocation.rst for more details.h]hOnly alignments up to those guaranteed by kmalloc() will be honored. Please see Documentation/core-api/memory-allocation.rst for more details.}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhM0hjCGubjM)}(hXIf __GFP_ZERO logic is requested, callers must ensure that, starting with the initial memory allocation, every subsequent call to this API for the same memory allocation is flagged with __GFP_ZERO. Otherwise, it is possible that __GFP_ZERO is not fully honored by this API.h]hXIf __GFP_ZERO logic is requested, callers must ensure that, starting with the initial memory allocation, every subsequent call to this API for the same memory allocation is flagged with __GFP_ZERO. Otherwise, it is possible that __GFP_ZERO is not fully honored by this API.}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhM3hjCGubjM)}(hWhen slub_debug_orig_size() is off, krealloc() only knows about the bucket size of an allocation (but not the exact size it was allocated with) and hence implements the following semantics for shrinking and growing buffers with __GFP_ZERO::h]hWhen slub_debug_orig_size() is off, krealloc() only knows about the bucket size of an allocation (but not the exact size it was allocated with) and hence implements the following semantics for shrinking and growing buffers with __GFP_ZERO:}(hj$IhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhM8hjCGubj7 )}(ht new bucket 0 size size |--------|----------------| | keep | zero |h]ht new bucket 0 size size |--------|----------------| | keep | zero |}hj3Isbah}(h]h ]h"]h$]h&]jjuh1j6 hT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhM=hjCGubjM)}(hOtherwise, the original allocation size 'orig_size' could be used to precisely clear the requested size, and the new size will also be stored as the new 'orig_size'.h]hOtherwise, the original allocation size ‘orig_size’ could be used to precisely clear the requested size, and the new size will also be stored as the new ‘orig_size’.}(hjBIhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMBhjCGubjM)}(hkIn any case, the contents of the object pointed to are preserved up to the lesser of the new and old sizes.h]hkIn any case, the contents of the object pointed to are preserved up to the lesser of the new and old sizes.}(hjQIhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMFhjCGubjM)}(h **Return**h]j)}(hjbIh]hReturn}(hjdIhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj`Iubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMIhjCGubjM)}(hvoid *kmem_cache_alloc(struct kmem_cache *cachep, gfp_t flags)h](j)}(hvoidh]hvoid}(hjIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIhhhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMMubj)}(h h]h }(hjIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIhhhjIhMMubjr)}(hjuh]h*}(hjIhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjIhhhjIhMMubh)}(hkmem_cache_alloch]j)}(hkmem_cache_alloch]hkmem_cache_alloc}(hjIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIubah}(h]h ](jjeh"]h$]h&]jjuh1hhjIhhhjIhMMubj8)}(h((struct kmem_cache *cachep, gfp_t flags)h](j>)}(hstruct kmem_cache *cacheph](j)}(hjJ,h]hstruct}(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIubj)}(h h]h }(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIubh)}(hhh]j)}(h kmem_cacheh]h kmem_cache}(hj!JhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj#JmodnameN classnameNjj)}j]j)}jjIsbc.kmem_cache_allocasbuh1hhjIubj)}(h h]h }(hjAJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIubjr)}(hjuh]h*}(hjOJhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjIubj)}(hcacheph]hcachep}(hj\JhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjIubj>)}(h gfp_t flagsh](h)}(hhh]j)}(hgfp_th]hgfp_t}(hjxJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjuJubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjzJmodnameN classnameNjj)}j]j=Jc.kmem_cache_allocasbuh1hhjqJubj)}(h h]h }(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjqJubj)}(hflagsh]hflags}(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjqJubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjIubeh}(h]h ]h"]h$]h&]jjuh1j7hjIhhhjIhMMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjIhhhjIhMMubah}(h]jIah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjIhMMhjIhhubj4)}(hhh]jM)}(hAllocate an objecth]hAllocate an object}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMMhjJhhubah}(h]h ]h"]h$]h&]uh1j3hjIhhhjIhMMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjJjHjJjIjJjKuh1hhhhjU3hNhNubj)}(hX-**Parameters** ``struct kmem_cache *cachep`` The cache to allocate from. ``gfp_t flags`` See kmalloc(). **Description** Allocate an object from this cache. See kmem_cache_zalloc() for a shortcut of adding __GFP_ZERO to flags. **Return** pointer to the new object or ``NULL`` in case of errorh](jM)}(h**Parameters**h]j)}(hjJh]h Parameters}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjJubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMQhjJubj)}(hhh](j)}(h:``struct kmem_cache *cachep`` The cache to allocate from. h](j)}(h``struct kmem_cache *cachep``h]jS)}(hjKh]hstruct kmem_cache *cachep}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj Kubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMNhj Kubj)}(hhh]jM)}(hThe cache to allocate from.h]hThe cache to allocate from.}(hj(KhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj$KhMNhj%Kubah}(h]h ]h"]h$]h&]uh1jhj Kubeh}(h]h ]h"]h$]h&]uh1jhj$KhMNhjKubj)}(h``gfp_t flags`` See kmalloc(). h](j)}(h``gfp_t flags``h]jS)}(hjHKh]h gfp_t flags}(hjJKhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjFKubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMOhjBKubj)}(hhh]jM)}(hSee kmalloc().h]hSee kmalloc().}(hjaKhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj]KhMOhj^Kubah}(h]h ]h"]h$]h&]uh1jhjBKubeh}(h]h ]h"]h$]h&]uh1jhj]KhMOhjKubeh}(h]h ]h"]h$]h&]uh1jhjJubjM)}(h**Description**h]j)}(hjKh]h Description}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjKubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMQhjJubjM)}(hiAllocate an object from this cache. See kmem_cache_zalloc() for a shortcut of adding __GFP_ZERO to flags.h]hiAllocate an object from this cache. See kmem_cache_zalloc() for a shortcut of adding __GFP_ZERO to flags.}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMPhjJubjM)}(h **Return**h]j)}(hjKh]hReturn}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjKubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMShjJubjM)}(h6pointer to the new object or ``NULL`` in case of errorh](hpointer to the new object or }(hjKhhhNhNubjS)}(h``NULL``h]hNULL}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjKubh in case of error}(hjKhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMThjJubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjU3hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hkmem_cache_charge (C function)c.kmem_cache_chargehNtauh1hhjU3hhhNhNubh)}(hhh](h)}(h3bool kmem_cache_charge (void *objp, gfp_t gfpflags)h]h)}(h2bool kmem_cache_charge(void *objp, gfp_t gfpflags)h](j)}(hjh]hbool}(hjLhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjKhhhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhM_ubj)}(h h]h }(hjLhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjKhhhjLhM_ubh)}(hkmem_cache_chargeh]j)}(hkmem_cache_chargeh]hkmem_cache_charge}(hj!LhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjLubah}(h]h ](jjeh"]h$]h&]jjuh1hhjKhhhjLhM_ubj8)}(h(void *objp, gfp_t gfpflags)h](j>)}(h void *objph](j)}(hvoidh]hvoid}(hj=LhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9Lubj)}(h h]h }(hjKLhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9Lubjr)}(hjuh]h*}(hjYLhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj9Lubj)}(hobjph]hobjp}(hjfLhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9Lubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj5Lubj>)}(hgfp_t gfpflagsh](h)}(hhh]j)}(hgfp_th]hgfp_t}(hjLhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjLubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjLmodnameN classnameNjj)}j]j)}jj#Lsbc.kmem_cache_chargeasbuh1hhj{Lubj)}(h h]h }(hjLhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{Lubj)}(hgfpflagsh]hgfpflags}(hjLhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{Lubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj5Lubeh}(h]h ]h"]h$]h&]jjuh1j7hjKhhhjLhM_ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjKhhhjLhM_ubah}(h]jKah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjLhM_hjKhhubj4)}(hhh]jM)}(h-memcg charge an already allocated slab memoryh]h-memcg charge an already allocated slab memory}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhM_hjLhhubah}(h]h ]h"]h$]h&]uh1j3hjKhhhjLhM_ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjLjHjLjIjJjKuh1hhhhjU3hNhNubj)}(hX**Parameters** ``void *objp`` address of the slab object to memcg charge ``gfp_t gfpflags`` describe the allocation context **Description** kmem_cache_charge allows charging a slab object to the current memcg, primarily in cases where charging at allocation time might not be possible because the target memcg is not known (i.e. softirq context) The objp should be pointer returned by the slab allocator functions like kmalloc (with __GFP_ACCOUNT in flags) or kmem_cache_alloc. The memcg charge behavior can be controlled through gfpflags parameter, which affects how the necessary internal metadata can be allocated. Including __GFP_NOFAIL denotes that overcharging is requested instead of failure, but is not applied for the internal metadata allocation. There are several cases where it will return true even if the charging was not done: More specifically: 1. For !CONFIG_MEMCG or cgroup_disable=memory systems. 2. Already charged slab objects. 3. For slab objects from KMALLOC_NORMAL caches - allocated by kmalloc() without __GFP_ACCOUNT 4. Allocating internal metadata has failed **Return** true if charge was successful otherwise false.h](jM)}(h**Parameters**h]j)}(hjLh]h Parameters}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjLubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMchjLubj)}(hhh](j)}(h:``void *objp`` address of the slab object to memcg charge h](j)}(h``void *objp``h]jS)}(hjMh]h void *objp}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjMubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhM`hjMubj)}(hhh]jM)}(h*address of the slab object to memcg chargeh]h*address of the slab object to memcg charge}(hj4MhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj0MhM`hj1Mubah}(h]h ]h"]h$]h&]uh1jhjMubeh}(h]h ]h"]h$]h&]uh1jhj0MhM`hjMubj)}(h3``gfp_t gfpflags`` describe the allocation context h](j)}(h``gfp_t gfpflags``h]jS)}(hjTMh]hgfp_t gfpflags}(hjVMhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjRMubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMahjNMubj)}(hhh]jM)}(hdescribe the allocation contexth]hdescribe the allocation context}(hjmMhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjiMhMahjjMubah}(h]h ]h"]h$]h&]uh1jhjNMubeh}(h]h ]h"]h$]h&]uh1jhjiMhMahjMubeh}(h]h ]h"]h$]h&]uh1jhjLubjM)}(h**Description**h]j)}(hjMh]h Description}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjMubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMchjLubjM)}(hkmem_cache_charge allows charging a slab object to the current memcg, primarily in cases where charging at allocation time might not be possible because the target memcg is not known (i.e. softirq context)h]hkmem_cache_charge allows charging a slab object to the current memcg, primarily in cases where charging at allocation time might not be possible because the target memcg is not known (i.e. softirq context)}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMbhjLubjM)}(hXThe objp should be pointer returned by the slab allocator functions like kmalloc (with __GFP_ACCOUNT in flags) or kmem_cache_alloc. The memcg charge behavior can be controlled through gfpflags parameter, which affects how the necessary internal metadata can be allocated. Including __GFP_NOFAIL denotes that overcharging is requested instead of failure, but is not applied for the internal metadata allocation.h]hXThe objp should be pointer returned by the slab allocator functions like kmalloc (with __GFP_ACCOUNT in flags) or kmem_cache_alloc. The memcg charge behavior can be controlled through gfpflags parameter, which affects how the necessary internal metadata can be allocated. Including __GFP_NOFAIL denotes that overcharging is requested instead of failure, but is not applied for the internal metadata allocation.}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMfhjLubjM)}(hgThere are several cases where it will return true even if the charging was not done: More specifically:h]hgThere are several cases where it will return true even if the charging was not done: More specifically:}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMmhjLubhenumerated_list)}(hhh](jc)}(h3For !CONFIG_MEMCG or cgroup_disable=memory systems.h]jM)}(hjMh]h3For !CONFIG_MEMCG or cgroup_disable=memory systems.}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMqhjMubah}(h]h ]h"]h$]h&]uh1jbhjMubjc)}(hAlready charged slab objects.h]jM)}(hjMh]hAlready charged slab objects.}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMrhjMubah}(h]h ]h"]h$]h&]uh1jbhjMubjc)}(hZFor slab objects from KMALLOC_NORMAL caches - allocated by kmalloc() without __GFP_ACCOUNTh]jM)}(hZFor slab objects from KMALLOC_NORMAL caches - allocated by kmalloc() without __GFP_ACCOUNTh]hZFor slab objects from KMALLOC_NORMAL caches - allocated by kmalloc() without __GFP_ACCOUNT}(hj NhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMshjNubah}(h]h ]h"]h$]h&]uh1jbhjMubjc)}(h(Allocating internal metadata has failed h]jM)}(h'Allocating internal metadata has failedh]h'Allocating internal metadata has failed}(hj$NhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMuhj Nubah}(h]h ]h"]h$]h&]uh1jbhjMubeh}(h]h ]h"]h$]h&]enumtypearabicprefixhsuffix.uh1jMhjLubjM)}(h **Return**h]j)}(hjFNh]hReturn}(hjHNhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjDNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMwhjLubjM)}(h.true if charge was successful otherwise false.h]h.true if charge was successful otherwise false.}(hj\NhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMxhjLubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjU3hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hkmalloc (C function) c.kmallochNtauh1hhjU3hhhNhNubh)}(hhh](h)}(h)void * kmalloc (size_t size, gfp_t flags)h]h)}(h'void *kmalloc(size_t size, gfp_t flags)h](j)}(hvoidh]hvoid}(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNhhhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMubj)}(h h]h }(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNhhhjNhMubjr)}(hjuh]h*}(hjNhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjNhhhjNhMubh)}(hkmalloch]j)}(hkmalloch]hkmalloc}(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubah}(h]h ](jjeh"]h$]h&]jjuh1hhjNhhhjNhMubj8)}(h(size_t size, gfp_t flags)h](j>)}(h size_t sizeh](h)}(hhh]j)}(hsize_th]hsize_t}(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjNmodnameN classnameNjj)}j]j)}jjNsb c.kmallocasbuh1hhjNubj)}(h h]h }(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubj)}(hsizeh]hsize}(hjOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjNubj>)}(h gfp_t flagsh](h)}(hhh]j)}(hgfp_th]hgfp_t}(hj"OhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjOubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj$OmodnameN classnameNjj)}j]jN c.kmallocasbuh1hhjOubj)}(h h]h }(hj@OhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjOubj)}(hflagsh]hflags}(hjNOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjOubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjNubeh}(h]h ]h"]h$]h&]jjuh1j7hjNhhhjNhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjNhhhjNhMubah}(h]j~Nah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjNhMhjNhhubj4)}(hhh]jM)}(hallocate kernel memoryh]hallocate kernel memory}(hjxOhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhjuOhhubah}(h]h ]h"]h$]h&]uh1j3hjNhhhjNhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjOjHjOjIjJjKuh1hhhhjU3hNhNubj)}(hX**Parameters** ``size_t size`` how many bytes of memory are required. ``gfp_t flags`` describe the allocation context **Description** kmalloc is the normal method of allocating memory for objects smaller than page size in the kernel. The allocated object address is aligned to at least ARCH_KMALLOC_MINALIGN bytes. For **size** of power of two bytes, the alignment is also guaranteed to be at least to the size. For other sizes, the alignment is guaranteed to be at least the largest power-of-two divisor of **size**. The **flags** argument may be one of the GFP flags defined at include/linux/gfp_types.h and described at :ref:`Documentation/core-api/mm-api.rst ` The recommended usage of the **flags** is described at :ref:`Documentation/core-api/memory-allocation.rst ` Below is a brief outline of the most useful GFP flags ``GFP_KERNEL`` Allocate normal kernel ram. May sleep. ``GFP_NOWAIT`` Allocation will not sleep. ``GFP_ATOMIC`` Allocation will not sleep. May use emergency pools. Also it is possible to set different flags by OR'ing in one or more of the following additional **flags**: ``__GFP_ZERO`` Zero the allocated memory before returning. Also see kzalloc(). ``__GFP_HIGH`` This allocation has high priority and may use emergency pools. ``__GFP_NOFAIL`` Indicate that this allocation is in no way allowed to fail (think twice before using). ``__GFP_NORETRY`` If memory is not immediately available, then give up at once. ``__GFP_NOWARN`` If allocation fails, don't issue any warnings. ``__GFP_RETRY_MAYFAIL`` Try really hard to succeed the allocation but fail eventually.h](jM)}(h**Parameters**h]j)}(hjOh]h Parameters}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjOubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhjOubj)}(hhh](j)}(h7``size_t size`` how many bytes of memory are required. h](j)}(h``size_t size``h]jS)}(hjOh]h size_t size}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjOubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhjOubj)}(hhh]jM)}(h&how many bytes of memory are required.h]h&how many bytes of memory are required.}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjOhMhjOubah}(h]h ]h"]h$]h&]uh1jhjOubeh}(h]h ]h"]h$]h&]uh1jhjOhMhjOubj)}(h0``gfp_t flags`` describe the allocation context h](j)}(h``gfp_t flags``h]jS)}(hjOh]h gfp_t flags}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjOubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhjOubj)}(hhh]jM)}(hdescribe the allocation contexth]hdescribe the allocation context}(hj PhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjPhMhjPubah}(h]h ]h"]h$]h&]uh1jhjOubeh}(h]h ]h"]h$]h&]uh1jhjPhMhjOubeh}(h]h ]h"]h$]h&]uh1jhjOubjM)}(h**Description**h]j)}(hj-Ph]h Description}(hj/PhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj+Pubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhjOubjM)}(hckmalloc is the normal method of allocating memory for objects smaller than page size in the kernel.h]hckmalloc is the normal method of allocating memory for objects smaller than page size in the kernel.}(hjCPhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhjOubjM)}(hXThe allocated object address is aligned to at least ARCH_KMALLOC_MINALIGN bytes. For **size** of power of two bytes, the alignment is also guaranteed to be at least to the size. For other sizes, the alignment is guaranteed to be at least the largest power-of-two divisor of **size**.h](hUThe allocated object address is aligned to at least ARCH_KMALLOC_MINALIGN bytes. For }(hjRPhhhNhNubj)}(h**size**h]hsize}(hjZPhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjRPubh of power of two bytes, the alignment is also guaranteed to be at least to the size. For other sizes, the alignment is guaranteed to be at least the largest power-of-two divisor of }(hjRPhhhNhNubj)}(h**size**h]hsize}(hjlPhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjRPubh.}(hjRPhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhjOubjM)}(hThe **flags** argument may be one of the GFP flags defined at include/linux/gfp_types.h and described at :ref:`Documentation/core-api/mm-api.rst `h](hThe }(hjPhhhNhNubj)}(h **flags**h]hflags}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjPubh\ argument may be one of the GFP flags defined at include/linux/gfp_types.h and described at }(hjPhhhNhNubh)}(h;:ref:`Documentation/core-api/mm-api.rst `h]hinline)}(hjPh]h!Documentation/core-api/mm-api.rst}(hjPhhhNhNubah}(h]h ](j%4stdstd-refeh"]h$]h&]uh1jPhjPubah}(h]h ]h"]h$]h&]refdocj14 refdomainjPreftyperef refexplicitrefwarnj:4mm-api-gfp-flagsuh1hhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhjPubeh}(h]h ]h"]h$]h&]uh1jLhjPhMhjOubjM)}(h~The recommended usage of the **flags** is described at :ref:`Documentation/core-api/memory-allocation.rst `h](hThe recommended usage of the }(hjPhhhNhNubj)}(h **flags**h]hflags}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjPubh is described at }(hjPhhhNhNubh)}(hG:ref:`Documentation/core-api/memory-allocation.rst `h]jP)}(hjPh]h,Documentation/core-api/memory-allocation.rst}(hjPhhhNhNubah}(h]h ](j%4stdstd-refeh"]h$]h&]uh1jPhjPubah}(h]h ]h"]h$]h&]refdocj14 refdomainjPreftyperef refexplicitrefwarnj:4memory_allocationuh1hhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhjPubeh}(h]h ]h"]h$]h&]uh1jLhjQhMhjOubjM)}(h5Below is a brief outline of the most useful GFP flagsh]h5Below is a brief outline of the most useful GFP flags}(hj QhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhjOubj)}(hhh](j)}(h6``GFP_KERNEL`` Allocate normal kernel ram. May sleep. h](j)}(h``GFP_KERNEL``h]jS)}(hj!Qh]h GFP_KERNEL}(hj#QhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjQubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhjQubj)}(hhh]jM)}(h&Allocate normal kernel ram. May sleep.h]h&Allocate normal kernel ram. May sleep.}(hj:QhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj6QhMhj7Qubah}(h]h ]h"]h$]h&]uh1jhjQubeh}(h]h ]h"]h$]h&]uh1jhj6QhMhjQubj)}(h*``GFP_NOWAIT`` Allocation will not sleep. h](j)}(h``GFP_NOWAIT``h]jS)}(hjZQh]h GFP_NOWAIT}(hj\QhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjXQubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhjTQubj)}(hhh]jM)}(hAllocation will not sleep.h]hAllocation will not sleep.}(hjsQhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjoQhMhjpQubah}(h]h ]h"]h$]h&]uh1jhjTQubeh}(h]h ]h"]h$]h&]uh1jhjoQhMhjQubj)}(hD``GFP_ATOMIC`` Allocation will not sleep. May use emergency pools. h](j)}(h``GFP_ATOMIC``h]jS)}(hjQh]h GFP_ATOMIC}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjQubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhjQubj)}(hhh]jM)}(h4Allocation will not sleep. May use emergency pools.h]h4Allocation will not sleep. May use emergency pools.}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjQhMhjQubah}(h]h ]h"]h$]h&]uh1jhjQubeh}(h]h ]h"]h$]h&]uh1jhjQhMhjQubeh}(h]h ]h"]h$]h&]uh1jhjOubjM)}(hjAlso it is possible to set different flags by OR'ing in one or more of the following additional **flags**:h](hbAlso it is possible to set different flags by OR’ing in one or more of the following additional }(hjQhhhNhNubj)}(h **flags**h]hflags}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjQubh:}(hjQhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhjOubj)}(hhh](j)}(hO``__GFP_ZERO`` Zero the allocated memory before returning. Also see kzalloc(). h](j)}(h``__GFP_ZERO``h]jS)}(hjQh]h __GFP_ZERO}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjQubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhM hjQubj)}(hhh]jM)}(h?Zero the allocated memory before returning. Also see kzalloc().h]h?Zero the allocated memory before returning. Also see kzalloc().}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj RhM hj Rubah}(h]h ]h"]h$]h&]uh1jhjQubeh}(h]h ]h"]h$]h&]uh1jhj RhM hjQubj)}(hN``__GFP_HIGH`` This allocation has high priority and may use emergency pools. h](j)}(h``__GFP_HIGH``h]jS)}(hj/Rh]h __GFP_HIGH}(hj1RhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj-Rubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhM hj)Rubj)}(hhh]jM)}(h>This allocation has high priority and may use emergency pools.h]h>This allocation has high priority and may use emergency pools.}(hjHRhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjDRhM hjERubah}(h]h ]h"]h$]h&]uh1jhj)Rubeh}(h]h ]h"]h$]h&]uh1jhjDRhM hjQubj)}(hh``__GFP_NOFAIL`` Indicate that this allocation is in no way allowed to fail (think twice before using). h](j)}(h``__GFP_NOFAIL``h]jS)}(hjhRh]h __GFP_NOFAIL}(hjjRhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjfRubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhjbRubj)}(hhh]jM)}(hVIndicate that this allocation is in no way allowed to fail (think twice before using).h]hVIndicate that this allocation is in no way allowed to fail (think twice before using).}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhj~Rubah}(h]h ]h"]h$]h&]uh1jhjbRubeh}(h]h ]h"]h$]h&]uh1jhj}RhMhjQubj)}(hP``__GFP_NORETRY`` If memory is not immediately available, then give up at once. h](j)}(h``__GFP_NORETRY``h]jS)}(hjRh]h __GFP_NORETRY}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjRubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhjRubj)}(hhh]jM)}(h=If memory is not immediately available, then give up at once.h]h=If memory is not immediately available, then give up at once.}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhjRubah}(h]h ]h"]h$]h&]uh1jhjRubeh}(h]h ]h"]h$]h&]uh1jhjRhMhjQubj)}(h@``__GFP_NOWARN`` If allocation fails, don't issue any warnings. h](j)}(h``__GFP_NOWARN``h]jS)}(hjRh]h __GFP_NOWARN}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjRubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhjRubj)}(hhh]jM)}(h.If allocation fails, don't issue any warnings.h]h0If allocation fails, don’t issue any warnings.}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjRhMhjRubah}(h]h ]h"]h$]h&]uh1jhjRubeh}(h]h ]h"]h$]h&]uh1jhjRhMhjQubj)}(hV``__GFP_RETRY_MAYFAIL`` Try really hard to succeed the allocation but fail eventually.h](j)}(h``__GFP_RETRY_MAYFAIL``h]jS)}(hjSh]h__GFP_RETRY_MAYFAIL}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjSubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhjSubj)}(hhh]jM)}(h>Try really hard to succeed the allocation but fail eventually.h]h>Try really hard to succeed the allocation but fail eventually.}(hj.ShhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj*ShMhj+Subah}(h]h ]h"]h$]h&]uh1jhjSubeh}(h]h ]h"]h$]h&]uh1jhj*ShMhjQubeh}(h]h ]h"]h$]h&]uh1jhjOubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjU3hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hkmalloc_nolock (C function)c.kmalloc_nolockhNtauh1hhjU3hhhNhNubh)}(hhh](h)}(h>void * kmalloc_nolock (size_t size, gfp_t gfp_flags, int node)h]h)}(h)}(h size_t sizeh](h)}(hhh]j)}(hsize_th]hsize_t}(hjShhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjSmodnameN classnameNjj)}j]j)}jjSsbc.kmalloc_nolockasbuh1hhjSubj)}(h h]h }(hjShhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSubj)}(hsizeh]hsize}(hjShhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjSubj>)}(hgfp_t gfp_flagsh](h)}(hhh]j)}(hgfp_th]hgfp_t}(hjThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjTubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjTmodnameN classnameNjj)}j]jSc.kmalloc_nolockasbuh1hhjSubj)}(h h]h }(hj#ThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSubj)}(h gfp_flagsh]h gfp_flags}(hj1ThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjSubj>)}(hint nodeh](j)}(hinth]hint}(hjJThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFTubj)}(h h]h }(hjXThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFTubj)}(hnodeh]hnode}(hjfThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFTubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjSubeh}(h]h ]h"]h$]h&]jjuh1j7hjjShhhj|ShM&ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjfShhhj|ShM&ubah}(h]jaSah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj|ShM&hjcShhubj4)}(hhh]jM)}(h2Allocate an object of given size from any context.h]h2Allocate an object of given size from any context.}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhM&hjThhubah}(h]h ]h"]h$]h&]uh1j3hjcShhhj|ShM&ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjTjHjTjIjJjKuh1hhhhjU3hNhNubj)}(hX**Parameters** ``size_t size`` size to allocate ``gfp_t gfp_flags`` GFP flags. Only __GFP_ACCOUNT and __GFP_ZERO allowed. Also __GFP_NOWARN and __GFP_NOMEMALLOC are allowed but added internally thus not necessary. ``int node`` node number of the target node. **Return** pointer to the new object or NULL in case of error. NULL does not mean EBUSY or EAGAIN. It means ENOMEM. There is no reason to call it again and expect !NULL.h](jM)}(h**Parameters**h]j)}(hjTh]h Parameters}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jhjTubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhM*hjTubj)}(hhh](j)}(h!``size_t size`` size to allocate h](j)}(h``size_t size``h]jS)}(hjTh]h size_t size}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjTubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhM'hjTubj)}(hhh]jM)}(hsize to allocateh]hsize to allocate}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjThM'hjTubah}(h]h ]h"]h$]h&]uh1jhjTubeh}(h]h ]h"]h$]h&]uh1jhjThM'hjTubj)}(h``gfp_t gfp_flags`` GFP flags. Only __GFP_ACCOUNT and __GFP_ZERO allowed. Also __GFP_NOWARN and __GFP_NOMEMALLOC are allowed but added internally thus not necessary. h](j)}(h``gfp_t gfp_flags``h]jS)}(hj Uh]hgfp_t gfp_flags}(hj UhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjUubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhM*hjUubj)}(hhh]jM)}(hGFP flags. Only __GFP_ACCOUNT and __GFP_ZERO allowed. Also __GFP_NOWARN and __GFP_NOMEMALLOC are allowed but added internally thus not necessary.h]hGFP flags. Only __GFP_ACCOUNT and __GFP_ZERO allowed. Also __GFP_NOWARN and __GFP_NOMEMALLOC are allowed but added internally thus not necessary.}(hj#UhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhM(hj Uubah}(h]h ]h"]h$]h&]uh1jhjUubeh}(h]h ]h"]h$]h&]uh1jhjUhM*hjTubj)}(h-``int node`` node number of the target node. h](j)}(h ``int node``h]jS)}(hjDUh]hint node}(hjFUhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjBUubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhM+hj>Uubj)}(hhh]jM)}(hnode number of the target node.h]hnode number of the target node.}(hj]UhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjYUhM+hjZUubah}(h]h ]h"]h$]h&]uh1jhj>Uubeh}(h]h ]h"]h$]h&]uh1jhjYUhM+hjTubeh}(h]h ]h"]h$]h&]uh1jhjTubjM)}(h **Return**h]j)}(hjUh]hReturn}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj}Uubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhM-hjTubjM)}(hpointer to the new object or NULL in case of error. NULL does not mean EBUSY or EAGAIN. It means ENOMEM. There is no reason to call it again and expect !NULL.h]hpointer to the new object or NULL in case of error. NULL does not mean EBUSY or EAGAIN. It means ENOMEM. There is no reason to call it again and expect !NULL.}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhM-hjTubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjU3hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h__alloc_objs (C macro)c.__alloc_objshNtauh1hhjU3hhhNhNubh)}(hhh](h)}(h __alloc_objsh]h)}(h __alloc_objsh]h)}(h __alloc_objsh]j)}(hjUh]h __alloc_objs}(hjUhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjUubah}(h]h ](jjeh"]h$]h&]jjuh1hhjUhhhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhM6ubah}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjUhhhjUhM6ubah}(h]jUah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjUhM6hjUhhubj4)}(hhh]h}(h]h ]h"]h$]h&]uh1j3hjUhhhjUhM6ubeh}(h]h ](jAmacroeh"]h$]h&]jFjAjGjUjHjUjIjJjKuh1hhhhjU3hNhNubjM)}(h,``__alloc_objs (KMALLOC, GFP, TYPE, COUNT)``h]jS)}(hjUh]h(__alloc_objs (KMALLOC, GFP, TYPE, COUNT)}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjUubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhM8hjU3hhubji)}(h'Allocate objects of a given type using h]jM)}(h&Allocate objects of a given type usingh]h&Allocate objects of a given type using}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhM6hjVubah}(h]h ]h"]h$]h&]uh1jhhj"VhM6hjU3hhubj)}(hXP**Parameters** ``KMALLOC`` which size-based kmalloc wrapper to allocate with. ``GFP`` GFP flags for the allocation. ``TYPE`` type to allocate space for. ``COUNT`` how many **TYPE** objects to allocate. **Return** Newly allocated pointer to (first) **TYPE** of **COUNT**-many allocated **TYPE** objects, or NULL on failure.h](jM)}(h**Parameters**h]j)}(hj/Vh]h Parameters}(hj1VhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj-Vubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhM:hj)Vubj)}(hhh](j)}(h?``KMALLOC`` which size-based kmalloc wrapper to allocate with. h](j)}(h ``KMALLOC``h]jS)}(hjNVh]hKMALLOC}(hjPVhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjLVubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhM7hjHVubj)}(hhh]jM)}(h2which size-based kmalloc wrapper to allocate with.h]h2which size-based kmalloc wrapper to allocate with.}(hjgVhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjcVhM7hjdVubah}(h]h ]h"]h$]h&]uh1jhjHVubeh}(h]h ]h"]h$]h&]uh1jhjcVhM7hjEVubj)}(h&``GFP`` GFP flags for the allocation. h](j)}(h``GFP``h]jS)}(hjVh]hGFP}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjVubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhM8hjVubj)}(hhh]jM)}(hGFP flags for the allocation.h]hGFP flags for the allocation.}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjVhM8hjVubah}(h]h ]h"]h$]h&]uh1jhjVubeh}(h]h ]h"]h$]h&]uh1jhjVhM8hjEVubj)}(h%``TYPE`` type to allocate space for. h](j)}(h``TYPE``h]jS)}(hjVh]hTYPE}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjVubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhM9hjVubj)}(hhh]jM)}(htype to allocate space for.h]htype to allocate space for.}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjVhM9hjVubah}(h]h ]h"]h$]h&]uh1jhjVubeh}(h]h ]h"]h$]h&]uh1jhjVhM9hjEVubj)}(h1``COUNT`` how many **TYPE** objects to allocate. h](j)}(h ``COUNT``h]jS)}(hjVh]hCOUNT}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjVubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhM:hjVubj)}(hhh]jM)}(h&how many **TYPE** objects to allocate.h](h how many }(hjWhhhNhNubj)}(h**TYPE**h]hTYPE}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjWubh objects to allocate.}(hjWhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhjWhM:hjWubah}(h]h ]h"]h$]h&]uh1jhjVubeh}(h]h ]h"]h$]h&]uh1jhjWhM:hjEVubeh}(h]h ]h"]h$]h&]uh1jhj)VubjM)}(h **Return**h]j)}(hjFWh]hReturn}(hjHWhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjDWubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhM<hj)VubjM)}(hmNewly allocated pointer to (first) **TYPE** of **COUNT**-many allocated **TYPE** objects, or NULL on failure.h](h#Newly allocated pointer to (first) }(hj\WhhhNhNubj)}(h**TYPE**h]hTYPE}(hjdWhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj\Wubh of }(hj\WhhhNhNubj)}(h **COUNT**h]hCOUNT}(hjvWhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj\Wubh-many allocated }(hj\WhhhNhNubj)}(h**TYPE**h]hTYPE}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj\Wubh objects, or NULL on failure.}(hj\WhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhM<hj)Vubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjU3hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h__alloc_flex (C macro)c.__alloc_flexhNtauh1hhjU3hhhNhNubh)}(hhh](h)}(h __alloc_flexh]h)}(h __alloc_flexh]h)}(h __alloc_flexh]j)}(hjWh]h __alloc_flex}(hjWhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjWubah}(h]h ](jjeh"]h$]h&]jjuh1hhjWhhhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMFubah}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjWhhhjWhMFubah}(h]jWah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjWhMFhjWhhubj4)}(hhh]h}(h]h ]h"]h$]h&]uh1j3hjWhhhjWhMFubeh}(h]h ](jAmacroeh"]h$]h&]jFjAjGjWjHjWjIjJjKuh1hhhhjU3hNhNubjM)}(h1``__alloc_flex (KMALLOC, GFP, TYPE, FAM, COUNT)``h]jS)}(hjWh]h-__alloc_flex (KMALLOC, GFP, TYPE, FAM, COUNT)}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjWubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMHhjU3hhubji)}(h6Allocate an object that has a trailing flexible array h]jM)}(h5Allocate an object that has a trailing flexible arrayh]h5Allocate an object that has a trailing flexible array}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMFhj Xubah}(h]h ]h"]h$]h&]uh1jhhjXhMFhjU3hhubj)}(hX%**Parameters** ``KMALLOC`` kmalloc wrapper function to use for allocation. ``GFP`` GFP flags for the allocation. ``TYPE`` type of structure to allocate space for. ``FAM`` The name of the flexible array member of **TYPE** structure. ``COUNT`` how many **FAM** elements to allocate space for. **Return** Newly allocated pointer to **TYPE** with **COUNT**-many trailing **FAM** elements, or NULL on failure or if **COUNT** cannot be represented by the member of **TYPE** that counts the **FAM** elements (annotated via __counted_by()).h](jM)}(h**Parameters**h]j)}(hj,Xh]h Parameters}(hj.XhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj*Xubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMJhj&Xubj)}(hhh](j)}(h<``KMALLOC`` kmalloc wrapper function to use for allocation. h](j)}(h ``KMALLOC``h]jS)}(hjKXh]hKMALLOC}(hjMXhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjIXubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMGhjEXubj)}(hhh]jM)}(h/kmalloc wrapper function to use for allocation.h]h/kmalloc wrapper function to use for allocation.}(hjdXhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj`XhMGhjaXubah}(h]h ]h"]h$]h&]uh1jhjEXubeh}(h]h ]h"]h$]h&]uh1jhj`XhMGhjBXubj)}(h&``GFP`` GFP flags for the allocation. h](j)}(h``GFP``h]jS)}(hjXh]hGFP}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjXubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMHhj~Xubj)}(hhh]jM)}(hGFP flags for the allocation.h]hGFP flags for the allocation.}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjXhMHhjXubah}(h]h ]h"]h$]h&]uh1jhj~Xubeh}(h]h ]h"]h$]h&]uh1jhjXhMHhjBXubj)}(h2``TYPE`` type of structure to allocate space for. h](j)}(h``TYPE``h]jS)}(hjXh]hTYPE}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjXubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMIhjXubj)}(hhh]jM)}(h(type of structure to allocate space for.h]h(type of structure to allocate space for.}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjXhMIhjXubah}(h]h ]h"]h$]h&]uh1jhjXubeh}(h]h ]h"]h$]h&]uh1jhjXhMIhjBXubj)}(hE``FAM`` The name of the flexible array member of **TYPE** structure. h](j)}(h``FAM``h]jS)}(hjXh]hFAM}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjXubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMJhjXubj)}(hhh]jM)}(h)}(hsize_t nh](h)}(hhh]j)}(hsize_th]hsize_t}(hjZ_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjW_ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj\_modnameN classnameNjj)}j]j)}jj=_sbc.kmalloc_arrayasbuh1hhjS_ubj)}(h h]h }(hjz_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjS_ubj)}(hjh]hn}(hj_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjS_ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjO_ubj>)}(h size_t sizeh](h)}(hhh]j)}(hsize_th]hsize_t}(hj_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj_ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj_modnameN classnameNjj)}j]jv_c.kmalloc_arrayasbuh1hhj_ubj)}(h h]h }(hj_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj_ubj)}(hsizeh]hsize}(hj_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj_ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjO_ubj>)}(h gfp_t flagsh](h)}(hhh]j)}(hgfp_th]hgfp_t}(hj_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj_ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj_modnameN classnameNjj)}j]jv_c.kmalloc_arrayasbuh1hhj_ubj)}(h h]h }(hj `hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj_ubj)}(hflagsh]hflags}(hj`hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj_ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjO_ubeh}(h]h ]h"]h$]h&]jjuh1j7hj _hhhj_hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj_hhhj_hMubah}(h]j_ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj_hMhj_hhubj4)}(hhh]jM)}(hallocate memory for an array.h]hallocate memory for an array.}(hjA`hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhj>`hhubah}(h]h ]h"]h$]h&]uh1j3hj_hhhj_hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjY`jHjY`jIjJjKuh1hhhhjU3hNhNubj)}(h**Parameters** ``size_t n`` number of elements. ``size_t size`` element size. ``gfp_t flags`` the type of memory to allocate (see kmalloc).h](jM)}(h**Parameters**h]j)}(hjc`h]h Parameters}(hje`hhhNhNubah}(h]h ]h"]h$]h&]uh1jhja`ubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhj]`ubj)}(hhh](j)}(h!``size_t n`` number of elements. h](j)}(h ``size_t n``h]jS)}(hj`h]hsize_t n}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj`ubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhj|`ubj)}(hhh]jM)}(hnumber of elements.h]hnumber of elements.}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj`hMhj`ubah}(h]h ]h"]h$]h&]uh1jhj|`ubeh}(h]h ]h"]h$]h&]uh1jhj`hMhjy`ubj)}(h``size_t size`` element size. h](j)}(h``size_t size``h]jS)}(hj`h]h size_t size}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj`ubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhj`ubj)}(hhh]jM)}(h element size.h]h element size.}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj`hMhj`ubah}(h]h ]h"]h$]h&]uh1jhj`ubeh}(h]h ]h"]h$]h&]uh1jhj`hMhjy`ubj)}(h=``gfp_t flags`` the type of memory to allocate (see kmalloc).h](j)}(h``gfp_t flags``h]jS)}(hj`h]h gfp_t flags}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj`ubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhj`ubj)}(hhh]jM)}(h-the type of memory to allocate (see kmalloc).h]h-the type of memory to allocate (see kmalloc).}(hj ahhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhj aubah}(h]h ]h"]h$]h&]uh1jhj`ubeh}(h]h ]h"]h$]h&]uh1jhj ahMhjy`ubeh}(h]h ]h"]h$]h&]uh1jhj]`ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjU3hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hkrealloc_array (C function)c.krealloc_arrayhNtauh1hhjU3hhhNhNubh)}(hhh](h)}(hKvoid * krealloc_array (void *p, size_t new_n, size_t new_size, gfp_t flags)h]h)}(hIvoid *krealloc_array(void *p, size_t new_n, size_t new_size, gfp_t flags)h](j)}(hvoidh]hvoid}(hjNahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJahhhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMubj)}(h h]h }(hj]ahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJahhhj\ahMubjr)}(hjuh]h*}(hjkahhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjJahhhj\ahMubh)}(hkrealloc_arrayh]j)}(hkrealloc_arrayh]hkrealloc_array}(hj|ahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjxaubah}(h]h ](jjeh"]h$]h&]jjuh1hhjJahhhj\ahMubj8)}(h5(void *p, size_t new_n, size_t new_size, gfp_t flags)h](j>)}(hvoid *ph](j)}(hvoidh]hvoid}(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubj)}(h h]h }(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubjr)}(hjuh]h*}(hjahhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjaubj)}(hj~h]hp}(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjaubj>)}(h size_t new_nh](h)}(hhh]j)}(hsize_th]hsize_t}(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjamodnameN classnameNjj)}j]j)}jj~asbc.krealloc_arrayasbuh1hhjaubj)}(h h]h }(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubj)}(hnew_nh]hnew_n}(hj bhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjaubj>)}(hsize_t new_sizeh](h)}(hhh]j)}(hsize_th]hsize_t}(hj&bhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#bubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj(bmodnameN classnameNjj)}j]jac.krealloc_arrayasbuh1hhjbubj)}(h h]h }(hjDbhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjbubj)}(hnew_sizeh]hnew_size}(hjRbhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjbubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjaubj>)}(h gfp_t flagsh](h)}(hhh]j)}(hgfp_th]hgfp_t}(hjnbhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjkbubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjpbmodnameN classnameNjj)}j]jac.krealloc_arrayasbuh1hhjgbubj)}(h h]h }(hjbhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgbubj)}(hflagsh]hflags}(hjbhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgbubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjaubeh}(h]h ]h"]h$]h&]jjuh1j7hjJahhhj\ahMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjFahhhj\ahMubah}(h]jAaah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj\ahMhjCahhubj4)}(hhh]jM)}(hreallocate memory for an array.h]hreallocate memory for an array.}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhjbhhubah}(h]h ]h"]h$]h&]uh1j3hjCahhhj\ahMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjbjHjbjIjJjKuh1hhhhjU3hNhNubj)}(hX**Parameters** ``void *p`` pointer to the memory chunk to reallocate ``size_t new_n`` new number of elements to alloc ``size_t new_size`` new size of a single member of the array ``gfp_t flags`` the type of memory to allocate (see kmalloc) **Description** If __GFP_ZERO logic is requested, callers must ensure that, starting with the initial memory allocation, every subsequent call to this API for the same memory allocation is flagged with __GFP_ZERO. Otherwise, it is possible that __GFP_ZERO is not fully honored by this API. See krealloc_noprof() for further details. In any case, the contents of the object pointed to are preserved up to the lesser of the new and old sizes.h](jM)}(h**Parameters**h]j)}(hjbh]h Parameters}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjbubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhjbubj)}(hhh](j)}(h6``void *p`` pointer to the memory chunk to reallocate h](j)}(h ``void *p``h]jS)}(hjch]hvoid *p}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjcubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhjbubj)}(hhh]jM)}(h)pointer to the memory chunk to reallocateh]h)pointer to the memory chunk to reallocate}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjchMhjcubah}(h]h ]h"]h$]h&]uh1jhjbubeh}(h]h ]h"]h$]h&]uh1jhjchMhjbubj)}(h1``size_t new_n`` new number of elements to alloc h](j)}(h``size_t new_n``h]jS)}(hj>ch]h size_t new_n}(hj@chhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj)}(h size_t sizeh](h)}(hhh]j)}(hsize_th]hsize_t}(hjehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjemodnameN classnameNjj)}j]j)}jjesb c.kzallocasbuh1hhjeubj)}(h h]h }(hjfhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubj)}(hsizeh]hsize}(hjfhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjeubj>)}(h gfp_t flagsh](h)}(hhh]j)}(hgfp_th]hgfp_t}(hj;fhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj8fubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj=fmodnameN classnameNjj)}j]j f c.kzallocasbuh1hhj4fubj)}(h h]h }(hjYfhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4fubj)}(hflagsh]hflags}(hjgfhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4fubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjeubeh}(h]h ]h"]h$]h&]jjuh1j7hjehhhjehM%ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjehhhjehM%ubah}(h]jeah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjehM%hjehhubj4)}(hhh]jM)}(h+allocate memory. The memory is set to zero.h]h+allocate memory. The memory is set to zero.}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhM%hjfhhubah}(h]h ]h"]h$]h&]uh1j3hjehhhjehM%ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjfjHjfjIjJjKuh1hhhhjU3hNhNubj)}(h**Parameters** ``size_t size`` how many bytes of memory are required. ``gfp_t flags`` the type of memory to allocate (see kmalloc).h](jM)}(h**Parameters**h]j)}(hjfh]h Parameters}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjfubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhM)hjfubj)}(hhh](j)}(h7``size_t size`` how many bytes of memory are required. h](j)}(h``size_t size``h]jS)}(hjfh]h size_t size}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjfubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhM&hjfubj)}(hhh]jM)}(h&how many bytes of memory are required.h]h&how many bytes of memory are required.}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjfhM&hjfubah}(h]h ]h"]h$]h&]uh1jhjfubeh}(h]h ]h"]h$]h&]uh1jhjfhM&hjfubj)}(h=``gfp_t flags`` the type of memory to allocate (see kmalloc).h](j)}(h``gfp_t flags``h]jS)}(hj gh]h gfp_t flags}(hj ghhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj gubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhM(hjgubj)}(hhh]jM)}(h-the type of memory to allocate (see kmalloc).h]h-the type of memory to allocate (see kmalloc).}(hj$ghhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhM'hj!gubah}(h]h ]h"]h$]h&]uh1jhjgubeh}(h]h ]h"]h$]h&]uh1jhj ghM(hjfubeh}(h]h ]h"]h$]h&]uh1jhjfubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjU3hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hkvmalloc_node (C function)c.kvmalloc_nodehNtauh1hhjU3hhhNhNubh)}(hhh](h)}(h9void * kvmalloc_node (size_t size, gfp_t flags, int node)h]h)}(h7void *kvmalloc_node(size_t size, gfp_t flags, int node)h](j)}(hvoidh]hvoid}(hjeghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaghhhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhM6ubj)}(h h]h }(hjtghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaghhhjsghM6ubjr)}(hjuh]h*}(hjghhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjaghhhjsghM6ubh)}(h kvmalloc_nodeh]j)}(h kvmalloc_nodeh]h kvmalloc_node}(hjghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubah}(h]h ](jjeh"]h$]h&]jjuh1hhjaghhhjsghM6ubj8)}(h$(size_t size, gfp_t flags, int node)h](j>)}(h size_t sizeh](h)}(hhh]j)}(hsize_th]hsize_t}(hjghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjgmodnameN classnameNjj)}j]j)}jjgsbc.kvmalloc_nodeasbuh1hhjgubj)}(h h]h }(hjghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubj)}(hsizeh]hsize}(hjghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjgubj>)}(h gfp_t flagsh](h)}(hhh]j)}(hgfp_th]hgfp_t}(hjghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjgmodnameN classnameNjj)}j]jgc.kvmalloc_nodeasbuh1hhjgubj)}(h h]h }(hjhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubj)}(hflagsh]hflags}(hj(hhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjgubj>)}(hint nodeh](j)}(hinth]hint}(hjAhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=hubj)}(h h]h }(hjOhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=hubj)}(hnodeh]hnode}(hj]hhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=hubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjgubeh}(h]h ]h"]h$]h&]jjuh1j7hjaghhhjsghM6ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj]ghhhjsghM6ubah}(h]jXgah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjsghM6hjZghhubj4)}(hhh]jM)}(huattempt to allocate physically contiguous memory, but upon failure, fall back to non-contiguous (vmalloc) allocation.h]huattempt to allocate physically contiguous memory, but upon failure, fall back to non-contiguous (vmalloc) allocation.}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhM6hjhhhubah}(h]h ]h"]h$]h&]uh1j3hjZghhhjsghM6ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjhjHjhjIjJjKuh1hhhhjU3hNhNubj)}(hX**Parameters** ``size_t size`` size of the request. ``gfp_t flags`` gfp mask for the allocation - must be compatible (superset) with GFP_KERNEL. ``int node`` numa node to allocate from **Description** Only alignments up to those guaranteed by kmalloc() will be honored. Please see Documentation/core-api/memory-allocation.rst for more details. Uses kmalloc to get the memory but if the allocation fails then falls back to the vmalloc allocator. Use kvfree for freeing the memory. GFP_NOWAIT and GFP_ATOMIC are supported, the __GFP_NORETRY modifier is not. __GFP_RETRY_MAYFAIL is supported, and it should be used only if kmalloc is preferable to the vmalloc fallback, due to visible performance drawbacks. **Return** pointer to the allocated memory of ``NULL`` in case of failureh](jM)}(h**Parameters**h]j)}(hjhh]h Parameters}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjhubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhM:hjhubj)}(hhh](j)}(h%``size_t size`` size of the request. h](j)}(h``size_t size``h]jS)}(hjhh]h size_t size}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjhubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhM8hjhubj)}(hhh]jM)}(hsize of the request.h]hsize of the request.}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhhM8hjhubah}(h]h ]h"]h$]h&]uh1jhjhubeh}(h]h ]h"]h$]h&]uh1jhjhhM8hjhubj)}(h]``gfp_t flags`` gfp mask for the allocation - must be compatible (superset) with GFP_KERNEL. h](j)}(h``gfp_t flags``h]jS)}(hjih]h gfp_t flags}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjhubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhM9hjhubj)}(hhh]jM)}(hLgfp mask for the allocation - must be compatible (superset) with GFP_KERNEL.h]hLgfp mask for the allocation - must be compatible (superset) with GFP_KERNEL.}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjihM9hjiubah}(h]h ]h"]h$]h&]uh1jhjhubeh}(h]h ]h"]h$]h&]uh1jhjihM9hjhubj)}(h(``int node`` numa node to allocate from h](j)}(h ``int node``h]jS)}(hj:ih]hint node}(hjhjhubjM)}(hGFP_NOWAIT and GFP_ATOMIC are supported, the __GFP_NORETRY modifier is not. __GFP_RETRY_MAYFAIL is supported, and it should be used only if kmalloc is preferable to the vmalloc fallback, due to visible performance drawbacks.h]hGFP_NOWAIT and GFP_ATOMIC are supported, the __GFP_NORETRY modifier is not. __GFP_RETRY_MAYFAIL is supported, and it should be used only if kmalloc is preferable to the vmalloc fallback, due to visible performance drawbacks.}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMAhjhubjM)}(h **Return**h]j)}(hjih]hReturn}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1jhjiubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMEhjhubjM)}(h>pointer to the allocated memory of ``NULL`` in case of failureh](h#pointer to the allocated memory of }(hjihhhNhNubjS)}(h``NULL``h]hNULL}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjiubh in case of failure}(hjihhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMFhjhubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjU3hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h!kvrealloc_node_align (C function)c.kvrealloc_node_alignhNtauh1hhjU3hhhNhNubh)}(hhh](h)}(hcvoid * kvrealloc_node_align (const void *p, size_t size, unsigned long align, gfp_t flags, int nid)h]h)}(havoid *kvrealloc_node_align(const void *p, size_t size, unsigned long align, gfp_t flags, int nid)h](j)}(hvoidh]hvoid}(hjjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj jhhhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMmubj)}(h h]h }(hj jhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj jhhhjjhMmubjr)}(hjuh]h*}(hj.jhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj jhhhjjhMmubh)}(hkvrealloc_node_alignh]j)}(hkvrealloc_node_alignh]hkvrealloc_node_align}(hj?jhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;jubah}(h]h ](jjeh"]h$]h&]jjuh1hhj jhhhjjhMmubj8)}(hG(const void *p, size_t size, unsigned long align, gfp_t flags, int nid)h](j>)}(h const void *ph](j)}(hjh]hconst}(hj[jhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjWjubj)}(h h]h }(hjhjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjWjubj)}(hvoidh]hvoid}(hjvjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjWjubj)}(h h]h }(hjjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjWjubjr)}(hjuh]h*}(hjjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjWjubj)}(hj~h]hp}(hjjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjWjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjSjubj>)}(h size_t sizeh](h)}(hhh]j)}(hsize_th]hsize_t}(hjjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjjmodnameN classnameNjj)}j]j)}jjAjsbc.kvrealloc_node_alignasbuh1hhjjubj)}(h h]h }(hjjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjjubj)}(hsizeh]hsize}(hjjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjSjubj>)}(hunsigned long alignh](j)}(hunsignedh]hunsigned}(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjjubj)}(h h]h }(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjjubj)}(hlongh]hlong}(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjjubj)}(h h]h }(hj+khhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjjubj)}(halignh]halign}(hj9khhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjSjubj>)}(h gfp_t flagsh](h)}(hhh]j)}(hgfp_th]hgfp_t}(hjUkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRkubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjWkmodnameN classnameNjj)}j]jjc.kvrealloc_node_alignasbuh1hhjNkubj)}(h h]h }(hjskhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNkubj)}(hflagsh]hflags}(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNkubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjSjubj>)}(hint nidh](j)}(hinth]hint}(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjkubj)}(h h]h }(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjkubj)}(hnidh]hnid}(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjkubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjSjubeh}(h]h ]h"]h$]h&]jjuh1j7hj jhhhjjhMmubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj jhhhjjhMmubah}(h]jjah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjjhMmhjjhhubj4)}(hhh]jM)}(h,reallocate memory; contents remain unchangedh]h,reallocate memory; contents remain unchanged}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMmhjkhhubah}(h]h ]h"]h$]h&]uh1j3hjjhhhjjhMmubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjkjHjkjIjJjKuh1hhhhjU3hNhNubj)}(hX\**Parameters** ``const void *p`` object to reallocate memory for ``size_t size`` the size to reallocate ``unsigned long align`` desired alignment ``gfp_t flags`` the flags for the page level allocator ``int nid`` NUMA node id **Description** If **p** is ``NULL``, kvrealloc() behaves exactly like kvmalloc(). If **size** is 0 and **p** is not a ``NULL`` pointer, the object pointed to is freed. Only alignments up to those guaranteed by kmalloc() will be honored. Please see Documentation/core-api/memory-allocation.rst for more details. If __GFP_ZERO logic is requested, callers must ensure that, starting with the initial memory allocation, every subsequent call to this API for the same memory allocation is flagged with __GFP_ZERO. Otherwise, it is possible that __GFP_ZERO is not fully honored by this API. In any case, the contents of the object pointed to are preserved up to the lesser of the new and old sizes. This function must not be called concurrently with itself or kvfree() for the same memory allocation. **Return** pointer to the allocated memory or ``NULL`` in case of errorh](jM)}(h**Parameters**h]j)}(hjlh]h Parameters}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjlubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMqhjkubj)}(hhh](j)}(h2``const void *p`` object to reallocate memory for h](j)}(h``const void *p``h]jS)}(hj!lh]h const void *p}(hj#lhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjlubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMnhjlubj)}(hhh]jM)}(hobject to reallocate memory forh]hobject to reallocate memory for}(hj:lhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj6lhMnhj7lubah}(h]h ]h"]h$]h&]uh1jhjlubeh}(h]h ]h"]h$]h&]uh1jhj6lhMnhjlubj)}(h'``size_t size`` the size to reallocate h](j)}(h``size_t size``h]jS)}(hjZlh]h size_t size}(hj\lhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjXlubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMohjTlubj)}(hhh]jM)}(hthe size to reallocateh]hthe size to reallocate}(hjslhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjolhMohjplubah}(h]h ]h"]h$]h&]uh1jhjTlubeh}(h]h ]h"]h$]h&]uh1jhjolhMohjlubj)}(h*``unsigned long align`` desired alignment h](j)}(h``unsigned long align``h]jS)}(hjlh]hunsigned long align}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjlubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMphjlubj)}(hhh]jM)}(hdesired alignmenth]hdesired alignment}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjlhMphjlubah}(h]h ]h"]h$]h&]uh1jhjlubeh}(h]h ]h"]h$]h&]uh1jhjlhMphjlubj)}(h7``gfp_t flags`` the flags for the page level allocator h](j)}(h``gfp_t flags``h]jS)}(hjlh]h gfp_t flags}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjlubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMqhjlubj)}(hhh]jM)}(h&the flags for the page level allocatorh]h&the flags for the page level allocator}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjlhMqhjlubah}(h]h ]h"]h$]h&]uh1jhjlubeh}(h]h ]h"]h$]h&]uh1jhjlhMqhjlubj)}(h``int nid`` NUMA node id h](j)}(h ``int nid``h]jS)}(hjmh]hint nid}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjmubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMrhjlubj)}(hhh]jM)}(h NUMA node idh]h NUMA node id}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjmhMrhjmubah}(h]h ]h"]h$]h&]uh1jhjlubeh}(h]h ]h"]h$]h&]uh1jhjmhMrhjlubeh}(h]h ]h"]h$]h&]uh1jhjkubjM)}(h**Description**h]j)}(hj@mh]h Description}(hjBmhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj>mubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMthjkubjM)}(hIf **p** is ``NULL``, kvrealloc() behaves exactly like kvmalloc(). If **size** is 0 and **p** is not a ``NULL`` pointer, the object pointed to is freed.h](hIf }(hjVmhhhNhNubj)}(h**p**h]hp}(hj^mhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjVmubh is }(hjVmhhhNhNubjS)}(h``NULL``h]hNULL}(hjpmhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjVmubh2, kvrealloc() behaves exactly like kvmalloc(). If }(hjVmhhhNhNubj)}(h**size**h]hsize}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjVmubh is 0 and }(hjVmhhhNhNubj)}(h**p**h]hp}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjVmubh is not a }(hjVmhhhNhNubjS)}(h``NULL``h]hNULL}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjVmubh) pointer, the object pointed to is freed.}(hjVmhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMshjkubjM)}(hOnly alignments up to those guaranteed by kmalloc() will be honored. Please see Documentation/core-api/memory-allocation.rst for more details.h]hOnly alignments up to those guaranteed by kmalloc() will be honored. Please see Documentation/core-api/memory-allocation.rst for more details.}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMvhjkubjM)}(hXIf __GFP_ZERO logic is requested, callers must ensure that, starting with the initial memory allocation, every subsequent call to this API for the same memory allocation is flagged with __GFP_ZERO. Otherwise, it is possible that __GFP_ZERO is not fully honored by this API.h]hXIf __GFP_ZERO logic is requested, callers must ensure that, starting with the initial memory allocation, every subsequent call to this API for the same memory allocation is flagged with __GFP_ZERO. Otherwise, it is possible that __GFP_ZERO is not fully honored by this API.}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMyhjkubjM)}(hkIn any case, the contents of the object pointed to are preserved up to the lesser of the new and old sizes.h]hkIn any case, the contents of the object pointed to are preserved up to the lesser of the new and old sizes.}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhM~hjkubjM)}(heThis function must not be called concurrently with itself or kvfree() for the same memory allocation.h]heThis function must not be called concurrently with itself or kvfree() for the same memory allocation.}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhjkubjM)}(h **Return**h]j)}(hjmh]hReturn}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjmubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhjkubjM)}(h)}(h size_t sizeh](h)}(hhh]j)}(hsize_th]hsize_t}(hjnhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjnmodnameN classnameNjj)}j]jsnc.kmalloc_size_roundupasbuh1hhjnubj)}(h h]h }(hjnhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnubj)}(hsizeh]hsize}(hjnhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjnubah}(h]h ]h"]h$]h&]jjuh1j7hjPnhhhjxnhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjLnhhhjxnhMubah}(h]jGnah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjxnhMhjInhhubj4)}(hhh]jM)}(h0Report allocation bucket size for the given sizeh]h0Report allocation bucket size for the given size}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhjnhhubah}(h]h ]h"]h$]h&]uh1j3hjInhhhjxnhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjojHjojIjJjKuh1hhhhjU3hNhNubj)}(hX!**Parameters** ``size_t size`` Number of bytes to round up from. **Description** This returns the number of bytes that would be available in a kmalloc() allocation of **size** bytes. For example, a 126 byte request would be rounded up to the next sized kmalloc bucket, 128 bytes. (This is strictly for the general-purpose kmalloc()-based allocations, and is not for the pre-sized kmem_cache_alloc()-based allocations.) Use this to kmalloc() the full bucket size ahead of time instead of using ksize() to query the size after an allocation.h](jM)}(h**Parameters**h]j)}(hj!oh]h Parameters}(hj#ohhhNhNubah}(h]h ]h"]h$]h&]uh1jhjoubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhjoubj)}(hhh]j)}(h2``size_t size`` Number of bytes to round up from. h](j)}(h``size_t size``h]jS)}(hj@oh]h size_t size}(hjBohhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj>oubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhj:oubj)}(hhh]jM)}(h!Number of bytes to round up from.h]h!Number of bytes to round up from.}(hjYohhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjUohMhjVoubah}(h]h ]h"]h$]h&]uh1jhj:oubeh}(h]h ]h"]h$]h&]uh1jhjUohMhj7oubah}(h]h ]h"]h$]h&]uh1jhjoubjM)}(h**Description**h]j)}(hj{oh]h Description}(hj}ohhhNhNubah}(h]h ]h"]h$]h&]uh1jhjyoubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhjoubjM)}(hXQThis returns the number of bytes that would be available in a kmalloc() allocation of **size** bytes. For example, a 126 byte request would be rounded up to the next sized kmalloc bucket, 128 bytes. (This is strictly for the general-purpose kmalloc()-based allocations, and is not for the pre-sized kmem_cache_alloc()-based allocations.)h](hVThis returns the number of bytes that would be available in a kmalloc() allocation of }(hjohhhNhNubj)}(h**size**h]hsize}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1jhjoubh bytes. For example, a 126 byte request would be rounded up to the next sized kmalloc bucket, 128 bytes. (This is strictly for the general-purpose kmalloc()-based allocations, and is not for the pre-sized kmem_cache_alloc()-based allocations.)}(hjohhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhjoubjM)}(hxUse this to kmalloc() the full bucket size ahead of time instead of using ksize() to query the size after an allocation.h]hxUse this to kmalloc() the full bucket size ahead of time instead of using ksize() to query the size after an allocation.}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:40: ./include/linux/slab.hhMhjoubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjU3hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h"kmem_cache_alloc_node (C function)c.kmem_cache_alloc_nodehNtauh1hhjU3hhhNhNubh)}(hhh](h)}(hMvoid * kmem_cache_alloc_node (struct kmem_cache *s, gfp_t gfpflags, int node)h]h)}(hKvoid *kmem_cache_alloc_node(struct kmem_cache *s, gfp_t gfpflags, int node)h](j)}(hvoidh]hvoid}(hjohhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjohhhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:43: ./mm/slub.chMubj)}(h h]h }(hjohhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjohhhjohMubjr)}(hjuh]h*}(hjohhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjohhhjohMubh)}(hkmem_cache_alloc_nodeh]j)}(hkmem_cache_alloc_nodeh]hkmem_cache_alloc_node}(hjphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj pubah}(h]h ](jjeh"]h$]h&]jjuh1hhjohhhjohMubj8)}(h0(struct kmem_cache *s, gfp_t gfpflags, int node)h](j>)}(hstruct kmem_cache *sh](j)}(hjJ,h]hstruct}(hj+phhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj'pubj)}(h h]h }(hj8phhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj'pubh)}(hhh]j)}(h kmem_cacheh]h kmem_cache}(hjIphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFpubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjKpmodnameN classnameNjj)}j]j)}jjpsbc.kmem_cache_alloc_nodeasbuh1hhj'pubj)}(h h]h }(hjiphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj'pubjr)}(hjuh]h*}(hjwphhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj'pubj)}(hsh]hs}(hjphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj'pubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj#pubj>)}(hgfp_t gfpflagsh](h)}(hhh]j)}(hgfp_th]hgfp_t}(hjphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjpmodnameN classnameNjj)}j]jepc.kmem_cache_alloc_nodeasbuh1hhjpubj)}(h h]h }(hjphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpubj)}(hgfpflagsh]hgfpflags}(hjphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj#pubj>)}(hint nodeh](j)}(hinth]hint}(hjphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpubj)}(h h]h }(hjphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpubj)}(hnodeh]hnode}(hjqhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj#pubeh}(h]h ]h"]h$]h&]jjuh1j7hjohhhjohMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjohhhjohMubah}(h]joah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjohMhjohhubj4)}(hhh]jM)}(h(Allocate an object on the specified nodeh]h(Allocate an object on the specified node}(hj+qhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:43: ./mm/slub.chMhj(qhhubah}(h]h ]h"]h$]h&]uh1j3hjohhhjohMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjCqjHjCqjIjJjKuh1hhhhjU3hNhNubj)}(hX**Parameters** ``struct kmem_cache *s`` The cache to allocate from. ``gfp_t gfpflags`` See kmalloc(). ``int node`` node number of the target node. **Description** Identical to kmem_cache_alloc but it will allocate memory on the given node, which can improve the performance for cpu bound structures. Fallback to other node is possible if __GFP_THISNODE is not set. **Return** pointer to the new object or ``NULL`` in case of errorh](jM)}(h**Parameters**h]j)}(hjMqh]h Parameters}(hjOqhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjKqubah}(h]h ]h"]h$]h&]uh1jLhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:43: ./mm/slub.chMhjGqubj)}(hhh](j)}(h5``struct kmem_cache *s`` The cache to allocate from. h](j)}(h``struct kmem_cache *s``h]jS)}(hjlqh]hstruct kmem_cache *s}(hjnqhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjjqubah}(h]h ]h"]h$]h&]uh1jhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:43: ./mm/slub.chMhjfqubj)}(hhh]jM)}(hThe cache to allocate from.h]hThe cache to allocate from.}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjqhMhjqubah}(h]h ]h"]h$]h&]uh1jhjfqubeh}(h]h ]h"]h$]h&]uh1jhjqhMhjcqubj)}(h"``gfp_t gfpflags`` See kmalloc(). h](j)}(h``gfp_t gfpflags``h]jS)}(hjqh]hgfp_t gfpflags}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjqubah}(h]h ]h"]h$]h&]uh1jhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:43: ./mm/slub.chMhjqubj)}(hhh]jM)}(hSee kmalloc().h]hSee kmalloc().}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjqhMhjqubah}(h]h ]h"]h$]h&]uh1jhjqubeh}(h]h ]h"]h$]h&]uh1jhjqhMhjcqubj)}(h-``int node`` node number of the target node. h](j)}(h ``int node``h]jS)}(hjqh]hint node}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjqubah}(h]h ]h"]h$]h&]uh1jhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:43: ./mm/slub.chMhjqubj)}(hhh]jM)}(hnode number of the target node.h]hnode number of the target node.}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjqhMhjqubah}(h]h ]h"]h$]h&]uh1jhjqubeh}(h]h ]h"]h$]h&]uh1jhjqhMhjcqubeh}(h]h ]h"]h$]h&]uh1jhjGqubjM)}(h**Description**h]j)}(hjrh]h Description}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjrubah}(h]h ]h"]h$]h&]uh1jLhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:43: ./mm/slub.chMhjGqubjM)}(hIdentical to kmem_cache_alloc but it will allocate memory on the given node, which can improve the performance for cpu bound structures.h]hIdentical to kmem_cache_alloc but it will allocate memory on the given node, which can improve the performance for cpu bound structures.}(hj/rhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:43: ./mm/slub.chMhjGqubjM)}(h@Fallback to other node is possible if __GFP_THISNODE is not set.h]h@Fallback to other node is possible if __GFP_THISNODE is not set.}(hj>rhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:43: ./mm/slub.chMhjGqubjM)}(h **Return**h]j)}(hjOrh]hReturn}(hjQrhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjMrubah}(h]h ]h"]h$]h&]uh1jLhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:43: ./mm/slub.chMhjGqubjM)}(h6pointer to the new object or ``NULL`` in case of errorh](hpointer to the new object or }(hjerhhhNhNubjS)}(h``NULL``h]hNULL}(hjmrhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjerubh in case of error}(hjerhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:43: ./mm/slub.chMhjGqubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjU3hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hkmem_cache_free (C function)c.kmem_cache_freehNtauh1hhjU3hhhNhNubh)}(hhh](h)}(h4void kmem_cache_free (struct kmem_cache *s, void *x)h]h)}(h3void kmem_cache_free(struct kmem_cache *s, void *x)h](j)}(hvoidh]hvoid}(hjrhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjrhhhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:43: ./mm/slub.chMJubj)}(h h]h }(hjrhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjrhhhjrhMJubh)}(hkmem_cache_freeh]j)}(hkmem_cache_freeh]hkmem_cache_free}(hjrhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjrubah}(h]h ](jjeh"]h$]h&]jjuh1hhjrhhhjrhMJubj8)}(h(struct kmem_cache *s, void *x)h](j>)}(hstruct kmem_cache *sh](j)}(hjJ,h]hstruct}(hjrhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjrubj)}(h h]h }(hjrhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjrubh)}(hhh]j)}(h kmem_cacheh]h kmem_cache}(hjshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjrubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjsmodnameN classnameNjj)}j]j)}jjrsbc.kmem_cache_freeasbuh1hhjrubj)}(h h]h }(hj!shhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjrubjr)}(hjuh]h*}(hj/shhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjrubj)}(hjph]hs}(hj)}(hvoid *xh](j)}(hvoidh]hvoid}(hjTshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjPsubj)}(h h]h }(hjbshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjPsubjr)}(hjuh]h*}(hjpshhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjPsubj)}(hxh]hx}(hj}shhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjPsubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjrubeh}(h]h ]h"]h$]h&]jjuh1j7hjrhhhjrhMJubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjrhhhjrhMJubah}(h]jrah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjrhMJhjrhhubj4)}(hhh]jM)}(hDeallocate an objecth]hDeallocate an object}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1jLhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:43: ./mm/slub.chMJhjshhubah}(h]h ]h"]h$]h&]uh1j3hjrhhhjrhMJubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjsjHjsjIjJjKuh1hhhhjU3hNhNubj)}(h**Parameters** ``struct kmem_cache *s`` The cache the allocation was from. ``void *x`` The previously allocated object. **Description** Free an object which was previously allocated from this cache.h](jM)}(h**Parameters**h]j)}(hjsh]h Parameters}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1jhjsubah}(h]h ]h"]h$]h&]uh1jLhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:43: ./mm/slub.chMNhjsubj)}(hhh](j)}(h<``struct kmem_cache *s`` The cache the allocation was from. h](j)}(h``struct kmem_cache *s``h]jS)}(hjsh]hstruct kmem_cache *s}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjsubah}(h]h ]h"]h$]h&]uh1jhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:43: ./mm/slub.chMKhjsubj)}(hhh]jM)}(h"The cache the allocation was from.h]h"The cache the allocation was from.}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjshMKhjsubah}(h]h ]h"]h$]h&]uh1jhjsubeh}(h]h ]h"]h$]h&]uh1jhjshMKhjsubj)}(h-``void *x`` The previously allocated object. h](j)}(h ``void *x``h]jS)}(hj!th]hvoid *x}(hj#thhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjtubah}(h]h ]h"]h$]h&]uh1jhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:43: ./mm/slub.chMLhjtubj)}(hhh]jM)}(h The previously allocated object.h]h The previously allocated object.}(hj:thhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj6thMLhj7tubah}(h]h ]h"]h$]h&]uh1jhjtubeh}(h]h ]h"]h$]h&]uh1jhj6thMLhjsubeh}(h]h ]h"]h$]h&]uh1jhjsubjM)}(h**Description**h]j)}(hj\th]h Description}(hj^thhhNhNubah}(h]h ]h"]h$]h&]uh1jhjZtubah}(h]h ]h"]h$]h&]uh1jLhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:43: ./mm/slub.chMNhjsubjM)}(h>Free an object which was previously allocated from this cache.h]h>Free an object which was previously allocated from this cache.}(hjrthhhNhNubah}(h]h ]h"]h$]h&]uh1jLhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:43: ./mm/slub.chMMhjsubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjU3hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hksize (C function)c.ksizehNtauh1hhjU3hhhNhNubh)}(hhh](h)}(hsize_t ksize (const void *objp)h]h)}(hsize_t ksize(const void *objp)h](h)}(hhh]j)}(hsize_th]hsize_t}(hjthhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjtubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjtmodnameN classnameNjj)}j]j)}jksizesbc.ksizeasbuh1hhjthhhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:43: ./mm/slub.chMubj)}(h h]h }(hjthhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjthhhjthMubh)}(hksizeh]j)}(hjth]hksize}(hjthhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjtubah}(h]h ](jjeh"]h$]h&]jjuh1hhjthhhjthMubj8)}(h(const void *objp)h]j>)}(hconst void *objph](j)}(hjh]hconst}(hjthhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjtubj)}(h h]h }(hjuhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjtubj)}(hvoidh]hvoid}(hjuhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjtubj)}(h h]h }(hjuhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjtubjr)}(hjuh]h*}(hj*uhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjtubj)}(hobjph]hobjp}(hj7uhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjtubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjtubah}(h]h ]h"]h$]h&]jjuh1j7hjthhhjthMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjthhhjthMubah}(h]jtah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjthMhjthhubj4)}(hhh]j^)}(hhh]jc)}(h)Report full size of underlying allocationh]jM)}(hjfuh]h)Report full size of underlying allocation}(hjhuhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:43: ./mm/slub.chMhjduubah}(h]h ]h"]h$]h&]uh1jbhjauhhhjuuhNubah}(h]h ]h"]h$]h&]jjuh1j]hjuuhMhj^uhhubah}(h]h ]h"]h$]h&]uh1j3hjthhhjthMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjujHjujIjJjKuh1hhhhjU3hNhNubj)}(hX**Parameters** ``const void *objp`` pointer to the object **Description** This should only be used internally to query the true size of allocations. It is not meant to be a way to discover the usable size of an allocation after the fact. Instead, use kmalloc_size_roundup(). Using memory beyond the originally requested allocation size may trigger KASAN, UBSAN_BOUNDS, and/or FORTIFY_SOURCE. **Return** size of the actual memory used by **objp** in bytesh](jM)}(h**Parameters**h]j)}(hjuh]h Parameters}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjuubah}(h]h ]h"]h$]h&]uh1jLhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:43: ./mm/slub.chMhjuubj)}(hhh]j)}(h+``const void *objp`` pointer to the object h](j)}(h``const void *objp``h]jS)}(hjuh]hconst void *objp}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjuubah}(h]h ]h"]h$]h&]uh1jhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:43: ./mm/slub.chMhjuubj)}(hhh]jM)}(hpointer to the objecth]hpointer to the object}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjuhMhjuubah}(h]h ]h"]h$]h&]uh1jhjuubeh}(h]h ]h"]h$]h&]uh1jhjuhMhjuubah}(h]h ]h"]h$]h&]uh1jhjuubjM)}(h**Description**h]j)}(hjuh]h Description}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjuubah}(h]h ]h"]h$]h&]uh1jLhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:43: ./mm/slub.chMhjuubjM)}(hX=This should only be used internally to query the true size of allocations. It is not meant to be a way to discover the usable size of an allocation after the fact. Instead, use kmalloc_size_roundup(). Using memory beyond the originally requested allocation size may trigger KASAN, UBSAN_BOUNDS, and/or FORTIFY_SOURCE.h]hX=This should only be used internally to query the true size of allocations. It is not meant to be a way to discover the usable size of an allocation after the fact. Instead, use kmalloc_size_roundup(). Using memory beyond the originally requested allocation size may trigger KASAN, UBSAN_BOUNDS, and/or FORTIFY_SOURCE.}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:43: ./mm/slub.chMhjuubjM)}(h **Return**h]j)}(hjvh]hReturn}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjvubah}(h]h ]h"]h$]h&]uh1jLhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:43: ./mm/slub.chMhjuubjM)}(h3size of the actual memory used by **objp** in bytesh](h"size of the actual memory used by }(hj,vhhhNhNubj)}(h**objp**h]hobjp}(hj4vhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj,vubh in bytes}(hj,vhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:43: ./mm/slub.chMhjuubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjU3hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hkfree (C function)c.kfreehNtauh1hhjU3hhhNhNubh)}(hhh](h)}(hvoid kfree (const void *object)h]h)}(hvoid kfree(const void *object)h](j)}(hvoidh]hvoid}(hjmvhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjivhhhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:43: ./mm/slub.chMubj)}(h h]h }(hj|vhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjivhhhj{vhMubh)}(hkfreeh]j)}(hkfreeh]hkfree}(hjvhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvubah}(h]h ](jjeh"]h$]h&]jjuh1hhjivhhhj{vhMubj8)}(h(const void *object)h]j>)}(hconst void *objecth](j)}(hjh]hconst}(hjvhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvubj)}(h h]h }(hjvhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvubj)}(hvoidh]hvoid}(hjvhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvubj)}(h h]h }(hjvhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvubjr)}(hjuh]h*}(hjvhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjvubj)}(hobjecth]hobject}(hjvhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjvubah}(h]h ]h"]h$]h&]jjuh1j7hjivhhhj{vhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjevhhhj{vhMubah}(h]j`vah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj{vhMhjbvhhubj4)}(hhh]jM)}(h free previously allocated memoryh]h free previously allocated memory}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:43: ./mm/slub.chMhjwhhubah}(h]h ]h"]h$]h&]uh1j3hjbvhhhj{vhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj0wjHj0wjIjJjKuh1hhhhjU3hNhNubj)}(h**Parameters** ``const void *object`` pointer returned by kmalloc(), kmalloc_nolock(), or kmem_cache_alloc() **Description** If **object** is NULL, no operation is performed.h](jM)}(h**Parameters**h]j)}(hj:wh]h Parameters}(hj)}(hconst void *addrh](j)}(hjh]hconst}(hj(xhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$xubj)}(h h]h }(hj5xhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$xubj)}(hvoidh]hvoid}(hjCxhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$xubj)}(h h]h }(hjQxhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$xubjr)}(hjuh]h*}(hj_xhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj$xubj)}(haddrh]haddr}(hjlxhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$xubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj xubah}(h]h ]h"]h$]h&]jjuh1j7hjwhhhjwhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjwhhhjwhMubah}(h]jwah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjwhMhjwhhubj4)}(hhh]jM)}(h Free memory.h]h Free memory.}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:43: ./mm/slub.chMhjxhhubah}(h]h ]h"]h$]h&]uh1j3hjwhhhjwhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjxjHjxjIjJjKuh1hhhhjU3hNhNubj)}(hXP**Parameters** ``const void *addr`` Pointer to allocated memory. **Description** kvfree frees memory allocated by any of vmalloc(), kmalloc() or kvmalloc(). It is slightly more efficient to use kfree() or vfree() if you are certain that you know which one to use. **Context** Either preemptible task context or not-NMI interrupt.h](jM)}(h**Parameters**h]j)}(hjxh]h Parameters}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjxubah}(h]h ]h"]h$]h&]uh1jLhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:43: ./mm/slub.chMhjxubj)}(hhh]j)}(h2``const void *addr`` Pointer to allocated memory. h](j)}(h``const void *addr``h]jS)}(hjxh]hconst void *addr}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjxubah}(h]h ]h"]h$]h&]uh1jhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:43: ./mm/slub.chMhjxubj)}(hhh]jM)}(hPointer to allocated memory.h]hPointer to allocated memory.}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjxhMhjxubah}(h]h ]h"]h$]h&]uh1jhjxubeh}(h]h ]h"]h$]h&]uh1jhjxhMhjxubah}(h]h ]h"]h$]h&]uh1jhjxubjM)}(h**Description**h]j)}(hjyh]h Description}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjyubah}(h]h ]h"]h$]h&]uh1jLhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:43: ./mm/slub.chMhjxubjM)}(hkvfree frees memory allocated by any of vmalloc(), kmalloc() or kvmalloc(). It is slightly more efficient to use kfree() or vfree() if you are certain that you know which one to use.h]hkvfree frees memory allocated by any of vmalloc(), kmalloc() or kvmalloc(). It is slightly more efficient to use kfree() or vfree() if you are certain that you know which one to use.}(hj(yhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:43: ./mm/slub.chMhjxubjM)}(h **Context**h]j)}(hj9yh]hContext}(hj;yhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj7yubah}(h]h ]h"]h$]h&]uh1jLhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:43: ./mm/slub.chM hjxubjM)}(h5Either preemptible task context or not-NMI interrupt.h]h5Either preemptible task context or not-NMI interrupt.}(hjOyhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:43: ./mm/slub.chM hjxubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjU3hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hkvfree_atomic (C function)c.kvfree_atomichNtauh1hhjU3hhhNhNubh)}(hhh](h)}(h%void kvfree_atomic (const void *addr)h]h)}(h$void kvfree_atomic(const void *addr)h](j)}(hvoidh]hvoid}(hj~yhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjzyhhhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:43: ./mm/slub.chMubj)}(h h]h }(hjyhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjzyhhhjyhMubh)}(h kvfree_atomich]j)}(h kvfree_atomich]h kvfree_atomic}(hjyhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyubah}(h]h ](jjeh"]h$]h&]jjuh1hhjzyhhhjyhMubj8)}(h(const void *addr)h]j>)}(hconst void *addrh](j)}(hjh]hconst}(hjyhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyubj)}(h h]h }(hjyhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyubj)}(hvoidh]hvoid}(hjyhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyubj)}(h h]h }(hjyhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyubjr)}(hjuh]h*}(hjyhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjyubj)}(haddrh]haddr}(hjyhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjyubah}(h]h ]h"]h$]h&]jjuh1j7hjzyhhhjyhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjvyhhhjyhMubah}(h]jqyah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjyhMhjsyhhubj4)}(hhh]jM)}(h Free memory.h]h Free memory.}(hj)zhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:43: ./mm/slub.chMhj&zhhubah}(h]h ]h"]h$]h&]uh1j3hjsyhhhjyhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjAzjHjAzjIjJjKuh1hhhhjU3hNhNubj)}(h**Parameters** ``const void *addr`` Pointer to allocated memory. **Description** Same as kvfree(), but uses vfree_atomic() for vmalloc backed memory. Must not be called from NMI context.h](jM)}(h**Parameters**h]j)}(hjKzh]h Parameters}(hjMzhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjIzubah}(h]h ]h"]h$]h&]uh1jLhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:43: ./mm/slub.chMhjEzubj)}(hhh]j)}(h2``const void *addr`` Pointer to allocated memory. h](j)}(h``const void *addr``h]jS)}(hjjzh]hconst void *addr}(hjlzhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjhzubah}(h]h ]h"]h$]h&]uh1jhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:43: ./mm/slub.chMhjdzubj)}(hhh]jM)}(hPointer to allocated memory.h]hPointer to allocated memory.}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjzhMhjzubah}(h]h ]h"]h$]h&]uh1jhjdzubeh}(h]h ]h"]h$]h&]uh1jhjzhMhjazubah}(h]h ]h"]h$]h&]uh1jhjEzubjM)}(h**Description**h]j)}(hjzh]h Description}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjzubah}(h]h ]h"]h$]h&]uh1jLhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:43: ./mm/slub.chMhjEzubjM)}(hiSame as kvfree(), but uses vfree_atomic() for vmalloc backed memory. Must not be called from NMI context.h]hiSame as kvfree(), but uses vfree_atomic() for vmalloc backed memory. Must not be called from NMI context.}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:43: ./mm/slub.chMhjEzubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjU3hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hkvfree_sensitive (C function)c.kvfree_sensitivehNtauh1hhjU3hhhNhNubh)}(hhh](h)}(h4void kvfree_sensitive (const void *addr, size_t len)h]h)}(h3void kvfree_sensitive(const void *addr, size_t len)h](j)}(hvoidh]hvoid}(hjzhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjzhhhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:43: ./mm/slub.chM&ubj)}(h h]h }(hjzhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjzhhhjzhM&ubh)}(hkvfree_sensitiveh]j)}(hkvfree_sensitiveh]hkvfree_sensitive}(hj {hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjzhhhjzhM&ubj8)}(h(const void *addr, size_t len)h](j>)}(hconst void *addrh](j)}(hjh]hconst}(hj'{hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#{ubj)}(h h]h }(hj4{hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#{ubj)}(hvoidh]hvoid}(hjB{hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#{ubj)}(h h]h }(hjP{hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#{ubjr)}(hjuh]h*}(hj^{hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj#{ubj)}(haddrh]haddr}(hjk{hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#{ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj{ubj>)}(h size_t lenh](h)}(hhh]j)}(hsize_th]hsize_t}(hj{hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj{modnameN classnameNjj)}j]j)}jj {sbc.kvfree_sensitiveasbuh1hhj{ubj)}(h h]h }(hj{hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{ubj)}(hlenh]hlen}(hj{hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj{ubeh}(h]h ]h"]h$]h&]jjuh1j7hjzhhhjzhM&ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjzhhhjzhM&ubah}(h]jzah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjzhM&hjzhhubj4)}(hhh]jM)}(h4Free a data object containing sensitive information.h]h4Free a data object containing sensitive information.}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:43: ./mm/slub.chM&hj{hhubah}(h]h ]h"]h$]h&]uh1j3hjzhhhjzhM&ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj{jHj{jIjJjKuh1hhhhjU3hNhNubj)}(hXE**Parameters** ``const void *addr`` address of the data object to be freed. ``size_t len`` length of the data object. **Description** Use the special memzero_explicit() function to clear the content of a kvmalloc'ed object containing sensitive data to make sure that the compiler won't optimize out the data clearing.h](jM)}(h**Parameters**h]j)}(hj|h]h Parameters}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj{ubah}(h]h ]h"]h$]h&]uh1jLhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:43: ./mm/slub.chM*hj{ubj)}(hhh](j)}(h=``const void *addr`` address of the data object to be freed. h](j)}(h``const void *addr``h]jS)}(hj |h]hconst void *addr}(hj"|hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj|ubah}(h]h ]h"]h$]h&]uh1jhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:43: ./mm/slub.chM'hj|ubj)}(hhh]jM)}(h'address of the data object to be freed.h]h'address of the data object to be freed.}(hj9|hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj5|hM'hj6|ubah}(h]h ]h"]h$]h&]uh1jhj|ubeh}(h]h ]h"]h$]h&]uh1jhj5|hM'hj|ubj)}(h*``size_t len`` length of the data object. h](j)}(h``size_t len``h]jS)}(hjY|h]h size_t len}(hj[|hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjW|ubah}(h]h ]h"]h$]h&]uh1jhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:43: ./mm/slub.chM(hjS|ubj)}(hhh]jM)}(hlength of the data object.h]hlength of the data object.}(hjr|hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjn|hM(hjo|ubah}(h]h ]h"]h$]h&]uh1jhjS|ubeh}(h]h ]h"]h$]h&]uh1jhjn|hM(hj|ubeh}(h]h ]h"]h$]h&]uh1jhj{ubjM)}(h**Description**h]j)}(hj|h]h Description}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj|ubah}(h]h ]h"]h$]h&]uh1jLhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:43: ./mm/slub.chM*hj{ubjM)}(hUse the special memzero_explicit() function to clear the content of a kvmalloc'ed object containing sensitive data to make sure that the compiler won't optimize out the data clearing.h]hUse the special memzero_explicit() function to clear the content of a kvmalloc’ed object containing sensitive data to make sure that the compiler won’t optimize out the data clearing.}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:43: ./mm/slub.chM)hj{ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjU3hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h"kmem_cache_alloc_bulk (C function)c.kmem_cache_alloc_bulkhNtauh1hhjU3hhhNhNubh)}(hhh](h)}(hUbool kmem_cache_alloc_bulk (struct kmem_cache *s, gfp_t flags, size_t size, void **p)h]h)}(hTbool kmem_cache_alloc_bulk(struct kmem_cache *s, gfp_t flags, size_t size, void **p)h](j)}(hjh]hbool}(hj|hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|hhhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:43: ./mm/slub.chMubj)}(h h]h }(hj|hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|hhhj|hMubh)}(hkmem_cache_alloc_bulkh]j)}(hkmem_cache_alloc_bulkh]hkmem_cache_alloc_bulk}(hj|hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj|hhhj|hMubj8)}(h:(struct kmem_cache *s, gfp_t flags, size_t size, void **p)h](j>)}(hstruct kmem_cache *sh](j)}(hjJ,h]hstruct}(hj}hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj}ubj)}(h h]h }(hj"}hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj}ubh)}(hhh]j)}(h kmem_cacheh]h kmem_cache}(hj3}hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0}ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj5}modnameN classnameNjj)}j]j)}jj|sbc.kmem_cache_alloc_bulkasbuh1hhj}ubj)}(h h]h }(hjS}hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj}ubjr)}(hjuh]h*}(hja}hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj}ubj)}(hjph]hs}(hjn}hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj}ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj }ubj>)}(h gfp_t flagsh](h)}(hhh]j)}(hgfp_th]hgfp_t}(hj}hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj}ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj}modnameN classnameNjj)}j]jO}c.kmem_cache_alloc_bulkasbuh1hhj}ubj)}(h h]h }(hj}hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj}ubj)}(hflagsh]hflags}(hj}hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj}ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj }ubj>)}(h size_t sizeh](h)}(hhh]j)}(hsize_th]hsize_t}(hj}hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj}ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj}modnameN classnameNjj)}j]jO}c.kmem_cache_alloc_bulkasbuh1hhj}ubj)}(h h]h }(hj}hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj}ubj)}(hsizeh]hsize}(hj}hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj}ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj }ubj>)}(hvoid **ph](j)}(hvoidh]hvoid}(hj~hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~ubj)}(h h]h }(hj$~hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~ubjr)}(hjuh]h*}(hj2~hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj~ubjr)}(hjuh]h*}(hj?~hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj~ubj)}(hj~h]hp}(hjL~hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj }ubeh}(h]h ]h"]h$]h&]jjuh1j7hj|hhhj|hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj|hhhj|hMubah}(h]j|ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj|hMhj|hhubj4)}(hhh]jM)}(hAllocate multiple objectsh]hAllocate multiple objects}(hju~hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:43: ./mm/slub.chMhjr~hhubah}(h]h ]h"]h$]h&]uh1j3hj|hhhj|hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj~jHj~jIjJjKuh1hhhhjU3hNhNubj)}(hXY**Parameters** ``struct kmem_cache *s`` The cache to allocate from ``gfp_t flags`` GFP_* flags. See kmalloc(). ``size_t size`` Number of objects to allocate ``void **p`` Array of allocated objects **Description** Allocate **size** objects from **s** and places them into **p**. **size** must be larger than 0. Interrupts must be enabled when calling this function. Unlike alloc_pages_bulk(), this function does not check for already allocated objects in **p**, and thus the caller does not need to zero it. **Return** ``true`` if the allocation succeeded, or ``false`` if it failed.h](jM)}(h**Parameters**h]j)}(hj~h]h Parameters}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj~ubah}(h]h ]h"]h$]h&]uh1jLhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:43: ./mm/slub.chMhj~ubj)}(hhh](j)}(h4``struct kmem_cache *s`` The cache to allocate from h](j)}(h``struct kmem_cache *s``h]jS)}(hj~h]hstruct kmem_cache *s}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj~ubah}(h]h ]h"]h$]h&]uh1jhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:43: ./mm/slub.chMhj~ubj)}(hhh]jM)}(hThe cache to allocate fromh]hThe cache to allocate from}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj~hMhj~ubah}(h]h ]h"]h$]h&]uh1jhj~ubeh}(h]h ]h"]h$]h&]uh1jhj~hMhj~ubj)}(h,``gfp_t flags`` GFP_* flags. See kmalloc(). h](j)}(h``gfp_t flags``h]jS)}(hj~h]h gfp_t flags}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj~ubah}(h]h ]h"]h$]h&]uh1jhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:43: ./mm/slub.chMhj~ubj)}(hhh]jM)}(hGFP_* flags. See kmalloc().h]hGFP_* flags. See kmalloc().}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhj~ubeh}(h]h ]h"]h$]h&]uh1jhjhMhj~ubj)}(h.``size_t size`` Number of objects to allocate h](j)}(h``size_t size``h]jS)}(hj(h]h size_t size}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj&ubah}(h]h ]h"]h$]h&]uh1jhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:43: ./mm/slub.chMhj"ubj)}(hhh]jM)}(hNumber of objects to allocateh]hNumber of objects to allocate}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj=hMhj>ubah}(h]h ]h"]h$]h&]uh1jhj"ubeh}(h]h ]h"]h$]h&]uh1jhj=hMhj~ubj)}(h(``void **p`` Array of allocated objects h](j)}(h ``void **p``h]jS)}(hjah]hvoid **p}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj_ubah}(h]h ]h"]h$]h&]uh1jhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:43: ./mm/slub.chMhj[ubj)}(hhh]jM)}(hArray of allocated objectsh]hArray of allocated objects}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjvhMhjwubah}(h]h ]h"]h$]h&]uh1jhj[ubeh}(h]h ]h"]h$]h&]uh1jhjvhMhj~ubeh}(h]h ]h"]h$]h&]uh1jhj~ubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:43: ./mm/slub.chMhj~ubjM)}(haAllocate **size** objects from **s** and places them into **p**. **size** must be larger than 0.h](h Allocate }(hjhhhNhNubj)}(h**size**h]hsize}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh objects from }(hjhhhNhNubj)}(h**s**h]hs}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh and places them into }(hjhhhNhNubj)}(h**p**h]hp}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh. }(hjhhhNhNubj)}(h**size**h]hsize}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh must be larger than 0.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:43: ./mm/slub.chMhj~ubjM)}(h6Interrupts must be enabled when calling this function.h]h6Interrupts must be enabled when calling this function.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:43: ./mm/slub.chMhj~ubjM)}(hUnlike alloc_pages_bulk(), this function does not check for already allocated objects in **p**, and thus the caller does not need to zero it.h](hYUnlike alloc_pages_bulk(), this function does not check for already allocated objects in }(hjhhhNhNubj)}(h**p**h]hp}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh/, and thus the caller does not need to zero it.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:43: ./mm/slub.chMhj~ubjM)}(h **Return**h]j)}(hj;h]hReturn}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj9ubah}(h]h ]h"]h$]h&]uh1jLhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:43: ./mm/slub.chMhj~ubjM)}(h@``true`` if the allocation succeeded, or ``false`` if it failed.h](jS)}(h``true``h]htrue}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjQubh! if the allocation succeeded, or }(hjQhhhNhNubjS)}(h ``false``h]hfalse}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjQubh if it failed.}(hjQhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:43: ./mm/slub.chMhj~ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjU3hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h%__kmem_cache_create_args (C function)c.__kmem_cache_create_argshNtauh1hhjU3hhhNhNubh)}(hhh](h)}(hstruct kmem_cache * __kmem_cache_create_args (const char *name, unsigned int object_size, struct kmem_cache_args *args, slab_flags_t flags)h]h)}(hstruct kmem_cache *__kmem_cache_create_args(const char *name, unsigned int object_size, struct kmem_cache_args *args, slab_flags_t flags)h](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:46: ./mm/slab_common.chM$ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM$ubh)}(hhh]j)}(h kmem_cacheh]h kmem_cache}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}j__kmem_cache_create_argssbc.__kmem_cache_create_argsasbuh1hhjhhhjhM$ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM$ubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjhhhjhM$ubh)}(h__kmem_cache_create_argsh]j)}(hj݀h]h__kmem_cache_create_args}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhM$ubj8)}(h^(const char *name, unsigned int object_size, struct kmem_cache_args *args, slab_flags_t flags)h](j>)}(hconst char *nameh](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hcharh]hchar}(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjQhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hnameh]hname}(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hunsigned int object_sizeh](j)}(hunsignedh]hunsigned}(hjwhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjsubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjsubj)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjsubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjsubj)}(h object_sizeh]h object_size}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjsubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hstruct kmem_cache_args *argsh](j)}(hjJ,h]hstruct}(hjȁhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjāubj)}(h h]h }(hjՁhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjāubh)}(hhh]j)}(hkmem_cache_argsh]hkmem_cache_args}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jۀc.__kmem_cache_create_argsasbuh1hhjāubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjāubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjāubj)}(hargsh]hargs}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjāubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hslab_flags_t flagsh](h)}(hhh]j)}(h slab_flags_th]h slab_flags_t}(hj;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj8ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj=modnameN classnameNjj)}j]jۀc.__kmem_cache_create_argsasbuh1hhj4ubj)}(h h]h }(hjYhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4ubj)}(hflagsh]hflags}(hjghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhM$ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhM$ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhM$hjhhubj4)}(hhh]jM)}(hCreate a kmem cache.h]hCreate a kmem cache.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:46: ./mm/slab_common.chM$hjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhM$ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjU3hNhNubj)}(hX**Parameters** ``const char *name`` A string which is used in /proc/slabinfo to identify this cache. ``unsigned int object_size`` The size of objects to be created in this cache. ``struct kmem_cache_args *args`` Additional arguments for the cache creation (see :c:type:`struct kmem_cache_args `). ``slab_flags_t flags`` See the descriptions of individual flags. The common ones are listed in the description below. **Description** Not to be called directly, use the kmem_cache_create() wrapper with the same parameters. Commonly used **flags**: :c:type:`SLAB_ACCOUNT` - Account allocations to memcg. :c:type:`SLAB_HWCACHE_ALIGN` - Align objects on cache line boundaries. :c:type:`SLAB_RECLAIM_ACCOUNT` - Objects are reclaimable. :c:type:`SLAB_TYPESAFE_BY_RCU` - Slab page (not individual objects) freeing delayed by a grace period - see the full description before using. **Context** Cannot be called within an interrupt, but can be interrupted. **Return** a pointer to the cache on success, NULL on failure.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:46: ./mm/slab_common.chM(hjubj)}(hhh](j)}(hV``const char *name`` A string which is used in /proc/slabinfo to identify this cache. h](j)}(h``const char *name``h]jS)}(hj҂h]hconst char *name}(hjԂhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjЂubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:46: ./mm/slab_common.chM%hĵubj)}(hhh]jM)}(h@A string which is used in /proc/slabinfo to identify this cache.h]h@A string which is used in /proc/slabinfo to identify this cache.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM%hjubah}(h]h ]h"]h$]h&]uh1jhĵubeh}(h]h ]h"]h$]h&]uh1jhjhM%hjɂubj)}(hN``unsigned int object_size`` The size of objects to be created in this cache. h](j)}(h``unsigned int object_size``h]jS)}(hj h]hunsigned int object_size}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:46: ./mm/slab_common.chM&hjubj)}(hhh]jM)}(h0The size of objects to be created in this cache.h]h0The size of objects to be created in this cache.}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj hM&hj!ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj hM&hjɂubj)}(h``struct kmem_cache_args *args`` Additional arguments for the cache creation (see :c:type:`struct kmem_cache_args `). h](j)}(h ``struct kmem_cache_args *args``h]jS)}(hjDh]hstruct kmem_cache_args *args}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjBubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:46: ./mm/slab_common.chM(hj>ubj)}(hhh]jM)}(heAdditional arguments for the cache creation (see :c:type:`struct kmem_cache_args `).h](h1Additional arguments for the cache creation (see }(hj]hhhNhNubh)}(h2:c:type:`struct kmem_cache_args `h]jS)}(hjgh]hstruct kmem_cache_args}(hjihhhNhNubah}(h]h ](j%4jAc-typeeh"]h$]h&]uh1jRhjeubah}(h]h ]h"]h$]h&]refdocj14 refdomainjAreftypetype refexplicitrefwarnjj74j:4kmem_cache_argsuh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:46: ./mm/slab_common.chM'hj]ubh).}(hj]hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhjhM'hjZubah}(h]h ]h"]h$]h&]uh1jhj>ubeh}(h]h ]h"]h$]h&]uh1jhjYhM(hjɂubj)}(hv``slab_flags_t flags`` See the descriptions of individual flags. The common ones are listed in the description below. h](j)}(h``slab_flags_t flags``h]jS)}(hjh]hslab_flags_t flags}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:46: ./mm/slab_common.chM*hjubj)}(hhh]jM)}(h^See the descriptions of individual flags. The common ones are listed in the description below.h]h^See the descriptions of individual flags. The common ones are listed in the description below.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:46: ./mm/slab_common.chM)hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM*hjɂubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hj݃h]h Description}(hj߃hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjۃubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:46: ./mm/slab_common.chM,hjubjM)}(hXNot to be called directly, use the kmem_cache_create() wrapper with the same parameters.h]hXNot to be called directly, use the kmem_cache_create() wrapper with the same parameters.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:46: ./mm/slab_common.chM+hjubjM)}(hCommonly used **flags**:h](hCommonly used }(hjhhhNhNubj)}(h **flags**h]hflags}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh:}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:46: ./mm/slab_common.chM.hjubjM)}(h6:c:type:`SLAB_ACCOUNT` - Account allocations to memcg.h](h)}(h:c:type:`SLAB_ACCOUNT`h]jS)}(hj)h]h SLAB_ACCOUNT}(hj+hhhNhNubah}(h]h ](j%4jAc-typeeh"]h$]h&]uh1jRhj'ubah}(h]h ]h"]h$]h&]refdocj14 refdomainjAreftypetype refexplicitrefwarnjj74j:4 SLAB_ACCOUNTuh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:46: ./mm/slab_common.chM0hj#ubh - Account allocations to memcg.}(hj#hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhjFhM0hjubjM)}(hF:c:type:`SLAB_HWCACHE_ALIGN` - Align objects on cache line boundaries.h](h)}(h:c:type:`SLAB_HWCACHE_ALIGN`h]jS)}(hjWh]hSLAB_HWCACHE_ALIGN}(hjYhhhNhNubah}(h]h ](j%4jAc-typeeh"]h$]h&]uh1jRhjUubah}(h]h ]h"]h$]h&]refdocj14 refdomainjAreftypetype refexplicitrefwarnjj74j:4SLAB_HWCACHE_ALIGNuh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:46: ./mm/slab_common.chM2hjQubh* - Align objects on cache line boundaries.}(hjQhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhjthM2hjubjM)}(h9:c:type:`SLAB_RECLAIM_ACCOUNT` - Objects are reclaimable.h](h)}(h:c:type:`SLAB_RECLAIM_ACCOUNT`h]jS)}(hjh]hSLAB_RECLAIM_ACCOUNT}(hjhhhNhNubah}(h]h ](j%4jAc-typeeh"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]refdocj14 refdomainjAreftypetype refexplicitrefwarnjj74j:4SLAB_RECLAIM_ACCOUNTuh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:46: ./mm/slab_common.chM4hjubh - Objects are reclaimable.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhjhM4hjubjM)}(h:c:type:`SLAB_TYPESAFE_BY_RCU` - Slab page (not individual objects) freeing delayed by a grace period - see the full description before using.h](h)}(h:c:type:`SLAB_TYPESAFE_BY_RCU`h]jS)}(hjh]hSLAB_TYPESAFE_BY_RCU}(hjhhhNhNubah}(h]h ](j%4jAc-typeeh"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]refdocj14 refdomainjAreftypetype refexplicitrefwarnjj74j:4SLAB_TYPESAFE_BY_RCUuh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:46: ./mm/slab_common.chM6hjubhp - Slab page (not individual objects) freeing delayed by a grace period - see the full description before using.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhjЄhM6hjubjM)}(h **Context**h]j)}(hj݄h]hContext}(hj߄hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjۄubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:46: ./mm/slab_common.chM9hjubjM)}(h=Cannot be called within an interrupt, but can be interrupted.h]h=Cannot be called within an interrupt, but can be interrupted.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:46: ./mm/slab_common.chM:hjubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:46: ./mm/slab_common.chM<hjubjM)}(h3a pointer to the cache on success, NULL on failure.h]h3a pointer to the cache on success, NULL on failure.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:46: ./mm/slab_common.chM<hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjU3hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h kmem_buckets_create (C function)c.kmem_buckets_createhNtauh1hhjU3hhhNhNubh)}(hhh](h)}(hkmem_buckets * kmem_buckets_create (const char *name, slab_flags_t flags, unsigned int useroffset, unsigned int usersize, void (*ctor)(void *))h]h)}(hkmem_buckets *kmem_buckets_create(const char *name, slab_flags_t flags, unsigned int useroffset, unsigned int usersize, void (*ctor)(void*))h](h)}(hhh]j)}(h kmem_bucketsh]h kmem_buckets}(hjLhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjNmodnameN classnameNjj)}j]j)}jkmem_buckets_createsbc.kmem_buckets_createasbuh1hhjEhhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:46: ./mm/slab_common.chMubj)}(h h]h }(hjnhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEhhhjmhMubjr)}(hjuh]h*}(hj|hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjEhhhjmhMubh)}(hkmem_buckets_createh]j)}(hjjh]hkmem_buckets_create}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjEhhhjmhMubj8)}(hk(const char *name, slab_flags_t flags, unsigned int useroffset, unsigned int usersize, void (*ctor)(void*))h](j>)}(hconst char *nameh](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hcharh]hchar}(hjÅhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjхhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hj߅hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hnameh]hname}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hslab_flags_t flagsh](h)}(hhh]j)}(h slab_flags_th]h slab_flags_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj modnameN classnameNjj)}j]jhc.kmem_buckets_createasbuh1hhjubj)}(h h]h }(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hflagsh]hflags}(hj4hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hunsigned int useroffseth](j)}(hunsignedh]hunsigned}(hjMhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIubj)}(h h]h }(hj[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIubj)}(hinth]hint}(hjihhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIubj)}(h h]h }(hjwhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIubj)}(h useroffseth]h useroffset}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hunsigned int usersizeh](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjȆhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(husersizeh]husersize}(hjֆhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hvoid (*ctor)(void*)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hj?h]h(}(hj hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hctorh]hctor}(hj%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hj?h]h)}(hj3hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubjr)}(hj?h]h(}(hj@hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hvoidh]hvoid}(hjMhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hj[hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubjr)}(hj?h]h)}(hjhhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjEhhhjmhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjAhhhjmhMubah}(h]j<ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjmhMhj>hhubj4)}(hhh]jM)}(hUCreate a set of caches that handle dynamic sized allocations via kmem_buckets_alloc()h]hUCreate a set of caches that handle dynamic sized allocations via kmem_buckets_alloc()}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:46: ./mm/slab_common.chMhjhhubah}(h]h ]h"]h$]h&]uh1j3hj>hhhjmhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjU3hNhNubj)}(hX**Parameters** ``const char *name`` A prefix string which is used in /proc/slabinfo to identify this cache. The individual caches with have their sizes as the suffix. ``slab_flags_t flags`` SLAB flags (see kmem_cache_create() for details). ``unsigned int useroffset`` Starting offset within an allocation that may be copied to/from userspace. ``unsigned int usersize`` How many bytes, starting at **useroffset**, may be copied to/from userspace. ``void (*ctor)(void *)`` A constructor for the objects, run when new allocations are made. **Context** Cannot be called within an interrupt, but can be interrupted. **Return** a pointer to the cache on success, NULL on failure. When CONFIG_SLAB_BUCKETS is not enabled, ZERO_SIZE_PTR is returned, and subsequent calls to kmem_buckets_alloc() will fall back to kmalloc(). (i.e. callers only need to check for NULL on failure.)h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:46: ./mm/slab_common.chMhjubj)}(hhh](j)}(h``const char *name`` A prefix string which is used in /proc/slabinfo to identify this cache. The individual caches with have their sizes as the suffix. h](j)}(h``const char *name``h]jS)}(hj҇h]hconst char *name}(hjԇhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjЇubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:46: ./mm/slab_common.chMhj̇ubj)}(hhh]jM)}(hA prefix string which is used in /proc/slabinfo to identify this cache. The individual caches with have their sizes as the suffix.h]hA prefix string which is used in /proc/slabinfo to identify this cache. The individual caches with have their sizes as the suffix.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:46: ./mm/slab_common.chMhjubah}(h]h ]h"]h$]h&]uh1jhj̇ubeh}(h]h ]h"]h$]h&]uh1jhjhMhjɇubj)}(hI``slab_flags_t flags`` SLAB flags (see kmem_cache_create() for details). h](j)}(h``slab_flags_t flags``h]jS)}(hj h]hslab_flags_t flags}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:46: ./mm/slab_common.chMhjubj)}(hhh]jM)}(h1SLAB flags (see kmem_cache_create() for details).h]h1SLAB flags (see kmem_cache_create() for details).}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj!hMhj"ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj!hMhjɇubj)}(hg``unsigned int useroffset`` Starting offset within an allocation that may be copied to/from userspace. h](j)}(h``unsigned int useroffset``h]jS)}(hjEh]hunsigned int useroffset}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjCubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:46: ./mm/slab_common.chMhj?ubj)}(hhh]jM)}(hJStarting offset within an allocation that may be copied to/from userspace.h]hJStarting offset within an allocation that may be copied to/from userspace.}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:46: ./mm/slab_common.chMhj[ubah}(h]h ]h"]h$]h&]uh1jhj?ubeh}(h]h ]h"]h$]h&]uh1jhjZhMhjɇubj)}(hg``unsigned int usersize`` How many bytes, starting at **useroffset**, may be copied to/from userspace. h](j)}(h``unsigned int usersize``h]jS)}(hjh]hunsigned int usersize}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj}ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:46: ./mm/slab_common.chMhjyubj)}(hhh]jM)}(hLHow many bytes, starting at **useroffset**, may be copied to/from userspace.h](hHow many bytes, starting at }(hjhhhNhNubj)}(h**useroffset**h]h useroffset}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh", may be copied to/from userspace.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:46: ./mm/slab_common.chMhjubah}(h]h ]h"]h$]h&]uh1jhjyubeh}(h]h ]h"]h$]h&]uh1jhjhMhjɇubj)}(h[``void (*ctor)(void *)`` A constructor for the objects, run when new allocations are made. h](j)}(h``void (*ctor)(void *)``h]jS)}(hjˈh]hvoid (*ctor)(void *)}(hj͈hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjɈubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:46: ./mm/slab_common.chMhjňubj)}(hhh]jM)}(hAA constructor for the objects, run when new allocations are made.h]hAA constructor for the objects, run when new allocations are made.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjňubeh}(h]h ]h"]h$]h&]uh1jhjhMhjɇubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h **Context**h]j)}(hjh]hContext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:46: ./mm/slab_common.chMhjubjM)}(h=Cannot be called within an interrupt, but can be interrupted.h]h=Cannot be called within an interrupt, but can be interrupted.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:46: ./mm/slab_common.chMhjubjM)}(h **Return**h]j)}(hj-h]hReturn}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj+ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:46: ./mm/slab_common.chMhjubjM)}(ha pointer to the cache on success, NULL on failure. When CONFIG_SLAB_BUCKETS is not enabled, ZERO_SIZE_PTR is returned, and subsequent calls to kmem_buckets_alloc() will fall back to kmalloc(). (i.e. callers only need to check for NULL on failure.)h]ha pointer to the cache on success, NULL on failure. When CONFIG_SLAB_BUCKETS is not enabled, ZERO_SIZE_PTR is returned, and subsequent calls to kmem_buckets_alloc() will fall back to kmalloc(). (i.e. callers only need to check for NULL on failure.)}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:46: ./mm/slab_common.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjU3hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hkmem_cache_shrink (C function)c.kmem_cache_shrinkhNtauh1hhjU3hhhNhNubh)}(hhh](h)}(h1int kmem_cache_shrink (struct kmem_cache *cachep)h]h)}(h0int kmem_cache_shrink(struct kmem_cache *cachep)h](j)}(hinth]hint}(hjrhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnhhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:46: ./mm/slab_common.chMbubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnhhhjhMbubh)}(hkmem_cache_shrinkh]j)}(hkmem_cache_shrinkh]hkmem_cache_shrink}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjnhhhjhMbubj8)}(h(struct kmem_cache *cachep)h]j>)}(hstruct kmem_cache *cacheph](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(h kmem_cacheh]h kmem_cache}(hj͉hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjʉubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjωmodnameN classnameNjj)}j]j)}jjsbc.kmem_cache_shrinkasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hcacheph]hcachep}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjnhhhjhMbubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjjhhhjhMbubah}(h]jeah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMbhjghhubj4)}(hhh]jM)}(hShrink a cache.h]hShrink a cache.}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:46: ./mm/slab_common.chMbhj/hhubah}(h]h ]h"]h$]h&]uh1j3hjghhhjhMbubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjJjHjJjIjJjKuh1hhhhjU3hNhNubj)}(hX**Parameters** ``struct kmem_cache *cachep`` The cache to shrink. **Description** Releases as many slabs as possible for a cache. To help debugging, a zero exit status indicates all slabs were released. **Return** ``0`` if all slabs were released, non-zero otherwiseh](jM)}(h**Parameters**h]j)}(hjTh]h Parameters}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjRubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:46: ./mm/slab_common.chMfhjNubj)}(hhh]j)}(h3``struct kmem_cache *cachep`` The cache to shrink. h](j)}(h``struct kmem_cache *cachep``h]jS)}(hjsh]hstruct kmem_cache *cachep}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjqubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:46: ./mm/slab_common.chMchjmubj)}(hhh]jM)}(hThe cache to shrink.h]hThe cache to shrink.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMchjubah}(h]h ]h"]h$]h&]uh1jhjmubeh}(h]h ]h"]h$]h&]uh1jhjhMchjjubah}(h]h ]h"]h$]h&]uh1jhjNubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:46: ./mm/slab_common.chMehjNubjM)}(hxReleases as many slabs as possible for a cache. To help debugging, a zero exit status indicates all slabs were released.h]hxReleases as many slabs as possible for a cache. To help debugging, a zero exit status indicates all slabs were released.}(hjĊhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:46: ./mm/slab_common.chMdhjNubjM)}(h **Return**h]j)}(hjՊh]hReturn}(hj׊hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjӊubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:46: ./mm/slab_common.chMghjNubjM)}(h4``0`` if all slabs were released, non-zero otherwiseh](jS)}(h``0``h]h0}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubh/ if all slabs were released, non-zero otherwise}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:46: ./mm/slab_common.chMhhjNubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjU3hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hkmem_dump_obj (C function)c.kmem_dump_objhNtauh1hhjU3hhhNhNubh)}(hhh](h)}(h!bool kmem_dump_obj (void *object)h]h)}(h bool kmem_dump_obj(void *object)h](j)}(hjh]hbool}(hj(hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$hhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:46: ./mm/slab_common.chMubj)}(h h]h }(hj6hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$hhhj5hMubh)}(h kmem_dump_objh]j)}(h kmem_dump_objh]h kmem_dump_obj}(hjHhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjDubah}(h]h ](jjeh"]h$]h&]jjuh1hhj$hhhj5hMubj8)}(h(void *object)h]j>)}(h void *objecth](j)}(hvoidh]hvoid}(hjdhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj`ubj)}(h h]h }(hjrhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj`ubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj`ubj)}(hobjecth]hobject}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj`ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj\ubah}(h]h ]h"]h$]h&]jjuh1j7hj$hhhj5hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj hhhj5hMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj5hMhjhhubj4)}(hhh]jM)}(h+Print available slab provenance informationh]h+Print available slab provenance information}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:46: ./mm/slab_common.chMhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhj5hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjϋjHjϋjIjJjKuh1hhhhjU3hNhNubj)}(hX**Parameters** ``void *object`` slab object for which to find provenance information. **Description** This function uses pr_cont(), so that the caller is expected to have printed out whatever preamble is appropriate. The provenance information depends on the type of object and on how much debugging is enabled. For a slab-cache object, the fact that it is a slab object is printed, and, if available, the slab name, return address, and stack trace from the allocation and last free path of that object. **Return** ``true`` if the pointer is to a not-yet-freed object from kmalloc() or kmem_cache_alloc(), either ``true`` or ``false`` if the pointer is to an already-freed object, and ``false`` otherwise.h](jM)}(h**Parameters**h]j)}(hjًh]h Parameters}(hjۋhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj׋ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:46: ./mm/slab_common.chMhjӋubj)}(hhh]j)}(hG``void *object`` slab object for which to find provenance information. h](j)}(h``void *object``h]jS)}(hjh]h void *object}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:46: ./mm/slab_common.chMhjubj)}(hhh]jM)}(h5slab object for which to find provenance information.h]h5slab object for which to find provenance information.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj hMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj hMhjubah}(h]h ]h"]h$]h&]uh1jhjӋubjM)}(h**Description**h]j)}(hj3h]h Description}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj1ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:46: ./mm/slab_common.chMhjӋubjM)}(hXThis function uses pr_cont(), so that the caller is expected to have printed out whatever preamble is appropriate. The provenance information depends on the type of object and on how much debugging is enabled. For a slab-cache object, the fact that it is a slab object is printed, and, if available, the slab name, return address, and stack trace from the allocation and last free path of that object.h]hXThis function uses pr_cont(), so that the caller is expected to have printed out whatever preamble is appropriate. The provenance information depends on the type of object and on how much debugging is enabled. For a slab-cache object, the fact that it is a slab object is printed, and, if available, the slab name, return address, and stack trace from the allocation and last free path of that object.}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:46: ./mm/slab_common.chMhjӋubjM)}(h **Return**h]j)}(hjZh]hReturn}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjXubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:46: ./mm/slab_common.chMhjӋubjM)}(h``true`` if the pointer is to a not-yet-freed object from kmalloc() or kmem_cache_alloc(), either ``true`` or ``false`` if the pointer is to an already-freed object, and ``false`` otherwise.h](jS)}(h``true``h]htrue}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjpubhZ if the pointer is to a not-yet-freed object from kmalloc() or kmem_cache_alloc(), either }(hjphhhNhNubjS)}(h``true``h]htrue}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjpubh or }(hjphhhNhNubjS)}(h ``false``h]hfalse}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjpubh3 if the pointer is to an already-freed object, and }(hjphhhNhNubjS)}(h ``false``h]hfalse}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjpubh otherwise.}(hjphhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:46: ./mm/slab_common.chMhjӋubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjU3hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hkfree_sensitive (C function)c.kfree_sensitivehNtauh1hhjU3hhhNhNubh)}(hhh](h)}(h$void kfree_sensitive (const void *p)h]h)}(h#void kfree_sensitive(const void *p)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjߌhhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:46: ./mm/slab_common.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjߌhhhjhMubh)}(hkfree_sensitiveh]j)}(hkfree_sensitiveh]hkfree_sensitive}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjߌhhhjhMubj8)}(h(const void *p)h]j>)}(h const void *ph](j)}(hjh]hconst}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hvoidh]hvoid}(hj;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjWhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hj~h]hp}(hjdhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjߌhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjیhhhjhMubah}(h]j֌ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhj،hhubj4)}(hhh]jM)}(h4Clear sensitive information in memory before freeingh]h4Clear sensitive information in memory before freeing}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:46: ./mm/slab_common.chMhjhhubah}(h]h ]h"]h$]h&]uh1j3hj،hhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjU3hNhNubj)}(hX**Parameters** ``const void *p`` object to free memory of **Description** The memory of the object **p** points to is zeroed before freed. If **p** is ``NULL``, kfree_sensitive() does nothing. **Note** this function zeroes the whole allocated buffer which can be a good deal bigger than the requested buffer size passed to kmalloc(). So be careful when using this function in performance sensitive code.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:46: ./mm/slab_common.chMhjubj)}(hhh]j)}(h+``const void *p`` object to free memory of h](j)}(h``const void *p``h]jS)}(hj΍h]h const void *p}(hjЍhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj̍ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:46: ./mm/slab_common.chMhjȍubj)}(hhh]jM)}(hobject to free memory ofh]hobject to free memory of}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjȍubeh}(h]h ]h"]h$]h&]uh1jhjhMhjōubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hj h]h Description}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:46: ./mm/slab_common.chMhjubjM)}(hvThe memory of the object **p** points to is zeroed before freed. If **p** is ``NULL``, kfree_sensitive() does nothing.h](hThe memory of the object }(hjhhhNhNubj)}(h**p**h]hp}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh& points to is zeroed before freed. If }(hjhhhNhNubj)}(h**p**h]hp}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh is }(hjhhhNhNubjS)}(h``NULL``h]hNULL}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubh!, kfree_sensitive() does nothing.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:46: ./mm/slab_common.chMhjubjM)}(h**Note**h]j)}(hjfh]hNote}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjdubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:46: ./mm/slab_common.chMhjubjM)}(hthis function zeroes the whole allocated buffer which can be a good deal bigger than the requested buffer size passed to kmalloc(). So be careful when using this function in performance sensitive code.h]hthis function zeroes the whole allocated buffer which can be a good deal bigger than the requested buffer size passed to kmalloc(). So be careful when using this function in performance sensitive code.}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:46: ./mm/slab_common.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjU3hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hkfree_const (C function) c.kfree_consthNtauh1hhjU3hhhNhNubh)}(hhh](h)}(h void kfree_const (const void *x)h]h)}(hvoid kfree_const(const void *x)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:49: ./mm/util.chK&ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhK&ubh)}(h kfree_consth]j)}(h kfree_consth]h kfree_const}(hj̎hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjȎubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhK&ubj8)}(h(const void *x)h]j>)}(h const void *xh](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hjsh]hx}(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhK&ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhK&ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhK&hjhhubj4)}(hhh]jM)}(hconditionally free memoryh]hconditionally free memory}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:49: ./mm/util.chK&hjRhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhK&ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjmjHjmjIjJjKuh1hhhhjU3hNhNubj)}(h**Parameters** ``const void *x`` pointer to the memory **Description** Function calls kfree only if **x** is not in .rodata section.h](jM)}(h**Parameters**h]j)}(hjwh]h Parameters}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjuubah}(h]h ]h"]h$]h&]uh1jLhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:49: ./mm/util.chK*hjqubj)}(hhh]j)}(h(``const void *x`` pointer to the memory h](j)}(h``const void *x``h]jS)}(hjh]h const void *x}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:49: ./mm/util.chK'hjubj)}(hhh]jM)}(hpointer to the memoryh]hpointer to the memory}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhK'hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhK'hjubah}(h]h ]h"]h$]h&]uh1jhjqubjM)}(h**Description**h]j)}(hjяh]h Description}(hjӏhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjϏubah}(h]h ]h"]h$]h&]uh1jLhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:49: ./mm/util.chK)hjqubjM)}(h=Function calls kfree only if **x** is not in .rodata section.h](hFunction calls kfree only if }(hjhhhNhNubj)}(h**x**h]hx}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh is not in .rodata section.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhI/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:49: ./mm/util.chK(hjqubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjU3hhhNhNubeh}(h]the-slab-cacheah ]h"]the slab cacheah$]h&]uh1hhhhhhhhK&ubh)}(hhh](h)}(hVirtually Contiguous Mappingsh]hVirtually Contiguous Mappings}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhK5ubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hvm_unmap_aliases (C function)c.vm_unmap_aliaseshNtauh1hhjhhhNhNubh)}(hhh](h)}(hvoid vm_unmap_aliases (void)h]h)}(hvoid vm_unmap_aliases(void)h](j)}(hvoidh]hvoid}(hjAhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=hhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chM ubj)}(h h]h }(hjPhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=hhhjOhM ubh)}(hvm_unmap_aliasesh]j)}(hvm_unmap_aliasesh]hvm_unmap_aliases}(hjbhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj=hhhjOhM ubj8)}(h(void)h]j>)}(hvoidh]j)}(hvoidh]hvoid}(hj~hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjzubah}(h]h ]h"]h$]h&]noemphjjuh1j=hjvubah}(h]h ]h"]h$]h&]jjuh1j7hj=hhhjOhM ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj9hhhjOhM ubah}(h]j4ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjOhM hj6hhubj4)}(hhh]jM)}(h0unmap outstanding lazy aliases in the vmap layerh]h0unmap outstanding lazy aliases in the vmap layer}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chM hjhhubah}(h]h ]h"]h$]h&]uh1j3hj6hhhjOhM ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjhNhNubj)}(hXQ**Parameters** ``void`` no arguments **Description** The vmap/vmalloc layer lazily flushes kernel virtual mappings primarily to amortize TLB flushing overheads. What this means is that any page you have now, may, in a former life, have been mapped into kernel virtual address by the vmap layer and so there might be some CPUs with TLB entries still referencing that page (additional to the regular 1:1 kernel mapping). vm_unmap_aliases flushes all such lazy mappings. After it returns, we can be sure that none of the pages we have control over will have any aliases from the vmap layer.h](jM)}(h**Parameters**h]j)}(hjʐh]h Parameters}(hj̐hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjȐubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chM hjĐubj)}(hhh]j)}(h``void`` no arguments h](j)}(h``void``h]jS)}(hjh]hvoid}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chKhjubj)}(hhh]jM)}(h no argumentsh]h no arguments}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjĐubjM)}(h**Description**h]j)}(hj$h]h Description}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj"ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chKhjĐubjM)}(hXmThe vmap/vmalloc layer lazily flushes kernel virtual mappings primarily to amortize TLB flushing overheads. What this means is that any page you have now, may, in a former life, have been mapped into kernel virtual address by the vmap layer and so there might be some CPUs with TLB entries still referencing that page (additional to the regular 1:1 kernel mapping).h]hXmThe vmap/vmalloc layer lazily flushes kernel virtual mappings primarily to amortize TLB flushing overheads. What this means is that any page you have now, may, in a former life, have been mapped into kernel virtual address by the vmap layer and so there might be some CPUs with TLB entries still referencing that page (additional to the regular 1:1 kernel mapping).}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chM hjĐubjM)}(hvm_unmap_aliases flushes all such lazy mappings. After it returns, we can be sure that none of the pages we have control over will have any aliases from the vmap layer.h]hvm_unmap_aliases flushes all such lazy mappings. After it returns, we can be sure that none of the pages we have control over will have any aliases from the vmap layer.}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chM hjĐubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hvm_unmap_ram (C function)c.vm_unmap_ramhNtauh1hhjhhhNhNubh)}(hhh](h)}(h7void vm_unmap_ram (const void *mem, unsigned int count)h]h)}(h6void vm_unmap_ram(const void *mem, unsigned int count)h](j)}(hvoidh]hvoid}(hjxhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjthhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chM ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjthhhjhM ubh)}(h vm_unmap_ramh]j)}(h vm_unmap_ramh]h vm_unmap_ram}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjthhhjhM ubj8)}(h%(const void *mem, unsigned int count)h](j>)}(hconst void *memh](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj‘hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hvoidh]hvoid}(hjБhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjޑhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hmemh]hmem}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hunsigned int counth](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hinth]hint}(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj<hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hcounth]hcount}(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjthhhjhM ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjphhhjhM ubah}(h]jkah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhM hjmhhubj4)}(hhh]jM)}(h6unmap linear kernel address space set up by vm_map_ramh]h6unmap linear kernel address space set up by vm_map_ram}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chM hjqhhubah}(h]h ]h"]h$]h&]uh1j3hjmhhhjhM ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjhNhNubj)}(h**Parameters** ``const void *mem`` the pointer returned by vm_map_ram ``unsigned int count`` the count passed to that vm_map_ram call (cannot unmap partial)h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chM hjubj)}(hhh](j)}(h7``const void *mem`` the pointer returned by vm_map_ram h](j)}(h``const void *mem``h]jS)}(hjh]hconst void *mem}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chM hjubj)}(hhh]jM)}(h"the pointer returned by vm_map_ramh]h"the pointer returned by vm_map_ram}(hjΒhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjʒhM hj˒ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjʒhM hjubj)}(hV``unsigned int count`` the count passed to that vm_map_ram call (cannot unmap partial)h](j)}(h``unsigned int count``h]jS)}(hjh]hunsigned int count}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chM hjubj)}(hhh]jM)}(h?the count passed to that vm_map_ram call (cannot unmap partial)h]h?the count passed to that vm_map_ram call (cannot unmap partial)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hvm_map_ram (C function) c.vm_map_ramhNtauh1hhjhhhNhNubh)}(hhh](h)}(hEvoid * vm_map_ram (struct page **pages, unsigned int count, int node)h]h)}(hCvoid *vm_map_ram(struct page **pages, unsigned int count, int node)h](j)}(hvoidh]hvoid}(hjHhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjDhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chM ubj)}(h h]h }(hjWhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjDhhhjVhM ubjr)}(hjuh]h*}(hjehhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjDhhhjVhM ubh)}(h vm_map_ramh]j)}(h vm_map_ramh]h vm_map_ram}(hjvhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjrubah}(h]h ](jjeh"]h$]h&]jjuh1hhjDhhhjVhM ubj8)}(h3(struct page **pages, unsigned int count, int node)h](j>)}(hstruct page **pagesh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hpageh]hpage}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjxsb c.vm_map_ramasbuh1hhjubj)}(h h]h }(hjГhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjޓhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hpagesh]hpages}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hunsigned int counth](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(hinth]hint}(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h h]h }(hj;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(hcounth]hcount}(hjIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hint nodeh](j)}(hinth]hint}(hjbhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^ubj)}(h h]h }(hjphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^ubj)}(hnodeh]hnode}(hj~hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjDhhhjVhM ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj@hhhjVhM ubah}(h]j;ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjVhM hj=hhubj4)}(hhh]jM)}(h>map pages linearly into kernel virtual address (vmalloc space)h]h>map pages linearly into kernel virtual address (vmalloc space)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chM hjhhubah}(h]h ]h"]h$]h&]uh1j3hj=hhhjVhM ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjhNhNubj)}(hX**Parameters** ``struct page **pages`` an array of pointers to the pages to be mapped ``unsigned int count`` number of pages ``int node`` prefer to allocate data structures on this node **Description** If you use this function for less than VMAP_MAX_ALLOC pages, it could be faster than vmap so it's good. But if you mix long-life and short-life objects with vm_map_ram(), it could consume lots of address space through fragmentation (especially on a 32bit machine). You could see failures in the end. Please use this function for short-lived objects. **Return** a pointer to the address that has been mapped, or ``NULL`` on failureh](jM)}(h**Parameters**h]j)}(hjʔh]h Parameters}(hj̔hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjȔubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chM$ hjĔubj)}(hhh](j)}(hG``struct page **pages`` an array of pointers to the pages to be mapped h](j)}(h``struct page **pages``h]jS)}(hjh]hstruct page **pages}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chM! hjubj)}(hhh]jM)}(h.an array of pointers to the pages to be mappedh]h.an array of pointers to the pages to be mapped}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM! hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM! hjubj)}(h'``unsigned int count`` number of pages h](j)}(h``unsigned int count``h]jS)}(hj"h]hunsigned int count}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chM" hjubj)}(hhh]jM)}(hnumber of pagesh]hnumber of pages}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj7hM" hj8ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj7hM" hjubj)}(h=``int node`` prefer to allocate data structures on this node h](j)}(h ``int node``h]jS)}(hj[h]hint node}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjYubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chM# hjUubj)}(hhh]jM)}(h/prefer to allocate data structures on this nodeh]h/prefer to allocate data structures on this node}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjphM# hjqubah}(h]h ]h"]h$]h&]uh1jhjUubeh}(h]h ]h"]h$]h&]uh1jhjphM# hjubeh}(h]h ]h"]h$]h&]uh1jhjĔubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chM% hjĔubjM)}(hX`If you use this function for less than VMAP_MAX_ALLOC pages, it could be faster than vmap so it's good. But if you mix long-life and short-life objects with vm_map_ram(), it could consume lots of address space through fragmentation (especially on a 32bit machine). You could see failures in the end. Please use this function for short-lived objects.h]hXbIf you use this function for less than VMAP_MAX_ALLOC pages, it could be faster than vmap so it’s good. But if you mix long-life and short-life objects with vm_map_ram(), it could consume lots of address space through fragmentation (especially on a 32bit machine). You could see failures in the end. Please use this function for short-lived objects.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chM$ hjĔubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(Ah]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chM* hjĔubjM)}(hEa pointer to the address that has been mapped, or ``NULL`` on failureh](h2a pointer to the address that has been mapped, or }(hjӕhhhNhNubjS)}(h``NULL``h]hNULL}(hjەhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjӕubh on failure}(hjӕhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chM+ hjĔubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hvfree (C function)c.vfreehNtauh1hhjhhhNhNubh)}(hhh](h)}(hvoid vfree (const void *addr)h]h)}(hvoid vfree(const void *addr)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chM ubj)}(h h]h }(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhj"hM ubh)}(hvfreeh]j)}(hvfreeh]hvfree}(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj1ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhj"hM ubj8)}(h(const void *addr)h]j>)}(hconst void *addrh](j)}(hjh]hconst}(hjQhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjMubj)}(h h]h }(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjMubj)}(hvoidh]hvoid}(hjlhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjMubj)}(h h]h }(hjzhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjMubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjMubj)}(haddrh]haddr}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjMubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjIubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhj"hM ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj hhhj"hM ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj"hM hj hhubj4)}(hhh]jM)}(h%Release memory allocated by vmalloc()h]h%Release memory allocated by vmalloc()}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chM hjhhubah}(h]h ]h"]h$]h&]uh1j3hj hhhj"hM ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjזjHjזjIjJjKuh1hhhhjhNhNubj)}(hX**Parameters** ``const void *addr`` Memory base address **Description** Free the virtually continuous memory area starting at **addr**, as obtained from one of the vmalloc() family of APIs. This will usually also free the physical memory underlying the virtual allocation, but that memory is reference counted, so it will not be freed until the last user goes away. If **addr** is NULL, no operation is performed. **Context** May sleep if called *not* from interrupt context. Must not be called in NMI context (strictly speaking, it could be if we have CONFIG_ARCH_HAVE_NMI_SAFE_CMPXCHG, but making the calling conventions for vfree() arch-dependent would be a really bad idea).h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjߖubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chM hjۖubj)}(hhh]j)}(h)``const void *addr`` Memory base address h](j)}(h``const void *addr``h]jS)}(hjh]hconst void *addr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chM hjubj)}(hhh]jM)}(hMemory base addressh]hMemory base address}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjۖubjM)}(h**Description**h]j)}(hj;h]h Description}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj9ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chM hjۖubjM)}(hX&Free the virtually continuous memory area starting at **addr**, as obtained from one of the vmalloc() family of APIs. This will usually also free the physical memory underlying the virtual allocation, but that memory is reference counted, so it will not be freed until the last user goes away.h](h6Free the virtually continuous memory area starting at }(hjQhhhNhNubj)}(h**addr**h]haddr}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjQubh, as obtained from one of the vmalloc() family of APIs. This will usually also free the physical memory underlying the virtual allocation, but that memory is reference counted, so it will not be freed until the last user goes away.}(hjQhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chM hjۖubjM)}(h/If **addr** is NULL, no operation is performed.h](hIf }(hjrhhhNhNubj)}(h**addr**h]haddr}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjrubh$ is NULL, no operation is performed.}(hjrhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chM hjۖubjM)}(h **Context**h]j)}(hjh]hContext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chM hjۖubjM)}(hMay sleep if called *not* from interrupt context. Must not be called in NMI context (strictly speaking, it could be if we have CONFIG_ARCH_HAVE_NMI_SAFE_CMPXCHG, but making the calling conventions for vfree() arch-dependent would be a really bad idea).h](hMay sleep if called }(hjhhhNhNubj )}(h*not*h]hnot}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j hjubh from interrupt context. Must not be called in NMI context (strictly speaking, it could be if we have CONFIG_ARCH_HAVE_NMI_SAFE_CMPXCHG, but making the calling conventions for vfree() arch-dependent would be a really bad idea).}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chM hjۖubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hvunmap (C function)c.vunmaphNtauh1hhjhhhNhNubh)}(hhh](h)}(hvoid vunmap (const void *addr)h]h)}(hvoid vunmap(const void *addr)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chM ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM ubh)}(hvunmaph]j)}(hvunmaph]hvunmap}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhM ubj8)}(h(const void *addr)h]j>)}(hconst void *addrh](j)}(hjh]hconst}(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%ubj)}(h h]h }(hj6hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%ubj)}(hvoidh]hvoid}(hjDhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%ubj)}(h h]h }(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%ubjr)}(hjuh]h*}(hj`hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj%ubj)}(haddrh]haddr}(hjmhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj!ubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhM ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhM ubah}(h]jߗah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhM hjhhubj4)}(hhh]jM)}(h*release virtual mapping obtained by vmap()h]h*release virtual mapping obtained by vmap()}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chM hjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhM ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjhNhNubj)}(h**Parameters** ``const void *addr`` memory base address **Description** Free the virtually contiguous memory area starting at **addr**, which was created from the page array passed to vmap(). Must not be called in interrupt context.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chM hjubj)}(hhh]j)}(h)``const void *addr`` memory base address h](j)}(h``const void *addr``h]jS)}(hjؘh]hconst void *addr}(hjژhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj֘ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chM hjҘubj)}(hhh]jM)}(hmemory base addressh]hmemory base address}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjҘubeh}(h]h ]h"]h$]h&]uh1jhjhM hjϘubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chM hjubjM)}(hwFree the virtually contiguous memory area starting at **addr**, which was created from the page array passed to vmap().h](h6Free the virtually contiguous memory area starting at }(hj)hhhNhNubj)}(h**addr**h]haddr}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj)ubh9, which was created from the page array passed to vmap().}(hj)hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chM hjubjM)}(h(Must not be called in interrupt context.h]h(Must not be called in interrupt context.}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chM hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hvmap (C function)c.vmaphNtauh1hhjhhhNhNubh)}(hhh](h)}(hYvoid * vmap (struct page **pages, unsigned int count, unsigned long flags, pgprot_t prot)h]h)}(hWvoid *vmap(struct page **pages, unsigned int count, unsigned long flags, pgprot_t prot)h](j)}(hvoidh]hvoid}(hjyhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjuhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chM ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjuhhhjhM ubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjuhhhjhM ubh)}(hvmaph]j)}(hvmaph]hvmap}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjuhhhjhM ubj8)}(hM(struct page **pages, unsigned int count, unsigned long flags, pgprot_t prot)h](j>)}(hstruct page **pagesh](j)}(hjJ,h]hstruct}(hjÙhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjЙhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hpageh]hpage}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjޙubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsbc.vmapasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hpagesh]hpages}(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hunsigned int counth](j)}(hunsignedh]hunsigned}(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>ubj)}(h h]h }(hjPhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>ubj)}(hinth]hint}(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>ubj)}(h h]h }(hjlhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>ubj)}(hcounth]hcount}(hjzhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hunsigned long flagsh](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hflagsh]hflags}(hj˚hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(h pgprot_t proth](h)}(hhh]j)}(hpgprot_th]hpgprot_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.vmapasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hproth]hprot}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjuhhhjhM ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjqhhhjhM ubah}(h]jlah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhM hjnhhubj4)}(hhh]jM)}(h5map an array of pages into virtually contiguous spaceh]h5map an array of pages into virtually contiguous space}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chM hj:hhubah}(h]h ]h"]h$]h&]uh1j3hjnhhhjhM ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjUjHjUjIjJjKuh1hhhhjhNhNubj)}(hXz**Parameters** ``struct page **pages`` array of page pointers ``unsigned int count`` number of pages to map ``unsigned long flags`` vm_area->flags ``pgprot_t prot`` page protection for the mapping **Description** Maps **count** pages from **pages** into contiguous kernel virtual space. If **flags** contains ``VM_MAP_PUT_PAGES`` the ownership of the pages array itself (which must be kmalloc or vmalloc memory) and one reference per pages in it are transferred from the caller to vmap(), and will be freed / dropped when vfree() is called on the return value. **Return** the address of the area or ``NULL`` on failureh](jM)}(h**Parameters**h]j)}(hj_h]h Parameters}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1jhj]ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjYubj)}(hhh](j)}(h/``struct page **pages`` array of page pointers h](j)}(h``struct page **pages``h]jS)}(hj~h]hstruct page **pages}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj|ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chM hjxubj)}(hhh]jM)}(harray of page pointersh]harray of page pointers}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjxubeh}(h]h ]h"]h$]h&]uh1jhjhM hjuubj)}(h.``unsigned int count`` number of pages to map h](j)}(h``unsigned int count``h]jS)}(hjh]hunsigned int count}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjubj)}(hhh]jM)}(hnumber of pages to maph]hnumber of pages to map}(hjЛhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj̛hMhj͛ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj̛hMhjuubj)}(h'``unsigned long flags`` vm_area->flags h](j)}(h``unsigned long flags``h]jS)}(hjh]hunsigned long flags}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjubj)}(hhh]jM)}(hvm_area->flagsh]hvm_area->flags}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjuubj)}(h2``pgprot_t prot`` page protection for the mapping h](j)}(h``pgprot_t prot``h]jS)}(hj)h]h pgprot_t prot}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj'ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhj#ubj)}(hhh]jM)}(hpage protection for the mappingh]hpage protection for the mapping}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj>hMhj?ubah}(h]h ]h"]h$]h&]uh1jhj#ubeh}(h]h ]h"]h$]h&]uh1jhj>hMhjuubeh}(h]h ]h"]h$]h&]uh1jhjYubjM)}(h**Description**h]j)}(hjdh]h Description}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjbubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjYubjM)}(hX[Maps **count** pages from **pages** into contiguous kernel virtual space. If **flags** contains ``VM_MAP_PUT_PAGES`` the ownership of the pages array itself (which must be kmalloc or vmalloc memory) and one reference per pages in it are transferred from the caller to vmap(), and will be freed / dropped when vfree() is called on the return value.h](hMaps }(hjzhhhNhNubj)}(h **count**h]hcount}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjzubh pages from }(hjzhhhNhNubj)}(h **pages**h]hpages}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjzubh* into contiguous kernel virtual space. If }(hjzhhhNhNubj)}(h **flags**h]hflags}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjzubh contains }(hjzhhhNhNubjS)}(h``VM_MAP_PUT_PAGES``h]hVM_MAP_PUT_PAGES}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjzubh the ownership of the pages array itself (which must be kmalloc or vmalloc memory) and one reference per pages in it are transferred from the caller to vmap(), and will be freed / dropped when vfree() is called on the return value.}(hjzhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjYubjM)}(h **Return**h]j)}(hjӜh]hReturn}(hj՜hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjќubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chM hjYubjM)}(h.the address of the area or ``NULL`` on failureh](hthe address of the area or }(hjhhhNhNubjS)}(h``NULL``h]hNULL}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubh on failure}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chM hjYubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hvmap_pfn (C function) c.vmap_pfnhNtauh1hhjhhhNhNubh)}(hhh](h)}(hHvoid * vmap_pfn (unsigned long *pfns, unsigned int count, pgprot_t prot)h]h)}(hFvoid *vmap_pfn(unsigned long *pfns, unsigned int count, pgprot_t prot)h](j)}(hvoidh]hvoid}(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&hhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMNubj)}(h h]h }(hj9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&hhhj8hMNubjr)}(hjuh]h*}(hjGhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj&hhhj8hMNubh)}(hvmap_pfnh]j)}(hvmap_pfnh]hvmap_pfn}(hjXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjTubah}(h]h ](jjeh"]h$]h&]jjuh1hhj&hhhj8hMNubj8)}(h8(unsigned long *pfns, unsigned int count, pgprot_t prot)h](j>)}(hunsigned long *pfnsh](j)}(hunsignedh]hunsigned}(hjthhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpubj)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjpubj)}(hpfnsh]hpfns}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjlubj>)}(hunsigned int counth](j)}(hunsignedh]hunsigned}(hjҝhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjΝubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjΝubj)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjΝubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjΝubj)}(hcounth]hcount}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjΝubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjlubj>)}(h pgprot_t proth](h)}(hhh]j)}(hpgprot_th]hpgprot_t}(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj(modnameN classnameNjj)}j]j)}jjZsb c.vmap_pfnasbuh1hhjubj)}(h h]h }(hjFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hproth]hprot}(hjThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjlubeh}(h]h ]h"]h$]h&]jjuh1j7hj&hhhj8hMNubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj"hhhj8hMNubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj8hMNhjhhubj4)}(hhh]jM)}(h4map an array of PFNs into virtually contiguous spaceh]h4map an array of PFNs into virtually contiguous space}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMNhj{hhubah}(h]h ]h"]h$]h&]uh1j3hjhhhj8hMNubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjhNhNubj)}(hX$**Parameters** ``unsigned long *pfns`` array of PFNs ``unsigned int count`` number of pages to map ``pgprot_t prot`` page protection for the mapping **Description** Maps **count** PFNs from **pfns** into contiguous kernel virtual space and returns the start address of the mapping.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMRhjubj)}(hhh](j)}(h&``unsigned long *pfns`` array of PFNs h](j)}(h``unsigned long *pfns``h]jS)}(hjh]hunsigned long *pfns}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMOhjubj)}(hhh]jM)}(h array of PFNsh]h array of PFNs}(hj؞hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjԞhMOhj՞ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjԞhMOhjubj)}(h.``unsigned int count`` number of pages to map h](j)}(h``unsigned int count``h]jS)}(hjh]hunsigned int count}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMPhjubj)}(hhh]jM)}(hnumber of pages to maph]hnumber of pages to map}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj hMPhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj hMPhjubj)}(h2``pgprot_t prot`` page protection for the mapping h](j)}(h``pgprot_t prot``h]jS)}(hj1h]h pgprot_t prot}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj/ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMQhj+ubj)}(hhh]jM)}(hpage protection for the mappingh]hpage protection for the mapping}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjFhMQhjGubah}(h]h ]h"]h$]h&]uh1jhj+ubeh}(h]h ]h"]h$]h&]uh1jhjFhMQhjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjlh]h Description}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMShjubjM)}(htMaps **count** PFNs from **pfns** into contiguous kernel virtual space and returns the start address of the mapping.h](hMaps }(hjhhhNhNubj)}(h **count**h]hcount}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh PFNs from }(hjhhhNhNubj)}(h**pfns**h]hpfns}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhS into contiguous kernel virtual space and returns the start address of the mapping.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMRhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h__vmalloc_node (C function)c.__vmalloc_nodehNtauh1hhjhhhNhNubh)}(hhh](h)}(hmvoid * __vmalloc_node (unsigned long size, unsigned long align, gfp_t gfp_mask, int node, const void *caller)h]h)}(hkvoid *__vmalloc_node(unsigned long size, unsigned long align, gfp_t gfp_mask, int node, const void *caller)h](j)}(hvoidh]hvoid}(hj՟hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjџhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMcubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjџhhhjhMcubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjџhhhjhMcubh)}(h__vmalloc_nodeh]j)}(h__vmalloc_nodeh]h__vmalloc_node}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjџhhhjhMcubj8)}(hW(unsigned long size, unsigned long align, gfp_t gfp_mask, int node, const void *caller)h](j>)}(hunsigned long sizeh](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hlongh]hlong}(hj;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hsizeh]hsize}(hjWhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hunsigned long alignh](j)}(hunsignedh]hunsigned}(hjphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjlubj)}(h h]h }(hj~hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjlubj)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjlubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjlubj)}(halignh]halign}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjlubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hgfp_t gfp_maskh](h)}(hhh]j)}(hgfp_th]hgfp_t}(hjĠhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjƠmodnameN classnameNjj)}j]j)}jjsbc.__vmalloc_nodeasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hgfp_maskh]hgfp_mask}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hint nodeh](j)}(hinth]hint}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hnodeh]hnode}(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hconst void *callerh](j)}(hjh]hconst}(hj@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj<ubj)}(h h]h }(hjMhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj<ubj)}(hvoidh]hvoid}(hj[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj<ubj)}(h h]h }(hjihhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj<ubjr)}(hjuh]h*}(hjwhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj<ubj)}(hcallerh]hcaller}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj<ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjџhhhjhMcubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj͟hhhjhMcubah}(h]jȟah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMchjʟhhubj4)}(hhh]jM)}(h$allocate virtually contiguous memoryh]h$allocate virtually contiguous memory}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMchjhhubah}(h]h ]h"]h$]h&]uh1j3hjʟhhhjhMcubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjơjHjơjIjJjKuh1hhhhjhNhNubj)}(hXt**Parameters** ``unsigned long size`` allocation size ``unsigned long align`` desired alignment ``gfp_t gfp_mask`` flags for the page level allocator ``int node`` node to use for allocation or NUMA_NO_NODE ``const void *caller`` caller's return address **Description** Allocate enough pages to cover **size** from the page level allocator with **gfp_mask** flags. Map them into contiguous kernel virtual space. Semantics of **gfp_mask** (including reclaim/retry modifiers such as __GFP_NOFAIL) are the same as in __vmalloc_node_range_noprof(). **Return** pointer to the allocated memory or ``NULL`` on errorh](jM)}(h**Parameters**h]j)}(hjСh]h Parameters}(hjҡhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjΡubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMghjʡubj)}(hhh](j)}(h'``unsigned long size`` allocation size h](j)}(h``unsigned long size``h]jS)}(hjh]hunsigned long size}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMdhjubj)}(hhh]jM)}(hallocation sizeh]hallocation size}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMdhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMdhjubj)}(h*``unsigned long align`` desired alignment h](j)}(h``unsigned long align``h]jS)}(hj(h]hunsigned long align}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj&ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMehj"ubj)}(hhh]jM)}(hdesired alignmenth]hdesired alignment}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj=hMehj>ubah}(h]h ]h"]h$]h&]uh1jhj"ubeh}(h]h ]h"]h$]h&]uh1jhj=hMehjubj)}(h6``gfp_t gfp_mask`` flags for the page level allocator h](j)}(h``gfp_t gfp_mask``h]jS)}(hjah]hgfp_t gfp_mask}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj_ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMfhj[ubj)}(hhh]jM)}(h"flags for the page level allocatorh]h"flags for the page level allocator}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjvhMfhjwubah}(h]h ]h"]h$]h&]uh1jhj[ubeh}(h]h ]h"]h$]h&]uh1jhjvhMfhjubj)}(h8``int node`` node to use for allocation or NUMA_NO_NODE h](j)}(h ``int node``h]jS)}(hjh]hint node}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMghjubj)}(hhh]jM)}(h*node to use for allocation or NUMA_NO_NODEh]h*node to use for allocation or NUMA_NO_NODE}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMghjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMghjubj)}(h/``const void *caller`` caller's return address h](j)}(h``const void *caller``h]jS)}(hjӢh]hconst void *caller}(hjբhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjѢubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhhj͢ubj)}(hhh]jM)}(hcaller's return addressh]hcaller’s return address}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhhjubah}(h]h ]h"]h$]h&]uh1jhj͢ubeh}(h]h ]h"]h$]h&]uh1jhjhMhhjubeh}(h]h ]h"]h$]h&]uh1jhjʡubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMjhjʡubjM)}(hAllocate enough pages to cover **size** from the page level allocator with **gfp_mask** flags. Map them into contiguous kernel virtual space.h](hAllocate enough pages to cover }(hj$hhhNhNubj)}(h**size**h]hsize}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj$ubh$ from the page level allocator with }(hj$hhhNhNubj)}(h **gfp_mask**h]hgfp_mask}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj$ubh7 flags. Map them into contiguous kernel virtual space.}(hj$hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMihjʡubjM)}(hSemantics of **gfp_mask** (including reclaim/retry modifiers such as __GFP_NOFAIL) are the same as in __vmalloc_node_range_noprof().h](h Semantics of }(hjWhhhNhNubj)}(h **gfp_mask**h]hgfp_mask}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjWubhk (including reclaim/retry modifiers such as __GFP_NOFAIL) are the same as in __vmalloc_node_range_noprof().}(hjWhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMlhjʡubjM)}(h **Return**h]j)}(hjzh]hReturn}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjxubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMohjʡubjM)}(h4pointer to the allocated memory or ``NULL`` on errorh](h#pointer to the allocated memory or }(hjhhhNhNubjS)}(h``NULL``h]hNULL}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubh on error}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMphjʡubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hvmalloc (C function) c.vmallochNtauh1hhjhhhNhNubh)}(hhh](h)}(h#void * vmalloc (unsigned long size)h]h)}(h!void *vmalloc(unsigned long size)h](j)}(hvoidh]hvoid}(hjѣhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjͣhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjͣhhhjߣhMubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjͣhhhjߣhMubh)}(hvmalloch]j)}(hvmalloch]hvmalloc}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjͣhhhjߣhMubj8)}(h(unsigned long size)h]j>)}(hunsigned long sizeh](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hlongh]hlong}(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hsizeh]hsize}(hjShhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjͣhhhjߣhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjɣhhhjߣhMubah}(h]jģah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjߣhMhjƣhhubj4)}(hhh]jM)}(h$allocate virtually contiguous memoryh]h$allocate virtually contiguous memory}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjzhhubah}(h]h ]h"]h$]h&]uh1j3hjƣhhhjߣhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjhNhNubj)}(hX`**Parameters** ``unsigned long size`` allocation size **Description** Allocate enough pages to cover **size** from the page level allocator and map them into contiguous kernel virtual space. For tight control over page level allocator and protection flags use __vmalloc() instead. **Return** pointer to the allocated memory or ``NULL`` on errorh](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjubj)}(hhh]j)}(h'``unsigned long size`` allocation size h](j)}(h``unsigned long size``h]jS)}(hjh]hunsigned long size}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjubj)}(hhh]jM)}(hallocation sizeh]hallocation size}(hjפhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjӤhMhjԤubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjӤhMhjubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjubjM)}(hxAllocate enough pages to cover **size** from the page level allocator and map them into contiguous kernel virtual space.h](hAllocate enough pages to cover }(hjhhhNhNubj)}(h**size**h]hsize}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhQ from the page level allocator and map them into contiguous kernel virtual space.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjubjM)}(hYFor tight control over page level allocator and protection flags use __vmalloc() instead.h]hYFor tight control over page level allocator and protection flags use __vmalloc() instead.}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjubjM)}(h **Return**h]j)}(hjAh]hReturn}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1jhj?ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjubjM)}(h4pointer to the allocated memory or ``NULL`` on errorh](h#pointer to the allocated memory or }(hjWhhhNhNubjS)}(h``NULL``h]hNULL}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjWubh on error}(hjWhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hvmalloc_huge_node (C function)c.vmalloc_huge_nodehNtauh1hhjhhhNhNubh)}(hhh](h)}(hGvoid * vmalloc_huge_node (unsigned long size, gfp_t gfp_mask, int node)h]h)}(hEvoid *vmalloc_huge_node(unsigned long size, gfp_t gfp_mask, int node)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjhhhjhMubh)}(hvmalloc_huge_nodeh]j)}(hvmalloc_huge_nodeh]hvmalloc_huge_node}(hjƥhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj¥ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMubj8)}(h.(unsigned long size, gfp_t gfp_mask, int node)h](j>)}(hunsigned long sizeh](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjޥubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjޥubj)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjޥubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjޥubj)}(hsizeh]hsize}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjޥubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjڥubj>)}(hgfp_t gfp_maskh](h)}(hhh]j)}(hgfp_th]hgfp_t}(hj6hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj8modnameN classnameNjj)}j]j)}jjȥsbc.vmalloc_huge_nodeasbuh1hhj/ubj)}(h h]h }(hjVhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/ubj)}(hgfp_maskh]hgfp_mask}(hjdhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjڥubj>)}(hint nodeh](j)}(hinth]hint}(hj}hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyubj)}(hnodeh]hnode}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjڥubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]jM)}(h6allocate virtually contiguous memory, allow huge pagesh]h6allocate virtually contiguous memory, allow huge pages}(hjæhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjۦjHjۦjIjJjKuh1hhhhjhNhNubj)}(hX**Parameters** ``unsigned long size`` allocation size ``gfp_t gfp_mask`` flags for the page level allocator ``int node`` node to use for allocation or NUMA_NO_NODE **Description** Allocate enough pages to cover **size** from the page level allocator and map them into contiguous kernel virtual space. If **size** is greater than or equal to PMD_SIZE, allow using huge pages for the memory **Return** pointer to the allocated memory or ``NULL`` on errorh](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjߦubj)}(hhh](j)}(h'``unsigned long size`` allocation size h](j)}(h``unsigned long size``h]jS)}(hjh]hunsigned long size}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjubj)}(hhh]jM)}(hallocation sizeh]hallocation size}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h6``gfp_t gfp_mask`` flags for the page level allocator h](j)}(h``gfp_t gfp_mask``h]jS)}(hj=h]hgfp_t gfp_mask}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj;ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhj7ubj)}(hhh]jM)}(h"flags for the page level allocatorh]h"flags for the page level allocator}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjRhMhjSubah}(h]h ]h"]h$]h&]uh1jhj7ubeh}(h]h ]h"]h$]h&]uh1jhjRhMhjubj)}(h8``int node`` node to use for allocation or NUMA_NO_NODE h](j)}(h ``int node``h]jS)}(hjvh]hint node}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjtubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjpubj)}(hhh]jM)}(h*node to use for allocation or NUMA_NO_NODEh]h*node to use for allocation or NUMA_NO_NODE}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjpubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubeh}(h]h ]h"]h$]h&]uh1jhjߦubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjߦubjM)}(hAllocate enough pages to cover **size** from the page level allocator and map them into contiguous kernel virtual space. If **size** is greater than or equal to PMD_SIZE, allow using huge pages for the memoryh](hAllocate enough pages to cover }(hjǧhhhNhNubj)}(h**size**h]hsize}(hjϧhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjǧubhU from the page level allocator and map them into contiguous kernel virtual space. If }(hjǧhhhNhNubj)}(h**size**h]hsize}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjǧubhL is greater than or equal to PMD_SIZE, allow using huge pages for the memory}(hjǧhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjߦubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjߦubjM)}(h4pointer to the allocated memory or ``NULL`` on errorh](h#pointer to the allocated memory or }(hjhhhNhNubjS)}(h``NULL``h]hNULL}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubh on error}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjߦubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hvzalloc (C function) c.vzallochNtauh1hhjhhhNhNubh)}(hhh](h)}(h#void * vzalloc (unsigned long size)h]h)}(h!void *vzalloc(unsigned long size)h](j)}(hvoidh]hvoid}(hjShhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjOhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMubj)}(h h]h }(hjbhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjOhhhjahMubjr)}(hjuh]h*}(hjphhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjOhhhjahMubh)}(hvzalloch]j)}(hvzalloch]hvzalloc}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj}ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjOhhhjahMubj8)}(h(unsigned long size)h]j>)}(hunsigned long sizeh](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjǨhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hsizeh]hsize}(hjըhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjOhhhjahMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjKhhhjahMubah}(h]jFah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjahMhjHhhubj4)}(hhh]jM)}(h3allocate virtually contiguous memory with zero fillh]h3allocate virtually contiguous memory with zero fill}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjhhubah}(h]h ]h"]h$]h&]uh1j3hjHhhhjahMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjhNhNubj)}(hX**Parameters** ``unsigned long size`` allocation size **Description** Allocate enough pages to cover **size** from the page level allocator and map them into contiguous kernel virtual space. The memory allocated is set to zero. For tight control over page level allocator and protection flags use __vmalloc() instead. **Return** pointer to the allocated memory or ``NULL`` on errorh](jM)}(h**Parameters**h]j)}(hj!h]h Parameters}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjubj)}(hhh]j)}(h'``unsigned long size`` allocation size h](j)}(h``unsigned long size``h]jS)}(hj@h]hunsigned long size}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj>ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhj:ubj)}(hhh]jM)}(hallocation sizeh]hallocation size}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjUhMhjVubah}(h]h ]h"]h$]h&]uh1jhj:ubeh}(h]h ]h"]h$]h&]uh1jhjUhMhj7ubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hj{h]h Description}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjyubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjubjM)}(hAllocate enough pages to cover **size** from the page level allocator and map them into contiguous kernel virtual space. The memory allocated is set to zero.h](hAllocate enough pages to cover }(hjhhhNhNubj)}(h**size**h]hsize}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhv from the page level allocator and map them into contiguous kernel virtual space. The memory allocated is set to zero.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjubjM)}(hYFor tight control over page level allocator and protection flags use __vmalloc() instead.h]hYFor tight control over page level allocator and protection flags use __vmalloc() instead.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjubjM)}(h **Return**h]j)}(hjéh]hReturn}(hjũhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjubjM)}(h4pointer to the allocated memory or ``NULL`` on errorh](h#pointer to the allocated memory or }(hj٩hhhNhNubjS)}(h``NULL``h]hNULL}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj٩ubh on error}(hj٩hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hvmalloc_user (C function)c.vmalloc_userhNtauh1hhjhhhNhNubh)}(hhh](h)}(h(void * vmalloc_user (unsigned long size)h]h)}(h&void *vmalloc_user(unsigned long size)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMubj)}(h h]h }(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhj(hMubjr)}(hjuh]h*}(hj7hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjhhhj(hMubh)}(h vmalloc_userh]j)}(h vmalloc_userh]h vmalloc_user}(hjHhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjDubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhj(hMubj8)}(h(unsigned long size)h]j>)}(hunsigned long sizeh](j)}(hunsignedh]hunsigned}(hjdhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj`ubj)}(h h]h }(hjrhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj`ubj)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj`ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj`ubj)}(hsizeh]hsize}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj`ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj\ubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhj(hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhj(hMubah}(h]j ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj(hMhjhhubj4)}(hhh]jM)}(h9allocate zeroed virtually contiguous memory for userspaceh]h9allocate zeroed virtually contiguous memory for userspace}(hjƪhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjêhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhj(hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjުjHjުjIjJjKuh1hhhhjhNhNubj)}(h**Parameters** ``unsigned long size`` allocation size **Description** The resulting memory area is zeroed so it can be mapped to userspace without leaking data. **Return** pointer to the allocated memory or ``NULL`` on errorh](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjubj)}(hhh]j)}(h'``unsigned long size`` allocation size h](j)}(h``unsigned long size``h]jS)}(hjh]hunsigned long size}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjubj)}(hhh]jM)}(hallocation sizeh]hallocation size}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjBh]h Description}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj@ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjubjM)}(hZThe resulting memory area is zeroed so it can be mapped to userspace without leaking data.h]hZThe resulting memory area is zeroed so it can be mapped to userspace without leaking data.}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjubjM)}(h **Return**h]j)}(hjih]hReturn}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjgubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjubjM)}(h4pointer to the allocated memory or ``NULL`` on errorh](h#pointer to the allocated memory or }(hjhhhNhNubjS)}(h``NULL``h]hNULL}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubh on error}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hvmalloc_node (C function)c.vmalloc_nodehNtauh1hhjhhhNhNubh)}(hhh](h)}(h2void * vmalloc_node (unsigned long size, int node)h]h)}(h0void *vmalloc_node(unsigned long size, int node)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMubj)}(h h]h }(hjϫhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjΫhMubjr)}(hjuh]h*}(hjݫhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjhhhjΫhMubh)}(h vmalloc_nodeh]j)}(h vmalloc_nodeh]h vmalloc_node}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjΫhMubj8)}(h(unsigned long size, int node)h](j>)}(hunsigned long sizeh](j)}(hunsignedh]hunsigned}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hlongh]hlong}(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj4hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hsizeh]hsize}(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hint nodeh](j)}(hinth]hint}(hj[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjWubj)}(h h]h }(hjihhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjWubj)}(hnodeh]hnode}(hjwhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjWubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjΫhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjΫhMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjΫhMhjhhubj4)}(hhh]jM)}(h"allocate memory on a specific nodeh]h"allocate memory on a specific node}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjΫhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjhNhNubj)}(hXz**Parameters** ``unsigned long size`` allocation size ``int node`` numa node **Description** Allocate enough pages to cover **size** from the page level allocator and map them into contiguous kernel virtual space. For tight control over page level allocator and protection flags use __vmalloc() instead. **Return** pointer to the allocated memory or ``NULL`` on errorh](jM)}(h**Parameters**h]j)}(hjìh]h Parameters}(hjŬhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjubj)}(hhh](j)}(h'``unsigned long size`` allocation size h](j)}(h``unsigned long size``h]jS)}(hjh]hunsigned long size}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjܬubj)}(hhh]jM)}(hallocation sizeh]hallocation size}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjܬubeh}(h]h ]h"]h$]h&]uh1jhjhMhj٬ubj)}(h``int node`` numa node h](j)}(h ``int node``h]jS)}(hjh]hint node}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjubj)}(hhh]jM)}(h numa nodeh]h numa node}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj0hMhj1ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj0hMhj٬ubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjVh]h Description}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjTubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjubjM)}(hxAllocate enough pages to cover **size** from the page level allocator and map them into contiguous kernel virtual space.h](hAllocate enough pages to cover }(hjlhhhNhNubj)}(h**size**h]hsize}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jhjlubhQ from the page level allocator and map them into contiguous kernel virtual space.}(hjlhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjubjM)}(hYFor tight control over page level allocator and protection flags use __vmalloc() instead.h]hYFor tight control over page level allocator and protection flags use __vmalloc() instead.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjubjM)}(h4pointer to the allocated memory or ``NULL`` on errorh](h#pointer to the allocated memory or }(hjhhhNhNubjS)}(h``NULL``h]hNULL}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubh on error}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hvzalloc_node (C function)c.vzalloc_nodehNtauh1hhjhhhNhNubh)}(hhh](h)}(h2void * vzalloc_node (unsigned long size, int node)h]h)}(h0void *vzalloc_node(unsigned long size, int node)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjhhhjhMubh)}(h vzalloc_nodeh]j)}(h vzalloc_nodeh]h vzalloc_node}(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMubj8)}(h(unsigned long size, int node)h](j>)}(hunsigned long sizeh](j)}(hunsignedh]hunsigned}(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;ubj)}(h h]h }(hjMhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;ubj)}(hlongh]hlong}(hj[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;ubj)}(h h]h }(hjihhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;ubj)}(hsizeh]hsize}(hjwhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj7ubj>)}(hint nodeh](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hnodeh]hnode}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj7ubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]jM)}(h1allocate memory on a specific node with zero fillh]h1allocate memory on a specific node with zero fill}(hj֮hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjӮhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjhNhNubj)}(hXD**Parameters** ``unsigned long size`` allocation size ``int node`` numa node **Description** Allocate enough pages to cover **size** from the page level allocator and map them into contiguous kernel virtual space. The memory allocated is set to zero. **Return** pointer to the allocated memory or ``NULL`` on errorh](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjubj)}(hhh](j)}(h'``unsigned long size`` allocation size h](j)}(h``unsigned long size``h]jS)}(hjh]hunsigned long size}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjubj)}(hhh]jM)}(hallocation sizeh]hallocation size}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj,hMhj-ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj,hMhjubj)}(h``int node`` numa node h](j)}(h ``int node``h]jS)}(hjPh]hint node}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjNubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjJubj)}(hhh]jM)}(h numa nodeh]h numa node}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjehMhjfubah}(h]h ]h"]h$]h&]uh1jhjJubeh}(h]h ]h"]h$]h&]uh1jhjehMhjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjubjM)}(hAllocate enough pages to cover **size** from the page level allocator and map them into contiguous kernel virtual space. The memory allocated is set to zero.h](hAllocate enough pages to cover }(hjhhhNhNubj)}(h**size**h]hsize}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhv from the page level allocator and map them into contiguous kernel virtual space. The memory allocated is set to zero.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjubjM)}(h **Return**h]j)}(hjįh]hReturn}(hjƯhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj¯ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjubjM)}(h4pointer to the allocated memory or ``NULL`` on errorh](h#pointer to the allocated memory or }(hjگhhhNhNubjS)}(h``NULL``h]hNULL}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjگubh on error}(hjگhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h vrealloc_node_align (C function)c.vrealloc_node_alignhNtauh1hhjhhhNhNubh)}(hhh](h)}(hbvoid * vrealloc_node_align (const void *p, size_t size, unsigned long align, gfp_t flags, int nid)h]h)}(h`void *vrealloc_node_align(const void *p, size_t size, unsigned long align, gfp_t flags, int nid)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMubj)}(h h]h }(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhj)hMubjr)}(hjuh]h*}(hj8hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjhhhj)hMubh)}(hvrealloc_node_alignh]j)}(hvrealloc_node_alignh]hvrealloc_node_align}(hjIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhj)hMubj8)}(hG(const void *p, size_t size, unsigned long align, gfp_t flags, int nid)h](j>)}(h const void *ph](j)}(hjh]hconst}(hjehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubj)}(h h]h }(hjrhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubj)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjaubj)}(hj~h]hp}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj]ubj>)}(h size_t sizeh](h)}(hhh]j)}(hsize_th]hsize_t}(hjİhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjưmodnameN classnameNjj)}j]j)}jjKsbc.vrealloc_node_alignasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hsizeh]hsize}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj]ubj>)}(hunsigned long alignh](j)}(hunsignedh]hunsigned}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hlongh]hlong}(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(halignh]halign}(hjChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj]ubj>)}(h gfp_t flagsh](h)}(hhh]j)}(hgfp_th]hgfp_t}(hj_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjamodnameN classnameNjj)}j]jc.vrealloc_node_alignasbuh1hhjXubj)}(h h]h }(hj}hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjXubj)}(hflagsh]hflags}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjXubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj]ubj>)}(hint nidh](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hnidh]hnid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj]ubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhj)hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhj)hMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj)hMhjhhubj4)}(hhh]jM)}(hAreallocate virtually contiguous memory; contents remain unchangedh]hAreallocate virtually contiguous memory; contents remain unchanged}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhj)hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjhNhNubj)}(hX'**Parameters** ``const void *p`` object to reallocate memory for ``size_t size`` the size to reallocate ``unsigned long align`` requested alignment ``gfp_t flags`` the flags for the page level allocator ``int nid`` node number of the target node **Description** If **p** is ``NULL``, vrealloc_XXX() behaves exactly like vmalloc_XXX(). If **size** is 0 and **p** is not a ``NULL`` pointer, the object pointed to is freed. If the caller wants the new memory to be on specific node *only*, __GFP_THISNODE flag should be set, otherwise the function will try to avoid reallocation and possibly disregard the specified **nid**. If __GFP_ZERO logic is requested, callers must ensure that, starting with the initial memory allocation, every subsequent call to this API for the same memory allocation is flagged with __GFP_ZERO. Otherwise, it is possible that __GFP_ZERO is not fully honored by this API. Requesting an alignment that is bigger than the alignment of the existing allocation will fail. In any case, the contents of the object pointed to are preserved up to the lesser of the new and old sizes. This function must not be called concurrently with itself or vfree() for the same memory allocation. **Return** pointer to the allocated memory; ``NULL`` if **size** is zero or in case of failureh](jM)}(h**Parameters**h]j)}(hj h]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjubj)}(hhh](j)}(h2``const void *p`` object to reallocate memory for h](j)}(h``const void *p``h]jS)}(hj+h]h const void *p}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj)ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhj%ubj)}(hhh]jM)}(hobject to reallocate memory forh]hobject to reallocate memory for}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj@hMhjAubah}(h]h ]h"]h$]h&]uh1jhj%ubeh}(h]h ]h"]h$]h&]uh1jhj@hMhj"ubj)}(h'``size_t size`` the size to reallocate h](j)}(h``size_t size``h]jS)}(hjdh]h size_t size}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjbubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhj^ubj)}(hhh]jM)}(hthe size to reallocateh]hthe size to reallocate}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjyhMhjzubah}(h]h ]h"]h$]h&]uh1jhj^ubeh}(h]h ]h"]h$]h&]uh1jhjyhMhj"ubj)}(h,``unsigned long align`` requested alignment h](j)}(h``unsigned long align``h]jS)}(hjh]hunsigned long align}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjubj)}(hhh]jM)}(hrequested alignmenth]hrequested alignment}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhj"ubj)}(h7``gfp_t flags`` the flags for the page level allocator h](j)}(h``gfp_t flags``h]jS)}(hjֲh]h gfp_t flags}(hjزhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjԲubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjвubj)}(hhh]jM)}(h&the flags for the page level allocatorh]h&the flags for the page level allocator}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjвubeh}(h]h ]h"]h$]h&]uh1jhjhMhj"ubj)}(h+``int nid`` node number of the target node h](j)}(h ``int nid``h]jS)}(hjh]hint nid}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhj ubj)}(hhh]jM)}(hnode number of the target nodeh]hnode number of the target node}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj$hMhj%ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj$hMhj"ubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjJh]h Description}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjHubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chM hjubjM)}(hIf **p** is ``NULL``, vrealloc_XXX() behaves exactly like vmalloc_XXX(). If **size** is 0 and **p** is not a ``NULL`` pointer, the object pointed to is freed.h](hIf }(hj`hhhNhNubj)}(h**p**h]hp}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj`ubh is }(hj`hhhNhNubjS)}(h``NULL``h]hNULL}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj`ubh8, vrealloc_XXX() behaves exactly like vmalloc_XXX(). If }(hj`hhhNhNubj)}(h**size**h]hsize}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj`ubh is 0 and }(hj`hhhNhNubj)}(h**p**h]hp}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj`ubh is not a }(hj`hhhNhNubjS)}(h``NULL``h]hNULL}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj`ubh) pointer, the object pointed to is freed.}(hj`hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjubjM)}(hIf the caller wants the new memory to be on specific node *only*, __GFP_THISNODE flag should be set, otherwise the function will try to avoid reallocation and possibly disregard the specified **nid**.h](h:If the caller wants the new memory to be on specific node }(hjɳhhhNhNubj )}(h*only*h]honly}(hjѳhhhNhNubah}(h]h ]h"]h$]h&]uh1j hjɳubh, __GFP_THISNODE flag should be set, otherwise the function will try to avoid reallocation and possibly disregard the specified }(hjɳhhhNhNubj)}(h**nid**h]hnid}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjɳubh.}(hjɳhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chM hjubjM)}(hXIf __GFP_ZERO logic is requested, callers must ensure that, starting with the initial memory allocation, every subsequent call to this API for the same memory allocation is flagged with __GFP_ZERO. Otherwise, it is possible that __GFP_ZERO is not fully honored by this API.h]hXIf __GFP_ZERO logic is requested, callers must ensure that, starting with the initial memory allocation, every subsequent call to this API for the same memory allocation is flagged with __GFP_ZERO. Otherwise, it is possible that __GFP_ZERO is not fully honored by this API.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjubjM)}(h_Requesting an alignment that is bigger than the alignment of the existing allocation will fail.h]h_Requesting an alignment that is bigger than the alignment of the existing allocation will fail.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjubjM)}(hkIn any case, the contents of the object pointed to are preserved up to the lesser of the new and old sizes.h]hkIn any case, the contents of the object pointed to are preserved up to the lesser of the new and old sizes.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjubjM)}(hdThis function must not be called concurrently with itself or vfree() for the same memory allocation.h]hdThis function must not be called concurrently with itself or vfree() for the same memory allocation.}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjubjM)}(h **Return**h]j)}(hj:h]hReturn}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj8ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjubjM)}(hSpointer to the allocated memory; ``NULL`` if **size** is zero or in case of failureh](h!pointer to the allocated memory; }(hjPhhhNhNubjS)}(h``NULL``h]hNULL}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjPubh if }(hjPhhhNhNubj)}(h**size**h]hsize}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjPubh is zero or in case of failure}(hjPhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hvmalloc_32 (C function) c.vmalloc_32hNtauh1hhjhhhNhNubh)}(hhh](h)}(h&void * vmalloc_32 (unsigned long size)h]h)}(h$void *vmalloc_32(unsigned long size)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjhhhjhMubh)}(h vmalloc_32h]j)}(h vmalloc_32h]h vmalloc_32}(hjѴhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjʹubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMubj8)}(h(unsigned long size)h]j>)}(hunsigned long sizeh](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hlongh]hlong}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hsizeh]hsize}(hj%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]jM)}(h8allocate virtually contiguous memory (32bit addressable)h]h8allocate virtually contiguous memory (32bit addressable)}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjLhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjgjHjgjIjJjKuh1hhhhjhNhNubj)}(hX**Parameters** ``unsigned long size`` allocation size **Description** Allocate enough 32bit PA addressable pages to cover **size** from the page level allocator and map them into contiguous kernel virtual space. **Return** pointer to the allocated memory or ``NULL`` on errorh](jM)}(h**Parameters**h]j)}(hjqh]h Parameters}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1jhjoubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjkubj)}(hhh]j)}(h'``unsigned long size`` allocation size h](j)}(h``unsigned long size``h]jS)}(hjh]hunsigned long size}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjubj)}(hhh]jM)}(hallocation sizeh]hallocation size}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjkubjM)}(h**Description**h]j)}(hj˵h]h Description}(hj͵hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjɵubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjkubjM)}(hAllocate enough 32bit PA addressable pages to cover **size** from the page level allocator and map them into contiguous kernel virtual space.h](h4Allocate enough 32bit PA addressable pages to cover }(hjhhhNhNubj)}(h**size**h]hsize}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhQ from the page level allocator and map them into contiguous kernel virtual space.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjkubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjkubjM)}(h4pointer to the allocated memory or ``NULL`` on errorh](h#pointer to the allocated memory or }(hjhhhNhNubjS)}(h``NULL``h]hNULL}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubh on error}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjkubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hvmalloc_32_user (C function)c.vmalloc_32_userhNtauh1hhjhhhNhNubh)}(hhh](h)}(h+void * vmalloc_32_user (unsigned long size)h]h)}(h)void *vmalloc_32_user(unsigned long size)h](j)}(hvoidh]hvoid}(hj[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjWhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMubj)}(h h]h }(hjjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjWhhhjihMubjr)}(hjuh]h*}(hjxhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjWhhhjihMubh)}(hvmalloc_32_userh]j)}(hvmalloc_32_userh]hvmalloc_32_user}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjWhhhjihMubj8)}(h(unsigned long size)h]j>)}(hunsigned long sizeh](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj϶hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hsizeh]hsize}(hjݶhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjWhhhjihMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjShhhjihMubah}(h]jNah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjihMhjPhhubj4)}(hhh]jM)}(h1allocate zeroed virtually contiguous 32bit memoryh]h1allocate zeroed virtually contiguous 32bit memory}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjhhubah}(h]h ]h"]h$]h&]uh1j3hjPhhhjihMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjhNhNubj)}(h**Parameters** ``unsigned long size`` allocation size **Description** The resulting memory area is 32bit addressable and zeroed so it can be mapped to userspace without leaking data. **Return** pointer to the allocated memory or ``NULL`` on errorh](jM)}(h**Parameters**h]j)}(hj)h]h Parameters}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj'ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhj#ubj)}(hhh]j)}(h'``unsigned long size`` allocation size h](j)}(h``unsigned long size``h]jS)}(hjHh]hunsigned long size}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjFubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhjBubj)}(hhh]jM)}(hallocation sizeh]hallocation size}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj]hMhj^ubah}(h]h ]h"]h$]h&]uh1jhjBubeh}(h]h ]h"]h$]h&]uh1jhj]hMhj?ubah}(h]h ]h"]h$]h&]uh1jhj#ubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhj#ubjM)}(hpThe resulting memory area is 32bit addressable and zeroed so it can be mapped to userspace without leaking data.h]hpThe resulting memory area is 32bit addressable and zeroed so it can be mapped to userspace without leaking data.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhj#ubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhj#ubjM)}(h4pointer to the allocated memory or ``NULL`` on errorh](h#pointer to the allocated memory or }(hjhhhNhNubjS)}(h``NULL``h]hNULL}(hjȷhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubh on error}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chMhj#ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h remap_vmalloc_range (C function)c.remap_vmalloc_rangehNtauh1hhjhhhNhNubh)}(hhh](h)}(hUint remap_vmalloc_range (struct vm_area_struct *vma, void *addr, unsigned long pgoff)h]h)}(hTint remap_vmalloc_range(struct vm_area_struct *vma, void *addr, unsigned long pgoff)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chM/ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM/ubh)}(hremap_vmalloc_rangeh]j)}(hremap_vmalloc_rangeh]hremap_vmalloc_range}(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhM/ubj8)}(h=(struct vm_area_struct *vma, void *addr, unsigned long pgoff)h](j>)}(hstruct vm_area_struct *vmah](j)}(hjJ,h]hstruct}(hj>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:ubj)}(h h]h }(hjKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:ubh)}(hhh]j)}(hvm_area_structh]hvm_area_struct}(hj\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjYubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj^modnameN classnameNjj)}j]j)}jj$sbc.remap_vmalloc_rangeasbuh1hhj:ubj)}(h h]h }(hj|hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:ubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj:ubj)}(hvmah]hvma}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj6ubj>)}(h void *addrh](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hj̸hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(haddrh]haddr}(hjٸhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj6ubj>)}(hunsigned long pgoffh](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hpgoffh]hpgoff}(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj6ubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhM/ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhM/ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhM/hjhhubj4)}(hhh]jM)}(hmap vmalloc pages to userspaceh]hmap vmalloc pages to userspace}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chM/hjQhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhM/ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjljHjljIjJjKuh1hhhhjhNhNubj)}(hX**Parameters** ``struct vm_area_struct *vma`` vma to cover (map full range of vma) ``void *addr`` vmalloc memory ``unsigned long pgoff`` number of pages into addr before first page to map **Return** 0 for success, -Exxx on failure **Description** This function checks that addr is a valid vmalloc'ed area, and that it is big enough to cover the vma. Will return failure if that criteria isn't met. Similar to remap_pfn_range() (see mm/memory.c)h](jM)}(h**Parameters**h]j)}(hjvh]h Parameters}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjtubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chM3hjpubj)}(hhh](j)}(hD``struct vm_area_struct *vma`` vma to cover (map full range of vma) h](j)}(h``struct vm_area_struct *vma``h]jS)}(hjh]hstruct vm_area_struct *vma}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chM0hjubj)}(hhh]jM)}(h$vma to cover (map full range of vma)h]h$vma to cover (map full range of vma)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM0hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM0hjubj)}(h``void *addr`` vmalloc memory h](j)}(h``void *addr``h]jS)}(hjιh]h void *addr}(hjйhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj̹ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chM1hjȹubj)}(hhh]jM)}(hvmalloc memoryh]hvmalloc memory}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM1hjubah}(h]h ]h"]h$]h&]uh1jhjȹubeh}(h]h ]h"]h$]h&]uh1jhjhM1hjubj)}(hK``unsigned long pgoff`` number of pages into addr before first page to map h](j)}(h``unsigned long pgoff``h]jS)}(hjh]hunsigned long pgoff}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chM2hjubj)}(hhh]jM)}(h2number of pages into addr before first page to maph]h2number of pages into addr before first page to map}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM2hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM2hjubeh}(h]h ]h"]h$]h&]uh1jhjpubjM)}(h **Return**h]j)}(hjBh]hReturn}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj@ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chM4hjpubjM)}(h0 for success, -Exxx on failureh]h0 for success, -Exxx on failure}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chM4hjpubjM)}(h**Description**h]j)}(hjih]h Description}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjgubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chM6hjpubjM)}(hThis function checks that addr is a valid vmalloc'ed area, and that it is big enough to cover the vma. Will return failure if that criteria isn't met.h]hThis function checks that addr is a valid vmalloc’ed area, and that it is big enough to cover the vma. Will return failure if that criteria isn’t met.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chM5hjpubjM)}(h.Similar to remap_pfn_range() (see mm/memory.c)h]h.Similar to remap_pfn_range() (see mm/memory.c)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:55: ./mm/vmalloc.chM9hjpubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubeh}(h]virtually-contiguous-mappingsah ]h"]virtually contiguous mappingsah$]h&]uh1hhhhhhhhK5ubh)}(hhh](h)}(hKernel Page Table Permissionsh]hKernel Page Table Permissions}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhK;ubjM)}(hZThe set_memory() and set_direct_map() APIs update permissions of existing kernel mappings.h]hZThe set_memory() and set_direct_map() APIs update permissions of existing kernel mappings.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:61: ./include/linux/set_memory.hhK hjhhubjM)}(hThe set_memory() functions operate on a range of kernel virtual addresses, the set_direct_map() functions operate on the direct map.h]hThe set_memory() functions operate on a range of kernel virtual addresses, the set_direct_map() functions operate on the direct map.}(hj̺hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:61: ./include/linux/set_memory.hhK hjhhubjM)}(hThe updates are not atomic: when a call fails, an arbitrary prefix of the range may have been updated already and there is no automatic rollback. A caller must restore the required permissions before reusing or freeing the memory.h]hThe updates are not atomic: when a call fails, an arbitrary prefix of the range may have been updated already and there is no automatic rollback. A caller must restore the required permissions before reusing or freeing the memory.}(hjۺhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:61: ./include/linux/set_memory.hhKhjhhubjM)}(hWhen an architecture does not implement these APIs they succeed without doing anything, so a return value of 0 does not mean that the permissions were actually changed.h]hWhen an architecture does not implement these APIs they succeed without doing anything, so a return value of 0 does not mean that the permissions were actually changed.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:61: ./include/linux/set_memory.hhKhjhhubjM)}(hCallers that depend on the permissions being applied must ensure that the architecture supports the required operation for the target addresses. The Kconfig symbols alone do not guarantee this.h]hCallers that depend on the permissions being applied must ensure that the architecture supports the required operation for the target addresses. The Kconfig symbols alone do not guarantee this.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:61: ./include/linux/set_memory.hhKhjhhubjM)}(h}See Documentation/mm/kernel-page-tables.rst for the details and for the differences between the architecture implementations.h]h}See Documentation/mm/kernel-page-tables.rst for the details and for the differences between the architecture implementations.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:61: ./include/linux/set_memory.hhKhjhhubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hset_memory_ro (C function)c.set_memory_rohNtauh1hhjhhhNhNubh)}(hhh](h)}(h4int set_memory_ro (unsigned long addr, int numpages)h]h)}(h3int set_memory_ro(unsigned long addr, int numpages)h](j)}(hinth]hint}(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,hhhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhK&ubj)}(h h]h }(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,hhhj>hK&ubh)}(h set_memory_roh]j)}(h set_memory_roh]h set_memory_ro}(hjQhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjMubah}(h]h ](jjeh"]h$]h&]jjuh1hhj,hhhj>hK&ubj8)}(h"(unsigned long addr, int numpages)h](j>)}(hunsigned long addrh](j)}(hunsignedh]hunsigned}(hjmhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjiubj)}(h h]h }(hj{hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjiubj)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjiubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjiubj)}(haddrh]haddr}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjiubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjeubj>)}(h int numpagesh](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj̻hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hnumpagesh]hnumpages}(hjڻhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjeubeh}(h]h ]h"]h$]h&]jjuh1j7hj,hhhj>hK&ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj(hhhj>hK&ubah}(h]j#ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj>hK&hj%hhubj4)}(hhh]jM)}(hmake a kernel mapping read-onlyh]hmake a kernel mapping read-only}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhK&hjhhubah}(h]h ]h"]h$]h&]uh1j3hj%hhhj>hK&ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjhNhNubj)}(h**Parameters** ``unsigned long addr`` page aligned start of the kernel virtual address range ``int numpages`` number of pages in the range **Description** Flushes the TLB for the range. **Return** 0 on success, negative error code on failure.h](jM)}(h**Parameters**h]j)}(hj&h]h Parameters}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj$ubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhK*hj ubj)}(hhh](j)}(hN``unsigned long addr`` page aligned start of the kernel virtual address range h](j)}(h``unsigned long addr``h]jS)}(hjEh]hunsigned long addr}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjCubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhK'hj?ubj)}(hhh]jM)}(h6page aligned start of the kernel virtual address rangeh]h6page aligned start of the kernel virtual address range}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjZhK'hj[ubah}(h]h ]h"]h$]h&]uh1jhj?ubeh}(h]h ]h"]h$]h&]uh1jhjZhK'hj<ubj)}(h.``int numpages`` number of pages in the range h](j)}(h``int numpages``h]jS)}(hj~h]h int numpages}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj|ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhK(hjxubj)}(hhh]jM)}(hnumber of pages in the rangeh]hnumber of pages in the range}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhK(hjubah}(h]h ]h"]h$]h&]uh1jhjxubeh}(h]h ]h"]h$]h&]uh1jhjhK(hj<ubeh}(h]h ]h"]h$]h&]uh1jhj ubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhK*hj ubjM)}(hFlushes the TLB for the range.h]hFlushes the TLB for the range.}(hjϼhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhK)hj ubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj޼ubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhK+hj ubjM)}(h-0 on success, negative error code on failure.h]h-0 on success, negative error code on failure.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhK,hj ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hset_memory_rw (C function)c.set_memory_rwhNtauh1hhjhhhNhNubh)}(hhh](h)}(h4int set_memory_rw (unsigned long addr, int numpages)h]h)}(h3int set_memory_rw(unsigned long addr, int numpages)h](j)}(hinth]hint}(hj%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!hhhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhK1ubj)}(h h]h }(hj4hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!hhhj3hK1ubh)}(h set_memory_rwh]j)}(h set_memory_rwh]h set_memory_rw}(hjFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubah}(h]h ](jjeh"]h$]h&]jjuh1hhj!hhhj3hK1ubj8)}(h"(unsigned long addr, int numpages)h](j>)}(hunsigned long addrh](j)}(hunsignedh]hunsigned}(hjbhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^ubj)}(h h]h }(hjphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^ubj)}(hlongh]hlong}(hj~hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^ubj)}(haddrh]haddr}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjZubj>)}(h int numpagesh](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hnumpagesh]hnumpages}(hjϽhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjZubeh}(h]h ]h"]h$]h&]jjuh1j7hj!hhhj3hK1ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhj3hK1ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj3hK1hjhhubj4)}(hhh]jM)}(hmake a kernel mapping writableh]hmake a kernel mapping writable}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhK1hjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhj3hK1ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjhNhNubj)}(h**Parameters** ``unsigned long addr`` page aligned start of the kernel virtual address range ``int numpages`` number of pages in the range **Description** Flushes the TLB for the range. **Return** 0 on success, negative error code on failure.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhK5hjubj)}(hhh](j)}(hN``unsigned long addr`` page aligned start of the kernel virtual address range h](j)}(h``unsigned long addr``h]jS)}(hj:h]hunsigned long addr}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj8ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhK2hj4ubj)}(hhh]jM)}(h6page aligned start of the kernel virtual address rangeh]h6page aligned start of the kernel virtual address range}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjOhK2hjPubah}(h]h ]h"]h$]h&]uh1jhj4ubeh}(h]h ]h"]h$]h&]uh1jhjOhK2hj1ubj)}(h.``int numpages`` number of pages in the range h](j)}(h``int numpages``h]jS)}(hjsh]h int numpages}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjqubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhK3hjmubj)}(hhh]jM)}(hnumber of pages in the rangeh]hnumber of pages in the range}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhK3hjubah}(h]h ]h"]h$]h&]uh1jhjmubeh}(h]h ]h"]h$]h&]uh1jhjhK3hj1ubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhK5hjubjM)}(hFlushes the TLB for the range.h]hFlushes the TLB for the range.}(hjľhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhK4hjubjM)}(h **Return**h]j)}(hjվh]hReturn}(hj׾hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjӾubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhK6hjubjM)}(h-0 on success, negative error code on failure.h]h-0 on success, negative error code on failure.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhK7hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hset_memory_x (C function)c.set_memory_xhNtauh1hhjhhhNhNubh)}(hhh](h)}(h3int set_memory_x (unsigned long addr, int numpages)h]h)}(h2int set_memory_x(unsigned long addr, int numpages)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhK)}(hunsigned long addrh](j)}(hunsignedh]hunsigned}(hjWhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSubj)}(h h]h }(hjehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSubj)}(hlongh]hlong}(hjshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSubj)}(haddrh]haddr}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjOubj>)}(h int numpagesh](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hnumpagesh]hnumpages}(hjĿhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjOubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhj(hKhjbubj)}(hhh]jM)}(hnumber of pages in the rangeh]hnumber of pages in the range}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj}hK>hj~ubah}(h]h ]h"]h$]h&]uh1jhjbubeh}(h]h ]h"]h$]h&]uh1jhj}hK>hj&ubeh}(h]h ]h"]h$]h&]uh1jhj ubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhK@hj ubjM)}(hFlushes the TLB for the range.h]hFlushes the TLB for the range.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhK?hj ubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhKAhj ubjM)}(h-0 on success, negative error code on failure.h]h-0 on success, negative error code on failure.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhKBhj ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hset_memory_nx (C function)c.set_memory_nxhNtauh1hhjhhhNhNubh)}(hhh](h)}(h4int set_memory_nx (unsigned long addr, int numpages)h]h)}(h3int set_memory_nx(unsigned long addr, int numpages)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhKGubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhjhKGubh)}(h set_memory_nxh]j)}(h set_memory_nxh]h set_memory_nx}(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj hhhjhKGubj8)}(h"(unsigned long addr, int numpages)h](j>)}(hunsigned long addrh](j)}(hunsignedh]hunsigned}(hjLhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHubj)}(h h]h }(hjZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHubj)}(hlongh]hlong}(hjhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHubj)}(h h]h }(hjvhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHubj)}(haddrh]haddr}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjDubj>)}(h int numpagesh](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hnumpagesh]hnumpages}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjDubeh}(h]h ]h"]h$]h&]jjuh1j7hj hhhjhKGubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhKGubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhKGhjhhubj4)}(hhh]jM)}(h$make a kernel mapping non-executableh]h$make a kernel mapping non-executable}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhKGhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhKGubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjhNhNubj)}(h**Parameters** ``unsigned long addr`` page aligned start of the kernel virtual address range ``int numpages`` number of pages in the range **Description** Flushes the TLB for the range. **Return** 0 on success, negative error code on failure.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhKKhjubj)}(hhh](j)}(hN``unsigned long addr`` page aligned start of the kernel virtual address range h](j)}(h``unsigned long addr``h]jS)}(hj$h]hunsigned long addr}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj"ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhKHhjubj)}(hhh]jM)}(h6page aligned start of the kernel virtual address rangeh]h6page aligned start of the kernel virtual address range}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj9hKHhj:ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj9hKHhjubj)}(h.``int numpages`` number of pages in the range h](j)}(h``int numpages``h]jS)}(hj]h]h int numpages}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj[ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhKIhjWubj)}(hhh]jM)}(hnumber of pages in the rangeh]hnumber of pages in the range}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjrhKIhjsubah}(h]h ]h"]h$]h&]uh1jhjWubeh}(h]h ]h"]h$]h&]uh1jhjrhKIhjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhKKhjubjM)}(hFlushes the TLB for the range.h]hFlushes the TLB for the range.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhKJhjubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhKLhjubjM)}(h-0 on success, negative error code on failure.h]h-0 on success, negative error code on failure.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhKMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hset_memory_rox (C function)c.set_memory_roxhNtauh1hhjhhhNhNubh)}(hhh](h)}(h5int set_memory_rox (unsigned long addr, int numpages)h]h)}(h4int set_memory_rox(unsigned long addr, int numpages)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhKTubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhKTubh)}(hset_memory_roxh]j)}(hset_memory_roxh]hset_memory_rox}(hj%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhKTubj8)}(h"(unsigned long addr, int numpages)h](j>)}(hunsigned long addrh](j)}(hunsignedh]hunsigned}(hjAhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=ubj)}(h h]h }(hjOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=ubj)}(hlongh]hlong}(hj]hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=ubj)}(h h]h }(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=ubj)}(haddrh]haddr}(hjyhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj9ubj>)}(h int numpagesh](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hnumpagesh]hnumpages}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj9ubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhKTubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhKTubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhKThjhhubj4)}(hhh]jM)}(h.make a kernel mapping read-only and executableh]h.make a kernel mapping read-only and executable}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhKThjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhKTubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjhNhNubj)}(hX9**Parameters** ``unsigned long addr`` page aligned start of the kernel virtual address range ``int numpages`` number of pages in the range **Description** A failure may leave the range read-only but not executable. Flushes the TLB for the range. **Return** 0 on success, negative error code on failure.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhKXhjubj)}(hhh](j)}(hN``unsigned long addr`` page aligned start of the kernel virtual address range h](j)}(h``unsigned long addr``h]jS)}(hjh]hunsigned long addr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhKUhjubj)}(hhh]jM)}(h6page aligned start of the kernel virtual address rangeh]h6page aligned start of the kernel virtual address range}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj.hKUhj/ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj.hKUhjubj)}(h.``int numpages`` number of pages in the range h](j)}(h``int numpages``h]jS)}(hjRh]h int numpages}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjPubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhKVhjLubj)}(hhh]jM)}(hnumber of pages in the rangeh]hnumber of pages in the range}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjghKVhjhubah}(h]h ]h"]h$]h&]uh1jhjLubeh}(h]h ]h"]h$]h&]uh1jhjghKVhjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhKXhjubjM)}(h;A failure may leave the range read-only but not executable.h]h;A failure may leave the range read-only but not executable.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhKWhjubjM)}(hFlushes the TLB for the range.h]hFlushes the TLB for the range.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhKYhjubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhK[hjubjM)}(h-0 on success, negative error code on failure.h]h-0 on success, negative error code on failure.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhK\hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h+set_direct_map_invalid_noflush (C function) c.set_direct_map_invalid_noflushhNtauh1hhjhhhNhNubh)}(hhh](h)}(hGint set_direct_map_invalid_noflush (struct page *page, unsigned int nr)h]h)}(hFint set_direct_map_invalid_noflush(struct page *page, unsigned int nr)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhKiubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhKiubh)}(hset_direct_map_invalid_noflushh]j)}(hset_direct_map_invalid_noflushh]hset_direct_map_invalid_noflush}(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhKiubj8)}(h$(struct page *page, unsigned int nr)h](j>)}(hstruct page *pageh](j)}(hjJ,h]hstruct}(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjAubj)}(h h]h }(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjAubh)}(hhh]j)}(hpageh]hpage}(hjchhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj`ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjemodnameN classnameNjj)}j]j)}jj+sb c.set_direct_map_invalid_noflushasbuh1hhjAubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjAubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjAubj)}(hpageh]hpage}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjAubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj=ubj>)}(hunsigned int nrh](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hnrh]hnr}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj=ubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhKiubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhKiubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhKihjhhubj4)}(hhh]jM)}(h remove pages from the direct maph]h remove pages from the direct map}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhKihjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhKiubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj1jHj1jIjJjKuh1hhhhjhNhNubj)}(hX>**Parameters** ``struct page *page`` first page to update ``unsigned int nr`` number of pages to update **Description** Makes the direct mapping of **nr** pages starting at **page** not present. The caller is responsible for any required TLB flushing. **Return** 0 on success, negative error code on failure.h](jM)}(h**Parameters**h]j)}(hj;h]h Parameters}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj9ubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhKmhj5ubj)}(hhh](j)}(h+``struct page *page`` first page to update h](j)}(h``struct page *page``h]jS)}(hjZh]hstruct page *page}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjXubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhKjhjTubj)}(hhh]jM)}(hfirst page to updateh]hfirst page to update}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjohKjhjpubah}(h]h ]h"]h$]h&]uh1jhjTubeh}(h]h ]h"]h$]h&]uh1jhjohKjhjQubj)}(h.``unsigned int nr`` number of pages to update h](j)}(h``unsigned int nr``h]jS)}(hjh]hunsigned int nr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhKkhjubj)}(hhh]jM)}(hnumber of pages to updateh]hnumber of pages to update}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhKkhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKkhjQubeh}(h]h ]h"]h$]h&]uh1jhj5ubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhKmhj5ubjM)}(hMakes the direct mapping of **nr** pages starting at **page** not present. The caller is responsible for any required TLB flushing.h](hMakes the direct mapping of }(hjhhhNhNubj)}(h**nr**h]hnr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh pages starting at }(hjhhhNhNubj)}(h**page**h]hpage}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhF not present. The caller is responsible for any required TLB flushing.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhKlhj5ubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhKohj5ubjM)}(h-0 on success, negative error code on failure.h]h-0 on success, negative error code on failure.}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhKphj5ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h+set_direct_map_default_noflush (C function) c.set_direct_map_default_noflushhNtauh1hhjhhhNhNubh)}(hhh](h)}(hGint set_direct_map_default_noflush (struct page *page, unsigned int nr)h]h)}(hFint set_direct_map_default_noflush(struct page *page, unsigned int nr)h](j)}(hinth]hint}(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZhhhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhKyubj)}(h h]h }(hjmhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZhhhjlhKyubh)}(hset_direct_map_default_noflushh]j)}(hset_direct_map_default_noflushh]hset_direct_map_default_noflush}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjZhhhjlhKyubj8)}(h$(struct page *page, unsigned int nr)h](j>)}(hstruct page *pageh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hpageh]hpage}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsb c.set_direct_map_default_noflushasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hpageh]hpage}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hunsigned int nrh](j)}(hunsignedh]hunsigned}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(hinth]hint}(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h h]h }(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(hnrh]hnr}(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjZhhhjlhKyubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjVhhhjlhKyubah}(h]jQah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjlhKyhjShhubj4)}(hhh]jM)}(hrestore the direct map of pagesh]hrestore the direct map of pages}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhKyhjlhhubah}(h]h ]h"]h$]h&]uh1j3hjShhhjlhKyubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjhNhNubj)}(hXW**Parameters** ``struct page *page`` first page to update ``unsigned int nr`` number of pages to update **Description** Restores the default kernel permissions of the direct mapping of **nr** pages starting at **page**. The caller is responsible for any required TLB flushing. **Return** 0 on success, negative error code on failure.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhK}hjubj)}(hhh](j)}(h+``struct page *page`` first page to update h](j)}(h``struct page *page``h]jS)}(hjh]hstruct page *page}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhKzhjubj)}(hhh]jM)}(hfirst page to updateh]hfirst page to update}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhKzhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKzhjubj)}(h.``unsigned int nr`` number of pages to update h](j)}(h``unsigned int nr``h]jS)}(hjh]hunsigned int nr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhK{hjubj)}(hhh]jM)}(hnumber of pages to updateh]hnumber of pages to update}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhK{hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhK{hjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hj$h]h Description}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj"ubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhK}hjubjM)}(hRestores the default kernel permissions of the direct mapping of **nr** pages starting at **page**. The caller is responsible for any required TLB flushing.h](hARestores the default kernel permissions of the direct mapping of }(hj:hhhNhNubj)}(h**nr**h]hnr}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj:ubh pages starting at }(hj:hhhNhNubj)}(h**page**h]hpage}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jhj:ubh:. The caller is responsible for any required TLB flushing.}(hj:hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhK|hjubjM)}(h **Return**h]j)}(hjoh]hReturn}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjmubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhKhjubjM)}(h-0 on success, negative error code on failure.h]h-0 on success, negative error code on failure.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhKhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hcan_set_direct_map (C function)c.can_set_direct_maphNtauh1hhjhhhNhNubh)}(hhh](h)}(hbool can_set_direct_map (void)h]h)}(hbool can_set_direct_map(void)h](j)}(hjh]hbool}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhKubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhKubh)}(hcan_set_direct_maph]j)}(hcan_set_direct_maph]hcan_set_direct_map}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhKubj8)}(h(void)h]j>)}(hvoidh]j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhKubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhKubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhKhjhhubj4)}(hhh]jM)}(h'check if the direct map can be modifiedh]h'check if the direct map can be modified}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhKhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhKubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj2jHj2jIjJjKuh1hhhhjhNhNubj)}(hX**Parameters** ``void`` no arguments **Description** Available with CONFIG_ARCH_HAS_SET_DIRECT_MAP. Architectures may override this to report whether direct map updates are enabled at runtime. Even though the generic implementation returns true this does not guarantee that every address can be updated. See Documentation/mm/kernel-page-tables.rst for the details **Return** true unless the architecture reports direct map updates disabled.h](jM)}(h**Parameters**h]j)}(hj<h]h Parameters}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj:ubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhKhj6ubj)}(hhh]j)}(h``void`` no arguments h](j)}(h``void``h]jS)}(hj[h]hvoid}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjYubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhKhjUubj)}(hhh]jM)}(h no argumentsh]h no arguments}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjphKhjqubah}(h]h ]h"]h$]h&]uh1jhjUubeh}(h]h ]h"]h$]h&]uh1jhjphKhjRubah}(h]h ]h"]h$]h&]uh1jhj6ubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhKhj6ubjM)}(hAvailable with CONFIG_ARCH_HAS_SET_DIRECT_MAP. Architectures may override this to report whether direct map updates are enabled at runtime. Even though the generic implementation returns true this does not guarantee that every address can be updated.h]hAvailable with CONFIG_ARCH_HAS_SET_DIRECT_MAP. Architectures may override this to report whether direct map updates are enabled at runtime. Even though the generic implementation returns true this does not guarantee that every address can be updated.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhKhj6ubjM)}(h;See Documentation/mm/kernel-page-tables.rst for the detailsh]h;See Documentation/mm/kernel-page-tables.rst for the details}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhKhj6ubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhKhj6ubjM)}(hAtrue unless the architecture reports direct map updates disabled.h]hAtrue unless the architecture reports direct map updates disabled.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:64: ./include/linux/set_memory.hhKhj6ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubeh}(h]kernel-page-table-permissionsah ]h"]kernel page table permissionsah$]h&]uh1hhhhhhhhK;ubh)}(hhh](h)}(hFile Mapping and Page Cacheh]hFile Mapping and Page Cache}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKDubh)}(hhh](h)}(hFilemaph]hFilemap}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKGubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h%filemap_fdatawrite_range (C function)c.filemap_fdatawrite_rangehNtauh1hhjhhhNhNubh)}(hhh](h)}(hVint filemap_fdatawrite_range (struct address_space *mapping, loff_t start, loff_t end)h]h)}(hUint filemap_fdatawrite_range(struct address_space *mapping, loff_t start, loff_t end)h](j)}(hinth]hint}(hj;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7hhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMubj)}(h h]h }(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7hhhjIhMubh)}(hfilemap_fdatawrite_rangeh]j)}(hfilemap_fdatawrite_rangeh]hfilemap_fdatawrite_range}(hj\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjXubah}(h]h ](jjeh"]h$]h&]jjuh1hhj7hhhjIhMubj8)}(h9(struct address_space *mapping, loff_t start, loff_t end)h](j>)}(hstruct address_space *mappingh](j)}(hjJ,h]hstruct}(hjxhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjtubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjtubh)}(hhh]j)}(h address_spaceh]h address_space}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jj^sbc.filemap_fdatawrite_rangeasbuh1hhjtubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjtubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjtubj)}(hmappingh]hmapping}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjtubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjpubj>)}(h loff_t starth](h)}(hhh]j)}(hloff_th]hloff_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.filemap_fdatawrite_rangeasbuh1hhjubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hstarth]hstart}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjpubj>)}(h loff_t endh](h)}(hhh]j)}(hloff_th]hloff_t}(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj7modnameN classnameNjj)}j]jc.filemap_fdatawrite_rangeasbuh1hhj.ubj)}(h h]h }(hjShhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj.ubj)}(hendh]hend}(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj.ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjpubeh}(h]h ]h"]h$]h&]jjuh1j7hj7hhhjIhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj3hhhjIhMubah}(h]j.ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjIhMhj0hhubj4)}(hhh]jM)}(h/start writeback on mapping dirty pages in rangeh]h/start writeback on mapping dirty pages in range}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjhhubah}(h]h ]h"]h$]h&]uh1j3hj0hhhjIhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjhNhNubj)}(hX**Parameters** ``struct address_space *mapping`` address space structure to write ``loff_t start`` offset in bytes where the range starts ``loff_t end`` offset in bytes where the range ends (inclusive) **Description** Start writeback against all of a mapping's dirty pages that lie within the byte offsets inclusive. This is a data integrity operation that waits upon dirty or in writeback pages. **Return** ``0`` on success, negative error code otherwise.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubj)}(hhh](j)}(hC``struct address_space *mapping`` address space structure to write h](j)}(h!``struct address_space *mapping``h]jS)}(hjh]hstruct address_space *mapping}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubj)}(hhh]jM)}(h address space structure to writeh]h address space structure to write}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h8``loff_t start`` offset in bytes where the range starts h](j)}(h``loff_t start``h]jS)}(hjh]h loff_t start}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubj)}(hhh]jM)}(h&offset in bytes where the range startsh]h&offset in bytes where the range starts}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h@``loff_t end`` offset in bytes where the range ends (inclusive) h](j)}(h``loff_t end``h]jS)}(hj>h]h loff_t end}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj<ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhj8ubj)}(hhh]jM)}(h0offset in bytes where the range ends (inclusive)h]h0offset in bytes where the range ends (inclusive)}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjShMhjTubah}(h]h ]h"]h$]h&]uh1jhj8ubeh}(h]h ]h"]h$]h&]uh1jhjShMhjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjyh]h Description}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjwubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubjM)}(hoStart writeback against all of a mapping's dirty pages that lie within the byte offsets inclusive.h]hqStart writeback against all of a mapping’s dirty pages that lie within the byte offsets inclusive.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubjM)}(hOThis is a data integrity operation that waits upon dirty or in writeback pages.h]hOThis is a data integrity operation that waits upon dirty or in writeback pages.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubjM)}(h0``0`` on success, negative error code otherwise.h](jS)}(h``0``h]h0}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubh+ on success, negative error code otherwise.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h filemap_flush_range (C function)c.filemap_flush_rangehNtauh1hhjhhhNhNubh)}(hhh](h)}(hQint filemap_flush_range (struct address_space *mapping, loff_t start, loff_t end)h]h)}(hPint filemap_flush_range(struct address_space *mapping, loff_t start, loff_t end)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh)}(hfilemap_flush_rangeh]j)}(hfilemap_flush_rangeh]hfilemap_flush_range}(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMubj8)}(h9(struct address_space *mapping, loff_t start, loff_t end)h](j>)}(hstruct address_space *mappingh](j)}(hjJ,h]hstruct}(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;ubj)}(h h]h }(hjLhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;ubh)}(hhh]j)}(h address_spaceh]h address_space}(hj]hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj_modnameN classnameNjj)}j]j)}jj%sbc.filemap_flush_rangeasbuh1hhj;ubj)}(h h]h }(hj}hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;ubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj;ubj)}(hmappingh]hmapping}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj7ubj>)}(h loff_t starth](h)}(hhh]j)}(hloff_th]hloff_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jyc.filemap_flush_rangeasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hstarth]hstart}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj7ubj>)}(h loff_t endh](h)}(hhh]j)}(hloff_th]hloff_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jyc.filemap_flush_rangeasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hendh]hend}(hj(hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj7ubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]jM)}(hstart writeback on a rangeh]hstart writeback on a range}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjOhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjjHjjjIjJjKuh1hhhhjhNhNubj)}(hX_**Parameters** ``struct address_space *mapping`` target address_space ``loff_t start`` index to start writeback on ``loff_t end`` last (inclusive) index for writeback **Description** This is a non-integrity writeback helper, to start writing back folios for the indicated range. **Return** ``0`` on success, negative error code otherwise.h](jM)}(h**Parameters**h]j)}(hjth]h Parameters}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjrubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjnubj)}(hhh](j)}(h7``struct address_space *mapping`` target address_space h](j)}(h!``struct address_space *mapping``h]jS)}(hjh]hstruct address_space *mapping}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubj)}(hhh]jM)}(htarget address_spaceh]htarget address_space}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h-``loff_t start`` index to start writeback on h](j)}(h``loff_t start``h]jS)}(hjh]h loff_t start}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubj)}(hhh]jM)}(hindex to start writeback onh]hindex to start writeback on}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h4``loff_t end`` last (inclusive) index for writeback h](j)}(h``loff_t end``h]jS)}(hjh]h loff_t end}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubj)}(hhh]jM)}(h$last (inclusive) index for writebackh]h$last (inclusive) index for writeback}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubeh}(h]h ]h"]h$]h&]uh1jhjnubjM)}(h**Description**h]j)}(hj@h]h Description}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj>ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjnubjM)}(h_This is a non-integrity writeback helper, to start writing back folios for the indicated range.h]h_This is a non-integrity writeback helper, to start writing back folios for the indicated range.}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjnubjM)}(h **Return**h]j)}(hjgh]hReturn}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1jhjeubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjnubjM)}(h0``0`` on success, negative error code otherwise.h](jS)}(h``0``h]h0}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj}ubh+ on success, negative error code otherwise.}(hj}hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjnubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfilemap_flush (C function)c.filemap_flushhNtauh1hhjhhhNhNubh)}(hhh](h)}(h1int filemap_flush (struct address_space *mapping)h]h)}(h0int filemap_flush(struct address_space *mapping)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh)}(h filemap_flushh]j)}(h filemap_flushh]h filemap_flush}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMubj8)}(h(struct address_space *mapping)h]j>)}(hstruct address_space *mappingh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(h address_spaceh]h address_space}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsbc.filemap_flushasbuh1hhjubj)}(h h]h }(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjChhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hmappingh]hmapping}(hjPhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]jM)}(hmostly a non-blocking flushh]hmostly a non-blocking flush}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjwhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjhNhNubj)}(hX**Parameters** ``struct address_space *mapping`` target address_space **Description** This is a mostly non-blocking flush. Not suitable for data-integrity purposes - I/O may not be started against all dirty pages. **Return** ``0`` on success, negative error code otherwise.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubj)}(hhh]j)}(h7``struct address_space *mapping`` target address_space h](j)}(h!``struct address_space *mapping``h]jS)}(hjh]hstruct address_space *mapping}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubj)}(hhh]jM)}(htarget address_spaceh]htarget address_space}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubjM)}(hThis is a mostly non-blocking flush. Not suitable for data-integrity purposes - I/O may not be started against all dirty pages.h]hThis is a mostly non-blocking flush. Not suitable for data-integrity purposes - I/O may not be started against all dirty pages.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubjM)}(h0``0`` on success, negative error code otherwise.h](jS)}(h``0``h]h0}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj3ubh+ on success, negative error code otherwise.}(hj3hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h#filemap_range_has_page (C function)c.filemap_range_has_pagehNtauh1hhjhhhNhNubh)}(hhh](h)}(h_bool filemap_range_has_page (struct address_space *mapping, loff_t start_byte, loff_t end_byte)h]h)}(h^bool filemap_range_has_page(struct address_space *mapping, loff_t start_byte, loff_t end_byte)h](j)}(hjh]hbool}(hjphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjlhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMubj)}(h h]h }(hj~hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjlhhhj}hMubh)}(hfilemap_range_has_pageh]j)}(hfilemap_range_has_pageh]hfilemap_range_has_page}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjlhhhj}hMubj8)}(hC(struct address_space *mapping, loff_t start_byte, loff_t end_byte)h](j>)}(hstruct address_space *mappingh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(h address_spaceh]h address_space}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsbc.filemap_range_has_pageasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hmappingh]hmapping}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hloff_t start_byteh](h)}(hhh]j)}(hloff_th]hloff_t}(hj!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj#modnameN classnameNjj)}j]jc.filemap_range_has_pageasbuh1hhjubj)}(h h]h }(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h start_byteh]h start_byte}(hjMhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hloff_t end_byteh](h)}(hhh]j)}(hloff_th]hloff_t}(hjihhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjfubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjkmodnameN classnameNjj)}j]jc.filemap_range_has_pageasbuh1hhjbubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjbubj)}(hend_byteh]hend_byte}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjbubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjlhhhj}hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhhj}hMubah}(h]jcah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj}hMhjehhubj4)}(hhh]jM)}(h check if a page exists in range.h]h check if a page exists in range.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjhhubah}(h]h ]h"]h$]h&]uh1j3hjehhhj}hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjhNhNubj)}(hX**Parameters** ``struct address_space *mapping`` address space within which to check ``loff_t start_byte`` offset in bytes where the range starts ``loff_t end_byte`` offset in bytes where the range ends (inclusive) **Description** Find at least one page in the range supplied, usually used to check if direct writing in this range will trigger a writeback. **Return** ``true`` if at least one page exists in the specified range, ``false`` otherwise.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubj)}(hhh](j)}(hF``struct address_space *mapping`` address space within which to check h](j)}(h!``struct address_space *mapping``h]jS)}(hjh]hstruct address_space *mapping}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubj)}(hhh]jM)}(h#address space within which to checkh]h#address space within which to check}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h=``loff_t start_byte`` offset in bytes where the range starts h](j)}(h``loff_t start_byte``h]jS)}(hj9h]hloff_t start_byte}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj7ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhj3ubj)}(hhh]jM)}(h&offset in bytes where the range startsh]h&offset in bytes where the range starts}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjNhMhjOubah}(h]h ]h"]h$]h&]uh1jhj3ubeh}(h]h ]h"]h$]h&]uh1jhjNhMhjubj)}(hE``loff_t end_byte`` offset in bytes where the range ends (inclusive) h](j)}(h``loff_t end_byte``h]jS)}(hjrh]hloff_t end_byte}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjpubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjlubj)}(hhh]jM)}(h0offset in bytes where the range ends (inclusive)h]h0offset in bytes where the range ends (inclusive)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjlubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubjM)}(h}Find at least one page in the range supplied, usually used to check if direct writing in this range will trigger a writeback.h]h}Find at least one page in the range supplied, usually used to check if direct writing in this range will trigger a writeback.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubjM)}(hQ``true`` if at least one page exists in the specified range, ``false`` otherwise.h](jS)}(h``true``h]htrue}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubh5 if at least one page exists in the specified range, }(hjhhhNhNubjS)}(h ``false``h]hfalse}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubh otherwise.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h$filemap_fdatawait_range (C function)c.filemap_fdatawait_rangehNtauh1hhjhhhNhNubh)}(hhh](h)}(h_int filemap_fdatawait_range (struct address_space *mapping, loff_t start_byte, loff_t end_byte)h]h)}(h^int filemap_fdatawait_range(struct address_space *mapping, loff_t start_byte, loff_t end_byte)h](j)}(hinth]hint}(hj9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5hhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMubj)}(h h]h }(hjHhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5hhhjGhMubh)}(hfilemap_fdatawait_rangeh]j)}(hfilemap_fdatawait_rangeh]hfilemap_fdatawait_range}(hjZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVubah}(h]h ](jjeh"]h$]h&]jjuh1hhj5hhhjGhMubj8)}(hC(struct address_space *mapping, loff_t start_byte, loff_t end_byte)h](j>)}(hstruct address_space *mappingh](j)}(hjJ,h]hstruct}(hjvhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjrubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjrubh)}(hhh]j)}(h address_spaceh]h address_space}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jj\sbc.filemap_fdatawait_rangeasbuh1hhjrubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjrubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjrubj)}(hmappingh]hmapping}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjrubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjnubj>)}(hloff_t start_byteh](h)}(hhh]j)}(hloff_th]hloff_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.filemap_fdatawait_rangeasbuh1hhjubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h start_byteh]h start_byte}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjnubj>)}(hloff_t end_byteh](h)}(hhh]j)}(hloff_th]hloff_t}(hj3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj5modnameN classnameNjj)}j]jc.filemap_fdatawait_rangeasbuh1hhj,ubj)}(h h]h }(hjQhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,ubj)}(hend_byteh]hend_byte}(hj_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjnubeh}(h]h ]h"]h$]h&]jjuh1j7hj5hhhjGhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj1hhhjGhMubah}(h]j,ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjGhMhj.hhubj4)}(hhh]jM)}(hwait for writeback to completeh]hwait for writeback to complete}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjhhubaFh}(h]h ]h"]h$]h&]uh1j3hj.hhhjGhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjhNhNubj)}(hXq**Parameters** ``struct address_space *mapping`` address space structure to wait for ``loff_t start_byte`` offset in bytes where the range starts ``loff_t end_byte`` offset in bytes where the range ends (inclusive) **Description** Walk the list of under-writeback pages of the given address space in the given range and wait for all of them. Check error status of the address space and return it. Since the error status of the address space is cleared by this function, callers are responsible for checking the return value and handling and/or reporting the error. **Return** error status of the address space.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM hjubj)}(hhh](j)}(hF``struct address_space *mapping`` address space structure to wait for h](j)}(h!``struct address_space *mapping``h]jS)}(hjh]hstruct address_space *mapping}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubj)}(hhh]jM)}(h#address space structure to wait forh]h#address space structure to wait for}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h=``loff_t start_byte`` offset in bytes where the range starts h](j)}(h``loff_t start_byte``h]jS)}(hjh]hloff_t start_byte}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubj)}(hhh]jM)}(h&offset in bytes where the range startsh]h&offset in bytes where the range starts}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(hE``loff_t end_byte`` offset in bytes where the range ends (inclusive) h](j)}(h``loff_t end_byte``h]jS)}(hj<h]hloff_t end_byte}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj:ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhj6ubj)}(hhh]jM)}(h0offset in bytes where the range ends (inclusive)h]h0offset in bytes where the range ends (inclusive)}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjQhMhjRubah}(h]h ]h"]h$]h&]uh1jhj6ubeh}(h]h ]h"]h$]h&]uh1jhjQhMhjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjwh]h Description}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjuubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM!hjubjM)}(hWalk the list of under-writeback pages of the given address space in the given range and wait for all of them. Check error status of the address space and return it.h]hWalk the list of under-writeback pages of the given address space in the given range and wait for all of them. Check error status of the address space and return it.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM hjubjM)}(hSince the error status of the address space is cleared by this function, callers are responsible for checking the return value and handling and/or reporting the error.h]hSince the error status of the address space is cleared by this function, callers are responsible for checking the return value and handling and/or reporting the error.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM$hjubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM(hjubjM)}(h"error status of the address space.h]h"error status of the address space.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM)hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h0filemap_fdatawait_range_keep_errors (C function)%c.filemap_fdatawait_range_keep_errorshNtauh1hhjhhhNhNubh)}(hhh](h)}(hkint filemap_fdatawait_range_keep_errors (struct address_space *mapping, loff_t start_byte, loff_t end_byte)h]h)}(hjint filemap_fdatawait_range_keep_errors(struct address_space *mapping, loff_t start_byte, loff_t end_byte)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM4ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM4ubh)}(h#filemap_fdatawait_range_keep_errorsh]j)}(h#filemap_fdatawait_range_keep_errorsh]h#filemap_fdatawait_range_keep_errors}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhM4ubj8)}(hC(struct address_space *mapping, loff_t start_byte, loff_t end_byte)h](j>)}(hstruct address_space *mappingh](j)}(hjJ,h]hstruct}(hj/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubj)}(h h]h }(hj<hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubh)}(hhh]j)}(h address_spaceh]h address_space}(hjMhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjOmodnameN classnameNjj)}j]j)}jjsb%c.filemap_fdatawait_range_keep_errorsasbuh1hhj+ubj)}(h h]h }(hjmhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubjr)}(hjuh]h*}(hj{hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj+ubj)}(hmappingh]hmapping}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj'ubj>)}(hloff_t start_byteh](h)}(hhh]j)}(hloff_th]hloff_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]ji%c.filemap_fdatawait_range_keep_errorsasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h start_byteh]h start_byte}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj'ubj>)}(hloff_t end_byteh](h)}(hhh]j)}(hloff_th]hloff_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]ji%c.filemap_fdatawait_range_keep_errorsasbuh1hhjubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hend_byteh]hend_byte}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj'ubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhM4ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhM4ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhM4hjhhubj4)}(hhh]jM)}(hwait for writeback to completeh]hwait for writeback to complete}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM4hj?hhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhM4ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjZjHjZjIjJjKuh1hhhhjhNhNubj)}(hXa**Parameters** ``struct address_space *mapping`` address space structure to wait for ``loff_t start_byte`` offset in bytes where the range starts ``loff_t end_byte`` offset in bytes where the range ends (inclusive) **Description** Walk the list of under-writeback pages of the given address space in the given range and wait for all of them. Unlike filemap_fdatawait_range(), this function does not clear error status of the address space. Use this function if callers don't handle errors themselves. Expected call sites are system-wide / filesystem-wide data flushers: e.g. sync(2), fsfreeze(8)h](jM)}(h**Parameters**h]j)}(hjdh]h Parameters}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjbubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM8hj^ubj)}(hhh](j)}(hF``struct address_space *mapping`` address space structure to wait for h](j)}(h!``struct address_space *mapping``h]jS)}(hjh]hstruct address_space *mapping}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM5hj}ubj)}(hhh]jM)}(h#address space structure to wait forh]h#address space structure to wait for}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM5hjubah}(h]h ]h"]h$]h&]uh1jhj}ubeh}(h]h ]h"]h$]h&]uh1jhjhM5hjzubj)}(h=``loff_t start_byte`` offset in bytes where the range starts h](j)}(h``loff_t start_byte``h]jS)}(hjh]hloff_t start_byte}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM6hjubj)}(hhh]jM)}(h&offset in bytes where the range startsh]h&offset in bytes where the range starts}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM6hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM6hjzubj)}(hE``loff_t end_byte`` offset in bytes where the range ends (inclusive) h](j)}(h``loff_t end_byte``h]jS)}(hjh]hloff_t end_byte}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM7hjubj)}(hhh]jM)}(h0offset in bytes where the range ends (inclusive)h]h0offset in bytes where the range ends (inclusive)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj hM7hj ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj hM7hjzubeh}(h]h ]h"]h$]h&]uh1jhj^ubjM)}(h**Description**h]j)}(hj0h]h Description}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj.ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM9hj^ubjM)}(hWalk the list of under-writeback pages of the given address space in the given range and wait for all of them. Unlike filemap_fdatawait_range(), this function does not clear error status of the address space.h]hWalk the list of under-writeback pages of the given address space in the given range and wait for all of them. Unlike filemap_fdatawait_range(), this function does not clear error status of the address space.}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM8hj^ubjM)}(hUse this function if callers don't handle errors themselves. Expected call sites are system-wide / filesystem-wide data flushers: e.g. sync(2), fsfreeze(8)h]hUse this function if callers don’t handle errors themselves. Expected call sites are system-wide / filesystem-wide data flushers: e.g. sync(2), fsfreeze(8)}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM<hj^ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h!file_fdatawait_range (C function)c.file_fdatawait_rangehNtauh1hhjhhhNhNubh)}(hhh](h)}(hPint file_fdatawait_range (struct file *file, loff_t start_byte, loff_t end_byte)h]h)}(hOint file_fdatawait_range(struct file *file, loff_t start_byte, loff_t end_byte)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMJubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMJubh)}(hfile_fdatawait_rangeh]j)}(hfile_fdatawait_rangeh]hfile_fdatawait_range}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMJubj8)}(h7(struct file *file, loff_t start_byte, loff_t end_byte)h](j>)}(hstruct file *fileh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hfileh]hfile}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsbc.file_fdatawait_rangeasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hj hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hfileh]hfile}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hloff_t start_byteh](h)}(hhh]j)}(hloff_th]hloff_t}(hj6hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj8modnameN classnameNjj)}j]jc.file_fdatawait_rangeasbuh1hhj/ubj)}(h h]h }(hjThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/ubj)}(h start_byteh]h start_byte}(hjbhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hloff_t end_byteh](h)}(hhh]j)}(hloff_th]hloff_t}(hj~hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.file_fdatawait_rangeasbuh1hhjwubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjwubj)}(hend_byteh]hend_byte}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjwubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMJubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj|hhhjhMJubah}(h]jwah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMJhjyhhubj4)}(hhh]jM)}(hwait for writeback to completeh]hwait for writeback to complete}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMJhjhhubah}(h]h ]h"]h$]h&]uh1j3hjyhhhjhMJubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjhNhNubj)}(hX**Parameters** ``struct file *file`` file pointing to address space structure to wait for ``loff_t start_byte`` offset in bytes where the range starts ``loff_t end_byte`` offset in bytes where the range ends (inclusive) **Description** Walk the list of under-writeback pages of the address space that file refers to, in the given range and wait for all of them. Check error status of the address space vs. the file->f_wb_err cursor and return it. Since the error status of the file is advanced by this function, callers are responsible for checking the return value and handling and/or reporting the error. **Return** error status of the address space vs. the file->f_wb_err cursor.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMNhjubj)}(hhh](j)}(hK``struct file *file`` file pointing to address space structure to wait for h](j)}(h``struct file *file``h]jS)}(hjh]hstruct file *file}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMKhjubj)}(hhh]jM)}(h4file pointing to address space structure to wait forh]h4file pointing to address space structure to wait for}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj*hMKhj+ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj*hMKhj ubj)}(h=``loff_t start_byte`` offset in bytes where the range starts h](j)}(h``loff_t start_byte``h]jS)}(hjNh]hloff_t start_byte}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjLubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMLhjHubj)}(hhh]jM)}(h&offset in bytes where the range startsh]h&offset in bytes where the range starts}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjchMLhjdubah}(h]h ]h"]h$]h&]uh1jhjHubeh}(h]h ]h"]h$]h&]uh1jhjchMLhj ubj)}(hE``loff_t end_byte`` offset in bytes where the range ends (inclusive) h](j)}(h``loff_t end_byte``h]jS)}(hjh]hloff_t end_byte}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMMhjubj)}(hhh]jM)}(h0offset in bytes where the range ends (inclusive)h]h0offset in bytes where the range ends (inclusive)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMMhj ubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMOhjubjM)}(hWalk the list of under-writeback pages of the address space that file refers to, in the given range and wait for all of them. Check error status of the address space vs. the file->f_wb_err cursor and return it.h]hWalk the list of under-writeback pages of the address space that file refers to, in the given range and wait for all of them. Check error status of the address space vs. the file->f_wb_err cursor and return it.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMNhjubjM)}(hSince the error status of the file is advanced by this function, callers are responsible for checking the return value and handling and/or reporting the error.h]hSince the error status of the file is advanced by this function, callers are responsible for checking the return value and handling and/or reporting the error.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMRhjubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMVhjubjM)}(h@error status of the address space vs. the file->f_wb_err cursor.h]h@error status of the address space vs. the file->f_wb_err cursor.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMWhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h*filemap_fdatawait_keep_errors (C function)c.filemap_fdatawait_keep_errorshNtauh1hhjhhhNhNubh)}(hhh](h)}(hAint filemap_fdatawait_keep_errors (struct address_space *mapping)h]h)}(h@int filemap_fdatawait_keep_errors(struct address_space *mapping)h](j)}(hinth]hint}(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9hhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMcubj)}(h h]h }(hjLhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9hhhjKhMcubh)}(hfilemap_fdatawait_keep_errorsh]j)}(hfilemap_fdatawait_keep_errorsh]hfilemap_fdatawait_keep_errors}(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZubah}(h]h ](jjeh"]h$]h&]jjuh1hhj9hhhjKhMcubj8)}(h(struct address_space *mapping)h]j>)}(hstruct address_space *mappingh](j)}(hjJ,h]hstruct}(hjzhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvubh)}(hhh]j)}(h address_spaceh]h address_space}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jj`sbc.filemap_fdatawait_keep_errorsasbuh1hhjvubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjvubj)}(hmappingh]hmapping}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjrubah}(h]h ]h"]h$]h&]jjuh1j7hj9hhhjKhMcubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj5hhhjKhMcubah}(h]j0ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjKhMchj2hhubj4)}(hhh]jM)}(h*wait for writeback without clearing errorsh]h*wait for writeback without clearing errors}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMchjhhubah}(h]h ]h"]h$]h&]uh1j3hj2hhhjKhMcubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjhNhNubj)}(hX**Parameters** ``struct address_space *mapping`` address space structure to wait for **Description** Walk the list of under-writeback pages of the given address space and wait for all of them. Unlike filemap_fdatawait(), this function does not clear error status of the address space. Use this function if callers don't handle errors themselves. Expected call sites are system-wide / filesystem-wide data flushers: e.g. sync(2), fsfreeze(8) **Return** error status of the address space.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMghjubj)}(hhh]j)}(hF``struct address_space *mapping`` address space structure to wait for h](j)}(h!``struct address_space *mapping``h]jS)}(hj>h]hstruct address_space *mapping}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj<ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMdhj8ubj)}(hhh]jM)}(h#address space structure to wait forh]h#address space structure to wait for}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjShMdhjTubah}(h]h ]h"]h$]h&]uh1jhj8ubeh}(h]h ]h"]h$]h&]uh1jhjShMdhj5ubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjyh]h Description}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjwubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMfhjubjM)}(hWalk the list of under-writeback pages of the given address space and wait for all of them. Unlike filemap_fdatawait(), this function does not clear error status of the address space.h]hWalk the list of under-writeback pages of the given address space and wait for all of them. Unlike filemap_fdatawait(), this function does not clear error status of the address space.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMehjubjM)}(hUse this function if callers don't handle errors themselves. Expected call sites are system-wide / filesystem-wide data flushers: e.g. sync(2), fsfreeze(8)h]hUse this function if callers don’t handle errors themselves. Expected call sites are system-wide / filesystem-wide data flushers: e.g. sync(2), fsfreeze(8)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMihjubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMmhjubjM)}(h"error status of the address space.h]h"error status of the address space.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMnhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h)filemap_write_and_wait_range (C function)c.filemap_write_and_wait_rangehNtauh1hhjhhhNhNubh)}(hhh](h)}(h\int filemap_write_and_wait_range (struct address_space *mapping, loff_t lstart, loff_t lend)h]h)}(h[int filemap_write_and_wait_range(struct address_space *mapping, loff_t lstart, loff_t lend)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh)}(hfilemap_write_and_wait_rangeh]j)}(hfilemap_write_and_wait_rangeh]hfilemap_write_and_wait_range}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMubj8)}(h;(struct address_space *mapping, loff_t lstart, loff_t lend)h](j>)}(hstruct address_space *mappingh](j)}(hjJ,h]hstruct}(hj1hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-ubj)}(h h]h }(hj>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-ubh)}(hhh]j)}(h address_spaceh]h address_space}(hjOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjLubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjQmodnameN classnameNjj)}j]j)}jjsbc.filemap_write_and_wait_rangeasbuh1hhj-ubj)}(h h]h }(hjohhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-ubjr)}(hjuh]h*}(hj}hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj-ubj)}(hmappingh]hmapping}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj)ubj>)}(h loff_t lstarth](h)}(hhh]j)}(hloff_th]hloff_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jkc.filemap_write_and_wait_rangeasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hlstarth]hlstart}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj)ubj>)}(h loff_t lendh](h)}(hhh]j)}(hloff_th]hloff_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jkc.filemap_write_and_wait_rangeasbuh1hhjubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hlendh]hlend}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj)ubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]jM)}(h write out & wait on a file rangeh]h write out & wait on a file range}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjAhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj\jHj\jIjJjKuh1hhhhjhNhNubj)}(hX**Parameters** ``struct address_space *mapping`` the address_space for the pages ``loff_t lstart`` offset in bytes where the range starts ``loff_t lend`` offset in bytes where the range ends (inclusive) **Description** Write out and wait upon file offsets lstart->lend, inclusive. Note that **lend** is inclusive (describes the last byte to be written) so that this function can be used to write to the very end-of-file (end = -1). **Return** error status of the address space.h](jM)}(h**Parameters**h]j)}(hjfh]h Parameters}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjdubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhj`ubj)}(hhh](j)}(hB``struct address_space *mapping`` the address_space for the pages h](j)}(h!``struct address_space *mapping``h]jS)}(hjh]hstruct address_space *mapping}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubj)}(hhh]jM)}(hthe address_space for the pagesh]hthe address_space for the pages}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhj|ubj)}(h9``loff_t lstart`` offset in bytes where the range starts h](j)}(h``loff_t lstart``h]jS)}(hjh]h loff_t lstart}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubj)}(hhh]jM)}(h&offset in bytes where the range startsh]h&offset in bytes where the range starts}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhj|ubj)}(hA``loff_t lend`` offset in bytes where the range ends (inclusive) h](j)}(h``loff_t lend``h]jS)}(hjh]h loff_t lend}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubj)}(hhh]jM)}(h0offset in bytes where the range ends (inclusive)h]h0offset in bytes where the range ends (inclusive)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj hMhj ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj hMhj|ubeh}(h]h ]h"]h$]h&]uh1jhj`ubjM)}(h**Description**h]j)}(hj2h]h Description}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj0ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhj`ubjM)}(h=Write out and wait upon file offsets lstart->lend, inclusive.h]h=Write out and wait upon file offsets lstart->lend, inclusive.}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhj`ubjM)}(hNote that **lend** is inclusive (describes the last byte to be written) so that this function can be used to write to the very end-of-file (end = -1).h](h Note that }(hjWhhhNhNubj)}(h**lend**h]hlend}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjWubh is inclusive (describes the last byte to be written) so that this function can be used to write to the very end-of-file (end = -1).}(hjWhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhj`ubjM)}(h **Return**h]j)}(hjzh]hReturn}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjxubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhj`ubjM)}(h"error status of the address space.h]h"error status of the address space.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhj`ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h*file_check_and_advance_wb_err (C function)c.file_check_and_advance_wb_errhNtauh1hhjhhhNhNubh)}(hhh](h)}(h5int file_check_and_advance_wb_err (struct file *file)h]h)}(h4int file_check_and_advance_wb_err(struct file *file)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh)}(hfile_check_and_advance_wb_errh]j)}(hfile_check_and_advance_wb_errh]hfile_check_and_advance_wb_err}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMubj8)}(h(struct file *file)h]j>)}(hstruct file *fileh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hfileh]hfile}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsbc.file_check_and_advance_wb_errasbuh1hhjubj)}(h h]h }(hj:hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjHhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hfileh]hfile}(hjUhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]jM)}(hNreport wb error (if any) that was previously and advance wb_err to current oneh]hNreport wb error (if any) that was previously and advance wb_err to current one}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhj|hhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjhNhNubj)}(hX**Parameters** ``struct file *file`` struct file on which the error is being reported **Description** When userland calls fsync (or something like nfsd does the equivalent), we want to report any writeback errors that occurred since the last fsync (or since the file was opened if there haven't been any). Grab the wb_err from the mapping. If it matches what we have in the file, then just quickly return 0. The file is all caught up. If it doesn't match, then take the mapping value, set the "seen" flag in it and try to swap it into place. If it works, or another task beat us to it with the new value, then update the f_wb_err and return the error portion. The error at this point must be reported via proper channels (a'la fsync, or NFS COMMIT operation, etc.). While we handle mapping->wb_err with atomic operations, the f_wb_err value is protected by the f_lock since we must ensure that it reflects the latest value swapped in for this file descriptor. **Return** ``0`` on success, negative error code otherwise.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubj)}(hhh]j)}(hG``struct file *file`` struct file on which the error is being reported h](j)}(h``struct file *file``h]jS)}(hjh]hstruct file *file}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubj)}(hhh]jM)}(h0struct file on which the error is being reportedh]h0struct file on which the error is being reported}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubjM)}(hWhen userland calls fsync (or something like nfsd does the equivalent), we want to report any writeback errors that occurred since the last fsync (or since the file was opened if there haven't been any).h]hWhen userland calls fsync (or something like nfsd does the equivalent), we want to report any writeback errors that occurred since the last fsync (or since the file was opened if there haven’t been any).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubjM)}(hGrab the wb_err from the mapping. If it matches what we have in the file, then just quickly return 0. The file is all caught up.h]hGrab the wb_err from the mapping. If it matches what we have in the file, then just quickly return 0. The file is all caught up.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubjM)}(hXJIf it doesn't match, then take the mapping value, set the "seen" flag in it and try to swap it into place. If it works, or another task beat us to it with the new value, then update the f_wb_err and return the error portion. The error at this point must be reported via proper channels (a'la fsync, or NFS COMMIT operation, etc.).h]hXRIf it doesn’t match, then take the mapping value, set the “seen” flag in it and try to swap it into place. If it works, or another task beat us to it with the new value, then update the f_wb_err and return the error portion. The error at this point must be reported via proper channels (a’la fsync, or NFS COMMIT operation, etc.).}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubjM)}(hWhile we handle mapping->wb_err with atomic operations, the f_wb_err value is protected by the f_lock since we must ensure that it reflects the latest value swapped in for this file descriptor.h]hWhile we handle mapping->wb_err with atomic operations, the f_wb_err value is protected by the f_lock since we must ensure that it reflects the latest value swapped in for this file descriptor.}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubjM)}(h **Return**h]j)}(hjOh]hReturn}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjMubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubjM)}(h0``0`` on success, negative error code otherwise.h](jS)}(h``0``h]h0}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjeubh+ on success, negative error code otherwise.}(hjehhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h&file_write_and_wait_range (C function)c.file_write_and_wait_rangehNtauh1hhjhhhNhNubh)}(hhh](h)}(hMint file_write_and_wait_range (struct file *file, loff_t lstart, loff_t lend)h]h)}(hLint file_write_and_wait_range(struct file *file, loff_t lstart, loff_t lend)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh)}(hfile_write_and_wait_rangeh]j)}(hfile_write_and_wait_rangeh]hfile_write_and_wait_range}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMubj8)}(h/(struct file *file, loff_t lstart, loff_t lend)h](j>)}(hstruct file *fileh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hfileh]hfile}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsbc.file_write_and_wait_rangeasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hj+hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hfileh]hfile}(hj8hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(h loff_t lstarth](h)}(hhh]j)}(hloff_th]hloff_t}(hjThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjQubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjVmodnameN classnameNjj)}j]jc.file_write_and_wait_rangeasbuh1hhjMubj)}(h h]h }(hjrhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjMubj)}(hlstarth]hlstart}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjMubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(h loff_t lendh](h)}(hhh]j)}(hloff_th]hloff_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.file_write_and_wait_rangeasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hlendh]hlend}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]jM)}(h write out & wait on a file rangeh]h write out & wait on a file range}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj jHj jIjJjKuh1hhhhjhNhNubj)}(hX**Parameters** ``struct file *file`` file pointing to address_space with pages ``loff_t lstart`` offset in bytes where the range starts ``loff_t lend`` offset in bytes where the range ends (inclusive) **Description** Write out and wait upon file offsets lstart->lend, inclusive. Note that **lend** is inclusive (describes the last byte to be written) so that this function can be used to write to the very end-of-file (end = -1). After writing out and waiting on the data, we check and advance the f_wb_err cursor to the latest value, and return any errors detected there. **Return** ``0`` on success, negative error code otherwise.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubj)}(hhh](j)}(h@``struct file *file`` file pointing to address_space with pages h](j)}(h``struct file *file``h]jS)}(hj3h]hstruct file *file}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj1ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhj-ubj)}(hhh]jM)}(h)file pointing to address_space with pagesh]h)file pointing to address_space with pages}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjHhMhjIubah}(h]h ]h"]h$]h&]uh1jhj-ubeh}(h]h ]h"]h$]h&]uh1jhjHhMhj*ubj)}(h9``loff_t lstart`` offset in bytes where the range starts h](j)}(h``loff_t lstart``h]jS)}(hjlh]h loff_t lstart}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjfubj)}(hhh]jM)}(h&offset in bytes where the range startsh]h&offset in bytes where the range starts}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjfubeh}(h]h ]h"]h$]h&]uh1jhjhMhj*ubj)}(hA``loff_t lend`` offset in bytes where the range ends (inclusive) h](j)}(h``loff_t lend``h]jS)}(hjh]h loff_t lend}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubj)}(hhh]jM)}(h0offset in bytes where the range ends (inclusive)h]h0offset in bytes where the range ends (inclusive)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhj*ubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubjM)}(h=Write out and wait upon file offsets lstart->lend, inclusive.h]h=Write out and wait upon file offsets lstart->lend, inclusive.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubjM)}(hNote that **lend** is inclusive (describes the last byte to be written) so that this function can be used to write to the very end-of-file (end = -1).h](h Note that }(hjhhhNhNubj)}(h**lend**h]hlend}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh is inclusive (describes the last byte to be written) so that this function can be used to write to the very end-of-file (end = -1).}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubjM)}(hAfter writing out and waiting on the data, we check and advance the f_wb_err cursor to the latest value, and return any errors detected there.h]hAfter writing out and waiting on the data, we check and advance the f_wb_err cursor to the latest value, and return any errors detected there.}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubjM)}(h **Return**h]j)}(hj7h]hReturn}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj5ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubjM)}(h0``0`` on success, negative error code otherwise.h](jS)}(h``0``h]h0}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjMubh+ on success, negative error code otherwise.}(hjMhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h%replace_page_cache_folio (C function)c.replace_page_cache_foliohNtauh1hhjhhhNhNubh)}(hhh](h)}(hDvoid replace_page_cache_folio (struct folio *old, struct folio *new)h]h)}(hCvoid replace_page_cache_folio(struct folio *old, struct folio *new)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh)}(hreplace_page_cache_folioh]j)}(hreplace_page_cache_folioh]hreplace_page_cache_folio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMubj8)}(h&(struct folio *old, struct folio *new)h](j>)}(hstruct folio *oldh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsbc.replace_page_cache_folioasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(holdh]hold}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hstruct folio *newh](j)}(hjJ,h]hstruct}(hj9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5ubj)}(h h]h }(hjFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5ubh)}(hhh]j)}(hfolioh]hfolio}(hjWhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjTubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjYmodnameN classnameNjj)}j]jc.replace_page_cache_folioasbuh1hhj5ubj)}(h h]h }(hjuhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5ubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj5ubj)}(hnewh]hnew}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]j}ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]jM)}(h(replace a pagecache folio with a new oneh]h(replace a pagecache folio with a new one}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjhNhNubj)}(hX**Parameters** ``struct folio *old`` folio to be replaced ``struct folio *new`` folio to replace with **Description** This function replaces a folio in the pagecache with a new one. On success it acquires the pagecache reference for the new folio and drops it for the old folio. Both the old and new folios must be locked. This function does not add the new folio to the LRU, the caller must do that. The remove + add is atomic. This function cannot fail.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM#hjubj)}(hhh](j)}(h+``struct folio *old`` folio to be replaced h](j)}(h``struct folio *old``h]jS)}(hjh]hstruct folio *old}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM hjubj)}(hhh]jM)}(hfolio to be replacedh]hfolio to be replaced}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hjubj)}(h,``struct folio *new`` folio to replace with h](j)}(h``struct folio *new``h]jS)}(hj4h]hstruct folio *new}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj2ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM!hj.ubj)}(hhh]jM)}(hfolio to replace withh]hfolio to replace with}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjIhM!hjJubah}(h]h ]h"]h$]h&]uh1jhj.ubeh}(h]h ]h"]h$]h&]uh1jhjIhM!hjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjoh]h Description}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjmubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM#hjubjM)}(hXThis function replaces a folio in the pagecache with a new one. On success it acquires the pagecache reference for the new folio and drops it for the old folio. Both the old and new folios must be locked. This function does not add the new folio to the LRU, the caller must do that.h]hXThis function replaces a folio in the pagecache with a new one. On success it acquires the pagecache reference for the new folio and drops it for the old folio. Both the old and new folios must be locked. This function does not add the new folio to the LRU, the caller must do that.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM"hjubjM)}(h7The remove + add is atomic. This function cannot fail.h]h7The remove + add is atomic. This function cannot fail.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM(hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfolio_unlock (C function)c.folio_unlockhNtauh1hhjhhhNhNubh)}(hhh](h)}(h'void folio_unlock (struct folio *folio)h]h)}(h&void folio_unlock(struct folio *folio)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh)}(h folio_unlockh]j)}(h folio_unlockh]h folio_unlock}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMubj8)}(h(struct folio *folio)h]j>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj modnameN classnameNjj)}j]j)}jjsbc.folio_unlockasbuh1hhjubj)}(h h]h }(hj>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjLhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hfolioh]hfolio}(hjYhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]jM)}(hUnlock a locked folio.h]hUnlock a locked folio.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjhNhNubj)}(h**Parameters** ``struct folio *folio`` The folio. **Description** Unlocks the folio and wakes up any thread sleeping on the page lock. **Context** May be called from interrupt or process context. May not be called from NMI context.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubj)}(hhh]j)}(h#``struct folio *folio`` The folio. h](j)}(h``struct folio *folio``h]jS)}(hjh]hstruct folio *folio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubj)}(hhh]jM)}(h The folio.h]h The folio.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubjM)}(hDUnlocks the folio and wakes up any thread sleeping on the page lock.h]hDUnlocks the folio and wakes up any thread sleeping on the page lock.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubjM)}(h **Context**h]j)}(hj&h]hContext}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj$ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubjM)}(hUMay be called from interrupt or process context. May not be called from NMI context.h]hUMay be called from interrupt or process context. May not be called from NMI context.}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfolio_end_read (C function)c.folio_end_readhNtauh1hhjhhhNhNubh)}(hhh](h)}(h7void folio_end_read (struct folio *folio, bool success)h]h)}(h6void folio_end_read(struct folio *folio, bool success)h](j)}(hvoidh]hvoid}(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjghhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMubj)}(h h]h }(hjzhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjghhhjyhMubh)}(hfolio_end_readh]j)}(hfolio_end_readh]hfolio_end_read}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjghhhjyhMubj8)}(h#(struct folio *folio, bool success)h](j>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsbc.folio_end_readasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(h bool successh](j)}(hjh]hbool}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hsuccessh]hsuccess}(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjghhhjyhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjchhhjyhMubah}(h]j^ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjyhMhj`hhubj4)}(hhh]jM)}(hEnd read on a folio.h]hEnd read on a folio.}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhj\hhubah}(h]h ]h"]h$]h&]uh1j3hj`hhhjyhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjwjHjwjIjJjKuh1hhhhjhNhNubj)}(hX**Parameters** ``struct folio *folio`` The folio. ``bool success`` True if all reads completed successfully. **Description** When all reads against a folio have completed, filesystems should call this function to let the pagecache know that no more reads are outstanding. This will unlock the folio and wake up any thread sleeping on the lock. The folio will also be marked uptodate if all reads succeeded. **Context** May be called from interrupt or process context. May not be called from NMI context.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhj{ubj)}(hhh](j)}(h#``struct folio *folio`` The folio. h](j)}(h``struct folio *folio``h]jS)}(hjh]hstruct folio *folio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubj)}(hhh]jM)}(h The folio.h]h The folio.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h;``bool success`` True if all reads completed successfully. h](j)}(h``bool success``h]jS)}(hjh]h bool success}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubj)}(hhh]jM)}(h)True if all reads completed successfully.h]h)True if all reads completed successfully.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubeh}(h]h ]h"]h$]h&]uh1jhj{ubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhj{ubjM)}(hXWhen all reads against a folio have completed, filesystems should call this function to let the pagecache know that no more reads are outstanding. This will unlock the folio and wake up any thread sleeping on the lock. The folio will also be marked uptodate if all reads succeeded.h]hXWhen all reads against a folio have completed, filesystems should call this function to let the pagecache know that no more reads are outstanding. This will unlock the folio and wake up any thread sleeping on the lock. The folio will also be marked uptodate if all reads succeeded.}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhj{ubjM)}(h **Context**h]j)}(hj;h]hContext}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj9ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhj{ubjM)}(hUMay be called from interrupt or process context. May not be called from NMI context.h]hUMay be called from interrupt or process context. May not be called from NMI context.}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhj{ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h folio_end_private_2 (C function)c.folio_end_private_2hNtauh1hhjhhhNhNubh)}(hhh](h)}(h.void folio_end_private_2 (struct folio *folio)h]h)}(h-void folio_end_private_2(struct folio *folio)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|hhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|hhhjhMubh)}(hfolio_end_private_2h]j)}(hfolio_end_private_2h]hfolio_end_private_2}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhj|hhhjhMubj8)}(h(struct folio *folio)h]j>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsbc.folio_end_private_2asbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hj hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hj|hhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjxhhhjhMubah}(h]jsah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjuhhubj4)}(hhh]jM)}(h(Clear PG_private_2 and wake any waiters.h]h(Clear PG_private_2 and wake any waiters.}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhj=hhubah}(h]h ]h"]h$]h&]uh1j3hjuhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjXjHjXjIjJjKuh1hhhhjhNhNubj)}(hXx**Parameters** ``struct folio *folio`` The folio. **Description** Clear the PG_private_2 bit on a folio and wake up any sleepers waiting for it. The folio reference held for PG_private_2 being set is released. This is, for example, used when a netfs folio is being written to a local disk cache, thereby allowing writes to the cache for the same folio to be serialised.h](jM)}(h**Parameters**h]j)}(hjbh]h Parameters}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj`ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhj\ubj)}(hhh]j)}(h#``struct folio *folio`` The folio. h](j)}(h``struct folio *folio``h]jS)}(hjh]hstruct folio *folio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhj{ubj)}(hhh]jM)}(h The folio.h]h The folio.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhj{ubeh}(h]h ]h"]h$]h&]uh1jhjhMhjxubah}(h]h ]h"]h$]h&]uh1jhj\ubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhj\ubjM)}(hClear the PG_private_2 bit on a folio and wake up any sleepers waiting for it. The folio reference held for PG_private_2 being set is released.h]hClear the PG_private_2 bit on a folio and wake up any sleepers waiting for it. The folio reference held for PG_private_2 being set is released.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhj\ubjM)}(hThis is, for example, used when a netfs folio is being written to a local disk cache, thereby allowing writes to the cache for the same folio to be serialised.h]hThis is, for example, used when a netfs folio is being written to a local disk cache, thereby allowing writes to the cache for the same folio to be serialised.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhj\ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h!folio_wait_private_2 (C function)c.folio_wait_private_2hNtauh1hhjhhhNhNubh)}(hhh](h)}(h/void folio_wait_private_2 (struct folio *folio)h]h)}(h.void folio_wait_private_2(struct folio *folio)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM#ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhjhM#ubh)}(hfolio_wait_private_2h]j)}(hfolio_wait_private_2h]hfolio_wait_private_2}(hj1hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj hhhjhM#ubj8)}(h(struct folio *folio)h]j>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hjMhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIubj)}(h h]h }(hjZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIubh)}(hhh]j)}(hfolioh]hfolio}(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmmodnameN classnameNjj)}j]j)}jj3sbc.folio_wait_private_2asbuh1hhjIubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjIubj)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjEubah}(h]h ]h"]h$]h&]jjuh1j7hj hhhjhM#ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhM#ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhM#hjhhubj4)}(hhh]jM)}(h/Wait for PG_private_2 to be cleared on a folio.h]h/Wait for PG_private_2 to be cleared on a folio.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM#hjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhM#ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjhNhNubj)}(h**Parameters** ``struct folio *folio`` The folio to wait on. **Description** Wait for PG_private_2 to be cleared on a folio.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM'hjubj)}(hhh]j)}(h.``struct folio *folio`` The folio to wait on. h](j)}(h``struct folio *folio``h]jS)}(hjh]hstruct folio *folio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM$hj ubj)}(hhh]jM)}(hThe folio to wait on.h]hThe folio to wait on.}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj&hM$hj'ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj&hM$hjubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjLh]h Description}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjJubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM&hjubjM)}(h/Wait for PG_private_2 to be cleared on a folio.h]h/Wait for PG_private_2 to be cleared on a folio.}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM%hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h*folio_wait_private_2_killable (C function)c.folio_wait_private_2_killablehNtauh1hhjhhhNhNubh)}(hhh](h)}(h7int folio_wait_private_2_killable (struct folio *folio)h]h)}(h6int folio_wait_private_2_killable(struct folio *folio)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM0ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM0ubh)}(hfolio_wait_private_2_killableh]j)}(hfolio_wait_private_2_killableh]hfolio_wait_private_2_killable}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhM0ubj8)}(h(struct folio *folio)h]j>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsbc.folio_wait_private_2_killableasbuh1hhjubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hfolioh]hfolio}(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhM0ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhM0ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhM0hjhhubj4)}(hhh]jM)}(h/Wait for PG_private_2 to be cleared on a folio.h]h/Wait for PG_private_2 to be cleared on a folio.}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM0hjNhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhM0ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjijHjijIjJjKuh1hhhhjhNhNubj)}(hX**Parameters** ``struct folio *folio`` The folio to wait on. **Description** Wait for PG_private_2 to be cleared on a folio or until a fatal signal is received by the calling task. **Return** - 0 if successful. - -EINTR if a fatal signal was encountered.h](jM)}(h**Parameters**h]j)}(hjsh]h Parameters}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjqubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM4hjmubj)}(hhh]j)}(h.``struct folio *folio`` The folio to wait on. h](j)}(h``struct folio *folio``h]jS)}(hjh]hstruct folio *folio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM1hjubj)}(hhh]jM)}(hThe folio to wait on.h]hThe folio to wait on.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM1hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM1hjubah}(h]h ]h"]h$]h&]uh1jhjmubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM3hjmubjM)}(hgWait for PG_private_2 to be cleared on a folio or until a fatal signal is received by the calling task.h]hgWait for PG_private_2 to be cleared on a folio or until a fatal signal is received by the calling task.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM2hjmubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM5hjmubj^)}(hhh](jc)}(h0 if successful.h]jM)}(hjh]h0 if successful.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM6hj ubah}(h]h ]h"]h$]h&]uh1jbhj ubjc)}(h)-EINTR if a fatal signal was encountered.h]jM)}(hj'h]h)-EINTR if a fatal signal was encountered.}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM7hj%ubah}(h]h ]h"]h$]h&]uh1jbhj ubeh}(h]h ]h"]h$]h&]jjuh1j]hjhM6hjmubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h.folio_end_writeback_no_dropbehind (C function)#c.folio_end_writeback_no_dropbehindhNtauh1hhjhhhNhNubh)}(hhh](h)}(h)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsb#c.folio_end_writeback_no_dropbehindasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hj_hhhjqhMoubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj[hhhjqhMoubah}(h]jVah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjqhMohjXhhubj4)}(hhh]jM)}(hEnd writeback against a folio.h]hEnd writeback against a folio.}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMohj hhubah}(h]h ]h"]h$]h&]uh1j3hjXhhhjqhMoubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj;jHj;jIjJjKuh1hhhhjhNhNubj)}(h**Parameters** ``struct folio *folio`` The folio. **Description** The folio must actually be under writeback. This call is intended for filesystems that need to defer dropbehind. **Context** May be called from process or interrupt context.h](jM)}(h**Parameters**h]j)}(hjEh]h Parameters}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjCubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMshj?ubj)}(hhh]j)}(h#``struct folio *folio`` The folio. h](j)}(h``struct folio *folio``h]jS)}(hjdh]hstruct folio *folio}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjbubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMphj^ubj)}(hhh]jM)}(h The folio.h]h The folio.}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjyhMphjzubah}(h]h ]h"]h$]h&]uh1jhj^ubeh}(h]h ]h"]h$]h&]uh1jhjyhMphj[ubah}(h]h ]h"]h$]h&]uh1jhj?ubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMrhj?ubjM)}(hpThe folio must actually be under writeback. This call is intended for filesystems that need to defer dropbehind.h]hpThe folio must actually be under writeback. This call is intended for filesystems that need to defer dropbehind.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMqhj?ubjM)}(h **Context**h]j)}(hjh]hContext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMthj?ubjM)}(h0May be called from process or interrupt context.h]h0May be called from process or interrupt context.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMuhj?ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h folio_end_writeback (C function)c.folio_end_writebackhNtauh1hhjhhhNhNubh)}(hhh](h)}(h.void folio_end_writeback (struct folio *folio)h]h)}(h-void folio_end_writeback(struct folio *folio)h](j)}(hvoidh]hvoid}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh)}(hfolio_end_writebackh]j)}(hfolio_end_writebackh]hfolio_end_writeback}(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMubj8)}(h(struct folio *folio)h]j>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hjHhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjDubj)}(h h]h }(hjUhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjDubh)}(hhh]j)}(hfolioh]hfolio}(hjfhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjcubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjhmodnameN classnameNjj)}j]j)}jj.sbc.folio_end_writebackasbuh1hhjDubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjDubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjDubj)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjDubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj@ubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]jM)}(hEnd writeback against a folio.h]hEnd writeback against a folio.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjhNhNubj)}(h**Parameters** ``struct folio *folio`` The folio. **Description** The folio must actually be under writeback. **Context** May be called from process or interrupt context.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubj)}(hhh]j)}(h#``struct folio *folio`` The folio. h](j)}(h``struct folio *folio``h]jS)}(hj h]hstruct folio *folio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubj)}(hhh]jM)}(h The folio.h]h The folio.}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj!hMhj"ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj!hMhjubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjGh]h Description}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjEubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubjM)}(h+The folio must actually be under writeback.h]h+The folio must actually be under writeback.}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubjM)}(h **Context**h]j)}(hjnh]hContext}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1jhjlubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubjM)}(h0May be called from process or interrupt context.h]h0May be called from process or interrupt context.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h__folio_lock (C function)c.__folio_lockhNtauh1hhjhhhNhNubh)}(hhh](h)}(h'void __folio_lock (struct folio *folio)h]h)}(h&void __folio_lock(struct folio *folio)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh)}(h __folio_lockh]j)}(h __folio_lockh]h __folio_lock}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMubj8)}(h(struct folio *folio)h]j>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsbc.__folio_lockasbuh1hhjubj)}(h h]h }(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hj<hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hfolioh]hfolio}(hjIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]jM)}(h=Get a lock on the folio, assuming we need to sleep to get it.h]h=Get a lock on the folio, assuming we need to sleep to get it.}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjphhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjhNhNubj)}(h;**Parameters** ``struct folio *folio`` The folio to lockh](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubj)}(hhh]j)}(h)``struct folio *folio`` The folio to lockh](j)}(h``struct folio *folio``h]jS)}(hjh]hstruct folio *folio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubj)}(hhh]jM)}(hThe folio to lockh]hThe folio to lock}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h!page_cache_next_miss (C function)c.page_cache_next_misshNtauh1hhjhhhNhNubh)}(hhh](h)}(hcpgoff_t page_cache_next_miss (struct address_space *mapping, pgoff_t index, unsigned long max_scan)h]h)}(hbpgoff_t page_cache_next_miss(struct address_space *mapping, pgoff_t index, unsigned long max_scan)h](h)}(hhh]j)}(hpgoff_th]hpgoff_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jpage_cache_next_misssbc.page_cache_next_missasbuh1hhj hhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMubj)}(h h]h }(hj3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhj2hMubh)}(hpage_cache_next_missh]j)}(hj/h]hpage_cache_next_miss}(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjAubah}(h]h ](jjeh"]h$]h&]jjuh1hhj hhhj2hMubj8)}(hF(struct address_space *mapping, pgoff_t index, unsigned long max_scan)h](j>)}(hstruct address_space *mappingh](j)}(hjJ,h]hstruct}(hj`hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\ubj)}(h h]h }(hjmhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\ubh)}(hhh]j)}(h address_spaceh]h address_space}(hj~hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j-c.page_cache_next_missasbuh1hhj\ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\ubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj\ubj)}(hmappingh]hmapping}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjXubj>)}(h pgoff_t indexh](h)}(hhh]j)}(hpgoff_th]hpgoff_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j-c.page_cache_next_missasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hindexh]hindex}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjXubj>)}(hunsigned long max_scanh](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hlongh]hlong}(hj4hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hmax_scanh]hmax_scan}(hjPhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjXubeh}(h]h ]h"]h$]h&]jjuh1j7hj hhhj2hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhj2hMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj2hMhjhhubj4)}(hhh]jM)}(h$Find the next gap in the page cache.h]h$Find the next gap in the page cache.}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjwhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhj2hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjhNhNubj)}(hX **Parameters** ``struct address_space *mapping`` Mapping. ``pgoff_t index`` Index. ``unsigned long max_scan`` Maximum range to search. **Description** Search the range [index, min(index + max_scan - 1, ULONG_MAX)] for the gap with the lowest index. This function may be called under the rcu_read_lock. However, this will not atomically search a snapshot of the cache at a single point in time. For example, if a gap is created at index 5, then subsequently a gap is created at index 10, page_cache_next_miss covering both indices may return 10 if called under the rcu_read_lock. **Return** The index of the gap if found, otherwise an index outside the range specified (in which case 'return - index >= max_scan' will be true). In the rare case of index wrap-around, 0 will be returned.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubj)}(hhh](j)}(h+``struct address_space *mapping`` Mapping. h](j)}(h!``struct address_space *mapping``h]jS)}(hjh]hstruct address_space *mapping}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubj)}(hhh]jM)}(hMapping.h]hMapping.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h``pgoff_t index`` Index. h](j)}(h``pgoff_t index``h]jS)}(hjh]h pgoff_t index}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubj)}(hhh]jM)}(hIndex.h]hIndex.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj hMhj ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj hMhjubj)}(h4``unsigned long max_scan`` Maximum range to search. h](j)}(h``unsigned long max_scan``h]jS)}(hj-h]hunsigned long max_scan}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj+ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhj'ubj)}(hhh]jM)}(hMaximum range to search.h]hMaximum range to search.}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjBhMhjCubah}(h]h ]h"]h$]h&]uh1jhj'ubeh}(h]h ]h"]h$]h&]uh1jhjBhMhjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjhh]h Description}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjfubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubjM)}(haSearch the range [index, min(index + max_scan - 1, ULONG_MAX)] for the gap with the lowest index.h]haSearch the range [index, min(index + max_scan - 1, ULONG_MAX)] for the gap with the lowest index.}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubjM)}(hXJThis function may be called under the rcu_read_lock. However, this will not atomically search a snapshot of the cache at a single point in time. For example, if a gap is created at index 5, then subsequently a gap is created at index 10, page_cache_next_miss covering both indices may return 10 if called under the rcu_read_lock.h]hXJThis function may be called under the rcu_read_lock. However, this will not atomically search a snapshot of the cache at a single point in time. For example, if a gap is created at index 5, then subsequently a gap is created at index 10, page_cache_next_miss covering both indices may return 10 if called under the rcu_read_lock.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM!hjubjM)}(hThe index of the gap if found, otherwise an index outside the range specified (in which case 'return - index >= max_scan' will be true). In the rare case of index wrap-around, 0 will be returned.h]hThe index of the gap if found, otherwise an index outside the range specified (in which case ‘return - index >= max_scan’ will be true). In the rare case of index wrap-around, 0 will be returned.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM"hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h!page_cache_prev_miss (C function)c.page_cache_prev_misshNtauh1hhjhhhNhNubh)}(hhh](h)}(hcpgoff_t page_cache_prev_miss (struct address_space *mapping, pgoff_t index, unsigned long max_scan)h]h)}(hbpgoff_t page_cache_prev_miss(struct address_space *mapping, pgoff_t index, unsigned long max_scan)h](h)}(hhh]j)}(hpgoff_th]hpgoff_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jpage_cache_prev_misssbc.page_cache_prev_missasbuh1hhjhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM9ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM9ubh)}(hpage_cache_prev_missh]j)}(hjh]hpage_cache_prev_miss}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhM9ubj8)}(hF(struct address_space *mapping, pgoff_t index, unsigned long max_scan)h](j>)}(hstruct address_space *mappingh](j)}(hjJ,h]hstruct}(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj1ubj)}(h h]h }(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj1ubh)}(hhh]j)}(h address_spaceh]h address_space}(hjShhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjPubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjUmodnameN classnameNjj)}j]jc.page_cache_prev_missasbuh1hhj1ubj)}(h h]h }(hjqhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj1ubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj1ubj)}(hmappingh]hmapping}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj1ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj-ubj>)}(h pgoff_t indexh](h)}(hhh]j)}(hpgoff_th]hpgoff_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.page_cache_prev_missasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hindexh]hindex}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj-ubj>)}(hunsigned long max_scanh](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hlongh]hlong}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hmax_scanh]hmax_scan}(hj%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj-ubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhM9ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhM9ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhM9hjhhubj4)}(hhh]jM)}(h(Find the previous gap in the page cache.h]h(Find the previous gap in the page cache.}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM9hjLhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhM9ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjgjHjgjIjJjKuh1hhhhjhNhNubj)}(hX**Parameters** ``struct address_space *mapping`` Mapping. ``pgoff_t index`` Index. ``unsigned long max_scan`` Maximum range to search. **Description** Search the range [max(index - max_scan + 1, 0), index] for the gap with the highest index. This function may be called under the rcu_read_lock. However, this will not atomically search a snapshot of the cache at a single point in time. For example, if a gap is created at index 10, then subsequently a gap is created at index 5, page_cache_prev_miss() covering both indices may return 5 if called under the rcu_read_lock. **Return** The index of the gap if found, otherwise an index outside the range specified (in which case 'index - return >= max_scan' will be true). In the rare case of wrap-around, ULONG_MAX will be returned.h](jM)}(h**Parameters**h]j)}(hjqh]h Parameters}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1jhjoubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM=hjkubj)}(hhh](j)}(h+``struct address_space *mapping`` Mapping. h](j)}(h!``struct address_space *mapping``h]jS)}(hjh]hstruct address_space *mapping}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM:hjubj)}(hhh]jM)}(hMapping.h]hMapping.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM:hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM:hjubj)}(h``pgoff_t index`` Index. h](j)}(h``pgoff_t index``h]jS)}(hjh]h pgoff_t index}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM;hjubj)}(hhh]jM)}(hIndex.h]hIndex.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM;hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM;hjubj)}(h4``unsigned long max_scan`` Maximum range to search. h](j)}(h``unsigned long max_scan``h]jS)}(hjh]hunsigned long max_scan}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM<hjubj)}(hhh]jM)}(hMaximum range to search.h]hMaximum range to search.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM<hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM<hjubeh}(h]h ]h"]h$]h&]uh1jhjkubjM)}(h**Description**h]j)}(hj=h]h Description}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj;ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM>hjkubjM)}(hZSearch the range [max(index - max_scan + 1, 0), index] for the gap with the highest index.h]hZSearch the range [max(index - max_scan + 1, 0), index] for the gap with the highest index.}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM=hjkubjM)}(hXKThis function may be called under the rcu_read_lock. However, this will not atomically search a snapshot of the cache at a single point in time. For example, if a gap is created at index 10, then subsequently a gap is created at index 5, page_cache_prev_miss() covering both indices may return 5 if called under the rcu_read_lock.h]hXKThis function may be called under the rcu_read_lock. However, this will not atomically search a snapshot of the cache at a single point in time. For example, if a gap is created at index 10, then subsequently a gap is created at index 5, page_cache_prev_miss() covering both indices may return 5 if called under the rcu_read_lock.}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM@hjkubjM)}(h **Return**h]j)}(hjsh]hReturn}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjqubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMFhjkubjM)}(hThe index of the gap if found, otherwise an index outside the range specified (in which case 'index - return >= max_scan' will be true). In the rare case of wrap-around, ULONG_MAX will be returned.h]hThe index of the gap if found, otherwise an index outside the range specified (in which case ‘index - return >= max_scan’ will be true). In the rare case of wrap-around, ULONG_MAX will be returned.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMGhjkubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h%__filemap_get_folio_mpol (C function)c.__filemap_get_folio_mpolhNtauh1hhjhhhNhNubh)}(hhh](h)}(hstruct folio * __filemap_get_folio_mpol (struct address_space *mapping, pgoff_t index, fgf_t fgp_flags, gfp_t gfp, struct mempolicy *policy)h]h)}(hstruct folio *__filemap_get_folio_mpol(struct address_space *mapping, pgoff_t index, fgf_t fgp_flags, gfp_t gfp, struct mempolicy *policy)h](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh)}(hhh]j)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}j__filemap_get_folio_mpolsbc.__filemap_get_folio_mpolasbuh1hhjhhhjhMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjhhhjhMubh)}(h__filemap_get_folio_mpolh]j)}(hjh]h__filemap_get_folio_mpol}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMubj8)}(hd(struct address_space *mapping, pgoff_t index, fgf_t fgp_flags, gfp_t gfp, struct mempolicy *policy)h](j>)}(hstruct address_space *mappingh](j)}(hjJ,h]hstruct}(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj.ubj)}(h h]h }(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj.ubh)}(hhh]j)}(h address_spaceh]h address_space}(hjPhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjMubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjRmodnameN classnameNjj)}j]jc.__filemap_get_folio_mpolasbuh1hhj.ubj)}(h h]h }(hjnhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj.ubjr)}(hjuh]h*}(hj|hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj.ubj)}(hmappingh]hmapping}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj.ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj*ubj>)}(h pgoff_t indexh](h)}(hhh]j)}(hpgoff_th]hpgoff_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.__filemap_get_folio_mpolasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hindexh]hindex}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj*ubj>)}(hfgf_t fgp_flagsh](h)}(hhh]j)}(hfgf_th]hfgf_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.__filemap_get_folio_mpolasbuh1hhjubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h fgp_flagsh]h fgp_flags}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj*ubj>)}(h gfp_t gfph](h)}(hhh]j)}(hgfp_th]hgfp_t}(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj7modnameN classnameNjj)}j]jc.__filemap_get_folio_mpolasbuh1hhj.ubj)}(h h]h }(hjShhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj.ubj)}(hgfph]hgfp}(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj.ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj*ubj>)}(hstruct mempolicy *policyh](j)}(hjJ,h]hstruct}(hjzhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvubh)}(hhh]j)}(h mempolicyh]h mempolicy}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.__filemap_get_folio_mpolasbuh1hhjvubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjvubj)}(hpolicyh]hpolicy}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj*ubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]jM)}(h$Find and get a reference to a folio.h]h$Find and get a reference to a folio.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjhNhNubj)}(hX**Parameters** ``struct address_space *mapping`` The address_space to search. ``pgoff_t index`` The page index. ``fgf_t fgp_flags`` ``FGP`` flags modify how the folio is returned. ``gfp_t gfp`` Memory allocation flags to use if ``FGP_CREAT`` is specified. ``struct mempolicy *policy`` NUMA memory allocation policy to follow. **Description** Looks up the page cache entry at **mapping** & **index**. If ``FGP_LOCK`` or ``FGP_CREAT`` are specified then the function may sleep even if the ``GFP`` flags specified for ``FGP_CREAT`` are atomic. If this function returns a folio, it is returned with an increased refcount. **Return** The found folio or an ERR_PTR() otherwise.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubj)}(hhh](j)}(h?``struct address_space *mapping`` The address_space to search. h](j)}(h!``struct address_space *mapping``h]jS)}(hj<h]hstruct address_space *mapping}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj:ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhj6ubj)}(hhh]jM)}(hThe address_space to search.h]hThe address_space to search.}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjQhMhjRubah}(h]h ]h"]h$]h&]uh1jhj6ubeh}(h]h ]h"]h$]h&]uh1jhjQhMhj3ubj)}(h"``pgoff_t index`` The page index. h](j)}(h``pgoff_t index``h]jS)}(hjuh]h pgoff_t index}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjsubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjoubj)}(hhh]jM)}(hThe page index.h]hThe page index.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjoubeh}(h]h ]h"]h$]h&]uh1jhjhMhj3ubj)}(hD``fgf_t fgp_flags`` ``FGP`` flags modify how the folio is returned. h](j)}(h``fgf_t fgp_flags``h]jS)}(hjh]hfgf_t fgp_flags}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubj)}(hhh]jM)}(h/``FGP`` flags modify how the folio is returned.h](jS)}(h``FGP``h]hFGP}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubh( flags modify how the folio is returned.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhj3ubj)}(hL``gfp_t gfp`` Memory allocation flags to use if ``FGP_CREAT`` is specified. h](j)}(h ``gfp_t gfp``h]jS)}(hjh]h gfp_t gfp}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubj)}(hhh]jM)}(h=Memory allocation flags to use if ``FGP_CREAT`` is specified.h](h"Memory allocation flags to use if }(hjhhhNhNubjS)}(h ``FGP_CREAT``h]h FGP_CREAT}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubh is specified.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhj hMhj ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj hMhj3ubj)}(hF``struct mempolicy *policy`` NUMA memory allocation policy to follow. h](j)}(h``struct mempolicy *policy``h]jS)}(hj@h]hstruct mempolicy *policy}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj>ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhj:ubj)}(hhh]jM)}(h(NUMA memory allocation policy to follow.h]h(NUMA memory allocation policy to follow.}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjUhMhjVubah}(h]h ]h"]h$]h&]uh1jhj:ubeh}(h]h ]h"]h$]h&]uh1jhjUhMhj3ubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hj{h]h Description}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjyubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubjM)}(h9Looks up the page cache entry at **mapping** & **index**.h](h!Looks up the page cache entry at }(hjhhhNhNubj)}(h **mapping**h]hmapping}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh & }(hjhhhNhNubj)}(h **index**h]hindex}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubjM)}(hIf ``FGP_LOCK`` or ``FGP_CREAT`` are specified then the function may sleep even if the ``GFP`` flags specified for ``FGP_CREAT`` are atomic.h](hIf }(hjhhhNhNubjS)}(h ``FGP_LOCK``h]hFGP_LOCK}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubh or }(hjhhhNhNubjS)}(h ``FGP_CREAT``h]h FGP_CREAT}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubh7 are specified then the function may sleep even if the }(hjhhhNhNubjS)}(h``GFP``h]hGFP}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubh flags specified for }(hjhhhNhNubjS)}(h ``FGP_CREAT``h]h FGP_CREAT}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubh are atomic.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubjM)}(hLIf this function returns a folio, it is returned with an increased refcount.h]hLIf this function returns a folio, it is returned with an increased refcount.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubjM)}(h **Return**h]j)}(hj,h]hReturn}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj*ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubjM)}(h*The found folio or an ERR_PTR() otherwise.h]h*The found folio or an ERR_PTR() otherwise.}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfilemap_get_folios (C function)c.filemap_get_folioshNtauh1hhjhhhNhNubh)}(hhh](h)}(htunsigned filemap_get_folios (struct address_space *mapping, pgoff_t *start, pgoff_t end, struct folio_batch *fbatch)h]h)}(hsunsigned filemap_get_folios(struct address_space *mapping, pgoff_t *start, pgoff_t end, struct folio_batch *fbatch)h](j)}(hunsignedh]hunsigned}(hjqhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmhhhjhMubh)}(hfilemap_get_foliosh]j)}(hfilemap_get_foliosh]hfilemap_get_folios}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjmhhhjhMubj8)}(hX(struct address_space *mapping, pgoff_t *start, pgoff_t end, struct folio_batch *fbatch)h](j>)}(hstruct address_space *mappingh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(h address_spaceh]h address_space}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsbc.filemap_get_foliosasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hmappingh]hmapping}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hpgoff_t *starth](h)}(hhh]j)}(hpgoff_th]hpgoff_t}(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj%modnameN classnameNjj)}j]jc.filemap_get_foliosasbuh1hhjubj)}(h h]h }(hjAhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjOhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hstarth]hstart}(hj\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(h pgoff_t endh](h)}(hhh]j)}(hpgoff_th]hpgoff_t}(hjxhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjuubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjzmodnameN classnameNjj)}j]jc.filemap_get_foliosasbuh1hhjqubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjqubj)}(hendh]hend}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjqubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hstruct folio_batch *fbatchh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(h folio_batchh]h folio_batch}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.filemap_get_foliosasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hfbatchh]hfbatch}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjmhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjihhhjhMubah}(h]jdah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjfhhubj4)}(hhh]jM)}(hGet a batch of foliosh]hGet a batch of folios}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhj;hhubah}(h]h ]h"]h$]h&]uh1j3hjfhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjVjHjVjIjJjKuh1hhhhjhNhNubj)}(hX1**Parameters** ``struct address_space *mapping`` The address_space to search ``pgoff_t *start`` The starting page index ``pgoff_t end`` The final page index (inclusive) ``struct folio_batch *fbatch`` The batch to fill. **Description** Search for and return a batch of folios in the mapping starting at index **start** and up to index **end** (inclusive). The folios are returned in **fbatch** with an elevated reference count. **Return** The number of folios which were found. We also update **start** to index the next folio for the traversal.h](jM)}(h**Parameters**h]j)}(hj`h]h Parameters}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj^ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjZubj)}(hhh](j)}(h>``struct address_space *mapping`` The address_space to search h](j)}(h!``struct address_space *mapping``h]jS)}(hjh]hstruct address_space *mapping}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj}ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjyubj)}(hhh]jM)}(hThe address_space to searchh]hThe address_space to search}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjyubeh}(h]h ]h"]h$]h&]uh1jhjhMhjvubj)}(h+``pgoff_t *start`` The starting page index h](j)}(h``pgoff_t *start``h]jS)}(hjh]hpgoff_t *start}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubj)}(hhh]jM)}(hThe starting page indexh]hThe starting page index}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjvubj)}(h1``pgoff_t end`` The final page index (inclusive) h](j)}(h``pgoff_t end``h]jS)}(hjh]h pgoff_t end}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubj)}(hhh]jM)}(h The final page index (inclusive)h]h The final page index (inclusive)}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjvubj)}(h2``struct folio_batch *fbatch`` The batch to fill. h](j)}(h``struct folio_batch *fbatch``h]jS)}(hj*h]hstruct folio_batch *fbatch}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj(ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhj$ubj)}(hhh]jM)}(hThe batch to fill.h]hThe batch to fill.}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj?hMhj@ubah}(h]h ]h"]h$]h&]uh1jhj$ubeh}(h]h ]h"]h$]h&]uh1jhj?hMhjvubeh}(h]h ]h"]h$]h&]uh1jhjZubjM)}(h**Description**h]j)}(hjeh]h Description}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1jhjcubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjZubjM)}(hSearch for and return a batch of folios in the mapping starting at index **start** and up to index **end** (inclusive). The folios are returned in **fbatch** with an elevated reference count.h](hISearch for and return a batch of folios in the mapping starting at index }(hj{hhhNhNubj)}(h **start**h]hstart}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj{ubh and up to index }(hj{hhhNhNubj)}(h**end**h]hend}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj{ubh* (inclusive). The folios are returned in }(hj{hhhNhNubj)}(h **fbatch**h]hfbatch}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj{ubh" with an elevated reference count.}(hj{hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjZubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjZubjM)}(hjThe number of folios which were found. We also update **start** to index the next folio for the traversal.h](h6The number of folios which were found. We also update }(hjhhhNhNubj)}(h **start**h]hstart}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh+ to index the next folio for the traversal.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjZubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h&filemap_get_folios_contig (C function)c.filemap_get_folios_contighNtauh1hhjhhhNhNubh)}(hhh](h)}(h{unsigned filemap_get_folios_contig (struct address_space *mapping, pgoff_t *start, pgoff_t end, struct folio_batch *fbatch)h]h)}(hzunsigned filemap_get_folios_contig(struct address_space *mapping, pgoff_t *start, pgoff_t end, struct folio_batch *fbatch)h](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMubj)}(h h]h }(hj(hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhj'hMubh)}(hfilemap_get_folios_contigh]j)}(hfilemap_get_folios_contigh]hfilemap_get_folios_contig}(hj:hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj6ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhj'hMubj8)}(hX(struct address_space *mapping, pgoff_t *start, pgoff_t end, struct folio_batch *fbatch)h](j>)}(hstruct address_space *mappingh](j)}(hjJ,h]hstruct}(hjVhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRubj)}(h h]h }(hjchhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRubh)}(hhh]j)}(h address_spaceh]h address_space}(hjthhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjqubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjvmodnameN classnameNjj)}j]j)}jj<sbc.filemap_get_folios_contigasbuh1hhjRubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjRubj)}(hmappingh]hmapping}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjNubj>)}(hpgoff_t *starth](h)}(hhh]j)}(hpgoff_th]hpgoff_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.filemap_get_folios_contigasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hstarth]hstart}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjNubj>)}(h pgoff_t endh](h)}(hhh]j)}(hpgoff_th]hpgoff_t}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj"modnameN classnameNjj)}j]jc.filemap_get_folios_contigasbuh1hhjubj)}(h h]h }(hj>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hendh]hend}(hjLhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjNubj>)}(hstruct folio_batch *fbatchh](j)}(hjJ,h]hstruct}(hjehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubj)}(h h]h }(hjrhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubh)}(hhh]j)}(h folio_batchh]h folio_batch}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.filemap_get_folios_contigasbuh1hhjaubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjaubj)}(hfbatchh]hfbatch}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjNubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhj'hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhj'hMubah}(h]j ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj'hMhjhhubj4)}(hhh]jM)}(h Get a batch of contiguous foliosh]h Get a batch of contiguous folios}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhj'hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjhNhNubj)}(hX0**Parameters** ``struct address_space *mapping`` The address_space to search ``pgoff_t *start`` The starting page index ``pgoff_t end`` The final page index (inclusive) ``struct folio_batch *fbatch`` The batch to fill **Description** filemap_get_folios_contig() works exactly like filemap_get_folios(), except the returned folios are guaranteed to be contiguous. This may not return all contiguous folios if the batch gets filled up. **Return** The number of folios found. Also update **start** to be positioned for traversal of the next folio.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubj)}(hhh](j)}(h>``struct address_space *mapping`` The address_space to search h](j)}(h!``struct address_space *mapping``h]jS)}(hj'h]hstruct address_space *mapping}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj%ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhj!ubj)}(hhh]jM)}(hThe address_space to searchh]hThe address_space to search}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj<hMhj=ubah}(h]h ]h"]h$]h&]uh1jhj!ubeh}(h]h ]h"]h$]h&]uh1jhj<hMhjubj)}(h+``pgoff_t *start`` The starting page index h](j)}(h``pgoff_t *start``h]jS)}(hj`h]hpgoff_t *start}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj^ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjZubj)}(hhh]jM)}(hThe starting page indexh]hThe starting page index}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjuhMhjvubah}(h]h ]h"]h$]h&]uh1jhjZubeh}(h]h ]h"]h$]h&]uh1jhjuhMhjubj)}(h1``pgoff_t end`` The final page index (inclusive) h](j)}(h``pgoff_t end``h]jS)}(hjh]h pgoff_t end}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubj)}(hhh]jM)}(h The final page index (inclusive)h]h The final page index (inclusive)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h1``struct folio_batch *fbatch`` The batch to fill h](j)}(h``struct folio_batch *fbatch``h]jS)}(hjh]hstruct folio_batch *fbatch}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubj)}(hhh]jM)}(hThe batch to fillh]hThe batch to fill}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hj h]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubjM)}(hfilemap_get_folios_contig() works exactly like filemap_get_folios(), except the returned folios are guaranteed to be contiguous. This may not return all contiguous folios if the batch gets filled up.h]hfilemap_get_folios_contig() works exactly like filemap_get_folios(), except the returned folios are guaranteed to be contiguous. This may not return all contiguous folios if the batch gets filled up.}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubjM)}(h **Return**h]j)}(hj4h]hReturn}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj2ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubjM)}(hcThe number of folios found. Also update **start** to be positioned for traversal of the next folio.h](h(The number of folios found. Also update }(hjJhhhNhNubj)}(h **start**h]hstart}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjJubh2 to be positioned for traversal of the next folio.}(hjJhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h#filemap_get_folios_tag (C function)c.filemap_get_folios_taghNtauh1hhjhhhNhNubh)}(hhh](h)}(hunsigned filemap_get_folios_tag (struct address_space *mapping, pgoff_t *start, pgoff_t end, xa_mark_t tag, struct folio_batch *fbatch)h]h)}(hunsigned filemap_get_folios_tag(struct address_space *mapping, pgoff_t *start, pgoff_t end, xa_mark_t tag, struct folio_batch *fbatch)h](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM* ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM* ubh)}(hfilemap_get_folios_tagh]j)}(hfilemap_get_folios_tagh]hfilemap_get_folios_tag}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhM* ubj8)}(hg(struct address_space *mapping, pgoff_t *start, pgoff_t end, xa_mark_t tag, struct folio_batch *fbatch)h](j>)}(hstruct address_space *mappingh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(h address_spaceh]h address_space}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsbc.filemap_get_folios_tagasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hmappingh]hmapping}(hj!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hpgoff_t *starth](h)}(hhh]j)}(hpgoff_th]hpgoff_t}(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj?modnameN classnameNjj)}j]jc.filemap_get_folios_tagasbuh1hhj6ubj)}(h h]h }(hj[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj6ubjr)}(hjuh]h*}(hjihhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj6ubj)}(hstarth]hstart}(hjvhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj6ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(h pgoff_t endh](h)}(hhh]j)}(hpgoff_th]hpgoff_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.filemap_get_folios_tagasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hendh]hend}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(h xa_mark_t tagh](h)}(hhh]j)}(h xa_mark_th]h xa_mark_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.filemap_get_folios_tagasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(htagh]htag}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hstruct folio_batch *fbatchh](j)}(hjJ,h]hstruct}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h h]h }(hj, hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubh)}(hhh]j)}(h folio_batchh]h folio_batch}(hj= hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj: ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj? modnameN classnameNjj)}j]jc.filemap_get_folios_tagasbuh1hhj ubj)}(h h]h }(hj[ hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubjr)}(hjuh]h*}(hji hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj ubj)}(hfbatchh]hfbatch}(hjv hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhM* ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhM* ubah}(h]j~ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhM* hjhhubj4)}(hhh]jM)}(h&Get a batch of folios matching **tag**h](hGet a batch of folios matching }(hj hhhNhNubj)}(h**tag**h]htag}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM* hj hhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhM* ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj jHj jIjJjKuh1hhhhjhNhNubj)}(hXU**Parameters** ``struct address_space *mapping`` The address_space to search ``pgoff_t *start`` The starting page index ``pgoff_t end`` The final page index (inclusive) ``xa_mark_t tag`` The tag index ``struct folio_batch *fbatch`` The batch to fill **Description** The first folio may start before **start**; if it does, it will contain **start**. The final folio may extend beyond **end**; if it does, it will contain **end**. The folios have ascending indices. There may be gaps between the folios if there are indices which have no folio in the page cache. If folios are added to or removed from the page cache while this is running, they may or may not be found by this call. Only returns folios that are tagged with **tag**. **Return** The number of folios found. Also update **start** to index the next folio for traversal.h](jM)}(h**Parameters**h]j)}(hj h]h Parameters}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM. hj ubj)}(hhh](j)}(h>``struct address_space *mapping`` The address_space to search h](j)}(h!``struct address_space *mapping``h]jS)}(hj h]hstruct address_space *mapping}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM+ hj ubj)}(hhh]jM)}(hThe address_space to searchh]hThe address_space to search}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj hM+ hj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hM+ hj ubj)}(h+``pgoff_t *start`` The starting page index h](j)}(h``pgoff_t *start``h]jS)}(hj( h]hpgoff_t *start}(hj* hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj& ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM, hj" ubj)}(hhh]jM)}(hThe starting page indexh]hThe starting page index}(hjA hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj= hM, hj> ubah}(h]h ]h"]h$]h&]uh1jhj" ubeh}(h]h ]h"]h$]h&]uh1jhj= hM, hj ubj)}(h1``pgoff_t end`` The final page index (inclusive) h](j)}(h``pgoff_t end``h]jS)}(hja h]h pgoff_t end}(hjc hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj_ ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM- hj[ ubj)}(hhh]jM)}(h The final page index (inclusive)h]h The final page index (inclusive)}(hjz hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjv hM- hjw ubah}(h]h ]h"]h$]h&]uh1jhj[ ubeh}(h]h ]h"]h$]h&]uh1jhjv hM- hj ubj)}(h ``xa_mark_t tag`` The tag index h](j)}(h``xa_mark_t tag``h]jS)}(hj h]h xa_mark_t tag}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM. hj ubj)}(hhh]jM)}(h The tag indexh]h The tag index}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj hM. hj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hM. hj ubj)}(h1``struct folio_batch *fbatch`` The batch to fill h](j)}(h``struct folio_batch *fbatch``h]jS)}(hj h]hstruct folio_batch *fbatch}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM/ hj ubj)}(hhh]jM)}(hThe batch to fillh]hThe batch to fill}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj 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 ubjM)}(h**Description**h]j)}(hj h]h Description}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM1 hj ubjM)}(hXThe first folio may start before **start**; if it does, it will contain **start**. The final folio may extend beyond **end**; if it does, it will contain **end**. The folios have ascending indices. There may be gaps between the folios if there are indices which have no folio in the page cache. If folios are added to or removed from the page cache while this is running, they may or may not be found by this call. Only returns folios that are tagged with **tag**.h](h!The first folio may start before }(hj$ hhhNhNubj)}(h **start**h]hstart}(hj, hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj$ ubh; if it does, it will contain }(hj$ hhhNhNubj)}(h **start**h]hstart}(hj> hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj$ ubh%. The final folio may extend beyond }(hj$ hhhNhNubj)}(h**end**h]hend}(hjP hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj$ ubh; if it does, it will contain }(hj$ hhhNhNubj)}(h**end**h]hend}(hjb hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj$ ubhX*. The folios have ascending indices. There may be gaps between the folios if there are indices which have no folio in the page cache. If folios are added to or removed from the page cache while this is running, they may or may not be found by this call. Only returns folios that are tagged with }(hj$ hhhNhNubj)}(h**tag**h]htag}(hjt hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj$ ubh.}(hj$ hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM0 hj ubjM)}(h **Return**h]j)}(hj h]hReturn}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM8 hj ubjM)}(hXThe number of folios found. Also update **start** to index the next folio for traversal.h](h(The number of folios found. Also update }(hj hhhNhNubj)}(h **start**h]hstart}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubh' to index the next folio for traversal.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM9 hj ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfilemap_read (C function)c.filemap_readhNtauh1hhjhhhNhNubh)}(hhh](h)}(hVssize_t filemap_read (struct kiocb *iocb, struct iov_iter *iter, ssize_t already_read)h]h)}(hUssize_t filemap_read(struct kiocb *iocb, struct iov_iter *iter, ssize_t already_read)h](h)}(hhh]j)}(hssize_th]hssize_t}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj modnameN classnameNjj)}j]j)}j filemap_readsbc.filemap_readasbuh1hhj hhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM ubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhj hM ubh)}(h filemap_readh]j)}(hj h]h filemap_read}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj hhhj hM ubj8)}(hA(struct kiocb *iocb, struct iov_iter *iter, ssize_t already_read)h](j>)}(hstruct kiocb *iocbh](j)}(hjJ,h]hstruct}(hj8 hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4 ubj)}(h h]h }(hjE hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4 ubh)}(hhh]j)}(hkiocbh]hkiocb}(hjV hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjS ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjX modnameN classnameNjj)}j]j c.filemap_readasbuh1hhj4 ubj)}(h h]h }(hjt hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4 ubjr)}(hjuh]h*}(hj hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj4 ubj)}(hiocbh]hiocb}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4 ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj0 ubj>)}(hstruct iov_iter *iterh](j)}(hjJ,h]hstruct}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubh)}(hhh]j)}(hiov_iterh]hiov_iter}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj modnameN classnameNjj)}j]j c.filemap_readasbuh1hhj ubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubjr)}(hjuh]h*}(hj hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj ubj)}(hiterh]hiter}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj0 ubj>)}(hssize_t already_readh](h)}(hhh]j)}(hssize_th]hssize_t}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj modnameN classnameNjj)}j]j c.filemap_readasbuh1hhj ubj)}(h h]h }(hj9 hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h already_readh]h already_read}(hjG hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj0 ubeh}(h]h ]h"]h$]h&]jjuh1j7hj hhhj hM ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj hhhj hM ubah}(h]j ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj hM hj hhubj4)}(hhh]jM)}(hRead data from the page cache.h]hRead data from the page cache.}(hjq hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM hjn hhubah}(h]h ]h"]h$]h&]uh1j3hj hhhj hM ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj jHj jIjJjKuh1hhhhjhNhNubj)}(hX**Parameters** ``struct kiocb *iocb`` The iocb to read. ``struct iov_iter *iter`` Destination for the data. ``ssize_t already_read`` Number of bytes already read by the caller. **Description** Copies data from the page cache. If the data is not currently present, uses the readahead and read_folio address_space operations to fetch it. **Return** Total number of bytes copied, including those already read by the caller. If an error happens before any bytes are copied, returns a negative error number.h](jM)}(h**Parameters**h]j)}(hj h]h Parameters}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM hj ubj)}(hhh](j)}(h)``struct kiocb *iocb`` The iocb to read. h](j)}(h``struct kiocb *iocb``h]jS)}(hj h]hstruct kiocb *iocb}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM hj ubj)}(hhh]jM)}(hThe iocb to read.h]hThe iocb to read.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj hM hj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hM hj ubj)}(h4``struct iov_iter *iter`` Destination for the data. h](j)}(h``struct iov_iter *iter``h]jS)}(hj h]hstruct iov_iter *iter}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM hj ubj)}(hhh]jM)}(hDestination for the data.h]hDestination for the data.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM hjubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhjhM hj ubj)}(hE``ssize_t already_read`` Number of bytes already read by the caller. h](j)}(h``ssize_t already_read``h]jS)}(hj$h]hssize_t already_read}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj"ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM hjubj)}(hhh]jM)}(h+Number of bytes already read by the caller.h]h+Number of bytes already read by the caller.}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj9hM hj:ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj9hM hj ubeh}(h]h ]h"]h$]h&]uh1jhj ubjM)}(h**Description**h]j)}(hj_h]h Description}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1jhj]ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM hj ubjM)}(hCopies data from the page cache. If the data is not currently present, uses the readahead and read_folio address_space operations to fetch it.h]hCopies data from the page cache. If the data is not currently present, uses the readahead and read_folio address_space operations to fetch it.}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM hj ubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM hj ubjM)}(hTotal number of bytes copied, including those already read by the caller. If an error happens before any bytes are copied, returns a negative error number.h]hTotal number of bytes copied, including those already read by the caller. If an error happens before any bytes are copied, returns a negative error number.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM hj ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h#generic_file_read_iter (C function)c.generic_file_read_iterhNtauh1hhjhhhNhNubh)}(hhh](h)}(hJssize_t generic_file_read_iter (struct kiocb *iocb, struct iov_iter *iter)h]h)}(hIssize_t generic_file_read_iter(struct kiocb *iocb, struct iov_iter *iter)h](h)}(hhh]j)}(hssize_th]hssize_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jgeneric_file_read_itersbc.generic_file_read_iterasbuh1hhjhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM ubh)}(hgeneric_file_read_iterh]j)}(hjh]hgeneric_file_read_iter}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhM ubj8)}(h+(struct kiocb *iocb, struct iov_iter *iter)h](j>)}(hstruct kiocb *iocbh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hkiocbh]hkiocb}(hj;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj8ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj=modnameN classnameNjj)}j]jc.generic_file_read_iterasbuh1hhjubj)}(h h]h }(hjYhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjghhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hiocbh]hiocb}(hjthhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hstruct iov_iter *iterh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hiov_iterh]hiov_iter}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.generic_file_read_iterasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hiterh]hiter}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhM ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhM ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhM hjhhubj4)}(hhh]jM)}(hgeneric filesystem read routineh]hgeneric filesystem read routine}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM hj hhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhM ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj&jHj&jIjJjKuh1hhhhjhNhNubj)}(hX**Parameters** ``struct kiocb *iocb`` kernel I/O control block ``struct iov_iter *iter`` destination for the data read **Description** This is the "read_iter()" routine for all filesystems that can use the page cache directly. The IOCB_NOWAIT flag in iocb->ki_flags indicates that -EAGAIN shall be returned when no data can be read without waiting for I/O requests to complete; it doesn't prevent readahead. The IOCB_NOIO flag in iocb->ki_flags indicates that no new I/O requests shall be made for the read or for readahead. When no data can be read, -EAGAIN shall be returned. When readahead would be triggered, a partial, possibly empty read shall be returned. **Return** * number of bytes copied, even for partial reads * negative error code (or 0 if IOCB_NOIO) if nothing was readh](jM)}(h**Parameters**h]j)}(hj0h]h Parameters}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj.ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM hj*ubj)}(hhh](j)}(h0``struct kiocb *iocb`` kernel I/O control block h](j)}(h``struct kiocb *iocb``h]jS)}(hjOh]hstruct kiocb *iocb}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjMubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM hjIubj)}(hhh]jM)}(hkernel I/O control blockh]hkernel I/O control block}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjdhM hjeubah}(h]h ]h"]h$]h&]uh1jhjIubeh}(h]h ]h"]h$]h&]uh1jhjdhM hjFubj)}(h8``struct iov_iter *iter`` destination for the data read h](j)}(h``struct iov_iter *iter``h]jS)}(hjh]hstruct iov_iter *iter}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM hjubj)}(hhh]jM)}(hdestination for the data readh]hdestination for the data read}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hjFubeh}(h]h ]h"]h$]h&]uh1jhj*ubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM hj*ubjM)}(h[This is the "read_iter()" routine for all filesystems that can use the page cache directly.h]h_This is the “read_iter()” routine for all filesystems that can use the page cache directly.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM hj*ubjM)}(hThe IOCB_NOWAIT flag in iocb->ki_flags indicates that -EAGAIN shall be returned when no data can be read without waiting for I/O requests to complete; it doesn't prevent readahead.h]hThe IOCB_NOWAIT flag in iocb->ki_flags indicates that -EAGAIN shall be returned when no data can be read without waiting for I/O requests to complete; it doesn’t prevent readahead.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM hj*ubjM)}(hXThe IOCB_NOIO flag in iocb->ki_flags indicates that no new I/O requests shall be made for the read or for readahead. When no data can be read, -EAGAIN shall be returned. When readahead would be triggered, a partial, possibly empty read shall be returned.h]hXThe IOCB_NOIO flag in iocb->ki_flags indicates that no new I/O requests shall be made for the read or for readahead. When no data can be read, -EAGAIN shall be returned. When readahead would be triggered, a partial, possibly empty read shall be returned.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM hj*ubjM)}(h **Return**h]j)}(hjh]hReturn}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM hj*ubj^)}(hhh](jc)}(h.number of bytes copied, even for partial readsh]jM)}(hj#h]h.number of bytes copied, even for partial reads}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM hj!ubah}(h]h ]h"]h$]h&]uh1jbhjubjc)}(h;negative error code (or 0 if IOCB_NOIO) if nothing was readh]jM)}(hj;h]h;negative error code (or 0 if IOCB_NOIO) if nothing was read}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM hj9ubah}(h]h ]h"]h$]h&]uh1jbhjubeh}(h]h ]h"]h$]h&]jjuuh1j]hj2hM hj*ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h filemap_splice_read (C function)c.filemap_splice_readhNtauh1hhjhhhNhNubh)}(hhh](h)}(hyssize_t filemap_splice_read (struct file *in, loff_t *ppos, struct pipe_inode_info *pipe, size_t len, unsigned int flags)h]h)}(hxssize_t filemap_splice_read(struct file *in, loff_t *ppos, struct pipe_inode_info *pipe, size_t len, unsigned int flags)h](h)}(hhh]j)}(hssize_th]hssize_t}(hjzhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjwubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj|modnameN classnameNjj)}j]j)}jfilemap_splice_readsbc.filemap_splice_readasbuh1hhjshhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjshhhjhM ubh)}(hfilemap_splice_readh]j)}(hjh]hfilemap_splice_read}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjshhhjhM ubj8)}(h](struct file *in, loff_t *ppos, struct pipe_inode_info *pipe, size_t len, unsigned int flags)h](j>)}(hstruct file *inh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hfileh]hfile}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.filemap_splice_readasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hinh]hin}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(h loff_t *pposh](h)}(hhh]j)}(hloff_th]hloff_t}(hj<hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj>modnameN classnameNjj)}j]jc.filemap_splice_readasbuh1hhj5ubj)}(h h]h }(hjZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5ubjr)}(hjuh]h*}(hjhhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj5ubj)}(hpposh]hppos}(hjuhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hstruct pipe_inode_info *pipeh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hpipe_inode_infoh]hpipe_inode_info}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.filemap_splice_readasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hpipeh]hpipe}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(h size_t lenh](h)}(hhh]j)}(hsize_th]hsize_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.filemap_splice_readasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hlenh]hlen}(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hunsigned int flagsh](j)}(hunsignedh]hunsigned}(hjFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubj)}(h h]h }(hjThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubj)}(hinth]hint}(hjbhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubj)}(h h]h }(hjphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubj)}(hflagsh]hflags}(hj~hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjshhhjhM ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjohhhjhM ubah}(h]jjah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhM hjlhhubj4)}(hhh]jM)}(h/Splice data from a file's pagecache into a pipeh]h1Splice data from a file’s pagecache into a pipe}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM hjhhubah}(h]h ]h"]h$]h&]uh1j3hjlhhhjhM ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjhNhNubj)}(hXV**Parameters** ``struct file *in`` The file to read from ``loff_t *ppos`` Pointer to the file position to read from ``struct pipe_inode_info *pipe`` The pipe to splice into ``size_t len`` The amount to splice ``unsigned int flags`` The SPLICE_F_* flags **Description** This function gets folios from a file's pagecache and splices them into the pipe. Readahead will be called as necessary to fill more folios. This may be used for blockdevs also. **Return** On success, the number of bytes read will be returned and ***ppos** will be updated if appropriate; 0 will be returned if there is no more data to be read; -EAGAIN will be returned if the pipe had no space, and some other negative error code will be returned on error. A short read may occur if the pipe has insufficient space, we reach the end of the data or we hit a hole.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM hjubj)}(hhh](j)}(h*``struct file *in`` The file to read from h](j)}(h``struct file *in``h]jS)}(hjh]hstruct file *in}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM hjubj)}(hhh]jM)}(hThe file to read fromh]hThe file to read from}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hjubj)}(h;``loff_t *ppos`` Pointer to the file position to read from h](j)}(h``loff_t *ppos``h]jS)}(hj"h]h loff_t *ppos}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM hjubj)}(hhh]jM)}(h)Pointer to the file position to read fromh]h)Pointer to the file position to read from}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj7hM hj8ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj7hM hjubj)}(h9``struct pipe_inode_info *pipe`` The pipe to splice into h](j)}(h ``struct pipe_inode_info *pipe``h]jS)}(hj[h]hstruct pipe_inode_info *pipe}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjYubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM hjUubj)}(hhh]jM)}(hThe pipe to splice intoh]hThe pipe to splice into}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjphM hjqubah}(h]h ]h"]h$]h&]uh1jhjUubeh}(h]h ]h"]h$]h&]uh1jhjphM hjubj)}(h$``size_t len`` The amount to splice h](j)}(h``size_t len``h]jS)}(hjh]h size_t len}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM hjubj)}(hhh]jM)}(hThe amount to spliceh]hThe amount to splice}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hjubj)}(h,``unsigned int flags`` The SPLICE_F_* flags h](j)}(h``unsigned int flags``h]jS)}(hjh]hunsigned int flags}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM hjubj)}(hhh]jM)}(hThe SPLICE_F_* flagsh]hThe SPLICE_F_* flags}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM hjubjM)}(hThis function gets folios from a file's pagecache and splices them into the pipe. Readahead will be called as necessary to fill more folios. This may be used for blockdevs also.h]hThis function gets folios from a file’s pagecache and splices them into the pipe. Readahead will be called as necessary to fill more folios. This may be used for blockdevs also.T}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM hjubjM)}(h **Return**h]j)}(hj/h]hReturn}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj-ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM hjubjM)}(hXwOn success, the number of bytes read will be returned and ***ppos** will be updated if appropriate; 0 will be returned if there is no more data to be read; -EAGAIN will be returned if the pipe had no space, and some other negative error code will be returned on error. A short read may occur if the pipe has insufficient space, we reach the end of the data or we hit a hole.h](h:On success, the number of bytes read will be returned and }(hjEhhhNhNubj)}(h ***ppos**h]h*ppos}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjEubhX4 will be updated if appropriate; 0 will be returned if there is no more data to be read; -EAGAIN will be returned if the pipe had no space, and some other negative error code will be returned on error. A short read may occur if the pipe has insufficient space, we reach the end of the data or we hit a hole.}(hjEhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfilemap_fault (C function)c.filemap_faulthNtauh1hhjhhhNhNubh)}(hhh](h)}(h/vm_fault_t filemap_fault (struct vm_fault *vmf)h]h)}(h.vm_fault_t filemap_fault(struct vm_fault *vmf)h](h)}(hhh]j)}(h vm_fault_th]h vm_fault_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}j filemap_faultsbc.filemap_faultasbuh1hhjhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM ubh)}(h filemap_faulth]j)}(hjh]h filemap_fault}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhM ubj8)}(h(struct vm_fault *vmf)h]j>)}(hstruct vm_fault *vmfh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hvm_faulth]hvm_fault}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.filemap_faultasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hj"hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hvmfh]hvmf}(hj/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhM ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj~hhhjhM ubah}(h]jyah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhM hj{hhubj4)}(hhh]jM)}(h)read in file data for page fault handlingh]h)read in file data for page fault handling}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM hjVhhubah}(h]h ]h"]h$]h&]uh1j3hj{hhhjhM ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjqjHjqjIjJjKuh1hhhhjhNhNubj)}(hX-**Parameters** ``struct vm_fault *vmf`` struct vm_fault containing details of the fault **Description** filemap_fault() is invoked via the vma operations vector for a mapped memory region to read in file data during a page fault. The goto's are kind of ugly, but this streamlines the normal case of having it in the page cache, and handles the special cases reasonably without having a lot of duplicated code. vma->vm_mm->mmap_lock must be held on entry. If our return value has VM_FAULT_RETRY set, it's because the mmap_lock may be dropped before doing I/O or by lock_folio_maybe_drop_mmap(). If our return value does not have VM_FAULT_RETRY set, the mmap_lock has not been released. We never return with VM_FAULT_RETRY and a bit from VM_FAULT_ERROR set. **Return** bitwise-OR of ``VM_FAULT_`` codes.h](jM)}(h**Parameters**h]j)}(hj{h]h Parameters}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjyubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM hjuubj)}(hhh]j)}(hI``struct vm_fault *vmf`` struct vm_fault containing details of the fault h](j)}(h``struct vm_fault *vmf``h]jS)}(hjh]hstruct vm_fault *vmf}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM hjubj)}(hhh]jM)}(h/struct vm_fault containing details of the faulth]h/struct vm_fault containing details of the fault}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjuubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM hjuubjM)}(h}filemap_fault() is invoked via the vma operations vector for a mapped memory region to read in file data during a page fault.h]h}filemap_fault() is invoked via the vma operations vector for a mapped memory region to read in file data during a page fault.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM hjuubjM)}(hThe goto's are kind of ugly, but this streamlines the normal case of having it in the page cache, and handles the special cases reasonably without having a lot of duplicated code.h]hThe goto’s are kind of ugly, but this streamlines the normal case of having it in the page cache, and handles the special cases reasonably without having a lot of duplicated code.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM hjuubjM)}(h,vma->vm_mm->mmap_lock must be held on entry.h]h,vma->vm_mm->mmap_lock must be held on entry.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM hjuubjM)}(hIf our return value has VM_FAULT_RETRY set, it's because the mmap_lock may be dropped before doing I/O or by lock_folio_maybe_drop_mmap().h]hIf our return value has VM_FAULT_RETRY set, it’s because the mmap_lock may be dropped before doing I/O or by lock_folio_maybe_drop_mmap().}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM hjuubjM)}(hZIf our return value does not have VM_FAULT_RETRY set, the mmap_lock has not been released.h]hZIf our return value does not have VM_FAULT_RETRY set, the mmap_lock has not been released.}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM hjuubjM)}(hFWe never return with VM_FAULT_RETRY and a bit from VM_FAULT_ERROR set.h]hFWe never return with VM_FAULT_RETRY and a bit from VM_FAULT_ERROR set.}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM hjuubjM)}(h **Return**h]j)}(hjGh]hReturn}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjEubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM hjuubjM)}(h"bitwise-OR of ``VM_FAULT_`` codes.h](hbitwise-OR of }(hj]hhhNhNubjS)}(h ``VM_FAULT_``h]h VM_FAULT_}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj]ubh codes.}(hj]hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM hjuubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hread_cache_folio (C function)c.read_cache_foliohNtauh1hhjhhhNhNubh)}(hhh](h)}(hrstruct folio * read_cache_folio (struct address_space *mapping, pgoff_t index, filler_t filler, struct file *file)h]h)}(hpstruct folio *read_cache_folio(struct address_space *mapping, pgoff_t index, filler_t filler, struct file *file)h](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM\ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM\ubh)}(hhh]j)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jread_cache_foliosbc.read_cache_folioasbuh1hhjhhhjhM\ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM\ubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjhhhjhM\ubh)}(hread_cache_folioh]j)}(hjh]hread_cache_folio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhM\ubj8)}(hR(struct address_space *mapping, pgoff_t index, filler_t filler, struct file *file)h](j>)}(hstruct address_space *mappingh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(h address_spaceh]h address_space}(hj6hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj8modnameN classnameNjj)}j]jc.read_cache_folioasbuh1hhjubj)}(h h]h }(hjThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjbhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hmappingh]hmapping}(hjohhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(h pgoff_t indexh](h)}(hhh]j)}(hpgoff_th]hpgoff_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.read_cache_folioasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hindexh]hindex}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hfiller_t fillerh](h)}(hhh]j)}(hfiller_th]hfiller_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.read_cache_folioasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hfillerh]hfiller}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hstruct file *fileh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hfileh]hfile}(hj6hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj8modnameN classnameNjj)}j]jc.read_cache_folioasbuh1hhjubj)}(h h]h }(hjThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjbhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hfileh]hfile}(hjohhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhM\ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhM\ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhM\hjhhubj4)}(hhh]jM)}(h(Read into page cache, fill it if needed.h]h(Read into page cache, fill it if needed.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM\hjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhM\ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjhNhNubj)}(hX**Parameters** ``struct address_space *mapping`` The address_space to read from. ``pgoff_t index`` The index to read. ``filler_t filler`` Function to perform the read, or NULL to use aops->read_folio(). ``struct file *file`` Passed to filler function, may be NULL if not required. **Description** Read one page into the page cache. If it succeeds, the folio returned will contain **index**, but it may not be the first page of the folio. If the filler function returns an error, it will be returned to the caller. **Context** May sleep. Expects mapping->invalidate_lock to be held. **Return** An uptodate folio on success, ERR_PTR() on failure.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM`hjubj)}(hhh](j)}(hB``struct address_space *mapping`` The address_space to read from. h](j)}(h!``struct address_space *mapping``h]jS)}(hjh]hstruct address_space *mapping}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM]hjubj)}(hhh]jM)}(hThe address_space to read from.h]hThe address_space to read from.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM]hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM]hjubj)}(h%``pgoff_t index`` The index to read. h](j)}(h``pgoff_t index``h]jS)}(hjh]h pgoff_t index}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM^hj ubj)}(hhh]jM)}(hThe index to read.h]hThe index to read.}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj(hM^hj)ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj(hM^hjubj)}(hU``filler_t filler`` Function to perform the read, or NULL to use aops->read_folio(). h](j)}(h``filler_t filler``h]jS)}(hjLh]hfiller_t filler}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjJubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM_hjFubj)}(hhh]jM)}(h@Function to perform the read, or NULL to use aops->read_folio().h]h@Function to perform the read, or NULL to use aops->read_folio().}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjahM_hjbubah}(h]h ]h"]h$]h&]uh1jhjFubeh}(h]h ]h"]h$]h&]uh1jhjahM_hjubj)}(hN``struct file *file`` Passed to filler function, may be NULL if not required. h](j)}(h``struct file *file``h]jS)}(hjh]hstruct file *file}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM`hjubj)}(hhh]jM)}(h7Passed to filler function, may be NULL if not required.h]h7Passed to filler function, may be NULL if not required.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM`hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM`hjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMbhjubjM)}(hRead one page into the page cache. If it succeeds, the folio returned will contain **index**, but it may not be the first page of the folio.h](hTRead one page into the page cache. If it succeeds, the folio returned will contain }(hjhhhNhNubj)}(h **index**h]hindex}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh0, but it may not be the first page of the folio.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMahjubjM)}(hKIf the filler function returns an error, it will be returned to the caller.h]hKIf the filler function returns an error, it will be returned to the caller.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMdhjubjM)}(h **Context**h]j)}(hjh]hContext}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMghjubjM)}(h8May sleep. Expects mapping->invalidate_lock to be held.h]h8May sleep. Expects mapping->invalidate_lock to be held.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhhjubjM)}(h **Return**h]j)}(hj/h]hReturn}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj-ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMjhjubjM)}(h3An uptodate folio on success, ERR_PTR() on failure.h]h3An uptodate folio on success, ERR_PTR() on failure.}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMihjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h#mapping_read_folio_gfp (C function)c.mapping_read_folio_gfphNtauh1hhjhhhNhNubh)}(hhh](h)}(h_struct folio * mapping_read_folio_gfp (struct address_space *mapping, pgoff_t index, gfp_t gfp)h]h)}(h]struct folio *mapping_read_folio_gfp(struct address_space *mapping, pgoff_t index, gfp_t gfp)h](j)}(hjJ,h]hstruct}(hjthhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjphhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMtubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjphhhjhMtubh)}(hhh]j)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jmapping_read_folio_gfpsbc.mapping_read_folio_gfpasbuh1hhjphhhjhMtubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjphhhjhMtubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjphhhjhMtubh)}(hmapping_read_folio_gfph]j)}(hjh]hmapping_read_folio_gfp}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjphhhjhMtubj8)}(h9(struct address_space *mapping, pgoff_t index, gfp_t gfp)h](j>)}(hstruct address_space *mappingh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(h address_spaceh]h address_space}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.mapping_read_folio_gfpasbuh1hhjubj)}(h h]h }(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hj8hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hmappingh]hmapping}(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(h pgoff_t indexh](h)}(hhh]j)}(hpgoff_th]hpgoff_t}(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjcmodnameN classnameNjj)}j]jc.mapping_read_folio_gfpasbuh1hhjZubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZubj)}(hindexh]hindex}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(h gfp_t gfph](h)}(hhh]j)}(hgfp_th]hgfp_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.mapping_read_folio_gfpasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hgfph]hgfp}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjphhhjhMtubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjlhhhjhMtubah}(h]jgah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMthjihhubj4)}(hhh]jM)}(h7Read into page cache, using specified allocation flags.h]h7Read into page cache, using specified allocation flags.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMthjhhubah}(h]h ]h"]h$]h&]uh1j3hjihhhjhMtubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjhNhNubj)}(hX**Parameters** ``struct address_space *mapping`` The address_space for the folio. ``pgoff_t index`` The index that the allocated folio will contain. ``gfp_t gfp`` The page allocator flags to use if allocating. **Description** This is the same as "read_cache_folio(mapping, index, NULL, NULL)", but with any new memory allocations done using the specified allocation flags. The most likely error from this function is EIO, but ENOMEM is possible and so is EINTR. If ->read_folio returns another error, that will be returned to the caller. The function expects mapping->invalidate_lock to be already held. **Return** Uptodate folio on success, ERR_PTR() on failure.h](jM)}(h**Parameters**h]j)}(hj!h]h Parameters}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMxhjubj)}(hhh](j)}(hC``struct address_space *mapping`` The address_space for the folio. h](j)}(h!``struct address_space *mapping``h]jS)}(hj@h]hstruct address_space *mapping}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj>ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMuhj:ubj)}(hhh]jM)}(h The address_space for the folio.h]h The address_space for the folio.}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjUhMuhjVubah}(h]h ]h"]h$]h&]uh1jhj:ubeh}(h]h ]h"]h$]h&]uh1jhjUhMuhj7ubj)}(hC``pgoff_t index`` The index that the allocated folio will contain. h](j)}(h``pgoff_t index``h]jS)}(hjyh]h pgoff_t index}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjwubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMvhjsubj)}(hhh]jM)}(h0The index that the allocated folio will contain.h]h0The index that the allocated folio will contain.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMvhjubah}(h]h ]h"]h$]h&]uh1jhjsubeh}(h]h ]h"]h$]h&]uh1jhjhMvhj7ubj)}(h=``gfp_t gfp`` The page allocator flags to use if allocating. h](j)}(h ``gfp_t gfp``h]jS)}(hjh]h gfp_t gfp}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMwhjubj)}(hhh]jM)}(h.The page allocator flags to use if allocating.h]h.The page allocator flags to use if allocating.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMwhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMwhj7ubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMyhjubjM)}(hThis is the same as "read_cache_folio(mapping, index, NULL, NULL)", but with any new memory allocations done using the specified allocation flags.h]hThis is the same as “read_cache_folio(mapping, index, NULL, NULL)”, but with any new memory allocations done using the specified allocation flags.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMxhjubjM)}(hThe most likely error from this function is EIO, but ENOMEM is possible and so is EINTR. If ->read_folio returns another error, that will be returned to the caller.h]hThe most likely error from this function is EIO, but ENOMEM is possible and so is EINTR. If ->read_folio returns another error, that will be returned to the caller.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM{hjubjM)}(hAThe function expects mapping->invalidate_lock to be already held.h]hAThe function expects mapping->invalidate_lock to be already held.}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubjM)}(h **Return**h]j)}(hj2h]hReturn}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj0ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubjM)}(h0Uptodate folio on success, ERR_PTR() on failure.h]h0Uptodate folio on success, ERR_PTR() on failure.}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h read_cache_page_gfp (C function)c.read_cache_page_gfphNtauh1hhjhhhNhNubh)}(hhh](h)}(h[struct page * read_cache_page_gfp (struct address_space *mapping, pgoff_t index, gfp_t gfp)h]h)}(hYstruct page *read_cache_page_gfp(struct address_space *mapping, pgoff_t index, gfp_t gfp)h](j)}(hjJ,h]hstruct}(hjwhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjshhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjshhhjhMubh)}(hhh]j)}(hpageh]hpage}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jread_cache_page_gfpsbc.read_cache_page_gfpasbuh1hhjshhhjhMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjshhhjhMubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjshhhjhMubh)}(hread_cache_page_gfph]j)}(hjh]hread_cache_page_gfp}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjshhhjhMubj8)}(h9(struct address_space *mapping, pgoff_t index, gfp_t gfp)h](j>)}(hstruct address_space *mappingh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(h address_spaceh]h address_space}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.read_cache_page_gfpasbuh1hhjubj)}(h h]h }(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hj;hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hmappingh]hmapping}(hjHhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(h pgoff_t indexh](h)}(hhh]j)}(hpgoff_th]hpgoff_t}(hjdhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjfmodnameN classnameNjj)}j]jc.read_cache_page_gfpasbuh1hhj]ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj]ubj)}(hindexh]hindex}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj]ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(h gfp_t gfph](h)}(hhh]j)}(hgfp_th]hgfp_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.read_cache_page_gfpasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hgfph]hgfp}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjshhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjohhhjhMubah}(h]jjah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjlhhubj4)}(hhh]jM)}(hinvalidate_lock to be already held. **Return** up to date page on success, ERR_PTR() on failure.h](jM)}(h**Parameters**h]j)}(hj$ h]h Parameters}(hj& hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj" ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhj ubj)}(hhh](j)}(h;``struct address_space *mapping`` the page's address_space h](j)}(h!``struct address_space *mapping``h]jS)}(hjC h]hstruct address_space *mapping}(hjE hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjA ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhj= ubj)}(hhh]jM)}(hthe page's address_spaceh]hthe page’s address_space}(hj\ hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjX hMhjY ubah}(h]h ]h"]h$]h&]uh1jhj= ubeh}(h]h ]h"]h$]h&]uh1jhjX hMhj: ubj)}(h!``pgoff_t index`` the page index h](j)}(h``pgoff_t index``h]jS)}(hj| h]h pgoff_t index}(hj~ hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjz ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjv ubj)}(hhh]jM)}(hthe page indexh]hthe page index}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj hMhj ubah}(h]h ]h"]h$]h&]uh1jhjv ubeh}(h]h ]h"]h$]h&]uh1jhj hMhj: ubj)}(h<``gfp_t gfp`` the page allocator flags to use if allocating h](j)}(h ``gfp_t gfp``h]jS)}(hj h]h gfp_t gfp}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhj ubj)}(hhh]jM)}(h-the page allocator flags to use if allocatingh]h-the page allocator flags to use if allocating}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj hMhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hMhj: ubeh}(h]h ]h"]h$]h&]uh1jhj ubjM)}(h**Description**h]j)}(hj h]h Description}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhj ubjM)}(hThis is the same as "read_mapping_page(mapping, index, NULL)", but with any new page allocations done using the specified allocation flags.h]hThis is the same as “read_mapping_page(mapping, index, NULL)”, but with any new page allocations done using the specified allocation flags.}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhj ubjM)}(h7If the page does not get brought uptodate, return -EIO.h]h7If the page does not get brought uptodate, return -EIO.}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhj ubjM)}(hAThe function expects mapping->invalidate_lock to be already held.h]hAThe function expects mapping->invalidate_lock to be already held.}(hj$!hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhj ubjM)}(h **Return**h]j)}(hj5!h]hReturn}(hj7!hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj3!ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhj ubjM)}(h1up to date page on success, ERR_PTR() on failure.h]h1up to date page on success, ERR_PTR() on failure.}(hjK!hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhj ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h&__generic_file_write_iter (C function)c.__generic_file_write_iterhNtauh1hhjhhhNhNubh)}(hhh](h)}(hMssize_t __generic_file_write_iter (struct kiocb *iocb, struct iov_iter *from)h]h)}(hLssize_t __generic_file_write_iter(struct kiocb *iocb, struct iov_iter *from)h](h)}(hhh]j)}(hssize_th]hssize_t}(hj}!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjz!ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj!modnameN classnameNjj)}j]j)}j__generic_file_write_itersbc.__generic_file_write_iterasbuh1hhjv!hhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMkubj)}(h h]h }(hj!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjv!hhhj!hMkubh)}(h__generic_file_write_iterh]j)}(hj!h]h__generic_file_write_iter}(hj!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjv!hhhj!hMkubj8)}(h+(struct kiocb *iocb, struct iov_iter *from)h](j>)}(hstruct kiocb *iocbh](j)}(hjJ,h]hstruct}(hj!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubj)}(h h]h }(hj!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubh)}(hhh]j)}(hkiocbh]hkiocb}(hj!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj!modnameN classnameNjj)}j]j!c.__generic_file_write_iterasbuh1hhj!ubj)}(h h]h }(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubjr)}(hjuh]h*}(hj"hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj!ubj)}(hiocbh]hiocb}(hj#"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj!ubj>)}(hstruct iov_iter *fromh](j)}(hjJ,h]hstruct}(hj<"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj8"ubj)}(h h]h }(hjI"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj8"ubh)}(hhh]j)}(hiov_iterh]hiov_iter}(hjZ"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjW"ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj\"modnameN classnameNjj)}j]j!c.__generic_file_write_iterasbuh1hhj8"ubj)}(h h]h }(hjx"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj8"ubjr)}(hjuh]h*}(hj"hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj8"ubj)}(hfromh]hfrom}(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj8"ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj!ubeh}(h]h ]h"]h$]h&]jjuh1j7hjv!hhhj!hMkubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjr!hhhj!hMkubah}(h]jm!ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj!hMkhjo!hhubj4)}(hhh]jM)}(hwrite data to a fileh]hwrite data to a file}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMkhj"hhubah}(h]h ]h"]h$]h&]uh1j3hjo!hhhj!hMkubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj"jHj"jIjJjKuh1hhhhjhNhNubj)}(hX@**Parameters** ``struct kiocb *iocb`` IO state structure (file, offset, etc.) ``struct iov_iter *from`` iov_iter with data to write **Description** This function does all the work needed for actually writing data to a file. It does all basic checks, removes SUID from the file, updates modification times and calls proper subroutines depending on whether we do direct IO or a standard buffered write. It expects i_rwsem to be grabbed unless we work on a block device or similar object which does not need locking at all. This function does *not* take care of syncing data in case of O_SYNC write. A caller has to handle it. This is mainly due to the fact that we want to avoid syncing under i_rwsem. **Return** * number of bytes written, even for truncated writes * negative error code if no data has been written at allh](jM)}(h**Parameters**h]j)}(hj"h]h Parameters}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj"ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMohj"ubj)}(hhh](j)}(h?``struct kiocb *iocb`` IO state structure (file, offset, etc.) h](j)}(h``struct kiocb *iocb``h]jS)}(hj"h]hstruct kiocb *iocb}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj"ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMlhj"ubj)}(hhh]jM)}(h'IO state structure (file, offset, etc.)h]h'IO state structure (file, offset, etc.)}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj#hMlhj#ubah}(h]h ]h"]h$]h&]uh1jhj"ubeh}(h]h ]h"]h$]h&]uh1jhj#hMlhj"ubj)}(h6``struct iov_iter *from`` iov_iter with data to write h](j)}(h``struct iov_iter *from``h]jS)}(hj7#h]hstruct iov_iter *from}(hj9#hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj5#ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMmhj1#ubj)}(hhh]jM)}(hiov_iter with data to writeh]hiov_iter with data to write}(hjP#hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjL#hMmhjM#ubah}(h]h ]h"]h$]h&]uh1jhj1#ubeh}(h]h ]h"]h$]h&]uh1jhjL#hMmhj"ubeh}(h]h ]h"]h$]h&]uh1jhj"ubjM)}(h**Description**h]j)}(hjr#h]h Description}(hjt#hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjp#ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMohj"ubjM)}(hThis function does all the work needed for actually writing data to a file. It does all basic checks, removes SUID from the file, updates modification times and calls proper subroutines depending on whether we do direct IO or a standard buffered write.h]hThis function does all the work needed for actually writing data to a file. It does all basic checks, removes SUID from the file, updates modification times and calls proper subroutines depending on whether we do direct IO or a standard buffered write.}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMnhj"ubjM)}(hwIt expects i_rwsem to be grabbed unless we work on a block device or similar object which does not need locking at all.h]hwIt expects i_rwsem to be grabbed unless we work on a block device or similar object which does not need locking at all.}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMshj"ubjM)}(hThis function does *not* take care of syncing data in case of O_SYNC write. A caller has to handle it. This is mainly due to the fact that we want to avoid syncing under i_rwsem.h](hThis function does }(hj#hhhNhNubj )}(h*not*h]hnot}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1j hj#ubh take care of syncing data in case of O_SYNC write. A caller has to handle it. This is mainly due to the fact that we want to avoid syncing under i_rwsem.}(hj#hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMvhj"ubjM)}(h **Return**h]j)}(hj#h]hReturn}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj#ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMzhj"ubj^)}(hhh](jc)}(h2number of bytes written, even for truncated writesh]jM)}(hj#h]h2number of bytes written, even for truncated writes}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM{hj#ubah}(h]h ]h"]h$]h&]uh1jbhj#ubjc)}(h6negative error code if no data has been written at allh]jM)}(hj#h]h6negative error code if no data has been written at all}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chM|hj#ubah}(h]h ]h"]h$]h&]uh1jbhj#ubeh}(h]h ]h"]h$]h&]jjuuh1j]hj#hM{hj"ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h$generic_file_write_iter (C function)c.generic_file_write_iterhNtauh1hhjhhhNhNubh)}(hhh](h)}(hKssize_t generic_file_write_iter (struct kiocb *iocb, struct iov_iter *from)h]h)}(hJssize_t generic_file_write_iter(struct kiocb *iocb, struct iov_iter *from)h](h)}(hhh]j)}(hssize_th]hssize_t}(hj;$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj8$ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj=$modnameN classnameNjj)}j]j)}jgeneric_file_write_itersbc.generic_file_write_iterasbuh1hhj4$hhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMubj)}(h h]h }(hj]$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4$hhhj\$hMubh)}(hgeneric_file_write_iterh]j)}(hjY$h]hgeneric_file_write_iter}(hjo$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjk$ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj4$hhhj\$hMubj8)}(h+(struct kiocb *iocb, struct iov_iter *from)h](j>)}(hstruct kiocb *iocbh](j)}(hjJ,h]hstruct}(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$ubj)}(h h]h }(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$ubh)}(hhh]j)}(hkiocbh]hkiocb}(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj$modnameN classnameNjj)}j]jW$c.generic_file_write_iterasbuh1hhj$ubj)}(h h]h }(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$ubjr)}(hjuh]h*}(hj$hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj$ubj)}(hiocbh]hiocb}(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj$ubj>)}(hstruct iov_iter *fromh](j)}(hjJ,h]hstruct}(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$ubj)}(h h]h }(hj%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$ubh)}(hhh]j)}(hiov_iterh]hiov_iter}(hj%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj%modnameN classnameNjj)}j]jW$c.generic_file_write_iterasbuh1hhj$ubj)}(h h]h }(hj6%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$ubjr)}(hjuh]h*}(hjD%hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj$ubj)}(hfromh]hfrom}(hjQ%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj$ubeh}(h]h ]h"]h$]h&]jjuh1j7hj4$hhhj\$hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj0$hhhj\$hMubah}(h]j+$ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj\$hMhj-$hhubj4)}(hhh]jM)}(hwrite data to a fileh]hwrite data to a file}(hj{%hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjx%hhubah}(h]h ]h"]h$]h&]uh1j3hj-$hhhj\$hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj%jHj%jIjJjKuh1hhhhjhNhNubj)}(hX**Parameters** ``struct kiocb *iocb`` IO state structure ``struct iov_iter *from`` iov_iter with data to write **Description** This is a wrapper around __generic_file_write_iter() to be used by most filesystems. It takes care of syncing the file in case of O_SYNC file and acquires i_rwsem as needed. **Return** * negative error code if no data has been written at all of vfs_fsync_range() failed for a synchronous write * number of bytes written, even for truncated writesh](jM)}(h**Parameters**h]j)}(hj%h]h Parameters}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj%ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhj%ubj)}(hhh](j)}(h*``struct kiocb *iocb`` IO state structure h](j)}(h``struct kiocb *iocb``h]jS)}(hj%h]hstruct kiocb *iocb}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj%ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhj%ubj)}(hhh]jM)}(hIO state structureh]hIO state structure}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj%hMhj%ubah}(h]h ]h"]h$]h&]uh1jhj%ubeh}(h]h ]h"]h$]h&]uh1jhj%hMhj%ubj)}(h6``struct iov_iter *from`` iov_iter with data to write h](j)}(h``struct iov_iter *from``h]jS)}(hj%h]hstruct iov_iter *from}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj%ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhj%ubj)}(hhh]jM)}(hiov_iter with data to writeh]hiov_iter with data to write}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj &hMhj &ubah}(h]h ]h"]h$]h&]uh1jhj%ubeh}(h]h ]h"]h$]h&]uh1jhj &hMhj%ubeh}(h]h ]h"]h$]h&]uh1jhj%ubjM)}(h**Description**h]j)}(hj0&h]h Description}(hj2&hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj.&ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhj%ubjM)}(hThis is a wrapper around __generic_file_write_iter() to be used by most filesystems. It takes care of syncing the file in case of O_SYNC file and acquires i_rwsem as needed.h]hThis is a wrapper around __generic_file_write_iter() to be used by most filesystems. It takes care of syncing the file in case of O_SYNC file and acquires i_rwsem as needed.}(hjF&hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhj%ubjM)}(h **Return**h]j)}(hjW&h]hReturn}(hjY&hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjU&ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhj%ubj^)}(hhh](jc)}(hjnegative error code if no data has been written at all of vfs_fsync_range() failed for a synchronous writeh]jM)}(hjnegative error code if no data has been written at all of vfs_fsync_range() failed for a synchronous writeh]hjnegative error code if no data has been written at all of vfs_fsync_range() failed for a synchronous write}(hjt&hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjp&ubah}(h]h ]h"]h$]h&]uh1jbhjm&ubjc)}(h2number of bytes written, even for truncated writesh]jM)}(hj&h]h2number of bytes written, even for truncated writes}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhj&ubah}(h]h ]h"]h$]h&]uh1jbhjm&ubeh}(h]h ]h"]h$]h&]jjuuh1j]hj&hMhj%ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h"filemap_release_folio (C function)c.filemap_release_foliohNtauh1hhjhhhNhNubh)}(hhh](h)}(h;bool filemap_release_folio (struct folio *folio, gfp_t gfp)h]h)}(h:bool filemap_release_folio(struct folio *folio, gfp_t gfp)h](j)}(hjh]hbool}(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&hhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMubj)}(h h]h }(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&hhhj&hMubh)}(hfilemap_release_folioh]j)}(hfilemap_release_folioh]hfilemap_release_folio}(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj&hhhj&hMubj8)}(h (struct folio *folio, gfp_t gfp)h](j>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubj)}(h h]h }(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubh)}(hhh]j)}(hfolioh]hfolio}(hj!'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj'ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj#'modnameN classnameNjj)}j]j)}jj&sbc.filemap_release_folioasbuh1hhj&ubj)}(h h]h }(hjA'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubjr)}(hjuh]h*}(hjO'hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj&ubj)}(hfolioh]hfolio}(hj\'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj&ubj>)}(h gfp_t gfph](h)}(hhh]j)}(hgfp_th]hgfp_t}(hjx'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhju'ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjz'modnameN classnameNjj)}j]j='c.filemap_release_folioasbuh1hhjq'ubj)}(h h]h }(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjq'ubj)}(hgfph]hgfp}(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjq'ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj&ubeh}(h]h ]h"]h$]h&]jjuh1j7hj&hhhj&hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj&hhhj&hMubah}(h]j&ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj&hMhj&hhubj4)}(hhh]jM)}(h(Release fs-specific metadata on a folio.h]h(Release fs-specific metadata on a folio.}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhj'hhubah}(h]h ]h"]h$]h&]uh1j3hj&hhhj&hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj'jHj'jIjJjKuh1hhhhjhNhNubj)}(hXl**Parameters** ``struct folio *folio`` The folio which the kernel is trying to free. ``gfp_t gfp`` Memory allocation flags (and I/O mode). **Description** The address_space is trying to release any data attached to a folio (presumably at folio->private). This will also be called if the private_2 flag is set on a page, indicating that the folio has other metadata associated with it. The **gfp** argument specifies whether I/O may be performed to release this page (__GFP_IO), and whether the call may block (__GFP_RECLAIM & __GFP_FS). **Return** ``true`` if the release was successful, otherwise ``false``.h](jM)}(h**Parameters**h]j)}(hj'h]h Parameters}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj'ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhj'ubj)}(hhh](j)}(hF``struct folio *folio`` The folio which the kernel is trying to free. h](j)}(h``struct folio *folio``h]jS)}(hj(h]hstruct folio *folio}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj (ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhj (ubj)}(hhh]jM)}(h-The folio which the kernel is trying to free.h]h-The folio which the kernel is trying to free.}(hj((hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj$(hMhj%(ubah}(h]h ]h"]h$]h&]uh1jhj (ubeh}(h]h ]h"]h$]h&]uh1jhj$(hMhj(ubj)}(h6``gfp_t gfp`` Memory allocation flags (and I/O mode). h](j)}(h ``gfp_t gfp``h]jS)}(hjH(h]h gfp_t gfp}(hjJ(hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjF(ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjB(ubj)}(hhh]jM)}(h'Memory allocation flags (and I/O mode).h]h'Memory allocation flags (and I/O mode).}(hja(hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj](hMhj^(ubah}(h]h ]h"]h$]h&]uh1jhjB(ubeh}(h]h ]h"]h$]h&]uh1jhj](hMhj(ubeh}(h]h ]h"]h$]h&]uh1jhj'ubjM)}(h**Description**h]j)}(hj(h]h Description}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj(ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhj'ubjM)}(hcThe address_space is trying to release any data attached to a folio (presumably at folio->private).h]hcThe address_space is trying to release any data attached to a folio (presumably at folio->private).}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhj'ubjM)}(hThis will also be called if the private_2 flag is set on a page, indicating that the folio has other metadata associated with it.h]hThis will also be called if the private_2 flag is set on a page, indicating that the folio has other metadata associated with it.}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhj'ubjM)}(hThe **gfp** argument specifies whether I/O may be performed to release this page (__GFP_IO), and whether the call may block (__GFP_RECLAIM & __GFP_FS).h](hThe }(hj(hhhNhNubj)}(h**gfp**h]hgfp}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj(ubh argument specifies whether I/O may be performed to release this page (__GFP_IO), and whether the call may block (__GFP_RECLAIM & __GFP_FS).}(hj(hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhj'ubjM)}(h **Return**h]j)}(hj(h]hReturn}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj(ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhj'ubjM)}(h<``true`` if the release was successful, otherwise ``false``.h](jS)}(h``true``h]htrue}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj(ubh* if the release was successful, otherwise }(hj(hhhNhNubjS)}(h ``false``h]hfalse}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj(ubh.}(hj(hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhj'ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h%filemap_invalidate_inode (C function)c.filemap_invalidate_inodehNtauh1hhjhhhNhNubh)}(hhh](h)}(hXint filemap_invalidate_inode (struct inode *inode, bool flush, loff_t start, loff_t end)h]h)}(hWint filemap_invalidate_inode(struct inode *inode, bool flush, loff_t start, loff_t end)h](j)}(hinth]hint}(hj?)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;)hhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMubj)}(h h]h }(hjN)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;)hhhjM)hMubh)}(hfilemap_invalidate_inodeh]j)}(hfilemap_invalidate_inodeh]hfilemap_invalidate_inode}(hj`)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\)ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj;)hhhjM)hMubj8)}(h;(struct inode *inode, bool flush, loff_t start, loff_t end)h](j>)}(hstruct inode *inodeh](j)}(hjJ,h]hstruct}(hj|)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjx)ubj)}(h h]h }(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjx)ubh)}(hhh]j)}(hinodeh]hinode}(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj)modnameN classnameNjj)}j]j)}jjb)sbc.filemap_invalidate_inodeasbuh1hhjx)ubj)}(h h]h }(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjx)ubjr)}(hjuh]h*}(hj)hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjx)ubj)}(hinodeh]hinode}(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjx)ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjt)ubj>)}(h bool flushh](j)}(hjh]hbool}(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubj)}(h h]h }(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubj)}(hflushh]hflush}(hj *hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjt)ubj>)}(h loff_t starth](h)}(hhh]j)}(hloff_th]hloff_t}(hj%*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"*ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj'*modnameN classnameNjj)}j]j)c.filemap_invalidate_inodeasbuh1hhj*ubj)}(h h]h }(hjC*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*ubj)}(hstarth]hstart}(hjQ*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjt)ubj>)}(h loff_t endh](h)}(hhh]j)}(hloff_th]hloff_t}(hjm*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjj*ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjo*modnameN classnameNjj)}j]j)c.filemap_invalidate_inodeasbuh1hhjf*ubj)}(h h]h }(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjf*ubj)}(hendh]hend}(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjf*ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjt)ubeh}(h]h ]h"]h$]h&]jjuh1j7hj;)hhhjM)hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj7)hhhjM)hMubah}(h]j2)ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjM)hMhj4)hhubj4)}(hhh]jM)}(h>Invalidate/forcibly write back a range of an inode's pagecacheh]h@Invalidate/forcibly write back a range of an inode’s pagecache}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhj*hhubah}(h]h ]h"]h$]h&]uh1j3hj4)hhhjM)hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj*jHj*jIjJjKuh1hhhhjhNhNubj)}(hX**Parameters** ``struct inode *inode`` The inode to flush ``bool flush`` Set to write back rather than simply invalidate. ``loff_t start`` First byte to in range. ``loff_t end`` Last byte in range (inclusive), or LLONG_MAX for everything from start onwards. **Description** Invalidate all the folios on an inode that contribute to the specified range, possibly writing them back first. Whilst the operation is undertaken, the invalidate lock is held to prevent new folios from being installed.h](jM)}(h**Parameters**h]j)}(hj*h]h Parameters}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj*ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhj*ubj)}(hhh](j)}(h+``struct inode *inode`` The inode to flush h](j)}(h``struct inode *inode``h]jS)}(hj+h]hstruct inode *inode}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj+ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhj*ubj)}(hhh]jM)}(hThe inode to flushh]hThe inode to flush}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj+hMhj+ubah}(h]h ]h"]h$]h&]uh1jhj*ubeh}(h]h ]h"]h$]h&]uh1jhj+hMhj*ubj)}(h@``bool flush`` Set to write back rather than simply invalidate. h](j)}(h``bool flush``h]jS)}(hj=+h]h bool flush}(hj?+hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj;+ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhj7+ubj)}(hhh]jM)}(h0Set to write back rather than simply invalidate.h]h0Set to write back rather than simply invalidate.}(hjV+hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjR+hMhjS+ubah}(h]h ]h"]h$]h&]uh1jhj7+ubeh}(h]h ]h"]h$]h&]uh1jhjR+hMhj*ubj)}(h)``loff_t start`` First byte to in range. h](j)}(h``loff_t start``h]jS)}(hjv+h]h loff_t start}(hjx+hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjt+ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhjp+ubj)}(hhh]jM)}(hFirst byte to in range.h]hFirst byte to in range.}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj+hMhj+ubah}(h]h ]h"]h$]h&]uh1jhjp+ubeh}(h]h ]h"]h$]h&]uh1jhj+hMhj*ubj)}(h_``loff_t end`` Last byte in range (inclusive), or LLONG_MAX for everything from start onwards. h](j)}(h``loff_t end``h]jS)}(hj+h]h loff_t end}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj+ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhj+ubj)}(hhh]jM)}(hOLast byte in range (inclusive), or LLONG_MAX for everything from start onwards.h]hOLast byte in range (inclusive), or LLONG_MAX for everything from start onwards.}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhj+ubah}(h]h ]h"]h$]h&]uh1jhj+ubeh}(h]h ]h"]h$]h&]uh1jhj+hMhj*ubeh}(h]h ]h"]h$]h&]uh1jhj*ubjM)}(h**Description**h]j)}(hj+h]h Description}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj+ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhj*ubjM)}(hInvalidate all the folios on an inode that contribute to the specified range, possibly writing them back first. Whilst the operation is undertaken, the invalidate lock is held to prevent new folios from being installed.h]hInvalidate all the folios on an inode that contribute to the specified range, possibly writing them back first. Whilst the operation is undertaken, the invalidate lock is held to prevent new folios from being installed.}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:73: ./mm/filemap.chMhj*ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubeh}(h]filemapah ]h"]filemapah$]h&]uh1hhjhhhhhKGubh)}(hhh](h)}(h Readaheadh]h Readahead}(hj",hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj,hhhhhKMubjM)}(hXBReadahead is used to read content into the page cache before it is explicitly requested by the application. Readahead only ever attempts to read folios that are not yet in the page cache. If a folio is present but not up-to-date, readahead will not try to read it. In that case a simple ->read_folio() will be requested.h]hXBReadahead is used to read content into the page cache before it is explicitly requested by the application. Readahead only ever attempts to read folios that are not yet in the page cache. If a folio is present but not up-to-date, readahead will not try to read it. In that case a simple ->read_folio() will be requested.}(hj0,hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:79: ./mm/readahead.chK hj,hhubjM)}(hXsReadahead is triggered when an application read request (whether a system call or a page fault) finds that the requested folio is not in the page cache, or that it is in the page cache and has the readahead flag set. This flag indicates that the folio was read as part of a previous readahead request and now that it has been accessed, it is time for the next readahead.h]hXsReadahead is triggered when an application read request (whether a system call or a page fault) finds that the requested folio is not in the page cache, or that it is in the page cache and has the readahead flag set. This flag indicates that the folio was read as part of a previous readahead request and now that it has been accessed, it is time for the next readahead.}(hj?,hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:79: ./mm/readahead.chKhj,hhubjM)}(hXEach readahead request is partly synchronous read, and partly async readahead. This is reflected in the struct file_ra_state which contains ->size being the total number of pages, and ->async_size which is the number of pages in the async section. The readahead flag will be set on the first folio in this async section to trigger a subsequent readahead. Once a series of sequential reads has been established, there should be no need for a synchronous component and all readahead request will be fully asynchronous.h]hXEach readahead request is partly synchronous read, and partly async readahead. This is reflected in the struct file_ra_state which contains ->size being the total number of pages, and ->async_size which is the number of pages in the async section. The readahead flag will be set on the first folio in this async section to trigger a subsequent readahead. Once a series of sequential reads has been established, there should be no need for a synchronous component and all readahead request will be fully asynchronous.}(hjN,hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:79: ./mm/readahead.chKhj,hhubjM)}(hWhen either of the triggers causes a readahead, three numbers need to be determined: the start of the region to read, the size of the region, and the size of the async tail.h]hWhen either of the triggers causes a readahead, three numbers need to be determined: the start of the region to read, the size of the region, and the size of the async tail.}(hj],hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:79: ./mm/readahead.chK"hj,hhubjM)}(hThe start of the region is simply the first page address at or after the accessed address, which is not currently populated in the page cache. This is found with a simple search in the page cache.h]hThe start of the region is simply the first page address at or after the accessed address, which is not currently populated in the page cache. This is found with a simple search in the page cache.}(hjl,hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:79: ./mm/readahead.chK&hj,hhubjM)}(hXAThe size of the async tail is determined by subtracting the size that was explicitly requested from the determined request size, unless this would be less than zero - then zero is used. NOTE THIS CALCULATION IS WRONG WHEN THE START OF THE REGION IS NOT THE ACCESSED PAGE. ALSO THIS CALCULATION IS NOT USED CONSISTENTLY.h]hXAThe size of the async tail is determined by subtracting the size that was explicitly requested from the determined request size, unless this would be less than zero - then zero is used. NOTE THIS CALCULATION IS WRONG WHEN THE START OF THE REGION IS NOT THE ACCESSED PAGE. ALSO THIS CALCULATION IS NOT USED CONSISTENTLY.}(hj{,hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:79: ./mm/readahead.chK*hj,hhubjM)}(hXThe size of the region is normally determined from the size of the previous readahead which loaded the preceding pages. This may be discovered from the struct file_ra_state for simple sequential reads, or from examining the state of the page cache when multiple sequential reads are interleaved. Specifically: where the readahead was triggered by the readahead flag, the size of the previous readahead is assumed to be the number of pages from the triggering page to the start of the new readahead. In these cases, the size of the previous readahead is scaled, often doubled, for the new readahead, though see get_next_ra_size() for details.h]hXThe size of the region is normally determined from the size of the previous readahead which loaded the preceding pages. This may be discovered from the struct file_ra_state for simple sequential reads, or from examining the state of the page cache when multiple sequential reads are interleaved. Specifically: where the readahead was triggered by the readahead flag, the size of the previous readahead is assumed to be the number of pages from the triggering page to the start of the new readahead. In these cases, the size of the previous readahead is scaled, often doubled, for the new readahead, though see get_next_ra_size() for details.}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:79: ./mm/readahead.chK0hj,hhubjM)}(hXgIf the size of the previous read cannot be determined, the number of preceding pages in the page cache is used to estimate the size of a previous read. This estimate could easily be misled by random reads being coincidentally adjacent, so it is ignored unless it is larger than the current request, and it is not scaled up, unless it is at the start of file.h]hXgIf the size of the previous read cannot be determined, the number of preceding pages in the page cache is used to estimate the size of a previous read. This estimate could easily be misled by random reads being coincidentally adjacent, so it is ignored unless it is larger than the current request, and it is not scaled up, unless it is at the start of file.}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:79: ./mm/readahead.chK;hj,hhubjM)}(hIn general readahead is accelerated at the start of the file, as reads from there are often sequential. There are other minor adjustments to the readahead size in various special cases and these are best discovered by reading the code.h]hIn general readahead is accelerated at the start of the file, as reads from there are often sequential. There are other minor adjustments to the readahead size in various special cases and these are best discovered by reading the code.}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:79: ./mm/readahead.chKBhj,hhubjM)}(hThe above calculation, based on the previous readahead size, determines the size of the readahead, to which any requested read size may be added.h]hThe above calculation, based on the previous readahead size, determines the size of the readahead, to which any requested read size may be added.}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:79: ./mm/readahead.chKGhj,hhubjM)}(hXReadahead requests are sent to the filesystem using the ->readahead() address space operation, for which mpage_readahead() is a canonical implementation. ->readahead() should normally initiate reads on all folios, but may fail to read any or all folios without causing an I/O error. The page cache reading code will issue a ->read_folio() request for any folio which ->readahead() did not read, and only an error from this will be final.h]hXReadahead requests are sent to the filesystem using the ->readahead() address space operation, for which mpage_readahead() is a canonical implementation. ->readahead() should normally initiate reads on all folios, but may fail to read any or all folios without causing an I/O error. The page cache reading code will issue a ->read_folio() request for any folio which ->readahead() did not read, and only an error from this will be final.}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:79: ./mm/readahead.chKKhj,hhubjM)}(h->readahead() will generally call readahead_folio() repeatedly to get each folio from those prepared for readahead. It may fail to read a folio by:h]h->readahead() will generally call readahead_folio() repeatedly to get each folio from those prepared for readahead. It may fail to read a folio by:}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:79: ./mm/readahead.chKShj,hhubj^)}(hhh](jc)}(hnot calling readahead_folio() sufficiently many times, effectively ignoring some folios, as might be appropriate if the path to storage is congested. h]jM)}(hnot calling readahead_folio() sufficiently many times, effectively ignoring some folios, as might be appropriate if the path to storage is congested.h]hnot calling readahead_folio() sufficiently many times, effectively ignoring some folios, as might be appropriate if the path to storage is congested.}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:79: ./mm/readahead.chKWhj,ubah}(h]h ]h"]h$]h&]uh1jbhj,ubjc)}(hhfailing to actually submit a read request for a given folio, possibly due to insufficient resources, or h]jM)}(hgfailing to actually submit a read request for a given folio, possibly due to insufficient resources, orh]hgfailing to actually submit a read request for a given folio, possibly due to insufficient resources, or}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:79: ./mm/readahead.chK[hj-ubah}(h]h ]h"]h$]h&]uh1jbhj,ubjc)}(hreadahead() should not fail them due to congestion or temporary resource unavailability, but should wait for necessary resources (e.g. memory or indexing information) to become available. Folios in the final ``async_size`` may be considered less urgent and failure to read them is more acceptable. In this case it is best to use filemap_remove_folio() to remove the folios from the page cache as is automatically done for folios that were not fetched with readahead_folio(). This will allow a subsequent synchronous readahead request to try them again. If they are left in the page cache, then they will be read individually using ->read_folio() which may be less efficient.h](hThose folios not in the final }(hjG-hhhNhNubjS)}(h``async_size``h]h async_size}(hjO-hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjG-ubhX  of the request should be considered to be important and ->readahead() should not fail them due to congestion or temporary resource unavailability, but should wait for necessary resources (e.g. memory or indexing information) to become available. Folios in the final }(hjG-hhhNhNubjS)}(h``async_size``h]h async_size}(hja-hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjG-ubhX may be considered less urgent and failure to read them is more acceptable. In this case it is best to use filemap_remove_folio() to remove the folios from the page cache as is automatically done for folios that were not fetched with readahead_folio(). This will allow a subsequent synchronous readahead request to try them again. If they are left in the page cache, then they will be read individually using ->read_folio() which may be less efficient.}(hjG-hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:79: ./mm/readahead.chKdhj,hhubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h$page_cache_ra_unbounded (C function)c.page_cache_ra_unboundedhNtauh1hhj,hhhNhNubh)}(hhh](h)}(hvvoid page_cache_ra_unbounded (struct readahead_control *ractl, unsigned long nr_to_read, unsigned long lookahead_size)h]h)}(huvoid page_cache_ra_unbounded(struct readahead_control *ractl, unsigned long nr_to_read, unsigned long lookahead_size)h](j)}(hvoidh]hvoid}(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-hhhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:82: ./mm/readahead.chKubj)}(h h]h }(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-hhhj-hKubh)}(hpage_cache_ra_unboundedh]j)}(hpage_cache_ra_unboundedh]hpage_cache_ra_unbounded}(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj-hhhj-hKubj8)}(hY(struct readahead_control *ractl, unsigned long nr_to_read, unsigned long lookahead_size)h](j>)}(hstruct readahead_control *ractlh](j)}(hjJ,h]hstruct}(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-ubj)}(h h]h }(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-ubh)}(hhh]j)}(hreadahead_controlh]hreadahead_control}(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj-modnameN classnameNjj)}j]j)}jj-sbc.page_cache_ra_unboundedasbuh1hhj-ubj)}(h h]h }(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-ubjr)}(hjuh]h*}(hj.hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj-ubj)}(hractlh]hractl}(hj).hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj-ubj>)}(hunsigned long nr_to_readh](j)}(hunsignedh]hunsigned}(hjB.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>.ubj)}(h h]h }(hjP.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>.ubj)}(hlongh]hlong}(hj^.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>.ubj)}(h h]h }(hjl.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>.ubj)}(h nr_to_readh]h nr_to_read}(hjz.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>.ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj-ubj>)}(hunsigned long lookahead_sizeh](j)}(hunsignedh]hunsigned}(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj.ubj)}(h h]h }(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj.ubj)}(hlongh]hlong}(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj.ubj)}(h h]h }(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj.ubj)}(hlookahead_sizeh]hlookahead_size}(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj.ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj-ubeh}(h]h ]h"]h$]h&]jjuh1j7hj-hhhj-hKubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj-hhhj-hKubah}(h]j-ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj-hKhj-hhubj4)}(hhh]jM)}(hStart unchecked readahead.h]hStart unchecked readahead.}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:82: ./mm/readahead.chKhj.hhubah}(h]h ]h"]h$]h&]uh1j3hj-hhhj-hKubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj /jHj /jIjJjKuh1hhhhj,hNhNubj)}(hX**Parameters** ``struct readahead_control *ractl`` Readahead control. ``unsigned long nr_to_read`` The number of pages to read. ``unsigned long lookahead_size`` Where to start the next readahead. **Description** This function is for filesystems to call when they want to start readahead beyond a file's stated i_size. This is almost certainly not the function you want to call. Use page_cache_async_readahead() or page_cache_sync_readahead() instead. **Context** File is referenced by caller, and ractl->mapping->invalidate_lock must be held by the caller at least in shared mode. Mutexes may be held by caller. May sleep, but will not reenter filesystem to reclaim memory.h](jM)}(h**Parameters**h]j)}(hj/h]h Parameters}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj/ubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:82: ./mm/readahead.chKhj/ubj)}(hhh](j)}(h7``struct readahead_control *ractl`` Readahead control. h](j)}(h#``struct readahead_control *ractl``h]jS)}(hj6/h]hstruct readahead_control *ractl}(hj8/hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj4/ubah}(h]h ]h"]h$]h&]uh1jhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:82: ./mm/readahead.chKhj0/ubj)}(hhh]jM)}(hReadahead control.h]hReadahead control.}(hjO/hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjK/hKhjL/ubah}(h]h ]h"]h$]h&]uh1jhj0/ubeh}(h]h ]h"]h$]h&]uh1jhjK/hKhj-/ubj)}(h:``unsigned long nr_to_read`` The number of pages to read. h](j)}(h``unsigned long nr_to_read``h]jS)}(hjo/h]hunsigned long nr_to_read}(hjq/hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjm/ubah}(h]h ]h"]h$]h&]uh1jhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:82: ./mm/readahead.chKhji/ubj)}(hhh]jM)}(hThe number of pages to read.h]hThe number of pages to read.}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj/hKhj/ubah}(h]h ]h"]h$]h&]uh1jhji/ubeh}(h]h ]h"]h$]h&]uh1jhj/hKhj-/ubj)}(hD``unsigned long lookahead_size`` Where to start the next readahead. h](j)}(h ``unsigned long lookahead_size``h]jS)}(hj/h]hunsigned long lookahead_size}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj/ubah}(h]h ]h"]h$]h&]uh1jhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:82: ./mm/readahead.chKhj/ubj)}(hhh]jM)}(h"Where to start the next readahead.h]h"Where to start the next readahead.}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj/hKhj/ubah}(h]h ]h"]h$]h&]uh1jhj/ubeh}(h]h ]h"]h$]h&]uh1jhj/hKhj-/ubeh}(h]h ]h"]h$]h&]uh1jhj/ubjM)}(h**Description**h]j)}(hj/h]h Description}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj/ubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:82: ./mm/readahead.chKhj/ubjM)}(hThis function is for filesystems to call when they want to start readahead beyond a file's stated i_size. This is almost certainly not the function you want to call. Use page_cache_async_readahead() or page_cache_sync_readahead() instead.h]hThis function is for filesystems to call when they want to start readahead beyond a file’s stated i_size. This is almost certainly not the function you want to call. Use page_cache_async_readahead() or page_cache_sync_readahead() instead.}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:82: ./mm/readahead.chKhj/ubjM)}(h **Context**h]j)}(hj 0h]hContext}(hj 0hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj0ubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:82: ./mm/readahead.chKhj/ubjM)}(hFile is referenced by caller, and ractl->mapping->invalidate_lock must be held by the caller at least in shared mode. Mutexes may be held by caller. May sleep, but will not reenter filesystem to reclaim memory.h]hFile is referenced by caller, and ractl->mapping->invalidate_lock must be held by the caller at least in shared mode. Mutexes may be held by caller. May sleep, but will not reenter filesystem to reclaim memory.}(hj 0hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:82: ./mm/readahead.chKhj/ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj,hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hreadahead_expand (C function)c.readahead_expandhNtauh1hhj,hhhNhNubh)}(hhh](h)}(hYvoid readahead_expand (struct readahead_control *ractl, loff_t new_start, size_t new_len)h]h)}(hXvoid readahead_expand(struct readahead_control *ractl, loff_t new_start, size_t new_len)h](j)}(hvoidh]hvoid}(hjO0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjK0hhhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:82: ./mm/readahead.chMubj)}(h h]h }(hj^0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjK0hhhj]0hMubh)}(hreadahead_expandh]j)}(hreadahead_expandh]hreadahead_expand}(hjp0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjl0ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjK0hhhj]0hMubj8)}(hC(struct readahead_control *ractl, loff_t new_start, size_t new_len)h](j>)}(hstruct readahead_control *ractlh](j)}(hjJ,h]hstruct}(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubj)}(h h]h }(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubh)}(hhh]j)}(hreadahead_controlh]hreadahead_control}(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj0modnameN classnameNjj)}j]j)}jjr0sbc.readahead_expandasbuh1hhj0ubj)}(h h]h }(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubjr)}(hjuh]h*}(hj0hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj0ubj)}(hractlh]hractl}(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj0ubj>)}(hloff_t new_starth](h)}(hhh]j)}(hloff_th]hloff_t}(hj1hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj1modnameN classnameNjj)}j]j0c.readahead_expandasbuh1hhj0ubj)}(h h]h }(hj1hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubj)}(h new_starth]h new_start}(hj-1hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj0ubj>)}(hsize_t new_lenh](h)}(hhh]j)}(hsize_th]hsize_t}(hjI1hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjF1ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjK1modnameN classnameNjj)}j]j0c.readahead_expandasbuh1hhjB1ubj)}(h h]h }(hjg1hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjB1ubj)}(hnew_lenh]hnew_len}(hju1hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjB1ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj0ubeh}(h]h ]h"]h$]h&]jjuh1j7hjK0hhhj]0hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjG0hhhj]0hMubah}(h]jB0ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj]0hMhjD0hhubj4)}(hhh]jM)}(hExpand a readahead requesth]hExpand a readahead request}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:82: ./mm/readahead.chMhj1hhubah}(h]h ]h"]h$]h&]uh1j3hjD0hhhj]0hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj1jHj1jIjJjKuh1hhhhj,hNhNubj)}(hX**Parameters** ``struct readahead_control *ractl`` The request to be expanded ``loff_t new_start`` The revised start ``size_t new_len`` The revised size of the request **Description** Attempt to expand a readahead request outwards from the current size to the specified size by inserting locked pages before and after the current window to increase the size to the new window. This may involve the insertion of THPs, in which case the window may get expanded even beyond what was requested. The algorithm will stop if it encounters a conflicting page already in the pagecache and leave a smaller expansion than requested. The caller must check for this by examining the revised **ractl** object for a different expansion than was requested.h](jM)}(h**Parameters**h]j)}(hj1h]h Parameters}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj1ubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:82: ./mm/readahead.chMhj1ubj)}(hhh](j)}(h?``struct readahead_control *ractl`` The request to be expanded h](j)}(h#``struct readahead_control *ractl``h]jS)}(hj1h]hstruct readahead_control *ractl}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj1ubah}(h]h ]h"]h$]h&]uh1jhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:82: ./mm/readahead.chMhj1ubj)}(hhh]jM)}(hThe request to be expandedh]hThe request to be expanded}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj1hMhj1ubah}(h]h ]h"]h$]h&]uh1jhj1ubeh}(h]h ]h"]h$]h&]uh1jhj1hMhj1ubj)}(h'``loff_t new_start`` The revised start h](j)}(h``loff_t new_start``h]jS)}(hj2h]hloff_t new_start}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj2ubah}(h]h ]h"]h$]h&]uh1jhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:82: ./mm/readahead.chMhj2ubj)}(hhh]jM)}(hThe revised starth]hThe revised start}(hj22hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj.2hMhj/2ubah}(h]h ]h"]h$]h&]uh1jhj2ubeh}(h]h ]h"]h$]h&]uh1jhj.2hMhj1ubj)}(h3``size_t new_len`` The revised size of the request h](j)}(h``size_t new_len``h]jS)}(hjR2h]hsize_t new_len}(hjT2hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjP2ubah}(h]h ]h"]h$]h&]uh1jhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:82: ./mm/readahead.chMhjL2ubj)}(hhh]jM)}(hThe revised size of the requesth]hThe revised size of the request}(hjk2hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjg2hMhjh2ubah}(h]h ]h"]h$]h&]uh1jhjL2ubeh}(h]h ]h"]h$]h&]uh1jhjg2hMhj1ubeh}(h]h ]h"]h$]h&]uh1jhj1ubjM)}(h**Description**h]j)}(hj2h]h Description}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj2ubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:82: ./mm/readahead.chMhj1ubjM)}(hX3Attempt to expand a readahead request outwards from the current size to the specified size by inserting locked pages before and after the current window to increase the size to the new window. This may involve the insertion of THPs, in which case the window may get expanded even beyond what was requested.h]hX3Attempt to expand a readahead request outwards from the current size to the specified size by inserting locked pages before and after the current window to increase the size to the new window. This may involve the insertion of THPs, in which case the window may get expanded even beyond what was requested.}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:82: ./mm/readahead.chMhj1ubjM)}(hThe algorithm will stop if it encounters a conflicting page already in the pagecache and leave a smaller expansion than requested.h]hThe algorithm will stop if it encounters a conflicting page already in the pagecache and leave a smaller expansion than requested.}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:82: ./mm/readahead.chM hj1ubjM)}(hvThe caller must check for this by examining the revised **ractl** object for a different expansion than was requested.h](h8The caller must check for this by examining the revised }(hj2hhhNhNubj)}(h **ractl**h]hractl}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj2ubh5 object for a different expansion than was requested.}(hj2hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:82: ./mm/readahead.chMhj1ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj,hhhNhNubeh}(h] readaheadah ]h"] readaheadah$]h&]uh1hhjhhhhhKMubh)}(hhh](h)}(h Writebackh]h Writeback}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj2hhhhhKVubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h#wb_domain_size_changed (C function)c.wb_domain_size_changedhNtauh1hhj2hhhNhNubh)}(hhh](h)}(h3void wb_domain_size_changed (struct wb_domain *dom)h]h)}(h2void wb_domain_size_changed(struct wb_domain *dom)h](j)}(hvoidh]hvoid}(hj3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3hhhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:88: ./include/linux/writeback.hhKubj)}(h h]h }(hj*3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3hhhj)3hKubh)}(hwb_domain_size_changedh]j)}(hwb_domain_size_changedh]hwb_domain_size_changed}(hj<3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj83ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj3hhhj)3hKubj8)}(h(struct wb_domain *dom)h]j>)}(hstruct wb_domain *domh](j)}(hjJ,h]hstruct}(hjX3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjT3ubj)}(h h]h }(hje3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjT3ubh)}(hhh]j)}(h wb_domainh]h wb_domain}(hjv3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjs3ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjx3modnameN classnameNjj)}j]j)}jj>3sbc.wb_domain_size_changedasbuh1hhjT3ubj)}(h h]h }(hj3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjT3ubjr)}(hjuh]h*}(hj3hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjT3ubj)}(hdomh]hdom}(hj3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjT3ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjP3ubah}(h]h ]h"]h$]h&]jjuh1j7hj3hhhj)3hKubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj3hhhj)3hKubah}(h]j3ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj)3hKhj3hhubj4)}(hhh]jM)}(h+memory available to a wb_domain has changedh]h+memory available to a wb_domain has changed}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:88: ./include/linux/writeback.hhKhj3hhubah}(h]h ]h"]h$]h&]uh1j3hj3hhhj)3hKubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj3jHj3jIjJjKuh1hhhhj2hNhNubj)}(hX**Parameters** ``struct wb_domain *dom`` wb_domain of interest **Description** This function should be called when the amount of memory available to **dom** has changed. It resets **dom**'s dirty limit parameters to prevent the past values which don't match the current configuration from skewing dirty throttling. Without this, when memory size of a wb_domain is greatly reduced, the dirty throttling logic may allow too many pages to be dirtied leading to consecutive unnecessary OOMs and may get stuck in that situation.h](jM)}(h**Parameters**h]j)}(hj3h]h Parameters}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj3ubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:88: ./include/linux/writeback.hhKhj3ubj)}(hhh]j)}(h0``struct wb_domain *dom`` wb_domain of interest h](j)}(h``struct wb_domain *dom``h]jS)}(hj4h]hstruct wb_domain *dom}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj4ubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:88: ./include/linux/writeback.hhKhj4ubj)}(hhh]jM)}(hwb_domain of interesth]hwb_domain of interest}(hj54hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj14hKhj24ubah}(h]h ]h"]h$]h&]uh1jhj4ubeh}(h]h ]h"]h$]h&]uh1jhj14hKhj4ubah}(h]h ]h"]h$]h&]uh1jhj3ubjM)}(h**Description**h]j)}(hjW4h]h Description}(hjY4hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjU4ubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:88: ./include/linux/writeback.hhKhj3ubjM)}(hXThis function should be called when the amount of memory available to **dom** has changed. It resets **dom**'s dirty limit parameters to prevent the past values which don't match the current configuration from skewing dirty throttling. Without this, when memory size of a wb_domain is greatly reduced, the dirty throttling logic may allow too many pages to be dirtied leading to consecutive unnecessary OOMs and may get stuck in that situation.h](hFThis function should be called when the amount of memory available to }(hjm4hhhNhNubj)}(h**dom**h]hdom}(hju4hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjm4ubh has changed. It resets }(hjm4hhhNhNubj)}(h**dom**h]hdom}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjm4ubhXU’s dirty limit parameters to prevent the past values which don’t match the current configuration from skewing dirty throttling. Without this, when memory size of a wb_domain is greatly reduced, the dirty throttling logic may allow too many pages to be dirtied leading to consecutive unnecessary OOMs and may get stuck in that situation.}(hjm4hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:88: ./include/linux/writeback.hhKhj3ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj2hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hinode_attach_wb (C function)c.inode_attach_wbhNtauh1hhj2hhhNhNubh)}(hhh](h)}(h?void inode_attach_wb (struct inode *inode, struct folio *folio)h]h)}(h>void inode_attach_wb(struct inode *inode, struct folio *folio)h](j)}(hvoidh]hvoid}(hj4hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4hhhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:88: ./include/linux/writeback.hhKubj)}(h h]h }(hj4hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4hhhj4hKubh)}(hinode_attach_wbh]j)}(hinode_attach_wbh]hinode_attach_wb}(hj4hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj4hhhj4hKubj8)}(h*(struct inode *inode, struct folio *folio)h](j>)}(hstruct inode *inodeh](j)}(hjJ,h]hstruct}(hj4hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4ubj)}(h h]h }(hj 5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4ubh)}(hhh]j)}(hinodeh]hinode}(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj5modnameN classnameNjj)}j]j)}jj4sbc.inode_attach_wbasbuh1hhj4ubj)}(h h]h }(hj;5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4ubjr)}(hjuh]h*}(hjI5hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj4ubj)}(hinodeh]hinode}(hjV5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj4ubj>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hjo5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjk5ubj)}(h h]h }(hj|5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjk5ubh)}(hhh]j)}(hfolioh]hfolio}(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj5modnameN classnameNjj)}j]j75c.inode_attach_wbasbuh1hhjk5ubj)}(h h]h }(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjk5ubjr)}(hjuh]h*}(hj5hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjk5ubj)}(hfolioh]hfolio}(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjk5ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj4ubeh}(h]h ]h"]h$]h&]jjuh1j7hj4hhhj4hKubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj4hhhj4hKubah}(h]j4ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj4hKhj4hhubj4)}(hhh]jM)}(hassociate an inode with its wbh]hassociate an inode with its wb}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:88: ./include/linux/writeback.hhKhj5hhubah}(h]h ]h"]h$]h&]uh1j3hj4hhhj4hKubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj6jHj6jIjJjKuh1hhhhj2hNhNubj)}(hX8**Parameters** ``struct inode *inode`` inode of interest ``struct folio *folio`` folio being dirtied (may be NULL) **Description** If **inode** doesn't have its wb, associate it with the wb matching the memcg of **folio** or, if **folio** is NULL, ``current``. May be called w/ or w/o **inode->i_lock**.h](jM)}(h**Parameters**h]j)}(hj6h]h Parameters}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj6ubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:88: ./include/linux/writeback.hhKhj 6ubj)}(hhh](j)}(h*``struct inode *inode`` inode of interest h](j)}(h``struct inode *inode``h]jS)}(hj16h]hstruct inode *inode}(hj36hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj/6ubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:88: ./include/linux/writeback.hhKhj+6ubj)}(hhh]jM)}(hinode of interesth]hinode of interest}(hjJ6hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjF6hKhjG6ubah}(h]h ]h"]h$]h&]uh1jhj+6ubeh}(h]h ]h"]h$]h&]uh1jhjF6hKhj(6ubj)}(h:``struct folio *folio`` folio being dirtied (may be NULL) h](j)}(h``struct folio *folio``h]jS)}(hjj6h]hstruct folio *folio}(hjl6hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjh6ubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:88: ./include/linux/writeback.hhKhjd6ubj)}(hhh]jM)}(h!folio being dirtied (may be NULL)h]h!folio being dirtied (may be NULL)}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj6hKhj6ubah}(h]h ]h"]h$]h&]uh1jhjd6ubeh}(h]h ]h"]h$]h&]uh1jhj6hKhj(6ubeh}(h]h ]h"]h$]h&]uh1jhj 6ubjM)}(h**Description**h]j)}(hj6h]h Description}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj6ubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:88: ./include/linux/writeback.hhKhj 6ubjM)}(hIf **inode** doesn't have its wb, associate it with the wb matching the memcg of **folio** or, if **folio** is NULL, ``current``. May be called w/ or w/o **inode->i_lock**.h](hIf }(hj6hhhNhNubj)}(h **inode**h]hinode}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj6ubhG doesn’t have its wb, associate it with the wb matching the memcg of }(hj6hhhNhNubj)}(h **folio**h]hfolio}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj6ubh or, if }(hj6hhhNhNubj)}(h **folio**h]hfolio}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj6ubh is NULL, }(hj6hhhNhNubjS)}(h ``current``h]hcurrent}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj6ubh. May be called w/ or w/o }(hj6hhhNhNubj)}(h**inode->i_lock**h]h inode->i_lock}(hj 7hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj6ubh.}(hj6hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:88: ./include/linux/writeback.hhKhj 6ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj2hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hinode_detach_wb (C function)c.inode_detach_wbhNtauh1hhj2hhhNhNubh)}(hhh](h)}(h*void inode_detach_wb (struct inode *inode)h]h)}(h)void inode_detach_wb(struct inode *inode)h](j)}(hvoidh]hvoid}(hjD7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@7hhhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:88: ./include/linux/writeback.hhKubj)}(h h]h }(hjS7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@7hhhjR7hKubh)}(hinode_detach_wbh]j)}(hinode_detach_wbh]hinode_detach_wb}(hje7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhja7ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj@7hhhjR7hKubj8)}(h(struct inode *inode)h]j>)}(hstruct inode *inodeh](j)}(hjJ,h]hstruct}(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj}7ubj)}(h h]h }(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj}7ubh)}(hhh]j)}(hinodeh]hinode}(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj7modnameN classnameNjj)}j]j)}jjg7sbc.inode_detach_wbasbuh1hhj}7ubj)}(h h]h }(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj}7ubjr)}(hjuh]h*}(hj7hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj}7ubj)}(hinodeh]hinode}(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj}7ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjy7ubah}(h]h ]h"]h$]h&]jjuh1j7hj@7hhhjR7hKubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj<7hhhjR7hKubah}(h]j77ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjR7hKhj97hhubj4)}(hhh]jM)}(h!disassociate an inode from its wbh]h!disassociate an inode from its wb}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:88: ./include/linux/writeback.hhKhj8hhubah}(h]h ]h"]h$]h&]uh1j3hj97hhhjR7hKubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj8jHj8jIjJjKuh1hhhhj2hNhNubj)}(h|**Parameters** ``struct inode *inode`` inode of interest **Description** **inode** is being freed. Detach from its wb.h](jM)}(h**Parameters**h]j)}(hj&8h]h Parameters}(hj(8hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj$8ubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:88: ./include/linux/writeback.hhKhj 8ubj)}(hhh]j)}(h*``struct inode *inode`` inode of interest h](j)}(h``struct inode *inode``h]jS)}(hjE8h]hstruct inode *inode}(hjG8hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjC8ubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:88: ./include/linux/writeback.hhKhj?8ubj)}(hhh]jM)}(hinode of interesth]hinode of interest}(hj^8hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjZ8hKhj[8ubah}(h]h ]h"]h$]h&]uh1jhj?8ubeh}(h]h ]h"]h$]h&]uh1jhjZ8hKhj<8ubah}(h]h ]h"]h$]h&]uh1jhj 8ubjM)}(h**Description**h]j)}(hj8h]h Description}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj~8ubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:88: ./include/linux/writeback.hhKhj 8ubjM)}(h.**inode** is being freed. Detach from its wb.h](j)}(h **inode**h]hinode}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj8ubh% is being freed. Detach from its wb.}(hj8hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:88: ./include/linux/writeback.hhKhj 8ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj2hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hwbc_init_bio (C function)c.wbc_init_biohNtauh1hhj2hhhNhNubh)}(hhh](h)}(hBvoid wbc_init_bio (struct writeback_control *wbc, struct bio *bio)h]h)}(hAvoid wbc_init_bio(struct writeback_control *wbc, struct bio *bio)h](j)}(hvoidh]hvoid}(hj8hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj8hhhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:88: ./include/linux/writeback.hhKubj)}(h h]h }(hj8hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj8hhhj8hKubh)}(h wbc_init_bioh]j)}(h wbc_init_bioh]h wbc_init_bio}(hj8hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj8ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj8hhhj8hKubj8)}(h0(struct writeback_control *wbc, struct bio *bio)h](j>)}(hstruct writeback_control *wbch](j)}(hjJ,h]hstruct}(hj9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj 9ubj)}(h h]h }(hj9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj 9ubh)}(hhh]j)}(hwriteback_controlh]hwriteback_control}(hj.9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+9ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj09modnameN classnameNjj)}j]j)}jj8sbc.wbc_init_bioasbuh1hhj 9ubj)}(h h]h }(hjN9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj 9ubjr)}(hjuh]h*}(hj\9hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj 9ubj)}(hwbch]hwbc}(hji9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj 9ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj9ubj>)}(hstruct bio *bioh](j)}(hjJ,h]hstruct}(hj9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~9ubj)}(h h]h }(hj9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~9ubh)}(hhh]j)}(hbioh]hbio}(hj9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj9modnameN classnameNjj)}j]jJ9c.wbc_init_bioasbuh1hhj~9ubj)}(h h]h }(hj9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~9ubjr)}(hjuh]h*}(hj9hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj~9ubj)}(hbioh]hbio}(hj9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~9ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj9ubeh}(h]h ]h"]h$]h&]jjuh1j7hj8hhhj8hKubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj8hhhj8hKubah}(h]j8ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj8hKhj8hhubj4)}(hhh]jM)}(h(writeback specific initialization of bioh]h(writeback specific initialization of bio}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:88: ./include/linux/writeback.hhKhj:hhubah}(h]h ]h"]h$]h&]uh1j3hj8hhhj8hKubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj:jHj:jIjJjKuh1hhhhj2hNhNubj)}(hX**Parameters** ``struct writeback_control *wbc`` writeback_control for the writeback in progress ``struct bio *bio`` bio to be initialized **Description** **bio** is a part of the writeback in progress controlled by **wbc**. Perform writeback specific initialization. This is used to apply the cgroup writeback context. Must be called after the bio has been associated with a device.h](jM)}(h**Parameters**h]j)}(hj%:h]h Parameters}(hj':hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj#:ubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:88: ./include/linux/writeback.hhKhj:ubj)}(hhh](j)}(hR``struct writeback_control *wbc`` writeback_control for the writeback in progress h](j)}(h!``struct writeback_control *wbc``h]jS)}(hjD:h]hstruct writeback_control *wbc}(hjF:hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjB:ubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:88: ./include/linux/writeback.hhKhj>:ubj)}(hhh]jM)}(h/writeback_control for the writeback in progressh]h/writeback_control for the writeback in progress}(hj]:hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjY:hKhjZ:ubah}(h]h ]h"]h$]h&]uh1jhj>:ubeh}(h]h ]h"]h$]h&]uh1jhjY:hKhj;:ubj)}(h*``struct bio *bio`` bio to be initialized h](j)}(h``struct bio *bio``h]jS)}(hj}:h]hstruct bio *bio}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj{:ubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:88: ./include/linux/writeback.hhKhjw:ubj)}(hhh]jM)}(hbio to be initializedh]hbio to be initialized}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj:hKhj:ubah}(h]h ]h"]h$]h&]uh1jhjw:ubeh}(h]h ]h"]h$]h&]uh1jhj:hKhj;:ubeh}(h]h ]h"]h$]h&]uh1jhj:ubjM)}(h**Description**h]j)}(hj:h]h Description}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj:ubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:88: ./include/linux/writeback.hhKhj:ubjM)}(h**bio** is a part of the writeback in progress controlled by **wbc**. Perform writeback specific initialization. This is used to apply the cgroup writeback context. Must be called after the bio has been associated with a device.h](j)}(h**bio**h]hbio}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj:ubh6 is a part of the writeback in progress controlled by }(hj:hhhNhNubj)}(h**wbc**h]hwbc}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj:ubh. Perform writeback specific initialization. This is used to apply the cgroup writeback context. Must be called after the bio has been associated with a device.}(hj:hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:88: ./include/linux/writeback.hhKhj:ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj2hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entriesc](h2balance_dirty_pages_ratelimited_flags (C function)'c.balance_dirty_pages_ratelimited_flagshNtauh1hhj2hhhNhNubh)}(hhh](h)}(h]int balance_dirty_pages_ratelimited_flags (struct address_space *mapping, unsigned int flags)h]h)}(h\int balance_dirty_pages_ratelimited_flags(struct address_space *mapping, unsigned int flags)h](j)}(hinth]hint}(hj;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;hhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chMubj)}(h h]h }(hj,;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;hhhj+;hMubh)}(h%balance_dirty_pages_ratelimited_flagsh]j)}(h%balance_dirty_pages_ratelimited_flagsh]h%balance_dirty_pages_ratelimited_flags}(hj>;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:;ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj;hhhj+;hMubj8)}(h3(struct address_space *mapping, unsigned int flags)h](j>)}(hstruct address_space *mappingh](j)}(hjJ,h]hstruct}(hjZ;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjV;ubj)}(h h]h }(hjg;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjV;ubh)}(hhh]j)}(h address_spaceh]h address_space}(hjx;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhju;ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjz;modnameN classnameNjj)}j]j)}jj@;sb'c.balance_dirty_pages_ratelimited_flagsasbuh1hhjV;ubj)}(h h]h }(hj;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjV;ubjr)}(hjuh]h*}(hj;hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjV;ubj)}(hmappingh]hmapping}(hj;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjV;ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjR;ubj>)}(hunsigned int flagsh](j)}(hunsignedh]hunsigned}(hj;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;ubj)}(h h]h }(hj;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;ubj)}(hinth]hint}(hj;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;ubj)}(h h]h }(hj;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;ubj)}(hflagsh]hflags}(hj<hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjR;ubeh}(h]h ]h"]h$]h&]jjuh1j7hj;hhhj+;hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj;hhhj+;hMubah}(h]j;ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj+;hMhj;hhubj4)}(hhh]jM)}(hBalance dirty memory state.h]hBalance dirty memory state.}(hj.<hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chMhj+<hhubah}(h]h ]h"]h$]h&]uh1j3hj;hhhj+;hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjF<jHjF<jIjJjKuh1hhhhj2hNhNubj)}(hX**Parameters** ``struct address_space *mapping`` address_space which was dirtied. ``unsigned int flags`` BDP flags. **Description** Processes which are dirtying memory should call in here once for each page which was newly dirtied. The function will periodically check the system's dirty state and will initiate writeback if needed. See balance_dirty_pages_ratelimited() for details. **Return** If **flags** contains BDP_ASYNC, it may return -EAGAIN to indicate that memory is out of balance and the caller must wait for I/O to complete. Otherwise, it will return 0 to indicate that either memory was already in balance, or it was able to sleep until the amount of dirty memory returned to balance.h](jM)}(h**Parameters**h]j)}(hjP<h]h Parameters}(hjR<hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjN<ubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chMhjJ<ubj)}(hhh](j)}(hC``struct address_space *mapping`` address_space which was dirtied. h](j)}(h!``struct address_space *mapping``h]jS)}(hjo<h]hstruct address_space *mapping}(hjq<hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjm<ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chMhji<ubj)}(hhh]jM)}(h address_space which was dirtied.h]h address_space which was dirtied.}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj<hMhj<ubah}(h]h ]h"]h$]h&]uh1jhji<ubeh}(h]h ]h"]h$]h&]uh1jhj<hMhjf<ubj)}(h"``unsigned int flags`` BDP flags. h](j)}(h``unsigned int flags``h]jS)}(hj<h]hunsigned int flags}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj<ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chMhj<ubj)}(hhh]jM)}(h BDP flags.h]h BDP flags.}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj<hMhj<ubah}(h]h ]h"]h$]h&]uh1jhj<ubeh}(h]h ]h"]h$]h&]uh1jhj<hMhjf<ubeh}(h]h ]h"]h$]h&]uh1jhjJ<ubjM)}(h**Description**h]j)}(hj<h]h Description}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj<ubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chMhjJ<ubjM)}(hProcesses which are dirtying memory should call in here once for each page which was newly dirtied. The function will periodically check the system's dirty state and will initiate writeback if needed.h]hProcesses which are dirtying memory should call in here once for each page which was newly dirtied. The function will periodically check the system’s dirty state and will initiate writeback if needed.}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chMhjJ<ubjM)}(h2See balance_dirty_pages_ratelimited() for details.h]h2See balance_dirty_pages_ratelimited() for details.}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chMhjJ<ubjM)}(h **Return**h]j)}(hj=h]hReturn}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj=ubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chMhjJ<ubjM)}(hX0If **flags** contains BDP_ASYNC, it may return -EAGAIN to indicate that memory is out of balance and the caller must wait for I/O to complete. Otherwise, it will return 0 to indicate that either memory was already in balance, or it was able to sleep until the amount of dirty memory returned to balance.h](hIf }(hj/=hhhNhNubj)}(h **flags**h]hflags}(hj7=hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj/=ubhX$ contains BDP_ASYNC, it may return -EAGAIN to indicate that memory is out of balance and the caller must wait for I/O to complete. Otherwise, it will return 0 to indicate that either memory was already in balance, or it was able to sleep until the amount of dirty memory returned to balance.}(hj/=hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chMhjJ<ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj2hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h,balance_dirty_pages_ratelimited (C function)!c.balance_dirty_pages_ratelimitedhNtauh1hhj2hhhNhNubh)}(hhh](h)}(hDvoid balance_dirty_pages_ratelimited (struct address_space *mapping)h]h)}(hCvoid balance_dirty_pages_ratelimited(struct address_space *mapping)h](j)}(hvoidh]hvoid}(hjp=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjl=hhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM)ubj)}(h h]h }(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjl=hhhj~=hM)ubh)}(hbalance_dirty_pages_ratelimitedh]j)}(hbalance_dirty_pages_ratelimitedh]hbalance_dirty_pages_ratelimited}(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjl=hhhj~=hM)ubj8)}(h(struct address_space *mapping)h]j>)}(hstruct address_space *mappingh](j)}(hjJ,h]hstruct}(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=ubj)}(h h]h }(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=ubh)}(hhh]j)}(h address_spaceh]h address_space}(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj=modnameN classnameNjj)}j]j)}jj=sb!c.balance_dirty_pages_ratelimitedasbuh1hhj=ubj)}(h h]h }(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=ubjr)}(hjuh]h*}(hj=hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj=ubj)}(hmappingh]hmapping}(hj>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj=ubah}(h]h ]h"]h$]h&]jjuh1j7hjl=hhhj~=hM)ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjh=hhhj~=hM)ubah}(h]jc=ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj~=hM)hje=hhubj4)}(hhh]jM)}(hbalance dirty memory state.h]hbalance dirty memory state.}(hj0>hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM)hj->hhubah}(h]h ]h"]h$]h&]uh1j3hje=hhhj~=hM)ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjH>jHjH>jIjJjKuh1hhhhj2hNhNubj)}(hX**Parameters** ``struct address_space *mapping`` address_space which was dirtied. **Description** Processes which are dirtying memory should call in here once for each page which was newly dirtied. The function will periodically check the system's dirty state and will initiate writeback if needed. Once we're over the dirty memory limit we decrease the ratelimiting by a lot, to prevent individual processes from overshooting the limit by (ratelimit_pages) each.h](jM)}(h**Parameters**h]j)}(hjR>h]h Parameters}(hjT>hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjP>ubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM-hjL>ubj)}(hhh]j)}(hC``struct address_space *mapping`` address_space which was dirtied. h](j)}(h!``struct address_space *mapping``h]jS)}(hjq>h]hstruct address_space *mapping}(hjs>hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjo>ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM*hjk>ubj)}(hhh]jM)}(h address_space which was dirtied.h]h address_space which was dirtied.}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj>hM*hj>ubah}(h]h ]h"]h$]h&]uh1jhjk>ubeh}(h]h ]h"]h$]h&]uh1jhj>hM*hjh>ubah}(h]h ]h"]h$]h&]uh1jhjL>ubjM)}(h**Description**h]j)}(hj>h]h Description}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj>ubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM,hjL>ubjM)}(hProcesses which are dirtying memory should call in here once for each page which was newly dirtied. The function will periodically check the system's dirty state and will initiate writeback if needed.h]hProcesses which are dirtying memory should call in here once for each page which was newly dirtied. The function will periodically check the system’s dirty state and will initiate writeback if needed.}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM+hjL>ubjM)}(hOnce we're over the dirty memory limit we decrease the ratelimiting by a lot, to prevent individual processes from overshooting the limit by (ratelimit_pages) each.h]hOnce we’re over the dirty memory limit we decrease the ratelimiting by a lot, to prevent individual processes from overshooting the limit by (ratelimit_pages) each.}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM/hjL>ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj2hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h$tag_pages_for_writeback (C function)c.tag_pages_for_writebackhNtauh1hhj2hhhNhNubh)}(hhh](h)}(hXvoid tag_pages_for_writeback (struct address_space *mapping, pgoff_t start, pgoff_t end)h]h)}(hWvoid tag_pages_for_writeback(struct address_space *mapping, pgoff_t start, pgoff_t end)h](j)}(hvoidh]hvoid}(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>hhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM ubj)}(h h]h }(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>hhhj?hM ubh)}(htag_pages_for_writebackh]j)}(htag_pages_for_writebackh]htag_pages_for_writeback}(hj!?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj>hhhj?hM ubj8)}(h;(struct address_space *mapping, pgoff_t start, pgoff_t end)h](j>)}(hstruct address_space *mappingh](j)}(hjJ,h]hstruct}(hj=?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9?ubj)}(h h]h }(hjJ?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9?ubh)}(hhh]j)}(h address_spaceh]h address_space}(hj[?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjX?ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj]?modnameN classnameNjj)}j]j)}jj#?sbc.tag_pages_for_writebackasbuh1hhj9?ubj)}(h h]h }(hj{?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9?ubjr)}(hjuh]h*}(hj?hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj9?ubj)}(hmappingh]hmapping}(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9?ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj5?ubj>)}(h pgoff_t starth](h)}(hhh]j)}(hpgoff_th]hpgoff_t}(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj?modnameN classnameNjj)}j]jw?c.tag_pages_for_writebackasbuh1hhj?ubj)}(h h]h }(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?ubj)}(hstarth]hstart}(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj5?ubj>)}(h pgoff_t endh](h)}(hhh]j)}(hpgoff_th]hpgoff_t}(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj?modnameN classnameNjj)}j]jw?c.tag_pages_for_writebackasbuh1hhj?ubj)}(h h]h }(hj@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?ubj)}(hendh]hend}(hj&@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj5?ubeh}(h]h ]h"]h$]h&]jjuh1j7hj>hhhj?hM ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj>hhhj?hM ubah}(h]j>ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj?hM hj>hhubj4)}(hhh]jM)}(h$tag pages to be written by writebackh]h$tag pages to be written by writeback}(hjP@hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM hjM@hhubah}(h]h ]h"]h$]h&]uh1j3hj>hhhj?hM ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjh@jHjh@jIjJjKuh1hhhhj2hNhNubj)}(hX**Parameters** ``struct address_space *mapping`` address space structure to write ``pgoff_t start`` starting page index ``pgoff_t end`` ending page index (inclusive) **Description** This function scans the page range from **start** to **end** (inclusive) and tags all pages that have DIRTY tag set with a special TOWRITE tag. The caller can then use the TOWRITE tag to identify pages eligible for writeback. This mechanism is used to avoid livelocking of writeback by a process steadily creating new dirty pages in the file (thus it is important for this function to be quick so that it can tag pages faster than a dirtying process can create them).h](jM)}(h**Parameters**h]j)}(hjr@h]h Parameters}(hjt@hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjp@ubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM hjl@ubj)}(hhh](j)}(hC``struct address_space *mapping`` address space structure to write h](j)}(h!``struct address_space *mapping``h]jS)}(hj@h]hstruct address_space *mapping}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj@ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM hj@ubj)}(hhh]jM)}(h address space structure to writeh]h address space structure to write}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj@hM hj@ubah}(h]h ]h"]h$]h&]uh1jhj@ubeh}(h]h ]h"]h$]h&]uh1jhj@hM hj@ubj)}(h&``pgoff_t start`` starting page index h](j)}(h``pgoff_t start``h]jS)}(hj@h]h pgoff_t start}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj@ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM hj@ubj)}(hhh]jM)}(hstarting page indexh]hstarting page index}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj@hM hj@ubah}(h]h ]h"]h$]h&]uh1jhj@ubeh}(h]h ]h"]h$]h&]uh1jhj@hM hj@ubj)}(h.``pgoff_t end`` ending page index (inclusive) h](j)}(h``pgoff_t end``h]jS)}(hjAh]h pgoff_t end}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjAubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM hj@ubj)}(hhh]jM)}(hending page index (inclusive)h]hending page index (inclusive)}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjAhM hjAubah}(h]h ]h"]h$]h&]uh1jhj@ubeh}(h]h ]h"]h$]h&]uh1jhjAhM hj@ubeh}(h]h ]h"]h$]h&]uh1jhjl@ubjM)}(h**Description**h]j)}(hj>Ah]h Description}(hj@AhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj)}(hstruct address_space *mappingh](j)}(hjJ,h]hstruct}(hj!BhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubj)}(h h]h }(hj.BhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubh)}(hhh]j)}(h address_spaceh]h address_space}(hj?BhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)}(hstruct writeback_control *wbch](j)}(hjJ,h]hstruct}(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubj)}(h h]h }(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubh)}(hhh]j)}(hwriteback_controlh]hwriteback_control}(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjBmodnameN classnameNjj)}j]jAc.writeback_iterasbuh1hhjBubj)}(h h]h }(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubjr)}(hjuh]h*}(hjBhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjBubj)}(hwbch]hwbc}(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjBubj>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hjChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubj)}(h h]h }(hjChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubh)}(hhh]j)}(hfolioh]hfolio}(hjChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj!CmodnameN classnameNjj)}j]jAc.writeback_iterasbuh1hhjBubj)}(h h]h }(hj=ChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubjr)}(hjuh]h*}(hjKChhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjBubj)}(hfolioh]hfolio}(hjXChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjBubj>)}(h int *errorh](j)}(hinth]hint}(hjqChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmCubj)}(h h]h }(hjChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmCubjr)}(hjuh]h*}(hjChhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjmCubj)}(herrorh]herror}(hjChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmCubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjBubeh}(h]h ]h"]h$]h&]jjuh1j7hjAhhhjAhM ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjAhhhjAhM ubah}(h]jAah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjAhM hjAhhubj4)}(hhh]jM)}(h(iterate folio of a mapping for writebackh]h(iterate folio of a mapping for writeback}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM hjChhubah}(h]h ]h"]h$]h&]uh1j3hjAhhhjAhM ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjCjHjCjIjJjKuh1hhhhj2hNhNubj)}(hXu**Parameters** ``struct address_space *mapping`` address space structure to write ``struct writeback_control *wbc`` writeback context ``struct folio *folio`` previously iterated folio (``NULL`` to start) ``int *error`` in-out pointer for writeback errors (see below) **Description** This function returns the next folio for the writeback operation described by **wbc** on **mapping** and should be called in a while loop in the ->writepages implementation. To start the writeback operation, ``NULL`` is passed in the **folio** argument, and for every subsequent iteration the folio returned previously should be passed back in. If there was an error in the per-folio writeback inside the writeback_iter() loop, **error** should be set to the error value. Once the writeback described in **wbc** has finished, this function will return ``NULL`` and if there was an error in any iteration restore it to **error**. **Note** callers should not manually break out of the loop using break or goto but must keep calling writeback_iter() until it returns ``NULL``. **Return** the folio to write or ``NULL`` if the loop is done.h](jM)}(h**Parameters**h]j)}(hjCh]h Parameters}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1jhjCubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM hjCubj)}(hhh](j)}(hC``struct address_space *mapping`` address space structure to write h](j)}(h!``struct address_space *mapping``h]jS)}(hjDh]hstruct address_space *mapping}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjDubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM hjCubj)}(hhh]jM)}(h address space structure to writeh]h address space structure to write}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjDhM hjDubah}(h]h ]h"]h$]h&]uh1jhjCubeh}(h]h ]h"]h$]h&]uh1jhjDhM hjCubj)}(h4``struct writeback_control *wbc`` writeback context h](j)}(h!``struct writeback_control *wbc``h]jS)}(hj>Dh]hstruct writeback_control *wbc}(hj@DhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjwritepages implementation.h](hNThis function returns the next folio for the writeback operation described by }(hjEhhhNhNubj)}(h**wbc**h]hwbc}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjEubh on }(hjEhhhNhNubj)}(h **mapping**h]hmapping}(hj-EhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjEubhJ and should be called in a while loop in the ->writepages implementation.}(hjEhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM hjCubjM)}(hTo start the writeback operation, ``NULL`` is passed in the **folio** argument, and for every subsequent iteration the folio returned previously should be passed back in.h](h"To start the writeback operation, }(hjFEhhhNhNubjS)}(h``NULL``h]hNULL}(hjNEhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjFEubh is passed in the }(hjFEhhhNhNubj)}(h **folio**h]hfolio}(hj`EhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjFEubhe argument, and for every subsequent iteration the folio returned previously should be passed back in.}(hjFEhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM hjCubjM)}(h~If there was an error in the per-folio writeback inside the writeback_iter() loop, **error** should be set to the error value.h](hSIf there was an error in the per-folio writeback inside the writeback_iter() loop, }(hjyEhhhNhNubj)}(h **error**h]herror}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjyEubh" should be set to the error value.}(hjyEhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM hjCubjM)}(hOnce the writeback described in **wbc** has finished, this function will return ``NULL`` and if there was an error in any iteration restore it to **error**.h](h Once the writeback described in }(hjEhhhNhNubj)}(h**wbc**h]hwbc}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjEubh) has finished, this function will return }(hjEhhhNhNubjS)}(h``NULL``h]hNULL}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjEubh: and if there was an error in any iteration restore it to }(hjEhhhNhNubj)}(h **error**h]herror}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjEubh.}(hjEhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM hjCubjM)}(h**Note**h]j)}(hjEh]hNote}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjEubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM hjCubjM)}(hcallers should not manually break out of the loop using break or goto but must keep calling writeback_iter() until it returns ``NULL``.h](h~callers should not manually break out of the loop using break or goto but must keep calling writeback_iter() until it returns }(hjEhhhNhNubjS)}(h``NULL``h]hNULL}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjEubh.}(hjEhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM hjCubjM)}(h **Return**h]j)}(hjFh]hReturn}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjFubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM hjCubjM)}(h3the folio to write or ``NULL`` if the loop is done.h](hthe folio to write or }(hj0FhhhNhNubjS)}(h``NULL``h]hNULL}(hj8FhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj0Fubh if the loop is done.}(hj0FhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM hjCubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj2hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h filemap_dirty_folio (C function)c.filemap_dirty_foliohNtauh1hhj2hhhNhNubh)}(hhh](h)}(hMbool filemap_dirty_folio (struct address_space *mapping, struct folio *folio)h]h)}(hLbool filemap_dirty_folio(struct address_space *mapping, struct folio *folio)h](j)}(hjh]hbool}(hjqFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmFhhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM} ubj)}(h h]h }(hjFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmFhhhj~FhM} ubh)}(hfilemap_dirty_folioh]j)}(hfilemap_dirty_folioh]hfilemap_dirty_folio}(hjFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFubah}(h]h ](jjeh"]h$]h&]jjuh1hhjmFhhhj~FhM} ubj8)}(h4(struct address_space *mapping, struct folio *folio)h](j>)}(hstruct address_space *mappingh](j)}(hjJ,h]hstruct}(hjFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFubj)}(h h]h }(hjFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFubh)}(hhh]j)}(h address_spaceh]h address_space}(hjFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjFmodnameN classnameNjj)}j]j)}jjFsbc.filemap_dirty_folioasbuh1hhjFubj)}(h h]h }(hjFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFubjr)}(hjuh]h*}(hjFhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjFubj)}(hmappingh]hmapping}(hjGhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjFubj>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hjGhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGubj)}(h h]h }(hj,GhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGubh)}(hhh]j)}(hfolioh]hfolio}(hj=GhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:Gubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj?GmodnameN classnameNjj)}j]jFc.filemap_dirty_folioasbuh1hhjGubj)}(h h]h }(hj[GhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGubjr)}(hjuh]h*}(hjiGhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjGubj)}(hfolioh]hfolio}(hjvGhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjFubeh}(h]h ]h"]h$]h&]jjuh1j7hjmFhhhj~FhM} ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjiFhhhj~FhM} ubah}(h]jdFah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj~FhM} hjfFhhubj4)}(hhh]jM)}(hAMark a folio dirty for filesystems which do not use buffer_heads.h]hAMark a folio dirty for filesystems which do not use buffer_heads.}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM} hjGhhubah}(h]h ]h"]h$]h&]uh1j3hjfFhhhj~FhM} ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjGjHjGjIjJjKuh1hhhhj2hNhNubj)}(hX~**Parameters** ``struct address_space *mapping`` Address space this folio belongs to. ``struct folio *folio`` Folio to be marked as dirty. **Description** Filesystems which do not use buffer heads should call this function from their dirty_folio address space operation. It ignores the contents of folio_get_private(), so if the filesystem marks individual blocks as dirty, the filesystem should handle that itself. This is also sometimes used by filesystems which use buffer_heads when a single buffer is being dirtied: we want to set the folio dirty in that case, but not all the buffers. This is a "bottom-up" dirtying, whereas block_dirty_folio() is a "top-down" dirtying. The caller must ensure this doesn't race with truncation. Most will simply hold the folio lock, but e.g. zap_pte_range() calls with the folio mapped and the pte lock held, which also locks out truncation.h](jM)}(h**Parameters**h]j)}(hjGh]h Parameters}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjGubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM hjGubj)}(hhh](j)}(hG``struct address_space *mapping`` Address space this folio belongs to. h](j)}(h!``struct address_space *mapping``h]jS)}(hjGh]hstruct address_space *mapping}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjGubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM~ hjGubj)}(hhh]jM)}(h$Address space this folio belongs to.h]h$Address space this folio belongs to.}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjGhM~ hjGubah}(h]h ]h"]h$]h&]uh1jhjGubeh}(h]h ]h"]h$]h&]uh1jhjGhM~ hjGubj)}(h5``struct folio *folio`` Folio to be marked as dirty. h](j)}(h``struct folio *folio``h]jS)}(hjHh]hstruct folio *folio}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjHubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM hjHubj)}(hhh]jM)}(hFolio to be marked as dirty.h]hFolio to be marked as dirty.}(hj3HhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj/HhM hj0Hubah}(h]h ]h"]h$]h&]uh1jhjHubeh}(h]h ]h"]h$]h&]uh1jhj/HhM hjGubeh}(h]h ]h"]h$]h&]uh1jhjGubjM)}(h**Description**h]j)}(hjUHh]h Description}(hjWHhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjSHubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM hjGubjM)}(hXFilesystems which do not use buffer heads should call this function from their dirty_folio address space operation. It ignores the contents of folio_get_private(), so if the filesystem marks individual blocks as dirty, the filesystem should handle that itself.h]hXFilesystems which do not use buffer heads should call this function from their dirty_folio address space operation. It ignores the contents of folio_get_private(), so if the filesystem marks individual blocks as dirty, the filesystem should handle that itself.}(hjkHhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM hjGubjM)}(hXThis is also sometimes used by filesystems which use buffer_heads when a single buffer is being dirtied: we want to set the folio dirty in that case, but not all the buffers. This is a "bottom-up" dirtying, whereas block_dirty_folio() is a "top-down" dirtying.h]hX This is also sometimes used by filesystems which use buffer_heads when a single buffer is being dirtied: we want to set the folio dirty in that case, but not all the buffers. This is a “bottom-up” dirtying, whereas block_dirty_folio() is a “top-down” dirtying.}(hjzHhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM hjGubjM)}(hThe caller must ensure this doesn't race with truncation. Most will simply hold the folio lock, but e.g. zap_pte_range() calls with the folio mapped and the pte lock held, which also locks out truncation.h]hThe caller must ensure this doesn’t race with truncation. Most will simply hold the folio lock, but e.g. zap_pte_range() calls with the folio mapped and the pte lock held, which also locks out truncation.}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM hjGubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj2hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h(folio_redirty_for_writepage (C function)c.folio_redirty_for_writepagehNtauh1hhj2hhhNhNubh)}(hhh](h)}(hUbool folio_redirty_for_writepage (struct writeback_control *wbc, struct folio *folio)h]h)}(hTbool folio_redirty_for_writepage(struct writeback_control *wbc, struct folio *folio)h](j)}(hjh]hbool}(hjHhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHhhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM ubj)}(h h]h }(hjHhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHhhhjHhM ubh)}(hfolio_redirty_for_writepageh]j)}(hfolio_redirty_for_writepageh]hfolio_redirty_for_writepage}(hjHhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHubah}(h]h ](jjeh"]h$]h&]jjuh1hhjHhhhjHhM ubj8)}(h4(struct writeback_control *wbc, struct folio *folio)h](j>)}(hstruct writeback_control *wbch](j)}(hjJ,h]hstruct}(hjHhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHubj)}(h h]h }(hjIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHubh)}(hhh]j)}(hwriteback_controlh]hwriteback_control}(hjIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjImodnameN classnameNjj)}j]j)}jjHsbc.folio_redirty_for_writepageasbuh1hhjHubj)}(h h]h }(hj2IhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHubjr)}(hjuh]h*}(hj@IhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjHubj)}(hwbch]hwbc}(hjMIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjHubj>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hjfIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjbIubj)}(h h]h }(hjsIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjbIubh)}(hhh]j)}(hfolioh]hfolio}(hjIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjImodnameN classnameNjj)}j]j.Ic.folio_redirty_for_writepageasbuh1hhjbIubj)}(h h]h }(hjIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjbIubjr)}(hjuh]h*}(hjIhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjbIubj)}(hfolioh]hfolio}(hjIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjbIubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjHubeh}(h]h ]h"]h$]h&]jjuh1j7hjHhhhjHhM ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjHhhhjHhM ubah}(h]jHah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjHhM hjHhhubj4)}(hhh]jM)}(hDecline to write a dirty folio.h]hDecline to write a dirty folio.}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM hjIhhubah}(h]h ]h"]h$]h&]uh1j3hjHhhhjHhM ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjIjHjIjIjJjKuh1hhhhj2hNhNubj)}(hXv**Parameters** ``struct writeback_control *wbc`` The writeback control. ``struct folio *folio`` The folio. **Description** When a writepage implementation decides that it doesn't want to write **folio** for some reason, it should call this function, unlock **folio** and return 0. **Return** True if we redirtied the folio. False if someone else dirtied it first.h](jM)}(h**Parameters**h]j)}(hj Jh]h Parameters}(hj JhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjJubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM hjJubj)}(hhh](j)}(h9``struct writeback_control *wbc`` The writeback control. h](j)}(h!``struct writeback_control *wbc``h]jS)}(hj(Jh]hstruct writeback_control *wbc}(hj*JhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj&Jubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM hj"Jubj)}(hhh]jM)}(hThe writeback control.h]hThe writeback control.}(hjAJhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj=JhM hj>Jubah}(h]h ]h"]h$]h&]uh1jhj"Jubeh}(h]h ]h"]h$]h&]uh1jhj=JhM hjJubj)}(h#``struct folio *folio`` The folio. h](j)}(h``struct folio *folio``h]jS)}(hjaJh]hstruct folio *folio}(hjcJhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj_Jubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM hj[Jubj)}(hhh]jM)}(h The folio.h]h The folio.}(hjzJhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjvJhM hjwJubah}(h]h ]h"]h$]h&]uh1jhj[Jubeh}(h]h ]h"]h$]h&]uh1jhjvJhM hjJubeh}(h]h ]h"]h$]h&]uh1jhjJubjM)}(h**Description**h]j)}(hjJh]h Description}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjJubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM hjJubjM)}(hWhen a writepage implementation decides that it doesn't want to write **folio** for some reason, it should call this function, unlock **folio** and return 0.h](hHWhen a writepage implementation decides that it doesn’t want to write }(hjJhhhNhNubj)}(h **folio**h]hfolio}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjJubh7 for some reason, it should call this function, unlock }(hjJhhhNhNubj)}(h **folio**h]hfolio}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjJubh and return 0.}(hjJhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM hjJubjM)}(h **Return**h]j)}(hjJh]hReturn}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjJubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM hjJubjM)}(hHTrue if we redirtied the folio. False if someone else dirtied it first.h]hHTrue if we redirtied the folio. False if someone else dirtied it first.}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM hjJubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj2hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfolio_mark_dirty (C function)c.folio_mark_dirtyhNtauh1hhj2hhhNhNubh)}(hhh](h)}(h+bool folio_mark_dirty (struct folio *folio)h]h)}(h*bool folio_mark_dirty(struct folio *folio)h](j)}(hjh]hbool}(hj,KhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(KhhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM ubj)}(h h]h }(hj:KhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(Khhhj9KhM ubh)}(hfolio_mark_dirtyh]j)}(hfolio_mark_dirtyh]hfolio_mark_dirty}(hjLKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHKubah}(h]h ](jjeh"]h$]h&]jjuh1hhj(Khhhj9KhM ubj8)}(h(struct folio *folio)h]j>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hjhKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjdKubj)}(h h]h }(hjuKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjdKubh)}(hhh]j)}(hfolioh]hfolio}(hjKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjKubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjKmodnameN classnameNjj)}j]j)}jjNKsbc.folio_mark_dirtyasbuh1hhjdKubj)}(h h]h }(hjKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjdKubjr)}(hjuh]h*}(hjKhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjdKubj)}(hfolioh]hfolio}(hjKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjdKubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj`Kubah}(h]h ]h"]h$]h&]jjuh1j7hj(Khhhj9KhM ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj$Khhhj9KhM ubah}(h]jKah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj9KhM hj!Khhubj4)}(hhh]jM)}(hMark a folio as being modified.h]hMark a folio as being modified.}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM hjKhhubah}(h]h ]h"]h$]h&]uh1j3hj!Khhhj9KhM ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjLjHjLjIjJjKuh1hhhhj2hNhNubj)}(hX**Parameters** ``struct folio *folio`` The folio. **Description** The folio may not be truncated while this function is running. Holding the folio lock is sufficient to prevent truncation, but some callers cannot acquire a sleeping lock. These callers instead hold the page table lock for a page table which contains at least one page in this folio. Truncation will block on the page table lock as it unmaps pages before removing the folio from its mapping. .. DANGER:: Do not use this on a folio obtained from a function like get_user_pages_fast() without holding appropriate locks; you might want to use set_page_dirty_lock() or folio_mark_dirty_lock() instead. **Return** True if the folio was newly dirtied, false if it was already dirty.h](jM)}(h**Parameters**h]j)}(hj Lh]h Parameters}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj Lubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM hjLubj)}(hhh]j)}(h#``struct folio *folio`` The folio. h](j)}(h``struct folio *folio``h]jS)}(hj,Lh]hstruct folio *folio}(hj.LhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj*Lubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM hj&Lubj)}(hhh]jM)}(h The folio.h]h The folio.}(hjELhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjALhM hjBLubah}(h]h ]h"]h$]h&]uh1jhj&Lubeh}(h]h ]h"]h$]h&]uh1jhjALhM hj#Lubah}(h]h ]h"]h$]h&]uh1jhjLubjM)}(h**Description**h]j)}(hjgLh]h Description}(hjiLhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjeLubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM hjLubjM)}(hXThe folio may not be truncated while this function is running. Holding the folio lock is sufficient to prevent truncation, but some callers cannot acquire a sleeping lock. These callers instead hold the page table lock for a page table which contains at least one page in this folio. Truncation will block on the page table lock as it unmaps pages before removing the folio from its mapping.h]hXThe folio may not be truncated while this function is running. Holding the folio lock is sufficient to prevent truncation, but some callers cannot acquire a sleeping lock. These callers instead hold the page table lock for a page table which contains at least one page in this folio. Truncation will block on the page table lock as it unmaps pages before removing the folio from its mapping.}(hj}LhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM hjLubhdanger)}(hDo not use this on a folio obtained from a function like get_user_pages_fast() without holding appropriate locks; you might want to use set_page_dirty_lock() or folio_mark_dirty_lock() instead.h]jM)}(hDo not use this on a folio obtained from a function like get_user_pages_fast() without holding appropriate locks; you might want to use set_page_dirty_lock() or folio_mark_dirty_lock() instead.h]hDo not use this on a folio obtained from a function like get_user_pages_fast() without holding appropriate locks; you might want to use set_page_dirty_lock() or folio_mark_dirty_lock() instead.}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM hjLubah}(h]h ]h"]h$]h&]uh1jLhjLubjM)}(h **Return**h]j)}(hjLh]hReturn}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjLubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM hjLubjM)}(hCTrue if the folio was newly dirtied, false if it was already dirty.h]hCTrue if the folio was newly dirtied, false if it was already dirty.}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM hjLubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj2hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h!folio_wait_writeback (C function)c.folio_wait_writebackhNtauh1hhj2hhhNhNubh)}(hhh](h)}(h/void folio_wait_writeback (struct folio *folio)h]h)}(h.void folio_wait_writeback(struct folio *folio)h](j)}(hvoidh]hvoid}(hjLhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjLhhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM ubj)}(h h]h }(hjLhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjLhhhjLhM ubh)}(hfolio_wait_writebackh]j)}(hfolio_wait_writebackh]hfolio_wait_writeback}(hjMhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj Mubah}(h]h ](jjeh"]h$]h&]jjuh1hhjLhhhjLhM ubj8)}(h(struct folio *folio)h]j>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hj+MhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj'Mubj)}(h h]h }(hj8MhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj'Mubh)}(hhh]j)}(hfolioh]hfolio}(hjIMhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFMubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjKMmodnameN classnameNjj)}j]j)}jjMsbc.folio_wait_writebackasbuh1hhj'Mubj)}(h h]h }(hjiMhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj'Mubjr)}(hjuh]h*}(hjwMhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj'Mubj)}(hfolioh]hfolio}(hjMhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj'Mubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj#Mubah}(h]h ]h"]h$]h&]jjuh1j7hjLhhhjLhM ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjLhhhjLhM ubah}(h]jLah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjLhM hjLhhubj4)}(hhh]jM)}(h%Wait for a folio to finish writeback.h]h%Wait for a folio to finish writeback.}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM hjMhhubah}(h]h ]h"]h$]h&]uh1j3hjLhhhjLhM ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjMjHjMjIjJjKuh1hhhhj2hNhNubj)}(hX**Parameters** ``struct folio *folio`` The folio to wait for. **Description** If the folio is currently being written back to storage, wait for the I/O to complete. **Context** Sleeps. Must be called in process context and with no spinlocks held. Caller should hold a reference on the folio. If the folio is not locked, writeback may start again after writeback has finished.h](jM)}(h**Parameters**h]j)}(hjMh]h Parameters}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjMubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM hjMubj)}(hhh]j)}(h/``struct folio *folio`` The folio to wait for. h](j)}(h``struct folio *folio``h]jS)}(hjMh]hstruct folio *folio}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjMubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM hjMubj)}(hhh]jM)}(hThe folio to wait for.h]hThe folio to wait for.}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjNhM hjNubah}(h]h ]h"]h$]h&]uh1jhjMubeh}(h]h ]h"]h$]h&]uh1jhjNhM hjMubah}(h]h ]h"]h$]h&]uh1jhjMubjM)}(h**Description**h]j)}(hj*Nh]h Description}(hj,NhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj(Nubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM hjMubjM)}(hVIf the folio is currently being written back to storage, wait for the I/O to complete.h]hVIf the folio is currently being written back to storage, wait for the I/O to complete.}(hj@NhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM hjMubjM)}(h **Context**h]j)}(hjQNh]hContext}(hjSNhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjONubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM hjMubjM)}(hSleeps. Must be called in process context and with no spinlocks held. Caller should hold a reference on the folio. If the folio is not locked, writeback may start again after writeback has finished.h]hSleeps. Must be called in process context and with no spinlocks held. Caller should hold a reference on the folio. If the folio is not locked, writeback may start again after writeback has finished.0}(hjgNhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM hjMubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj2hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h*folio_wait_writeback_killable (C function)c.folio_wait_writeback_killablehNtauh1hhj2hhhNhNubh)}(hhh](h)}(h7int folio_wait_writeback_killable (struct folio *folio)h]h)}(h6int folio_wait_writeback_killable(struct folio *folio)h](j)}(hinth]hint}(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNhhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM ubj)}(h h]h }(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNhhhjNhM ubh)}(hfolio_wait_writeback_killableh]j)}(hfolio_wait_writeback_killableh]hfolio_wait_writeback_killable}(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubah}(h]h ](jjeh"]h$]h&]jjuh1hhjNhhhjNhM ubj8)}(h(struct folio *folio)h]j>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubj)}(h h]h }(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubh)}(hhh]j)}(hfolioh]hfolio}(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjNmodnameN classnameNjj)}j]j)}jjNsbc.folio_wait_writeback_killableasbuh1hhjNubj)}(h h]h }(hjOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubjr)}(hjuh]h*}(hjOhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjNubj)}(hfolioh]hfolio}(hj,OhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjNubah}(h]h ]h"]h$]h&]jjuh1j7hjNhhhjNhM ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjNhhhjNhM ubah}(h]jNah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjNhM hjNhhubj4)}(hhh]jM)}(h%Wait for a folio to finish writeback.h]h%Wait for a folio to finish writeback.}(hjVOhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM hjSOhhubah}(h]h ]h"]h$]h&]uh1j3hjNhhhjNhM ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjnOjHjnOjIjJjKuh1hhhhj2hNhNubj)}(hX**Parameters** ``struct folio *folio`` The folio to wait for. **Description** If the folio is currently being written back to storage, wait for the I/O to complete or a fatal signal to arrive. **Context** Sleeps. Must be called in process context and with no spinlocks held. Caller should hold a reference on the folio. If the folio is not locked, writeback may start again after writeback has finished. **Return** 0 on success, -EINTR if we get a fatal signal while waiting.h](jM)}(h**Parameters**h]j)}(hjxOh]h Parameters}(hjzOhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjvOubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM hjrOubj)}(hhh]j)}(h/``struct folio *folio`` The folio to wait for. h](j)}(h``struct folio *folio``h]jS)}(hjOh]hstruct folio *folio}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjOubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM hjOubj)}(hhh]jM)}(hThe folio to wait for.h]hThe folio to wait for.}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjOhM hjOubah}(h]h ]h"]h$]h&]uh1jhjOubeh}(h]h ]h"]h$]h&]uh1jhjOhM hjOubah}(h]h ]h"]h$]h&]uh1jhjrOubjM)}(h**Description**h]j)}(hjOh]h Description}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjOubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM hjrOubjM)}(hrIf the folio is currently being written back to storage, wait for the I/O to complete or a fatal signal to arrive.h]hrIf the folio is currently being written back to storage, wait for the I/O to complete or a fatal signal to arrive.}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM hjrOubjM)}(h **Context**h]j)}(hjOh]hContext}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjOubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM hjrOubjM)}(hSleeps. Must be called in process context and with no spinlocks held. Caller should hold a reference on the folio. If the folio is not locked, writeback may start again after writeback has finished.h]hSleeps. Must be called in process context and with no spinlocks held. Caller should hold a reference on the folio. If the folio is not locked, writeback may start again after writeback has finished.}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM hjrOubjM)}(h **Return**h]j)}(hj Ph]hReturn}(hj"PhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjPubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM hjrOubjM)}(h<0 on success, -EINTR if we get a fatal signal while waiting.h]h<0 on success, -EINTR if we get a fatal signal while waiting.}(hj6PhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM hjrOubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj2hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfolio_wait_stable (C function)c.folio_wait_stablehNtauh1hhj2hhhNhNubh)}(hhh](h)}(h,void folio_wait_stable (struct folio *folio)h]h)}(h+void folio_wait_stable(struct folio *folio)h](j)}(hvoidh]hvoid}(hjePhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaPhhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM ubj)}(h h]h }(hjtPhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaPhhhjsPhM ubh)}(hfolio_wait_stableh]j)}(hfolio_wait_stableh]hfolio_wait_stable}(hjPhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjPubah}(h]h ](jjeh"]h$]h&]jjuh1hhjaPhhhjsPhM ubj8)}(h(struct folio *folio)h]j>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hjPhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjPubj)}(h h]h }(hjPhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjPubh)}(hhh]j)}(hfolioh]hfolio}(hjPhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjPubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjPmodnameN classnameNjj)}j]j)}jjPsbc.folio_wait_stableasbuh1hhjPubj)}(h h]h }(hjPhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjPubjr)}(hjuh]h*}(hjPhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjPubj)}(hfolioh]hfolio}(hjPhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjPubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjPubah}(h]h ]h"]h$]h&]jjuh1j7hjaPhhhjsPhM ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj]PhhhjsPhM ubah}(h]jXPah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjsPhM hjZPhhubj4)}(hhh]jM)}(h+wait for writeback to finish, if necessary.h]h+wait for writeback to finish, if necessary.}(hj%QhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM hj"Qhhubah}(h]h ]h"]h$]h&]uh1j3hjZPhhhjsPhM ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj=QjHj=QjIjJjKuh1hhhhj2hNhNubj)}(hX**Parameters** ``struct folio *folio`` The folio to wait on. **Description** This function determines if the given folio is related to a backing device that requires folio contents to be held stable during writeback. If so, then it will wait for any pending writeback to complete. **Context** Sleeps. Must be called in process context and with no spinlocks held. Caller should hold a reference on the folio. If the folio is not locked, writeback may start again after writeback has finished.h](jM)}(h**Parameters**h]j)}(hjGQh]h Parameters}(hjIQhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjEQubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM hjAQubj)}(hhh]j)}(h.``struct folio *folio`` The folio to wait on. h](j)}(h``struct folio *folio``h]jS)}(hjfQh]hstruct folio *folio}(hjhQhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjdQubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM hj`Qubj)}(hhh]jM)}(hThe folio to wait on.h]hThe folio to wait on.}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj{QhM hj|Qubah}(h]h ]h"]h$]h&]uh1jhj`Qubeh}(h]h ]h"]h$]h&]uh1jhj{QhM hj]Qubah}(h]h ]h"]h$]h&]uh1jhjAQubjM)}(h**Description**h]j)}(hjQh]h Description}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjQubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM hjAQubjM)}(hThis function determines if the given folio is related to a backing device that requires folio contents to be held stable during writeback. If so, then it will wait for any pending writeback to complete.h]hThis function determines if the given folio is related to a backing device that requires folio contents to be held stable during writeback. If so, then it will wait for any pending writeback to complete.}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM hjAQubjM)}(h **Context**h]j)}(hjQh]hContext}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjQubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM hjAQubjM)}(hSleeps. Must be called in process context and with no spinlocks held. Caller should hold a reference on the folio. If the folio is not locked, writeback may start again after writeback has finished.h]hSleeps. Must be called in process context and with no spinlocks held. Caller should hold a reference on the folio. If the folio is not locked, writeback may start again after writeback has finished.}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:89: ./mm/page-writeback.chM hjAQubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj2hhhNhNubeh}(h] writebackah ]h"] writebackah$]h&]uh1hhjhhhhhKVubh)}(hhh](h)}(hTruncateh]hTruncate}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjQhhhhhK]ubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfolio_invalidate (C function)c.folio_invalidatehNtauh1hhjQhhhNhNubh)}(hhh](h)}(hIvoid folio_invalidate (struct folio *folio, size_t offset, size_t length)h]h)}(hHvoid folio_invalidate(struct folio *folio, size_t offset, size_t length)h](j)}(hvoidh]hvoid}(hj&RhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"RhhhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chKyubj)}(h h]h }(hj5RhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"Rhhhj4RhKyubh)}(hfolio_invalidateh]j)}(hfolio_invalidateh]hfolio_invalidate}(hjGRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCRubah}(h]h ](jjeh"]h$]h&]jjuh1hhj"Rhhhj4RhKyubj8)}(h3(struct folio *folio, size_t offset, size_t length)h](j>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hjcRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj_Rubj)}(h h]h }(hjpRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj_Rubh)}(hhh]j)}(hfolioh]hfolio}(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~Rubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjRmodnameN classnameNjj)}j]j)}jjIRsbc.folio_invalidateasbuh1hhj_Rubj)}(h h]h }(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj_Rubjr)}(hjuh]h*}(hjRhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj_Rubj)}(hfolioh]hfolio}(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj_Rubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj[Rubj>)}(h size_t offseth](h)}(hhh]j)}(hsize_th]hsize_t}(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjRmodnameN classnameNjj)}j]jRc.folio_invalidateasbuh1hhjRubj)}(h h]h }(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRubj)}(hoffseth]hoffset}(hjShhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj[Rubj>)}(h size_t lengthh](h)}(hhh]j)}(hsize_th]hsize_t}(hj ShhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj"SmodnameN classnameNjj)}j]jRc.folio_invalidateasbuh1hhjSubj)}(h h]h }(hj>ShhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSubj)}(hlengthh]hlength}(hjLShhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj[Rubeh}(h]h ]h"]h$]h&]jjuh1j7hj"Rhhhj4RhKyubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjRhhhj4RhKyubah}(h]jRah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj4RhKyhjRhhubj4)}(hhh]jM)}(h"Invalidate part or all of a folio.h]h"Invalidate part or all of a folio.}(hjvShhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chKyhjsShhubah}(h]h ]h"]h$]h&]uh1j3hjRhhhj4RhKyubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjSjHjSjIjJjKuh1hhhhjQhNhNubj)}(hX[**Parameters** ``struct folio *folio`` The folio which is affected. ``size_t offset`` start of the range to invalidate ``size_t length`` length of the range to invalidate **Description** folio_invalidate() is called when all or part of the folio has become invalidated by a truncate operation. folio_invalidate() does not have to release all buffers, but it must ensure that no dirty buffer is left outside **offset** and that no I/O is underway against any of the blocks which are outside the truncation point. Because the caller is about to free (and possibly reuse) those blocks on-disk.h](jM)}(h**Parameters**h]j)}(hjSh]h Parameters}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1jhjSubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chK}hjSubj)}(hhh](j)}(h5``struct folio *folio`` The folio which is affected. h](j)}(h``struct folio *folio``h]jS)}(hjSh]hstruct folio *folio}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjSubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chKzhjSubj)}(hhh]jM)}(hThe folio which is affected.h]hThe folio which is affected.}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjShKzhjSubah}(h]h ]h"]h$]h&]uh1jhjSubeh}(h]h ]h"]h$]h&]uh1jhjShKzhjSubj)}(h3``size_t offset`` start of the range to invalidate h](j)}(h``size_t offset``h]jS)}(hjSh]h size_t offset}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjSubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chK{hjSubj)}(hhh]jM)}(h start of the range to invalidateh]h start of the range to invalidate}(hj ThhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjThK{hjTubah}(h]h ]h"]h$]h&]uh1jhjSubeh}(h]h ]h"]h$]h&]uh1jhjThK{hjSubj)}(h4``size_t length`` length of the range to invalidate h](j)}(h``size_t length``h]jS)}(hj)Th]h size_t length}(hj+ThhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj'Tubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chK|hj#Tubj)}(hhh]jM)}(h!length of the range to invalidateh]h!length of the range to invalidate}(hjBThhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj>ThK|hj?Tubah}(h]h ]h"]h$]h&]uh1jhj#Tubeh}(h]h ]h"]h$]h&]uh1jhj>ThK|hjSubeh}(h]h ]h"]h$]h&]uh1jhjSubjM)}(h**Description**h]j)}(hjdTh]h Description}(hjfThhhNhNubah}(h]h ]h"]h$]h&]uh1jhjbTubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chK~hjSubjM)}(hjfolio_invalidate() is called when all or part of the folio has become invalidated by a truncate operation.h]hjfolio_invalidate() is called when all or part of the folio has become invalidated by a truncate operation.}(hjzThhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chK}hjSubjM)}(hX)folio_invalidate() does not have to release all buffers, but it must ensure that no dirty buffer is left outside **offset** and that no I/O is underway against any of the blocks which are outside the truncation point. Because the caller is about to free (and possibly reuse) those blocks on-disk.h](hqfolio_invalidate() does not have to release all buffers, but it must ensure that no dirty buffer is left outside }(hjThhhNhNubj)}(h **offset**h]hoffset}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jhjTubh and that no I/O is underway against any of the blocks which are outside the truncation point. Because the caller is about to free (and possibly reuse) those blocks on-disk.}(hjThhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chKhjSubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjQhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h'truncate_inode_pages_range (C function)c.truncate_inode_pages_rangehNtauh1hhjQhhhNhNubh)}(hhh](h)}(h[void truncate_inode_pages_range (struct address_space *mapping, loff_t lstart, uoff_t lend)h]h)}(hZvoid truncate_inode_pages_range(struct address_space *mapping, loff_t lstart, uoff_t lend)h](j)}(hvoidh]hvoid}(hjThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjThhhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chM}ubj)}(h h]h }(hjThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjThhhjThM}ubh)}(htruncate_inode_pages_rangeh]j)}(htruncate_inode_pages_rangeh]htruncate_inode_pages_range}(hjThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjTubah}(h]h ](jjeh"]h$]h&]jjuh1hhjThhhjThM}ubj8)}(h;(struct address_space *mapping, loff_t lstart, uoff_t lend)h](j>)}(hstruct address_space *mappingh](j)}(hjJ,h]hstruct}(hjUhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjUubj)}(h h]h }(hjUhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjUubh)}(hhh]j)}(h address_spaceh]h address_space}(hj%UhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"Uubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj'UmodnameN classnameNjj)}j]j)}jjTsbc.truncate_inode_pages_rangeasbuh1hhjUubj)}(h h]h }(hjEUhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjUubjr)}(hjuh]h*}(hjSUhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjUubj)}(hmappingh]hmapping}(hj`UhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjUubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjTubj>)}(h loff_t lstarth](h)}(hhh]j)}(hloff_th]hloff_t}(hj|UhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyUubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj~UmodnameN classnameNjj)}j]jAUc.truncate_inode_pages_rangeasbuh1hhjuUubj)}(h h]h }(hjUhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjuUubj)}(hlstarth]hlstart}(hjUhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjuUubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjTubj>)}(h uoff_t lendh](h)}(hhh]j)}(huoff_th]huoff_t}(hjUhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjUubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjUmodnameN classnameNjj)}j]jAUc.truncate_inode_pages_rangeasbuh1hhjUubj)}(h h]h }(hjUhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjUubj)}(hlendh]hlend}(hjUhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjUubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjTubeh}(h]h ]h"]h$]h&]jjuh1j7hjThhhjThM}ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjThhhjThM}ubah}(h]jTah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjThM}hjThhubj4)}(hhh]jM)}(h=truncate range of pages specified by start & end byte offsetsh]h=truncate range of pages specified by start & end byte offsets}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chM}hjVhhubah}(h]h ]h"]h$]h&]uh1j3hjThhhjThM}ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj2VjHj2VjIjJjKuh1hhhhjQhNhNubj)}(hX**Parameters** ``struct address_space *mapping`` mapping to truncate ``loff_t lstart`` offset from which to truncate ``uoff_t lend`` offset to which to truncate (inclusive) **Description** Truncate the page cache, removing the folios that are between specified offsets (and zeroing out partial folios if lstart or lend + 1 is not folio aligned). For mappings with a non-zero minimum folio order, the boundaries are aligned inwards to 1 << min_order so the edge sub-folio straddling the range is kept. Truncate takes two passes - the first pass is nonblocking. It will not block on page locks and it will not block on writeback. The second pass will wait. This is to prevent as much IO as possible in the affected region. The first pass will remove most pages, so the search cost of the second pass is low. We pass down the cache-hot hint to the page freeing code. Even if the mapping is large, it is probably the case that the final pages are the most recently touched, and freeing happens in ascending file offset order. Note that since ->invalidate_folio() accepts range to invalidate truncate_inode_pages_range is able to handle cases where lend + 1 is not page aligned properly.h](jM)}(h**Parameters**h]j)}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj:Vubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chMhj6Vubj)}(hhh](j)}(h6``struct address_space *mapping`` mapping to truncate h](j)}(h!``struct address_space *mapping``h]jS)}(hj[Vh]hstruct address_space *mapping}(hj]VhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjYVubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chM~hjUVubj)}(hhh]jM)}(hmapping to truncateh]hmapping to truncate}(hjtVhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjpVhM~hjqVubah}(h]h ]h"]h$]h&]uh1jhjUVubeh}(h]h ]h"]h$]h&]uh1jhjpVhM~hjRVubj)}(h0``loff_t lstart`` offset from which to truncate h](j)}(h``loff_t lstart``h]jS)}(hjVh]h loff_t lstart}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjVubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chMhjVubj)}(hhh]jM)}(hoffset from which to truncateh]hoffset from which to truncate}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjVhMhjVubah}(h]h ]h"]h$]h&]uh1jhjVubeh}(h]h ]h"]h$]h&]uh1jhjVhMhjRVubj)}(h8``uoff_t lend`` offset to which to truncate (inclusive) h](j)}(h``uoff_t lend``h]jS)}(hjVh]h uoff_t lend}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjVubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chMhjVubj)}(hhh]jM)}(h'offset to which to truncate (inclusive)h]h'offset to which to truncate (inclusive)}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjVhMhjVubah}(h]h ]h"]h$]h&]uh1jhjVubeh}(h]h ]h"]h$]h&]uh1jhjVhMhjRVubeh}(h]h ]h"]h$]h&]uh1jhj6VubjM)}(h**Description**h]j)}(hjWh]h Description}(hj WhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjWubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chMhj6VubjM)}(hX8Truncate the page cache, removing the folios that are between specified offsets (and zeroing out partial folios if lstart or lend + 1 is not folio aligned). For mappings with a non-zero minimum folio order, the boundaries are aligned inwards to 1 << min_order so the edge sub-folio straddling the range is kept.h]hX8Truncate the page cache, removing the folios that are between specified offsets (and zeroing out partial folios if lstart or lend + 1 is not folio aligned). For mappings with a non-zero minimum folio order, the boundaries are aligned inwards to 1 << min_order so the edge sub-folio straddling the range is kept.}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chMhj6VubjM)}(hX3Truncate takes two passes - the first pass is nonblocking. It will not block on page locks and it will not block on writeback. The second pass will wait. This is to prevent as much IO as possible in the affected region. The first pass will remove most pages, so the search cost of the second pass is low.h]hX3Truncate takes two passes - the first pass is nonblocking. It will not block on page locks and it will not block on writeback. The second pass will wait. This is to prevent as much IO as possible in the affected region. The first pass will remove most pages, so the search cost of the second pass is low.}(hj-WhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chMhj6VubjM)}(hWe pass down the cache-hot hint to the page freeing code. Even if the mapping is large, it is probably the case that the final pages are the most recently touched, and freeing happens in ascending file offset order.h]hWe pass down the cache-hot hint to the page freeing code. Even if the mapping is large, it is probably the case that the final pages are the most recently touched, and freeing happens in ascending file offset order.}(hjinvalidate_folio() accepts range to invalidate truncate_inode_pages_range is able to handle cases where lend + 1 is not page aligned properly.h]hNote that since ->invalidate_folio() accepts range to invalidate truncate_inode_pages_range is able to handle cases where lend + 1 is not page aligned properly.}(hjKWhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chMhj6Vubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjQhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h!truncate_inode_pages (C function)c.truncate_inode_pageshNtauh1hhjQhhhNhNubh)}(hhh](h)}(hHvoid truncate_inode_pages (struct address_space *mapping, loff_t lstart)h]h)}(hGvoid truncate_inode_pages(struct address_space *mapping, loff_t lstart)h](j)}(hvoidh]hvoid}(hjzWhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvWhhhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chMubj)}(h h]h }(hjWhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvWhhhjWhMubh)}(htruncate_inode_pagesh]j)}(htruncate_inode_pagesh]htruncate_inode_pages}(hjWhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjWubah}(h]h ](jjeh"]h$]h&]jjuh1hhjvWhhhjWhMubj8)}(h.(struct address_space *mapping, loff_t lstart)h](j>)}(hstruct address_space *mappingh](j)}(hjJ,h]hstruct}(hjWhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjWubj)}(h h]h }(hjWhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjWubh)}(hhh]j)}(h address_spaceh]h address_space}(hjWhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjWubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjWmodnameN classnameNjj)}j]j)}jjWsbc.truncate_inode_pagesasbuh1hhjWubj)}(h h]h }(hjWhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjWubjr)}(hjuh]h*}(hjXhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjWubj)}(hmappingh]hmapping}(hjXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjWubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjWubj>)}(h loff_t lstarth](h)}(hhh]j)}(hloff_th]hloff_t}(hj,XhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)Xubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj.XmodnameN classnameNjj)}j]jWc.truncate_inode_pagesasbuh1hhj%Xubj)}(h h]h }(hjJXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%Xubj)}(hlstarth]hlstart}(hjXXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%Xubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjWubeh}(h]h ]h"]h$]h&]jjuh1j7hjvWhhhjWhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjrWhhhjWhMubah}(h]jmWah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjWhMhjoWhhubj4)}(hhh]jM)}(h'truncate *all* the pages from an offseth](h truncate }(hjXhhhNhNubj )}(h*all*h]hall}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1j hjXubh the pages from an offset}(hjXhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chMhjXhhubah}(h]h ]h"]h$]h&]uh1j3hjoWhhhjWhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjXjHjXjIjJjKuh1hhhhjQhNhNubj)}(hX**Parameters** ``struct address_space *mapping`` mapping to truncate ``loff_t lstart`` offset from which to truncate **Description** Called under (and serialised by) inode->i_rwsem and mapping->invalidate_lock. **Note** When this function returns, there can be a page in the process of deletion (inside __filemap_remove_folio()) in the specified range. Thus mapping->nrpages can be non-zero when this function returns even after truncation of the whole mapping.h](jM)}(h**Parameters**h]j)}(hjXh]h Parameters}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjXubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chMhjXubj)}(hhh](j)}(h6``struct address_space *mapping`` mapping to truncate h](j)}(h!``struct address_space *mapping``h]jS)}(hjXh]hstruct address_space *mapping}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjXubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chMhjXubj)}(hhh]jM)}(hmapping to truncateh]hmapping to truncate}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjXhMhjXubah}(h]h ]h"]h$]h&]uh1jhjXubeh}(h]h ]h"]h$]h&]uh1jhjXhMhjXubj)}(h0``loff_t lstart`` offset from which to truncate h](j)}(h``loff_t lstart``h]jS)}(hjYh]h loff_t lstart}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj Yubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chMhjYubj)}(hhh]jM)}(hoffset from which to truncateh]hoffset from which to truncate}(hj'YhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj#YhMhj$Yubah}(h]h ]h"]h$]h&]uh1jhjYubeh}(h]h ]h"]h$]h&]uh1jhj#YhMhjXubeh}(h]h ]h"]h$]h&]uh1jhjXubjM)}(h**Description**h]j)}(hjIYh]h Description}(hjKYhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjGYubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chMhjXubjM)}(hMCalled under (and serialised by) inode->i_rwsem and mapping->invalidate_lock.h]hMCalled under (and serialised by) inode->i_rwsem and mapping->invalidate_lock.}(hj_YhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chMhjXubjM)}(h**Note**h]j)}(hjpYh]hNote}(hjrYhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjnYubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chMhjXubjM)}(hWhen this function returns, there can be a page in the process of deletion (inside __filemap_remove_folio()) in the specified range. Thus mapping->nrpages can be non-zero when this function returns even after truncation of the whole mapping.h]hWhen this function returns, there can be a page in the process of deletion (inside __filemap_remove_folio()) in the specified range. Thus mapping->nrpages can be non-zero when this function returns even after truncation of the whole mapping.}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chMhjXubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjQhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h'truncate_inode_pages_final (C function)c.truncate_inode_pages_finalhNtauh1hhjQhhhNhNubh)}(hhh](h)}(h?void truncate_inode_pages_final (struct address_space *mapping)h]h)}(h>void truncate_inode_pages_final(struct address_space *mapping)h](j)}(hvoidh]hvoid}(hjYhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjYhhhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chMubj)}(h h]h }(hjYhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjYhhhjYhMubh)}(htruncate_inode_pages_finalh]j)}(htruncate_inode_pages_finalh]htruncate_inode_pages_final}(hjYhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjYubah}(h]h ](jjeh"]h$]h&]jjuh1hhjYhhhjYhMubj8)}(h(struct address_space *mapping)h]j>)}(hstruct address_space *mappingh](j)}(hjJ,h]hstruct}(hjYhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjYubj)}(h h]h }(hjYhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjYubh)}(hhh]j)}(h address_spaceh]h address_space}(hjZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj Zubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjZmodnameN classnameNjj)}j]j)}jjYsbc.truncate_inode_pages_finalasbuh1hhjYubj)}(h h]h }(hj0ZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjYubjr)}(hjuh]h*}(hj>ZhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjYubj)}(hmappingh]hmapping}(hjKZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjYubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjYubah}(h]h ]h"]h$]h&]jjuh1j7hjYhhhjYhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjYhhhjYhMubah}(h]jYah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjYhMhjYhhubj4)}(hhh]jM)}(h&truncate *all* pages before inode diesh](h truncate }(hjuZhhhNhNubj )}(h*all*h]hall}(hj}ZhhhNhNubah}(h]h ]h"]h$]h&]uh1j hjuZubh pages before inode dies}(hjuZhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chMhjrZhhubah}(h]h ]h"]h$]h&]uh1j3hjYhhhjYhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjZjHjZjIjJjKuh1hhhhjQhNhNubj)}(hX**Parameters** ``struct address_space *mapping`` mapping to truncate **Description** Called under (and serialized by) inode->i_rwsem. Filesystems have to use this in the .evict_inode path to inform the VM that this is the final truncate and the inode is going away.h](jM)}(h**Parameters**h]j)}(hjZh]h Parameters}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjZubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chMhjZubj)}(hhh]j)}(h6``struct address_space *mapping`` mapping to truncate h](j)}(h!``struct address_space *mapping``h]jS)}(hjZh]hstruct address_space *mapping}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjZubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chMhjZubj)}(hhh]jM)}(hmapping to truncateh]hmapping to truncate}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjZhMhjZubah}(h]h ]h"]h$]h&]uh1jhjZubeh}(h]h ]h"]h$]h&]uh1jhjZhMhjZubah}(h]h ]h"]h$]h&]uh1jhjZubjM)}(h**Description**h]j)}(hj[h]h Description}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj[ubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chMhjZubjM)}(h0Called under (and serialized by) inode->i_rwsem.h]h0Called under (and serialized by) inode->i_rwsem.}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chMhjZubjM)}(hFilesystems have to use this in the .evict_inode path to inform the VM that this is the final truncate and the inode is going away.h]hFilesystems have to use this in the .evict_inode path to inform the VM that this is the final truncate and the inode is going away.}(hj([hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chMhjZubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjQhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h%invalidate_mapping_pages (C function)c.invalidate_mapping_pageshNtauh1hhjQhhhNhNubh)}(hhh](h)}(hbunsigned long invalidate_mapping_pages (struct address_space *mapping, pgoff_t start, pgoff_t end)h]h)}(haunsigned long invalidate_mapping_pages(struct address_space *mapping, pgoff_t start, pgoff_t end)h](j)}(hunsignedh]hunsigned}(hjW[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjS[hhhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chMsubj)}(h h]h }(hjf[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjS[hhhje[hMsubj)}(hlongh]hlong}(hjt[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjS[hhhje[hMsubj)}(h h]h }(hj[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjS[hhhje[hMsubh)}(hinvalidate_mapping_pagesh]j)}(hinvalidate_mapping_pagesh]hinvalidate_mapping_pages}(hj[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj[ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjS[hhhje[hMsubj8)}(h;(struct address_space *mapping, pgoff_t start, pgoff_t end)h](j>)}(hstruct address_space *mappingh](j)}(hjJ,h]hstruct}(hj[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj[ubj)}(h h]h }(hj[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj[ubh)}(hhh]j)}(h address_spaceh]h address_space}(hj[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj[ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj[modnameN classnameNjj)}j]j)}jj[sbc.invalidate_mapping_pagesasbuh1hhj[ubj)}(h h]h }(hj[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj[ubjr)}(hjuh]h*}(hj[hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj[ubj)}(hmappingh]hmapping}(hj \hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj[ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj[ubj>)}(h pgoff_t starth](h)}(hhh]j)}(hpgoff_th]hpgoff_t}(hj%\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"\ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj'\modnameN classnameNjj)}j]j[c.invalidate_mapping_pagesasbuh1hhj\ubj)}(h h]h }(hjC\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\ubj)}(hstarth]hstart}(hjQ\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj[ubj>)}(h pgoff_t endh](h)}(hhh]j)}(hpgoff_th]hpgoff_t}(hjm\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjj\ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjo\modnameN classnameNjj)}j]j[c.invalidate_mapping_pagesasbuh1hhjf\ubj)}(h h]h }(hj\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjf\ubj)}(hendh]hend}(hj\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjf\ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj[ubeh}(h]h ]h"]h$]h&]jjuh1j7hjS[hhhje[hMsubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjO[hhhje[hMsubah}(h]jJ[ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhje[hMshjL[hhubj4)}(hhh]jM)}(h1Invalidate all clean, unlocked cache of one inodeh]h1Invalidate all clean, unlocked cache of one inode}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chMshj\hhubah}(h]h ]h"]h$]h&]uh1j3hjL[hhhje[hMsubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj\jHj\jIjJjKuh1hhhhjQhNhNubj)}(hX<**Parameters** ``struct address_space *mapping`` the address_space which holds the cache to invalidate ``pgoff_t start`` the offset 'from' which to invalidate ``pgoff_t end`` the offset 'to' which to invalidate (inclusive) **Description** This function removes pages that are clean, unmapped and unlocked, as well as shadow entries. It will not block on IO activity. If you want to remove all the pages of one inode, regardless of their use and writeback state, use truncate_inode_pages(). **Return** The number of indices that had their contents invalidatedh](jM)}(h**Parameters**h]j)}(hj\h]h Parameters}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj\ubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chMwhj\ubj)}(hhh](j)}(hX``struct address_space *mapping`` the address_space which holds the cache to invalidate h](j)}(h!``struct address_space *mapping``h]jS)}(hj]h]hstruct address_space *mapping}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj]ubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chMthj\ubj)}(hhh]jM)}(h5the address_space which holds the cache to invalidateh]h5the address_space which holds the cache to invalidate}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj]hMthj]ubah}(h]h ]h"]h$]h&]uh1jhj\ubeh}(h]h ]h"]h$]h&]uh1jhj]hMthj\ubj)}(h8``pgoff_t start`` the offset 'from' which to invalidate h](j)}(h``pgoff_t start``h]jS)}(hj=]h]h pgoff_t start}(hj?]hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj;]ubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chMuhj7]ubj)}(hhh]jM)}(h%the offset 'from' which to invalidateh]h)the offset ‘from’ which to invalidate}(hjV]hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjR]hMuhjS]ubah}(h]h ]h"]h$]h&]uh1jhj7]ubeh}(h]h ]h"]h$]h&]uh1jhjR]hMuhj\ubj)}(h@``pgoff_t end`` the offset 'to' which to invalidate (inclusive) h](j)}(h``pgoff_t end``h]jS)}(hjv]h]h pgoff_t end}(hjx]hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjt]ubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chMvhjp]ubj)}(hhh]jM)}(h/the offset 'to' which to invalidate (inclusive)h]h3the offset ‘to’ which to invalidate (inclusive)}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj]hMvhj]ubah}(h]h ]h"]h$]h&]uh1jhjp]ubeh}(h]h ]h"]h$]h&]uh1jhj]hMvhj\ubeh}(h]h ]h"]h$]h&]uh1jhj\ubjM)}(h**Description**h]j)}(hj]h]h Description}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj]ubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chMxhj\ubjM)}(hThis function removes pages that are clean, unmapped and unlocked, as well as shadow entries. It will not block on IO activity.h]hThis function removes pages that are clean, unmapped and unlocked, as well as shadow entries. It will not block on IO activity.}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chMwhj\ubjM)}(hzIf you want to remove all the pages of one inode, regardless of their use and writeback state, use truncate_inode_pages().h]hzIf you want to remove all the pages of one inode, regardless of their use and writeback state, use truncate_inode_pages().}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chMzhj\ubjM)}(h **Return**h]j)}(hj]h]hReturn}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj]ubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chM}hj\ubjM)}(h9The number of indices that had their contents invalidatedh]h9The number of indices that had their contents invalidated}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chM~hj\ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjQhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h*invalidate_inode_pages2_range (C function)c.invalidate_inode_pages2_rangehNtauh1hhjQhhhNhNubh)}(hhh](h)}(h]int invalidate_inode_pages2_range (struct address_space *mapping, pgoff_t start, pgoff_t end)h]h)}(h\int invalidate_inode_pages2_range(struct address_space *mapping, pgoff_t start, pgoff_t end)h](j)}(hinth]hint}(hj,^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(^hhhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chMubj)}(h h]h }(hj;^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(^hhhj:^hMubh)}(hinvalidate_inode_pages2_rangeh]j)}(hinvalidate_inode_pages2_rangeh]hinvalidate_inode_pages2_range}(hjM^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjI^ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj(^hhhj:^hMubj8)}(h;(struct address_space *mapping, pgoff_t start, pgoff_t end)h](j>)}(hstruct address_space *mappingh](j)}(hjJ,h]hstruct}(hji^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhje^ubj)}(h h]h }(hjv^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhje^ubh)}(hhh]j)}(h address_spaceh]h address_space}(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj^modnameN classnameNjj)}j]j)}jjO^sbc.invalidate_inode_pages2_rangeasbuh1hhje^ubj)}(h h]h }(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhje^ubjr)}(hjuh]h*}(hj^hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhje^ubj)}(hmappingh]hmapping}(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhje^ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hja^ubj>)}(h pgoff_t starth](h)}(hhh]j)}(hpgoff_th]hpgoff_t}(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj^modnameN classnameNjj)}j]j^c.invalidate_inode_pages2_rangeasbuh1hhj^ubj)}(h h]h }(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^ubj)}(hstarth]hstart}(hj _hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hja^ubj>)}(h pgoff_t endh](h)}(hhh]j)}(hpgoff_th]hpgoff_t}(hj&_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#_ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj(_modnameN classnameNjj)}j]j^c.invalidate_inode_pages2_rangeasbuh1hhj_ubj)}(h h]h }(hjD_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj_ubj)}(hendh]hend}(hjR_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj_ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hja^ubeh}(h]h ]h"]h$]h&]jjuh1j7hj(^hhhj:^hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj$^hhhj:^hMubah}(h]j^ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj:^hMhj!^hhubj4)}(hhh]jM)}(h+remove range of pages from an address_spaceh]h+remove range of pages from an address_space}(hj|_hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chMhjy_hhubah}(h]h ]h"]h$]h&]uh1j3hj!^hhhj:^hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj_jHj_jIjJjKuh1hhhhjQhNhNubj)}(hXu**Parameters** ``struct address_space *mapping`` the address_space ``pgoff_t start`` the page offset 'from' which to invalidate ``pgoff_t end`` the page offset 'to' which to invalidate (inclusive) **Description** Any pages which are found to be mapped into pagetables are unmapped prior to invalidation. **Return** -EBUSY if any pages could not be invalidated.h](jM)}(h**Parameters**h]j)}(hj_h]h Parameters}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj_ubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chMhj_ubj)}(hhh](j)}(h4``struct address_space *mapping`` the address_space h](j)}(h!``struct address_space *mapping``h]jS)}(hj_h]hstruct address_space *mapping}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj_ubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chMhj_ubj)}(hhh]jM)}(hthe address_spaceh]hthe address_space}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj_hMhj_ubah}(h]h ]h"]h$]h&]uh1jhj_ubeh}(h]h ]h"]h$]h&]uh1jhj_hMhj_ubj)}(h=``pgoff_t start`` the page offset 'from' which to invalidate h](j)}(h``pgoff_t start``h]jS)}(hj_h]h pgoff_t start}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj_ubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chMhj_ubj)}(hhh]jM)}(h*the page offset 'from' which to invalidateh]h.the page offset ‘from’ which to invalidate}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj `hMhj `ubah}(h]h ]h"]h$]h&]uh1jhj_ubeh}(h]h ]h"]h$]h&]uh1jhj `hMhj_ubj)}(hE``pgoff_t end`` the page offset 'to' which to invalidate (inclusive) h](j)}(h``pgoff_t end``h]jS)}(hj/`h]h pgoff_t end}(hj1`hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj-`ubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chMhj)`ubj)}(hhh]jM)}(h4the page offset 'to' which to invalidate (inclusive)h]h8the page offset ‘to’ which to invalidate (inclusive)}(hjH`hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjD`hMhjE`ubah}(h]h ]h"]h$]h&]uh1jhj)`ubeh}(h]h ]h"]h$]h&]uh1jhjD`hMhj_ubeh}(h]h ]h"]h$]h&]uh1jhj_ubjM)}(h**Description**h]j)}(hjj`h]h Description}(hjl`hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjh`ubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chMhj_ubjM)}(hZAny pages which are found to be mapped into pagetables are unmapped prior to invalidation.h]hZAny pages which are found to be mapped into pagetables are unmapped prior to invalidation.}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chMhj_ubjM)}(h **Return**h]j)}(hj`h]hReturn}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj`ubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chMhj_ubjM)}(h--EBUSY if any pages could not be invalidated.h]h--EBUSY if any pages could not be invalidated.}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chMhj_ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjQhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h$invalidate_inode_pages2 (C function)c.invalidate_inode_pages2hNtauh1hhjQhhhNhNubh)}(hhh](h)}(h;int invalidate_inode_pages2 (struct address_space *mapping)h]h)}(h:int invalidate_inode_pages2(struct address_space *mapping)h](j)}(hinth]hint}(hj`hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj`hhhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chMubj)}(h h]h }(hj`hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj`hhhj`hMubh)}(hinvalidate_inode_pages2h]j)}(hinvalidate_inode_pages2h]hinvalidate_inode_pages2}(hj`hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj`ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj`hhhj`hMubj8)}(h(struct address_space *mapping)h]j>)}(hstruct address_space *mappingh](j)}(hjJ,h]hstruct}(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubj)}(h h]h }(hj ahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubh)}(hhh]j)}(h address_spaceh]h address_space}(hj1ahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj.aubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj3amodnameN classnameNjj)}j]j)}jj`sbc.invalidate_inode_pages2asbuh1hhjaubj)}(h h]h }(hjQahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubjr)}(hjuh]h*}(hj_ahhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjaubj)}(hmappingh]hmapping}(hjlahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj aubah}(h]h ]h"]h$]h&]jjuh1j7hj`hhhj`hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj`hhhj`hMubah}(h]j`ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj`hMhj`hhubj4)}(hhh]jM)}(h&remove all pages from an address_spaceh]h&remove all pages from an address_space}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chMhjahhubah}(h]h ]h"]h$]h&]uh1j3hj`hhhj`hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjajHjajIjJjKuh1hhhhjQhNhNubj)}(h**Parameters** ``struct address_space *mapping`` the address_space **Description** Any pages which are found to be mapped into pagetables are unmapped prior to invalidation. **Return** -EBUSY if any pages could not be invalidated.h](jM)}(h**Parameters**h]j)}(hjah]h Parameters}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1jhjaubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chMhjaubj)}(hhh]j)}(h4``struct address_space *mapping`` the address_space h](j)}(h!``struct address_space *mapping``h]jS)}(hjah]hstruct address_space *mapping}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjaubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chMhjaubj)}(hhh]jM)}(hthe address_spaceh]hthe address_space}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjahMhjaubah}(h]h ]h"]h$]h&]uh1jhjaubeh}(h]h ]h"]h$]h&]uh1jhjahMhjaubah}(h]h ]h"]h$]h&]uh1jhjaubjM)}(h**Description**h]j)}(hjbh]h Description}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjbubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chMhjaubjM)}(hZAny pages which are found to be mapped into pagetables are unmapped prior to invalidation.h]hZAny pages which are found to be mapped into pagetables are unmapped prior to invalidation.}(hj(bhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chMhjaubjM)}(h **Return**h]j)}(hj9bh]hReturn}(hj;bhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj7bubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chM hjaubjM)}(h--EBUSY if any pages could not be invalidated.h]h--EBUSY if any pages could not be invalidated.}(hjObhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chM!hjaubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjQhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](htruncate_pagecache (C function)c.truncate_pagecachehNtauh1hhjQhhhNhNubh)}(hhh](h)}(h=void truncate_pagecache (struct inode *inode, loff_t newsize)h]h)}(h)}(hstruct inode *inodeh](j)}(hjJ,h]hstruct}(hjbhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjbubj)}(h h]h }(hjbhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjbubh)}(hhh]j)}(hinodeh]hinode}(hjbhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjbubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjbmodnameN classnameNjj)}j]j)}jjbsbc.truncate_pagecacheasbuh1hhjbubj)}(h h]h }(hjbhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjbubjr)}(hjuh]h*}(hjchhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjbubj)}(hinodeh]hinode}(hjchhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjbubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjbubj>)}(hloff_t newsizeh](h)}(hhh]j)}(hloff_th]hloff_t}(hj0chhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-cubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj2cmodnameN classnameNjj)}j]jbc.truncate_pagecacheasbuh1hhj)cubj)}(h h]h }(hjNchhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)cubj)}(hnewsizeh]hnewsize}(hj\chhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)cubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjbubeh}(h]h ]h"]h$]h&]jjuh1j7hjzbhhhjbhM*ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjvbhhhjbhM*ubah}(h]jqbah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjbhM*hjsbhhubj4)}(hhh]jM)}(h2unmap and remove pagecache that has been truncatedh]h2unmap and remove pagecache that has been truncated}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chM*hjchhubah}(h]h ]h"]h$]h&]uh1j3hjsbhhhjbhM*ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjcjHjcjIjJjKuh1hhhhjQhNhNubj)}(hX+**Parameters** ``struct inode *inode`` inode ``loff_t newsize`` new file size **Description** inode's new i_size must already be written before truncate_pagecache is called. This function should typically be called before the filesystem releases resources associated with the freed range (eg. deallocates blocks). This way, pagecache will always stay logically coherent with on-disk format, and the filesystem would not have to deal with situations such as writepage being called for a page that has already had its underlying blocks deallocated.h](jM)}(h**Parameters**h]j)}(hjch]h Parameters}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jhjcubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chM.hjcubj)}(hhh](j)}(h``struct inode *inode`` inode h](j)}(h``struct inode *inode``h]jS)}(hjch]hstruct inode *inode}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjcubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chM+hjcubj)}(hhh]jM)}(hinodeh]hinode}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjchM+hjcubah}(h]h ]h"]h$]h&]uh1jhjcubeh}(h]h ]h"]h$]h&]uh1jhjchM+hjcubj)}(h!``loff_t newsize`` new file size h](j)}(h``loff_t newsize``h]jS)}(hjdh]hloff_t newsize}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjcubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chM,hjcubj)}(hhh]jM)}(h new file sizeh]h new file size}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjdhM,hjdubah}(h]h ]h"]h$]h&]uh1jhjcubeh}(h]h ]h"]h$]h&]uh1jhjdhM,hjcubeh}(h]h ]h"]h$]h&]uh1jhjcubjM)}(h**Description**h]j)}(hj;dh]h Description}(hj=dhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj9dubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chM.hjcubjM)}(hOinode's new i_size must already be written before truncate_pagecache is called.h]hQinode’s new i_size must already be written before truncate_pagecache is called.}(hjQdhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chM-hjcubjM)}(hXtThis function should typically be called before the filesystem releases resources associated with the freed range (eg. deallocates blocks). This way, pagecache will always stay logically coherent with on-disk format, and the filesystem would not have to deal with situations such as writepage being called for a page that has already had its underlying blocks deallocated.h]hXtThis function should typically be called before the filesystem releases resources associated with the freed range (eg. deallocates blocks). This way, pagecache will always stay logically coherent with on-disk format, and the filesystem would not have to deal with situations such as writepage being called for a page that has already had its underlying blocks deallocated.}(hj`dhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chM0hjcubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjQhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](htruncate_setsize (C function)c.truncate_setsizehNtauh1hhjQhhhNhNubh)}(hhh](h)}(h;void truncate_setsize (struct inode *inode, loff_t newsize)h]h)}(h:void truncate_setsize(struct inode *inode, loff_t newsize)h](j)}(hvoidh]hvoid}(hjdhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjdhhhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chMMubj)}(h h]h }(hjdhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjdhhhjdhMMubh)}(htruncate_setsizeh]j)}(htruncate_setsizeh]htruncate_setsize}(hjdhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjdubah}(h]h ](jjeh"]h$]h&]jjuh1hhjdhhhjdhMMubj8)}(h%(struct inode *inode, loff_t newsize)h](j>)}(hstruct inode *inodeh](j)}(hjJ,h]hstruct}(hjdhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjdubj)}(h h]h }(hjdhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjdubh)}(hhh]j)}(hinodeh]hinode}(hjdhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjdubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjdmodnameN classnameNjj)}j]j)}jjdsbc.truncate_setsizeasbuh1hhjdubj)}(h h]h }(hj ehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjdubjr)}(hjuh]h*}(hjehhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjdubj)}(hinodeh]hinode}(hj%ehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjdubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjdubj>)}(hloff_t newsizeh](h)}(hhh]j)}(hloff_th]hloff_t}(hjAehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>eubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjCemodnameN classnameNjj)}j]jec.truncate_setsizeasbuh1hhj:eubj)}(h h]h }(hj_ehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:eubj)}(hnewsizeh]hnewsize}(hjmehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:eubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjdubeh}(h]h ]h"]h$]h&]jjuh1j7hjdhhhjdhMMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjdhhhjdhMMubah}(h]jdah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjdhMMhjdhhubj4)}(hhh]jM)}(h.update inode and pagecache for a new file sizeh]h.update inode and pagecache for a new file size}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chMMhjehhubah}(h]h ]h"]h$]h&]uh1j3hjdhhhjdhMMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjejHjejIjJjKuh1hhhhjQhNhNubj)}(hX**Parameters** ``struct inode *inode`` inode ``loff_t newsize`` new file size **Description** truncate_setsize updates i_size and performs pagecache truncation (if necessary) to **newsize**. It will be typically be called from the filesystem's setattr function when ATTR_SIZE is passed in. Must be called with a lock serializing truncates and writes (generally i_rwsem but e.g. xfs uses a different lock) and before all filesystem specific block truncation has been performed.h](jM)}(h**Parameters**h]j)}(hjeh]h Parameters}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1jhjeubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chMQhjeubj)}(hhh](j)}(h``struct inode *inode`` inode h](j)}(h``struct inode *inode``h]jS)}(hjeh]hstruct inode *inode}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjeubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chMNhjeubj)}(hhh]jM)}(hinodeh]hinode}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjehMNhjeubah}(h]h ]h"]h$]h&]uh1jhjeubeh}(h]h ]h"]h$]h&]uh1jhjehMNhjeubj)}(h!``loff_t newsize`` new file size h](j)}(h``loff_t newsize``h]jS)}(hjfh]hloff_t newsize}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjfubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chMOhj fubj)}(hhh]jM)}(h new file sizeh]h new file size}(hj*fhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj&fhMOhj'fubah}(h]h ]h"]h$]h&]uh1jhj fubeh}(h]h ]h"]h$]h&]uh1jhj&fhMOhjeubeh}(h]h ]h"]h$]h&]uh1jhjeubjM)}(h**Description**h]j)}(hjLfh]h Description}(hjNfhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjJfubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chMQhjeubjM)}(htruncate_setsize updates i_size and performs pagecache truncation (if necessary) to **newsize**. It will be typically be called from the filesystem's setattr function when ATTR_SIZE is passed in.h](hTtruncate_setsize updates i_size and performs pagecache truncation (if necessary) to }(hjbfhhhNhNubj)}(h **newsize**h]hnewsize}(hjjfhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjbfubhf. It will be typically be called from the filesystem’s setattr function when ATTR_SIZE is passed in.}(hjbfhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chMPhjeubjM)}(hMust be called with a lock serializing truncates and writes (generally i_rwsem but e.g. xfs uses a different lock) and before all filesystem specific block truncation has been performed.h]hMust be called with a lock serializing truncates and writes (generally i_rwsem but e.g. xfs uses a different lock) and before all filesystem specific block truncation has been performed.}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chMThjeubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjQhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h%pagecache_isize_extended (C function)c.pagecache_isize_extendedhNtauh1hhjQhhhNhNubh)}(hhh](h)}(hKvoid pagecache_isize_extended (struct inode *inode, loff_t from, loff_t to)h]h)}(hJvoid pagecache_isize_extended(struct inode *inode, loff_t from, loff_t to)h](j)}(hvoidh]hvoid}(hjfhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjfhhhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chMeubj)}(h h]h }(hjfhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjfhhhjfhMeubh)}(hpagecache_isize_extendedh]j)}(hpagecache_isize_extendedh]hpagecache_isize_extended}(hjfhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjfubah}(h]h ](jjeh"]h$]h&]jjuh1hhjfhhhjfhMeubj8)}(h-(struct inode *inode, loff_t from, loff_t to)h](j>)}(hstruct inode *inodeh](j)}(hjJ,h]hstruct}(hjfhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjfubj)}(h h]h }(hjfhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjfubh)}(hhh]j)}(hinodeh]hinode}(hj ghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj gubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjgmodnameN classnameNjj)}j]j)}jjfsbc.pagecache_isize_extendedasbuh1hhjfubj)}(h h]h }(hj-ghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjfubjr)}(hjuh]h*}(hj;ghhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjfubj)}(hinodeh]hinode}(hjHghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjfubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjfubj>)}(h loff_t fromh](h)}(hhh]j)}(hloff_th]hloff_t}(hjdghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjagubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjfgmodnameN classnameNjj)}j]j)gc.pagecache_isize_extendedasbuh1hhj]gubj)}(h h]h }(hjghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj]gubj)}(hfromh]hfrom}(hjghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj]gubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjfubj>)}(h loff_t toh](h)}(hhh]j)}(hloff_th]hloff_t}(hjghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjgmodnameN classnameNjj)}j]j)gc.pagecache_isize_extendedasbuh1hhjgubj)}(h h]h }(hjghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubj)}(htoh]hto}(hjghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjfubeh}(h]h ]h"]h$]h&]jjuh1j7hjfhhhjfhMeubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjfhhhjfhMeubah}(h]jfah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjfhMehjfhhubj4)}(hhh]jM)}(h*update pagecache after extension of i_sizeh]h*update pagecache after extension of i_size}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chMehjghhubah}(h]h ]h"]h$]h&]uh1j3hjfhhhjfhMeubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjhjHjhjIjJjKuh1hhhhjQhNhNubj)}(hXq**Parameters** ``struct inode *inode`` inode for which i_size was extended ``loff_t from`` original inode size ``loff_t to`` new inode size **Description** Handle extension of inode size either caused by extending truncate or by write starting after current i_size. We mark the page straddling current i_size RO so that page_mkwrite() is called on the first write access to the page. The filesystem will update its per-block information before user writes to the page via mmap after the i_size has been changed. The function must be called after i_size is updated so that page fault coming after we unlock the folio will already see the new i_size. The function must be called while we still hold i_rwsem - this not only makes sure i_size is stable but also that userspace cannot observe new i_size value before we are prepared to store mmap writes at new inode size.h](jM)}(h**Parameters**h]j)}(hj$hh]h Parameters}(hj&hhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj"hubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chMihjhubj)}(hhh](j)}(h<``struct inode *inode`` inode for which i_size was extended h](j)}(h``struct inode *inode``h]jS)}(hjChh]hstruct inode *inode}(hjEhhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjAhubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chMfhj=hubj)}(hhh]jM)}(h#inode for which i_size was extendedh]h#inode for which i_size was extended}(hj\hhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjXhhMfhjYhubah}(h]h ]h"]h$]h&]uh1jhj=hubeh}(h]h ]h"]h$]h&]uh1jhjXhhMfhj:hubj)}(h$``loff_t from`` original inode size h](j)}(h``loff_t from``h]jS)}(hj|hh]h loff_t from}(hj~hhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjzhubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chMghjvhubj)}(hhh]jM)}(horiginal inode sizeh]horiginal inode size}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhhMghjhubah}(h]h ]h"]h$]h&]uh1jhjvhubeh}(h]h ]h"]h$]h&]uh1jhjhhMghj:hubj)}(h``loff_t to`` new inode size h](j)}(h ``loff_t to``h]jS)}(hjhh]h loff_t to}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjhubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chMhhjhubj)}(hhh]jM)}(hnew inode sizeh]hnew inode size}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhhMhhjhubah}(h]h ]h"]h$]h&]uh1jhjhubeh}(h]h ]h"]h$]h&]uh1jhjhhMhhj:hubeh}(h]h ]h"]h$]h&]uh1jhjhubjM)}(h**Description**h]j)}(hjhh]h Description}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjhubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chMjhjhubjM)}(hXeHandle extension of inode size either caused by extending truncate or by write starting after current i_size. We mark the page straddling current i_size RO so that page_mkwrite() is called on the first write access to the page. The filesystem will update its per-block information before user writes to the page via mmap after the i_size has been changed.h]hXeHandle extension of inode size either caused by extending truncate or by write starting after current i_size. We mark the page straddling current i_size RO so that page_mkwrite() is called on the first write access to the page. The filesystem will update its per-block information before user writes to the page via mmap after the i_size has been changed.}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chMihjhubjM)}(hXcThe function must be called after i_size is updated so that page fault coming after we unlock the folio will already see the new i_size. The function must be called while we still hold i_rwsem - this not only makes sure i_size is stable but also that userspace cannot observe new i_size value before we are prepared to store mmap writes at new inode size.h]hXcThe function must be called after i_size is updated so that page fault coming after we unlock the folio will already see the new i_size. The function must be called while we still hold i_rwsem - this not only makes sure i_size is stable but also that userspace cannot observe new i_size value before we are prepared to store mmap writes at new inode size.}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chMphjhubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjQhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h%truncate_pagecache_range (C function)c.truncate_pagecache_rangehNtauh1hhjQhhhNhNubh)}(hhh](h)}(hOvoid truncate_pagecache_range (struct inode *inode, loff_t lstart, loff_t lend)h]h)}(hNvoid truncate_pagecache_range(struct inode *inode, loff_t lstart, loff_t lend)h](j)}(hvoidh]hvoid}(hjDihhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@ihhhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:95: ./mm/truncate.chMubj)}(h h]h }(hjSihhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@ihhhjRihMubh)}(htruncate_pagecache_rangeh]j)}(htruncate_pagecache_rangeh]htruncate_pagecache_range}(hjeihhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaiubah}(h]h ](jjeh"]h$]h&]jjuh1hhj@ihhhjRihMubj8)}(h1(struct inode *inode, loff_t lstart, loff_t lend)h](j>)}(hstruct inode *inodeh](j)}(hjJ,h]hstruct}(hjihhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj}iubj)}(h h]h }(hjihhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj}iubh)}(hhh]j)}(hinodeh]hinode}(hjihhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjiubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjimodnameN classnameNjj)}j]j)}jjgisbc.truncate_pagecache_rangeasbuh1hhj}iubj)}(h h]h }(hjihhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj}iubjr)}(hjuh]h*}(hjihhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj}iubj)}(hinodeh]hinode}(hjihhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj}iubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjyiubj>)}(h loff_t lstarth](h)}(hhh]j)}(hloff_th]hloff_t}(hjihhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjiubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjimodnameN classnameNjj)}j]jic.truncate_pagecache_rangeasbuh1hhjiubj)}(h h]h }(hjjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjiubj)}(hlstarth]hlstart}(hj"jhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjiubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjyiubj>)}(h loff_t lendh](h)}(hhh]j)}(hloff_th]hloff_t}(hj>jhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;jubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj@jmodnameN classnameNjj)}j]jic.truncate_pagecache_rangeasbuh1hhj7jubj)}(h h]h }(hj\jhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7jubj)}(hlendh]hlend}(hjjjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7jubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjyiubeh}(h]h ]h"]h$]h&]jjuh1j7hj@ihhhjRihMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj)}(hstruct address_space *mappingh](j)}(hjJ,h]hstruct}(hjlhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjlubj)}(h h]h }(hjlhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjlubh)}(hhh]j)}(h address_spaceh]h address_space}(hj"lhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjlubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj$lmodnameN classnameNjj)}j]j)}jjksbc.filemap_set_wb_errasbuh1hhjlubj)}(h h]h }(hjBlhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjlubjr)}(hjuh]h*}(hjPlhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjlubj)}(hmappingh]hmapping}(hj]lhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjlubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjkubj>)}(hint errh](j)}(hinth]hint}(hjvlhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjrlubj)}(h h]h }(hjlhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjrlubj)}(herrh]herr}(hjlhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjrlubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjkubeh}(h]h ]h"]h$]h&]jjuh1j7hjkhhhjkhKDubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjkhhhjkhKDubah}(h]jkah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjkhKDhjkhhubj4)}(hhh]jM)}(h)set a writeback error on an address_spaceh]h)set a writeback error on an address_space}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhKDhjlhhubah}(h]h ]h"]h$]h&]uh1j3hjkhhhjkhKDubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjljHjljIjJjKuh1hhhhjQhNhNubj)}(hX**Parameters** ``struct address_space *mapping`` mapping in which to set writeback error ``int err`` error to be set in mapping **Description** When writeback fails in some way, we must record that error so that userspace can be informed when fsync and the like are called. We endeavor to report errors on any file that was open at the time of the error. Some internal callers also need to know when writeback errors have occurred. When a writeback error occurs, most filesystems will want to call filemap_set_wb_err to record the error in the mapping so that it will be automatically reported whenever fsync is called on the file.h](jM)}(h**Parameters**h]j)}(hjlh]h Parameters}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjlubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhKHhjlubj)}(hhh](j)}(hJ``struct address_space *mapping`` mapping in which to set writeback error h](j)}(h!``struct address_space *mapping``h]jS)}(hjlh]hstruct address_space *mapping}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjlubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhKEhjlubj)}(hhh]jM)}(h'mapping in which to set writeback errorh]h'mapping in which to set writeback error}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjmhKEhjmubah}(h]h ]h"]h$]h&]uh1jhjlubeh}(h]h ]h"]h$]h&]uh1jhjmhKEhjlubj)}(h'``int err`` error to be set in mapping h](j)}(h ``int err``h]jS)}(hj6mh]hint err}(hj8mhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj4mubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhKFhj0mubj)}(hhh]jM)}(herror to be set in mappingh]herror to be set in mapping}(hjOmhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjKmhKFhjLmubah}(h]h ]h"]h$]h&]uh1jhj0mubeh}(h]h ]h"]h$]h&]uh1jhjKmhKFhjlubeh}(h]h ]h"]h$]h&]uh1jhjlubjM)}(h**Description**h]j)}(hjqmh]h Description}(hjsmhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjomubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhKHhjlubjM)}(hX!When writeback fails in some way, we must record that error so that userspace can be informed when fsync and the like are called. We endeavor to report errors on any file that was open at the time of the error. Some internal callers also need to know when writeback errors have occurred.h]hX!When writeback fails in some way, we must record that error so that userspace can be informed when fsync and the like are called. We endeavor to report errors on any file that was open at the time of the error. Some internal callers also need to know when writeback errors have occurred.}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhKGhjlubjM)}(hWhen a writeback error occurs, most filesystems will want to call filemap_set_wb_err to record the error in the mapping so that it will be automatically reported whenever fsync is called on the file.h]hWhen a writeback error occurs, most filesystems will want to call filemap_set_wb_err to record the error in the mapping so that it will be automatically reported whenever fsync is called on the file.}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhKLhjlubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjQhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h!filemap_check_wb_err (C function)c.filemap_check_wb_errhNtauh1hhjQhhhNhNubh)}(hhh](h)}(hHint filemap_check_wb_err (struct address_space *mapping, errseq_t since)h]h)}(hGint filemap_check_wb_err(struct address_space *mapping, errseq_t since)h](j)}(hinth]hint}(hjmhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmhhhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhKYubj)}(h h]h }(hjmhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmhhhjmhKYubh)}(hfilemap_check_wb_errh]j)}(hfilemap_check_wb_errh]hfilemap_check_wb_err}(hjmhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmubah}(h]h ](jjeh"]h$]h&]jjuh1hhjmhhhjmhKYubj8)}(h/(struct address_space *mapping, errseq_t since)h](j>)}(hstruct address_space *mappingh](j)}(hjJ,h]hstruct}(hjnhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmubj)}(h h]h }(hjnhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmubh)}(hhh]j)}(h address_spaceh]h address_space}(hj nhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj"nmodnameN classnameNjj)}j]j)}jjmsbc.filemap_check_wb_errasbuh1hhjmubj)}(h h]h }(hj@nhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmubjr)}(hjuh]h*}(hjNnhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjmubj)}(hmappingh]hmapping}(hj[nhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjmubj>)}(herrseq_t sinceh](h)}(hhh]j)}(herrseq_th]herrseq_t}(hjwnhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjtnubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjynmodnameN classnameNjj)}j]jerrseq_t filemap_sample_wb_err (struct address_space *mapping)h]h)}(h=errseq_t filemap_sample_wb_err(struct address_space *mapping)h](h)}(hhh]j)}(herrseq_th]herrseq_t}(hjohhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjoubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjomodnameN classnameNjj)}j]j)}jfilemap_sample_wb_errsbc.filemap_sample_wb_errasbuh1hhjohhhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhKiubj)}(h h]h }(hjohhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjohhhjohKiubh)}(hfilemap_sample_wb_errh]j)}(hjoh]hfilemap_sample_wb_err}(hj phhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj pubah}(h]h ](jjeh"]h$]h&]jjuh1hhjohhhjohKiubj8)}(h(struct address_space *mapping)h]j>)}(hstruct address_space *mappingh](j)}(hjJ,h]hstruct}(hj(phhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$pubj)}(h h]h }(hj5phhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$pubh)}(hhh]j)}(h address_spaceh]h address_space}(hjFphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCpubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjHpmodnameN classnameNjj)}j]joc.filemap_sample_wb_errasbuh1hhj$pubj)}(h h]h }(hjdphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$pubjr)}(hjuh]h*}(hjrphhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj$pubj)}(hmappingh]hmapping}(hjphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$pubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj pubah}(h]h ]h"]h$]h&]jjuh1j7hjohhhjohKiubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjohhhjohKiubah}(h]joah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjohKihjohhubj4)}(hhh]jM)}(h4sample the current errseq_t to test for later errorsh]h4sample the current errseq_t to test for later errors}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhKihjphhubah}(h]h ]h"]h$]h&]uh1j3hjohhhjohKiubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjpjHjpjIjJjKuh1hhhhjQhNhNubj)}(h**Parameters** ``struct address_space *mapping`` mapping to be sampled **Description** Writeback errors are always reported relative to a particular sample point in the past. This function provides those sample points.h](jM)}(h**Parameters**h]j)}(hjph]h Parameters}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1jhjpubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhKmhjpubj)}(hhh]j)}(h8``struct address_space *mapping`` mapping to be sampled h](j)}(h!``struct address_space *mapping``h]jS)}(hjph]hstruct address_space *mapping}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjpubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhKjhjpubj)}(hhh]jM)}(hmapping to be sampledh]hmapping to be sampled}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjphKjhjqubah}(h]h ]h"]h$]h&]uh1jhjpubeh}(h]h ]h"]h$]h&]uh1jhjphKjhjpubah}(h]h ]h"]h$]h&]uh1jhjpubjM)}(h**Description**h]j)}(hj%qh]h Description}(hj'qhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj#qubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhKlhjpubjM)}(hWriteback errors are always reported relative to a particular sample point in the past. This function provides those sample points.h]hWriteback errors are always reported relative to a particular sample point in the past. This function provides those sample points.}(hj;qhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhKkhjpubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjQhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfile_sample_sb_err (C function)c.file_sample_sb_errhNtauh1hhjQhhhNhNubh)}(hhh](h)}(h/errseq_t file_sample_sb_err (struct file *file)h]h)}(h.errseq_t file_sample_sb_err(struct file *file)h](h)}(hhh]j)}(herrseq_th]herrseq_t}(hjmqhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjjqubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjoqmodnameN classnameNjj)}j]j)}jfile_sample_sb_errsbc.file_sample_sb_errasbuh1hhjfqhhhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhKuubj)}(h h]h }(hjqhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjfqhhhjqhKuubh)}(hfile_sample_sb_errh]j)}(hjqh]hfile_sample_sb_err}(hjqhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjqubah}(h]h ](jjeh"]h$]h&]jjuh1hhjfqhhhjqhKuubj8)}(h(struct file *file)h]j>)}(hstruct file *fileh](j)}(hjJ,h]hstruct}(hjqhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjqubj)}(h h]h }(hjqhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjqubh)}(hhh]j)}(hfileh]hfile}(hjqhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjqubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjqmodnameN classnameNjj)}j]jqc.file_sample_sb_errasbuh1hhjqubj)}(h h]h }(hjqhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjqubjr)}(hjuh]h*}(hjrhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjqubj)}(hfileh]hfile}(hjrhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjqubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjqubah}(h]h ]h"]h$]h&]jjuh1j7hjfqhhhjqhKuubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjbqhhhjqhKuubah}(h]j]qah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjqhKuhj_qhhubj4)}(hhh]jM)}(h4sample the current errseq_t to test for later errorsh]h4sample the current errseq_t to test for later errors}(hj=rhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhKuhj:rhhubah}(h]h ]h"]h$]h&]uh1j3hj_qhhhjqhKuubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjUrjHjUrjIjJjKuh1hhhhjQhNhNubj)}(h**Parameters** ``struct file *file`` file pointer to be sampled **Description** Grab the most current superblock-level errseq_t value for the given struct file.h](jM)}(h**Parameters**h]j)}(hj_rh]h Parameters}(hjarhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj]rubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhKyhjYrubj)}(hhh]j)}(h1``struct file *file`` file pointer to be sampled h](j)}(h``struct file *file``h]jS)}(hj~rh]hstruct file *file}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj|rubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhKvhjxrubj)}(hhh]jM)}(hfile pointer to be sampledh]hfile pointer to be sampled}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjrhKvhjrubah}(h]h ]h"]h$]h&]uh1jhjxrubeh}(h]h ]h"]h$]h&]uh1jhjrhKvhjurubah}(h]h ]h"]h$]h&]uh1jhjYrubjM)}(h**Description**h]j)}(hjrh]h Description}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjrubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhKxhjYrubjM)}(hPGrab the most current superblock-level errseq_t value for the given struct file.h]hPGrab the most current superblock-level errseq_t value for the given struct file.}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhKwhjYrubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjQhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hmapping_set_error (C function)c.mapping_set_errorhNtauh1hhjQhhhNhNubh)}(hhh](h)}(hAvoid mapping_set_error (struct address_space *mapping, int error)h]h)}(h@void mapping_set_error(struct address_space *mapping, int error)h](j)}(hvoidh]hvoid}(hjrhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjrhhhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhKubj)}(h h]h }(hj shhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjrhhhj shKubh)}(hmapping_set_errorh]j)}(hmapping_set_errorh]hmapping_set_error}(hjshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjsubah}(h]h ](jjeh"]h$]h&]jjuh1hhjrhhhj shKubj8)}(h*(struct address_space *mapping, int error)h](j>)}(hstruct address_space *mappingh](j)}(hjJ,h]hstruct}(hj;shhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7subj)}(h h]h }(hjHshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7subh)}(hhh]j)}(h address_spaceh]h address_space}(hjYshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVsubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj[smodnameN classnameNjj)}j]j)}jj!ssbc.mapping_set_errorasbuh1hhj7subj)}(h h]h }(hjyshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7subjr)}(hjuh]h*}(hjshhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj7subj)}(hmappingh]hmapping}(hjshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7subeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj3subj>)}(h int errorh](j)}(hinth]hint}(hjshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjsubj)}(h h]h }(hjshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjsubj)}(herrorh]herror}(hjshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjsubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj3subeh}(h]h ]h"]h$]h&]jjuh1j7hjrhhhj shKubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjrhhhj shKubah}(h]jrah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj shKhjrhhubj4)}(hhh]jM)}(h-record a writeback error in the address_spaceh]h-record a writeback error in the address_space}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhKhjshhubah}(h]h ]h"]h$]h&]uh1j3hjrhhhj shKubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj tjHj tjIjJjKuh1hhhhjQhNhNubj)}(hX|**Parameters** ``struct address_space *mapping`` the mapping in which an error should be set ``int error`` the error to set in the mapping **Description** When writeback fails in some way, we must record that error so that userspace can be informed when fsync and the like are called. We endeavor to report errors on any file that was open at the time of the error. Some internal callers also need to know when writeback errors have occurred. When a writeback error occurs, most filesystems will want to call mapping_set_error to record the error in the mapping so that it can be reported when the application calls fsync(2).h](jM)}(h**Parameters**h]j)}(hjth]h Parameters}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jhjtubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhKhjtubj)}(hhh](j)}(hN``struct address_space *mapping`` the mapping in which an error should be set h](j)}(h!``struct address_space *mapping``h]jS)}(hj4th]hstruct address_space *mapping}(hj6thhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj2tubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhKhj.tubj)}(hhh]jM)}(h+the mapping in which an error should be seth]h+the mapping in which an error should be set}(hjMthhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjIthKhjJtubah}(h]h ]h"]h$]h&]uh1jhj.tubeh}(h]h ]h"]h$]h&]uh1jhjIthKhj+tubj)}(h.``int error`` the error to set in the mapping h](j)}(h ``int error``h]jS)}(hjmth]h int error}(hjothhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjktubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhKhjgtubj)}(hhh]jM)}(hthe error to set in the mappingh]hthe error to set in the mapping}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjthKhjtubah}(h]h ]h"]h$]h&]uh1jhjgtubeh}(h]h ]h"]h$]h&]uh1jhjthKhj+tubeh}(h]h ]h"]h$]h&]uh1jhjtubjM)}(h**Description**h]j)}(hjth]h Description}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jhjtubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhKhjtubjM)}(hX!When writeback fails in some way, we must record that error so that userspace can be informed when fsync and the like are called. We endeavor to report errors on any file that was open at the time of the error. Some internal callers also need to know when writeback errors have occurred.h]hX!When writeback fails in some way, we must record that error so that userspace can be informed when fsync and the like are called. We endeavor to report errors on any file that was open at the time of the error. Some internal callers also need to know when writeback errors have occurred.}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhKhjtubjM)}(hWhen a writeback error occurs, most filesystems will want to call mapping_set_error to record the error in the mapping so that it can be reported when the application calls fsync(2).h]hWhen a writeback error occurs, most filesystems will want to call mapping_set_error to record the error in the mapping so that it can be reported when the application calls fsync(2).}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhKhjtubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjQhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h%mapping_set_large_folios (C function)c.mapping_set_large_folioshNtauh1hhjQhhhNhNubh)}(hhh](h)}(h=void mapping_set_large_folios (struct address_space *mapping)h]h)}(h)}(hstruct address_space *mappingh](j)}(hjJ,h]hstruct}(hj9uhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5uubj)}(h h]h }(hjFuhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5uubh)}(hhh]j)}(h address_spaceh]h address_space}(hjWuhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjTuubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjYumodnameN classnameNjj)}j]j)}jjusbc.mapping_set_large_foliosasbuh1hhj5uubj)}(h h]h }(hjwuhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5uubjr)}(hjuh]h*}(hjuhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj5uubj)}(hmappingh]hmapping}(hjuhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5uubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj1uubah}(h]h ]h"]h$]h&]jjuh1j7hjthhhj uhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjthhhj uhMubah}(h]jtah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj uhMhjthhubj4)}(hhh]jM)}(h(Indicate the file supports large folios.h]h(Indicate the file supports large folios.}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjuhhubah}(h]h ]h"]h$]h&]uh1j3hjthhhj uhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjujHjujIjJjKuh1hhhhjQhNhNubj)}(hXN**Parameters** ``struct address_space *mapping`` The address space of the file. **Description** The filesystem should call this function in its inode constructor to indicate that the VFS can use large folios to cache the contents of the file. **Context** This should not be called while the inode is active as it is non-atomic.h](jM)}(h**Parameters**h]j)}(hjuh]h Parameters}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjuubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjuubj)}(hhh]j)}(hA``struct address_space *mapping`` The address space of the file. h](j)}(h!``struct address_space *mapping``h]jS)}(hjuh]hstruct address_space *mapping}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjuubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjuubj)}(hhh]jM)}(hThe address space of the file.h]hThe address space of the file.}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjvhMhjvubah}(h]h ]h"]h$]h&]uh1jhjuubeh}(h]h ]h"]h$]h&]uh1jhjvhMhjuubah}(h]h ]h"]h$]h&]uh1jhjuubjM)}(h**Description**h]j)}(hj8vh]h Description}(hj:vhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj6vubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjuubjM)}(hThe filesystem should call this function in its inode constructor to indicate that the VFS can use large folios to cache the contents of the file.h]hThe filesystem should call this function in its inode constructor to indicate that the VFS can use large folios to cache the contents of the file.}(hjNvhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hMhMhjuubjM)}(h **Context**h]j)}(hj_vh]hContext}(hjavhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj]vubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjuubjM)}(hHThis should not be called while the inode is active as it is non-atomic.h]hHThis should not be called while the inode is active as it is non-atomic.}(hjuvhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjuubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjQhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h mapping_align_index (C function)c.mapping_align_indexhNtauh1hhjQhhhNhNubh)}(hhh](h)}(hPpgoff_t mapping_align_index (const struct address_space *mapping, pgoff_t index)h]h)}(hOpgoff_t mapping_align_index(const struct address_space *mapping, pgoff_t index)h](h)}(hhh]j)}(hpgoff_th]hpgoff_t}(hjvhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjvmodnameN classnameNjj)}j]j)}jmapping_align_indexsbc.mapping_align_indexasbuh1hhjvhhhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMubj)}(h h]h }(hjvhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvhhhjvhMubh)}(hmapping_align_indexh]j)}(hjvh]hmapping_align_index}(hjvhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvubah}(h]h ](jjeh"]h$]h&]jjuh1hhjvhhhjvhMubj8)}(h4(const struct address_space *mapping, pgoff_t index)h](j>)}(h#const struct address_space *mappingh](j)}(hjh]hconst}(hjvhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvubj)}(h h]h }(hjwhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvubj)}(hjJ,h]hstruct}(hjwhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvubj)}(h h]h }(hjwhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvubh)}(hhh]j)}(h address_spaceh]h address_space}(hj/whhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,wubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj1wmodnameN classnameNjj)}j]jvc.mapping_align_indexasbuh1hhjvubj)}(h h]h }(hjMwhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvubjr)}(hjuh]h*}(hj[whhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjvubj)}(hmappingh]hmapping}(hjhwhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjvubj>)}(h pgoff_t indexh](h)}(hhh]j)}(hpgoff_th]hpgoff_t}(hjwhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjwubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjwmodnameN classnameNjj)}j]jvc.mapping_align_indexasbuh1hhj}wubj)}(h h]h }(hjwhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj}wubj)}(hindexh]hindex}(hjwhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj}wubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjvubeh}(h]h ]h"]h$]h&]jjuh1j7hjvhhhjvhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjvhhhjvhMubah}(h]jvah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjvhMhjvhhubj4)}(hhh]jM)}(hAlign index for this mapping.h]hAlign index for this mapping.}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjwhhubah}(h]h ]h"]h$]h&]uh1j3hjvhhhjvhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjwjHjwjIjJjKuh1hhhhjQhNhNubj)}(hX **Parameters** ``const struct address_space *mapping`` The address_space. ``pgoff_t index`` The page index. **Description** The index of a folio must be naturally aligned. If you are adding a new folio to the page cache and need to know what index to give it, call this function.h](jM)}(h**Parameters**h]j)}(hjwh]h Parameters}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjwubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjwubj)}(hhh](j)}(h;``const struct address_space *mapping`` The address_space. h](j)}(h'``const struct address_space *mapping``h]jS)}(hjxh]h#const struct address_space *mapping}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjxubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjxubj)}(hhh]jM)}(hThe address_space.h]hThe address_space.}(hj4xhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj0xhMhj1xubah}(h]h ]h"]h$]h&]uh1jhjxubeh}(h]h ]h"]h$]h&]uh1jhj0xhMhjxubj)}(h"``pgoff_t index`` The page index. h](j)}(h``pgoff_t index``h]jS)}(hjTxh]h pgoff_t index}(hjVxhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjRxubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjNxubj)}(hhh]jM)}(hThe page index.h]hThe page index.}(hjmxhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjixhMhjjxubah}(h]h ]h"]h$]h&]uh1jhjNxubeh}(h]h ]h"]h$]h&]uh1jhjixhMhjxubeh}(h]h ]h"]h$]h&]uh1jhjwubjM)}(h**Description**h]j)}(hjxh]h Description}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjxubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjwubjM)}(hThe index of a folio must be naturally aligned. If you are adding a new folio to the page cache and need to know what index to give it, call this function.h]hThe index of a folio must be naturally aligned. If you are adding a new folio to the page cache and need to know what index to give it, call this function.}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjwubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjQhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h&mapping_pmd_folio_support (C function)c.mapping_pmd_folio_supporthNtauh1hhjQhhhNhNubh)}(hhh](h)}(hDbool mapping_pmd_folio_support (const struct address_space *mapping)h]h)}(hCbool mapping_pmd_folio_support(const struct address_space *mapping)h](j)}(hjh]hbool}(hjxhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjxhhhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMubj)}(h h]h }(hjxhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjxhhhjxhMubh)}(hmapping_pmd_folio_supporth]j)}(hmapping_pmd_folio_supporth]hmapping_pmd_folio_support}(hjxhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjxubah}(h]h ](jjeh"]h$]h&]jjuh1hhjxhhhjxhMubj8)}(h%(const struct address_space *mapping)h]j>)}(h#const struct address_space *mappingh](j)}(hjh]hconst}(hjyhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj yubj)}(h h]h }(hjyhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj yubj)}(hjJ,h]hstruct}(hj+yhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj yubj)}(h h]h }(hj8yhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj yubh)}(hhh]j)}(h address_spaceh]h address_space}(hjIyhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFyubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjKymodnameN classnameNjj)}j]j)}jjxsbc.mapping_pmd_folio_supportasbuh1hhj yubj)}(h h]h }(hjiyhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj yubjr)}(hjuh]h*}(hjwyhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj yubj)}(hmappingh]hmapping}(hjyhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj yubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjyubah}(h]h ]h"]h$]h&]jjuh1j7hjxhhhjxhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjxhhhjxhMubah}(h]jxah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjxhMhjxhhubj4)}(hhh]jM)}(h+Check if a mapping supports PMD-sized folioh]h+Check if a mapping supports PMD-sized folio}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjyhhubah}(h]h ]h"]h$]h&]uh1j3hjxhhhjxhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjyjHjyjIjJjKuh1hhhhjQhNhNubj)}(hX**Parameters** ``const struct address_space *mapping`` The address_space **Description** While some mappings support large folios, they might not support PMD-sized folios. This function checks whether a mapping supports PMD-sized folios. For example, khugepaged needs this information before attempting to collapsing THPs. **Return** True if PMD-sized folios are supported, otherwise false.h](jM)}(h**Parameters**h]j)}(hjyh]h Parameters}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjyubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjyubj)}(hhh]j)}(h:``const struct address_space *mapping`` The address_space h](j)}(h'``const struct address_space *mapping``h]jS)}(hjyh]h#const struct address_space *mapping}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjyubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjyubj)}(hhh]jM)}(hThe address_spaceh]hThe address_space}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjzhMhjzubah}(h]h ]h"]h$]h&]uh1jhjyubeh}(h]h ]h"]h$]h&]uh1jhjzhMhjyubah}(h]h ]h"]h$]h&]uh1jhjyubjM)}(h**Description**h]j)}(hj*zh]h Description}(hj,zhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj(zubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjyubjM)}(hWhile some mappings support large folios, they might not support PMD-sized folios. This function checks whether a mapping supports PMD-sized folios. For example, khugepaged needs this information before attempting to collapsing THPs.h]hWhile some mappings support large folios, they might not support PMD-sized folios. This function checks whether a mapping supports PMD-sized folios. For example, khugepaged needs this information before attempting to collapsing THPs.}(hj@zhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjyubjM)}(h **Return**h]j)}(hjQzh]hReturn}(hjSzhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjOzubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM hjyubjM)}(h8True if PMD-sized folios are supported, otherwise false.h]h8True if PMD-sized folios are supported, otherwise false.}(hjgzhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM hjyubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjQhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h folio_flush_mapping (C function)c.folio_flush_mappinghNtauh1hhjQhhhNhNubh)}(hhh](h)}(h@struct address_space * folio_flush_mapping (struct folio *folio)h]h)}(h>struct address_space *folio_flush_mapping(struct folio *folio)h](j)}(hjJ,h]hstruct}(hjzhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjzhhhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM'ubj)}(h h]h }(hjzhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjzhhhjzhM'ubh)}(hhh]j)}(h address_spaceh]h address_space}(hjzhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjzubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjzmodnameN classnameNjj)}j]j)}jfolio_flush_mappingsbc.folio_flush_mappingasbuh1hhjzhhhjzhM'ubj)}(h h]h }(hjzhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjzhhhjzhM'ubjr)}(hjuh]h*}(hjzhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjzhhhjzhM'ubh)}(hfolio_flush_mappingh]j)}(hjzh]hfolio_flush_mapping}(hjzhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjzubah}(h]h ](jjeh"]h$]h&]jjuh1hhjzhhhjzhM'ubj8)}(h(struct folio *folio)h]j>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hj{hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj {ubj)}(h h]h }(hj{hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj {ubh)}(hhh]j)}(hfolioh]hfolio}(hj.{hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+{ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj0{modnameN classnameNjj)}j]jzc.folio_flush_mappingasbuh1hhj {ubj)}(h h]h }(hjL{hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj {ubjr)}(hjuh]h*}(hjZ{hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj {ubj)}(hfolioh]hfolio}(hjg{hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj {ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj{ubah}(h]h ]h"]h$]h&]jjuh1j7hjzhhhjzhM'ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjzhhhjzhM'ubah}(h]jzah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjzhM'hjzhhubj4)}(hhh]jM)}(h,Find the file mapping this folio belongs to.h]h,Find the file mapping this folio belongs to.}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM'hj{hhubah}(h]h ]h"]h$]h&]uh1j3hjzhhhjzhM'ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj{jHj{jIjJjKuh1hhhhjQhNhNubj)}(hX**Parameters** ``struct folio *folio`` The folio. **Description** For folios which are in the page cache, return the mapping that this page belongs to. Anonymous folios return NULL, even if they're in the swap cache. Other kinds of folio also return NULL. This is ONLY used by architecture cache flushing code. If you aren't writing cache flushing code, you want either folio_mapping() or folio_file_mapping().h](jM)}(h**Parameters**h]j)}(hj{h]h Parameters}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj{ubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM+hj{ubj)}(hhh]j)}(h#``struct folio *folio`` The folio. h](j)}(h``struct folio *folio``h]jS)}(hj{h]hstruct folio *folio}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj{ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM(hj{ubj)}(hhh]jM)}(h The folio.h]h The folio.}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj{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{ubjM)}(h**Description**h]j)}(hj |h]h Description}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj |ubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM*hj{ubjM)}(hFor folios which are in the page cache, return the mapping that this page belongs to. Anonymous folios return NULL, even if they're in the swap cache. Other kinds of folio also return NULL.h]hFor folios which are in the page cache, return the mapping that this page belongs to. Anonymous folios return NULL, even if they’re in the swap cache. Other kinds of folio also return NULL.}(hj#|hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM)hj{ubjM)}(hThis is ONLY used by architecture cache flushing code. If you aren't writing cache flushing code, you want either folio_mapping() or folio_file_mapping().h]hThis is ONLY used by architecture cache flushing code. If you aren’t writing cache flushing code, you want either folio_mapping() or folio_file_mapping().}(hj2|hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM-hj{ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjQhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfolio_inode (C function) c.folio_inodehNtauh1hhjQhhhNhNubh)}(hhh](h)}(h0struct inode * folio_inode (struct folio *folio)h]h)}(h.struct inode *folio_inode(struct folio *folio)h](j)}(hjJ,h]hstruct}(hja|hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj]|hhhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM;ubj)}(h h]h }(hjo|hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj]|hhhjn|hM;ubh)}(hhh]j)}(hinodeh]hinode}(hj|hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj}|ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj|modnameN classnameNjj)}j]j)}j folio_inodesb c.folio_inodeasbuh1hhj]|hhhjn|hM;ubj)}(h h]h }(hj|hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj]|hhhjn|hM;ubjr)}(hjuh]h*}(hj|hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj]|hhhjn|hM;ubh)}(h folio_inodeh]j)}(hj|h]h folio_inode}(hj|hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj]|hhhjn|hM;ubj8)}(h(struct folio *folio)h]j>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hj|hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|ubj)}(h h]h }(hj|hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|ubh)}(hhh]j)}(hfolioh]hfolio}(hj|hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj|modnameN classnameNjj)}j]j| c.folio_inodeasbuh1hhj|ubj)}(h h]h }(hj}hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|ubjr)}(hjuh]h*}(hj%}hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj|ubj)}(hfolioh]hfolio}(hj2}hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj|ubah}(h]h ]h"]h$]h&]jjuh1j7hj]|hhhjn|hM;ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjY|hhhjn|hM;ubah}(h]jT|ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjn|hM;hjV|hhubj4)}(hhh]jM)}(h"Get the host inode for this folio.h]h"Get the host inode for this folio.}(hj\}hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM;hjY}hhubah}(h]h ]h"]h$]h&]uh1j3hjV|hhhjn|hM;ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjt}jHjt}jIjJjKuh1hhhhjQhNhNubj)}(h**Parameters** ``struct folio *folio`` The folio. **Description** For folios which are in the page cache, return the inode that this folio belongs to. Do not call this for folios which aren't in the page cache.h](jM)}(h**Parameters**h]j)}(hj~}h]h Parameters}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj|}ubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM?hjx}ubj)}(hhh]j)}(h#``struct folio *folio`` The folio. h](j)}(h``struct folio *folio``h]jS)}(hj}h]hstruct folio *folio}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj}ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM<hj}ubj)}(hhh]jM)}(h The folio.h]h The folio.}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj}hM<hj}ubah}(h]h ]h"]h$]h&]uh1jhj}ubeh}(h]h ]h"]h$]h&]uh1jhj}hM<hj}ubah}(h]h ]h"]h$]h&]uh1jhjx}ubjM)}(h**Description**h]j)}(hj}h]h Description}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj}ubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM>hjx}ubjM)}(hTFor folios which are in the page cache, return the inode that this folio belongs to.h]hTFor folios which are in the page cache, return the inode that this folio belongs to.}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM=hjx}ubjM)}(h;Do not call this for folios which aren't in the page cache.h]h=Do not call this for folios which aren’t in the page cache.}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM@hjx}ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjQhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h!folio_attach_private (C function)c.folio_attach_privatehNtauh1hhjQhhhNhNubh)}(hhh](h)}(h;void folio_attach_private (struct folio *folio, void *data)h]h)}(h:void folio_attach_private(struct folio *folio, void *data)h](j)}(hvoidh]hvoid}(hj,~hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(~hhhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMIubj)}(h h]h }(hj;~hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(~hhhj:~hMIubh)}(hfolio_attach_privateh]j)}(hfolio_attach_privateh]hfolio_attach_private}(hjM~hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjI~ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj(~hhhj:~hMIubj8)}(h!(struct folio *folio, void *data)h](j>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hji~hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhje~ubj)}(h h]h }(hjv~hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhje~ubh)}(hhh]j)}(hfolioh]hfolio}(hj~hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj~modnameN classnameNjj)}j]j)}jjO~sbc.folio_attach_privateasbuh1hhje~ubj)}(h h]h }(hj~hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhje~ubjr)}(hjuh]h*}(hj~hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhje~ubj)}(hfolioh]hfolio}(hj~hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhje~ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hja~ubj>)}(h void *datah](j)}(hvoidh]hvoid}(hj~hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~ubj)}(h h]h }(hj~hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~ubjr)}(hjuh]h*}(hj~hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj~ubj)}(hdatah]hdata}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hja~ubeh}(h]h ]h"]h$]h&]jjuh1j7hj(~hhhj:~hMIubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj$~hhhj:~hMIubah}(h]j~ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj:~hMIhj!~hhubj4)}(hhh]jM)}(hAttach private data to a folio.h]hAttach private data to a folio.}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMIhj+hhubah}(h]h ]h"]h$]h&]uh1j3hj!~hhhj:~hMIubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjFjHjFjIjJjKuh1hhhhjQhNhNubj)}(hX**Parameters** ``struct folio *folio`` Folio to attach data to. ``void *data`` Data to attach to folio. **Description** Attaching private data to a folio increments the page's reference count. The data must be detached before the folio will be freed.h](jM)}(h**Parameters**h]j)}(hjPh]h Parameters}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMMhjJubj)}(hhh](j)}(h1``struct folio *folio`` Folio to attach data to. h](j)}(h``struct folio *folio``h]jS)}(hjoh]hstruct folio *folio}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjmubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMJhjiubj)}(hhh]jM)}(hFolio to attach data to.h]hFolio to attach data to.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMJhjubah}(h]h ]h"]h$]h&]uh1jhjiubeh}(h]h ]h"]h$]h&]uh1jhjhMJhjfubj)}(h(``void *data`` Data to attach to folio. h](j)}(h``void *data``h]jS)}(hjh]h void *data}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMKhjubj)}(hhh]jM)}(hData to attach to folio.h]hData to attach to folio.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMKhjfubeh}(h]h ]h"]h$]h&]uh1jhjJubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMMhjJubjM)}(hAttaching private data to a folio increments the page's reference count. The data must be detached before the folio will be freed.h]hAttaching private data to a folio increments the page’s reference count. The data must be detached before the folio will be freed.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMLhjJubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjQhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h!folio_change_private (C function)c.folio_change_privatehNtauh1hhjQhhhNhNubh)}(hhh](h)}(h=void * folio_change_private (struct folio *folio, void *data)h]h)}(h;void *folio_change_private(struct folio *folio, void *data)h](j)}(hvoidh]hvoid}(hj(hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$hhhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMWubj)}(h h]h }(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$hhhj6hMWubjr)}(hjuh]h*}(hjEhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj$hhhj6hMWubh)}(hfolio_change_privateh]j)}(hfolio_change_privateh]hfolio_change_private}(hjVhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRubah}(h]h ](jjeh"]h$]h&]jjuh1hhj$hhhj6hMWubj8)}(h!(struct folio *folio, void *data)h](j>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hjrhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnubh)}(hhh]j)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjXsbc.folio_change_privateasbuh1hhjnubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjnubj)}(hfolioh]hfolio}(hjˀhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjjubj>)}(h void *datah](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hdatah]hdata}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjjubeh}(h]h ]h"]h$]h&]jjuh1j7hj$hhhj6hMWubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj hhhj6hMWubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj6hMWhjhhubj4)}(hhh]jM)}(hChange private data on a folio.h]hChange private data on a folio.}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMWhj4hhubah}(h]h ]h"]h$]h&]uh1j3hjhhhj6hMWubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjOjHjOjIjJjKuh1hhhhjQhNhNubj)}(hXu**Parameters** ``struct folio *folio`` Folio to change the data on. ``void *data`` Data to set on the folio. **Description** Change the private data attached to a folio and return the old data. The page must previously have had data attached and the data must be detached before the folio will be freed. **Return** Data that was previously attached to the folio.h](jM)}(h**Parameters**h]j)}(hjYh]h Parameters}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjWubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM[hjSubj)}(hhh](j)}(h5``struct folio *folio`` Folio to change the data on. h](j)}(h``struct folio *folio``h]jS)}(hjxh]hstruct folio *folio}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjvubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMXhjrubj)}(hhh]jM)}(hFolio to change the data on.h]hFolio to change the data on.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMXhjubah}(h]h ]h"]h$]h&]uh1jhjrubeh}(h]h ]h"]h$]h&]uh1jhjhMXhjoubj)}(h)``void *data`` Data to set on the folio. h](j)}(h``void *data``h]jS)}(hjh]h void *data}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMYhjubj)}(hhh]jM)}(hData to set on the folio.h]hData to set on the folio.}(hjʁhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjƁhMYhjǁubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjƁhMYhjoubeh}(h]h ]h"]h$]h&]uh1jhjSubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM[hjSubjM)}(hChange the private data attached to a folio and return the old data. The page must previously have had data attached and the data must be detached before the folio will be freed.h]hChange the private data attached to a folio and return the old data. The page must previously have had data attached and the data must be detached before the folio will be freed.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMZhjSubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM^hjSubjM)}(h/Data that was previously attached to the folio.h]h/Data that was previously attached to the folio.}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM_hjSubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjQhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h!folio_detach_private (C function)c.folio_detach_privatehNtauh1hhjQhhhNhNubh)}(hhh](h)}(h1void * folio_detach_private (struct folio *folio)h]h)}(h/void *folio_detach_private(struct folio *folio)h](j)}(hvoidh]hvoid}(hjXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjThhhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMjubj)}(h h]h }(hjghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjThhhjfhMjubjr)}(hjuh]h*}(hjuhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjThhhjfhMjubh)}(hfolio_detach_privateh]j)}(hfolio_detach_privateh]hfolio_detach_private}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjThhhjfhMjubj8)}(h(struct folio *folio)h]j>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj‚modnameN classnameNjj)}j]j)}jjsbc.folio_detach_privateasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjThhhjfhMjubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjPhhhjfhMjubah}(h]jKah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjfhMjhjMhhubj4)}(hhh]jM)}(h!Detach private data from a folio.h]h!Detach private data from a folio.}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMjhj"hhubah}(h]h ]h"]h$]h&]uh1j3hjMhhhjfhMjubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj=jHj=jIjJjKuh1hhhhjQhNhNubj)}(h**Parameters** ``struct folio *folio`` Folio to detach data from. **Description** Removes the data that was previously attached to the folio and decrements the refcount on the page. **Return** Data that was attached to the folio.h](jM)}(h**Parameters**h]j)}(hjGh]h Parameters}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjEubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMnhjAubj)}(hhh]j)}(h3``struct folio *folio`` Folio to detach data from. h](j)}(h``struct folio *folio``h]jS)}(hjfh]hstruct folio *folio}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjdubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMkhj`ubj)}(hhh]jM)}(hFolio to detach data from.h]hFolio to detach data from.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj{hMkhj|ubah}(h]h ]h"]h$]h&]uh1jhj`ubeh}(h]h ]h"]h$]h&]uh1jhj{hMkhj]ubah}(h]h ]h"]h$]h&]uh1jhjAubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMmhjAubjM)}(hcRemoves the data that was previously attached to the folio and decrements the refcount on the page.h]hcRemoves the data that was previously attached to the folio and decrements the refcount on the page.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMlhjAubjM)}(h **Return**h]j)}(hjȃh]hReturn}(hjʃhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjƃubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMohjAubjM)}(h$Data that was attached to the folio.h]h$Data that was attached to the folio.}(hjރhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMphjAubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjQhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfgf_t (C type)c.fgf_thNtauh1hhjQhhhNhNubh)}(hhh](h)}(hfgf_th]h)}(h type fgf_th](j)}(htypeh]htype}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMuubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhjhMuubh)}(hfgf_th]j)}(hjh]hfgf_t}(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj hhhjhMuubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMuubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMuhjhhubj4)}(hhh]jM)}(h-Flags for getting folios from the page cache.h]h-Flags for getting folios from the page cache.}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjMhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMuubeh}(h]h ](jAtypeeh"]h$]h&]jFjAjGjhjHjhjIjJjKuh1hhhhjQhNhNubjM)}(h**Description**h]j)}(hjnh]h Description}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1jhjlubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjQhhubjM)}(hXMost users of the page cache will not need to use these flags; there are convenience functions such as filemap_get_folio() and filemap_lock_folio(). For users which need more control over exactly what is done with the folios, these flags to __filemap_get_folio() are available.h]hXMost users of the page cache will not need to use these flags; there are convenience functions such as filemap_get_folio() and filemap_lock_folio(). For users which need more control over exactly what is done with the folios, these flags to __filemap_get_folio() are available.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjQhhubj^)}(hhh](jc)}(h5``FGP_ACCESSED`` - The folio will be marked accessed.h]jM)}(hjh](jS)}(h``FGP_ACCESSED``h]h FGP_ACCESSED}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubh% - The folio will be marked accessed.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubah}(h]h ]h"]h$]h&]uh1jbhjubjc)}(h,``FGP_LOCK`` - The folio is returned locked.h]jM)}(hjh](jS)}(h ``FGP_LOCK``h]hFGP_LOCK}(hjÄhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubh - The folio is returned locked.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubah}(h]h ]h"]h$]h&]uh1jbhjubjc)}(h``FGP_CREAT`` - If no folio is present then a new folio is allocated, added to the page cache and the VM's LRU list. The folio is returned locked.h]jM)}(h``FGP_CREAT`` - If no folio is present then a new folio is allocated, added to the page cache and the VM's LRU list. The folio is returned locked.h](jS)}(h ``FGP_CREAT``h]h FGP_CREAT}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubh - If no folio is present then a new folio is allocated, added to the page cache and the VM’s LRU list. The folio is returned locked.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubah}(h]h ]h"]h$]h&]uh1jbhjubjc)}(h``FGP_FOR_MMAP`` - The caller wants to do its own locking dance if the folio is already in cache. If the folio was allocated, unlock it before returning so the caller can do the same dance.h]jM)}(h``FGP_FOR_MMAP`` - The caller wants to do its own locking dance if the folio is already in cache. If the folio was allocated, unlock it before returning so the caller can do the same dance.h](jS)}(h``FGP_FOR_MMAP``h]h FGP_FOR_MMAP}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj ubh - The caller wants to do its own locking dance if the folio is already in cache. If the folio was allocated, unlock it before returning so the caller can do the same dance.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhj ubah}(h]h ]h"]h$]h&]uh1jbhjubjc)}(h;``FGP_WRITE`` - The folio will be written to by the caller.h]jM)}(hj2h](jS)}(h ``FGP_WRITE``h]h FGP_WRITE}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj4ubh. - The folio will be written to by the caller.}(hj4hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhj0ubah}(h]h ]h"]h$]h&]uh1jbhjubjc)}(h0``FGP_NOFS`` - __GFP_FS will get cleared in gfp.h]jM)}(hjXh](jS)}(h ``FGP_NOFS``h]hFGP_NOFS}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjZubh$ - __GFP_FS will get cleared in gfp.}(hjZhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjVubah}(h]h ]h"]h$]h&]uh1jbhjubjc)}(h/``FGP_NOWAIT`` - Don't block on the folio lock.h]jM)}(hj~h](jS)}(h``FGP_NOWAIT``h]h FGP_NOWAIT}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubh# - Don’t block on the folio lock.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhj|ubah}(h]h ]h"]h$]h&]uh1jbhjubjc)}(hE``FGP_STABLE`` - Wait for the folio to be stable (finished writeback)h]jM)}(hjh](jS)}(h``FGP_STABLE``h]h FGP_STABLE}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubh7 - Wait for the folio to be stable (finished writeback)}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubah}(h]h ]h"]h$]h&]uh1jbhjubjc)}(h(``FGP_DONTCACHE`` - Uncached buffered IOh]jM)}(hjʅh](jS)}(h``FGP_DONTCACHE``h]h FGP_DONTCACHE}(hjυhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj̅ubh - Uncached buffered IO}(hj̅hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjȅubah}(h]h ]h"]h$]h&]uh1jbhjubjc)}(hU``FGP_WRITEBEGIN`` - The flags to use in a filesystem write_begin() implementation. h]jM)}(hS``FGP_WRITEBEGIN`` - The flags to use in a filesystem write_begin() implementation.h](jS)}(h``FGP_WRITEBEGIN``h]hFGP_WRITEBEGIN}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubhA - The flags to use in a filesystem write_begin() implementation.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubah}(h]h ]h"]h$]h&]uh1jbhjubeh}(h]h ]h"]h$]h&]jjuuh1j]hjhMhjQhhubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfgf_set_order (C function)c.fgf_set_orderhNtauh1hhjQhhhNhNubh)}(hhh](h)}(h!fgf_t fgf_set_order (size_t size)h]h)}(h fgf_t fgf_set_order(size_t size)h](h)}(hhh]j)}(hfgf_th]hfgf_t}(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj9modnameN classnameNjj)}j]j)}j fgf_set_ordersbc.fgf_set_orderasbuh1hhj0hhhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMubj)}(h h]h }(hjYhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0hhhjXhMubh)}(h fgf_set_orderh]j)}(hjUh]h fgf_set_order}(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubah}(h]h ](jjeh"]h$]h&]jjuh1hhj0hhhjXhMubj8)}(h (size_t size)h]j>)}(h size_t sizeh](h)}(hhh]j)}(hsize_th]hsize_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jSc.fgf_set_orderasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hsizeh]hsize}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj~ubah}(h]h ]h"]h$]h&]jjuh1j7hj0hhhjXhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj,hhhjXhMubah}(h]j'ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjXhMhj)hhubj4)}(hhh]jM)}(h#Encode a length in the fgf_t flags.h]h#Encode a length in the fgf_t flags.}(hj߆hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhj܆hhubah}(h]h ]h"]h$]h&]uh1j3hj)hhhjXhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjQhNhNubj)}(hX**Parameters** ``size_t size`` The suggested size of the folio to create. **Description** The caller of __filemap_get_folio() can use this to suggest a preferred size for the folio that is created. If there is already a folio at the index, it will be returned, no matter what its size. If a folio is freshly created, it may be of a different size than requested due to alignment constraints, memory pressure, or the presence of other folios at nearby indices.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubj)}(hhh]j)}(h;``size_t size`` The suggested size of the folio to create. h](j)}(h``size_t size``h]jS)}(hj h]h size_t size}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubj)}(hhh]jM)}(h*The suggested size of the folio to create.h]h*The suggested size of the folio to create.}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj5hMhj6ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj5hMhjubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hj[h]h Description}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjYubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubjM)}(hXsThe caller of __filemap_get_folio() can use this to suggest a preferred size for the folio that is created. If there is already a folio at the index, it will be returned, no matter what its size. If a folio is freshly created, it may be of a different size than requested due to alignment constraints, memory pressure, or the presence of other folios at nearby indices.h]hXsThe caller of __filemap_get_folio() can use this to suggest a preferred size for the folio that is created. If there is already a folio at the index, it will be returned, no matter what its size. If a folio is freshly created, it may be of a different size than requested due to alignment constraints, memory pressure, or the presence of other folios at nearby indices.}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjQhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h"write_begin_get_folio (C function)c.write_begin_get_foliohNtauh1hhjQhhhNhNubh)}(hhh](h)}(hystruct folio * write_begin_get_folio (const struct kiocb *iocb, struct address_space *mapping, pgoff_t index, size_t len)h]h)}(hwstruct folio *write_begin_get_folio(const struct kiocb *iocb, struct address_space *mapping, pgoff_t index, size_t len)h](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh)}(hhh]j)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jwrite_begin_get_foliosbc.write_begin_get_folioasbuh1hhjhhhjhMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjhhhjhMubh)}(hwrite_begin_get_folioh]j)}(hj݇h]hwrite_begin_get_folio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMubj8)}(hT(const struct kiocb *iocb, struct address_space *mapping, pgoff_t index, size_t len)h](j>)}(hconst struct kiocb *iocbh](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjJ,h]hstruct}(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hkiocbh]hkiocb}(hjShhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjPubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjUmodnameN classnameNjj)}j]jۇc.write_begin_get_folioasbuh1hhjubj)}(h h]h }(hjqhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hiocbh]hiocb}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hstruct address_space *mappingh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(h address_spaceh]h address_space}(hjÈhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjňmodnameN classnameNjj)}j]jۇc.write_begin_get_folioasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hmappingh]hmapping}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(h pgoff_t indexh](h)}(hhh]j)}(hpgoff_th]hpgoff_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jۇc.write_begin_get_folioasbuh1hhjubj)}(h h]h }(hj6hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hindexh]hindex}(hjDhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(h size_t lenh](h)}(hhh]j)}(hsize_th]hsize_t}(hj`hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj]ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjbmodnameN classnameNjj)}j]jۇc.write_begin_get_folioasbuh1hhjYubj)}(h h]h }(hj~hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjYubj)}(hlenh]hlen}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjYubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]jM)}(h%Get folio for write_begin with flags.h]h%Get folio for write_begin with flags.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjΉjHjΉjIjJjKuh1hhhhjQhNhNubj)}(hX**Parameters** ``const struct kiocb *iocb`` The kiocb passed from write_begin (may be NULL). ``struct address_space *mapping`` The address space to search. ``pgoff_t index`` The page cache index. ``size_t len`` Length of data being written. **Description** This is a helper for filesystem write_begin() implementations. It wraps __filemap_get_folio(), setting appropriate flags in the write begin context. **Return** A folio or an ERR_PTR.h](jM)}(h**Parameters**h]j)}(hj؉h]h Parameters}(hjډhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj։ubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhj҉ubj)}(hhh](j)}(hN``const struct kiocb *iocb`` The kiocb passed from write_begin (may be NULL). h](j)}(h``const struct kiocb *iocb``h]jS)}(hjh]hconst struct kiocb *iocb}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubj)}(hhh]jM)}(h0The kiocb passed from write_begin (may be NULL).h]h0The kiocb passed from write_begin (may be NULL).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj hMhj ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj hMhjubj)}(h?``struct address_space *mapping`` The address space to search. h](j)}(h!``struct address_space *mapping``h]jS)}(hj0h]hstruct address_space *mapping}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj.ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhj*ubj)}(hhh]jM)}(hThe address space to search.h]hThe address space to search.}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjEhMhjFubah}(h]h ]h"]h$]h&]uh1jhj*ubeh}(h]h ]h"]h$]h&]uh1jhjEhMhjubj)}(h(``pgoff_t index`` The page cache index. h](j)}(h``pgoff_t index``h]jS)}(hjih]h pgoff_t index}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjgubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjcubj)}(hhh]jM)}(hThe page cache index.h]hThe page cache index.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj~hMhjubah}(h]h ]h"]h$]h&]uh1jhjcubeh}(h]h ]h"]h$]h&]uh1jhj~hMhjubj)}(h-``size_t len`` Length of data being written. h](j)}(h``size_t len``h]jS)}(hjh]h size_t len}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubj)}(hhh]jM)}(hLength of data being written.h]hLength of data being written.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubeh}(h]h ]h"]h$]h&]uh1jhj҉ubjM)}(h**Description**h]j)}(hj݊h]h Description}(hjߊhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjۊubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhj҉ubjM)}(hThis is a helper for filesystem write_begin() implementations. It wraps __filemap_get_folio(), setting appropriate flags in the write begin context.h]hThis is a helper for filesystem write_begin() implementations. It wraps __filemap_get_folio(), setting appropriate flags in the write begin context.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhj҉ubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhj҉ubjM)}(hA folio or an ERR_PTR.h]hA folio or an ERR_PTR.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hLhMhj҉ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjQhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfilemap_get_folio (C function)c.filemap_get_foliohNtauh1hhjQhhhNhNubh)}(hhh](h)}(hOstruct folio * filemap_get_folio (struct address_space *mapping, pgoff_t index)h]h)}(hMstruct folio *filemap_get_folio(struct address_space *mapping, pgoff_t index)h](j)}(hjJ,h]hstruct}(hjIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEhhhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMubj)}(h h]h }(hjWhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEhhhjVhMubh)}(hhh]j)}(hfolioh]hfolio}(hjhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjjmodnameN classnameNjj)}j]j)}jfilemap_get_foliosbc.filemap_get_folioasbuh1hhjEhhhjVhMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEhhhjVhMubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjEhhhjVhMubh)}(hfilemap_get_folioh]j)}(hjh]hfilemap_get_folio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjEhhhjVhMubj8)}(h.(struct address_space *mapping, pgoff_t index)h](j>)}(hstruct address_space *mappingh](j)}(hjJ,h]hstruct}(hjËhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjЋhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(h address_spaceh]h address_space}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjދubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.filemap_get_folioasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hj hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hmappingh]hmapping}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(h pgoff_t indexh](h)}(hhh]j)}(hpgoff_th]hpgoff_t}(hj6hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj8modnameN classnameNjj)}j]jc.filemap_get_folioasbuh1hhj/ubj)}(h h]h }(hjThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/ubj)}(hindexh]hindex}(hjbhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjEhhhjVhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjAhhhjVhMubah}(h]j<ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjVhMhj>hhubj4)}(hhh]jM)}(hFind and get a folio.h]hFind and get a folio.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjhhubah}(h]h ]h"]h$]h&]uh1j3hj>hhhjVhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjQhNhNubj)}(hX**Parameters** ``struct address_space *mapping`` The address_space to search. ``pgoff_t index`` The page index. **Description** Looks up the page cache entry at **mapping** & **index**. If a folio is present, it is returned with an increased refcount. **Return** A folio or ERR_PTR(-ENOENT) if there is no folio in the cache for this index. Will not return a shadow, swap or DAX entry.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubj)}(hhh](j)}(h?``struct address_space *mapping`` The address_space to search. h](j)}(h!``struct address_space *mapping``h]jS)}(hj͌h]hstruct address_space *mapping}(hjόhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjˌubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjnjubj)}(hhh]jM)}(hThe address_space to search.h]hThe address_space to search.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjnjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjČubj)}(h"``pgoff_t index`` The page index. h](j)}(h``pgoff_t index``h]jS)}(hjh]h pgoff_t index}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubj)}(hhh]jM)}(hThe page index.h]hThe page index.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjČubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjAh]h Description}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1jhj?ubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubjM)}(h|Looks up the page cache entry at **mapping** & **index**. If a folio is present, it is returned with an increased refcount.h](h!Looks up the page cache entry at }(hjWhhhNhNubj)}(h **mapping**h]hmapping}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjWubh & }(hjWhhhNhNubj)}(h **index**h]hindex}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjWubhD. If a folio is present, it is returned with an increased refcount.}(hjWhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubjM)}(h{A folio or ERR_PTR(-ENOENT) if there is no folio in the cache for this index. Will not return a shadow, swap or DAX entry.h]h{A folio or ERR_PTR(-ENOENT) if there is no folio in the cache for this index. Will not return a shadow, swap or DAX entry.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjQhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfilemap_lock_folio (C function)c.filemap_lock_foliohNtauh1hhjQhhhNhNubh)}(hhh](h)}(hPstruct folio * filemap_lock_folio (struct address_space *mapping, pgoff_t index)h]h)}(hNstruct folio *filemap_lock_folio(struct address_space *mapping, pgoff_t index)h](j)}(hjJ,h]hstruct}(hjэhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj͍hhhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM&ubj)}(h h]h }(hjߍhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj͍hhhjލhM&ubh)}(hhh]j)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jfilemap_lock_foliosbc.filemap_lock_folioasbuh1hhj͍hhhjލhM&ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj͍hhhjލhM&ubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj͍hhhjލhM&ubh)}(hfilemap_lock_folioh]j)}(hjh]hfilemap_lock_folio}(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj͍hhhjލhM&ubj8)}(h.(struct address_space *mapping, pgoff_t index)h](j>)}(hstruct address_space *mappingh](j)}(hjJ,h]hstruct}(hjKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGubj)}(h h]h }(hjXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGubh)}(hhh]j)}(h address_spaceh]h address_space}(hjihhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjfubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjkmodnameN classnameNjj)}j]j c.filemap_lock_folioasbuh1hhjGubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjGubj)}(hmappingh]hmapping}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjCubj>)}(h pgoff_t indexh](h)}(hhh]j)}(hpgoff_th]hpgoff_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j c.filemap_lock_folioasbuh1hhjubj)}(h h]h }(hj܎hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hindexh]hindex}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjCubeh}(h]h ]h"]h$]h&]jjuh1j7hj͍hhhjލhM&ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjɍhhhjލhM&ubah}(h]jčah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjލhM&hjƍhhubj4)}(hhh]jM)}(hFind and lock a folio.h]hFind and lock a folio.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM&hjhhubah}(h]h ]h"]h$]h&]uh1j3hjƍhhhjލhM&ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj,jHj,jIjJjKuh1hhhhjQhNhNubj)}(hX**Parameters** ``struct address_space *mapping`` The address_space to search. ``pgoff_t index`` The page index. **Description** Looks up the page cache entry at **mapping** & **index**. If a folio is present, it is returned locked with an increased refcount. **Context** May sleep. **Return** A folio or ERR_PTR(-ENOENT) if there is no folio in the cache for this index. Will not return a shadow, swap or DAX entry.h](jM)}(h**Parameters**h]j)}(hj6h]h Parameters}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj4ubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM*hj0ubj)}(hhh](j)}(h?``struct address_space *mapping`` The address_space to search. h](j)}(h!``struct address_space *mapping``h]jS)}(hjUh]hstruct address_space *mapping}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjSubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM'hjOubj)}(hhh]jM)}(hThe address_space to search.h]hThe address_space to search.}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjjhM'hjkubah}(h]h ]h"]h$]h&]uh1jhjOubeh}(h]h ]h"]h$]h&]uh1jhjjhM'hjLubj)}(h"``pgoff_t index`` The page index. h](j)}(h``pgoff_t index``h]jS)}(hjh]h pgoff_t index}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM(hjubj)}(hhh]jM)}(hThe page index.h]hThe page index.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM(hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM(hjLubeh}(h]h ]h"]h$]h&]uh1jhj0ubjM)}(h**Description**h]j)}(hjɏh]h Description}(hjˏhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjǏubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM*hj0ubjM)}(hLooks up the page cache entry at **mapping** & **index**. If a folio is present, it is returned locked with an increased refcount.h](h!Looks up the page cache entry at }(hjߏhhhNhNubj)}(h **mapping**h]hmapping}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjߏubh & }(hjߏhhhNhNubj)}(h **index**h]hindex}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjߏubhK. If a folio is present, it is returned locked with an increased refcount.}(hjߏhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM)hj0ubjM)}(h **Context**h]j)}(hjh]hContext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM,hj0ubjM)}(h May sleep.h]h May sleep.}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM-hj0ubjM)}(h **Return**h]j)}(hj;h]hReturn}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj9ubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM/hj0ubjM)}(h{A folio or ERR_PTR(-ENOENT) if there is no folio in the cache for this index. Will not return a shadow, swap or DAX entry.h]h{A folio or ERR_PTR(-ENOENT) if there is no folio in the cache for this index. Will not return a shadow, swap or DAX entry.}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM.hj0ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjQhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfilemap_grab_folio (C function)c.filemap_grab_foliohNtauh1hhjQhhhNhNubh)}(hhh](h)}(hPstruct folio * filemap_grab_folio (struct address_space *mapping, pgoff_t index)h]h)}(hNstruct folio *filemap_grab_folio(struct address_space *mapping, pgoff_t index)h](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|hhhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM8ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|hhhjhM8ubh)}(hhh]j)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jfilemap_grab_foliosbc.filemap_grab_folioasbuh1hhj|hhhjhM8ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|hhhjhM8ubjr)}(hjuh]h*}(hjΐhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj|hhhjhM8ubh)}(hfilemap_grab_folioh]j)}(hjh]hfilemap_grab_folio}(hjߐhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjېubah}(h]h ](jjeh"]h$]h&]jjuh1hhj|hhhjhM8ubj8)}(h.(struct address_space *mapping, pgoff_t index)h](j>)}(hstruct address_space *mappingh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(h address_spaceh]h address_space}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.filemap_grab_folioasbuh1hhjubj)}(h h]h }(hj6hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjDhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hmappingh]hmapping}(hjQhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(h pgoff_t indexh](h)}(hhh]j)}(hpgoff_th]hpgoff_t}(hjmhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjomodnameN classnameNjj)}j]jc.filemap_grab_folioasbuh1hhjfubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjfubj)}(hindexh]hindex}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjfubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hj|hhhjhM8ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjxhhhjhM8ubah}(h]jsah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhM8hjuhhubj4)}(hhh]jM)}(h grab a folio from the page cacheh]h grab a folio from the page cache}(hjÑhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM8hjhhubah}(h]h ]h"]h$]h&]uh1j3hjuhhhjhM8ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjۑjHjۑjIjJjKuh1hhhhjQhNhNubj)}(hX**Parameters** ``struct address_space *mapping`` The address space to search ``pgoff_t index`` The page index **Description** Looks up the page cache entry at **mapping** & **index**. If no folio is found, a new folio is created. The folio is locked, marked as accessed, and returned. **Return** A found or created folio. ERR_PTR(-ENOMEM) if no folio is found and failed to create a folio.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM<hjߑubj)}(hhh](j)}(h>``struct address_space *mapping`` The address space to search h](j)}(h!``struct address_space *mapping``h]jS)}(hjh]hstruct address_space *mapping}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM9hjubj)}(hhh]jM)}(hThe address space to searchh]hThe address space to search}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM9hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM9hjubj)}(h!``pgoff_t index`` The page index h](j)}(h``pgoff_t index``h]jS)}(hj=h]h pgoff_t index}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj;ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM:hj7ubj)}(hhh]jM)}(hThe page indexh]hThe page index}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjRhM:hjSubah}(h]h ]h"]h$]h&]uh1jhj7ubeh}(h]h ]h"]h$]h&]uh1jhjRhM:hjubeh}(h]h ]h"]h$]h&]uh1jhjߑubjM)}(h**Description**h]j)}(hjxh]h Description}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjvubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM<hjߑubjM)}(hLooks up the page cache entry at **mapping** & **index**. If no folio is found, a new folio is created. The folio is locked, marked as accessed, and returned.h](h!Looks up the page cache entry at }(hjhhhNhNubj)}(h **mapping**h]hmapping}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh & }(hjhhhNhNubj)}(h **index**h]hindex}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhf. If no folio is found, a new folio is created. The folio is locked, marked as accessed, and returned.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM;hjߑubjM)}(h **Return**h]j)}(hjÒh]hReturn}(hjŒhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM?hjߑubjM)}(h]A found or created folio. ERR_PTR(-ENOMEM) if no folio is found and failed to create a folio.h]h]A found or created folio. ERR_PTR(-ENOMEM) if no folio is found and failed to create a folio.}(hjْhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM@hjߑubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjQhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfind_get_page (C function)c.find_get_pagehNtauh1hhjQhhhNhNubh)}(hhh](h)}(hKstruct page * find_get_page (struct address_space *mapping, pgoff_t offset)h]h)}(hIstruct page *find_get_page(struct address_space *mapping, pgoff_t offset)h](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMLubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMLubh)}(hhh]j)}(hpageh]hpage}(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj)modnameN classnameNjj)}j]j)}j find_get_pagesbc.find_get_pageasbuh1hhjhhhjhMLubj)}(h h]h }(hjHhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMLubjr)}(hjuh]h*}(hjVhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjhhhjhMLubh)}(h find_get_pageh]j)}(hjEh]h find_get_page}(hjghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjcubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMLubj8)}(h/(struct address_space *mapping, pgoff_t offset)h](j>)}(hstruct address_space *mappingh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~ubh)}(hhh]j)}(h address_spaceh]h address_space}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jCc.find_get_pageasbuh1hhj~ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~ubjr)}(hjuh]h*}(hj̓hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj~ubj)}(hmappingh]hmapping}(hjٓhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjzubj>)}(hpgoff_t offseth](h)}(hhh]j)}(hpgoff_th]hpgoff_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jCc.find_get_pageasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hoffseth]hoffset}(hj!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjzubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMLubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMLubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMLhjhhubj4)}(hhh]jM)}(hfind and get a page referenceh]hfind and get a page reference}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMLhjHhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMLubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjcjHjcjIjJjKuh1hhhhjQhNhNubj)}(hX-**Parameters** ``struct address_space *mapping`` the address_space to search ``pgoff_t offset`` the page index **Description** Looks up the page cache slot at **mapping** & **offset**. If there is a page cache page, it is returned with an increased refcount. Otherwise, ``NULL`` is returned.h](jM)}(h**Parameters**h]j)}(hjmh]h Parameters}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1jhjkubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMPhjgubj)}(hhh](j)}(h>``struct address_space *mapping`` the address_space to search h](j)}(h!``struct address_space *mapping``h]jS)}(hjh]hstruct address_space *mapping}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMMhjubj)}(hhh]jM)}(hthe address_space to searchh]hthe address_space to search}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMMhjubj)}(h"``pgoff_t offset`` the page index h](j)}(h``pgoff_t offset``h]jS)}(hjŔh]hpgoff_t offset}(hjǔhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjÔubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMNhjubj)}(hhh]jM)}(hthe page indexh]hthe page index}(hjޔhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjڔhMNhj۔ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjڔhMNhjubeh}(h]h ]h"]h$]h&]uh1jhjgubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMPhjgubjM)}(hLooks up the page cache slot at **mapping** & **offset**. If there is a page cache page, it is returned with an increased refcount.h](h Looks up the page cache slot at }(hjhhhNhNubj)}(h **mapping**h]hmapping}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh & }(hjhhhNhNubj)}(h **offset**h]hoffset}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhL. If there is a page cache page, it is returned with an increased refcount.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMOhjgubjM)}(h Otherwise, ``NULL`` is returned.h](h Otherwise, }(hjIhhhNhNubjS)}(h``NULL``h]hNULL}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjIubh is returned.}(hjIhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMRhjgubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjQhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfind_lock_page (C function)c.find_lock_pagehNtauh1hhjQhhhNhNubh)}(hhh](h)}(hKstruct page * find_lock_page (struct address_space *mapping, pgoff_t index)h]h)}(hIstruct page *find_lock_page(struct address_space *mapping, pgoff_t index)h](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMbubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMbubh)}(hhh]j)}(hpageh]hpage}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jfind_lock_pagesbc.find_lock_pageasbuh1hhjhhhjhMbubj)}(h h]h }(hjʕhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMbubjr)}(hjuh]h*}(hjؕhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjhhhjhMbubh)}(hfind_lock_pageh]j)}(hjǕh]hfind_lock_page}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMbubj8)}(h.(struct address_space *mapping, pgoff_t index)h](j>)}(hstruct address_space *mappingh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(h address_spaceh]h address_space}(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj$modnameN classnameNjj)}j]jŕc.find_lock_pageasbuh1hhjubj)}(h h]h }(hj@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjNhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hmappingh]hmapping}(hj[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(h pgoff_t indexh](h)}(hhh]j)}(hpgoff_th]hpgoff_t}(hjwhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjtubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjymodnameN classnameNjj)}j]jŕc.find_lock_pageasbuh1hhjpubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpubj)}(hindexh]hindex}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMbubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMbubah}(h]j}ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMbhjhhubj4)}(hhh]jM)}(h%locate, pin and lock a pagecache pageh]h%locate, pin and lock a pagecache page}(hj͖hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMbhjʖhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMbubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjQhNhNubj)}(hX**Parameters** ``struct address_space *mapping`` the address_space to search ``pgoff_t index`` the page index **Description** Looks up the page cache entry at **mapping** & **index**. If there is a page cache page, it is returned locked and with an increased refcount. **Context** May sleep. **Return** A struct page or ``NULL`` if there is no page in the cache for this index.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMfhjubj)}(hhh](j)}(h>``struct address_space *mapping`` the address_space to search h](j)}(h!``struct address_space *mapping``h]jS)}(hjh]hstruct address_space *mapping}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMchjubj)}(hhh]jM)}(hthe address_space to searchh]hthe address_space to search}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj#hMchj$ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj#hMchjubj)}(h!``pgoff_t index`` the page index h](j)}(h``pgoff_t index``h]jS)}(hjGh]h pgoff_t index}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjEubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMdhjAubj)}(hhh]jM)}(hthe page indexh]hthe page index}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj\hMdhj]ubah}(h]h ]h"]h$]h&]uh1jhjAubeh}(h]h ]h"]h$]h&]uh1jhj\hMdhjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMfhjubjM)}(hLooks up the page cache entry at **mapping** & **index**. If there is a page cache page, it is returned locked and with an increased refcount.h](h!Looks up the page cache entry at }(hjhhhNhNubj)}(h **mapping**h]hmapping}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh & }(hjhhhNhNubj)}(h **index**h]hindex}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhW. If there is a page cache page, it is returned locked and with an increased refcount.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMehjubjM)}(h **Context**h]j)}(hj͗h]hContext}(hjϗhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj˗ubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMihjubjM)}(h May sleep.h]h May sleep.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMjhjubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMlhjubjM)}(hJA struct page or ``NULL`` if there is no page in the cache for this index.h](hA struct page or }(hj hhhNhNubjS)}(h``NULL``h]hNULL}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj ubh1 if there is no page in the cache for this index.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMkhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjQhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h find_or_create_page (C function)c.find_or_create_pagehNtauh1hhjQhhhNhNubh)}(hhh](h)}(h`struct page * find_or_create_page (struct address_space *mapping, pgoff_t index, gfp_t gfp_mask)h]h)}(h^struct page *find_or_create_page(struct address_space *mapping, pgoff_t index, gfp_t gfp_mask)h](j)}(hjJ,h]hstruct}(hjKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGhhhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMuubj)}(h h]h }(hjYhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGhhhjXhMuubh)}(hhh]j)}(hpageh]hpage}(hjjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjlmodnameN classnameNjj)}j]j)}jfind_or_create_pagesbc.find_or_create_pageasbuh1hhjGhhhjXhMuubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGhhhjXhMuubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjGhhhjXhMuubh)}(hfind_or_create_pageh]j)}(hjh]hfind_or_create_page}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjGhhhjXhMuubj8)}(h>(struct address_space *mapping, pgoff_t index, gfp_t gfp_mask)h](j>)}(hstruct address_space *mappingh](j)}(hjJ,h]hstruct}(hjŘhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjҘhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(h address_spaceh]h address_space}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.find_or_create_pageasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hmappingh]hmapping}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(h pgoff_t indexh](h)}(hhh]j)}(hpgoff_th]hpgoff_t}(hj8hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj:modnameN classnameNjj)}j]jc.find_or_create_pageasbuh1hhj1ubj)}(h h]h }(hjVhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj1ubj)}(hindexh]hindex}(hjdhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj1ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hgfp_t gfp_maskh](h)}(hhh]j)}(hgfp_th]hgfp_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj}ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.find_or_create_pageasbuh1hhjyubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyubj)}(hgfp_maskh]hgfp_mask}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjGhhhjXhMuubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjChhhjXhMuubah}(h]j>ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjXhMuhj@hhubj4)}(hhh]jM)}(hlocate or add a pagecache pageh]hlocate or add a pagecache page}(hj֙hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMuhjәhhubah}(h]h ]h"]h$]h&]uh1j3hj@hhhjXhMuubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjQhNhNubj)}(hX**Parameters** ``struct address_space *mapping`` the page's address_space ``pgoff_t index`` the page's index into the mapping ``gfp_t gfp_mask`` page allocation mode **Description** Looks up the page cache slot at **mapping** & **offset**. If there is a page cache page, it is returned locked and with an increased refcount. If the page is not present, a new page is allocated using **gfp_mask** and added to the page cache and the VM's LRU list. The page is returned locked and with an increased refcount. On memory exhaustion, ``NULL`` is returned. find_or_create_page() may sleep, even if **gfp_flags** specifies an atomic allocation!h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMyhjubj)}(hhh](j)}(h;``struct address_space *mapping`` the page's address_space h](j)}(h!``struct address_space *mapping``h]jS)}(hjh]hstruct address_space *mapping}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMvhjubj)}(hhh]jM)}(hthe page's address_spaceh]hthe page’s address_space}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj,hMvhj-ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj,hMvhjubj)}(h4``pgoff_t index`` the page's index into the mapping h](j)}(h``pgoff_t index``h]jS)}(hjPh]h pgoff_t index}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjNubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMwhjJubj)}(hhh]jM)}(h!the page's index into the mappingh]h#the page’s index into the mapping}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjehMwhjfubah}(h]h ]h"]h$]h&]uh1jhjJubeh}(h]h ]h"]h$]h&]uh1jhjehMwhjubj)}(h(``gfp_t gfp_mask`` page allocation mode h](j)}(h``gfp_t gfp_mask``h]jS)}(hjh]hgfp_t gfp_mask}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMxhjubj)}(hhh]jM)}(hpage allocation modeh]hpage allocation mode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMxhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMxhjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjĚh]h Description}(hjƚhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjšubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMzhjubjM)}(hLooks up the page cache slot at **mapping** & **offset**. If there is a page cache page, it is returned locked and with an increased refcount.h](h Looks up the page cache slot at }(hjښhhhNhNubj)}(h **mapping**h]hmapping}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjښubh & }(hjښhhhNhNubj)}(h **offset**h]hoffset}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjښubhW. If there is a page cache page, it is returned locked and with an increased refcount.}(hjښhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMyhjubjM)}(hIf the page is not present, a new page is allocated using **gfp_mask** and added to the page cache and the VM's LRU list. The page is returned locked and with an increased refcount.h](h:If the page is not present, a new page is allocated using }(hj hhhNhNubj)}(h **gfp_mask**h]hgfp_mask}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubhr and added to the page cache and the VM’s LRU list. The page is returned locked and with an increased refcount.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM}hjubjM)}(h+On memory exhaustion, ``NULL`` is returned.h](hOn memory exhaustion, }(hj.hhhNhNubjS)}(h``NULL``h]hNULL}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj.ubh is returned.}(hj.hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubjM)}(hVfind_or_create_page() may sleep, even if **gfp_flags** specifies an atomic allocation!h](h)find_or_create_page() may sleep, even if }(hjOhhhNhNubj)}(h **gfp_flags**h]h gfp_flags}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjOubh specifies an atomic allocation!}(hjOhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjQhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h#grab_cache_page_nowait (C function)c.grab_cache_page_nowaithNtauh1hhjQhhhNhNubh)}(hhh](h)}(hSstruct page * grab_cache_page_nowait (struct address_space *mapping, pgoff_t index)h]h)}(hQstruct page *grab_cache_page_nowait(struct address_space *mapping, pgoff_t index)h](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh)}(hhh]j)}(hpageh]hpage}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jgrab_cache_page_nowaitsbc.grab_cache_page_nowaitasbuh1hhjhhhjhMubj)}(h h]h }(hjЛhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubjr)}(hjuh]h*}(hjޛhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjhhhjhMubh)}(hgrab_cache_page_nowaith]j)}(hj͛h]hgrab_cache_page_nowait}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMubj8)}(h.(struct address_space *mapping, pgoff_t index)h](j>)}(hstruct address_space *mappingh](j)}(hjJ,h]hstruct}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(h address_spaceh]h address_space}(hj(hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj*modnameN classnameNjj)}j]j˛c.grab_cache_page_nowaitasbuh1hhjubj)}(h h]h }(hjFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjThhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hmappingh]hmapping}(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(h pgoff_t indexh](h)}(hhh]j)}(hpgoff_th]hpgoff_t}(hj}hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjzubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j˛c.grab_cache_page_nowaitasbuh1hhjvubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvubj)}(hindexh]hindex}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]jM)}(h1returns locked page at given index in given cacheh]h1returns locked page at given index in given cache}(hjӜhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjМhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjQhNhNubj)}(hX>**Parameters** ``struct address_space *mapping`` target address_space ``pgoff_t index`` the page index **Description** Returns locked page at given index in given cache, creating it if needed, but do not wait if the page is locked or to reclaim memory. This is intended for speculative data generators, where the data can be regenerated if the page couldn't be grabbed. This routine should be safe to call while holding the lock for another page. Clear __GFP_FS when allocating the page to avoid recursion into the fs and deadlock against the caller's locked page.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubj)}(hhh](j)}(h7``struct address_space *mapping`` target address_space h](j)}(h!``struct address_space *mapping``h]jS)}(hjh]hstruct address_space *mapping}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubj)}(hhh]jM)}(htarget address_spaceh]htarget address_space}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj)hMhj*ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj)hMhj ubj)}(h!``pgoff_t index`` the page index h](j)}(h``pgoff_t index``h]jS)}(hjMh]h pgoff_t index}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjKubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjGubj)}(hhh]jM)}(hthe page indexh]hthe page index}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjbhMhjcubah}(h]h ]h"]h$]h&]uh1jhjGubeh}(h]h ]h"]h$]h&]uh1jhjbhMhj ubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubjM)}(hXHReturns locked page at given index in given cache, creating it if needed, but do not wait if the page is locked or to reclaim memory. This is intended for speculative data generators, where the data can be regenerated if the page couldn't be grabbed. This routine should be safe to call while holding the lock for another page.h]hXJReturns locked page at given index in given cache, creating it if needed, but do not wait if the page is locked or to reclaim memory. This is intended for speculative data generators, where the data can be regenerated if the page couldn’t be grabbed. This routine should be safe to call while holding the lock for another page.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubjM)}(huClear __GFP_FS when allocating the page to avoid recursion into the fs and deadlock against the caller's locked page.h]hwClear __GFP_FS when allocating the page to avoid recursion into the fs and deadlock against the caller’s locked page.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjQhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfolio_next_index (C function)c.folio_next_indexhNtauh1hhjQhhhNhNubh)}(hhh](h)}(h4pgoff_t folio_next_index (const struct folio *folio)h]h)}(h3pgoff_t folio_next_index(const struct folio *folio)h](h)}(hhh]j)}(hpgoff_th]hpgoff_t}(hjߝhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjܝubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jfolio_next_indexsbc.folio_next_indexasbuh1hhj؝hhhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj؝hhhjhMubh)}(hfolio_next_indexh]j)}(hjh]hfolio_next_index}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhj؝hhhjhMubj8)}(h(const struct folio *folio)h]j>)}(hconst struct folio *folioh](j)}(hjh]hconst}(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*ubj)}(h h]h }(hj;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*ubj)}(hjJ,h]hstruct}(hjIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*ubj)}(h h]h }(hjVhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*ubh)}(hhh]j)}(hfolioh]hfolio}(hjghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjdubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjimodnameN classnameNjj)}j]jc.folio_next_indexasbuh1hhj*ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*ubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj*ubj)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj&ubah}(h]h ]h"]h$]h&]jjuh1j7hj؝hhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjԝhhhjhMubah}(h]jϝah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjѝhhubj4)}(hhh]jM)}(h Get the index of the next folio.h]h Get the index of the next folio.}(hjʞhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjǞhhubah}(h]h ]h"]h$]h&]uh1j3hjѝhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjQhNhNubj)}(h**Parameters** ``const struct folio *folio`` The current folio. **Return** The index of the folio which follows this folio in the file.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubj)}(hhh]j)}(h1``const struct folio *folio`` The current folio. h](j)}(h``const struct folio *folio``h]jS)}(hj h]hconst struct folio *folio}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubj)}(hhh]jM)}(hThe current folio.h]hThe current folio.}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj hMhj!ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj hMhjubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h **Return**h]j)}(hjFh]hReturn}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjDubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubjM)}(h)}(hconst struct folio *folioh](j)}(hjh]hconst}(hjݟhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjٟubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjٟubj)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjٟubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjٟubh)}(hhh]j)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.folio_next_posasbuh1hhjٟubj)}(h h]h }(hj4hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjٟubjr)}(hjuh]h*}(hjBhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjٟubj)}(hfolioh]hfolio}(hjOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjٟubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj՟ubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]j~ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]jM)}(h(Get the file position of the next folio.h]h(Get the file position of the next folio.}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjvhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjQhNhNubj)}(h**Parameters** ``const struct folio *folio`` The current folio. **Return** The position of the folio which follows this folio in the file.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubj)}(hhh]j)}(h1``const struct folio *folio`` The current folio. h](j)}(h``const struct folio *folio``h]jS)}(hjh]hconst struct folio *folio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubj)}(hhh]jM)}(hThe current folio.h]hThe current folio.}(hjӠhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjϠhMhjРubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjϠhMhjubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubjM)}(h?The position of the folio which follows this folio in the file.h]h?The position of the folio which follows this folio in the file.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjQhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfolio_file_page (C function)c.folio_file_pagehNtauh1hhjQhhhNhNubh)}(hhh](h)}(hBstruct page * folio_file_page (struct folio *folio, pgoff_t index)h]h)}(h@struct page *folio_file_page(struct folio *folio, pgoff_t index)h](j)}(hjJ,h]hstruct}(hj:hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj6hhhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMubj)}(h h]h }(hjHhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj6hhhjGhMubh)}(hhh]j)}(hpageh]hpage}(hjYhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj[modnameN classnameNjj)}j]j)}jfolio_file_pagesbc.folio_file_pageasbuh1hhj6hhhjGhMubj)}(h h]h }(hjzhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj6hhhjGhMubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj6hhhjGhMubh)}(hfolio_file_pageh]j)}(hjwh]hfolio_file_page}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhj6hhhjGhMubj8)}(h$(struct folio *folio, pgoff_t index)h](j>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hfolioh]hfolio}(hjҡhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjϡubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjԡmodnameN classnameNjj)}j]juc.folio_file_pageasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hfolioh]hfolio}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(h pgoff_t indexh](h)}(hhh]j)}(hpgoff_th]hpgoff_t}(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj)modnameN classnameNjj)}j]juc.folio_file_pageasbuh1hhj ubj)}(h h]h }(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(hindexh]hindex}(hjShhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hj6hhhjGhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj2hhhjGhMubah}(h]j-ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjGhMhj/hhubj4)}(hhh]jM)}(h The page for a particular index.h]h The page for a particular index.}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjzhhubah}(h]h ]h"]h$]h&]uh1j3hj/hhhjGhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjQhNhNubj)}(hXL**Parameters** ``struct folio *folio`` The folio which contains this index. ``pgoff_t index`` The index we want to look up. **Description** Sometimes after looking up a folio in the page cache, we need to obtain the specific page for an index (eg a page fault). **Return** The page containing the file data for this index.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubj)}(hhh](j)}(h=``struct folio *folio`` The folio which contains this index. h](j)}(h``struct folio *folio``h]jS)}(hjh]hstruct folio *folio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubj)}(hhh]jM)}(h$The folio which contains this index.h]h$The folio which contains this index.}(hjעhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjӢhMhjԢubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjӢhMhjubj)}(h0``pgoff_t index`` The index we want to look up. h](j)}(h``pgoff_t index``h]jS)}(hjh]h pgoff_t index}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubj)}(hhh]jM)}(hThe index we want to look up.h]hThe index we want to look up.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj hMhj ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj hMhjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hj2h]h Description}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj0ubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubjM)}(hySometimes after looking up a folio in the page cache, we need to obtain the specific page for an index (eg a page fault).h]hySometimes after looking up a folio in the page cache, we need to obtain the specific page for an index (eg a page fault).}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubjM)}(h **Return**h]j)}(hjYh]hReturn}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjWubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubjM)}(h1The page containing the file data for this index.h]h1The page containing the file data for this index.}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjQhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfolio_contains (C function)c.folio_containshNtauh1hhjQhhhNhNubh)}(hhh](h)}(h>bool folio_contains (const struct folio *folio, pgoff_t index)h]h)}(h=bool folio_contains(const struct folio *folio, pgoff_t index)h](j)}(hjh]hbool}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh)}(hfolio_containsh]j)}(hfolio_containsh]hfolio_contains}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMubj8)}(h*(const struct folio *folio, pgoff_t index)h](j>)}(hconst struct folio *folioh](j)}(hjh]hconst}(hjڣhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj֣ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj֣ubj)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj֣ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj֣ubh)}(hhh]j)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsbc.folio_containsasbuh1hhj֣ubj)}(h h]h }(hj3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj֣ubjr)}(hjuh]h*}(hjAhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj֣ubj)}(hfolioh]hfolio}(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj֣ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjңubj>)}(h pgoff_t indexh](h)}(hhh]j)}(hpgoff_th]hpgoff_t}(hjjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjlmodnameN classnameNjj)}j]j/c.folio_containsasbuh1hhjcubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjcubj)}(hindexh]hindex}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjcubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjңubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]jM)}(h#Does this folio contain this index?h]h#Does this folio contain this index?}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjؤjHjؤjIjJjKuh1hhhhjQhNhNubj)}(hX**Parameters** ``const struct folio *folio`` The folio. ``pgoff_t index`` The page index within the file. **Context** The caller should have the folio locked and ensure e.g., shmem did not move this folio to the swap cache. **Return** true or false.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjܤubj)}(hhh](j)}(h)``const struct folio *folio`` The folio. h](j)}(h``const struct folio *folio``h]jS)}(hjh]hconst struct folio *folio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubj)}(hhh]jM)}(h The folio.h]h The folio.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h2``pgoff_t index`` The page index within the file. h](j)}(h``pgoff_t index``h]jS)}(hj:h]h pgoff_t index}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj8ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhj4ubj)}(hhh]jM)}(hThe page index within the file.h]hThe page index within the file.}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjOhMhjPubah}(h]h ]h"]h$]h&]uh1jhj4ubeh}(h]h ]h"]h$]h&]uh1jhjOhMhjubeh}(h]h ]h"]h$]h&]uh1jhjܤubjM)}(h **Context**h]j)}(hjuh]hContext}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjsubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjܤubjM)}(hiThe caller should have the folio locked and ensure e.g., shmem did not move this folio to the swap cache.h]hiThe caller should have the folio locked and ensure e.g., shmem did not move this folio to the swap cache.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjܤubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjܤubjM)}(htrue or false.h]htrue or false.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjܤubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjQhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hpage_pgoff (C function) c.page_pgoffhNtauh1hhjQhhhNhNubh)}(hhh](h)}(hGpgoff_t page_pgoff (const struct folio *folio, const struct page *page)h]h)}(hFpgoff_t page_pgoff(const struct folio *folio, const struct page *page)h](h)}(hhh]j)}(hpgoff_th]hpgoff_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}j page_pgoffsb c.page_pgoffasbuh1hhjݥhhhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjݥhhhjhMubh)}(h page_pgoffh]j)}(hjh]h page_pgoff}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjݥhhhjhMubj8)}(h4(const struct folio *folio, const struct page *page)h](j>)}(hconst struct folio *folioh](j)}(hjh]hconst}(hj3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/ubj)}(h h]h }(hj@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/ubj)}(hjJ,h]hstruct}(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/ubj)}(h h]h }(hj[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/ubh)}(hhh]j)}(hfolioh]hfolio}(hjlhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjiubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjnmodnameN classnameNjj)}j]j c.page_pgoffasbuh1hhj/ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/ubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj/ubj)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj+ubj>)}(hconst struct page *pageh](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj˦hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjJ,h]hstruct}(hj٦hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hpageh]hpage}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j c.page_pgoffasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hj#hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hpageh]hpage}(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj+ubeh}(h]h ]h"]h$]h&]jjuh1j7hjݥhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj٥hhhjhMubah}(h]jԥah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhj֥hhubj4)}(hhh]jM)}(h/Calculate the logical page offset of this page.h]h/Calculate the logical page offset of this page.}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjWhhubah}(h]h ]h"]h$]h&]uh1j3hj֥hhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjrjHjrjIjJjKuh1hhhhjQhNhNubj)}(hX&**Parameters** ``const struct folio *folio`` The folio containing this page. ``const struct page *page`` The page which we need the offset of. **Description** For file pages, this is the offset from the beginning of the file in units of PAGE_SIZE. For anonymous pages, this is the offset from the beginning of the anon_vma in units of PAGE_SIZE. This will return nonsense for KSM pages. **Context** Caller must have a reference on the folio or otherwise prevent it from being split or freed. **Return** The offset in units of PAGE_SIZE.h](jM)}(h**Parameters**h]j)}(hj|h]h Parameters}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjzubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjvubj)}(hhh](j)}(h>``const struct folio *folio`` The folio containing this page. h](j)}(h``const struct folio *folio``h]jS)}(hjh]hconst struct folio *folio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubj)}(hhh]jM)}(hThe folio containing this page.h]hThe folio containing this page.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(hB``const struct page *page`` The page which we need the offset of. h](j)}(h``const struct page *page``h]jS)}(hjԧh]hconst struct page *page}(hj֧hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjҧubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjΧubj)}(hhh]jM)}(h%The page which we need the offset of.h]h%The page which we need the offset of.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjΧubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubeh}(h]h ]h"]h$]h&]uh1jhjvubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjvubjM)}(hFor file pages, this is the offset from the beginning of the file in units of PAGE_SIZE. For anonymous pages, this is the offset from the beginning of the anon_vma in units of PAGE_SIZE. This will return nonsense for KSM pages.h]hFor file pages, this is the offset from the beginning of the file in units of PAGE_SIZE. For anonymous pages, this is the offset from the beginning of the anon_vma in units of PAGE_SIZE. This will return nonsense for KSM pages.}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjvubjM)}(h **Context**h]j)}(hj6h]hContext}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj4ubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjvubjM)}(h\Caller must have a reference on the folio or otherwise prevent it from being split or freed.h]h\Caller must have a reference on the folio or otherwise prevent it from being split or freed.}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjvubjM)}(h **Return**h]j)}(hj]h]hReturn}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj[ubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjvubjM)}(h!The offset in units of PAGE_SIZE.h]h!The offset in units of PAGE_SIZE.}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjvubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjQhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfolio_pos (C function) c.folio_poshNtauh1hhjQhhhNhNubh)}(hhh](h)}(h,loff_t folio_pos (const struct folio *folio)h]h)}(h+loff_t folio_pos(const struct folio *folio)h](h)}(hhh]j)}(hloff_th]hloff_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}j folio_possb c.folio_posasbuh1hhjhhhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM ubj)}(h h]h }(hjǨhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjƨhM ubh)}(h folio_posh]j)}(hjèh]h folio_pos}(hj٨hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjըubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjƨhM ubj8)}(h(const struct folio *folio)h]j>)}(hconst struct folio *folioh](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hfolioh]hfolio}(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj/modnameN classnameNjj)}j]j c.folio_posasbuh1hhjubj)}(h h]h }(hjKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjYhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hfolioh]hfolio}(hjfhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjƨhM ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjƨhM ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjƨhM hjhhubj4)}(hhh]jM)}(h4Returns the byte position of this folio in its file.h]h4Returns the byte position of this folio in its file.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM hjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjƨhM ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjQhNhNubj)}(h:**Parameters** ``const struct folio *folio`` The folio.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubj)}(hhh]j)}(h(``const struct folio *folio`` The folio.h](j)}(h``const struct folio *folio``h]jS)}(hjѩh]hconst struct folio *folio}(hjөhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjϩubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhj˩ubj)}(hhh]jM)}(h The folio.h]h The folio.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubah}(h]h ]h"]h$]h&]uh1jhj˩ubeh}(h]h ]h"]h$]h&]uh1jhjhMhjȩubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjQhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hlinear_page_delta (C function)c.linear_page_deltahNtauh1hhjQhhhNhNubh)}(hhh](h)}(hYpgoff_t linear_page_delta (const struct vm_area_struct *vma, const unsigned long address)h]h)}(hXpgoff_t linear_page_delta(const struct vm_area_struct *vma, const unsigned long address)h](h)}(hhh]j)}(hpgoff_th]hpgoff_t}(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj0modnameN classnameNjj)}j]j)}jlinear_page_deltasbc.linear_page_deltaasbuh1hhj'hhhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM(ubj)}(h h]h }(hjPhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj'hhhjOhM(ubh)}(hlinear_page_deltah]j)}(hjLh]hlinear_page_delta}(hjbhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj'hhhjOhM(ubj8)}(h?(const struct vm_area_struct *vma, const unsigned long address)h](j>)}(h const struct vm_area_struct *vmah](j)}(hjh]hconst}(hj}hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyubj)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyubh)}(hhh]j)}(hvm_area_structh]hvm_area_struct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jJc.linear_page_deltaasbuh1hhjyubj)}(h h]h }(hjԪhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjyubj)}(hvmah]hvma}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjuubj>)}(hconst unsigned long addressh](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hunsignedh]hunsigned}(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj1hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hlongh]hlong}(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjMhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(haddressh]haddress}(hj[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjuubeh}(h]h ]h"]h$]h&]jjuh1j7hj'hhhjOhM(ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj#hhhjOhM(ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjOhM(hj hhubj4)}(hhh]jM)}(hADetermine the relative page offset of **address** within **vma**.h](h&Determine the relative page offset of }(hjhhhNhNubj)}(h **address**h]haddress}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh within }(hjhhhNhNubj)}(h**vma**h]hvma}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM(hjhhubah}(h]h ]h"]h$]h&]uh1j3hj hhhjOhM(ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjQhNhNubj)}(hX**Parameters** ``const struct vm_area_struct *vma`` The VMA in which **address** resides. ``const unsigned long address`` The address whose relative page offset is required. **Description** The result is identical for both file-backed and anonymous mappings and simply determines how many pages **address** lies from **vma->vm_start**. **Return** The number of pages **address** is offset by within **vma**.h](jM)}(h**Parameters**h]j)}(hj˫h]h Parameters}(hjͫhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjɫubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM,hjūubj)}(hhh](j)}(hK``const struct vm_area_struct *vma`` The VMA in which **address** resides. h](j)}(h$``const struct vm_area_struct *vma``h]jS)}(hjh]h const struct vm_area_struct *vma}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM*hjubj)}(hhh]jM)}(h%The VMA in which **address** resides.h](hThe VMA in which }(hjhhhNhNubj)}(h **address**h]haddress}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh resides.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhjhM*hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM*hjubj)}(hT``const unsigned long address`` The address whose relative page offset is required. h](j)}(h``const unsigned long address``h]jS)}(hj5h]hconst unsigned long address}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj3ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM+hj/ubj)}(hhh]jM)}(h3The address whose relative page offset is required.h]h3The address whose relative page offset is required.}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjJhM+hjKubah}(h]h ]h"]h$]h&]uh1jhj/ubeh}(h]h ]h"]h$]h&]uh1jhjJhM+hjubeh}(h]h ]h"]h$]h&]uh1jhjūubjM)}(h**Description**h]j)}(hjph]h Description}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjnubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM-hjūubjM)}(hThe result is identical for both file-backed and anonymous mappings and simply determines how many pages **address** lies from **vma->vm_start**.h](hiThe result is identical for both file-backed and anonymous mappings and simply determines how many pages }(hjhhhNhNubj)}(h **address**h]haddress}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh lies from }(hjhhhNhNubj)}(h**vma->vm_start**h]h vma->vm_start}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM,hjūubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM/hjūubjM)}(h)}(h const struct vm_area_struct *vmah](j)}(hjh]hconst}(hjvhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjrubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjrubj)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjrubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjrubh)}(hhh]j)}(hvm_area_structh]hvm_area_struct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jCc.linear_page_indexasbuh1hhjrubj)}(h h]h }(hjͭhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjrubjr)}(hjuh]h*}(hjۭhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjrubj)}(hvmah]hvma}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjrubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjnubj>)}(hconst unsigned long addressh](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hlongh]hlong}(hj8hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(haddressh]haddress}(hjThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjnubeh}(h]h ]h"]h$]h&]jjuh1j7hj hhhjHhM9ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjHhM9ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjHhM9hjhhubj4)}(hhh]jM)}(hADetermine the absolute page offset of **address** within **vma**.h](h&Determine the absolute page offset of }(hj~hhhNhNubj)}(h **address**h]haddress}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj~ubh within }(hj~hhhNhNubj)}(h**vma**h]hvma}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj~ubh.}(hj~hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM9hj{hhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjHhM9ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjQhNhNubj)}(hXe**Parameters** ``const struct vm_area_struct *vma`` The VMA in which **address** resides. ``const unsigned long address`` The address whose absolute page offset is required. **Description** See the comment for vma_start_pgoff() for a description of what the page offset signifies. **Return** The absolute page offset of **address** within **vma**.h](jM)}(h**Parameters**h]j)}(hjĮh]h Parameters}(hjƮhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj®ubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM=hjubj)}(hhh](j)}(hK``const struct vm_area_struct *vma`` The VMA in which **address** resides. h](j)}(h$``const struct vm_area_struct *vma``h]jS)}(hjh]h const struct vm_area_struct *vma}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM;hjݮubj)}(hhh]jM)}(h%The VMA in which **address** resides.h](hThe VMA in which }(hjhhhNhNubj)}(h **address**h]haddress}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh resides.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhjhM;hjubah}(h]h ]h"]h$]h&]uh1jhjݮubeh}(h]h ]h"]h$]h&]uh1jhjhM;hjڮubj)}(hT``const unsigned long address`` The address whose absolute page offset is required. h](j)}(h``const unsigned long address``h]jS)}(hj.h]hconst unsigned long address}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj,ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM<hj(ubj)}(hhh]jM)}(h3The address whose absolute page offset is required.h]h3The address whose absolute page offset is required.}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjChM<hjDubah}(h]h ]h"]h$]h&]uh1jhj(ubeh}(h]h ]h"]h$]h&]uh1jhjChM<hjڮubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjih]h Description}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjgubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM>hjubjM)}(hZSee the comment for vma_start_pgoff() for a description of what the page offset signifies.h]hZSee the comment for vma_start_pgoff() for a description of what the page offset signifies.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM=hjubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM@hjubjM)}(h7The absolute page offset of **address** within **vma**.h](hThe absolute page offset of }(hjhhhNhNubj)}(h **address**h]haddress}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh within }(hjhhhNhNubj)}(h**vma**h]hvma}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMAhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjQhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h#linear_anon_page_index (C function)c.linear_anon_page_indexhNtauh1hhjQhhhNhNubh)}(hhh](h)}(h^pgoff_t linear_anon_page_index (const struct vm_area_struct *vma, const unsigned long address)h]h)}(h]pgoff_t linear_anon_page_index(const struct vm_area_struct *vma, const unsigned long address)h](h)}(hhh]j)}(hpgoff_th]hpgoff_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jlinear_anon_page_indexsbc.linear_anon_page_indexasbuh1hhjhhhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMPubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMPubh)}(hlinear_anon_page_indexh]j)}(hjh]hlinear_anon_page_index}(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMPubj8)}(h?(const struct vm_area_struct *vma, const unsigned long address)h](j>)}(h const struct vm_area_struct *vmah](j)}(hjh]hconst}(hjKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGubj)}(h h]h }(hjXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGubj)}(hjJ,h]hstruct}(hjfhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGubj)}(h h]h }(hjshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGubh)}(hhh]j)}(hvm_area_structh]hvm_area_struct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.linear_anon_page_indexasbuh1hhjGubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjGubj)}(hvmah]hvma}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjCubj>)}(hconst unsigned long addressh](j)}(hjh]hconst}(hjְhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjҰubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjҰubj)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjҰubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjҰubj)}(hlongh]hlong}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjҰubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjҰubj)}(haddressh]haddress}(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjҰubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjCubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMPubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMPubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMPhjhhubj4)}(hhh]jM)}(hKDetermine the absolute anonymous page offset of **address** within **vma**.h](h0Determine the absolute anonymous page offset of }(hjShhhNhNubj)}(h **address**h]haddress}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjSubh within }(hjShhhNhNubj)}(h**vma**h]hvma}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjSubh.}(hjShhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMPhjPhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMPubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjQhNhNubj)}(hX**Parameters** ``const struct vm_area_struct *vma`` An anonymous or MAP_PRIVATE file-backed VMA in which **address** resides. ``const unsigned long address`` The address whose absolute page offset is required. **Description** This returns the anonymous page offset of **address**, which is the page offset the address possessed at the time the VMA was first faulted. For anonymous mappings, this returns the same value as linear_page_index(). For MAP_PRIVATE file-backed mappings, this returns the anonymous page offset of **address**, which is the page offset the address possessed at the time the VMA was first faulted. It is not valid to call this function for shared file-backed mappings. **Return** The absolute anonymous page offset of **address** within **vma**.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMThjubj)}(hhh](j)}(ho``const struct vm_area_struct *vma`` An anonymous or MAP_PRIVATE file-backed VMA in which **address** resides. h](j)}(h$``const struct vm_area_struct *vma``h]jS)}(hjh]h const struct vm_area_struct *vma}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMRhjubj)}(hhh]jM)}(hIAn anonymous or MAP_PRIVATE file-backed VMA in which **address** resides.h](h5An anonymous or MAP_PRIVATE file-backed VMA in which }(hjѱhhhNhNubj)}(h **address**h]haddress}(hjٱhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjѱubh resides.}(hjѱhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhjͱhMRhjαubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjͱhMRhjubj)}(hT``const unsigned long address`` The address whose absolute page offset is required. h](j)}(h``const unsigned long address``h]jS)}(hjh]hconst unsigned long address}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMShjubj)}(hhh]jM)}(h3The address whose absolute page offset is required.h]h3The address whose absolute page offset is required.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMShjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMShjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hj>h]h Description}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj<ubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMUhjubjM)}(hThis returns the anonymous page offset of **address**, which is the page offset the address possessed at the time the VMA was first faulted.h](h*This returns the anonymous page offset of }(hjThhhNhNubj)}(h **address**h]haddress}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjTubhW, which is the page offset the address possessed at the time the VMA was first faulted.}(hjThhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMThjubjM)}(hKFor anonymous mappings, this returns the same value as linear_page_index().h]hKFor anonymous mappings, this returns the same value as linear_page_index().}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMWhjubjM)}(hFor MAP_PRIVATE file-backed mappings, this returns the anonymous page offset of **address**, which is the page offset the address possessed at the time the VMA was first faulted.h](hPFor MAP_PRIVATE file-backed mappings, this returns the anonymous page offset of }(hjhhhNhNubj)}(h **address**h]haddress}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhW, which is the page offset the address possessed at the time the VMA was first faulted.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMYhjubjM)}(hFIt is not valid to call this function for shared file-backed mappings.h]hFIt is not valid to call this function for shared file-backed mappings.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM]hjubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM_hjubjM)}(hAThe absolute anonymous page offset of **address** within **vma**.h](h&The absolute anonymous page offset of }(hj̲hhhNhNubj)}(h **address**h]haddress}(hjԲhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj̲ubh within }(hj̲hhhNhNubj)}(h**vma**h]hvma}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj̲ubh.}(hj̲hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM`hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjQhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfolio_trylock (C function)c.folio_trylockhNtauh1hhjQhhhNhNubh)}(hhh](h)}(h(bool folio_trylock (struct folio *folio)h]h)}(h'bool folio_trylock(struct folio *folio)h](j)}(hjh]hbool}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMubj)}(h h]h }(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhj,hMubh)}(h folio_trylockh]j)}(h folio_trylockh]h folio_trylock}(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhj,hMubj8)}(h(struct folio *folio)h]j>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hj[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjWubj)}(h h]h }(hjhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjWubh)}(hhh]j)}(hfolioh]hfolio}(hjyhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj{modnameN classnameNjj)}j]j)}jjAsbc.folio_trylockasbuh1hhjWubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjWubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjWubj)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjWubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjSubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhj,hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhj,hMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj,hMhjhhubj4)}(hhh]jM)}(hAttempt to lock a folio.h]hAttempt to lock a folio.}(hj޳hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhj۳hhubah}(h]h ]h"]h$]h&]uh1j3hjhhhj,hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjQhNhNubj)}(hX**Parameters** ``struct folio *folio`` The folio to attempt to lock. **Description** Sometimes it is undesirable to wait for a folio to be unlocked (eg when the locks are being taken in the wrong order, or if making progress through a batch of folios is more important than processing them in order). Usually folio_lock() is the correct function to call. **Context** Any context. **Return** Whether the lock was successfully acquired.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubj)}(hhh]j)}(h6``struct folio *folio`` The folio to attempt to lock. h](j)}(h``struct folio *folio``h]jS)}(hjh]hstruct folio *folio}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubj)}(hhh]jM)}(hThe folio to attempt to lock.h]hThe folio to attempt to lock.}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj4hMhj5ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj4hMhjubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjZh]h Description}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjXubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubjM)}(hXSometimes it is undesirable to wait for a folio to be unlocked (eg when the locks are being taken in the wrong order, or if making progress through a batch of folios is more important than processing them in order). Usually folio_lock() is the correct function to call.h]hXSometimes it is undesirable to wait for a folio to be unlocked (eg when the locks are being taken in the wrong order, or if making progress through a batch of folios is more important than processing them in order). Usually folio_lock() is the correct function to call.}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubjM)}(h **Context**h]j)}(hjh]hContext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubjM)}(h Any context.h]h Any context.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubjM)}(h+Whether the lock was successfully acquired.h]h+Whether the lock was successfully acquired.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjQhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfolio_lock (C function) c.folio_lockhNtauh1hhjQhhhNhNubh)}(hhh](h)}(h%void folio_lock (struct folio *folio)h]h)}(h$void folio_lock(struct folio *folio)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh)}(h folio_lockh]j)}(h folio_lockh]h folio_lock}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMubj8)}(h(struct folio *folio)h]j>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubj)}(h h]h }(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubh)}(hhh]j)}(hfolioh]hfolio}(hjHhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjJmodnameN classnameNjj)}j]j)}jjsb c.folio_lockasbuh1hhj&ubj)}(h h]h }(hjhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubjr)}(hjuh]h*}(hjvhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj&ubj)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj"ubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]jM)}(hLock this folio.h]hLock this folio.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjŵjHjŵjIjJjKuh1hhhhjQhNhNubj)}(hX**Parameters** ``struct folio *folio`` The folio to lock. **Description** The folio lock protects against many things, probably more than it should. It is primarily held while a folio is being brought uptodate, either from its backing file or from swap. It is also held while a folio is being truncated from its address_space, so holding the lock is sufficient to keep folio->mapping stable. The folio lock is also held while write() is modifying the page to provide POSIX atomicity guarantees (as long as the write does not cross a page boundary). Other modifications to the data in the folio do not hold the folio lock and can race with writes, eg DMA and stores to mapped pages. **Context** May sleep. If you need to acquire the locks of two or more folios, they must be in order of ascending index, if they are in the same address_space. If they are in different address_spaces, acquire the lock of the folio which belongs to the address_space which has the lowest address in memory first.h](jM)}(h**Parameters**h]j)}(hjϵh]h Parameters}(hjѵhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj͵ubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjɵubj)}(hhh]j)}(h+``struct folio *folio`` The folio to lock. h](j)}(h``struct folio *folio``h]jS)}(hjh]hstruct folio *folio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubj)}(hhh]jM)}(hThe folio to lock.h]hThe folio to lock.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjɵubjM)}(h**Description**h]j)}(hj)h]h Description}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj'ubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjɵubjM)}(hX?The folio lock protects against many things, probably more than it should. It is primarily held while a folio is being brought uptodate, either from its backing file or from swap. It is also held while a folio is being truncated from its address_space, so holding the lock is sufficient to keep folio->mapping stable.h]hX?The folio lock protects against many things, probably more than it should. It is primarily held while a folio is being brought uptodate, either from its backing file or from swap. It is also held while a folio is being truncated from its address_space, so holding the lock is sufficient to keep folio->mapping stable.}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjɵubjM)}(hX"The folio lock is also held while write() is modifying the page to provide POSIX atomicity guarantees (as long as the write does not cross a page boundary). Other modifications to the data in the folio do not hold the folio lock and can race with writes, eg DMA and stores to mapped pages.h]hX"The folio lock is also held while write() is modifying the page to provide POSIX atomicity guarantees (as long as the write does not cross a page boundary). Other modifications to the data in the folio do not hold the folio lock and can race with writes, eg DMA and stores to mapped pages.}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjɵubjM)}(h **Context**h]j)}(hj_h]hContext}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1jhj]ubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjɵubjM)}(hX-May sleep. If you need to acquire the locks of two or more folios, they must be in order of ascending index, if they are in the same address_space. If they are in different address_spaces, acquire the lock of the folio which belongs to the address_space which has the lowest address in memory first.h]hX-May sleep. If you need to acquire the locks of two or more folios, they must be in order of ascending index, if they are in the same address_space. If they are in different address_spaces, acquire the lock of the folio which belongs to the address_space which has the lowest address in memory first.}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjɵubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjQhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hlock_page (C function) c.lock_pagehNtauh1hhjQhhhNhNubh)}(hhh](h)}(h"void lock_page (struct page *page)h]h)}(h!void lock_page(struct page *page)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh)}(h lock_pageh]j)}(h lock_pageh]h lock_page}(hjŶhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMubj8)}(h(struct page *page)h]j>)}(hstruct page *pageh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjݶubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjݶubh)}(hhh]j)}(hpageh]hpage}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjǶsb c.lock_pageasbuh1hhjݶubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjݶubjr)}(hjuh]h*}(hj-hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjݶubj)}(hpageh]hpage}(hj:hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjݶubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjٶubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]jM)}(h$Lock the folio containing this page.h]h$Lock the folio containing this page.}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjahhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj|jHj|jIjJjKuh1hhhhjQhNhNubj)}(hXS**Parameters** ``struct page *page`` The page to lock. **Description** See folio_lock() for a description of what the lock protects. This is a legacy function and new code should probably use folio_lock() instead. **Context** May sleep. Pages in the same folio share a lock, so do not attempt to lock two pages which share a folio.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubj)}(hhh]j)}(h(``struct page *page`` The page to lock. h](j)}(h``struct page *page``h]jS)}(hjh]hstruct page *page}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubj)}(hhh]jM)}(hThe page to lock.h]hThe page to lock.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj޷ubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubjM)}(hSee folio_lock() for a description of what the lock protects. This is a legacy function and new code should probably use folio_lock() instead.h]hSee folio_lock() for a description of what the lock protects. This is a legacy function and new code should probably use folio_lock() instead.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubjM)}(h **Context**h]j)}(hjh]hContext}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubjM)}(hjMay sleep. Pages in the same folio share a lock, so do not attempt to lock two pages which share a folio.h]hjMay sleep. Pages in the same folio share a lock, so do not attempt to lock two pages which share a folio.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjQhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h folio_lock_killable (C function)c.folio_lock_killablehNtauh1hhjQhhhNhNubh)}(hhh](h)}(h-int folio_lock_killable (struct folio *folio)h]h)}(h,int folio_lock_killable(struct folio *folio)h](j)}(hinth]hint}(hjLhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHhhhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMubj)}(h h]h }(hj[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHhhhjZhMubh)}(hfolio_lock_killableh]j)}(hfolio_lock_killableh]hfolio_lock_killable}(hjmhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjiubah}(h]h ](jjeh"]h$]h&]jjuh1hhjHhhhjZhMubj8)}(h(struct folio *folio)h]j>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjosbc.folio_lock_killableasbuh1hhjubj)}(h h]h }(hjǸhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjոhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjHhhhjZhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjDhhhjZhMubah}(h]j?ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjZhMhjAhhubj4)}(hhh]jM)}(h1Lock this folio, interruptible by a fatal signal.h]h1Lock this folio, interruptible by a fatal signal.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhj hhubah}(h]h ]h"]h$]h&]uh1j3hjAhhhjZhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj$jHj$jIjJjKuh1hhhhjQhNhNubj)}(hXF**Parameters** ``struct folio *folio`` The folio to lock. **Description** Attempts to lock the folio, like folio_lock(), except that the sleep to acquire the lock is interruptible by a fatal signal. **Context** May sleep; see folio_lock(). **Return** 0 if the lock was acquired; -EINTR if a fatal signal was received.h](jM)}(h**Parameters**h]j)}(hj.h]h Parameters}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj,ubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhj(ubj)}(hhh]j)}(h+``struct folio *folio`` The folio to lock. h](j)}(h``struct folio *folio``h]jS)}(hjMh]hstruct folio *folio}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjKubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjGubj)}(hhh]jM)}(hThe folio to lock.h]hThe folio to lock.}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjbhMhjcubah}(h]h ]h"]h$]h&]uh1jhjGubeh}(h]h ]h"]h$]h&]uh1jhjbhMhjDubah}(h]h ]h"]h$]h&]uh1jhj(ubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhj(ubjM)}(h|Attempts to lock the folio, like folio_lock(), except that the sleep to acquire the lock is interruptible by a fatal signal.h]h|Attempts to lock the folio, like folio_lock(), except that the sleep to acquire the lock is interruptible by a fatal signal.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhj(ubjM)}(h **Context**h]j)}(hjh]hContext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhj(ubjM)}(hMay sleep; see folio_lock().h]hMay sleep; see folio_lock().}(hjŹhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhj(ubjM)}(h **Return**h]j)}(hjֹh]hReturn}(hjعhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjԹubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhj(ubjM)}(hB0 if the lock was acquired; -EINTR if a fatal signal was received.h]hB0 if the lock was acquired; -EINTR if a fatal signal was received.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhj(ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjQhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h*filemap_range_needs_writeback (C function)c.filemap_range_needs_writebackhNtauh1hhjQhhhNhNubh)}(hhh](h)}(hfbool filemap_range_needs_writeback (struct address_space *mapping, loff_t start_byte, loff_t end_byte)h]h)}(hebool filemap_range_needs_writeback(struct address_space *mapping, loff_t start_byte, loff_t end_byte)h](j)}(hjh]hbool}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMSubj)}(h h]h }(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhj(hMSubh)}(hfilemap_range_needs_writebackh]j)}(hfilemap_range_needs_writebackh]hfilemap_range_needs_writeback}(hj;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhj(hMSubj8)}(hC(struct address_space *mapping, loff_t start_byte, loff_t end_byte)h](j>)}(hstruct address_space *mappingh](j)}(hjJ,h]hstruct}(hjWhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSubj)}(h h]h }(hjdhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSubh)}(hhh]j)}(h address_spaceh]h address_space}(hjuhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjrubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjwmodnameN classnameNjj)}j]j)}jj=sbc.filemap_range_needs_writebackasbuh1hhjSubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjSubj)}(hmappingh]hmapping}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjOubj>)}(hloff_t start_byteh](h)}(hhh]j)}(hloff_th]hloff_t}(hj̺hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjɺubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjκmodnameN classnameNjj)}j]jc.filemap_range_needs_writebackasbuh1hhjźubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjźubj)}(h start_byteh]h start_byte}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjźubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjOubj>)}(hloff_t end_byteh](h)}(hhh]j)}(hloff_th]hloff_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.filemap_range_needs_writebackasbuh1hhj ubj)}(h h]h }(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(hend_byteh]hend_byte}(hj@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjOubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhj(hMSubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhj(hMSubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj(hMShjhhubj4)}(hhh]jM)}(h*check if range potentially needs writebackh]h*check if range potentially needs writeback}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMShjghhubah}(h]h ]h"]h$]h&]uh1j3hjhhhj(hMSubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjQhNhNubj)}(hX**Parameters** ``struct address_space *mapping`` address space within which to check ``loff_t start_byte`` offset in bytes where the range starts ``loff_t end_byte`` offset in bytes where the range ends (inclusive) **Description** Find at least one page in the range supplied, usually used to check if direct writing in this range will trigger a writeback. Used by O_DIRECT read/write with IOCB_NOWAIT, to see if the caller needs to do filemap_write_and_wait_range() before proceeding. **Return** ``true`` if the caller should do filemap_write_and_wait_range() before doing O_DIRECT to a page in this range, ``false`` otherwise.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMWhjubj)}(hhh](j)}(hF``struct address_space *mapping`` address space within which to check h](j)}(h!``struct address_space *mapping``h]jS)}(hjh]hstruct address_space *mapping}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMThjubj)}(hhh]jM)}(h#address space within which to checkh]h#address space within which to check}(hjĻhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMThjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMThjubj)}(h=``loff_t start_byte`` offset in bytes where the range starts h](j)}(h``loff_t start_byte``h]jS)}(hjh]hloff_t start_byte}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMUhj޻ubj)}(hhh]jM)}(h&offset in bytes where the range startsh]h&offset in bytes where the range starts}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMUhjubah}(h]h ]h"]h$]h&]uh1jhj޻ubeh}(h]h ]h"]h$]h&]uh1jhjhMUhjubj)}(hE``loff_t end_byte`` offset in bytes where the range ends (inclusive) h](j)}(h``loff_t end_byte``h]jS)}(hjh]hloff_t end_byte}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMVhjubj)}(hhh]jM)}(h0offset in bytes where the range ends (inclusive)h]h0offset in bytes where the range ends (inclusive)}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj2hMVhj3ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj2hMVhjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjXh]h Description}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjVubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMXhjubjM)}(hFind at least one page in the range supplied, usually used to check if direct writing in this range will trigger a writeback. Used by O_DIRECT read/write with IOCB_NOWAIT, to see if the caller needs to do filemap_write_and_wait_range() before proceeding.h]hFind at least one page in the range supplied, usually used to check if direct writing in this range will trigger a writeback. Used by O_DIRECT read/write with IOCB_NOWAIT, to see if the caller needs to do filemap_write_and_wait_range() before proceeding.}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMWhjubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj}ubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM\hjubjM)}(h``true`` if the caller should do filemap_write_and_wait_range() before doing O_DIRECT to a page in this range, ``false`` otherwise.h](jS)}(h``true``h]htrue}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubhg if the caller should do filemap_write_and_wait_range() before doing O_DIRECT to a page in this range, }(hjhhhNhNubjS)}(h ``false``h]hfalse}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubh otherwise.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM]hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjQhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hreadahead_control (C struct)c.readahead_controlhNtauh1hhjQhhhNhNubh)}(hhh](h)}(hreadahead_controlh]h)}(hstruct readahead_controlh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMcubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMcubh)}(hreadahead_controlh]j)}(hj޼h]hreadahead_control}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMcubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjܼhhhjhMcubah}(h]j׼ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMchjټhhubj4)}(hhh]jM)}(hDescribes a readahead request.h]hDescribes a readahead request.}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMmhj#hhubah}(h]h ]h"]h$]h&]uh1j3hjټhhhjhMcubeh}(h]h ](jAstructeh"]h$]h&]jFjAjGj>jHj>jIjJjKuh1hhhhjQhNhNubj)}(hX**Definition**:: struct readahead_control { struct file *file; struct address_space *mapping; struct file_ra_state *ra; }; **Members** ``file`` The file, used primarily by network filesystems for authentication. May be NULL if invoked internally by the filesystem. ``mapping`` Readahead this filesystem object. ``ra`` File readahead state. May be NULL.h](jM)}(h**Definition**::h](j)}(h**Definition**h]h Definition}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjFubh:}(hjFhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMqhjBubj7 )}(hustruct readahead_control { struct file *file; struct address_space *mapping; struct file_ra_state *ra; };h]hustruct readahead_control { struct file *file; struct address_space *mapping; struct file_ra_state *ra; };}hjcsbah}(h]h ]h"]h$]h&]jjuh1j6 hW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMshjBubjM)}(h **Members**h]j)}(hjth]hMembers}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjrubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMyhjBubj)}(hhh](j)}(h``file`` The file, used primarily by network filesystems for authentication. May be NULL if invoked internally by the filesystem. h](j)}(h``file``h]jS)}(hjh]hfile}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMyhjubj)}(hhh]jM)}(hxThe file, used primarily by network filesystems for authentication. May be NULL if invoked internally by the filesystem.h]hxThe file, used primarily by network filesystems for authentication. May be NULL if invoked internally by the filesystem.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMxhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMyhjubj)}(h.``mapping`` Readahead this filesystem object. h](j)}(h ``mapping``h]jS)}(hjͽh]hmapping}(hjϽhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj˽ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMzhjǽubj)}(hhh]jM)}(h!Readahead this filesystem object.h]h!Readahead this filesystem object.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMzhjubah}(h]h ]h"]h$]h&]uh1jhjǽubeh}(h]h ]h"]h$]h&]uh1jhjhMzhjubj)}(h*``ra`` File readahead state. May be NULL.h](j)}(h``ra``h]jS)}(hjh]hra}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMzhjubj)}(hhh]jM)}(h#File readahead state. May be NULL.h]h#File readahead state. May be NULL.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM{hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMzhjubeh}(h]h ]h"]h$]h&]uh1jhjBubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjQhhhNhNubjM)}(h**Description**h]j)}(hjIh]h Description}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjGubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM~hjQhhubjM)}(hA readahead request is for consecutive pages. Filesystems which implement the ->readahead method should call readahead_folio() or __readahead_batch() in a loop and attempt to start reads into each folio in the request.h]hA readahead request is for consecutive pages. Filesystems which implement the ->readahead method should call readahead_folio() or __readahead_batch() in a loop and attempt to start reads into each folio in the request.}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMnhjQhhubjM)}(h\Most of the fields in this struct are private and should be accessed by the functions below.h]h\Most of the fields in this struct are private and should be accessed by the functions below.}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMshjQhhubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h&page_cache_sync_readahead (C function)c.page_cache_sync_readaheadhNtauh1hhjQhhhNhNubh)}(hhh](h)}(hvoid page_cache_sync_readahead (struct address_space *mapping, struct file_ra_state *ra, struct file *file, pgoff_t index, unsigned long req_count)h]h)}(hvoid page_cache_sync_readahead(struct address_space *mapping, struct file_ra_state *ra, struct file *file, pgoff_t index, unsigned long req_count)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh)}(hpage_cache_sync_readaheadh]j)}(hpage_cache_sync_readaheadh]hpage_cache_sync_readahead}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMubj8)}(ht(struct address_space *mapping, struct file_ra_state *ra, struct file *file, pgoff_t index, unsigned long req_count)h](j>)}(hstruct address_space *mappingh](j)}(hjJ,h]hstruct}(hjӾhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjϾubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjϾubh)}(hhh]j)}(h address_spaceh]h address_space}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsbc.page_cache_sync_readaheadasbuh1hhjϾubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjϾubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjϾubj)}(hmappingh]hmapping}(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjϾubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj˾ubj>)}(hstruct file_ra_state *rah](j)}(hjJ,h]hstruct}(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjAubj)}(h h]h }(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjAubh)}(hhh]j)}(h file_ra_stateh]h file_ra_state}(hjchhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj`ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjemodnameN classnameNjj)}j]j c.page_cache_sync_readaheadasbuh1hhjAubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjAubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjAubj)}(hrah]hra}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjAubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj˾ubj>)}(hstruct file *fileh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj¿hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hfileh]hfile}(hjӿhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjпubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjտmodnameN classnameNjj)}j]j c.page_cache_sync_readaheadasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hfileh]hfile}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj˾ubj>)}(h pgoff_t indexh](h)}(hhh]j)}(hpgoff_th]hpgoff_t}(hj(hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj*modnameN classnameNjj)}j]j c.page_cache_sync_readaheadasbuh1hhj!ubj)}(h h]h }(hjFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubj)}(hindexh]hindex}(hjThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj˾ubj>)}(hunsigned long req_counth](j)}(hunsignedh]hunsigned}(hjmhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjiubj)}(h h]h }(hj{hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjiubj)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjiubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjiubj)}(h req_counth]h req_count}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjiubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj˾ubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]jM)}(hgeneric file readaheadh]hgeneric file readahead}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjQhNhNubj)}(hX{**Parameters** ``struct address_space *mapping`` address_space which holds the pagecache and I/O vectors ``struct file_ra_state *ra`` file_ra_state which holds the readahead state ``struct file *file`` Used by the filesystem for authentication. ``pgoff_t index`` Index of first page to be read. ``unsigned long req_count`` Total number of pages being read by the caller. **Description** page_cache_sync_readahead() should be called when a cache miss happened: it will submit the read. The readahead logic may decide to piggyback more pages onto the read request if access patterns suggest it will improve performance.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubj)}(hhh](j)}(hZ``struct address_space *mapping`` address_space which holds the pagecache and I/O vectors h](j)}(h!``struct address_space *mapping``h]jS)}(hjh]hstruct address_space *mapping}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhj ubj)}(hhh]jM)}(h7address_space which holds the pagecache and I/O vectorsh]h7address_space which holds the pagecache and I/O vectors}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj%hMhj&ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj%hMhjubj)}(hK``struct file_ra_state *ra`` file_ra_state which holds the readahead state h](j)}(h``struct file_ra_state *ra``h]jS)}(hjIh]hstruct file_ra_state *ra}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjGubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjCubj)}(hhh]jM)}(h-file_ra_state which holds the readahead stateh]h-file_ra_state which holds the readahead state}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj^hMhj_ubah}(h]h ]h"]h$]h&]uh1jhjCubeh}(h]h ]h"]h$]h&]uh1jhj^hMhjubj)}(hA``struct file *file`` Used by the filesystem for authentication. h](j)}(h``struct file *file``h]jS)}(hjh]hstruct file *file}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhj|ubj)}(hhh]jM)}(h*Used by the filesystem for authentication.h]h*Used by the filesystem for authentication.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhj|ubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h2``pgoff_t index`` Index of first page to be read. h](j)}(h``pgoff_t index``h]jS)}(hjh]h pgoff_t index}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubj)}(hhh]jM)}(hIndex of first page to be read.h]hIndex of first page to be read.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(hL``unsigned long req_count`` Total number of pages being read by the caller. h](j)}(h``unsigned long req_count``h]jS)}(hjh]hunsigned long req_count}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubj)}(hhh]jM)}(h/Total number of pages being read by the caller.h]h/Total number of pages being read by the caller.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj hMhj ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj hMhjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hj/h]h Description}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj-ubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubjM)}(hpage_cache_sync_readahead() should be called when a cache miss happened: it will submit the read. The readahead logic may decide to piggyback more pages onto the read request if access patterns suggest it will improve performance.h]hpage_cache_sync_readahead() should be called when a cache miss happened: it will submit the read. The readahead logic may decide to piggyback more pages onto the read request if access patterns suggest it will improve performance.}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjQhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h'page_cache_async_readahead (C function)c.page_cache_async_readaheadhNtauh1hhjQhhhNhNubh)}(hhh](h)}(hvoid page_cache_async_readahead (struct address_space *mapping, struct file_ra_state *ra, struct file *file, struct folio *folio, unsigned long req_count)h]h)}(hvoid page_cache_async_readahead(struct address_space *mapping, struct file_ra_state *ra, struct file *file, struct folio *folio, unsigned long req_count)h](j)}(hvoidh]hvoid}(hjthhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjphhhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjphhhjhMubh)}(hpage_cache_async_readaheadh]j)}(hpage_cache_async_readaheadh]hpage_cache_async_readahead}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjphhhjhMubj8)}(hz(struct address_space *mapping, struct file_ra_state *ra, struct file *file, struct folio *folio, unsigned long req_count)h](j>)}(hstruct address_space *mappingh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(h address_spaceh]h address_space}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsbc.page_cache_async_readaheadasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hmappingh]hmapping}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hstruct file_ra_state *rah](j)}(hjJ,h]hstruct}(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(h file_ra_stateh]h file_ra_state}(hjAhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjCmodnameN classnameNjj)}j]jc.page_cache_async_readaheadasbuh1hhjubj)}(h h]h }(hj_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjmhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hrah]hra}(hjzhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hstruct file *fileh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hfileh]hfile}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.page_cache_async_readaheadasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hfileh]hfile}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hfolioh]hfolio}(hj!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj#modnameN classnameNjj)}j]jc.page_cache_async_readaheadasbuh1hhjubj)}(h h]h }(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjMhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hfolioh]hfolio}(hjZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hunsigned long req_counth](j)}(hunsignedh]hunsigned}(hjshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjoubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjoubj)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjoubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjoubj)}(h req_counth]h req_count}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjoubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjphhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjlhhhjhMubah}(h]jgah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjihhubj4)}(hhh]jM)}(hfile readahead for marked pagesh]hfile readahead for marked pages}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjhhubah}(h]h ]h"]h$]h&]uh1j3hjihhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjQhNhNubj)}(hX**Parameters** ``struct address_space *mapping`` address_space which holds the pagecache and I/O vectors ``struct file_ra_state *ra`` file_ra_state which holds the readahead state ``struct file *file`` Used by the filesystem for authentication. ``struct folio *folio`` The folio which triggered the readahead call. ``unsigned long req_count`` Total number of pages being read by the caller. **Description** page_cache_async_readahead() should be called when a page is used which is marked as PageReadahead; this is a marker to suggest that the application has used up enough of the readahead window that we should start pulling in more pages.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubj)}(hhh](j)}(hZ``struct address_space *mapping`` address_space which holds the pagecache and I/O vectors h](j)}(h!``struct address_space *mapping``h]jS)}(hjh]hstruct address_space *mapping}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubj)}(hhh]jM)}(h7address_space which holds the pagecache and I/O vectorsh]h7address_space which holds the pagecache and I/O vectors}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj+hMhj,ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj+hMhj ubj)}(hK``struct file_ra_state *ra`` file_ra_state which holds the readahead state h](j)}(h``struct file_ra_state *ra``h]jS)}(hjOh]hstruct file_ra_state *ra}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjMubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjIubj)}(hhh]jM)}(h-file_ra_state which holds the readahead stateh]h-file_ra_state which holds the readahead state}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjdhMhjeubah}(h]h ]h"]h$]h&]uh1jhjIubeh}(h]h ]h"]h$]h&]uh1jhjdhMhj ubj)}(hA``struct file *file`` Used by the filesystem for authentication. h](j)}(h``struct file *file``h]jS)}(hjh]hstruct file *file}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubj)}(hhh]jM)}(h*Used by the filesystem for authentication.h]h*Used by the filesystem for authentication.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhj ubj)}(hF``struct folio *folio`` The folio which triggered the readahead call. h](j)}(h``struct folio *folio``h]jS)}(hjh]hstruct folio *folio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubj)}(hhh]jM)}(h-The folio which triggered the readahead call.h]h-The folio which triggered the readahead call.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhj ubj)}(hL``unsigned long req_count`` Total number of pages being read by the caller. h](j)}(h``unsigned long req_count``h]jS)}(hjh]hunsigned long req_count}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubj)}(hhh]jM)}(h/Total number of pages being read by the caller.h]h/Total number of pages being read by the caller.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhj ubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hj5h]h Description}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj3ubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubjM)}(hpage_cache_async_readahead() should be called when a page is used which is marked as PageReadahead; this is a marker to suggest that the application has used up enough of the readahead window that we should start pulling in more pages.h]hpage_cache_async_readahead() should be called when a page is used which is marked as PageReadahead; this is a marker to suggest that the application has used up enough of the readahead window that we should start pulling in more pages.}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjQhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hreadahead_folio (C function)c.readahead_foliohNtauh1hhjQhhhNhNubh)}(hhh](h)}(h@struct folio * readahead_folio (struct readahead_control *ractl)h]h)}(h>struct folio *readahead_folio(struct readahead_control *ractl)h](j)}(hjJ,h]hstruct}(hjzhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvhhhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvhhhjhMubh)}(hhh]j)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jreadahead_foliosbc.readahead_folioasbuh1hhjvhhhjhMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvhhhjhMubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjvhhhjhMubh)}(hreadahead_folioh]j)}(hjh]hreadahead_folio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjvhhhjhMubj8)}(h!(struct readahead_control *ractl)h]j>)}(hstruct readahead_control *ractlh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hreadahead_controlh]hreadahead_control}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.readahead_folioasbuh1hhjubj)}(h h]h }(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hj>hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hractlh]hractl}(hjKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjvhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjrhhhjhMubah}(h]jmah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjohhubj4)}(hhh]jM)}(hGet the next folio to read.h]hGet the next folio to read.}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjrhhubah}(h]h ]h"]h$]h&]uh1j3hjohhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjQhNhNubj)}(hX **Parameters** ``struct readahead_control *ractl`` The current readahead request. **Context** The folio is locked. The caller should unlock the folio once all I/O to that folio has completed. **Return** A pointer to the next folio, or ``NULL`` if we are done.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubj)}(hhh]j)}(hC``struct readahead_control *ractl`` The current readahead request. h](j)}(h#``struct readahead_control *ractl``h]jS)}(hjh]hstruct readahead_control *ractl}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubj)}(hhh]jM)}(hThe current readahead request.h]hThe current readahead request.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h **Context**h]j)}(hjh]hContext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubjM)}(hbThe folio is locked. The caller should unlock the folio once all I/O to that folio has completed.h]hbThe folio is locked. The caller should unlock the folio once all I/O to that folio has completed.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubjM)}(h8A pointer to the next folio, or ``NULL`` if we are done.h](h A pointer to the next folio, or }(hj.hhhNhNubjS)}(h``NULL``h]hNULL}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj.ubh if we are done.}(hj.hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjQhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h!readahead_folio_last (C function)c.readahead_folio_lasthNtauh1hhjQhhhNhNubh)}(hhh](h)}(hEstruct folio * readahead_folio_last (struct readahead_control *ractl)h]h)}(hCstruct folio *readahead_folio_last(struct readahead_control *ractl)h](j)}(hjJ,h]hstruct}(hjohhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjkhhhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMubj)}(h h]h }(hj}hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjkhhhj|hMubh)}(hhh]j)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jreadahead_folio_lastsbc.readahead_folio_lastasbuh1hhjkhhhj|hMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjkhhhj|hMubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjkhhhj|hMubh)}(hreadahead_folio_lasth]j)}(hjh]hreadahead_folio_last}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjkhhhj|hMubj8)}(h!(struct readahead_control *ractl)h]j>)}(hstruct readahead_control *ractlh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hreadahead_controlh]hreadahead_control}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj modnameN classnameNjj)}j]jc.readahead_folio_lastasbuh1hhjubj)}(h h]h }(hj%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hj3hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hractlh]hractl}(hj@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjkhhhj|hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjghhhj|hMubah}(h]jbah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj|hMhjdhhubj4)}(hhh]jM)}(h*Get the next folio to read, from the tail.h]h*Get the next folio to read, from the tail.}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjghhubah}(h]h ]h"]h$]h&]uh1j3hjdhhhj|hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjQhNhNubj)}(hX**Parameters** ``struct readahead_control *ractl`` The current readahead request. **Description** Like readahead_folio(), but walks the range back-to-front. The folio is returned locked with its refcount dropped; the caller unlocks it once I/O completes. Compound folios are returned once, at their head index. **Context** The folio is locked. **Return** A pointer to the next folio, or ``NULL`` when done.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubj)}(hhh]j)}(hC``struct readahead_control *ractl`` The current readahead request. h](j)}(h#``struct readahead_control *ractl``h]jS)}(hjh]hstruct readahead_control *ractl}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubj)}(hhh]jM)}(hThe current readahead request.h]hThe current readahead request.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubjM)}(hLike readahead_folio(), but walks the range back-to-front. The folio is returned locked with its refcount dropped; the caller unlocks it once I/O completes. Compound folios are returned once, at their head index.h]hLike readahead_folio(), but walks the range back-to-front. The folio is returned locked with its refcount dropped; the caller unlocks it once I/O completes. Compound folios are returned once, at their head index.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubjM)}(h **Context**h]j)}(hj h]hContext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubjM)}(hThe folio is locked.h]hThe folio is locked.}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubjM)}(h **Return**h]j)}(hj4h]hReturn}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj2ubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubjM)}(h3A pointer to the next folio, or ``NULL`` when done.h](h A pointer to the next folio, or }(hjJhhhNhNubjS)}(h``NULL``h]hNULL}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjJubh when done.}(hjJhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjQhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hreadahead_pos (C function)c.readahead_poshNtauh1hhjQhhhNhNubh)}(hhh](h)}(h:loff_t readahead_pos (const struct readahead_control *rac)h]h)}(h9loff_t readahead_pos(const struct readahead_control *rac)h](h)}(hhh]j)}(hloff_th]hloff_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}j readahead_possbc.readahead_posasbuh1hhjhhhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM5ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]3h$]h&]uh1jhjhhhjhM5ubh)}(h readahead_posh]j)}(hjh]h readahead_pos}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhM5ubj8)}(h%(const struct readahead_control *rac)h]j>)}(h#const struct readahead_control *rach](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hreadahead_controlh]hreadahead_control}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.readahead_posasbuh1hhjubj)}(h h]h }(hj4hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjBhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hrach]hrac}(hjOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhM5ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhM5ubah}(h]j~ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhM5hjhhubj4)}(hhh]jM)}(h8The byte offset into the file of this readahead request.h]h8The byte offset into the file of this readahead request.}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM5hjvhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhM5ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjQhNhNubj)}(hP**Parameters** ``const struct readahead_control *rac`` The readahead request.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM9hjubj)}(hhh]j)}(h>``const struct readahead_control *rac`` The readahead request.h](j)}(h'``const struct readahead_control *rac``h]jS)}(hjh]h#const struct readahead_control *rac}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM;hjubj)}(hhh]jM)}(hThe readahead request.h]hThe readahead request.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM6hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM;hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjQhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hreadahead_length (C function)c.readahead_lengthhNtauh1hhjQhhhNhNubh)}(hhh](h)}(h=size_t readahead_length (const struct readahead_control *rac)h]h)}(hubj)}(h h]h }(hj9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhj8hM>ubh)}(hreadahead_lengthh]j)}(hj5h]hreadahead_length}(hjKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhj8hM>ubj8)}(h%(const struct readahead_control *rac)h]j>)}(h#const struct readahead_control *rach](j)}(hjh]hconst}(hjfhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjbubj)}(h h]h }(hjshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjbubj)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjbubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjbubh)}(hhh]j)}(hreadahead_controlh]hreadahead_control}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j3c.readahead_lengthasbuh1hhjbubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjbubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjbubj)}(hrach]hrac}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjbubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj^ubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhj8hM>ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj hhhj8hM>ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj8hM>hj hhubj4)}(hhh]jM)}(h.The number of bytes in this readahead request.h]h.The number of bytes in this readahead request.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM>hjhhubah}(h]h ]h"]h$]h&]uh1j3hj hhhj8hM>ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjQhNhNubj)}(hP**Parameters** ``const struct readahead_control *rac`` The readahead request.h](jM)}(h**Parameters**h]j)}(hj$h]h Parameters}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj"ubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMBhjubj)}(hhh]j)}(h>``const struct readahead_control *rac`` The readahead request.h](j)}(h'``const struct readahead_control *rac``h]jS)}(hjCh]h#const struct readahead_control *rac}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjAubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMDhj=ubj)}(hhh]jM)}(hThe readahead request.h]hThe readahead request.}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM?hjYubah}(h]h ]h"]h$]h&]uh1jhj=ubeh}(h]h ]h"]h$]h&]uh1jhjXhMDhj:ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjQhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hreadahead_index (C function)c.readahead_indexhNtauh1hhjQhhhNhNubh)}(hhh](h)}(h=pgoff_t readahead_index (const struct readahead_control *rac)h]h)}(h)}(h#const struct readahead_control *rach](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjJ,h]hstruct}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hreadahead_controlh]hreadahead_control}(hj(hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj*modnameN classnameNjj)}j]jc.readahead_indexasbuh1hhjubj)}(h h]h }(hjFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjThhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hrach]hrac}(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMGubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMGubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMGhjhhubj4)}(hhh]jM)}(h6The index of the first page in this readahead request.h]h6The index of the first page in this readahead request.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMGhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMGubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjQhNhNubj)}(hP**Parameters** ``const struct readahead_control *rac`` The readahead request.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMKhjubj)}(hhh]j)}(h>``const struct readahead_control *rac`` The readahead request.h](j)}(h'``const struct readahead_control *rac``h]jS)}(hjh]h#const struct readahead_control *rac}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMMhjubj)}(hhh]jM)}(hThe readahead request.h]hThe readahead request.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMHhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjQhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hreadahead_count (C function)c.readahead_counthNtauh1hhjQhhhNhNubh)}(hhh](h)}(hBunsigned int readahead_count (const struct readahead_control *rac)h]h)}(hAunsigned int readahead_count(const struct readahead_control *rac)h](j)}(hunsignedh]hunsigned}(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"hhhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMPubj)}(h h]h }(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"hhhj4hMPubj)}(hinth]hint}(hjChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"hhhj4hMPubj)}(h h]h }(hjQhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"hhhj4hMPubh)}(hreadahead_counth]j)}(hreadahead_counth]hreadahead_count}(hjchhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj_ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj"hhhj4hMPubj8)}(h%(const struct readahead_control *rac)h]j>)}(h#const struct readahead_control *rach](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{ubj)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{ubh)}(hhh]j)}(hreadahead_controlh]hreadahead_control}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjesbc.readahead_countasbuh1hhj{ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{ubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj{ubj)}(hrach]hrac}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjwubah}(h]h ]h"]h$]h&]jjuh1j7hj"hhhj4hMPubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhj4hMPubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj4hMPhjhhubj4)}(hhh]jM)}(h.The number of pages in this readahead request.h]h.The number of pages in this readahead request.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMPhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhj4hMPubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj5jHj5jIjJjKuh1hhhhjQhNhNubj)}(hP**Parameters** ``const struct readahead_control *rac`` The readahead request.h](jM)}(h**Parameters**h]j)}(hj?h]h Parameters}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj=ubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMThj9ubj)}(hhh]j)}(h>``const struct readahead_control *rac`` The readahead request.h](j)}(h'``const struct readahead_control *rac``h]jS)}(hj^h]h#const struct readahead_control *rac}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj\ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMVhjXubj)}(hhh]jM)}(hThe readahead request.h]hThe readahead request.}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMQhjtubah}(h]h ]h"]h$]h&]uh1jhjXubeh}(h]h ]h"]h$]h&]uh1jhjshMVhjUubah}(h]h ]h"]h$]h&]uh1jhj9ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjQhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h#readahead_batch_length (C function)c.readahead_batch_lengthhNtauh1hhjQhhhNhNubh)}(hhh](h)}(hCsize_t readahead_batch_length (const struct readahead_control *rac)h]h)}(hBsize_t readahead_batch_length(const struct readahead_control *rac)h](h)}(hhh]j)}(hsize_th]hsize_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jreadahead_batch_lengthsbc.readahead_batch_lengthasbuh1hhjhhhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMYubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMYubh)}(hreadahead_batch_lengthh]j)}(hjh]hreadahead_batch_length}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMYubj8)}(h%(const struct readahead_control *rac)h]j>)}(h#const struct readahead_control *rach](j)}(hjh]hconst}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjJ,h]hstruct}(hj%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hreadahead_controlh]hreadahead_control}(hjChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjEmodnameN classnameNjj)}j]jc.readahead_batch_lengthasbuh1hhjubj)}(h h]h }(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjohhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hrach]hrac}(hj|hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMYubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMYubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMYhjhhubj4)}(hhh]jM)}(h)The number of bytes in the current batch.h]h)The number of bytes in the current batch.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMYhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMYubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjQhNhNubj)}(hP**Parameters** ``const struct readahead_control *rac`` The readahead request.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM]hjubj)}(hhh]j)}(h>``const struct readahead_control *rac`` The readahead request.h](j)}(h'``const struct readahead_control *rac``h]jS)}(hjh]h#const struct readahead_control *rac}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhM_hjubj)}(hhh]jM)}(hThe readahead request.h]hThe readahead request.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMZhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM_hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjQhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h)folio_mkwrite_check_truncate (C function)c.folio_mkwrite_check_truncatehNtauh1hhjQhhhNhNubh)}(hhh](h)}(h[ssize_t folio_mkwrite_check_truncate (const struct folio *folio, const struct inode *inode)h]h)}(hZssize_t folio_mkwrite_check_truncate(const struct folio *folio, const struct inode *inode)h](h)}(hhh]j)}(hssize_th]hssize_t}(hjDhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjAubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjFmodnameN classnameNjj)}j]j)}jfolio_mkwrite_check_truncatesbc.folio_mkwrite_check_truncateasbuh1hhj=hhhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhubj)}(h h]h }(hjfhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=hhhjehMhubh)}(hfolio_mkwrite_check_truncateh]j)}(hjbh]hfolio_mkwrite_check_truncate}(hjxhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjtubah}(h]h ](jjeh"]h$]h&]jjuh1hhj=hhhjehMhubj8)}(h6(const struct folio *folio, const struct inode *inode)h](j>)}(hconst struct folio *folioh](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j`c.folio_mkwrite_check_truncateasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hconst struct inode *inodeh](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjJ,h]hstruct}(hj9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hinodeh]hinode}(hjWhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjTubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjYmodnameN classnameNjj)}j]j`c.folio_mkwrite_check_truncateasbuh1hhjubj)}(h h]h }(hjuhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hj=hhhjehMhubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj9hhhjehMhubah}(h]j4ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjehMhhj6hhubj4)}(hhh]jM)}(hcheck if folio was truncatedh]hcheck if folio was truncated}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhhjhhubah}(h]h ]h"]h$]h&]uh1j3hj6hhhjehMhubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjQhNhNubj)}(h**Parameters** ``const struct folio *folio`` the folio to check ``const struct inode *inode`` the inode to check the folio against **Return** the number of bytes in the folio up to EOF, or -EFAULT if the folio was truncated.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMlhjubj)}(hhh](j)}(h1``const struct folio *folio`` the folio to check h](j)}(h``const struct folio *folio``h]jS)}(hjh]hconst struct folio *folio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMihjubj)}(hhh]jM)}(hthe folio to checkh]hthe folio to check}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMihjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMihjubj)}(hC``const struct inode *inode`` the inode to check the folio against h](j)}(h``const struct inode *inode``h]jS)}(hj4h]hconst struct inode *inode}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj2ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMjhj.ubj)}(hhh]jM)}(h$the inode to check the folio againsth]h$the inode to check the folio against}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjIhMjhjJubah}(h]h ]h"]h$]h&]uh1jhj.ubeh}(h]h ]h"]h$]h&]uh1jhjIhMjhjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h **Return**h]j)}(hjoh]hReturn}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjmubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMlhjubjM)}(hRthe number of bytes in the folio up to EOF, or -EFAULT if the folio was truncated.h]hRthe number of bytes in the folio up to EOF, or -EFAULT if the folio was truncated.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMlhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjQhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hi_blocks_per_folio (C function)c.i_blocks_per_foliohNtauh1hhjQhhhNhNubh)}(hhh](h)}(hVunsigned int i_blocks_per_folio (const struct inode *inode, const struct folio *folio)h]h)}(hUunsigned int i_blocks_per_folio(const struct inode *inode, const struct folio *folio)h](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubj)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh)}(hi_blocks_per_folioh]j)}(hi_blocks_per_folioh]hi_blocks_per_folio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMubj8)}(h6(const struct inode *inode, const struct folio *folio)h](j>)}(hconst struct inode *inodeh](j)}(hjh]hconst}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(hjJ,h]hstruct}(hj(hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h h]h }(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubh)}(hhh]j)}(hinodeh]hinode}(hjFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjHmodnameN classnameNjj)}j]j)}jjsbc.i_blocks_per_folioasbuh1hhj ubj)}(h h]h }(hjfhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubjr)}(hjuh]h*}(hjthhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj ubj)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hconst struct folio *folioh](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jbc.i_blocks_per_folioasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hfolioh]hfolio}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]jM)}(h"How many blocks fit in this folio.h]h"How many blocks fit in this folio.}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhj3hhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjNjHjNjIjJjKuh1hhhhjQhNhNubj)}(hXy**Parameters** ``const struct inode *inode`` The inode which contains the blocks. ``const struct folio *folio`` The folio. **Description** If the block size is larger than the size of this folio, return zero. **Context** The caller should hold a refcount on the folio to prevent it from being split. **Return** The number of filesystem blocks covered by this folio.h](jM)}(h**Parameters**h]j)}(hjXh]h Parameters}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjVubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjRubj)}(hhh](j)}(hC``const struct inode *inode`` The inode which contains the blocks. h](j)}(h``const struct inode *inode``h]jS)}(hjwh]hconst struct inode *inode}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjuubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjqubj)}(hhh]jM)}(h$The inode which contains the blocks.h]h$The inode which contains the blocks.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjqubeh}(h]h ]h"]h$]h&]uh1jhjhMhjnubj)}(h)``const struct folio *folio`` The folio. h](j)}(h``const struct folio *folio``h]jS)}(hjh]hconst struct folio *folio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjubj)}(hhh]jM)}(h The folio.h]h The folio.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjnubeh}(h]h ]h"]h$]h&]uh1jhjRubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjRubjM)}(hEIf the block size is larger than the size of this folio, return zero.h]hEIf the block size is larger than the size of this folio, return zero.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjRubjM)}(h **Context**h]j)}(hjh]hContext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjRubjM)}(hNThe caller should hold a refcount on the folio to prevent it from being split.h]hNThe caller should hold a refcount on the folio to prevent it from being split.}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjRubjM)}(h **Return**h]j)}(hj9h]hReturn}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj7ubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjRubjM)}(h6The number of filesystem blocks covered by this folio.h]h6The number of filesystem blocks covered by this folio.}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:98: ./include/linux/pagemap.hhMhjRubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjQhhhNhNubeh}(h]truncateah ]h"]truncateah$]h&]uh1hhjhhhhhK]ubeh}(h]file-mapping-and-page-cacheah ]h"]file mapping and page cacheah$]h&]uh1hhhhhhhhKDubh)}(hhh](h)}(h Memory poolsh]h Memory pools}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjuhhhhhKfubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hmempool_exit (C function)c.mempool_exithNtauh1hhjuhhhNhNubh)}(hhh](h)}(h(void mempool_exit (struct mempool *pool)h]h)}(h'void mempool_exit(struct mempool *pool)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chKubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhKubh)}(h mempool_exith]j)}(h mempool_exith]h mempool_exit}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhKubj8)}(h(struct mempool *pool)h]j>)}(hstruct mempool *poolh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hmempoolh]hmempool}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsbc.mempool_exitasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hj(hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hpoolh]hpool}(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhKubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhKubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhKhjhhubj4)}(hhh]jM)}(h.exit a mempool initialized with mempool_init()h]h.exit a mempool initialized with mempool_init()}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chKhj\hhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhKubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjwjHjwjIjJjKuh1hhhhjuhNhNubj)}(hXS**Parameters** ``struct mempool *pool`` pointer to the memory pool which was initialized with mempool_init(). **Description** Free all reserved elements in **pool** and **pool** itself. This function only sleeps if the free_fn() function sleeps. May be called on a zeroed but uninitialized mempool (i.e. allocated with kzalloc()).h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chKhj{ubj)}(hhh]j)}(h_``struct mempool *pool`` pointer to the memory pool which was initialized with mempool_init(). h](j)}(h``struct mempool *pool``h]jS)}(hjh]hstruct mempool *pool}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chKhjubj)}(hhh]jM)}(hEpointer to the memory pool which was initialized with mempool_init().h]hEpointer to the memory pool which was initialized with mempool_init().}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubah}(h]h ]h"]h$]h&]uh1jhj{ubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chKhj{ubjM)}(hxFree all reserved elements in **pool** and **pool** itself. This function only sleeps if the free_fn() function sleeps.h](hFree all reserved elements in }(hjhhhNhNubj)}(h**pool**h]hpool}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh and }(hjhhhNhNubj)}(h**pool**h]hpool}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhE itself. This function only sleeps if the free_fn() function sleeps.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chKhj{ubjM)}(hTMay be called on a zeroed but uninitialized mempool (i.e. allocated with kzalloc()).h]hTMay be called on a zeroed but uninitialized mempool (i.e. allocated with kzalloc()).}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chKhj{ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjuhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hmempool_destroy (C function)c.mempool_destroyhNtauh1hhjuhhhNhNubh)}(hhh](h)}(h+void mempool_destroy (struct mempool *pool)h]h)}(h*void mempool_destroy(struct mempool *pool)h](j)}(hvoidh]hvoid}(hjThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjPhhhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chKubj)}(h h]h }(hjchhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjPhhhjbhKubh)}(hmempool_destroyh]j)}(hmempool_destroyh]hmempool_destroy}(hjuhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjqubah}(h]h ](jjeh"]h$]h&]jjuh1hhjPhhhjbhKubj8)}(h(struct mempool *pool)h]j>)}(hstruct mempool *poolh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hmempoolh]hmempool}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjwsbc.mempool_destroyasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hpoolh]hpool}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjPhhhjbhKubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjLhhhjbhKubah}(h]jGah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjbhKhjIhhubj4)}(hhh]jM)}(hdeallocate a memory poolh]hdeallocate a memory pool}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chKhjhhubah}(h]h ]h"]h$]h&]uh1j3hjIhhhjbhKubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj,jHj,jIjJjKuh1hhhhjuhNhNubj)}(h**Parameters** ``struct mempool *pool`` pointer to the memory pool which was allocated via mempool_create(). **Description** Free all reserved elements in **pool** and **pool** itself. This function only sleeps if the free_fn() function sleeps.h](jM)}(h**Parameters**h]j)}(hj6h]h Parameters}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj4ubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chKhj0ubj)}(hhh]j)}(h^``struct mempool *pool`` pointer to the memory pool which was allocated via mempool_create(). h](j)}(h``struct mempool *pool``h]jS)}(hjUh]hstruct mempool *pool}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjSubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chKhjOubj)}(hhh]jM)}(hDpointer to the memory pool which was allocated via mempool_create().h]hDpointer to the memory pool which was allocated via mempool_create().}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chKhjkubah}(h]h ]h"]h$]h&]uh1jhjOubeh}(h]h ]h"]h$]h&]uh1jhjjhKhjLubah}(h]h ]h"]h$]h&]uh1jhj0ubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chKhj0ubjM)}(hxFree all reserved elements in **pool** and **pool** itself. This function only sleeps if the free_fn() function sleeps.h](hFree all reserved elements in }(hjhhhNhNubj)}(h**pool**h]hpool}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh and }(hjhhhNhNubj)}(h**pool**h]hpool}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhE itself. This function only sleeps if the free_fn() function sleeps.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chKhj0ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjuhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hmempool_init (C function)c.mempool_inithNtauh1hhjuhhhNhNubh)}(hhh](h)}(hxint mempool_init (struct mempool *pool, int min_nr, mempool_alloc_t *alloc_fn, mempool_free_t *free_fn, void *pool_data)h]h)}(hwint mempool_init(struct mempool *pool, int min_nr, mempool_alloc_t *alloc_fn, mempool_free_t *free_fn, void *pool_data)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chMubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh)}(h mempool_inith]j)}(h mempool_inith]h mempool_init}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMubj8)}(hg(struct mempool *pool, int min_nr, mempool_alloc_t *alloc_fn, mempool_free_t *free_fn, void *pool_data)h](j>)}(hstruct mempool *poolh](j)}(hjJ,h]hstruct}(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3ubj)}(h h]h }(hjDhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3ubh)}(hhh]j)}(hmempoolh]hmempool}(hjUhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjWmodnameN classnameNjj)}j]j)}jjsbc.mempool_initasbuh1hhj3ubj)}(h h]h }(hjuhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3ubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj3ubj)}(hpoolh]hpool}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj/ubj>)}(h int min_nrh](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hmin_nrh]hmin_nr}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj/ubj>)}(hmempool_alloc_t *alloc_fnh](h)}(hhh]j)}(hmempool_alloc_th]hmempool_alloc_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jqc.mempool_initasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hj hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(halloc_fnh]halloc_fn}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj/ubj>)}(hmempool_free_t *free_fnh](h)}(hhh]j)}(hmempool_free_th]hmempool_free_t}(hj6hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj8modnameN classnameNjj)}j]jqc.mempool_initasbuh1hhj/ubj)}(h h]h }(hjThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/ubjr)}(hjuh]h*}(hjbhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj/ubj)}(hfree_fnh]hfree_fn}(hjohhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj/ubj>)}(hvoid *pool_datah](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(h pool_datah]h pool_data}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj/ubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]jM)}(hinitialize a memory poolh]hinitialize a memory pool}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chMhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjuhNhNubj)}(hXM**Parameters** ``struct mempool *pool`` pointer to the memory pool that should be initialized ``int min_nr`` the minimum number of elements guaranteed to be allocated for this pool. ``mempool_alloc_t *alloc_fn`` user-defined element-allocation function. ``mempool_free_t *free_fn`` user-defined element-freeing function. ``void *pool_data`` optional private data available to the user-defined functions. **Description** Like mempool_create(), but initializes the pool in (i.e. embedded in another structure). **Return** ``0`` on success, negative error code otherwise.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chM!hjubj)}(hhh](j)}(hO``struct mempool *pool`` pointer to the memory pool that should be initialized h](j)}(h``struct mempool *pool``h]jS)}(hjh]hstruct mempool *pool}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chMhjubj)}(hhh]jM)}(h5pointer to the memory pool that should be initializedh]h5pointer to the memory pool that should be initialized}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj1hMhj2ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj1hMhjubj)}(hX``int min_nr`` the minimum number of elements guaranteed to be allocated for this pool. h](j)}(h``int min_nr``h]jS)}(hjUh]h int min_nr}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjSubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chM hjOubj)}(hhh]jM)}(hHthe minimum number of elements guaranteed to be allocated for this pool.h]hHthe minimum number of elements guaranteed to be allocated for this pool.}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chMhjkubah}(h]h ]h"]h$]h&]uh1jhjOubeh}(h]h ]h"]h$]h&]uh1jhjjhM hjubj)}(hH``mempool_alloc_t *alloc_fn`` user-defined element-allocation function. h](j)}(h``mempool_alloc_t *alloc_fn``h]jS)}(hjh]hmempool_alloc_t *alloc_fn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chM!hjubj)}(hhh]jM)}(h)user-defined element-allocation function.h]h)user-defined element-allocation function.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM!hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM!hjubj)}(hC``mempool_free_t *free_fn`` user-defined element-freeing function. h](j)}(h``mempool_free_t *free_fn``h]jS)}(hjh]hmempool_free_t *free_fn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chM"hjubj)}(hhh]jM)}(h&user-defined element-freeing function.h]h&user-defined element-freeing function.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM"hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM"hjubj)}(hS``void *pool_data`` optional private data available to the user-defined functions. h](j)}(h``void *pool_data``h]jS)}(hjh]hvoid *pool_data}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chM#hjubj)}(hhh]jM)}(h>optional private data available to the user-defined functions.h]h>optional private data available to the user-defined functions.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM#hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM#hjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hj<h]h Description}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj:ubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chM%hjubjM)}(hXLike mempool_create(), but initializes the pool in (i.e. embedded in another structure).h]hXLike mempool_create(), but initializes the pool in (i.e. embedded in another structure).}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chM$hjubjM)}(h **Return**h]j)}(hjch]hReturn}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1jhjaubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chM'hjubjM)}(h0``0`` on success, negative error code otherwise.h](jS)}(h``0``h]h0}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjyubh+ on success, negative error code otherwise.}(hjyhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chM(hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjuhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h mempool_create_node (C function)c.mempool_create_nodehNtauh1hhjuhhhNhNubh)}(hhh](h)}(hstruct mempool * mempool_create_node (int min_nr, mempool_alloc_t *alloc_fn, mempool_free_t *free_fn, void *pool_data, gfp_t gfp_mask, int node_id)h]h)}(hstruct mempool *mempool_create_node(int min_nr, mempool_alloc_t *alloc_fn, mempool_free_t *free_fn, void *pool_data, gfp_t gfp_mask, int node_id)h](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chM5ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM5ubh)}(hhh]j)}(hmempoolh]hmempool}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jmempool_create_nodesbc.mempool_create_nodeasbuh1hhjhhhjhM5ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM5ubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjhhhjhM5ubh)}(hmempool_create_nodeh]j)}(hjh]hmempool_create_node}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhM5ubj8)}(hn(int min_nr, mempool_alloc_t *alloc_fn, mempool_free_t *free_fn, void *pool_data, gfp_t gfp_mask, int node_id)h](j>)}(h int min_nrh](j)}(hinth]hint}(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,ubj)}(h h]h }(hj>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,ubj)}(hmin_nrh]hmin_nr}(hjLhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj(ubj>)}(hmempool_alloc_t *alloc_fnh](h)}(hhh]j)}(hmempool_alloc_th]hmempool_alloc_t}(hjhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjjmodnameN classnameNjj)}j]jc.mempool_create_nodeasbuh1hhjaubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjaubj)}(halloc_fnh]halloc_fn}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj(ubj>)}(hmempool_free_t *free_fnh](h)}(hhh]j)}(hmempool_free_th]hmempool_free_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.mempool_create_nodeasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hfree_fnh]hfree_fn}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj(ubj>)}(hvoid *pool_datah](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubjr)}(hjuh]h*}(hj+hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj ubj)}(h pool_datah]h pool_data}(hj8hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj(ubj>)}(hgfp_t gfp_maskh](h)}(hhh]j)}(hgfp_th]hgfp_t}(hjThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjQubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjVmodnameN classnameNjj)}j]jc.mempool_create_nodeasbuh1hhjMubj)}(h h]h }(hjrhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjMubj)}(hgfp_maskh]hgfp_mask}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjMubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj(ubj>)}(h int node_idh](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hnode_idh]hnode_id}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj(ubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhM5ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhM5ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhM5hjhhubj4)}(hhh]jM)}(hcreate a memory poolh]hcreate a memory pool}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chM5hjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhM5ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjuhNhNubj)}(hXJ**Parameters** ``int min_nr`` the minimum number of elements guaranteed to be allocated for this pool. ``mempool_alloc_t *alloc_fn`` user-defined element-allocation function. ``mempool_free_t *free_fn`` user-defined element-freeing function. ``void *pool_data`` optional private data available to the user-defined functions. ``gfp_t gfp_mask`` memory allocation flags ``int node_id`` numa node to allocate on **Description** this function creates and allocates a guaranteed size, preallocated memory pool. The pool can be used from the mempool_alloc() and mempool_free() functions. This function might sleep. Both the alloc_fn() and the free_fn() functions might sleep - as long as the mempool_alloc() function is not called from IRQ contexts. **Return** pointer to the created memory pool object or ``NULL`` on error.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chM9hjubj)}(hhh](j)}(hX``int min_nr`` the minimum number of elements guaranteed to be allocated for this pool. h](j)}(h``int min_nr``h]jS)}(hj h]h int min_nr}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chM7hjubj)}(hhh]jM)}(hHthe minimum number of elements guaranteed to be allocated for this pool.h]hHthe minimum number of elements guaranteed to be allocated for this pool.}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chM6hj6ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj5hM7hjubj)}(hH``mempool_alloc_t *alloc_fn`` user-defined element-allocation function. h](j)}(h``mempool_alloc_t *alloc_fn``h]jS)}(hjZh]hmempool_alloc_t *alloc_fn}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjXubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chM8hjTubj)}(hhh]jM)}(h)user-defined element-allocation function.h]h)user-defined element-allocation function.}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjohM8hjpubah}(h]h ]h"]h$]h&]uh1jhjTubeh}(h]h ]h"]h$]h&]uh1jhjohM8hjubj)}(hC``mempool_free_t *free_fn`` user-defined element-freeing function. h](j)}(h``mempool_free_t *free_fn``h]jS)}(hjh]hmempool_free_t *free_fn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chM9hjubj)}(hhh]jM)}(h&user-defined element-freeing function.h]h&user-defined element-freeing function.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM9hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM9hjubj)}(hS``void *pool_data`` optional private data available to the user-defined functions. h](j)}(h``void *pool_data``h]jS)}(hjh]hvoid *pool_data}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chM:hjubj)}(hhh]jM)}(h>optional private data available to the user-defined functions.h]h>optional private data available to the user-defined functions.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM:hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM:hjubj)}(h+``gfp_t gfp_mask`` memory allocation flags h](j)}(h``gfp_t gfp_mask``h]jS)}(hjh]hgfp_t gfp_mask}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chM;hjubj)}(hhh]jM)}(hmemory allocation flagsh]hmemory allocation flags}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM;hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM;hjubj)}(h)``int node_id`` numa node to allocate on h](j)}(h``int node_id``h]jS)}(hj>h]h int node_id}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj<ubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chM<hj8ubj)}(hhh]jM)}(hnuma node to allocate onh]hnuma node to allocate on}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjShM<hjTubah}(h]h ]h"]h$]h&]uh1jhj8ubeh}(h]h ]h"]h$]h&]uh1jhjShM<hjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjyh]h Description}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjwubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chM>hjubjM)}(hX>this function creates and allocates a guaranteed size, preallocated memory pool. The pool can be used from the mempool_alloc() and mempool_free() functions. This function might sleep. Both the alloc_fn() and the free_fn() functions might sleep - as long as the mempool_alloc() function is not called from IRQ contexts.h]hX>this function creates and allocates a guaranteed size, preallocated memory pool. The pool can be used from the mempool_alloc() and mempool_free() functions. This function might sleep. Both the alloc_fn() and the free_fn() functions might sleep - as long as the mempool_alloc() function is not called from IRQ contexts.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chM=hjubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chMChjubjM)}(h?pointer to the created memory pool object or ``NULL`` on error.h](h-pointer to the created memory pool object or }(hjhhhNhNubjS)}(h``NULL``h]hNULL}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubh on error.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chMDhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjuhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hmempool_resize (C function)c.mempool_resizehNtauh1hhjuhhhNhNubh)}(hhh](h)}(h9int mempool_resize (struct mempool *pool, int new_min_nr)h]h)}(h8int mempool_resize(struct mempool *pool, int new_min_nr)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chM[ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM[ubh)}(hmempool_resizeh]j)}(hmempool_resizeh]hmempool_resize}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhM[ubj8)}(h&(struct mempool *pool, int new_min_nr)h](j>)}(hstruct mempool *poolh](j)}(hjJ,h]hstruct}(hj4hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubj)}(h h]h }(hjAhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubh)}(hhh]j)}(hmempoolh]hmempool}(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjOubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjTmodnameN classnameNjj)}j]j)}jjsbc.mempool_resizeasbuh1hhj0ubj)}(h h]h }(hjrhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj0ubj)}(hpoolh]hpool}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj,ubj>)}(hint new_min_nrh](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h new_min_nrh]h new_min_nr}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj,ubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhM[ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhM[ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhM[hjhhubj4)}(hhh]jM)}(hresize an existing memory poolh]hresize an existing memory pool}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chM[hjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhM[ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjuhNhNubj)}(hX**Parameters** ``struct mempool *pool`` pointer to the memory pool which was allocated via mempool_create(). ``int new_min_nr`` the new minimum number of elements guaranteed to be allocated for this pool. **Description** This function shrinks/grows the pool. In the case of growing, it cannot be guaranteed that the pool will be grown to the new size immediately, but new mempool_free() calls will refill it. This function may sleep. Note, the caller must guarantee that no mempool_destroy is called while this function is running. mempool_alloc() & mempool_free() might be called (eg. from IRQ contexts) while this function executes. **Return** ``0`` on success, negative error code otherwise.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chM_hjubj)}(hhh](j)}(h^``struct mempool *pool`` pointer to the memory pool which was allocated via mempool_create(). h](j)}(h``struct mempool *pool``h]jS)}(hj-h]hstruct mempool *pool}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj+ubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chM]hj'ubj)}(hhh]jM)}(hDpointer to the memory pool which was allocated via mempool_create().h]hDpointer to the memory pool which was allocated via mempool_create().}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chM\hjCubah}(h]h ]h"]h$]h&]uh1jhj'ubeh}(h]h ]h"]h$]h&]uh1jhjBhM]hj$ubj)}(h```int new_min_nr`` the new minimum number of elements guaranteed to be allocated for this pool. h](j)}(h``int new_min_nr``h]jS)}(hjgh]hint new_min_nr}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjeubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chM_hjaubj)}(hhh]jM)}(hLthe new minimum number of elements guaranteed to be allocated for this pool.h]hLthe new minimum number of elements guaranteed to be allocated for this pool.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chM^hj}ubah}(h]h ]h"]h$]h&]uh1jhjaubeh}(h]h ]h"]h$]h&]uh1jhj|hM_hj$ubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chMahjubjM)}(hThis function shrinks/grows the pool. In the case of growing, it cannot be guaranteed that the pool will be grown to the new size immediately, but new mempool_free() calls will refill it. This function may sleep.h]hThis function shrinks/grows the pool. In the case of growing, it cannot be guaranteed that the pool will be grown to the new size immediately, but new mempool_free() calls will refill it. This function may sleep.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chM`hjubjM)}(hNote, the caller must guarantee that no mempool_destroy is called while this function is running. mempool_alloc() & mempool_free() might be called (eg. from IRQ contexts) while this function executes.h]hNote, the caller must guarantee that no mempool_destroy is called while this function is running. mempool_alloc() & mempool_free() might be called (eg. from IRQ contexts) while this function executes.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chMehjubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chMihjubjM)}(h0``0`` on success, negative error code otherwise.h](jS)}(h``0``h]h0}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubh+ on success, negative error code otherwise.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chMjhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjuhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hmempool_alloc_bulk (C function)c.mempool_alloc_bulkhNtauh1hhjuhhhNhNubh)}(hhh](h)}(hOint mempool_alloc_bulk (struct mempool *pool, void **elems, unsigned int count)h]h)}(hNint mempool_alloc_bulk(struct mempool *pool, void **elems, unsigned int count)h](j)}(hinth]hint}(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(hhhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chMubj)}(h h]h }(hj;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(hhhj:hMubh)}(hmempool_alloc_bulkh]j)}(hmempool_alloc_bulkh]hmempool_alloc_bulk}(hjMhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIubah}(h]h ](jjeh"]h$]h&]jjuh1hhj(hhhj:hMubj8)}(h8(struct mempool *pool, void **elems, unsigned int count)h](j>)}(hstruct mempool *poolh](j)}(hjJ,h]hstruct}(hjihhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubj)}(h h]h }(hjvhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubh)}(hhh]j)}(hmempoolh]hmempool}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjOsbc.mempool_alloc_bulkasbuh1hhjeubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjeubj)}(hpoolh]hpool}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjaubj>)}(h void **elemsh](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(helemsh]helems}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjaubj>)}(hunsigned int counth](j)}(hunsignedh]hunsigned}(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubj)}(h h]h }(hj8hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubj)}(hinth]hint}(hjFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubj)}(h h]h }(hjThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubj)}(hcounth]hcount}(hjbhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjaubeh}(h]h ]h"]h$]h&]jjuh1j7hj(hhhj:hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj$hhhj:hMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj:hMhj!hhubj4)}(hhh]jM)}(h-allocate multiple elements from a memory poolh]h-allocate multiple elements from a memory pool}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chMhjhhubah}(h]h ]h"]h$]h&]uh1j3hj!hhhj:hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjuhNhNubj)}(hXN**Parameters** ``struct mempool *pool`` pointer to the memory pool ``void **elems`` partially or fully populated elements array ``unsigned int count`` number of entries in **elem** that need to be allocated **Description** Allocate **count** elements into **elems**. This is done by first calling into the alloc_fn supplied at pool initialization time, and dipping into the reserved pool when alloc_fn fails to allocate an element. On return all **count** elements in **elems** will be populated. **Return** Always 0. If it wasn't for %$#^$ alloc tags, it would return void.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chMhjubj)}(hhh](j)}(h4``struct mempool *pool`` pointer to the memory pool h](j)}(h``struct mempool *pool``h]jS)}(hjh]hstruct mempool *pool}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chMhjubj)}(hhh]jM)}(hpointer to the memory poolh]hpointer to the memory pool}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h=``void **elems`` partially or fully populated elements array h](j)}(h``void **elems``h]jS)}(hjh]h void **elems}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chMhjubj)}(hhh]jM)}(h+partially or fully populated elements arrayh]h+partially or fully populated elements array}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(hO``unsigned int count`` number of entries in **elem** that need to be allocated h](j)}(h``unsigned int count``h]jS)}(hj?h]hunsigned int count}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj=ubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chMhj9ubj)}(hhh]jM)}(h7number of entries in **elem** that need to be allocatedh](hnumber of entries in }(hjXhhhNhNubj)}(h**elem**h]helem}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjXubh that need to be allocated}(hjXhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhjThMhjUubah}(h]h ]h"]h$]h&]uh1jhj9ubeh}(h]h ]h"]h$]h&]uh1jhjThMhjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chMhjubjM)}(hAllocate **count** elements into **elems**. This is done by first calling into the alloc_fn supplied at pool initialization time, and dipping into the reserved pool when alloc_fn fails to allocate an element.h](h Allocate }(hjhhhNhNubj)}(h **count**h]hcount}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh elements into }(hjhhhNhNubj)}(h **elems**h]helems}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh. This is done by first calling into the alloc_fn supplied at pool initialization time, and dipping into the reserved pool when alloc_fn fails to allocate an element.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chMhjubjM)}(h@On return all **count** elements in **elems** will be populated.h](hOn return all }(hjhhhNhNubj)}(h **count**h]hcount}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh elements in }(hjhhhNhNubj)}(h **elems**h]helems}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh will be populated.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chMhjubjM)}(h **Return**h]j)}(hj h]hReturn}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chMhjubjM)}(hCAlways 0. If it wasn't for %$#^$ alloc tags, it would return void.h]hEAlways 0. If it wasn’t for %$#^$ alloc tags, it would return void.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjuhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hmempool_alloc (C function)c.mempool_allochNtauh1hhjuhhhNhNubh)}(hhh](h)}(h;void * mempool_alloc (struct mempool *pool, gfp_t gfp_mask)h]h)}(h9void *mempool_alloc(struct mempool *pool, gfp_t gfp_mask)h](j)}(hvoidh]hvoid}(hjOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjKhhhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chMubj)}(h h]h }(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjKhhhj]hMubjr)}(hjuh]h*}(hjlhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjKhhhj]hMubh)}(h mempool_alloch]j)}(h mempool_alloch]h mempool_alloc}(hj}hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyubah}(h]h ](jjeh"]h$]h&]jjuh1hhjKhhhj]hMubj8)}(h&(struct mempool *pool, gfp_t gfp_mask)h](j>)}(hstruct mempool *poolh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hmempoolh]hmempool}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsbc.mempool_allocasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hpoolh]hpool}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hgfp_t gfp_maskh](h)}(hhh]j)}(hgfp_th]hgfp_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.mempool_allocasbuh1hhjubj)}(h h]h }(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hgfp_maskh]hgfp_mask}(hj:hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjKhhhj]hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjGhhhj]hMubah}(h]jBah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj]hMhjDhhubj4)}(hhh]jM)}(h&allocate an element from a memory poolh]h&allocate an element from a memory pool}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chMhjahhubah}(h]h ]h"]h$]h&]uh1j3hjDhhhj]hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj|jHj|jIjJjKuh1hhhhjuhNhNubj)}(hX**Parameters** ``struct mempool *pool`` pointer to the memory pool ``gfp_t gfp_mask`` GFP_* flags. ``__GFP_ZERO`` is not supported. **Description** Allocate an element from **pool**. This is done by first calling into the alloc_fn supplied at pool initialization time, and dipping into the reserved pool when alloc_fn fails to allocate an element. This function only sleeps if the alloc_fn callback sleeps, or when waiting for elements to become available in the pool. **Return** pointer to the allocated element or ``NULL`` when failing to allocate an element. Allocation failure can only happen when **gfp_mask** does not include ``__GFP_DIRECT_RECLAIM``.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chM#hjubj)}(hhh](j)}(h4``struct mempool *pool`` pointer to the memory pool h](j)}(h``struct mempool *pool``h]jS)}(hjh]hstruct mempool *pool}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chM hjubj)}(hhh]jM)}(hpointer to the memory poolh]hpointer to the memory pool}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hjubj)}(hB``gfp_t gfp_mask`` GFP_* flags. ``__GFP_ZERO`` is not supported. h](j)}(h``gfp_t gfp_mask``h]jS)}(hjh]hgfp_t gfp_mask}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chM!hjubj)}(hhh]jM)}(h.GFP_* flags. ``__GFP_ZERO`` is not supported.h](hGFP_* flags. }(hjhhhNhNubjS)}(h``__GFP_ZERO``h]h __GFP_ZERO}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubh is not supported.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhjhM!hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM!hjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hj+h]h Description}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj)ubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chM#hjubjM)}(hAllocate an element from **pool**. This is done by first calling into the alloc_fn supplied at pool initialization time, and dipping into the reserved pool when alloc_fn fails to allocate an element.h](hAllocate an element from }(hjAhhhNhNubj)}(h**pool**h]hpool}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjAubh. This is done by first calling into the alloc_fn supplied at pool initialization time, and dipping into the reserved pool when alloc_fn fails to allocate an element.}(hjAhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chM"hjubjM)}(hxThis function only sleeps if the alloc_fn callback sleeps, or when waiting for elements to become available in the pool.h]hxThis function only sleeps if the alloc_fn callback sleeps, or when waiting for elements to become available in the pool.}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chM&hjubjM)}(h **Return**h]j)}(hjsh]hReturn}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjqubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chM)hjubjM)}(hpointer to the allocated element or ``NULL`` when failing to allocate an element. Allocation failure can only happen when **gfp_mask** does not include ``__GFP_DIRECT_RECLAIM``.h](h$pointer to the allocated element or }(hjhhhNhNubjS)}(h``NULL``h]hNULL}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubhO when failing to allocate an element. Allocation failure can only happen when }(hjhhhNhNubj)}(h **gfp_mask**h]hgfp_mask}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh does not include }(hjhhhNhNubjS)}(h``__GFP_DIRECT_RECLAIM``h]h__GFP_DIRECT_RECLAIM}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chM*hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjuhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h'mempool_alloc_preallocated (C function)c.mempool_alloc_preallocatedhNtauh1hhjuhhhNhNubh)}(hhh](h)}(h8void * mempool_alloc_preallocated (struct mempool *pool)h]h)}(h6void *mempool_alloc_preallocated(struct mempool *pool)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chMWubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMWubjr)}(hjuh]h*}(hj hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjhhhjhMWubh)}(hmempool_alloc_preallocatedh]j)}(hmempool_alloc_preallocatedh]hmempool_alloc_preallocated}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMWubj8)}(h(struct mempool *pool)h]j>)}(hstruct mempool *poolh](j)}(hjJ,h]hstruct}(hj8hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4ubj)}(h h]h }(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4ubh)}(hhh]j)}(hmempoolh]hmempool}(hjVhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjXmodnameN classnameNjj)}j]j)}jjsbc.mempool_alloc_preallocatedasbuh1hhj4ubj)}(h h]h }(hjvhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4ubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj4ubj)}(hpoolh]hpool}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj0ubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMWubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMWubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMWhjhhubj4)}(hhh]jM)}(hIallocate an element from preallocated elements belonging to a memory poolh]hIallocate an element from preallocated elements belonging to a memory pool}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chMWhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMWubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjuhNhNubj)}(hX**Parameters** ``struct mempool *pool`` pointer to the memory pool **Description** This function is similar to mempool_alloc(), but it only attempts allocating an element from the preallocated elements. It only takes a single spinlock_t and immediately returns if no preallocated elements are available. **Return** pointer to the allocated element or ``NULL`` if no elements are available.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chM[hjubj)}(hhh]j)}(h4``struct mempool *pool`` pointer to the memory pool h](j)}(h``struct mempool *pool``h]jS)}(hjh]hstruct mempool *pool}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chMYhjubj)}(hhh]jM)}(hpointer to the memory poolh]hpointer to the memory pool}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMYhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMYhjubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hj7h]h Description}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj5ubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chM[hjubjM)}(hThis function is similar to mempool_alloc(), but it only attempts allocating an element from the preallocated elements. It only takes a single spinlock_t and immediately returns if no preallocated elements are available.h]hThis function is similar to mempool_alloc(), but it only attempts allocating an element from the preallocated elements. It only takes a single spinlock_t and immediately returns if no preallocated elements are available.}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chMZhjubjM)}(h **Return**h]j)}(hj^h]hReturn}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj\ubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chM^hjubjM)}(hJpointer to the allocated element or ``NULL`` if no elements are available.h](h$pointer to the allocated element or }(hjthhhNhNubjS)}(h``NULL``h]hNULL}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjtubh if no elements are available.}(hjthhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chM_hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjuhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hmempool_free_bulk (C function)c.mempool_free_bulkhNtauh1hhjuhhhNhNubh)}(hhh](h)}(hWunsigned int mempool_free_bulk (struct mempool *pool, void **elems, unsigned int count)h]h)}(hVunsigned int mempool_free_bulk(struct mempool *pool, void **elems, unsigned int count)h](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chMlubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMlubj)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMlubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMlubh)}(hmempool_free_bulkh]j)}(hmempool_free_bulkh]hmempool_free_bulk}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMlubj8)}(h8(struct mempool *pool, void **elems, unsigned int count)h](j>)}(hstruct mempool *poolh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubh)}(hhh]j)}(hmempoolh]hmempool}(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj.modnameN classnameNjj)}j]j)}jjsbc.mempool_free_bulkasbuh1hhj ubj)}(h h]h }(hjLhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubjr)}(hjuh]h*}(hjZhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj ubj)}(hpoolh]hpool}(hjghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(h void **elemsh](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|ubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj|ubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj|ubj)}(helemsh]helems}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hunsigned int counth](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hcounth]hcount}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMlubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMlubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMlhjhhubj4)}(hhh]jM)}(hreturn elements to a mempoolh]hreturn elements to a mempool}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chMlhj.hhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMlubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjIjHjIjIjJjKuh1hhhhjuhNhNubj)}(hXS**Parameters** ``struct mempool *pool`` pointer to the memory pool ``void **elems`` elements to return ``unsigned int count`` number of elements to return **Description** Returns a number of elements from the start of **elem** to **pool** if **pool** needs replenishing and sets their slots in **elem** to NULL. Other elements are left in **elem**. **Return** number of elements transferred to **pool**. Elements are always transferred from the beginning of **elem**, so the return value can be used as an offset into **elem** for the freeing the remaining elements in the caller.h](jM)}(h**Parameters**h]j)}(hjSh]h Parameters}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjQubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chMphjMubj)}(hhh](j)}(h4``struct mempool *pool`` pointer to the memory pool h](j)}(h``struct mempool *pool``h]jS)}(hjrh]hstruct mempool *pool}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjpubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chMmhjlubj)}(hhh]jM)}(hpointer to the memory poolh]hpointer to the memory pool}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMmhjubah}(h]h ]h"]h$]h&]uh1jhjlubeh}(h]h ]h"]h$]h&]uh1jhjhMmhjiubj)}(h$``void **elems`` elements to return h](j)}(h``void **elems``h]jS)}(hjh]h void **elems}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chMnhjubj)}(hhh]jM)}(helements to returnh]helements to return}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMnhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMnhjiubj)}(h4``unsigned int count`` number of elements to return h](j)}(h``unsigned int count``h]jS)}(hjh]hunsigned int count}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chMohjubj)}(hhh]jM)}(hnumber of elements to returnh]hnumber of elements to return}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMohjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMohjiubeh}(h]h ]h"]h$]h&]uh1jhjMubjM)}(h**Description**h]j)}(hjh]h Description}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chMqhjMubjM)}(hReturns a number of elements from the start of **elem** to **pool** if **pool** needs replenishing and sets their slots in **elem** to NULL. Other elements are left in **elem**.h](h/Returns a number of elements from the start of }(hj5hhhNhNubj)}(h**elem**h]helem}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj5ubh to }(hj5hhhNhNubj)}(h**pool**h]hpool}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj5ubh if }(hj5hhhNhNubj)}(h**pool**h]hpool}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1jhj5ubh, needs replenishing and sets their slots in }(hj5hhhNhNubj)}(h**elem**h]helem}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1jhj5ubh& to NULL. Other elements are left in }(hj5hhhNhNubj)}(h**elem**h]helem}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj5ubh.}(hj5hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chMphjMubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chMthjMubjM)}(hnumber of elements transferred to **pool**. Elements are always transferred from the beginning of **elem**, so the return value can be used as an offset into **elem** for the freeing the remaining elements in the caller.h](h"number of elements transferred to }(hjhhhNhNubj)}(h**pool**h]hpool}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh9. Elements are always transferred from the beginning of }(hjhhhNhNubj)}(h**elem**h]helem}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh4, so the return value can be used as an offset into }(hjhhhNhNubj)}(h**elem**h]helem}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh6 for the freeing the remaining elements in the caller.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chMuhjMubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjuhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hmempool_free (C function)c.mempool_freehNtauh1hhjuhhhNhNubh)}(hhh](h)}(h7void mempool_free (void *element, struct mempool *pool)h]h)}(h6void mempool_free(void *element, struct mempool *pool)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chMubj)}(h h]h }(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhj)hMubh)}(h mempool_freeh]j)}(h mempool_freeh]h mempool_free}(hj<hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj8ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhj)hMubj8)}(h%(void *element, struct mempool *pool)h](j>)}(h void *elementh](j)}(hvoidh]hvoid}(hjXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjTubj)}(h h]h }(hjfhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjTubjr)}(hjuh]h*}(hjthhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjTubj)}(helementh]helement}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjTubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjPubj>)}(hstruct mempool *poolh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hmempoolh]hmempool}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jj>sbc.mempool_freeasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hpoolh]hpool}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjPubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhj)hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhj)hMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj)hMhjhhubj4)}(hhh]jM)}(hreturn an element to the pool.h]hreturn an element to the pool.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chMhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhj)hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj5jHj5jIjJjKuh1hhhhjuhNhNubj)}(hX)**Parameters** ``void *element`` element to return ``struct mempool *pool`` pointer to the memory pool **Description** Returns **element** to **pool** if it needs replenishing, else frees it using the free_fn callback in **pool**. This function only sleeps if the free_fn callback sleeps.h](jM)}(h**Parameters**h]j)}(hj?h]h Parameters}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj=ubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chMhj9ubj)}(hhh](j)}(h$``void *element`` element to return h](j)}(h``void *element``h]jS)}(hj^h]h void *element}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj\ubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chMhjXubj)}(hhh]jM)}(helement to returnh]helement to return}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjshMhjtubah}(h]h ]h"]h$]h&]uh1jhjXubeh}(h]h ]h"]h$]h&]uh1jhjshMhjUubj)}(h4``struct mempool *pool`` pointer to the memory pool h](j)}(h``struct mempool *pool``h]jS)}(hjh]hstruct mempool *pool}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chMhjubj)}(hhh]jM)}(hpointer to the memory poolh]hpointer to the memory pool}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjUubeh}(h]h ]h"]h$]h&]uh1jhj9ubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chMhj9ubjM)}(hoReturns **element** to **pool** if it needs replenishing, else frees it using the free_fn callback in **pool**.h](hReturns }(hjhhhNhNubj)}(h **element**h]helement}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh to }(hjhhhNhNubj)}(h**pool**h]hpool}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhG if it needs replenishing, else frees it using the free_fn callback in }(hjhhhNhNubj)}(h**pool**h]hpool}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chMhj9ubjM)}(h9This function only sleeps if the free_fn callback sleeps.h]h9This function only sleeps if the free_fn callback sleeps.}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:104: ./mm/mempool.chMhj9ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjuhhhNhNubeh}(h] memory-poolsah ]h"] memory poolsah$]h&]uh1hhhhhhhhKfubh)}(hhh](h)}(h More Memory Management Functionsh]h More Memory Management Functions}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjKhhhhhKlubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h"zap_special_vma_range (C function)c.zap_special_vma_rangehNtauh1hhjKhhhNhNubh)}(hhh](h)}(hbvoid zap_special_vma_range (struct vm_area_struct *vma, unsigned long address, unsigned long size)h]h)}(havoid zap_special_vma_range(struct vm_area_struct *vma, unsigned long address, unsigned long size)h](j)}(hvoidh]hvoid}(hjuhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjqhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM* ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjqhhhjhM* ubh)}(hzap_special_vma_rangeh]j)}(hzap_special_vma_rangeh]hzap_special_vma_range}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjqhhhjhM* ubj8)}(hG(struct vm_area_struct *vma, unsigned long address, unsigned long size)h](j>)}(hstruct vm_area_struct *vmah](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hvm_area_structh]hvm_area_struct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsbc.zap_special_vma_rangeasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hvmah]hvma}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hunsigned long addressh](j)}(hunsignedh]hunsigned}(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h h]h }(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(hlongh]hlong}(hj@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h h]h }(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(haddressh]haddress}(hj\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hunsigned long sizeh](j)}(hunsignedh]hunsigned}(hjuhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjqubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjqubj)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjqubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjqubj)}(hsizeh]hsize}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjqubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjqhhhjhM* ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjmhhhjhM* ubah}(h]jhah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhM* hjjhhubj4)}(hhh]jM)}(h;zap all page table entries in a VMA which is not mm-managedh]h;zap all page table entries in a VMA which is not mm-managed}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM* hjhhubah}(h]h ]h"]h$]h&]uh1j3hjjhhhjhM* ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hXT**Parameters** ``struct vm_area_struct *vma`` the vma covering the range to zap ``unsigned long address`` starting address of the range to zap ``unsigned long size`` number of bytes to zap **Description** This function does nothing when the provided address range is not fully contained in **vma**, or when **vma** is mm-managed.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM. hjubj)}(hhh](j)}(hA``struct vm_area_struct *vma`` the vma covering the range to zap h](j)}(h``struct vm_area_struct *vma``h]jS)}(hjh]hstruct vm_area_struct *vma}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM, hjubj)}(hhh]jM)}(h!the vma covering the range to zaph]h!the vma covering the range to zap}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj-hM, hj.ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj-hM, hjubj)}(h?``unsigned long address`` starting address of the range to zap h](j)}(h``unsigned long address``h]jS)}(hjQh]hunsigned long address}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjOubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM- hjKubj)}(hhh]jM)}(h$starting address of the range to zaph]h$starting address of the range to zap}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjfhM- hjgubah}(h]h ]h"]h$]h&]uh1jhjKubeh}(h]h ]h"]h$]h&]uh1jhjfhM- hjubj)}(h.``unsigned long size`` number of bytes to zap h](j)}(h``unsigned long size``h]jS)}(hjh]hunsigned long size}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM. hjubj)}(hhh]jM)}(hnumber of bytes to zaph]hnumber of bytes to zap}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM. hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM. hjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM0 hjubjM)}(h|This function does nothing when the provided address range is not fully contained in **vma**, or when **vma** is mm-managed.h](hUThis function does nothing when the provided address range is not fully contained in }(hjhhhNhNubj)}(h**vma**h]hvma}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh , or when }(hjhhhNhNubj)}(h**vma**h]hvma}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh is mm-managed.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM/ hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hvm_insert_pages (C function)c.vm_insert_pageshNtauh1hhjKhhhNhNubh)}(hhh](h)}(hmint vm_insert_pages (struct vm_area_struct *vma, unsigned long addr, struct page **pages, unsigned long *num)h]h)}(hlint vm_insert_pages(struct vm_area_struct *vma, unsigned long addr, struct page **pages, unsigned long *num)h](j)}(hinth]hint}(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*hhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM ubj)}(h h]h }(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*hhhj<hM ubh)}(hvm_insert_pagesh]j)}(hvm_insert_pagesh]hvm_insert_pages}(hjOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjKubah}(h]h ](jjeh"]h$]h&]jjuh1hhj*hhhj<hM ubj8)}(hY(struct vm_area_struct *vma, unsigned long addr, struct page **pages, unsigned long *num)h](j>)}(hstruct vm_area_struct *vmah](j)}(hjJ,h]hstruct}(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubj)}(h h]h }(hjxhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubh)}(hhh]j)}(hvm_area_structh]hvm_area_struct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjQsbc.vm_insert_pagesasbuh1hhjgubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjgubj)}(hvmah]hvma}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjcubj>)}(hunsigned long addrh](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(haddrh]haddr}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjcubj>)}(hstruct page **pagesh](j)}(hjJ,h]hstruct}(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*ubj)}(h h]h }(hj;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*ubh)}(hhh]j)}(hpageh]hpage}(hjLhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjNmodnameN classnameNjj)}j]jc.vm_insert_pagesasbuh1hhj*ubj)}(h h]h }(hjjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*ubjr)}(hjuh]h*}(hjxhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj*ubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj*ubj)}(hpagesh]hpages}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjcubj>)}(hunsigned long *numh](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hnumh]hnum}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjcubeh}(h]h ]h"]h$]h&]jjuh1j7hj*hhhj<hM ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj&hhhj<hM ubah}(h]j!ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj<hM hj#hhubj4)}(hhh]jM)}(h;insert multiple pages into user vma, batching the pmd lock.h]Dh;insert multiple pages into user vma, batching the pmd lock.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hjhhubah}(h]h ]h"]h$]h&]uh1j3hj#hhhj<hM ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj2jHj2jIjJjKuh1hhhhjKhNhNubj)}(hXP**Parameters** ``struct vm_area_struct *vma`` user vma to map to ``unsigned long addr`` target start user address of these pages ``struct page **pages`` source kernel pages ``unsigned long *num`` in: number of pages to map. out: number of pages that were *not* mapped. (0 means all pages were successfully mapped). **Description** Preferred over vm_insert_page() when inserting multiple pages. In case of error, we may have mapped a subset of the provided pages. It is the caller's responsibility to account for this case. The same restrictions apply as in vm_insert_page().h](jM)}(h**Parameters**h]j)}(hj<h]h Parameters}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj:ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hj6ubj)}(hhh](j)}(h2``struct vm_area_struct *vma`` user vma to map to h](j)}(h``struct vm_area_struct *vma``h]jS)}(hj[h]hstruct vm_area_struct *vma}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjYubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hjUubj)}(hhh]jM)}(huser vma to map toh]huser vma to map to}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjphM hjqubah}(h]h ]h"]h$]h&]uh1jhjUubeh}(h]h ]h"]h$]h&]uh1jhjphM hjRubj)}(h@``unsigned long addr`` target start user address of these pages h](j)}(h``unsigned long addr``h]jS)}(hjh]hunsigned long addr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hjubj)}(hhh]jM)}(h(target start user address of these pagesh]h(target start user address of these pages}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hjRubj)}(h,``struct page **pages`` source kernel pages h](j)}(h``struct page **pages``h]jS)}(hjh]hstruct page **pages}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hjubj)}(hhh]jM)}(hsource kernel pagesh]hsource kernel pages}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hjRubj)}(h``unsigned long *num`` in: number of pages to map. out: number of pages that were *not* mapped. (0 means all pages were successfully mapped). h](j)}(h``unsigned long *num``h]jS)}(hjh]hunsigned long *num}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hjubj)}(hhh]jM)}(hvin: number of pages to map. out: number of pages that were *not* mapped. (0 means all pages were successfully mapped).h](h;in: number of pages to map. out: number of pages that were }(hjhhhNhNubj )}(h*not*h]hnot}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1j hjubh6 mapped. (0 means all pages were successfully mapped).}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hjRubeh}(h]h ]h"]h$]h&]uh1jhj6ubjM)}(h**Description**h]j)}(hjTh]h Description}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjRubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hj6ubjM)}(h>Preferred over vm_insert_page() when inserting multiple pages.h]h>Preferred over vm_insert_page() when inserting multiple pages.}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hj6ubjM)}(hIn case of error, we may have mapped a subset of the provided pages. It is the caller's responsibility to account for this case.h]hIn case of error, we may have mapped a subset of the provided pages. It is the caller’s responsibility to account for this case.}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hj6ubjM)}(h3The same restrictions apply as in vm_insert_page().h]h3The same restrictions apply as in vm_insert_page().}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hj6ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hvm_insert_page (C function)c.vm_insert_pagehNtauh1hhjKhhhNhNubh)}(hhh](h)}(hVint vm_insert_page (struct vm_area_struct *vma, unsigned long addr, struct page *page)h]h)}(hUint vm_insert_page(struct vm_area_struct *vma, unsigned long addr, struct page *page)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM ubh)}(hvm_insert_pageh]j)}(hvm_insert_pageh]hvm_insert_page}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhM ubj8)}(hC(struct vm_area_struct *vma, unsigned long addr, struct page *page)h](j>)}(hstruct vm_area_struct *vmah](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hvm_area_structh]hvm_area_struct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsbc.vm_insert_pageasbuh1hhjubj)}(h h]h }(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hj@hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hvmah]hvma}(hjMhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hunsigned long addrh](j)}(hunsignedh]hunsigned}(hjfhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjbubj)}(h h]h }(hjthhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjbubj)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjbubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjbubj)}(haddrh]haddr}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjbubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hstruct page *pageh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hpageh]hpage}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j.c.vm_insert_pageasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hpageh]hpage}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhM ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhM ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhM hjhhubj4)}(hhh]jM)}(h insert single page into user vmah]h insert single page into user vma}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hj5hhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhM ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjPjHjPjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct vm_area_struct *vma`` user vma to map to ``unsigned long addr`` target user address of this page ``struct page *page`` source kernel page **Description** This allows drivers to insert individual pages they've allocated into a user vma. The zeropage is supported in some VMAs, see vm_mixed_zeropage_allowed(). The page has to be a nice clean _individual_ kernel allocation. If you allocate a compound page, you need to have marked it as such (__GFP_COMP), or manually just split the page up yourself (see split_page()). NOTE! Traditionally this was done with "remap_pfn_range()" which took an arbitrary page protection parameter. This doesn't allow that. Your vma protection will have to be set up correctly, which means that if you want a shared writable mapping, you'd better ask for a shared writable mapping! The page does not need to be reserved. Usually this function is called from f_op->mmap() handler under mm->mmap_lock write-lock, so it can change vma->vm_flags. Caller must set VM_MIXEDMAP on vma if it wants to call this function from other places, for example from page-fault handler. **Return** ``0`` on success, negative error code otherwise.h](jM)}(h**Parameters**h]j)}(hjZh]h Parameters}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjXubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hjTubj)}(hhh](j)}(h2``struct vm_area_struct *vma`` user vma to map to h](j)}(h``struct vm_area_struct *vma``h]jS)}(hjyh]hstruct vm_area_struct *vma}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjwubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hjsubj)}(hhh]jM)}(huser vma to map toh]huser vma to map to}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjsubeh}(h]h ]h"]h$]h&]uh1jhjhM hjpubj)}(h8``unsigned long addr`` target user address of this page h](j)}(h``unsigned long addr``h]jS)}(hjh]hunsigned long addr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hjubj)}(hhh]jM)}(h target user address of this pageh]h target user address of this page}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hjpubj)}(h)``struct page *page`` source kernel page h](j)}(h``struct page *page``h]jS)}(hjh]hstruct page *page}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hjubj)}(hhh]jM)}(hsource kernel pageh]hsource kernel page}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hjpubeh}(h]h ]h"]h$]h&]uh1jhjTubjM)}(h**Description**h]j)}(hj&h]h Description}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj$ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hjTubjM)}(hThis allows drivers to insert individual pages they've allocated into a user vma. The zeropage is supported in some VMAs, see vm_mixed_zeropage_allowed().h]hThis allows drivers to insert individual pages they’ve allocated into a user vma. The zeropage is supported in some VMAs, see vm_mixed_zeropage_allowed().}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hjTubjM)}(hThe page has to be a nice clean _individual_ kernel allocation. If you allocate a compound page, you need to have marked it as such (__GFP_COMP), or manually just split the page up yourself (see split_page()).h]hThe page has to be a nice clean _individual_ kernel allocation. If you allocate a compound page, you need to have marked it as such (__GFP_COMP), or manually just split the page up yourself (see split_page()).}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hjTubjM)}(hX$NOTE! Traditionally this was done with "remap_pfn_range()" which took an arbitrary page protection parameter. This doesn't allow that. Your vma protection will have to be set up correctly, which means that if you want a shared writable mapping, you'd better ask for a shared writable mapping!h]hX,NOTE! Traditionally this was done with “remap_pfn_range()” which took an arbitrary page protection parameter. This doesn’t allow that. Your vma protection will have to be set up correctly, which means that if you want a shared writable mapping, you’d better ask for a shared writable mapping!}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hjTubjM)}(h&The page does not need to be reserved.h]h&The page does not need to be reserved.}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hjTubjM)}(hUsually this function is called from f_op->mmap() handler under mm->mmap_lock write-lock, so it can change vma->vm_flags. Caller must set VM_MIXEDMAP on vma if it wants to call this function from other places, for example from page-fault handler.h]hUsually this function is called from f_op->mmap() handler under mm->mmap_lock write-lock, so it can change vma->vm_flags. Caller must set VM_MIXEDMAP on vma if it wants to call this function from other places, for example from page-fault handler.}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hjTubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hjTubjM)}(h0``0`` on success, negative error code otherwise.h](jS)}(h``0``h]h0}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubh+ on success, negative error code otherwise.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hjTubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hvm_map_pages (C function)c.vm_map_pageshNtauh1hhjKhhhNhNubh)}(hhh](h)}(hUint vm_map_pages (struct vm_area_struct *vma, struct page **pages, unsigned long num)h]h)}(hTint vm_map_pages(struct vm_area_struct *vma, struct page **pages, unsigned long num)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM ubh)}(h vm_map_pagesh]j)}(h vm_map_pagesh]h vm_map_pages}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhM ubj8)}(hD(struct vm_area_struct *vma, struct page **pages, unsigned long num)h](j>)}(hstruct vm_area_struct *vmah](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hvm_area_structh]hvm_area_struct}(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj9modnameN classnameNjj)}j]j)}jjsbc.vm_map_pagesasbuh1hhjubj)}(h h]h }(hjWhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjehhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hvmah]hvma}(hjrhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hstruct page **pagesh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hpageh]hpage}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jSc.vm_map_pagesasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hpagesh]hpages}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hunsigned long numh](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hlongh]hlong}(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hnumh]hnum}(hj@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhM ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhM ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhM hjhhubj4)}(hhh]jM)}(h6maps range of kernel pages starts with non zero offseth]h6maps range of kernel pages starts with non zero offset}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hjghhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhM ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct vm_area_struct *vma`` user vma to map to ``struct page **pages`` pointer to array of source kernel pages ``unsigned long num`` number of pages in page array **Description** Maps an object consisting of **num** pages, catering for the user's requested vm_pgoff If we fail to insert any page into the vma, the function will return immediately leaving any previously inserted pages present. Callers from the mmap handler may immediately return the error as their caller will destroy the vma, removing any successfully inserted pages. Other callers should make their own arrangements for calling unmap_region(). **Context** Process context. Called by mmap handlers. **Return** 0 on success and error code otherwise.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hjubj)}(hhh](j)}(h2``struct vm_area_struct *vma`` user vma to map to h](j)}(h``struct vm_area_struct *vma``h]jS)}(hjh]hstruct vm_area_struct *vma}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hjubj)}(hhh]jM)}(huser vma to map toh]huser vma to map to}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hjubj)}(h@``struct page **pages`` pointer to array of source kernel pages h](j)}(h``struct page **pages``h]jS)}(hjh]hstruct page **pages}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hjubj)}(hhh]jM)}(h'pointer to array of source kernel pagesh]h'pointer to array of source kernel pages}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hjubj)}(h4``unsigned long num`` number of pages in page array h](j)}(h``unsigned long num``h]jS)}(hjh]hunsigned long num}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hjubj)}(hhh]jM)}(hnumber of pages in page arrayh]hnumber of pages in page array}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj2hM hj3ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj2hM hjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjXh]h Description}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjVubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hjubjM)}(hVMaps an object consisting of **num** pages, catering for the user's requested vm_pgoffh](hMaps an object consisting of }(hjnhhhNhNubj)}(h**num**h]hnum}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjnubh4 pages, catering for the user’s requested vm_pgoff}(hjnhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hjubjM)}(hX\If we fail to insert any page into the vma, the function will return immediately leaving any previously inserted pages present. Callers from the mmap handler may immediately return the error as their caller will destroy the vma, removing any successfully inserted pages. Other callers should make their own arrangements for calling unmap_region().h]hX\If we fail to insert any page into the vma, the function will return immediately leaving any previously inserted pages present. Callers from the mmap handler may immediately return the error as their caller will destroy the vma, removing any successfully inserted pages. Other callers should make their own arrangements for calling unmap_region().}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hjubjM)}(h **Context**h]j)}(hjh]hContext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hjubjM)}(h)Process context. Called by mmap handlers.h]h)Process context. Called by mmap handlers.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hjubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hjubjM)}(h&0 on success and error code otherwise.h]h&0 on success and error code otherwise.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hvm_map_pages_zero (C function)c.vm_map_pages_zerohNtauh1hhjKhhhNhNubh)}(hhh](h)}(hZint vm_map_pages_zero (struct vm_area_struct *vma, struct page **pages, unsigned long num)h]h)}(hYint vm_map_pages_zero(struct vm_area_struct *vma, struct page **pages, unsigned long num)h](j)}(hinth]hint}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM ubh)}(hvm_map_pages_zeroh]j)}(hvm_map_pages_zeroh]hvm_map_pages_zero}(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhM ubj8)}(hD(struct vm_area_struct *vma, struct page **pages, unsigned long num)h](j>)}(hstruct vm_area_struct *vmah](j)}(hjJ,h]hstruct}(hjIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEubj)}(h h]h }(hjVhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEubh)}(hhh]j)}(hvm_area_structh]hvm_area_struct}(hjghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjdubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjimodnameN classnameNjj)}j]j)}jj/sbc.vm_map_pages_zeroasbuh1hhjEubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjEubj)}(hvmah]hvma}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjAubj>)}(hstruct page **pagesh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hpageh]hpage}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.vm_map_pages_zeroasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hpagesh]hpages}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjAubj>)}(hunsigned long numh](j)}(hunsignedh]hunsigned}(hj8hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4ubj)}(h h]h }(hjFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4ubj)}(hlongh]hlong}(hjThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4ubj)}(h h]h }(hjbhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4ubj)}(hnumh]hnum}(hjphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjAubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhM ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhM ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhM hjhhubj4)}(hhh]jM)}(h1map range of kernel pages starts with zero offseth]h1map range of kernel pages starts with zero offset}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhM ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct vm_area_struct *vma`` user vma to map to ``struct page **pages`` pointer to array of source kernel pages ``unsigned long num`` number of pages in page array **Description** Similar to vm_map_pages(), except that it explicitly sets the offset to 0. This function is intended for the drivers that did not consider vm_pgoff. **Context** Process context. Called by mmap handlers. **Return** 0 on success and error code otherwise.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hjubj)}(hhh](j)}(h2``struct vm_area_struct *vma`` user vma to map to h](j)}(h``struct vm_area_struct *vma``h]jS)}(hjh]hstruct vm_area_struct *vma}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hjubj)}(hhh]jM)}(huser vma to map toh]huser vma to map to}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hjubj)}(h@``struct page **pages`` pointer to array of source kernel pages h](j)}(h``struct page **pages``h]jS)}(hjh]hstruct page **pages}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hjubj)}(hhh]jM)}(h'pointer to array of source kernel pagesh]h'pointer to array of source kernel pages}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj)hM hj*ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj)hM hjubj)}(h4``unsigned long num`` number of pages in page array h](j)}(h``unsigned long num``h]jS)}(hjMh]hunsigned long num}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjKubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hjGubj)}(hhh]jM)}(hnumber of pages in page arrayh]hnumber of pages in page array}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjbhM hjcubah}(h]h ]h"]h$]h&]uh1jhjGubeh}(h]h ]h"]h$]h&]uh1jhjbhM hjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hjubjM)}(hSimilar to vm_map_pages(), except that it explicitly sets the offset to 0. This function is intended for the drivers that did not consider vm_pgoff.h]hSimilar to vm_map_pages(), except that it explicitly sets the offset to 0. This function is intended for the drivers that did not consider vm_pgoff.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hjubjM)}(h **Context**h]j)}(hjh]hContext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM" hjubjM)}(h)Process context. Called by mmap handlers.h]h)Process context. Called by mmap handlers.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM# hjubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM% hjubjM)}(h&0 on success and error code otherwise.h]h&0 on success and error code otherwise.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM$ hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h vmf_insert_pfn_prot (C function)c.vmf_insert_pfn_prothNtauh1hhjKhhhNhNubh)}(hhh](h)}(hsvm_fault_t vmf_insert_pfn_prot (struct vm_area_struct *vma, unsigned long addr, unsigned long pfn, pgprot_t pgprot)h]h)}(hrvm_fault_t vmf_insert_pfn_prot(struct vm_area_struct *vma, unsigned long addr, unsigned long pfn, pgprot_t pgprot)h](h)}(hhh]j)}(h vm_fault_th]h vm_fault_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj modnameN classnameNjj)}j]j)}jvmf_insert_pfn_protsbc.vmf_insert_pfn_protasbuh1hhjhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chMa ubj)}(h h]h }(hj@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhj?hMa ubh)}(hvmf_insert_pfn_proth]j)}(hj<h]hvmf_insert_pfn_prot}(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhj?hMa ubj8)}(hT(struct vm_area_struct *vma, unsigned long addr, unsigned long pfn, pgprot_t pgprot)h](j>)}(hstruct vm_area_struct *vmah](j)}(hjJ,h]hstruct}(hjmhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjiubj)}(h h]h }(hjzhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjiubh)}(hhh]j)}(hvm_area_structh]hvm_area_struct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j:c.vmf_insert_pfn_protasbuh1hhjiubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjiubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjiubj)}(hvmah]hvma}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjiubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjeubj>)}(hunsigned long addrh](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(haddrh]haddr}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjeubj>)}(hunsigned long pfnh](j)}(hunsignedh]hunsigned}(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*ubj)}(h h]h }(hj<hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*ubj)}(hlongh]hlong}(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*ubj)}(h h]h }(hjXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*ubj)}(hpfnh]hpfn}(hjfhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjeubj>)}(hpgprot_t pgproth](h)}(hhh]j)}(hpgprot_th]hpgprot_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j:c.vmf_insert_pfn_protasbuh1hhj{ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{ubj)}(hpgproth]hpgprot}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjeubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhj?hMa ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhj?hMa ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj?hMa hjhhubj4)}(hhh]jM)}(h5insert single pfn into user vma with specified pgproth]h5insert single pfn into user vma with specified pgprot}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chMa hjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhj?hMa ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct vm_area_struct *vma`` user vma to map to ``unsigned long addr`` target user address of this page ``unsigned long pfn`` source kernel pfn ``pgprot_t pgprot`` pgprot flags for the inserted page **Description** This is exactly like vmf_insert_pfn(), except that it allows drivers to override pgprot on a per-page basis. This only makes sense for IO mappings, and it makes no sense for COW mappings. In general, using multiple vmas is preferable; vmf_insert_pfn_prot should only be used if using multiple VMAs is impractical. pgprot typically only differs from **vma->vm_page_prot** when drivers set caching- and encryption bits different than those of **vma->vm_page_prot**, because the caching- or encryption mode may not be known at mmap() time. This is ok as long as **vma->vm_page_prot** is not used by the core vm to set caching and encryption bits for those vmas (except for COW pages). This is ensured by core vm only modifying these page table entries using functions that don't touch caching- or encryption bits, using pte_modify() if needed. (See for example mprotect()). Also when new page-table entries are created, this is only done using the fault() callback, and never using the value of vma->vm_page_prot, except for page-table entries that point to anonymous pages as the result of COW. **Context** Process context. May allocate using ``GFP_KERNEL``. **Return** vm_fault_t value.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chMe hjubj)}(hhh](j)}(h2``struct vm_area_struct *vma`` user vma to map to h](j)}(h``struct vm_area_struct *vma``h]jS)}(hjh]hstruct vm_area_struct *vma}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chMb hjubj)}(hhh]jM)}(huser vma to map toh]huser vma to map to}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj.hMb hj/ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj.hMb hjubj)}(h8``unsigned long addr`` target user address of this page h](j)}(h``unsigned long addr``h]jS)}(hjRh]hunsigned long addr}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjPubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chMc hjLubj)}(hhh]jM)}(h target user address of this pageh]h target user address of this page}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjghMc hjhubah}(h]h ]h"]h$]h&]uh1jhjLubeh}(h]h ]h"]h$]h&]uh1jhjghMc hjubj)}(h(``unsigned long pfn`` source kernel pfn h](j)}(h``unsigned long pfn``h]jS)}(hjh]hunsigned long pfn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chMd hjubj)}(hhh]jM)}(hsource kernel pfnh]hsource kernel pfn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMd hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMd hjubj)}(h7``pgprot_t pgprot`` pgprot flags for the inserted page h](j)}(h``pgprot_t pgprot``h]jS)}(hjh]hpgprot_t pgprot}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chMe hjubj)}(hhh]jM)}(h"pgprot flags for the inserted pageh]h"pgprot flags for the inserted page}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMe hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMe hjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chMg hjubjM)}(hlThis is exactly like vmf_insert_pfn(), except that it allows drivers to override pgprot on a per-page basis.h]hlThis is exactly like vmf_insert_pfn(), except that it allows drivers to override pgprot on a per-page basis.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chMf hjubjM)}(hThis only makes sense for IO mappings, and it makes no sense for COW mappings. In general, using multiple vmas is preferable; vmf_insert_pfn_prot should only be used if using multiple VMAs is impractical.h]hThis only makes sense for IO mappings, and it makes no sense for COW mappings. In general, using multiple vmas is preferable; vmf_insert_pfn_prot should only be used if using multiple VMAs is impractical.}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chMi hjubjM)}(hpgprot typically only differs from **vma->vm_page_prot** when drivers set caching- and encryption bits different than those of **vma->vm_page_prot**, because the caching- or encryption mode may not be known at mmap() time.h](h#pgprot typically only differs from }(hj3hhhNhNubj)}(h**vma->vm_page_prot**h]hvma->vm_page_prot}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj3ubhG when drivers set caching- and encryption bits different than those of }(hj3hhhNhNubj)}(h**vma->vm_page_prot**h]hvma->vm_page_prot}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj3ubhJ, because the caching- or encryption mode may not be known at mmap() time.}(hj3hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chMn hjubjM)}(hXMThis is ok as long as **vma->vm_page_prot** is not used by the core vm to set caching and encryption bits for those vmas (except for COW pages). This is ensured by core vm only modifying these page table entries using functions that don't touch caching- or encryption bits, using pte_modify() if needed. (See for example mprotect()).h](hThis is ok as long as }(hjfhhhNhNubj)}(h**vma->vm_page_prot**h]hvma->vm_page_prot}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjfubhX$ is not used by the core vm to set caching and encryption bits for those vmas (except for COW pages). This is ensured by core vm only modifying these page table entries using functions that don’t touch caching- or encryption bits, using pte_modify() if needed. (See for example mprotect()).}(hjfhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chMr hjubjM)}(hAlso when new page-table entries are created, this is only done using the fault() callback, and never using the value of vma->vm_page_prot, except for page-table entries that point to anonymous pages as the result of COW.h]hAlso when new page-table entries are created, this is only done using the fault() callback, and never using the value of vma->vm_page_prot, except for page-table entries that point to anonymous pages as the result of COW.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chMx hjubjM)}(h **Context**h]j)}(hjh]hContext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM} hjubjM)}(h4Process context. May allocate using ``GFP_KERNEL``.h](h%Process context. May allocate using }(hjhhhNhNubjS)}(h``GFP_KERNEL``h]h GFP_KERNEL}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM~ hjubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hjubjM)}(hvm_fault_t value.h]hvm_fault_t value.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hvmf_insert_pfn (C function)c.vmf_insert_pfnhNtauh1hhjKhhhNhNubh)}(hhh](h)}(h]vm_fault_t vmf_insert_pfn (struct vm_area_struct *vma, unsigned long addr, unsigned long pfn)h]h)}(h\vm_fault_t vmf_insert_pfn(struct vm_area_struct *vma, unsigned long addr, unsigned long pfn)h](h)}(hhh]j)}(h vm_fault_th]h vm_fault_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jvmf_insert_pfnsbc.vmf_insert_pfnasbuh1hhjhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM ubj)}(h h]h }(hj;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhj:hM ubh)}(hvmf_insert_pfnh]j)}(hj7h]hvmf_insert_pfn}(hjMhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhj:hM ubj8)}(hC(struct vm_area_struct *vma, unsigned long addr, unsigned long pfn)h](j>)}(hstruct vm_area_struct *vmah](j)}(hjJ,h]hstruct}(hjhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjdubj)}(h h]h }(hjuhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjdubh)}(hhh]j)}(hvm_area_structh]hvm_area_struct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j5c.vmf_insert_pfnasbuh1hhjdubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjdubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjdubj)}(hvmah]hvma}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjdubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj`ubj>)}(hunsigned long addrh](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(haddrh]haddr}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj`ubj>)}(hunsigned long pfnh](j)}(hunsignedh]hunsigned}(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%ubj)}(h h]h }(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%ubj)}(hlongh]hlong}(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%ubj)}(h h]h }(hjShhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%ubj)}(hpfnh]hpfn}(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj`ubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhj:hM ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhj:hM ubah}(h]j ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj:hM hj hhubj4)}(hhh]jM)}(hinsert single pfn into user vmah]hinsert single pfn into user vma}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hjhhubah}(h]h ]h"]h$]h&]uh1j3hj hhhj:hM ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct vm_area_struct *vma`` user vma to map to ``unsigned long addr`` target user address of this page ``unsigned long pfn`` source kernel pfn **Description** Similar to vm_insert_page, this allows drivers to insert individual pages they've allocated into a user vma. Same comments apply. This function should only be called from a vm_ops->fault handler, and in that case the handler should return the result of this function. vma cannot be a COW mapping. As this is called only for pages that do not currently exist, we do not need to flush old virtual caches or the TLB. **Context** Process context. May allocate using ``GFP_KERNEL``. **Return** vm_fault_t value.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hjubj)}(hhh](j)}(h2``struct vm_area_struct *vma`` user vma to map to h](j)}(h``struct vm_area_struct *vma``h]jS)}(hjh]hstruct vm_area_struct *vma}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hjubj)}(hhh]jM)}(huser vma to map toh]huser vma to map to}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hjubj)}(h8``unsigned long addr`` target user address of this page h](j)}(h``unsigned long addr``h]jS)}(hjh]hunsigned long addr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hjubj)}(hhh]jM)}(h target user address of this pageh]h target user address of this page}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hjubj)}(h(``unsigned long pfn`` source kernel pfn h](j)}(h``unsigned long pfn``h]jS)}(hj>h]hunsigned long pfn}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj<ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hj8ubj)}(hhh]jM)}(hsource kernel pfnh]hsource kernel pfn}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjShM hjTubah}(h]h ]h"]h$]h&]uh1jhj8ubeh}(h]h ]h"]h$]h&]uh1jhjShM hjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjyh]h Description}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjwubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hjubjM)}(hSimilar to vm_insert_page, this allows drivers to insert individual pages they've allocated into a user vma. Same comments apply.h]hSimilar to vm_insert_page, this allows drivers to insert individual pages they’ve allocated into a user vma. Same comments apply.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hjubjM)}(hThis function should only be called from a vm_ops->fault handler, and in that case the handler should return the result of this function.h]hThis function should only be called from a vm_ops->fault handler, and in that case the handler should return the result of this function.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hjubjM)}(hvma cannot be a COW mapping.h]hvma cannot be a COW mapping.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hjubjM)}(htAs this is called only for pages that do not currently exist, we do not need to flush old virtual caches or the TLB.h]htAs this is called only for pages that do not currently exist, we do not need to flush old virtual caches or the TLB.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hjubjM)}(h **Context**h]j)}(hjh]hContext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hjubjM)}(h4Process context. May allocate using ``GFP_KERNEL``.h](h%Process context. May allocate using }(hjhhhNhNubjS)}(h``GFP_KERNEL``h]h GFP_KERNEL}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hjubjM)}(h **Return**h]j)}(hj h]hReturn}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hjubjM)}(hvm_fault_t value.h]hvm_fault_t value.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hremap_pfn_range (C function)c.remap_pfn_rangehNtauh1hhjKhhhNhNubh)}(hhh](h)}(hzint remap_pfn_range (struct vm_area_struct *vma, unsigned long addr, unsigned long pfn, unsigned long size, pgprot_t prot)h]h)}(hyint remap_pfn_range(struct vm_area_struct *vma, unsigned long addr, unsigned long pfn, unsigned long size, pgprot_t prot)h](j)}(hinth]hint}(hjK hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjG hhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM9 ubj)}(h h]h }(hjZ hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjG hhhjY hM9 ubh)}(hremap_pfn_rangeh]j)}(hremap_pfn_rangeh]hremap_pfn_range}(hjl hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjh ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjG hhhjY hM9 ubj8)}(hf(struct vm_area_struct *vma, unsigned long addr, unsigned long pfn, unsigned long size, pgprot_t prot)h](j>)}(hstruct vm_area_struct *vmah](j)}(hjJ,h]hstruct}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubh)}(hhh]j)}(hvm_area_structh]hvm_area_struct}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj modnameN classnameNjj)}j]j)}jjn sbc.remap_pfn_rangeasbuh1hhj ubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubjr)}(hjuh]h*}(hj hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj ubj)}(hvmah]hvma}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj ubj>)}(hunsigned long addrh](j)}(hunsignedh]hunsigned}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(hlongh]hlong}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h h]h }(hj$ hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(haddrh]haddr}(hj2 hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj ubj>)}(hunsigned long pfnh](j)}(hunsignedh]hunsigned}(hjK hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjG ubj)}(h h]h }(hjY hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjG ubj)}(hlongh]hlong}(hjg hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjG ubj)}(h h]h }(hju hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjG ubj)}(hpfnh]hpfn}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjG ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj ubj>)}(hunsigned long sizeh](j)}(hunsignedh]hunsigned}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(hlongh]hlong}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(hsizeh]hsize}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj ubj>)}(h pgprot_t proth](h)}(hhh]j)}(hpgprot_th]hpgprot_t}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj modnameN classnameNjj)}j]j c.remap_pfn_rangeasbuh1hhj ubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(hproth]hprot}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj ubeh}(h]h ]h"]h$]h&]jjuh1j7hjG hhhjY hM9 ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjC hhhjY hM9 ubah}(h]j> ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjY hM9 hj@ hhubj4)}(hhh]jM)}(h remap kernel memory to userspaceh]h remap kernel memory to userspace}(hjF hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.c6hM9 hjC hhubah}(h]h ]h"]h$]h&]uh1j3hj@ hhhjY hM9 ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj^ jHj^ jIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct vm_area_struct *vma`` user vma to map to ``unsigned long addr`` target page aligned user address to start at ``unsigned long pfn`` page frame number of kernel physical memory address ``unsigned long size`` size of mapping area ``pgprot_t prot`` page protection flags for this mapping **Note** this is only safe if the mm semaphore is held when called. **Return** ``0`` on success, negative error code otherwise.h](jM)}(h**Parameters**h]j)}(hjh h]h Parameters}(hjj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjf ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM= hjb ubj)}(hhh](j)}(h2``struct vm_area_struct *vma`` user vma to map to h](j)}(h``struct vm_area_struct *vma``h]jS)}(hj h]hstruct vm_area_struct *vma}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM: hj ubj)}(hhh]jM)}(huser vma to map toh]huser vma to map to}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj hM: hj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hM: hj~ ubj)}(hD``unsigned long addr`` target page aligned user address to start at h](j)}(h``unsigned long addr``h]jS)}(hj h]hunsigned long addr}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM; hj ubj)}(hhh]jM)}(h,target page aligned user address to start ath]h,target page aligned user address to start at}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj hM; hj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hM; hj~ ubj)}(hJ``unsigned long pfn`` page frame number of kernel physical memory address h](j)}(h``unsigned long pfn``h]jS)}(hj h]hunsigned long pfn}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM< hj ubj)}(hhh]jM)}(h3page frame number of kernel physical memory addressh]h3page frame number of kernel physical memory address}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj hM< hj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hM< hj~ ubj)}(h,``unsigned long size`` size of mapping area h](j)}(h``unsigned long size``h]jS)}(hj2 h]hunsigned long size}(hj4 hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj0 ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM= hj, ubj)}(hhh]jM)}(hsize of mapping areah]hsize of mapping area}(hjK hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjG hM= hjH ubah}(h]h ]h"]h$]h&]uh1jhj, ubeh}(h]h ]h"]h$]h&]uh1jhjG hM= hj~ ubj)}(h9``pgprot_t prot`` page protection flags for this mapping h](j)}(h``pgprot_t prot``h]jS)}(hjk h]h pgprot_t prot}(hjm hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhji ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM> hje ubj)}(hhh]jM)}(h&page protection flags for this mappingh]h&page protection flags for this mapping}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj hM> hj ubah}(h]h ]h"]h$]h&]uh1jhje ubeh}(h]h ]h"]h$]h&]uh1jhj hM> hj~ ubeh}(h]h ]h"]h$]h&]uh1jhjb ubjM)}(h**Note**h]j)}(hj h]hNote}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM@ hjb ubjM)}(h:this is only safe if the mm semaphore is held when called.h]h:this is only safe if the mm semaphore is held when called.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM@ hjb ubjM)}(h **Return**h]j)}(hj h]hReturn}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chMB hjb ubjM)}(h0``0`` on success, negative error code otherwise.h](jS)}(h``0``h]h0}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj ubh+ on success, negative error code otherwise.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chMB hjb ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hvm_iomap_memory (C function)c.vm_iomap_memoryhNtauh1hhjKhhhNhNubh)}(hhh](h)}(hVint vm_iomap_memory (struct vm_area_struct *vma, phys_addr_t start, unsigned long len)h]h)}(hUint vm_iomap_memory(struct vm_area_struct *vma, phys_addr_t start, unsigned long len)h](j)}(hinth]hint}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM ubj)}(h h]h }(hj/ hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhj. hM ubh)}(hvm_iomap_memoryh]j)}(hvm_iomap_memoryh]hvm_iomap_memory}(hjA hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj= ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj hhhj. hM ubj8)}(hB(struct vm_area_struct *vma, phys_addr_t start, unsigned long len)h](j>)}(hstruct vm_area_struct *vmah](j)}(hjJ,h]hstruct}(hj] hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjY ubj)}(h h]h }(hjj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjY ubh)}(hhh]j)}(hvm_area_structh]hvm_area_struct}(hj{ hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjx ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj} modnameN classnameNjj)}j]j)}jjC sbc.vm_iomap_memoryasbuh1hhjY ubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjY ubjr)}(hjuh]h*}(hj hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjY ubj)}(hvmah]hvma}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjY ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjU ubj>)}(hphys_addr_t starth](h)}(hhh]j)}(h phys_addr_th]h phys_addr_t}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj modnameN classnameNjj)}j]j c.vm_iomap_memoryasbuh1hhj ubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(hstarth]hstart}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjU ubj>)}(hunsigned long lenh](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hlongh]hlong}(hj3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjAhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hlenh]hlen}(hjOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjU ubeh}(h]h ]h"]h$]h&]jjuh1j7hj hhhj. hM ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj hhhj. hM ubah}(h]j ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj. hM hj hhubj4)}(hhh]jM)}(hremap memory to userspaceh]hremap memory to userspace}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hjvhhubah}(h]h ]h"]h$]h&]uh1j3hj hhhj. hM ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hX.**Parameters** ``struct vm_area_struct *vma`` user vma to map to ``phys_addr_t start`` start of the physical memory to be mapped ``unsigned long len`` size of area **Description** This is a simplified io_remap_pfn_range() for common driver use. The driver just needs to give us the physical memory range to be mapped, we'll figure out the rest from the vma information. NOTE! Some drivers might want to tweak vma->vm_page_prot first to get whatever write-combining details or similar. **Return** ``0`` on success, negative error code otherwise.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hjubj)}(hhh](j)}(h2``struct vm_area_struct *vma`` user vma to map to h](j)}(h``struct vm_area_struct *vma``h]jS)}(hjh]hstruct vm_area_struct *vma}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hjubj)}(hhh]jM)}(huser vma to map toh]huser vma to map to}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hjubj)}(h@``phys_addr_t start`` start of the physical memory to be mapped h](j)}(h``phys_addr_t start``h]jS)}(hjh]hphys_addr_t start}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hjubj)}(hhh]jM)}(h)start of the physical memory to be mappedh]h)start of the physical memory to be mapped}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM hj ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hjubj)}(h#``unsigned long len`` size of area h](j)}(h``unsigned long len``h]jS)}(hj,h]hunsigned long len}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj*ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hj&ubj)}(hhh]jM)}(h size of areah]h size of area}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjAhM hjBubah}(h]h ]h"]h$]h&]uh1jhj&ubeh}(h]h ]h"]h$]h&]uh1jhjAhM hjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjgh]h Description}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1jhjeubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hjubjM)}(hThis is a simplified io_remap_pfn_range() for common driver use. The driver just needs to give us the physical memory range to be mapped, we'll figure out the rest from the vma information.h]hThis is a simplified io_remap_pfn_range() for common driver use. The driver just needs to give us the physical memory range to be mapped, we’ll figure out the rest from the vma information.}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hjubjM)}(hrNOTE! Some drivers might want to tweak vma->vm_page_prot first to get whatever write-combining details or similar.h]hrNOTE! Some drivers might want to tweak vma->vm_page_prot first to get whatever write-combining details or similar.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hjubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hjubjM)}(h0``0`` on success, negative error code otherwise.h](jS)}(h``0``h]h0}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubh+ on success, negative error code otherwise.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h unmap_mapping_pages (C function)c.unmap_mapping_pageshNtauh1hhjKhhhNhNubh)}(hhh](h)}(hcvoid unmap_mapping_pages (struct address_space *mapping, pgoff_t start, pgoff_t nr, bool even_cows)h]h)}(hbvoid unmap_mapping_pages(struct address_space *mapping, pgoff_t start, pgoff_t nr, bool even_cows)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh)}(hunmap_mapping_pagesh]j)}(hunmap_mapping_pagesh]hunmap_mapping_pages}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMubj8)}(hJ(struct address_space *mapping, pgoff_t start, pgoff_t nr, bool even_cows)h](j>)}(hstruct address_space *mappingh](j)}(hjJ,h]hstruct}(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubj)}(h h]h }(hj:hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubh)}(hhh]j)}(h address_spaceh]h address_space}(hjKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjMmodnameN classnameNjj)}j]j)}jjsbc.unmap_mapping_pagesasbuh1hhj)ubj)}(h h]h }(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubjr)}(hjuh]h*}(hjyhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj)ubj)}(hmappingh]hmapping}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj%ubj>)}(h pgoff_t starth](h)}(hhh]j)}(hpgoff_th]hpgoff_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jgc.unmap_mapping_pagesasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hstarth]hstart}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj%ubj>)}(h pgoff_t nrh](h)}(hhh]j)}(hpgoff_th]hpgoff_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jgc.unmap_mapping_pagesasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hnrh]hnr}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj%ubj>)}(hbool even_cowsh](j)}(hjh]hbool}(hj/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubj)}(h h]h }(hj<hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubj)}(h even_cowsh]h even_cows}(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj%ubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]jM)}(hUnmap pages from processes.h]hUnmap pages from processes.}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chMhjqhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hX **Parameters** ``struct address_space *mapping`` The address space containing pages to be unmapped. ``pgoff_t start`` Index of first page to be unmapped. ``pgoff_t nr`` Number of pages to be unmapped. 0 to unmap to end of file. ``bool even_cows`` Whether to unmap even private COWed pages. **Description** Unmap the pages in this address space from any userspace process which has them mmaped. Generally, you want to remove COWed pages as well when a file is being truncated, but not when invalidating pages from the page cache.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chMhjubj)}(hhh](j)}(hU``struct address_space *mapping`` The address space containing pages to be unmapped. h](j)}(h!``struct address_space *mapping``h]jS)}(hjh]hstruct address_space *mapping}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chMhjubj)}(hhh]jM)}(h2The address space containing pages to be unmapped.h]h2The address space containing pages to be unmapped.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h6``pgoff_t start`` Index of first page to be unmapped. h](j)}(h``pgoff_t start``h]jS)}(hjh]h pgoff_t start}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chMhjubj)}(hhh]jM)}(h#Index of first page to be unmapped.h]h#Index of first page to be unmapped.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(hK``pgoff_t nr`` Number of pages to be unmapped. 0 to unmap to end of file. h](j)}(h``pgoff_t nr``h]jS)}(hj'h]h pgoff_t nr}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj%ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chMhj!ubj)}(hhh]jM)}(h;Number of pages to be unmapped. 0 to unmap to end of file.h]h;Number of pages to be unmapped. 0 to unmap to end of file.}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj<hMhj=ubah}(h]h ]h"]h$]h&]uh1jhj!ubeh}(h]h ]h"]h$]h&]uh1jhj<hMhjubj)}(h>``bool even_cows`` Whether to unmap even private COWed pages. h](j)}(h``bool even_cows``h]jS)}(hj`h]hbool even_cows}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj^ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chMhjZubj)}(hhh]jM)}(h*Whether to unmap even private COWed pages.h]h*Whether to unmap even private COWed pages.}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjuhMhjvubah}(h]h ]h"]h$]h&]uh1jhjZubeh}(h]h ]h"]h$]h&]uh1jhjuhMhjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chMhjubjM)}(hUnmap the pages in this address space from any userspace process which has them mmaped. Generally, you want to remove COWed pages as well when a file is being truncated, but not when invalidating pages from the page cache.h]hUnmap the pages in this address space from any userspace process which has them mmaped. Generally, you want to remove COWed pages as well when a file is being truncated, but not when invalidating pages from the page cache.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h unmap_mapping_range (C function)c.unmap_mapping_rangehNtauh1hhjKhhhNhNubh)}(hhh](h)}(huvoid unmap_mapping_range (struct address_space *mapping, loff_t const holebegin, loff_t const holelen, int even_cows)h]h)}(htvoid unmap_mapping_range(struct address_space *mapping, loff_t const holebegin, loff_t const holelen, int even_cows)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh)}(hunmap_mapping_rangeh]j)}(hunmap_mapping_rangeh]hunmap_mapping_range}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMubj8)}(h\(struct address_space *mapping, loff_t const holebegin, loff_t const holelen, int even_cows)h](j>)}(hstruct address_space *mappingh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(h address_spaceh]h address_space}(hj;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj8ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj=modnameN classnameNjj)}j]j)}jjsbc.unmap_mapping_rangeasbuh1hhjubj)}(h h]h }(hj[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjihhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hmappingh]hmapping}(hjvhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hloff_t const holebeginh](h)}(hhh]j)}(hloff_th]hloff_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jWc.unmap_mapping_rangeasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h holebeginh]h holebegin}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hloff_t const holelenh](h)}(hhh]j)}(hloff_th]hloff_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jWc.unmap_mapping_rangeasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]hconst}(hj!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hholelenh]hholelen}(hj<hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(h int even_cowsh](j)}(hinth]hint}(hjUhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjQubj)}(h h]h }(hjchhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjQubj)}(h even_cowsh]h even_cows}(hjqhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjQubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]jM)}(hunmap the portion of all mmaps in the specified address_space corresponding to the specified byte range in the underlying file.h]hunmap the portion of all mmaps in the specified address_space corresponding to the specified byte range in the underlying file.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chMhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct address_space *mapping`` the address space containing mmaps to be unmapped. ``loff_t const holebegin`` byte in first page to unmap, relative to the start of the underlying file. This will be rounded down to a PAGE_SIZE boundary. Note that this is different from truncate_pagecache(), which must keep the partial page. In contrast, we must get rid of partial pages. ``loff_t const holelen`` size of prospective hole in bytes. This will be rounded up to a PAGE_SIZE boundary. A holelen of zero truncates to the end of the file. ``int even_cows`` 1 when truncating a file, unmap even private COWed pages; but 0 when invalidating pagecache, don't throw away private data.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chMhjubj)}(hhh](j)}(hU``struct address_space *mapping`` the address space containing mmaps to be unmapped. h](j)}(h!``struct address_space *mapping``h]jS)}(hjh]hstruct address_space *mapping}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chMhjubj)}(hhh]jM)}(h2the address space containing mmaps to be unmapped.h]h2the address space containing mmaps to be unmapped.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(hX$``loff_t const holebegin`` byte in first page to unmap, relative to the start of the underlying file. This will be rounded down to a PAGE_SIZE boundary. Note that this is different from truncate_pagecache(), which must keep the partial page. In contrast, we must get rid of partial pages. h](j)}(h``loff_t const holebegin``h]jS)}(hjh]hloff_t const holebegin}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chMhjubj)}(hhh]jM)}(hXbyte in first page to unmap, relative to the start of the underlying file. This will be rounded down to a PAGE_SIZE boundary. Note that this is different from truncate_pagecache(), which must keep the partial page. In contrast, we must get rid of partial pages.h]hXbyte in first page to unmap, relative to the start of the underlying file. This will be rounded down to a PAGE_SIZE boundary. Note that this is different from truncate_pagecache(), which must keep the partial page. In contrast, we must get rid of partial pages.}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chMhj+ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj*hMhjubj)}(h``loff_t const holelen`` size of prospective hole in bytes. This will be rounded up to a PAGE_SIZE boundary. A holelen of zero truncates to the end of the file. h](j)}(h``loff_t const holelen``h]jS)}(hjOh]hloff_t const holelen}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjMubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chMhjIubj)}(hhh]jM)}(hsize of prospective hole in bytes. This will be rounded up to a PAGE_SIZE boundary. A holelen of zero truncates to the end of the file.h]hsize of prospective hole in bytes. This will be rounded up to a PAGE_SIZE boundary. A holelen of zero truncates to the end of the file.}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chMhjeubah}(h]h ]h"]h$]h&]uh1jhjIubeh}(h]h ]h"]h$]h&]uh1jhjdhMhjubj)}(h``int even_cows`` 1 when truncating a file, unmap even private COWed pages; but 0 when invalidating pagecache, don't throw away private data.h](j)}(h``int even_cows``h]jS)}(hjh]h int even_cows}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chMhjubj)}(hhh]jM)}(h{1 when truncating a file, unmap even private COWed pages; but 0 when invalidating pagecache, don't throw away private data.h]h}1 when truncating a file, unmap even private COWed pages; but 0 when invalidating pagecache, don’t throw away private data.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h follow_pfnmap_start (C function)c.follow_pfnmap_starthNtauh1hhjKhhhNhNubh)}(hhh](h)}(h9int follow_pfnmap_start (struct follow_pfnmap_args *args)h]h)}(h8int follow_pfnmap_start(struct follow_pfnmap_args *args)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh)}(hfollow_pfnmap_starth]j)}(hfollow_pfnmap_starth]hfollow_pfnmap_start}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMubj8)}(h!(struct follow_pfnmap_args *args)h]j>)}(hstruct follow_pfnmap_args *argsh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hfollow_pfnmap_argsh]hfollow_pfnmap_args}(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj?modnameN classnameNjj)}j]j)}jjsbc.follow_pfnmap_startasbuh1hhjubj)}(h h]h }(hj]hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjkhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hargsh]hargs}(hjxhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]jM)}(h/Look up a pfn mapping at a user virtual addressh]h/Look up a pfn mapping at a user virtual address}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chMhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct follow_pfnmap_args *args`` Pointer to struct **follow_pfnmap_args** **Description** The caller needs to setup args->vma and args->address to point to the virtual address as the target of such lookup. On a successful return, the results will be put into other output fields. After the caller finished using the fields, the caller must invoke another follow_pfnmap_end() to proper releases the locks and resources of such look up request. During the start() and end() calls, the results in **args** will be valid as proper locks will be held. After the end() is called, all the fields in **follow_pfnmap_args** will be invalid to be further accessed. Further use of such information after end() may require proper synchronizations by the caller with page table updates, otherwise it can create a security bug. If the PTE maps a refcounted page, callers are responsible to protect against invalidation with MMU notifiers; otherwise access to the PFN at a later point in time can trigger use-after-free. Only IO mappings and raw PFN mappings are allowed. The mmap semaphore should be taken for read, and the mmap semaphore cannot be released before the end() is invoked. This function must not be used to modify PTE content. **Return** zero on success, negative otherwise.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chMhjubj)}(hhh]j)}(hM``struct follow_pfnmap_args *args`` Pointer to struct **follow_pfnmap_args** h](j)}(h#``struct follow_pfnmap_args *args``h]jS)}(hjh]hstruct follow_pfnmap_args *args}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chMhjubj)}(hhh]jM)}(h(Pointer to struct **follow_pfnmap_args**h](hPointer to struct }(hjhhhNhNubj)}(h**follow_pfnmap_args**h]hfollow_pfnmap_args}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hj,h]h Description}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj*ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chMhjubjM)}(hThe caller needs to setup args->vma and args->address to point to the virtual address as the target of such lookup. On a successful return, the results will be put into other output fields.h]hThe caller needs to setup args->vma and args->address to point to the virtual address as the target of such lookup. On a successful return, the results will be put into other output fields.}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chMhjubjM)}(hAfter the caller finished using the fields, the caller must invoke another follow_pfnmap_end() to proper releases the locks and resources of such look up request.h]hAfter the caller finished using the fields, the caller must invoke another follow_pfnmap_end() to proper releases the locks and resources of such look up request.}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chMhjubjM)}(hXtDuring the start() and end() calls, the results in **args** will be valid as proper locks will be held. After the end() is called, all the fields in **follow_pfnmap_args** will be invalid to be further accessed. Further use of such information after end() may require proper synchronizations by the caller with page table updates, otherwise it can create a security bug.h](h3During the start() and end() calls, the results in }(hj`hhhNhNubj)}(h**args**h]hargs}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj`ubh[ will be valid as proper locks will be held. After the end() is called, all the fields in }(hj`hhhNhNubj)}(h**follow_pfnmap_args**h]hfollow_pfnmap_args}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj`ubh will be invalid to be further accessed. Further use of such information after end() may require proper synchronizations by the caller with page table updates, otherwise it can create a security bug.}(hj`hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chMhjubjM)}(hIf the PTE maps a refcounted page, callers are responsible to protect against invalidation with MMU notifiers; otherwise access to the PFN at a later point in time can trigger use-after-free.h]hIf the PTE maps a refcounted page, callers are responsible to protect against invalidation with MMU notifiers; otherwise access to the PFN at a later point in time can trigger use-after-free.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chMhjubjM)}(hOnly IO mappings and raw PFN mappings are allowed. The mmap semaphore should be taken for read, and the mmap semaphore cannot be released before the end() is invoked.h]hOnly IO mappings and raw PFN mappings are allowed. The mmap semaphore should be taken for read, and the mmap semaphore cannot be released before the end() is invoked.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chMhjubjM)}(h5This function must not be used to modify PTE content.h]h5This function must not be used to modify PTE content.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chMhjubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chMhjubjM)}(h$zero on success, negative otherwise.h]h$zero on success, negative otherwise.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfollow_pfnmap_end (C function)c.follow_pfnmap_endhNtauh1hhjKhhhNhNubh)}(hhh](h)}(h8void follow_pfnmap_end (struct follow_pfnmap_args *args)h]h)}(h7void follow_pfnmap_end(struct follow_pfnmap_args *args)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh)}(hfollow_pfnmap_endh]j)}(hfollow_pfnmap_endh]hfollow_pfnmap_end}(hj(hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMubj8)}(h!(struct follow_pfnmap_args *args)h]j>)}(hstruct follow_pfnmap_args *argsh](j)}(hjJ,h]hstruct}(hjDhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@ubj)}(h h]h }(hjQhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@ubh)}(hhh]j)}(hfollow_pfnmap_argsh]hfollow_pfnmap_args}(hjbhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj_ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjdmodnameN classnameNjj)}j]j)}jj*sbc.follow_pfnmap_endasbuh1hhj@ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@ubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj@ubj)}(hargsh]hargs}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj<ubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]jM)}(h#End a follow_pfnmap_start() processh]h#End a follow_pfnmap_start() process}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chMhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``struct follow_pfnmap_args *args`` Pointer to struct **follow_pfnmap_args** **Description** Must be used in pair of follow_pfnmap_start(). See the start() function above for more information.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chMhjubj)}(hhh]j)}(hM``struct follow_pfnmap_args *args`` Pointer to struct **follow_pfnmap_args** h](j)}(h#``struct follow_pfnmap_args *args``h]jS)}(hjh]hstruct follow_pfnmap_args *args}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chMhjubj)}(hhh]jM)}(h(Pointer to struct **follow_pfnmap_args**h](hPointer to struct }(hj!hhhNhNubj)}(h**follow_pfnmap_args**h]hfollow_pfnmap_args}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj!ubeh}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjQh]h Description}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1jhjOubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chMhjubjM)}(hdMust be used in pair of follow_pfnmap_start(). See the start() function above for more information.h]hdMust be used in pair of follow_pfnmap_start(). See the start() function above for more information.}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h generic_access_phys (C function)c.generic_access_physhNtauh1hhjKhhhNhNubh)}(hhh](h)}(hgint generic_access_phys (struct vm_area_struct *vma, unsigned long addr, void *buf, int len, int write)h]h)}(hfint generic_access_phys(struct vm_area_struct *vma, unsigned long addr, void *buf, int len, int write)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM,ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM,ubh)}(hgeneric_access_physh]j)}(hgeneric_access_physh]hgeneric_access_phys}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhM,ubj8)}(hO(struct vm_area_struct *vma, unsigned long addr, void *buf, int len, int write)h](j>)}(hstruct vm_area_struct *vmah](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hvm_area_structh]hvm_area_struct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsbc.generic_access_physasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hvmah]hvma}(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hunsigned long addrh](j)}(hunsignedh]hunsigned}(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjAubj)}(h h]h }(hjShhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjAubj)}(hlongh]hlong}(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjAubj)}(h h]h }(hjohhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjAubj)}(haddrh]haddr}(hj}hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjAubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(h void *bufh](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hbufh]hbuf}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hint lenh](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hlenh]hlen}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(h int writeh](j)}(hinth]hint}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(hwriteh]hwrite}(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhM,ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhM,ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhM,hjhhubj4)}(hhh]jM)}(h,generic implementation for iomem mmap accessh]h,generic implementation for iomem mmap access}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM,hjPhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhM,ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjkjHjkjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct vm_area_struct *vma`` the vma to access ``unsigned long addr`` userspace address, not relative offset within **vma** ``void *buf`` buffer to read/write ``int len`` length of transfer ``int write`` set to FOLL_WRITE when writing, otherwise reading **Description** This is a generic implementation for :c:type:`vm_operations_struct.access ` for an iomem mapping. This callback is used by access_process_vm() when the **vma** is not page based.h](jM)}(h**Parameters**h]j)}(hjuh]h Parameters}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjsubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM0hjoubj)}(hhh](j)}(h1``struct vm_area_struct *vma`` the vma to access h](j)}(h``struct vm_area_struct *vma``h]jS)}(hjh]hstruct vm_area_struct *vma}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM-hjubj)}(hhh]jM)}(hthe vma to accessh]hthe vma to access}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM-hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM-hjubj)}(hM``unsigned long addr`` userspace address, not relative offset within **vma** h](j)}(h``unsigned long addr``h]jS)}(hjh]hunsigned long addr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM.hjubj)}(hhh]jM)}(h5userspace address, not relative offset within **vma**h](h.userspace address, not relative offset within }(hjhhhNhNubj)}(h**vma**h]hvma}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jLhjhM.hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM.hjubj)}(h#``void *buf`` buffer to read/write h](j)}(h ``void *buf``h]jS)}(hjh]h void *buf}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM/hjubj)}(hhh]jM)}(hbuffer to read/writeh]hbuffer to read/write}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj)hM/hj*ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj)hM/hjubj)}(h``int len`` length of transfer h](j)}(h ``int len``h]jS)}(hjMh]hint len}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjKubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM0hjGubj)}(hhh]jM)}(hlength of transferh]hlength of transfer}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjbhM0hjcubah}(h]h ]h"]h$]h&]uh1jhjGubeh}(h]h ]h"]h$]h&]uh1jhjbhM0hjubj)}(h@``int write`` set to FOLL_WRITE when writing, otherwise reading h](j)}(h ``int write``h]jS)}(hjh]h int write}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM1hjubj)}(hhh]jM)}(h1set to FOLL_WRITE when writing, otherwise readingh]h1set to FOLL_WRITE when writing, otherwise reading}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM1hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM1hjubeh}(h]h ]h"]h$]h&]uh1jhjoubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM3hjoubjM)}(hThis is a generic implementation for :c:type:`vm_operations_struct.access ` for an iomem mapping. This callback is used by access_process_vm() when the **vma** is not page based.h](h%This is a generic implementation for }(hjhhhNhNubh)}(h<:c:type:`vm_operations_struct.access `h]jS)}(hjh]hvm_operations_struct.access}(hjhhhNhNubah}(h]h ](j%4jAc-typeeh"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]refdocj14 refdomainjAreftypetype refexplicitrefwarnjj74j:4vm_operations_structuh1hhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:110: ./mm/memory.chM2hjubhM for an iomem mapping. This callback is used by access_process_vm() when the }(hjhhhNhNubj)}(h**vma**h]hvma}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh is not page based.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhjhM2hjoubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h&__get_pfnblock_flags_mask (C function)c.__get_pfnblock_flags_maskhNtauh1hhjKhhhNhNubh)}(hhh](h)}(hhunsigned long __get_pfnblock_flags_mask (const struct page *page, unsigned long pfn, unsigned long mask)h]h)}(hgunsigned long __get_pfnblock_flags_mask(const struct page *page, unsigned long pfn, unsigned long mask)h](j)}(hunsignedh]hunsigned}(hj;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7hhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMubj)}(h h]h }(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7hhhjIhMubj)}(hlongh]hlong}(hjXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7hhhjIhMubj)}(h h]h }(hjfhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7hhhjIhMubh)}(h__get_pfnblock_flags_maskh]j)}(h__get_pfnblock_flags_maskh]h__get_pfnblock_flags_mask}(hjxhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjtubah}(h]h ](jjeh"]h$]h&]jjuh1hhj7hhhjIhMubj8)}(h@(const struct page *page, unsigned long pfn, unsigned long mask)h](j>)}(hconst struct page *pageh](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hpageh]hpage}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjzsbc.__get_pfnblock_flags_maskasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hpageh]hpage}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hunsigned long pfnh](j)}(hunsignedh]hunsigned}(hj!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hlongh]hlong}(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hpfnh]hpfn}(hjYhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hunsigned long maskh](j)}(hunsignedh]hunsigned}(hjrhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnubj)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnubj)}(hmaskh]hmask}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hj7hhhjIhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj3hhhjIhMubah}(h]j.ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjIhMhj0hhubj4)}(hhh]jM)}(hKReturn the requested group of flags for a pageblock_nr_pages block of pagesh]hKReturn the requested group of flags for a pageblock_nr_pages block of pages}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhjhhubah}(h]h ]h"]h$]h&]uh1j3hj0hhhjIhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``const struct page *page`` The page within the block of interest ``unsigned long pfn`` The target page frame number ``unsigned long mask`` mask of bits that the caller is interested in **Return** pageblock_bits flagsh](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhjubj)}(hhh](j)}(hB``const struct page *page`` The page within the block of interest h](j)}(h``const struct page *page``h]jS)}(hjh]hconst struct page *page}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhjubj)}(hhh]jM)}(h%The page within the block of interesth]h%The page within the block of interest}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj*hMhj+ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj*hMhj ubj)}(h3``unsigned long pfn`` The target page frame number h](j)}(h``unsigned long pfn``h]jS)}(hjNh]hunsigned long pfn}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjLubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhjHubj)}(hhh]jM)}(hThe target page frame numberh]hThe target page frame number}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjchMhjdubah}(h]h ]h"]h$]h&]uh1jhjHubeh}(h]h ]h"]h$]h&]uh1jhjchMhj ubj)}(hE``unsigned long mask`` mask of bits that the caller is interested in h](j)}(h``unsigned long mask``h]jS)}(hjh]hunsigned long mask}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhjubj)}(hhh]jM)}(h-mask of bits that the caller is interested inh]h-mask of bits that the caller is interested in}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhj ubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhjubjM)}(hpageblock_bits flagsh]hpageblock_bits flags}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hget_pfnblock_bit (C function)c.get_pfnblock_bithNtauh1hhjKhhhNhNubh)}(hhh](h)}(h^bool get_pfnblock_bit (const struct page *page, unsigned long pfn, enum pageblock_bits pb_bit)h]h)}(h]bool get_pfnblock_bit(const struct page *page, unsigned long pfn, enum pageblock_bits pb_bit)h](j)}(hjh]hbool}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhj hMubh)}(hget_pfnblock_bith]j)}(hget_pfnblock_bith]hget_pfnblock_bit}(hj' hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj# ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj hhhj hMubj8)}(hH(const struct page *page, unsigned long pfn, enum pageblock_bits pb_bit)h](j>)}(hconst struct page *pageh](j)}(hjh]hconst}(hjC hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj? ubj)}(h h]h }(hjP hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj? ubj)}(hjJ,h]hstruct}(hj^ hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj? ubj)}(h h]h }(hjk hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj? ubh)}(hhh]j)}(hpageh]hpage}(hj| hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjy ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj~ modnameN classnameNjj)}j]j)}jj) sbc.get_pfnblock_bitasbuh1hhj? ubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj? ubjr)}(hjuh]h*}(hj hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj? ubj)}(hpageh]hpage}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj? ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj; ubj>)}(hunsigned long pfnh](j)}(hunsignedh]hunsigned}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(hlongh]hlong}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(hpfnh]hpfn}(hj!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj; ubj>)}(henum pageblock_bits pb_bith](j)}(henumh]henum}(hj!!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubj)}(h h]h }(hj/!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubh)}(hhh]j)}(hpageblock_bitsh]hpageblock_bits}(hj@!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=!ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjB!modnameN classnameNjj)}j]j c.get_pfnblock_bitasbuh1hhj!ubj)}(h h]h }(hj^!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubj)}(hpb_bith]hpb_bit}(hjl!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj; ubeh}(h]h ]h"]h$]h&]jjuh1j7hj hhhj hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhj hMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj hMhjhhubj4)}(hhh]jM)}(h/Check if a standalone bit of a pageblock is seth]h/Check if a standalone bit of a pageblock is set}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj!hhubah}(h]h ]h"]h$]h&]uh1j3hjhhhj hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj!jHj!jIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``const struct page *page`` The page within the block of interest ``unsigned long pfn`` The target page frame number ``enum pageblock_bits pb_bit`` pageblock bit to check **Return** true if the bit is set, otherwise falseh](jM)}(h**Parameters**h]j)}(hj!h]h Parameters}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj!ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj!ubj)}(hhh](j)}(hB``const struct page *page`` The page within the block of interest h](j)}(h``const struct page *page``h]jS)}(hj!h]hconst struct page *page}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj!ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj!ubj)}(hhh]jM)}(h%The page within the block of interesth]h%The page within the block of interest}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj!hMhj!ubah}(h]h ]h"]h$]h&]uh1jhj!ubeh}(h]h ]h"]h$]h&]uh1jhj!hMhj!ubj)}(h3``unsigned long pfn`` The target page frame number h](j)}(h``unsigned long pfn``h]jS)}(hj"h]hunsigned long pfn}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj"ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj "ubj)}(hhh]jM)}(hThe target page frame numberh]hThe target page frame number}(hj)"hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj%"hMhj&"ubah}(h]h ]h"]h$]h&]uh1jhj "ubeh}(h]h ]h"]h$]h&]uh1jhj%"hMhj!ubj)}(h6``enum pageblock_bits pb_bit`` pageblock bit to check h](j)}(h``enum pageblock_bits pb_bit``h]jS)}(hjI"h]henum pageblock_bits pb_bit}(hjK"hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjG"ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhjC"ubj)}(hhh]jM)}(hpageblock bit to checkh]hpageblock bit to check}(hjb"hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj^"hMhj_"ubah}(h]h ]h"]h$]h&]uh1jhjC"ubeh}(h]h ]h"]h$]h&]uh1jhj^"hMhj!ubeh}(h]h ]h"]h$]h&]uh1jhj!ubjM)}(h **Return**h]j)}(hj"h]hReturn}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj"ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj!ubjM)}(h'true if the bit is set, otherwise falseh]h'true if the bit is set, otherwise false}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj!ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h%get_pfnblock_migratetype (C function)c.get_pfnblock_migratetypehNtauh1hhjKhhhNhNubh)}(hhh](h)}(hVenum migratetype get_pfnblock_migratetype (const struct page *page, unsigned long pfn)h]h)}(hUenum migratetype get_pfnblock_migratetype(const struct page *page, unsigned long pfn)h](j)}(hj#!h]henum}(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"hhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMubj)}(h h]h }(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"hhhj"hMubh)}(hhh]j)}(h migratetypeh]h migratetype}(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj"modnameN classnameNjj)}j]j)}jget_pfnblock_migratetypesbc.get_pfnblock_migratetypeasbuh1hhj"hhhj"hMubj)}(h h]h }(hj #hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"hhhj"hMubh)}(hget_pfnblock_migratetypeh]j)}(hj#h]hget_pfnblock_migratetype}(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj"hhhj"hMubj8)}(h,(const struct page *page, unsigned long pfn)h](j>)}(hconst struct page *pageh](j)}(hjh]hconst}(hj6#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2#ubj)}(h h]h }(hjC#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2#ubj)}(hjJ,h]hstruct}(hjQ#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2#ubj)}(h h]h }(hj^#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2#ubh)}(hhh]j)}(hpageh]hpage}(hjo#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjl#ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjq#modnameN classnameNjj)}j]j#c.get_pfnblock_migratetypeasbuh1hhj2#ubj)}(h h]h }(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2#ubjr)}(hjuh]h*}(hj#hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj2#ubj)}(hpageh]hpage}(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2#ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj.#ubj>)}(hunsigned long pfnh](j)}(hunsignedh]hunsigned}(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#ubj)}(h h]h }(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#ubj)}(hlongh]hlong}(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#ubj)}(h h]h }(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#ubj)}(hpfnh]hpfn}(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj.#ubeh}(h]h ]h"]h$]h&]jjuh1j7hj"hhhj"hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj"hhhj"hMubah}(h]j"ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj"hMhj"hhubj4)}(hhh]jM)}(h%Return the migratetype of a pageblockh]h%Return the migratetype of a pageblock}(hj#$hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj $hhubah}(h]h ]h"]h$]h&]uh1j3hj"hhhj"hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj;$jHj;$jIjJjKuh1hhhhjKhNhNubj)}(hX9**Parameters** ``const struct page *page`` The page within the block of interest ``unsigned long pfn`` The target page frame number **Return** The migratetype of the pageblock **Description** Use get_pfnblock_migratetype() if caller already has both **page** and **pfn** to save a call to page_to_pfn().h](jM)}(h**Parameters**h]j)}(hjE$h]h Parameters}(hjG$hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjC$ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj?$ubj)}(hhh](j)}(hB``const struct page *page`` The page within the block of interest h](j)}(h``const struct page *page``h]jS)}(hjd$h]hconst struct page *page}(hjf$hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjb$ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj^$ubj)}(hhh]jM)}(h%The page within the block of interesth]h%The page within the block of interest}(hj}$hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjy$hMhjz$ubah}(h]h ]h"]h$]h&]uh1jhj^$ubeh}(h]h ]h"]h$]h&]uh1jhjy$hMhj[$ubj)}(h3``unsigned long pfn`` The target page frame number h](j)}(h``unsigned long pfn``h]jS)}(hj$h]hunsigned long pfn}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj$ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj$ubj)}(hhh]jM)}(hThe target page frame numberh]hThe target page frame number}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj$hMhj$ubah}(h]h ]h"]h$]h&]uh1jhj$ubeh}(h]h ]h"]h$]h&]uh1jhj$hMhj[$ubeh}(h]h ]h"]h$]h&]uh1jhj?$ubjM)}(h **Return**h]j)}(hj$h]hReturn}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj$ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj?$ubjM)}(h The migratetype of the pageblockh]h The migratetype of the pageblock}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj?$ubjM)}(h**Description**h]j)}(hj$h]h Description}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj$ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj?$ubjM)}(hoUse get_pfnblock_migratetype() if caller already has both **page** and **pfn** to save a call to page_to_pfn().h](h:Use get_pfnblock_migratetype() if caller already has both }(hj%hhhNhNubj)}(h**page**h]hpage}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj%ubh and }(hj%hhhNhNubj)}(h**pfn**h]hpfn}(hj/%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj%ubh! to save a call to page_to_pfn().}(hj%hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj?$ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h&__set_pfnblock_flags_mask (C function)c.__set_pfnblock_flags_maskhNtauh1hhjKhhhNhNubh)}(hhh](h)}(hnvoid __set_pfnblock_flags_mask (struct page *page, unsigned long pfn, unsigned long flags, unsigned long mask)h]h)}(hmvoid __set_pfnblock_flags_mask(struct page *page, unsigned long pfn, unsigned long flags, unsigned long mask)h](j)}(hvoidh]hvoid}(hjh%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjd%hhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMubj)}(h h]h }(hjw%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjd%hhhjv%hMubh)}(h__set_pfnblock_flags_maskh]j)}(h__set_pfnblock_flags_maskh]h__set_pfnblock_flags_mask}(hj%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjd%hhhjv%hMubj8)}(hO(struct page *page, unsigned long pfn, unsigned long flags, unsigned long mask)h](j>)}(hstruct page *pageh](j)}(hjJ,h]hstruct}(hj%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%ubj)}(h h]h }(hj%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%ubh)}(hhh]j)}(hpageh]hpage}(hj%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj%modnameN classnameNjj)}j]j)}jj%sbc.__set_pfnblock_flags_maskasbuh1hhj%ubj)}(h h]h }(hj%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%ubjr)}(hjuh]h*}(hj%hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj%ubj)}(hpageh]hpage}(hj%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj%ubj>)}(hunsigned long pfnh](j)}(hunsignedh]hunsigned}(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubj)}(h h]h }(hj%&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubj)}(hlongh]hlong}(hj3&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubj)}(h h]h }(hjA&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubj)}(hpfnh]hpfn}(hjO&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj%ubj>)}(hunsigned long flagsh](j)}(hunsignedh]hunsigned}(hjh&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjd&ubj)}(h h]h }(hjv&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjd&ubj)}(hlongh]hlong}(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjd&ubj)}(h h]h }(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjd&ubj)}(hflagsh]hflags}(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjd&ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj%ubj>)}(hunsigned long maskh](j)}(hunsignedh]hunsigned}(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubj)}(h h]h }(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubj)}(hlongh]hlong}(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubj)}(h h]h }(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubj)}(hmaskh]hmask}(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj%ubeh}(h]h ]h"]h$]h&]jjuh1j7hjd%hhhjv%hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj`%hhhjv%hMubah}(h]j[%ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjv%hMhj]%hhubj4)}(hhh]jM)}(hHSet the requested group of flags for a pageblock_nr_pages block of pagesh]hHSet the requested group of flags for a pageblock_nr_pages block of pages}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj'hhubah}(h]h ]h"]h$]h&]uh1j3hj]%hhhjv%hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj3'jHj3'jIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``struct page *page`` The page within the block of interest ``unsigned long pfn`` The target page frame number ``unsigned long flags`` The flags to set ``unsigned long mask`` mask of bits that the caller is interested inh](jM)}(h**Parameters**h]j)}(hj='h]h Parameters}(hj?'hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj;'ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj7'ubj)}(hhh](j)}(h<``struct page *page`` The page within the block of interest h](j)}(h``struct page *page``h]jS)}(hj\'h]hstruct page *page}(hj^'hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjZ'ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhjV'ubj)}(hhh]jM)}(h%The page within the block of interesth]h%The page within the block of interest}(hju'hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjq'hMhjr'ubah}(h]h ]h"]h$]h&]uh1jhjV'ubeh}(h]h ]h"]h$]h&]uh1jhjq'hMhjS'ubj)}(h3``unsigned long pfn`` The target page frame number h](j)}(h``unsigned long pfn``h]jS)}(hj'h]hunsigned long pfn}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj'ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj'ubj)}(hhh]jM)}(hThe target page frame numberh]hThe target page frame number}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj'hMhj'ubah}(h]h ]h"]h$]h&]uh1jhj'ubeh}(h]h ]h"]h$]h&]uh1jhj'hMhjS'ubj)}(h)``unsigned long flags`` The flags to set h](j)}(h``unsigned long flags``h]jS)}(hj'h]hunsigned long flags}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj'ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj'ubj)}(hhh]jM)}(hThe flags to seth]hThe flags to set}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj'hMhj'ubah}(h]h ]h"]h$]h&]uh1jhj'ubeh}(h]h ]h"]h$]h&]uh1jhj'hMhjS'ubj)}(hD``unsigned long mask`` mask of bits that the caller is interested inh](j)}(h``unsigned long mask``h]jS)}(hj(h]hunsigned long mask}(hj (hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj(ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj(ubj)}(hhh]jM)}(h-mask of bits that the caller is interested inh]h-mask of bits that the caller is interested in}(hj (hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj(ubah}(h]h ]h"]h$]h&]uh1jhj(ubeh}(h]h ]h"]h$]h&]uh1jhj(hMhjS'ubeh}(h]h ]h"]h$]h&]uh1jhj7'ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hset_pfnblock_bit (C function)c.set_pfnblock_bithNtauh1hhjKhhhNhNubh)}(hhh](h)}(h^void set_pfnblock_bit (const struct page *page, unsigned long pfn, enum pageblock_bits pb_bit)h]h)}(h]void set_pfnblock_bit(const struct page *page, unsigned long pfn, enum pageblock_bits pb_bit)h](j)}(hvoidh]hvoid}(hja(hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj](hhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMubj)}(h h]h }(hjp(hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj](hhhjo(hMubh)}(hset_pfnblock_bith]j)}(hset_pfnblock_bith]hset_pfnblock_bit}(hj(hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~(ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj](hhhjo(hMubj8)}(hH(const struct page *page, unsigned long pfn, enum pageblock_bits pb_bit)h](j>)}(hconst struct page *pageh](j)}(hjh]hconst}(hj(hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(ubj)}(h h]h }(hj(hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(ubj)}(hjJ,h]hstruct}(hj(hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(ubj)}(h h]h }(hj(hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(ubh)}(hhh]j)}(hpageh]hpage}(hj(hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj(modnameN classnameNjj)}j]j)}jj(sbc.set_pfnblock_bitasbuh1hhj(ubj)}(h h]h }(hj(hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(ubjr)}(hjuh]h*}(hj)hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj(ubj)}(hpageh]hpage}(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj(ubj>)}(hunsigned long pfnh](j)}(hunsignedh]hunsigned}(hj+)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj')ubj)}(h h]h }(hj9)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj')ubj)}(hlongh]hlong}(hjG)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj')ubj)}(h h]h }(hjU)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj')ubj)}(hpfnh]hpfn}(hjc)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj')ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj(ubj>)}(henum pageblock_bits pb_bith](j)}(hj#!h]henum}(hj|)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjx)ubj)}(h h]h }(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjx)ubh)}(hhh]j)}(hpageblock_bitsh]hpageblock_bits}(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj)modnameN classnameNjj)}j]j(c.set_pfnblock_bitasbuh1hhjx)ubj)}(h h]h }(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjx)ubj)}(hpb_bith]hpb_bit}(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjx)ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj(ubeh}(h]h ]h"]h$]h&]jjuh1j7hj](hhhjo(hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjY(hhhjo(hMubah}(h]jT(ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjo(hMhjV(hhubj4)}(hhh]jM)}(h#Set a standalone bit of a pageblockh]h#Set a standalone bit of a pageblock}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj)hhubah}(h]h ]h"]h$]h&]uh1j3hjV(hhhjo(hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj*jHj*jIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``const struct page *page`` The page within the block of interest ``unsigned long pfn`` The target page frame number ``enum pageblock_bits pb_bit`` pageblock bit to seth](jM)}(h**Parameters**h]j)}(hj*h]h Parameters}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj*ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj *ubj)}(hhh](j)}(hB``const struct page *page`` The page within the block of interest h](j)}(h``const struct page *page``h]jS)}(hj1*h]hconst struct page *page}(hj3*hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj/*ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj+*ubj)}(hhh]jM)}(h%The page within the block of interesth]h%The page within the block of interest}(hjJ*hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjF*hMhjG*ubah}(h]h ]h"]h$]h&]uh1jhj+*ubeh}(h]h ]h"]h$]h&]uh1jhjF*hMhj(*ubj)}(h3``unsigned long pfn`` The target page frame number h](j)}(h``unsigned long pfn``h]jS)}(hjj*h]hunsigned long pfn}(hjl*hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjh*ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhjd*ubj)}(hhh]jM)}(hThe target page frame numberh]hThe target page frame number}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj*hMhj*ubah}(h]h ]h"]h$]h&]uh1jhjd*ubeh}(h]h ]h"]h$]h&]uh1jhj*hMhj(*ubj)}(h3``enum pageblock_bits pb_bit`` pageblock bit to seth](j)}(h``enum pageblock_bits pb_bit``h]jS)}(hj*h]henum pageblock_bits pb_bit}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj*ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj*ubj)}(hhh]jM)}(hpageblock bit to seth]hpageblock bit to set}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj*ubah}(h]h ]h"]h$]h&]uh1jhj*ubeh}(h]h ]h"]h$]h&]uh1jhj*hMhj(*ubeh}(h]h ]h"]h$]h&]uh1jhj *ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hclear_pfnblock_bit (C function)c.clear_pfnblock_bithNtauh1hhjKhhhNhNubh)}(hhh](h)}(h`void clear_pfnblock_bit (const struct page *page, unsigned long pfn, enum pageblock_bits pb_bit)h]h)}(h_void clear_pfnblock_bit(const struct page *page, unsigned long pfn, enum pageblock_bits pb_bit)h](j)}(hvoidh]hvoid}(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*hhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMubj)}(h h]h }(hj +hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*hhhj +hMubh)}(hclear_pfnblock_bith]j)}(hclear_pfnblock_bith]hclear_pfnblock_bit}(hj+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj*hhhj +hMubj8)}(hH(const struct page *page, unsigned long pfn, enum pageblock_bits pb_bit)h](j>)}(hconst struct page *pageh](j)}(hjh]hconst}(hj:+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj6+ubj)}(h h]h }(hjG+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj6+ubj)}(hjJ,h]hstruct}(hjU+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj6+ubj)}(h h]h }(hjb+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj6+ubh)}(hhh]j)}(hpageh]hpage}(hjs+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjp+ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetju+modnameN classnameNjj)}j]j)}jj +sbc.clear_pfnblock_bitasbuh1hhj6+ubj)}(h h]h }(hj+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj6+ubjr)}(hjuh]h*}(hj+hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj6+ubj)}(hpageh]hpage}(hj+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj6+ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj2+ubj>)}(hunsigned long pfnh](j)}(hunsignedh]hunsigned}(hj+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubj)}(h h]h }(hj+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubj)}(hlongh]hlong}(hj+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubj)}(h h]h }(hj+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubj)}(hpfnh]hpfn}(hj+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj2+ubj>)}(henum pageblock_bits pb_bith](j)}(hj#!h]henum}(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,ubj)}(h h]h }(hj%,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,ubh)}(hhh]j)}(hpageblock_bitsh]hpageblock_bits}(hj6,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3,ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj8,modnameN classnameNjj)}j]j+c.clear_pfnblock_bitasbuh1hhj,ubj)}(h h]h }(hjT,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,ubj)}(hpb_bith]hpb_bit}(hjb,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj2+ubeh}(h]h ]h"]h$]h&]jjuh1j7hj*hhhj +hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj*hhhj +hMubah}(h]j*ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj +hMhj*hhubj4)}(hhh]jM)}(h%Clear a standalone bit of a pageblockh]h%Clear a standalone bit of a pageblock}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj,hhubah}(h]h ]h"]h$]h&]uh1j3hj*hhhj +hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj,jHj,jIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``const struct page *page`` The page within the block of interest ``unsigned long pfn`` The target page frame number ``enum pageblock_bits pb_bit`` pageblock bit to clearh](jM)}(h**Parameters**h]j)}(hj,h]h Parameters}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj,ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj,ubj)}(hhh](j)}(hB``const struct page *page`` The page within the block of interest h](j)}(h``const struct page *page``h]jS)}(hj,h]hconst struct page *page}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj,ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj,ubj)}(hhh]jM)}(h%The page within the block of interesth]h%The page within the block of interest}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj,hMhj,ubah}(h]h ]h"]h$]h&]uh1jhj,ubeh}(h]h ]h"]h$]h&]uh1jhj,hMhj,ubj)}(h3``unsigned long pfn`` The target page frame number h](j)}(h``unsigned long pfn``h]jS)}(hj-h]hunsigned long pfn}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj-ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj-ubj)}(hhh]jM)}(hThe target page frame numberh]hThe target page frame number}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj-hMhj-ubah}(h]h ]h"]h$]h&]uh1jhj-ubeh}(h]h ]h"]h$]h&]uh1jhj-hMhj,ubj)}(h5``enum pageblock_bits pb_bit`` pageblock bit to clearh](j)}(h``enum pageblock_bits pb_bit``h]jS)}(hj?-h]henum pageblock_bits pb_bit}(hjA-hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj=-ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj9-ubj)}(hhh]jM)}(hpageblock bit to clearh]hpageblock bit to clear}(hjX-hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhjU-ubah}(h]h ]h"]h$]h&]uh1jhj9-ubeh}(h]h ]h"]h$]h&]uh1jhjT-hMhj,ubeh}(h]h ]h"]h$]h&]uh1jhj,ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h&set_pageblock_migratetype (C function)c.set_pageblock_migratetypehNtauh1hhjKhhhNhNubh)}(hhh](h)}(hPvoid set_pageblock_migratetype (struct page *page, enum migratetype migratetype)h]h)}(hOvoid set_pageblock_migratetype(struct page *page, enum migratetype migratetype)h](j)}(hvoidh]hvoid}(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-hhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chM ubj)}(h h]h }(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-hhhj-hM ubh)}(hset_pageblock_migratetypeh]j)}(hset_pageblock_migratetypeh]hset_pageblock_migratetype}(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj-hhhj-hM ubj8)}(h1(struct page *page, enum migratetype migratetype)h](j>)}(hstruct page *pageh](j)}(hjJ,h]hstruct}(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-ubj)}(h h]h }(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-ubh)}(hhh]j)}(hpageh]hpage}(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj-modnameN classnameNjj)}j]j)}jj-sbc.set_pageblock_migratetypeasbuh1hhj-ubj)}(h h]h }(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-ubjr)}(hjuh]h*}(hj".hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj-ubj)}(hpageh]hpage}(hj/.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj-ubj>)}(henum migratetype migratetypeh](j)}(hj#!h]henum}(hjH.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjD.ubj)}(h h]h }(hjU.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjD.ubh)}(hhh]j)}(h migratetypeh]h migratetype}(hjf.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjc.ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjh.modnameN classnameNjj)}j]j.c.set_pageblock_migratetypeasbuh1hhjD.ubj)}(h h]h }(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjD.ubj)}(h migratetypeh]h migratetype}(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjD.ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj-ubeh}(h]h ]h"]h$]h&]jjuh1j7hj-hhhj-hM ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj-hhhj-hM ubah}(h]j-ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj-hM hj-hhubj4)}(hhh]jM)}(h"Set the migratetype of a pageblockh]h"Set the migratetype of a pageblock}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chM hj.hhubah}(h]h ]h"]h$]h&]uh1j3hj-hhhj-hM ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj.jHj.jIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``struct page *page`` The page within the block of interest ``enum migratetype migratetype`` migratetype to seth](jM)}(h**Parameters**h]j)}(hj.h]h Parameters}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj.ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj.ubj)}(hhh](j)}(h<``struct page *page`` The page within the block of interest h](j)}(h``struct page *page``h]jS)}(hj.h]hstruct page *page}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj.ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chM hj.ubj)}(hhh]jM)}(h%The page within the block of interesth]h%The page within the block of interest}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj/hM hj/ubah}(h]h ]h"]h$]h&]uh1jhj.ubeh}(h]h ]h"]h$]h&]uh1jhj/hM hj.ubj)}(h3``enum migratetype migratetype`` migratetype to seth](j)}(h ``enum migratetype migratetype``h]jS)}(hj6/h]henum migratetype migratetype}(hj8/hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj4/ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj0/ubj)}(hhh]jM)}(hmigratetype to seth]hmigratetype to set}(hjO/hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chM hjL/ubah}(h]h ]h"]h$]h&]uh1jhj0/ubeh}(h]h ]h"]h$]h&]uh1jhjK/hMhj.ubeh}(h]h ]h"]h$]h&]uh1jhj.ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h+__move_freepages_block_isolate (C function) c.__move_freepages_block_isolatehNtauh1hhjKhhhNhNubh)}(hhh](h)}(hXbool __move_freepages_block_isolate (struct zone *zone, struct page *page, bool isolate)h]h)}(hWbool __move_freepages_block_isolate(struct zone *zone, struct page *page, bool isolate)h](j)}(hjh]hbool}(hj/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/hhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMubj)}(h h]h }(hj/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/hhhj/hMubh)}(h__move_freepages_block_isolateh]j)}(h__move_freepages_block_isolateh]h__move_freepages_block_isolate}(hj/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj/hhhj/hMubj8)}(h4(struct zone *zone, struct page *page, bool isolate)h](j>)}(hstruct zone *zoneh](j)}(hjJ,h]hstruct}(hj/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/ubj)}(h h]h }(hj/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/ubh)}(hhh]j)}(hzoneh]hzone}(hj/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj/modnameN classnameNjj)}j]j)}jj/sb c.__move_freepages_block_isolateasbuh1hhj/ubj)}(h h]h }(hj 0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/ubjr)}(hjuh]h*}(hj0hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj/ubj)}(hzoneh]hzone}(hj%0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj/ubj>)}(hstruct page *pageh](j)}(hjJ,h]hstruct}(hj>0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:0ubj)}(h h]h }(hjK0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:0ubh)}(hhh]j)}(hpageh]hpage}(hj\0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjY0ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj^0modnameN classnameNjj)}j]j0 c.__move_freepages_block_isolateasbuh1hhj:0ubj)}(h h]h }(hjz0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:0ubjr)}(hjuh]h*}(hj0hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj:0ubj)}(hpageh]hpage}(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:0ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj/ubj>)}(h bool isolateh](j)}(hjh]hbool}(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubj)}(h h]h }(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubj)}(hisolateh]hisolate}(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj/ubeh}(h]h ]h"]h$]h&]jjuh1j7hj/hhhj/hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj/hhhj/hMubah}(h]j/ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj/hMhj/hhubj4)}(hhh]jM)}(h+move free pages in block for page isolationh]h+move free pages in block for page isolation}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj0hhubah}(h]h ]h"]h$]h&]uh1j3hj/hhhj/hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj 1jHj 1jIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct zone *zone`` the zone ``struct page *page`` the pageblock page ``bool isolate`` to isolate the given pageblock or unisolate it **Description** This is similar to move_freepages_block(), but handles the special case encountered in page isolation, where the block of interest might be part of a larger buddy spanning multiple pageblocks. Unlike the regular page allocator path, which moves pages while stealing buddies off the freelist, page isolation is interested in arbitrary pfn ranges that may have overlapping buddies on both ends. This function handles that. Straddling buddies are split into individual pageblocks. Only the block of interest is moved. Returns ``true`` if pages could be moved, ``false`` otherwise.h](jM)}(h**Parameters**h]j)}(hj1h]h Parameters}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj1ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chM"hj1ubj)}(hhh](j)}(h``struct zone *zone`` the zone h](j)}(h``struct zone *zone``h]jS)}(hj41h]hstruct zone *zone}(hj61hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj21ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj.1ubj)}(hhh]jM)}(hthe zoneh]hthe zone}(hjM1hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjI1hMhjJ1ubah}(h]h ]h"]h$]h&]uh1jhj.1ubeh}(h]h ]h"]h$]h&]uh1jhjI1hMhj+1ubj)}(h)``struct page *page`` the pageblock page h](j)}(h``struct page *page``h]jS)}(hjm1h]hstruct page *page}(hjo1hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjk1ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chM hjg1ubj)}(hhh]jM)}(hthe pageblock pageh]hthe pageblock page}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj1hM hj1ubah}(h]h ]h"]h$]h&]uh1jhjg1ubeh}(h]h ]h"]h$]h&]uh1jhj1hM hj+1ubj)}(h@``bool isolate`` to isolate the given pageblock or unisolate it h](j)}(h``bool isolate``h]jS)}(hj1h]h bool isolate}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj1ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chM!hj1ubj)}(hhh]jM)}(h.to isolate the given pageblock or unisolate ith]h.to isolate the given pageblock or unisolate it}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj1hM!hj1ubah}(h]h ]h"]h$]h&]uh1jhj1ubeh}(h]h ]h"]h$]h&]uh1jhj1hM!hj+1ubeh}(h]h ]h"]h$]h&]uh1jhj1ubjM)}(h**Description**h]j)}(hj1h]h Description}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj1ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chM#hj1ubjM)}(hThis is similar to move_freepages_block(), but handles the special case encountered in page isolation, where the block of interest might be part of a larger buddy spanning multiple pageblocks.h]hThis is similar to move_freepages_block(), but handles the special case encountered in page isolation, where the block of interest might be part of a larger buddy spanning multiple pageblocks.}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chM"hj1ubjM)}(hUnlike the regular page allocator path, which moves pages while stealing buddies off the freelist, page isolation is interested in arbitrary pfn ranges that may have overlapping buddies on both ends.h]hUnlike the regular page allocator path, which moves pages while stealing buddies off the freelist, page isolation is interested in arbitrary pfn ranges that may have overlapping buddies on both ends.}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chM&hj1ubjM)}(hyThis function handles that. Straddling buddies are split into individual pageblocks. Only the block of interest is moved.h]hyThis function handles that. Straddling buddies are split into individual pageblocks. Only the block of interest is moved.}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chM*hj1ubjM)}(h>Returns ``true`` if pages could be moved, ``false`` otherwise.h](hReturns }(hj$2hhhNhNubjS)}(h``true``h]htrue}(hj,2hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj$2ubh if pages could be moved, }(hj$2hhhNhNubjS)}(h ``false``h]hfalse}(hj>2hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj$2ubh otherwise.}(hj$2hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chM-hj1ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h$__putback_isolated_page (C function)c.__putback_isolated_pagehNtauh1hhjKhhhNhNubh)}(hhh](h)}(hLvoid __putback_isolated_page (struct page *page, unsigned int order, int mt)h]h)}(hKvoid __putback_isolated_page(struct page *page, unsigned int order, int mt)h](j)}(hvoidh]hvoid}(hjw2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjs2hhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chM^ ubj)}(h h]h }(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjs2hhhj2hM^ ubh)}(h__putback_isolated_pageh]j)}(h__putback_isolated_pageh]h__putback_isolated_page}(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjs2hhhj2hM^ ubj8)}(h/(struct page *page, unsigned int order, int mt)h](j>)}(hstruct page *pageh](j)}(hjJ,h]hstruct}(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2ubj)}(h h]h }(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2ubh)}(hhh]j)}(hpageh]hpage}(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj2modnameN classnameNjj)}j]j)}jj2sbc.__putback_isolated_pageasbuh1hhj2ubj)}(h h]h }(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2ubjr)}(hjuh]h*}(hj3hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj2ubj)}(hpageh]hpage}(hj 3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj2ubj>)}(hunsigned int orderh](j)}(hunsignedh]hunsigned}(hj&3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"3ubj)}(h h]h }(hj43hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"3ubj)}(hinth]hint}(hjB3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"3ubj)}(h h]h }(hjP3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"3ubj)}(horderh]horder}(hj^3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"3ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj2ubj>)}(hint mth](j)}(hinth]hint}(hjw3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjs3ubj)}(h h]h }(hj3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjs3ubj)}(hmth]hmt}(hj3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjs3ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj2ubeh}(h]h ]h"]h$]h&]jjuh1j7hjs2hhhj2hM^ ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjo2hhhj2hM^ ubah}(h]jj2ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj2hM^ hjl2hhubj4)}(hhh]jM)}(h/Return a now-isolated page back where we got ith]h/Return a now-isolated page back where we got it}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chM^ hj3hhubah}(h]h ]h"]h$]h&]uh1j3hjl2hhhj2hM^ ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj3jHj3jIjJjKuh1hhhhjKhNhNubj)}(hX?**Parameters** ``struct page *page`` Page that was isolated ``unsigned int order`` Order of the isolated page ``int mt`` The page's pageblock's migratetype **Description** This function is meant to return a page pulled from the free lists via __isolate_free_page back to the free lists they were pulled from.h](jM)}(h**Parameters**h]j)}(hj3h]h Parameters}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj3ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMb hj3ubj)}(hhh](j)}(h-``struct page *page`` Page that was isolated h](j)}(h``struct page *page``h]jS)}(hj3h]hstruct page *page}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj3ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chM_ hj3ubj)}(hhh]jM)}(hPage that was isolatedh]hPage that was isolated}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj4hM_ hj4ubah}(h]h ]h"]h$]h&]uh1jhj3ubeh}(h]h ]h"]h$]h&]uh1jhj4hM_ hj3ubj)}(h2``unsigned int order`` Order of the isolated page h](j)}(h``unsigned int order``h]jS)}(hj74h]hunsigned int order}(hj94hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj54ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chM` hj14ubj)}(hhh]jM)}(hOrder of the isolated pageh]hOrder of the isolated page}(hjP4hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjL4hM` hjM4ubah}(h]h ]h"]h$]h&]uh1jhj14ubeh}(h]h ]h"]h$]h&]uh1jhjL4hM` hj3ubj)}(h.``int mt`` The page's pageblock's migratetype h](j)}(h ``int mt``h]jS)}(hjp4h]hint mt}(hjr4hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjn4ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMa hjj4ubj)}(hhh]jM)}(h"The page's pageblock's migratetypeh]h&The page’s pageblock’s migratetype}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj4hMa hj4ubah}(h]h ]h"]h$]h&]uh1jhjj4ubeh}(h]h ]h"]h$]h&]uh1jhj4hMa hj3ubeh}(h]h ]h"]h$]h&]uh1jhj3ubjM)}(h**Description**h]j)}(hj4h]h Description}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj4ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMc hj3ubjM)}(hThis function is meant to return a page pulled from the free lists via __isolate_free_page back to the free lists they were pulled from.h]hThis function is meant to return a page pulled from the free lists via __isolate_free_page back to the free lists they were pulled from.}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMb hj3ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h__free_pages (C function)c.__free_pageshNtauh1hhjKhhhNhNubh)}(hhh](h)}(h9void __free_pages (struct page *page, unsigned int order)h]h)}(h8void __free_pages(struct page *page, unsigned int order)h](j)}(hvoidh]hvoid}(hj4hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4hhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMubj)}(h h]h }(hj4hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4hhhj4hMubh)}(h __free_pagesh]j)}(h __free_pagesh]h __free_pages}(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj 5ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj4hhhj4hMubj8)}(h'(struct page *page, unsigned int order)h](j>)}(hstruct page *pageh](j)}(hjJ,h]hstruct}(hj-5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)5ubj)}(h h]h }(hj:5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)5ubh)}(hhh]j)}(hpageh]hpage}(hjK5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjH5ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjM5modnameN classnameNjj)}j]j)}jj5sbc.__free_pagesasbuh1hhj)5ubj)}(h h]h }(hjk5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)5ubjr)}(hjuh]h*}(hjy5hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj)5ubj)}(hpageh]hpage}(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)5ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj%5ubj>)}(hunsigned int orderh](j)}(hunsignedh]hunsigned}(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5ubj)}(h h]h }(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5ubj)}(hinth]hint}(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5ubj)}(h h]h }(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5ubj)}(horderh]horder}(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj%5ubeh}(h]h ]h"]h$]h&]jjuh1j7hj4hhhj4hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj4hhhj4hMubah}(h]j4ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj4hMhj4hhubj4)}(hhh]jM)}(h(Free pages allocated with alloc_pages().h]h(Free pages allocated with alloc_pages().}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj5hhubah}(h]h ]h"]h$]h&]uh1j3hj4hhhj4hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj6jHj6jIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct page *page`` The page pointer returned from alloc_pages(). ``unsigned int order`` The order of the allocation. **Description** This function can free multi-page allocations that are not compound pages. It does not check that the **order** passed in matches that of the allocation, so it is easy to leak memory. Freeing more memory than was allocated will probably emit a warning. If the last reference to this page is speculative, it will be released by put_page() which only frees the first page of a non-compound allocation. To prevent the remaining pages from being leaked, we free the subsequent pages here. If you want to use the page's reference count to decide when to free the allocation, you should allocate a compound page, and use put_page() instead of __free_pages(). **Context** May be called in interrupt context or while holding a normal spinlock, but not in NMI context or while holding a raw spinlock.h](jM)}(h**Parameters**h]j)}(hj#6h]h Parameters}(hj%6hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj!6ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj6ubj)}(hhh](j)}(hD``struct page *page`` The page pointer returned from alloc_pages(). h](j)}(h``struct page *page``h]jS)}(hjB6h]hstruct page *page}(hjD6hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj@6ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj<6ubj)}(hhh]jM)}(h-The page pointer returned from alloc_pages().h]h-The page pointer returned from alloc_pages().}(hj[6hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjW6hMhjX6ubah}(h]h ]h"]h$]h&]uh1jhj<6ubeh}(h]h ]h"]h$]h&]uh1jhjW6hMhj96ubj)}(h4``unsigned int order`` The order of the allocation. h](j)}(h``unsigned int order``h]jS)}(hj{6h]hunsigned int order}(hj}6hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjy6ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhju6ubj)}(hhh]jM)}(hThe order of the allocation.h]hThe order of the allocation.}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj6hMhj6ubah}(h]h ]h"]h$]h&]uh1jhju6ubeh}(h]h ]h"]h$]h&]uh1jhj6hMhj96ubeh}(h]h ]h"]h$]h&]uh1jhj6ubjM)}(h**Description**h]j)}(hj6h]h Description}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj6ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj6ubjM)}(hThis function can free multi-page allocations that are not compound pages. It does not check that the **order** passed in matches that of the allocation, so it is easy to leak memory. Freeing more memory than was allocated will probably emit a warning.h](hgThis function can free multi-page allocations that are not compound pages. It does not check that the }(hj6hhhNhNubj)}(h **order**h]horder}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj6ubh passed in matches that of the allocation, so it is easy to leak memory. Freeing more memory than was allocated will probably emit a warning.}(hj6hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj6ubjM)}(hXIf the last reference to this page is speculative, it will be released by put_page() which only frees the first page of a non-compound allocation. To prevent the remaining pages from being leaked, we free the subsequent pages here. If you want to use the page's reference count to decide when to free the allocation, you should allocate a compound page, and use put_page() instead of __free_pages().h]hXIf the last reference to this page is speculative, it will be released by put_page() which only frees the first page of a non-compound allocation. To prevent the remaining pages from being leaked, we free the subsequent pages here. If you want to use the page’s reference count to decide when to free the allocation, you should allocate a compound page, and use put_page() instead of __free_pages().}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj6ubjM)}(h **Context**h]j)}(hj6h]hContext}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj6ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj6ubjM)}(h~May be called in interrupt context or while holding a normal spinlock, but not in NMI context or while holding a raw spinlock.h]h~May be called in interrupt context or while holding a normal spinlock, but not in NMI context or while holding a raw spinlock.}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj6ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfree_pages (C function) c.free_pageshNtauh1hhjKhhhNhNubh)}(hhh](h)}(h8void free_pages (unsigned long addr, unsigned int order)h]h)}(h7void free_pages(unsigned long addr, unsigned int order)h](j)}(hvoidh]hvoid}(hjC7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?7hhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMubj)}(h h]h }(hjR7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?7hhhjQ7hMubh)}(h free_pagesh]j)}(h free_pagesh]h free_pages}(hjd7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj`7ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj?7hhhjQ7hMubj8)}(h((unsigned long addr, unsigned int order)h](j>)}(hunsigned long addrh](j)}(hunsignedh]hunsigned}(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|7ubj)}(h h]h }(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|7ubj)}(hlongh]hlong}(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|7ubj)}(h h]h }(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|7ubj)}(haddrh]haddr}(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|7ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjx7ubj>)}(hunsigned int orderh](j)}(hunsignedh]hunsigned}(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7ubj)}(h h]h }(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7ubj)}(hinth]hint}(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7ubj)}(h h]h }(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7ubj)}(horderh]horder}(hj 8hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjx7ubeh}(h]h ]h"]h$]h&]jjuh1j7hj?7hhhjQ7hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj;7hhhjQ7hMubah}(h]j67ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjQ7hMhj87hhubj4)}(hhh]jM)}(h-Free pages allocated with __get_free_pages().h]h-Free pages allocated with __get_free_pages().}(hj38hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj08hhubah}(h]h ]h"]h$]h&]uh1j3hj87hhhjQ7hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjK8jHjK8jIjJjKuh1hhhhjKhNhNubj)}(hXg**Parameters** ``unsigned long addr`` The virtual address tied to a page returned from __get_free_pages(). ``unsigned int order`` The order of the allocation. **Description** This function behaves the same as __free_pages(). Use this function to free pages when you only have a valid virtual address. If you have the page, call __free_pages() instead.h](jM)}(h**Parameters**h]j)}(hjU8h]h Parameters}(hjW8hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjS8ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhjO8ubj)}(hhh](j)}(h\``unsigned long addr`` The virtual address tied to a page returned from __get_free_pages(). h](j)}(h``unsigned long addr``h]jS)}(hjt8h]hunsigned long addr}(hjv8hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjr8ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhjn8ubj)}(hhh]jM)}(hDThe virtual address tied to a page returned from __get_free_pages().h]hDThe virtual address tied to a page returned from __get_free_pages().}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj8hMhj8ubah}(h]h ]h"]h$]h&]uh1jhjn8ubeh}(h]h ]h"]h$]h&]uh1jhj8hMhjk8ubj)}(h4``unsigned int order`` The order of the allocation. h](j)}(h``unsigned int order``h]jS)}(hj8h]hunsigned int order}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj8ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj8ubj)}(hhh]jM)}(hThe order of the allocation.h]hThe order of the allocation.}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj8hMhj8ubah}(h]h ]h"]h$]h&]uh1jhj8ubeh}(h]h ]h"]h$]h&]uh1jhj8hMhjk8ubeh}(h]h ]h"]h$]h&]uh1jhjO8ubjM)}(h**Description**h]j)}(hj8h]h Description}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj8ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhjO8ubjM)}(hThis function behaves the same as __free_pages(). Use this function to free pages when you only have a valid virtual address. If you have the page, call __free_pages() instead.h]hThis function behaves the same as __free_pages(). Use this function to free pages when you only have a valid virtual address. If you have the page, call __free_pages() instead.}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhjO8ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](halloc_pages_exact (C function)c.alloc_pages_exacthNtauh1hhjKhhhNhNubh)}(hhh](h)}(h6void * alloc_pages_exact (size_t size, gfp_t gfp_mask)h]h)}(h4void *alloc_pages_exact(size_t size, gfp_t gfp_mask)h](j)}(hvoidh]hvoid}(hj-9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)9hhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMubj)}(h h]h }(hj<9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)9hhhj;9hMubjr)}(hjuh]h*}(hjJ9hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj)9hhhj;9hMubh)}(halloc_pages_exacth]j)}(halloc_pages_exacth]halloc_pages_exact}(hj[9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjW9ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj)9hhhj;9hMubj8)}(h(size_t size, gfp_t gfp_mask)h](j>)}(h size_t sizeh](h)}(hhh]j)}(hsize_th]hsize_t}(hjz9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjw9ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj|9modnameN classnameNjj)}j]j)}jj]9sbc.alloc_pages_exactasbuh1hhjs9ubj)}(h h]h }(hj9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjs9ubj)}(hsizeh]hsize}(hj9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjs9ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjo9ubj>)}(hgfp_t gfp_maskh](h)}(hhh]j)}(hgfp_th]hgfp_t}(hj9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj9modnameN classnameNjj)}j]j9c.alloc_pages_exactasbuh1hhj9ubj)}(h h]h }(hj9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9ubj)}(hgfp_maskh]hgfp_mask}(hj9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjo9ubeh}(h]h ]h"]h$]h&]jjuh1j7hj)9hhhj;9hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj%9hhhj;9hMubah}(h]j 9ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj;9hMhj"9hhubj4)}(hhh]jM)}(h5allocate an exact number physically-contiguous pages.h]h5allocate an exact number physically-contiguous pages.}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj:hhubah}(h]h ]h"]h$]h&]uh1j3hj"9hhhj;9hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj2:jHj2:jIjJjKuh1hhhhjKhNhNubj)}(hX **Parameters** ``size_t size`` the number of bytes to allocate ``gfp_t gfp_mask`` GFP flags for the allocation, must not contain __GFP_COMP **Description** This function is similar to alloc_pages(), except that it allocates the minimum number of pages to satisfy the request. alloc_pages() can only allocate memory in power-of-two pages. This function is also limited by MAX_PAGE_ORDER. Memory allocated by this function must be released by free_pages_exact(). **Return** pointer to the allocated area or ``NULL`` in case of error.h](jM)}(h**Parameters**h]j)}(hj<:h]h Parameters}(hj>:hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj::ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj6:ubj)}(hhh](j)}(h0``size_t size`` the number of bytes to allocate h](j)}(h``size_t size``h]jS)}(hj[:h]h size_t size}(hj]:hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjY:ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhjU:ubj)}(hhh]jM)}(hthe number of bytes to allocateh]hthe number of bytes to allocate}(hjt:hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjp:hMhjq:ubah}(h]h ]h"]h$]h&]uh1jhjU:ubeh}(h]h ]h"]h$]h&]uh1jhjp:hMhjR:ubj)}(hM``gfp_t gfp_mask`` GFP flags for the allocation, must not contain __GFP_COMP h](j)}(h``gfp_t gfp_mask``h]jS)}(hj:h]hgfp_t gfp_mask}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj:ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj:ubj)}(hhh]jM)}(h9GFP flags for the allocation, must not contain __GFP_COMPh]h9GFP flags for the allocation, must not contain __GFP_COMP}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj:hMhj:ubah}(h]h ]h"]h$]h&]uh1jhj:ubeh}(h]h ]h"]h$]h&]uh1jhj:hMhjR:ubeh}(h]h ]h"]h$]h&]uh1jhj6:ubjM)}(h**Description**h]j)}(hj:h]h Description}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj:ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj6:ubjM)}(hThis function is similar to alloc_pages(), except that it allocates the minimum number of pages to satisfy the request. alloc_pages() can only allocate memory in power-of-two pages.h]hThis function is similar to alloc_pages(), except that it allocates the minimum number of pages to satisfy the request. alloc_pages() can only allocate memory in power-of-two pages.}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj6:ubjM)}(h0This function is also limited by MAX_PAGE_ORDER.h]h0This function is also limited by MAX_PAGE_ORDER.}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj6:ubjM)}(hIMemory allocated by this function must be released by free_pages_exact().h]hIMemory allocated by this function must be released by free_pages_exact().}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj6:ubjM)}(h **Return**h]j)}(hj;h]hReturn}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj;ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj6:ubjM)}(h;pointer to the allocated area or ``NULL`` in case of error.h](h!pointer to the allocated area or }(hj*;hhhNhNubjS)}(h``NULL``h]hNULL}(hj2;hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj*;ubh in case of error.}(hj*;hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj6:ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h"alloc_pages_exact_nid (C function)c.alloc_pages_exact_nidhNtauh1hhjKhhhNhNubh)}(hhh](h)}(hCvoid * alloc_pages_exact_nid (int nid, size_t size, gfp_t gfp_mask)h]h)}(hAvoid *alloc_pages_exact_nid(int nid, size_t size, gfp_t gfp_mask)h](j)}(hvoidh]hvoid}(hjk;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjg;hhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMubj)}(h h]h }(hjz;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjg;hhhjy;hMubjr)}(hjuh]h*}(hj;hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjg;hhhjy;hMubh)}(halloc_pages_exact_nidh]j)}(halloc_pages_exact_nidh]halloc_pages_exact_nid}(hj;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjg;hhhjy;hMubj8)}(h&(int nid, size_t size, gfp_t gfp_mask)h](j>)}(hint nidh](j)}(hinth]hint}(hj;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;ubj)}(h h]h }(hj;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;ubj)}(hnidh]hnid}(hj;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj;ubj>)}(h size_t sizeh](h)}(hhh]j)}(hsize_th]hsize_t}(hj;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj;modnameN classnameNjj)}j]j)}jj;sbc.alloc_pages_exact_nidasbuh1hhj;ubj)}(h h]h }(hj <hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;ubj)}(hsizeh]hsize}(hj<hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj;ubj>)}(hgfp_t gfp_maskh](h)}(hhh]j)}(hgfp_th]hgfp_t}(hj7<hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4<ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj9<modnameN classnameNjj)}j]j <c.alloc_pages_exact_nidasbuh1hhj0<ubj)}(h h]h }(hjU<hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0<ubj)}(hgfp_maskh]hgfp_mask}(hjc<hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0<ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj;ubeh}(h]h ]h"]h$]h&]jjuh1j7hjg;hhhjy;hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjc;hhhjy;hMubah}(h]j^;ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjy;hMhj`;hhubj4)}(hhh]jM)}(hBallocate an exact number of physically-contiguous pages on a node.h]hBallocate an exact number of physically-contiguous pages on a node.}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj<hhubah}(h]h ]h"]h$]h&]uh1j3hj`;hhhjy;hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj<jHj<jIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``int nid`` the preferred node ID where memory should be allocated ``size_t size`` the number of bytes to allocate ``gfp_t gfp_mask`` GFP flags for the allocation, must not contain __GFP_COMP **Description** Like alloc_pages_exact(), but try to allocate on node nid first before falling back. **Return** pointer to the allocated area or ``NULL`` in case of error.h](jM)}(h**Parameters**h]j)}(hj<h]h Parameters}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj<ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj<ubj)}(hhh](j)}(hC``int nid`` the preferred node ID where memory should be allocated h](j)}(h ``int nid``h]jS)}(hj<h]hint nid}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj<ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj<ubj)}(hhh]jM)}(h6the preferred node ID where memory should be allocatedh]h6the preferred node ID where memory should be allocated}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj<hMhj<ubah}(h]h ]h"]h$]h&]uh1jhj<ubeh}(h]h ]h"]h$]h&]uh1jhj<hMhj<ubj)}(h0``size_t size`` the number of bytes to allocate h](j)}(h``size_t size``h]jS)}(hj=h]h size_t size}(hj =hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj=ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj=ubj)}(hhh]jM)}(hthe number of bytes to allocateh]hthe number of bytes to allocate}(hj =hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj=hMhj=ubah}(h]h ]h"]h$]h&]uh1jhj=ubeh}(h]h ]h"]h$]h&]uh1jhj=hMhj<ubj)}(hM``gfp_t gfp_mask`` GFP flags for the allocation, must not contain __GFP_COMP h](j)}(h``gfp_t gfp_mask``h]jS)}(hj@=h]hgfp_t gfp_mask}(hjB=hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj>=ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj:=ubj)}(hhh]jM)}(h9GFP flags for the allocation, must not contain __GFP_COMPh]h9GFP flags for the allocation, must not contain __GFP_COMP}(hjY=hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjU=hMhjV=ubah}(h]h ]h"]h$]h&]uh1jhj:=ubeh}(h]h ]h"]h$]h&]uh1jhjU=hMhj<ubeh}(h]h ]h"]h$]h&]uh1jhj<ubjM)}(h**Description**h]j)}(hj{=h]h Description}(hj}=hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjy=ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj<ubjM)}(hTLike alloc_pages_exact(), but try to allocate on node nid first before falling back.h]hTLike alloc_pages_exact(), but try to allocate on node nid first before falling back.}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj<ubjM)}(h **Return**h]j)}(hj=h]hReturn}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj=ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj<ubjM)}(h;pointer to the allocated area or ``NULL`` in case of error.h](h!pointer to the allocated area or }(hj=hhhNhNubjS)}(h``NULL``h]hNULL}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj=ubh in case of error.}(hj=hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chM hj<ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfree_pages_exact (C function)c.free_pages_exacthNtauh1hhjKhhhNhNubh)}(hhh](h)}(h/void free_pages_exact (void *virt, size_t size)h]h)}(h.void free_pages_exact(void *virt, size_t size)h](j)}(hvoidh]hvoid}(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=hhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chM1ubj)}(h h]h }(hj>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=hhhj>hM1ubh)}(hfree_pages_exacth]j)}(hfree_pages_exacth]hfree_pages_exact}(hj>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj=hhhj>hM1ubj8)}(h(void *virt, size_t size)h](j>)}(h void *virth](j)}(hvoidh]hvoid}(hj6>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2>ubj)}(h h]h }(hjD>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2>ubjr)}(hjuh]h*}(hjR>hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj2>ubj)}(hvirth]hvirt}(hj_>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2>ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj.>ubj>)}(h size_t sizeh](h)}(hhh]j)}(hsize_th]hsize_t}(hj{>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjx>ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj}>modnameN classnameNjj)}j]j)}jj>sbc.free_pages_exactasbuh1hhjt>ubj)}(h h]h }(hj>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjt>ubj)}(hsizeh]hsize}(hj>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjt>ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj.>ubeh}(h]h ]h"]h$]h&]jjuh1j7hj=hhhj>hM1ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj=hhhj>hM1ubah}(h]j=ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj>hM1hj=hhubj4)}(hhh]jM)}(h0release memory allocated via alloc_pages_exact()h]h0release memory allocated via alloc_pages_exact()}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chM1hj>hhubah}(h]h ]h"]h$]h&]uh1j3hj=hhhj>hM1ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj>jHj>jIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``void *virt`` the value returned by alloc_pages_exact. ``size_t size`` size of allocation, same value as passed to alloc_pages_exact(). **Description** Release the memory allocated by a previous call to alloc_pages_exact.h](jM)}(h**Parameters**h]j)}(hj>h]h Parameters}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj>ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chM5hj>ubj)}(hhh](j)}(h8``void *virt`` the value returned by alloc_pages_exact. h](j)}(h``void *virt``h]jS)}(hj?h]h void *virt}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj?ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chM2hj?ubj)}(hhh]jM)}(h(the value returned by alloc_pages_exact.h]h(the value returned by alloc_pages_exact.}(hj-?hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj)?hM2hj*?ubah}(h]h ]h"]h$]h&]uh1jhj?ubeh}(h]h ]h"]h$]h&]uh1jhj)?hM2hj ?ubj)}(hQ``size_t size`` size of allocation, same value as passed to alloc_pages_exact(). h](j)}(h``size_t size``h]jS)}(hjM?h]h size_t size}(hjO?hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjK?ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chM3hjG?ubj)}(hhh]jM)}(h@size of allocation, same value as passed to alloc_pages_exact().h]h@size of allocation, same value as passed to alloc_pages_exact().}(hjf?hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjb?hM3hjc?ubah}(h]h ]h"]h$]h&]uh1jhjG?ubeh}(h]h ]h"]h$]h&]uh1jhjb?hM3hj ?ubeh}(h]h ]h"]h$]h&]uh1jhj>ubjM)}(h**Description**h]j)}(hj?h]h Description}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj?ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chM5hj>ubjM)}(hERelease the memory allocated by a previous call to alloc_pages_exact.h]hERelease the memory allocated by a previous call to alloc_pages_exact.}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chM4hj>ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hnr_free_zone_pages (C function)c.nr_free_zone_pageshNtauh1hhjKhhhNhNubh)}(hhh](h)}(h-unsigned long nr_free_zone_pages (int offset)h]h)}(h,unsigned long nr_free_zone_pages(int offset)h](j)}(hunsignedh]hunsigned}(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?hhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMDubj)}(h h]h }(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?hhhj?hMDubj)}(hlongh]hlong}(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?hhhj?hMDubj)}(h h]h }(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?hhhj?hMDubh)}(hnr_free_zone_pagesh]j)}(hnr_free_zone_pagesh]hnr_free_zone_pages}(hj @hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj?hhhj?hMDubj8)}(h (int offset)h]j>)}(h int offseth](j)}(hinth]hint}(hj&@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"@ubj)}(h h]h }(hj4@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"@ubj)}(hoffseth]hoffset}(hjB@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"@ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj@ubah}(h]h ]h"]h$]h&]jjuh1j7hj?hhhj?hMDubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj?hhhj?hMDubah}(h]j?ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj?hMDhj?hhubj4)}(hhh]jM)}(h+count number of pages beyond high watermarkh]h+count number of pages beyond high watermark}(hjl@hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMDhji@hhubah}(h]h ]h"]h$]h&]uh1j3hj?hhhj?hMDubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj@jHj@jIjJjKuh1hhhhjKhNhNubj)}(hXy**Parameters** ``int offset`` The zone index of the highest zone **Description** nr_free_zone_pages() counts the number of pages which are beyond the high watermark within all zones at or below a given zone index. For each zone, the number of pages is calculated as: nr_free_zone_pages = managed_pages - high_pages **Return** number of pages beyond high watermark.h](jM)}(h**Parameters**h]j)}(hj@h]h Parameters}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj@ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMHhj@ubj)}(hhh]j)}(h2``int offset`` The zone index of the highest zone h](j)}(h``int offset``h]jS)}(hj@h]h int offset}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj@ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMEhj@ubj)}(hhh]jM)}(h"The zone index of the highest zoneh]h"The zone index of the highest zone}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj@hMEhj@ubah}(h]h ]h"]h$]h&]uh1jhj@ubeh}(h]h ]h"]h$]h&]uh1jhj@hMEhj@ubah}(h]h ]h"]h$]h&]uh1jhj@ubjM)}(h**Description**h]j)}(hj@h]h Description}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj@ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMGhj@ubjM)}(hnr_free_zone_pages() counts the number of pages which are beyond the high watermark within all zones at or below a given zone index. For each zone, the number of pages is calculated as:h]hnr_free_zone_pages() counts the number of pages which are beyond the high watermark within all zones at or below a given zone index. For each zone, the number of pages is calculated as:}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMFhj@ubji)}(h0nr_free_zone_pages = managed_pages - high_pages h]jM)}(h/nr_free_zone_pages = managed_pages - high_pagesh]h/nr_free_zone_pages = managed_pages - high_pages}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMJhj Aubah}(h]h ]h"]h$]h&]uh1jhhjAhMJhj@ubjM)}(h **Return**h]j)}(hj(Ah]hReturn}(hj*AhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj&Aubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMLhj@ubjM)}(h&number of pages beyond high watermark.h]h&number of pages beyond high watermark.}(hj>AhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMMhj@ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h!nr_free_buffer_pages (C function)c.nr_free_buffer_pageshNtauh1hhjKhhhNhNubh)}(hhh](h)}(h)unsigned long nr_free_buffer_pages (void)h]h)}(h(unsigned long nr_free_buffer_pages(void)h](j)}(hunsignedh]hunsigned}(hjmAhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjiAhhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMdubj)}(h h]h }(hj|AhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjiAhhhj{AhMdubj)}(hlongh]hlong}(hjAhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjiAhhhj{AhMdubj)}(h h]h }(hjAhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjiAhhhj{AhMdubh)}(hnr_free_buffer_pagesh]j)}(hnr_free_buffer_pagesh]hnr_free_buffer_pages}(hjAhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjAubah}(h]h ](jjeh"]h$]h&]jjuh1hhjiAhhhj{AhMdubj8)}(h(void)h]j>)}(hvoidh]j)}(hvoidh]hvoid}(hjAhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjAubah}(h]h ]h"]h$]h&]noemphjjuh1j=hjAubah}(h]h ]h"]h$]h&]jjuh1j7hjiAhhhj{AhMdubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjeAhhhj{AhMdubah}(h]j`Aah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj{AhMdhjbAhhubj4)}(hhh]jM)}(h+count number of pages beyond high watermarkh]h+count number of pages beyond high watermark}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMdhjAhhubah}(h]h ]h"]h$]h&]uh1j3hjbAhhhj{AhMdubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjBjHjBjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``void`` no arguments **Description** nr_free_buffer_pages() counts the number of pages which are beyond the high watermark within ZONE_DMA and ZONE_NORMAL. **Return** number of pages beyond high watermark within ZONE_DMA and ZONE_NORMAL.h](jM)}(h**Parameters**h]j)}(hjBh]h Parameters}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjBubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhhj Bubj)}(hhh]j)}(h``void`` no arguments h](j)}(h``void``h]jS)}(hj1Bh]hvoid}(hj3BhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj/Bubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chKhj+Bubj)}(hhh]jM)}(h no argumentsh]h no arguments}(hjJBhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjFBhKhjGBubah}(h]h ]h"]h$]h&]uh1jhj+Bubeh}(h]h ]h"]h$]h&]uh1jhjFBhKhj(Bubah}(h]h ]h"]h$]h&]uh1jhj BubjM)}(h**Description**h]j)}(hjlBh]h Description}(hjnBhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjjBubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chKhj BubjM)}(hvnr_free_buffer_pages() counts the number of pages which are beyond the high watermark within ZONE_DMA and ZONE_NORMAL.h]hvnr_free_buffer_pages() counts the number of pages which are beyond the high watermark within ZONE_DMA and ZONE_NORMAL.}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMehj BubjM)}(h **Return**h]j)}(hjBh]hReturn}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjBubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhhj BubjM)}(hFnumber of pages beyond high watermark within ZONE_DMA and ZONE_NORMAL.h]hFnumber of pages beyond high watermark within ZONE_DMA and ZONE_NORMAL.}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMihj Bubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h#find_next_best_node_in (C function)c.find_next_best_node_inhNtauh1hhjKhhhNhNubh)}(hhh](h)}(h_int find_next_best_node_in (int node, nodemask_t *used_node_mask, const nodemask_t *candidates)h]h)}(h^int find_next_best_node_in(int node, nodemask_t *used_node_mask, const nodemask_t *candidates)h](j)}(hinth]hint}(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBhhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMubj)}(h h]h }(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBhhhjBhMubh)}(hfind_next_best_node_inh]j)}(hfind_next_best_node_inh]hfind_next_best_node_in}(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubah}(h]h ](jjeh"]h$]h&]jjuh1hhjBhhhjBhMubj8)}(hD(int node, nodemask_t *used_node_mask, const nodemask_t *candidates)h](j>)}(hint nodeh](j)}(hinth]hint}(hjChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCubj)}(h h]h }(hj#ChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCubj)}(hnodeh]hnode}(hj1ChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj Cubj>)}(hnodemask_t *used_node_maskh](h)}(hhh]j)}(h nodemask_th]h nodemask_t}(hjMChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJCubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjOCmodnameN classnameNjj)}j]j)}jjBsbc.find_next_best_node_inasbuh1hhjFCubj)}(h h]h }(hjmChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFCubjr)}(hjuh]h*}(hj{ChhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjFCubj)}(hused_node_maskh]hused_node_mask}(hjChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFCubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj Cubj>)}(hconst nodemask_t *candidatesh](j)}(hjh]hconst}(hjChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCubj)}(h h]h }(hjChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCubh)}(hhh]j)}(h nodemask_th]h nodemask_t}(hjChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjCmodnameN classnameNjj)}j]jiCc.find_next_best_node_inasbuh1hhjCubj)}(h h]h }(hjChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCubjr)}(hjuh]h*}(hjChhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjCubj)}(h candidatesh]h candidates}(hjChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj Cubeh}(h]h ]h"]h$]h&]jjuh1j7hjBhhhjBhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjBhhhjBhMubah}(h]jBah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjBhMhjBhhubj4)}(hhh]jM)}(hEfind the next node that should appear in a given node's fallback listh]hGfind the next node that should appear in a given node’s fallback list}(hj"DhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhjDhhubah}(h]h ]h"]h$]h&]uh1j3hjBhhhjBhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj:DjHj:DjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``int node`` node whose fallback list we're appending ``nodemask_t *used_node_mask`` nodemask_t of already used nodes ``const nodemask_t *candidates`` nodemask_t of nodes eligible for selection **Description** We use a number of factors to determine which is the next node that should appear on a given node's fallback list. The node should not have appeared already in **node**'s fallback list, and it should be the next closest node according to the distance array (which contains arbitrary distance values from each node to each node in the system), and should also prefer nodes with no CPUs, since presumably they'll have very little allocation pressure on them otherwise. **Return** node id of the found node or ``NUMA_NO_NODE`` if no node is found.h](jM)}(h**Parameters**h]j)}(hjDDh]h Parameters}(hjFDhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjBDubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj>Dubj)}(hhh](j)}(h6``int node`` node whose fallback list we're appending h](j)}(h ``int node``h]jS)}(hjcDh]hint node}(hjeDhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjaDubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj]Dubj)}(hhh]jM)}(h(node whose fallback list we're appendingh]h*node whose fallback list we’re appending}(hj|DhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjxDhMhjyDubah}(h]h ]h"]h$]h&]uh1jhj]Dubeh}(h]h ]h"]h$]h&]uh1jhjxDhMhjZDubj)}(h@``nodemask_t *used_node_mask`` nodemask_t of already used nodes h](j)}(h``nodemask_t *used_node_mask``h]jS)}(hjDh]hnodemask_t *used_node_mask}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjDubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhjDubj)}(hhh]jM)}(h nodemask_t of already used nodesh]h nodemask_t of already used nodes}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjDhMhjDubah}(h]h ]h"]h$]h&]uh1jhjDubeh}(h]h ]h"]h$]h&]uh1jhjDhMhjZDubj)}(hL``const nodemask_t *candidates`` nodemask_t of nodes eligible for selection h](j)}(h ``const nodemask_t *candidates``h]jS)}(hjDh]hconst nodemask_t *candidates}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjDubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhjDubj)}(hhh]jM)}(h*nodemask_t of nodes eligible for selectionh]h*nodemask_t of nodes eligible for selection}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjDhMhjDubah}(h]h ]h"]h$]h&]uh1jhjDubeh}(h]h ]h"]h$]h&]uh1jhjDhMhjZDubeh}(h]h ]h"]h$]h&]uh1jhj>DubjM)}(h**Description**h]j)}(hjEh]h Description}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjEubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj>DubjM)}(hXWe use a number of factors to determine which is the next node that should appear on a given node's fallback list. The node should not have appeared already in **node**'s fallback list, and it should be the next closest node according to the distance array (which contains arbitrary distance values from each node to each node in the system), and should also prefer nodes with no CPUs, since presumably they'll have very little allocation pressure on them otherwise.h](hWe use a number of factors to determine which is the next node that should appear on a given node’s fallback list. The node should not have appeared already in }(hj&EhhhNhNubj)}(h**node**h]hnode}(hj.EhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj&EubhX.’s fallback list, and it should be the next closest node according to the distance array (which contains arbitrary distance values from each node to each node in the system), and should also prefer nodes with no CPUs, since presumably they’ll have very little allocation pressure on them otherwise.}(hj&EhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj>DubjM)}(h **Return**h]j)}(hjIEh]hReturn}(hjKEhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjGEubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj>DubjM)}(hBnode id of the found node or ``NUMA_NO_NODE`` if no node is found.h](hnode id of the found node or }(hj_EhhhNhNubjS)}(h``NUMA_NO_NODE``h]h NUMA_NO_NODE}(hjgEhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj_Eubh if no node is found.}(hj_EhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj>Dubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h free_reserved_pages (C function)c.free_reserved_pageshNtauh1hhjKhhhNhNubh)}(hhh](h)}(h@void free_reserved_pages (struct page *page, unsigned int order)h]h)}(h?void free_reserved_pages(struct page *page, unsigned int order)h](j)}(hvoidh]hvoid}(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEhhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMubj)}(h h]h }(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEhhhjEhMubh)}(hfree_reserved_pagesh]j)}(hfree_reserved_pagesh]hfree_reserved_pages}(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEubah}(h]h ](jjeh"]h$]h&]jjuh1hhjEhhhjEhMubj8)}(h'(struct page *page, unsigned int order)h](j>)}(hstruct page *pageh](j)}(hjJ,h]hstruct}(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEubj)}(h h]h }(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEubh)}(hhh]j)}(hpageh]hpage}(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjEmodnameN classnameNjj)}j]j)}jjEsbc.free_reserved_pagesasbuh1hhjEubj)}(h h]h }(hjFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEubjr)}(hjuh]h*}(hj)FhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjEubj)}(hpageh]hpage}(hj6FhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjEubj>)}(hunsigned int orderh](j)}(hunsignedh]hunsigned}(hjOFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjKFubj)}(h h]h }(hj]FhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjKFubj)}(hinth]hint}(hjkFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjKFubj)}(h h]h }(hjyFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjKFubj)}(horderh]horder}(hjFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjKFubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjEubeh}(h]h ]h"]h$]h&]jjuh1j7hjEhhhjEhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjEhhhjEhMubah}(h]jEah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjEhMhjEhhubj4)}(hhh]jM)}(hfree reserved pagesh]hfree reserved pages}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhjFhhubah}(h]h ]h"]h$]h&]uh1j3hjEhhhjEhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjFjHjFjIjJjKuh1hhhhjKhNhNubj)}(hXX**Parameters** ``struct page *page`` First page to free. ``unsigned int order`` The page order to free. **Description** Free pages allocated through memblock during boot, letting the buddy manage them from now on. **page** must be naturally aligned to the order and the order must not exceed MAX_PAGE_ORDER. All pages must be reserved.h](jM)}(h**Parameters**h]j)}(hjFh]h Parameters}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjFubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chM!hjFubj)}(hhh](j)}(h*``struct page *page`` First page to free. h](j)}(h``struct page *page``h]jS)}(hjFh]hstruct page *page}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjFubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhjFubj)}(hhh]jM)}(hFirst page to free.h]hFirst page to free.}(hj GhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjGhMhjGubah}(h]h ]h"]h$]h&]uh1jhjFubeh}(h]h ]h"]h$]h&]uh1jhjGhMhjFubj)}(h/``unsigned int order`` The page order to free. h](j)}(h``unsigned int order``h]jS)}(hj+Gh]hunsigned int order}(hj-GhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj)Gubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj%Gubj)}(hhh]jM)}(hThe page order to free.h]hThe page order to free.}(hjDGhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj@GhMhjAGubah}(h]h ]h"]h$]h&]uh1jhj%Gubeh}(h]h ]h"]h$]h&]uh1jhj@GhMhjFubeh}(h]h ]h"]h$]h&]uh1jhjFubjM)}(h**Description**h]j)}(hjfGh]h Description}(hjhGhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjdGubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chM!hjFubjM)}(h]Free pages allocated through memblock during boot, letting the buddy manage them from now on.h]h]Free pages allocated through memblock during boot, letting the buddy manage them from now on.}(hj|GhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chM hjFubjM)}(hy**page** must be naturally aligned to the order and the order must not exceed MAX_PAGE_ORDER. All pages must be reserved.h](j)}(h**page**h]hpage}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjGubhq must be naturally aligned to the order and the order must not exceed MAX_PAGE_ORDER. All pages must be reserved.}(hjGhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chM#hjFubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h"setup_per_zone_wmarks (C function)c.setup_per_zone_wmarkshNtauh1hhjKhhhNhNubh)}(hhh](h)}(h!void setup_per_zone_wmarks (void)h]h)}(h void setup_per_zone_wmarks(void)h](j)}(hvoidh]hvoid}(hjGhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGhhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMubj)}(h h]h }(hjGhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGhhhjGhMubh)}(hsetup_per_zone_wmarksh]j)}(hsetup_per_zone_wmarksh]hsetup_per_zone_wmarks}(hjGhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGubah}(h]h ](jjeh"]h$]h&]jjuh1hhjGhhhjGhMubj8)}(h(void)h]j>)}(hvoidh]j)}(hvoidh]hvoid}(hjHhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHubah}(h]h ]h"]h$]h&]noemphjjuh1j=hjGubah}(h]h ]h"]h$]h&]jjuh1j7hjGhhhjGhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjGhhhjGhMubah}(h]jGah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjGhMhjGhhubj4)}(hhh]jM)}(hIcalled when min_free_kbytes changes or when memory is hot-{added|removed}h]hIcalled when min_free_kbytes changes or when memory is hot-{added|removed}}(hj/HhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj,Hhhubah}(h]h ]h"]h$]h&]uh1j3hjGhhhjGhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjGHjHjGHjIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``void`` no arguments **Description** Ensures that the watermark[min,low,high] values for each zone are set correctly with respect to min_free_kbytes.h](jM)}(h**Parameters**h]j)}(hjQHh]h Parameters}(hjSHhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjOHubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhjKHubj)}(hhh]j)}(h``void`` no arguments h](j)}(h``void``h]jS)}(hjpHh]hvoid}(hjrHhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjnHubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chKhjjHubj)}(hhh]jM)}(h no argumentsh]h no arguments}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjHhKhjHubah}(h]h ]h"]h$]h&]uh1jhjjHubeh}(h]h ]h"]h$]h&]uh1jhjHhKhjgHubah}(h]h ]h"]h$]h&]uh1jhjKHubjM)}(h**Description**h]j)}(hjHh]h Description}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjHubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chKhjKHubjM)}(hpEnsures that the watermark[min,low,high] values for each zone are set correctly with respect to min_free_kbytes.h]hpEnsures that the watermark[min,low,high] values for each zone are set correctly with respect to min_free_kbytes.}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhjKHubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h __free_contig_range (C function)c.__free_contig_rangehNtauh1hhjKhhhNhNubh)}(hhh](h)}(hDvoid __free_contig_range (unsigned long pfn, unsigned long nr_pages)h]h)}(hCvoid __free_contig_range(unsigned long pfn, unsigned long nr_pages)h](j)}(hvoidh]hvoid}(hjHhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHhhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMubj)}(h h]h }(hjHhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHhhhjHhMubh)}(h__free_contig_rangeh]j)}(h__free_contig_rangeh]h__free_contig_range}(hjIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj Iubah}(h]h ](jjeh"]h$]h&]jjuh1hhjHhhhjHhMubj8)}(h+(unsigned long pfn, unsigned long nr_pages)h](j>)}(hunsigned long pfnh](j)}(hunsignedh]hunsigned}(hj-IhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)Iubj)}(h h]h }(hj;IhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)Iubj)}(hlongh]hlong}(hjIIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)Iubj)}(h h]h }(hjWIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)Iubj)}(hpfnh]hpfn}(hjeIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)Iubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj%Iubj>)}(hunsigned long nr_pagesh](j)}(hunsignedh]hunsigned}(hj~IhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjzIubj)}(h h]h }(hjIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjzIubj)}(hlongh]hlong}(hjIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjzIubj)}(h h]h }(hjIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjzIubj)}(hnr_pagesh]hnr_pages}(hjIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjzIubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj%Iubeh}(h]h ]h"]h$]h&]jjuh1j7hjHhhhjHhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjHhhhjHhMubah}(h]jHah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjHhMhjHhhubj4)}(hhh]jM)}(h'Free contiguous range of order-0 pages.h]h'Free contiguous range of order-0 pages.}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhjIhhubah}(h]h ]h"]h$]h&]uh1j3hjHhhhjHhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjIjHjIjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``unsigned long pfn`` Page frame number of the first page in the range. ``unsigned long nr_pages`` Number of pages to free. **Description** For each order-0 struct page in the physically contiguous range, put a reference. Free any page who's reference count falls to zero. The implementation is functionally equivalent to, but significantly faster than calling __free_page() for each struct page in a loop. Memory allocated with alloc_pages(order>=1) then subsequently split to order-0 with split_page() is an example of appropriate contiguous pages that can be freed with this API. **Context** May be called in interrupt context or while holding a normal spinlock, but not in NMI context or while holding a raw spinlock.h](jM)}(h**Parameters**h]j)}(hjJh]h Parameters}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjJubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhjIubj)}(hhh](j)}(hH``unsigned long pfn`` Page frame number of the first page in the range. h](j)}(h``unsigned long pfn``h]jS)}(hj!Jh]hunsigned long pfn}(hj#JhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjJubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhjJubj)}(hhh]jM)}(h1Page frame number of the first page in the range.h]h1Page frame number of the first page in the range.}(hj:JhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj6JhMhj7Jubah}(h]h ]h"]h$]h&]uh1jhjJubeh}(h]h ]h"]h$]h&]uh1jhj6JhMhjJubj)}(h4``unsigned long nr_pages`` Number of pages to free. h](j)}(h``unsigned long nr_pages``h]jS)}(hjZJh]hunsigned long nr_pages}(hj\JhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjXJubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhjTJubj)}(hhh]jM)}(hNumber of pages to free.h]hNumber of pages to free.}(hjsJhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjoJhMhjpJubah}(h]h ]h"]h$]h&]uh1jhjTJubeh}(h]h ]h"]h$]h&]uh1jhjoJhMhjJubeh}(h]h ]h"]h$]h&]uh1jhjIubjM)}(h**Description**h]j)}(hjJh]h Description}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjJubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhjIubjM)}(hX For each order-0 struct page in the physically contiguous range, put a reference. Free any page who's reference count falls to zero. The implementation is functionally equivalent to, but significantly faster than calling __free_page() for each struct page in a loop.h]hX For each order-0 struct page in the physically contiguous range, put a reference. Free any page who’s reference count falls to zero. The implementation is functionally equivalent to, but significantly faster than calling __free_page() for each struct page in a loop.}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhjIubjM)}(hMemory allocated with alloc_pages(order>=1) then subsequently split to order-0 with split_page() is an example of appropriate contiguous pages that can be freed with this API.h]hMemory allocated with alloc_pages(order>=1) then subsequently split to order-0 with split_page() is an example of appropriate contiguous pages that can be freed with this API.}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhjIubjM)}(h **Context**h]j)}(hjJh]hContext}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjJubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhjIubjM)}(h~May be called in interrupt context or while holding a normal spinlock, but not in NMI context or while holding a raw spinlock.h]h~May be called in interrupt context or while holding a normal spinlock, but not in NMI context or while holding a raw spinlock.}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhjIubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h&alloc_contig_frozen_range (C function)c.alloc_contig_frozen_rangehNtauh1hhjKhhhNhNubh)}(hhh](h)}(hoint alloc_contig_frozen_range (unsigned long start, unsigned long end, acr_flags_t alloc_flags, gfp_t gfp_mask)h]h)}(hnint alloc_contig_frozen_range(unsigned long start, unsigned long end, acr_flags_t alloc_flags, gfp_t gfp_mask)h](j)}(hinth]hint}(hjKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj KhhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMSubj)}(h h]h }(hjKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj KhhhjKhMSubh)}(halloc_contig_frozen_rangeh]j)}(halloc_contig_frozen_rangeh]halloc_contig_frozen_range}(hj1KhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-Kubah}(h]h ](jjeh"]h$]h&]jjuh1hhj KhhhjKhMSubj8)}(hQ(unsigned long start, unsigned long end, acr_flags_t alloc_flags, gfp_t gfp_mask)h](j>)}(hunsigned long starth](j)}(hunsignedh]hunsigned}(hjMKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIKubj)}(h h]h }(hj[KhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIKubj)}(hlongh]hlong}(hjiKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIKubj)}(h h]h }(hjwKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIKubj)}(hstarth]hstart}(hjKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIKubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjEKubj>)}(hunsigned long endh](j)}(hunsignedh]hunsigned}(hjKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjKubj)}(h h]h }(hjKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjKubj)}(hlongh]hlong}(hjKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjKubj)}(h h]h }(hjKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjKubj)}(hendh]hend}(hjKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjKubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjEKubj>)}(hacr_flags_t alloc_flagsh](h)}(hhh]j)}(h acr_flags_th]h acr_flags_t}(hjKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjKubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjKmodnameN classnameNjj)}j]j)}jj3Ksbc.alloc_contig_frozen_rangeasbuh1hhjKubj)}(h h]h }(hjLhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjKubj)}(h alloc_flagsh]h alloc_flags}(hj LhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjKubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjEKubj>)}(hgfp_t gfp_maskh](h)}(hhh]j)}(hgfp_th]hgfp_t}(hjLmodnameN classnameNjj)}j]jLc.alloc_contig_frozen_rangeasbuh1hhj5Lubj)}(h h]h }(hjZLhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5Lubj)}(hgfp_maskh]hgfp_mask}(hjhLhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5Lubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjEKubeh}(h]h ]h"]h$]h&]jjuh1j7hj KhhhjKhMSubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjKhhhjKhMSubah}(h]jKah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjKhMShjKhhubj4)}(hhh]j^)}(hhh]jc)}(h-tries to allocate given range of frozen pagesh]jM)}(hjLh]h-tries to allocate given range of frozen pages}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMShjLubah}(h]h ]h"]h$]h&]uh1jbhjLhhhjLhNubah}(h]h ]h"]h$]h&]jjuh1j]hjLhMShjLhhubah}(h]h ]h"]h$]h&]uh1j3hjKhhhjKhMSubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjLjHjLjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``unsigned long start`` start PFN to allocate ``unsigned long end`` one-past-the-last PFN to allocate ``acr_flags_t alloc_flags`` allocation information ``gfp_t gfp_mask`` GFP mask. Node/zone/placement hints are ignored; only some action and reclaim modifiers are supported. Reclaim modifiers control allocation behavior during compaction/migration/reclaim. **Description** The PFN range does not have to be pageblock aligned. The PFN range must belong to a single zone. The first thing this routine does is attempt to MIGRATE_ISOLATE all pageblocks in the range. Once isolated, the pageblocks should not be modified by others. All frozen pages which PFN is in [start, end) are allocated for the caller, and they could be freed with free_contig_frozen_range(), free_frozen_pages() also could be used to free compound frozen pages directly. **Return** zero on success or negative error code.h](jM)}(h**Parameters**h]j)}(hjLh]h Parameters}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjLubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMWhjLubj)}(hhh](j)}(h.``unsigned long start`` start PFN to allocate h](j)}(h``unsigned long start``h]jS)}(hjLh]hunsigned long start}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjLubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMThjLubj)}(hhh]jM)}(hstart PFN to allocateh]hstart PFN to allocate}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjLhMThjLubah}(h]h ]h"]h$]h&]uh1jhjLubeh}(h]h ]h"]h$]h&]uh1jhjLhMThjLubj)}(h8``unsigned long end`` one-past-the-last PFN to allocate h](j)}(h``unsigned long end``h]jS)}(hjMh]hunsigned long end}(hj MhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjMubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMUhjMubj)}(hhh]jM)}(h!one-past-the-last PFN to allocateh]h!one-past-the-last PFN to allocate}(hj7MhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj3MhMUhj4Mubah}(h]h ]h"]h$]h&]uh1jhjMubeh}(h]h ]h"]h$]h&]uh1jhj3MhMUhjLubj)}(h3``acr_flags_t alloc_flags`` allocation information h](j)}(h``acr_flags_t alloc_flags``h]jS)}(hjWMh]hacr_flags_t alloc_flags}(hjYMhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjUMubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMVhjQMubj)}(hhh]jM)}(hallocation informationh]hallocation information}(hjpMhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjlMhMVhjmMubah}(h]h ]h"]h$]h&]uh1jhjQMubeh}(h]h ]h"]h$]h&]uh1jhjlMhMVhjLubj)}(h``gfp_t gfp_mask`` GFP mask. Node/zone/placement hints are ignored; only some action and reclaim modifiers are supported. Reclaim modifiers control allocation behavior during compaction/migration/reclaim. h](j)}(h``gfp_t gfp_mask``h]jS)}(hjMh]hgfp_t gfp_mask}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjMubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMYhjMubj)}(hhh]jM)}(hGFP mask. Node/zone/placement hints are ignored; only some action and reclaim modifiers are supported. Reclaim modifiers control allocation behavior during compaction/migration/reclaim.h]hGFP mask. Node/zone/placement hints are ignored; only some action and reclaim modifiers are supported. Reclaim modifiers control allocation behavior during compaction/migration/reclaim.}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMWhjMubah}(h]h ]h"]h$]h&]uh1jhjMubeh}(h]h ]h"]h$]h&]uh1jhjMhMYhjLubeh}(h]h ]h"]h$]h&]uh1jhjLubjM)}(h**Description**h]j)}(hjMh]h Description}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjMubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chM[hjLubjM)}(h`The PFN range does not have to be pageblock aligned. The PFN range must belong to a single zone.h]h`The PFN range does not have to be pageblock aligned. The PFN range must belong to a single zone.}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMZhjLubjM)}(hThe first thing this routine does is attempt to MIGRATE_ISOLATE all pageblocks in the range. Once isolated, the pageblocks should not be modified by others.h]hThe first thing this routine does is attempt to MIGRATE_ISOLATE all pageblocks in the range. Once isolated, the pageblocks should not be modified by others.}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chM]hjLubjM)}(hAll frozen pages which PFN is in [start, end) are allocated for the caller, and they could be freed with free_contig_frozen_range(), free_frozen_pages() also could be used to free compound frozen pages directly.h]hAll frozen pages which PFN is in [start, end) are allocated for the caller, and they could be freed with free_contig_frozen_range(), free_frozen_pages() also could be used to free compound frozen pages directly.}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMahjLubjM)}(h **Return**h]j)}(hjNh]hReturn}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMfhjLubjM)}(h'zero on success or negative error code.h]h'zero on success or negative error code.}(hj'NhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMghjLubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](halloc_contig_range (C function)c.alloc_contig_rangehNtauh1hhjKhhhNhNubh)}(hhh](h)}(hhint alloc_contig_range (unsigned long start, unsigned long end, acr_flags_t alloc_flags, gfp_t gfp_mask)h]h)}(hgint alloc_contig_range(unsigned long start, unsigned long end, acr_flags_t alloc_flags, gfp_t gfp_mask)h](j)}(hinth]hint}(hjVNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRNhhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMubj)}(h h]h }(hjeNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRNhhhjdNhMubh)}(halloc_contig_rangeh]j)}(halloc_contig_rangeh]halloc_contig_range}(hjwNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjsNubah}(h]h ](jjeh"]h$]h&]jjuh1hhjRNhhhjdNhMubj8)}(hQ(unsigned long start, unsigned long end, acr_flags_t alloc_flags, gfp_t gfp_mask)h](j>)}(hunsigned long starth](j)}(hunsignedh]hunsigned}(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubj)}(h h]h }(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubj)}(hlongh]hlong}(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubj)}(h h]h }(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubj)}(hstarth]hstart}(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjNubj>)}(hunsigned long endh](j)}(hunsignedh]hunsigned}(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubj)}(h h]h }(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubj)}(hlongh]hlong}(hjOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubj)}(h h]h }(hjOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubj)}(hendh]hend}(hjOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjNubj>)}(hacr_flags_t alloc_flagsh](h)}(hhh]j)}(h acr_flags_th]h acr_flags_t}(hj8OhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5Oubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj:OmodnameN classnameNjj)}j]j)}jjyNsbc.alloc_contig_rangeasbuh1hhj1Oubj)}(h h]h }(hjXOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj1Oubj)}(h alloc_flagsh]h alloc_flags}(hjfOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj1Oubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjNubj>)}(hgfp_t gfp_maskh](h)}(hhh]j)}(hgfp_th]hgfp_t}(hjOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjOubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjOmodnameN classnameNjj)}j]jTOc.alloc_contig_rangeasbuh1hhj{Oubj)}(h h]h }(hjOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{Oubj)}(hgfp_maskh]hgfp_mask}(hjOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{Oubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjNubeh}(h]h ]h"]h$]h&]jjuh1j7hjRNhhhjdNhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjNNhhhjdNhMubah}(h]jINah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjdNhMhjKNhhubj4)}(hhh]j^)}(hhh]jc)}(h&tries to allocate given range of pagesh]jM)}(hjOh]h&tries to allocate given range of pages}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhjOubah}(h]h ]h"]h$]h&]uh1jbhjOhhhjOhNubah}(h]h ]h"]h$]h&]jjuh1j]hjOhMhjOhhubah}(h]h ]h"]h$]h&]uh1j3hjKNhhhjdNhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjPjHjPjIjJjKuh1hhhhjKhNhNubj)}(hXj**Parameters** ``unsigned long start`` start PFN to allocate ``unsigned long end`` one-past-the-last PFN to allocate ``acr_flags_t alloc_flags`` allocation information ``gfp_t gfp_mask`` GFP mask. **Description** This routine is a wrapper around alloc_contig_frozen_range(), it can't be used to allocate compound pages, the refcount of each allocated page will be set to one. All pages which PFN is in [start, end) are allocated for the caller, and should be freed with free_contig_range() or by manually calling __free_page() on each allocated page. **Return** zero on success or negative error code.h](jM)}(h**Parameters**h]j)}(hj Ph]h Parameters}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj Pubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhjPubj)}(hhh](j)}(h.``unsigned long start`` start PFN to allocate h](j)}(h``unsigned long start``h]jS)}(hj+Ph]hunsigned long start}(hj-PhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj)Pubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj%Pubj)}(hhh]jM)}(hstart PFN to allocateh]hstart PFN to allocate}(hjDPhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj@PhMhjAPubah}(h]h ]h"]h$]h&]uh1jhj%Pubeh}(h]h ]h"]h$]h&]uh1jhj@PhMhj"Pubj)}(h8``unsigned long end`` one-past-the-last PFN to allocate h](j)}(h``unsigned long end``h]jS)}(hjdPh]hunsigned long end}(hjfPhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjbPubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj^Pubj)}(hhh]jM)}(h!one-past-the-last PFN to allocateh]h!one-past-the-last PFN to allocate}(hj}PhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjyPhMhjzPubah}(h]h ]h"]h$]h&]uh1jhj^Pubeh}(h]h ]h"]h$]h&]uh1jhjyPhMhj"Pubj)}(h3``acr_flags_t alloc_flags`` allocation information h](j)}(h``acr_flags_t alloc_flags``h]jS)}(hjPh]hacr_flags_t alloc_flags}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjPubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhjPubj)}(hhh]jM)}(hallocation informationh]hallocation information}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjPhMhjPubah}(h]h ]h"]h$]h&]uh1jhjPubeh}(h]h ]h"]h$]h&]uh1jhjPhMhj"Pubj)}(h``gfp_t gfp_mask`` GFP mask. h](j)}(h``gfp_t gfp_mask``h]jS)}(hjPh]hgfp_t gfp_mask}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjPubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhjPubj)}(hhh]jM)}(h GFP mask.h]h GFP mask.}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjPhMhjPubah}(h]h ]h"]h$]h&]uh1jhjPubeh}(h]h ]h"]h$]h&]uh1jhjPhMhj"Pubeh}(h]h ]h"]h$]h&]uh1jhjPubjM)}(h**Description**h]j)}(hjQh]h Description}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjQubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhjPubjM)}(hThis routine is a wrapper around alloc_contig_frozen_range(), it can't be used to allocate compound pages, the refcount of each allocated page will be set to one.h]hThis routine is a wrapper around alloc_contig_frozen_range(), it can’t be used to allocate compound pages, the refcount of each allocated page will be set to one.}(hj'QhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhjPubjM)}(hAll pages which PFN is in [start, end) are allocated for the caller, and should be freed with free_contig_range() or by manually calling __free_page() on each allocated page.h]hAll pages which PFN is in [start, end) are allocated for the caller, and should be freed with free_contig_range() or by manually calling __free_page() on each allocated page.}(hj6QhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhjPubjM)}(h **Return**h]j)}(hjGQh]hReturn}(hjIQhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjEQubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhjPubjM)}(h'zero on success or negative error code.h]h'zero on success or negative error code.}(hj]QhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhjPubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h&alloc_contig_frozen_pages (C function)c.alloc_contig_frozen_pageshNtauh1hhjKhhhNhNubh)}(hhh](h)}(hostruct page * alloc_contig_frozen_pages (unsigned long nr_pages, gfp_t gfp_mask, int nid, nodemask_t *nodemask)h]h)}(hmstruct page *alloc_contig_frozen_pages(unsigned long nr_pages, gfp_t gfp_mask, int nid, nodemask_t *nodemask)h](j)}(hjJ,h]hstruct}(hjQhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjQhhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMPubj)}(h h]h }(hjQhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjQhhhjQhMPubh)}(hhh]j)}(hpageh]hpage}(hjQhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjQubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjQmodnameN classnameNjj)}j]j)}jalloc_contig_frozen_pagessbc.alloc_contig_frozen_pagesasbuh1hhjQhhhjQhMPubj)}(h h]h }(hjQhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjQhhhjQhMPubjr)}(hjuh]h*}(hjQhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjQhhhjQhMPubh)}(halloc_contig_frozen_pagesh]j)}(hjQh]halloc_contig_frozen_pages}(hjQhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjQubah}(h]h ](jjeh"]h$]h&]jjuh1hhjQhhhjQhMPubj8)}(hG(unsigned long nr_pages, gfp_t gfp_mask, int nid, nodemask_t *nodemask)h](j>)}(hunsigned long nr_pagesh](j)}(hunsignedh]hunsigned}(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRubj)}(h h]h }(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRubj)}(hlongh]hlong}(hj"RhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRubj)}(h h]h }(hj0RhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRubj)}(hnr_pagesh]hnr_pages}(hj>RhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjQubj>)}(hgfp_t gfp_maskh](h)}(hhh]j)}(hgfp_th]hgfp_t}(hjZRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjWRubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj\RmodnameN classnameNjj)}j]jQc.alloc_contig_frozen_pagesasbuh1hhjSRubj)}(h h]h }(hjxRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSRubj)}(hgfp_maskh]hgfp_mask}(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSRubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjQubj>)}(hint nidh](j)}(hinth]hint}(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRubj)}(h h]h }(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRubj)}(hnidh]hnid}(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjQubj>)}(hnodemask_t *nodemaskh](h)}(hhh]j)}(h nodemask_th]h nodemask_t}(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjRmodnameN classnameNjj)}j]jQc.alloc_contig_frozen_pagesasbuh1hhjRubj)}(h h]h }(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRubjr)}(hjuh]h*}(hjShhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjRubj)}(hnodemaskh]hnodemask}(hjShhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjQubeh}(h]h ]h"]h$]h&]jjuh1j7hjQhhhjQhMPubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjQhhhjQhMPubah}(h]jQah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjQhMPhjQhhubj4)}(hhh]j^)}(hhh]jc)}(h;tries to find and allocate contiguous range of frozen pagesh]jM)}(hj?Sh]h;tries to find and allocate contiguous range of frozen pages}(hjAShhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMPhj=Subah}(h]h ]h"]h$]h&]uh1jbhj:ShhhjNShNubah}(h]h ]h"]h$]h&]jjuh1j]hjNShMPhj7Shhubah}(h]h ]h"]h$]h&]uh1j3hjQhhhjQhMPubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjdSjHjdSjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``unsigned long nr_pages`` Number of contiguous pages to allocate ``gfp_t gfp_mask`` GFP mask. Node/zone/placement hints limit the search; only some action and reclaim modifiers are supported. Reclaim modifiers control allocation behavior during compaction/migration/reclaim. ``int nid`` Target node ``nodemask_t *nodemask`` Mask for other possible nodes **Description** This routine is a wrapper around alloc_contig_frozen_range(). It scans over zones on an applicable zonelist to find a contiguous pfn range which can then be tried for allocation with alloc_contig_frozen_range(). This routine is intended for allocation requests which can not be fulfilled with the buddy allocator. The allocated memory is always aligned to a page boundary. If nr_pages is a power of two, then allocated range is also guaranteed to be aligned to same nr_pages (e.g. 1GB request would be aligned to 1GB). Allocated frozen pages need be freed with free_contig_frozen_range(), or by manually calling free_frozen_pages() on each allocated frozen non-compound page, for compound frozen pages could be freed with free_frozen_pages() directly. **Return** pointer to contiguous frozen pages on success, or NULL if not successful.h](jM)}(h**Parameters**h]j)}(hjnSh]h Parameters}(hjpShhhNhNubah}(h]h ]h"]h$]h&]uh1jhjlSubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMThjhSubj)}(hhh](j)}(hB``unsigned long nr_pages`` Number of contiguous pages to allocate h](j)}(h``unsigned long nr_pages``h]jS)}(hjSh]hunsigned long nr_pages}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjSubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMQhjSubj)}(hhh]jM)}(h&Number of contiguous pages to allocateh]h&Number of contiguous pages to allocate}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjShMQhjSubah}(h]h ]h"]h$]h&]uh1jhjSubeh}(h]h ]h"]h$]h&]uh1jhjShMQhjSubj)}(h``gfp_t gfp_mask`` GFP mask. Node/zone/placement hints limit the search; only some action and reclaim modifiers are supported. Reclaim modifiers control allocation behavior during compaction/migration/reclaim. h](j)}(h``gfp_t gfp_mask``h]jS)}(hjSh]hgfp_t gfp_mask}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjSubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMThjSubj)}(hhh]jM)}(hGFP mask. Node/zone/placement hints limit the search; only some action and reclaim modifiers are supported. Reclaim modifiers control allocation behavior during compaction/migration/reclaim.h]hGFP mask. Node/zone/placement hints limit the search; only some action and reclaim modifiers are supported. Reclaim modifiers control allocation behavior during compaction/migration/reclaim.}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMRhjSubah}(h]h ]h"]h$]h&]uh1jhjSubeh}(h]h ]h"]h$]h&]uh1jhjShMThjSubj)}(h``int nid`` Target node h](j)}(h ``int nid``h]jS)}(hjTh]hint nid}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjSubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMUhjSubj)}(hhh]jM)}(h Target nodeh]h Target node}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjThMUhjTubah}(h]h ]h"]h$]h&]uh1jhjSubeh}(h]h ]h"]h$]h&]uh1jhjThMUhjSubj)}(h7``nodemask_t *nodemask`` Mask for other possible nodes h](j)}(h``nodemask_t *nodemask``h]jS)}(hj9Th]hnodemask_t *nodemask}(hj;ThhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj7Tubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMVhj3Tubj)}(hhh]jM)}(hMask for other possible nodesh]hMask for other possible nodes}(hjRThhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjNThMVhjOTubah}(h]h ]h"]h$]h&]uh1jhj3Tubeh}(h]h ]h"]h$]h&]uh1jhjNThMVhjSubeh}(h]h ]h"]h$]h&]uh1jhjhSubjM)}(h**Description**h]j)}(hjtTh]h Description}(hjvThhhNhNubah}(h]h ]h"]h$]h&]uh1jhjrTubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMXhjhSubjM)}(hX9This routine is a wrapper around alloc_contig_frozen_range(). It scans over zones on an applicable zonelist to find a contiguous pfn range which can then be tried for allocation with alloc_contig_frozen_range(). This routine is intended for allocation requests which can not be fulfilled with the buddy allocator.h]hX9This routine is a wrapper around alloc_contig_frozen_range(). It scans over zones on an applicable zonelist to find a contiguous pfn range which can then be tried for allocation with alloc_contig_frozen_range(). This routine is intended for allocation requests which can not be fulfilled with the buddy allocator.}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMWhjhSubjM)}(hThe allocated memory is always aligned to a page boundary. If nr_pages is a power of two, then allocated range is also guaranteed to be aligned to same nr_pages (e.g. 1GB request would be aligned to 1GB).h]hThe allocated memory is always aligned to a page boundary. If nr_pages is a power of two, then allocated range is also guaranteed to be aligned to same nr_pages (e.g. 1GB request would be aligned to 1GB).}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chM]hjhSubjM)}(hAllocated frozen pages need be freed with free_contig_frozen_range(), or by manually calling free_frozen_pages() on each allocated frozen non-compound page, for compound frozen pages could be freed with free_frozen_pages() directly.h]hAllocated frozen pages need be freed with free_contig_frozen_range(), or by manually calling free_frozen_pages() on each allocated frozen non-compound page, for compound frozen pages could be freed with free_frozen_pages() directly.}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMahjhSubjM)}(h **Return**h]j)}(hjTh]hReturn}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jhjTubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMfhjhSubjM)}(hIpointer to contiguous frozen pages on success, or NULL if not successful.h]hIpointer to contiguous frozen pages on success, or NULL if not successful.}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMghjhSubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](halloc_contig_pages (C function)c.alloc_contig_pageshNtauh1hhjKhhhNhNubh)}(hhh](h)}(hhstruct page * alloc_contig_pages (unsigned long nr_pages, gfp_t gfp_mask, int nid, nodemask_t *nodemask)h]h)}(hfstruct page *alloc_contig_pages(unsigned long nr_pages, gfp_t gfp_mask, int nid, nodemask_t *nodemask)h](j)}(hjJ,h]hstruct}(hjThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjThhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMubj)}(h h]h }(hj UhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjThhhj UhMubh)}(hhh]j)}(hpageh]hpage}(hjUhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjUubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjUmodnameN classnameNjj)}j]j)}jalloc_contig_pagessbc.alloc_contig_pagesasbuh1hhjThhhj UhMubj)}(h h]h }(hj>UhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjThhhj UhMubjr)}(hjuh]h*}(hjLUhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjThhhj UhMubh)}(halloc_contig_pagesh]j)}(hj;Uh]halloc_contig_pages}(hj]UhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjYUubah}(h]h ](jjeh"]h$]h&]jjuh1hhjThhhj UhMubj8)}(hG(unsigned long nr_pages, gfp_t gfp_mask, int nid, nodemask_t *nodemask)h](j>)}(hunsigned long nr_pagesh](j)}(hunsignedh]hunsigned}(hjxUhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjtUubj)}(h h]h }(hjUhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjtUubj)}(hlongh]hlong}(hjUhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjtUubj)}(h h]h }(hjUhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjtUubj)}(hnr_pagesh]hnr_pages}(hjUhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjtUubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjpUubj>)}(hgfp_t gfp_maskh](h)}(hhh]j)}(hgfp_th]hgfp_t}(hjUhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjUubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjUmodnameN classnameNjj)}j]j9Uc.alloc_contig_pagesasbuh1hhjUubj)}(h h]h }(hjUhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjUubj)}(hgfp_maskh]hgfp_mask}(hjUhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjUubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjpUubj>)}(hint nidh](j)}(hinth]hint}(hjVhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj Vubj)}(h h]h }(hjVhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj Vubj)}(hnidh]hnid}(hj-VhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj Vubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjpUubj>)}(hnodemask_t *nodemaskh](h)}(hhh]j)}(h nodemask_th]h nodemask_t}(hjIVhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFVubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjKVmodnameN classnameNjj)}j]j9Uc.alloc_contig_pagesasbuh1hhjBVubj)}(h h]h }(hjgVhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBVubjr)}(hjuh]h*}(hjuVhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjBVubj)}(hnodemaskh]hnodemask}(hjVhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBVubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjpUubeh}(h]h ]h"]h$]h&]jjuh1j7hjThhhj UhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjThhhj UhMubah}(h]jTah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj UhMhjThhubj4)}(hhh]j^)}(hhh]jc)}(h4tries to find and allocate contiguous range of pagesh]jM)}(hjVh]h4tries to find and allocate contiguous range of pages}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhjVubah}(h]h ]h"]h$]h&]uh1jbhjVhhhjVhNubah}(h]h ]h"]h$]h&]jjuh1j]hjVhMhjVhhubah}(h]h ]h"]h$]h&]uh1j3hjThhhj UhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjVjHjVjIjJjKuh1hhhhjKhNhNubj)}(hXA**Parameters** ``unsigned long nr_pages`` Number of contiguous pages to allocate ``gfp_t gfp_mask`` GFP mask. ``int nid`` Target node ``nodemask_t *nodemask`` Mask for other possible nodes **Description** This routine is a wrapper around alloc_contig_frozen_pages(), it can't be used to allocate compound pages, the refcount of each allocated page will be set to one. Allocated pages can be freed with free_contig_range() or by manually calling __free_page() on each allocated page. **Return** pointer to contiguous pages on success, or NULL if not successful.h](jM)}(h**Parameters**h]j)}(hjVh]h Parameters}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjVubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhjVubj)}(hhh](j)}(hB``unsigned long nr_pages`` Number of contiguous pages to allocate h](j)}(h``unsigned long nr_pages``h]jS)}(hjVh]hunsigned long nr_pages}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjVubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhjVubj)}(hhh]jM)}(h&Number of contiguous pages to allocateh]h&Number of contiguous pages to allocate}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjWhMhjWubah}(h]h ]h"]h$]h&]uh1jhjVubeh}(h]h ]h"]h$]h&]uh1jhjWhMhjVubj)}(h``gfp_t gfp_mask`` GFP mask. h](j)}(h``gfp_t gfp_mask``h]jS)}(hj8Wh]hgfp_t gfp_mask}(hj:WhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj6Wubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj2Wubj)}(hhh]jM)}(h GFP mask.h]h GFP mask.}(hjQWhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjMWhMhjNWubah}(h]h ]h"]h$]h&]uh1jhj2Wubeh}(h]h ]h"]h$]h&]uh1jhjMWhMhjVubj)}(h``int nid`` Target node h](j)}(h ``int nid``h]jS)}(hjqWh]hint nid}(hjsWhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjoWubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhjkWubj)}(hhh]jM)}(h Target nodeh]h Target node}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjWhMhjWubah}(h]h ]h"]h$]h&]uh1jhjkWubeh}(h]h ]h"]h$]h&]uh1jhjWhMhjVubj)}(h7``nodemask_t *nodemask`` Mask for other possible nodes h](j)}(h``nodemask_t *nodemask``h]jS)}(hjWh]hnodemask_t *nodemask}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjWubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhjWubj)}(hhh]jM)}(hMask for other possible nodesh]hMask for other possible nodes}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjWhMhjWubah}(h]h ]h"]h$]h&]uh1jhjWubeh}(h]h ]h"]h$]h&]uh1jhjWhMhjVubeh}(h]h ]h"]h$]h&]uh1jhjVubjM)}(h**Description**h]j)}(hjWh]h Description}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjWubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhjVubjM)}(hThis routine is a wrapper around alloc_contig_frozen_pages(), it can't be used to allocate compound pages, the refcount of each allocated page will be set to one.h]hThis routine is a wrapper around alloc_contig_frozen_pages(), it can’t be used to allocate compound pages, the refcount of each allocated page will be set to one.}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhjVubjM)}(hrAllocated pages can be freed with free_contig_range() or by manually calling __free_page() on each allocated page.h]hrAllocated pages can be freed with free_contig_range() or by manually calling __free_page() on each allocated page.}(hj XhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhjVubjM)}(h **Return**h]j)}(hjXh]hReturn}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjXubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhjVubjM)}(hBpointer to contiguous pages on success, or NULL if not successful.h]hBpointer to contiguous pages on success, or NULL if not successful.}(hj1XhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhjVubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h%free_contig_frozen_range (C function)c.free_contig_frozen_rangehNtauh1hhjKhhhNhNubh)}(hhh](h)}(hIvoid free_contig_frozen_range (unsigned long pfn, unsigned long nr_pages)h]h)}(hHvoid free_contig_frozen_range(unsigned long pfn, unsigned long nr_pages)h](j)}(hvoidh]hvoid}(hj`XhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\XhhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMubj)}(h h]h }(hjoXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\XhhhjnXhMubh)}(hfree_contig_frozen_rangeh]j)}(hfree_contig_frozen_rangeh]hfree_contig_frozen_range}(hjXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj}Xubah}(h]h ](jjeh"]h$]h&]jjuh1hhj\XhhhjnXhMubj8)}(h+(unsigned long pfn, unsigned long nr_pages)h](j>)}(hunsigned long pfnh](j)}(hunsignedh]hunsigned}(hjXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjXubj)}(h h]h }(hjXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjXubj)}(hlongh]hlong}(hjXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjXubj)}(h h]h }(hjXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjXubj)}(hpfnh]hpfn}(hjXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjXubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjXubj>)}(hunsigned long nr_pagesh](j)}(hunsignedh]hunsigned}(hjXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjXubj)}(h h]h }(hjXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjXubj)}(hlongh]hlong}(hj YhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjXubj)}(h h]h }(hjYhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjXubj)}(hnr_pagesh]hnr_pages}(hj&YhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjXubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjXubeh}(h]h ]h"]h$]h&]jjuh1j7hj\XhhhjnXhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjXXhhhjnXhMubah}(h]jSXah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjnXhMhjUXhhubj4)}(hhh]j^)}(hhh]jc)}(h)free the contiguous range of frozen pagesh]jM)}(hjUYh]h)free the contiguous range of frozen pages}(hjWYhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhjSYubah}(h]h ]h"]h$]h&]uh1jbhjPYhhhjdYhNubah}(h]h ]h"]h$]h&]jjuh1j]hjdYhMhjMYhhubah}(h]h ]h"]h$]h&]uh1j3hjUXhhhjnXhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjzYjHjzYjIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``unsigned long pfn`` start PFN to free ``unsigned long nr_pages`` Number of contiguous frozen pages to free **Description** This can be used to free the allocated compound/non-compound frozen pages.h](jM)}(h**Parameters**h]j)}(hjYh]h Parameters}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjYubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj~Yubj)}(hhh](j)}(h(``unsigned long pfn`` start PFN to free h](j)}(h``unsigned long pfn``h]jS)}(hjYh]hunsigned long pfn}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjYubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhjYubj)}(hhh]jM)}(hstart PFN to freeh]hstart PFN to free}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjYhMhjYubah}(h]h ]h"]h$]h&]uh1jhjYubeh}(h]h ]h"]h$]h&]uh1jhjYhMhjYubj)}(hE``unsigned long nr_pages`` Number of contiguous frozen pages to free h](j)}(h``unsigned long nr_pages``h]jS)}(hjYh]hunsigned long nr_pages}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjYubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhjYubj)}(hhh]jM)}(h)Number of contiguous frozen pages to freeh]h)Number of contiguous frozen pages to free}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjYhMhjYubah}(h]h ]h"]h$]h&]uh1jhjYubeh}(h]h ]h"]h$]h&]uh1jhjYhMhjYubeh}(h]h ]h"]h$]h&]uh1jhj~YubjM)}(h**Description**h]j)}(hjZh]h Description}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjZubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj~YubjM)}(hJThis can be used to free the allocated compound/non-compound frozen pages.h]hJThis can be used to free the allocated compound/non-compound frozen pages.}(hj-ZhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj~Yubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfree_contig_range (C function)c.free_contig_rangehNtauh1hhjKhhhNhNubh)}(hhh](h)}(hBvoid free_contig_range (unsigned long pfn, unsigned long nr_pages)h]h)}(hAvoid free_contig_range(unsigned long pfn, unsigned long nr_pages)h](j)}(hvoidh]hvoid}(hj\ZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjXZhhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMubj)}(h h]h }(hjkZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjXZhhhjjZhMubh)}(hfree_contig_rangeh]j)}(hfree_contig_rangeh]hfree_contig_range}(hj}ZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyZubah}(h]h ](jjeh"]h$]h&]jjuh1hhjXZhhhjjZhMubj8)}(h+(unsigned long pfn, unsigned long nr_pages)h](j>)}(hunsigned long pfnh](j)}(hunsignedh]hunsigned}(hjZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZubj)}(h h]h }(hjZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZubj)}(hlongh]hlong}(hjZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZubj)}(h h]h }(hjZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZubj)}(hpfnh]hpfn}(hjZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjZubj>)}(hunsigned long nr_pagesh](j)}(hunsignedh]hunsigned}(hjZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZubj)}(h h]h }(hjZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZubj)}(hlongh]hlong}(hj[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZubj)}(h h]h }(hj[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZubj)}(hnr_pagesh]hnr_pages}(hj"[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjZubeh}(h]h ]h"]h$]h&]jjuh1j7hjXZhhhjjZhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjTZhhhjjZhMubah}(h]jOZah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjjZhMhjQZhhubj4)}(hhh]j^)}(hhh]jc)}(h"free the contiguous range of pagesh]jM)}(hjQ[h]h"free the contiguous range of pages}(hjS[hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhjO[ubah}(h]h ]h"]h$]h&]uh1jbhjL[hhhj`[hNubah}(h]h ]h"]h$]h&]jjuh1j]hj`[hMhjI[hhubah}(h]h ]h"]h$]h&]uh1j3hjQZhhhjjZhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjv[jHjv[jIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``unsigned long pfn`` start PFN to free ``unsigned long nr_pages`` Number of contiguous pages to free **Description** This can be only used to free the allocated non-compound pages.h](jM)}(h**Parameters**h]j)}(hj[h]h Parameters}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj~[ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhjz[ubj)}(hhh](j)}(h(``unsigned long pfn`` start PFN to free h](j)}(h``unsigned long pfn``h]jS)}(hj[h]hunsigned long pfn}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj[ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj[ubj)}(hhh]jM)}(hstart PFN to freeh]hstart PFN to free}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj[hMhj[ubah}(h]h ]h"]h$]h&]uh1jhj[ubeh}(h]h ]h"]h$]h&]uh1jhj[hMhj[ubj)}(h>``unsigned long nr_pages`` Number of contiguous pages to free h](j)}(h``unsigned long nr_pages``h]jS)}(hj[h]hunsigned long nr_pages}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj[ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhj[ubj)}(hhh]jM)}(h"Number of contiguous pages to freeh]h"Number of contiguous pages to free}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj[hMhj[ubah}(h]h ]h"]h$]h&]uh1jhj[ubeh}(h]h ]h"]h$]h&]uh1jhj[hMhj[ubeh}(h]h ]h"]h$]h&]uh1jhjz[ubjM)}(h**Description**h]j)}(hj\h]h Description}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj\ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhjz[ubjM)}(h?This can be only used to free the allocated non-compound pages.h]h?This can be only used to free the allocated non-compound pages.}(hj)\hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhjz[ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](halloc_pages_nolock (C function)c.alloc_pages_nolockhNtauh1hhjKhhhNhNubh)}(hhh](h)}(hOstruct page * alloc_pages_nolock (gfp_t gfp_flags, int nid, unsigned int order)h]h)}(hMstruct page *alloc_pages_nolock(gfp_t gfp_flags, int nid, unsigned int order)h](j)}(hjJ,h]hstruct}(hjX\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjT\hhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMgubj)}(h h]h }(hjf\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjT\hhhje\hMgubh)}(hhh]j)}(hpageh]hpage}(hjw\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjt\ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjy\modnameN classnameNjj)}j]j)}jalloc_pages_nolocksbc.alloc_pages_nolockasbuh1hhjT\hhhje\hMgubj)}(h h]h }(hj\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjT\hhhje\hMgubjr)}(hjuh]h*}(hj\hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjT\hhhje\hMgubh)}(halloc_pages_nolockh]j)}(hj\h]halloc_pages_nolock}(hj\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjT\hhhje\hMgubj8)}(h.(gfp_t gfp_flags, int nid, unsigned int order)h](j>)}(hgfp_t gfp_flagsh](h)}(hhh]j)}(hgfp_th]hgfp_t}(hj\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj\modnameN classnameNjj)}j]j\c.alloc_pages_nolockasbuh1hhj\ubj)}(h h]h }(hj\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\ubj)}(h gfp_flagsh]h gfp_flags}(hj]hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj\ubj>)}(hint nidh](j)}(hinth]hint}(hj]hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj]ubj)}(h h]h }(hj(]hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj]ubj)}(hnidh]hnid}(hj6]hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj]ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj\ubj>)}(hunsigned int orderh](j)}(hunsignedh]hunsigned}(hjO]hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjK]ubj)}(h h]h }(hj]]hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjK]ubj)}(hinth]hint}(hjk]hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjK]ubj)}(h h]h }(hjy]hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjK]ubj)}(horderh]horder}(hj]hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjK]ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj\ubeh}(h]h ]h"]h$]h&]jjuh1j7hjT\hhhje\hMgubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjP\hhhje\hMgubah}(h]jK\ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhje\hMghjM\hhubj4)}(hhh]jM)}(h3opportunistic reentrant allocation from any contexth]h3opportunistic reentrant allocation from any context}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMghj]hhubah}(h]h ]h"]h$]h&]uh1j3hjM\hhhje\hMgubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj]jHj]jIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``gfp_t gfp_flags`` GFP flags. Only __GFP_ACCOUNT, plus some flags that get set internally regardless (see ``gfp_nolock``) are allowed. ``int nid`` node to allocate from ``unsigned int order`` allocation order size **Description** Allocates pages of a given order from the given node. This is safe to call from any context where RCU is watching (from atomic, NMI, and also reentrant allocator -> tracepoint -> alloc_pages_nolock_noprof). Allocation is best effort and to be expected to fail easily so nobody should rely on the success. Failures are not reported via warn_alloc(). See always fail conditions below. **Return** allocated page or NULL on failure. NULL does not mean EBUSY or EAGAIN. It means ENOMEM. There is no reason to call it again and expect !NULL.h](jM)}(h**Parameters**h]j)}(hj]h]h Parameters}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj]ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMkhj]ubj)}(hhh](j)}(h``gfp_t gfp_flags`` GFP flags. Only __GFP_ACCOUNT, plus some flags that get set internally regardless (see ``gfp_nolock``) are allowed. h](j)}(h``gfp_t gfp_flags``h]jS)}(hj]h]hgfp_t gfp_flags}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj]ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMihj]ubj)}(hhh]jM)}(hsGFP flags. Only __GFP_ACCOUNT, plus some flags that get set internally regardless (see ``gfp_nolock``) are allowed.h](hWGFP flags. Only __GFP_ACCOUNT, plus some flags that get set internally regardless (see }(hj ^hhhNhNubjS)}(h``gfp_nolock``h]h gfp_nolock}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj ^ubh) are allowed.}(hj ^hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMhhj^ubah}(h]h ]h"]h$]h&]uh1jhj]ubeh}(h]h ]h"]h$]h&]uh1jhj^hMihj]ubj)}(h"``int nid`` node to allocate from h](j)}(h ``int nid``h]jS)}(hj>^h]hint nid}(hj@^hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj<^ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMjhj8^ubj)}(hhh]jM)}(hnode to allocate fromh]hnode to allocate from}(hjW^hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjS^hMjhjT^ubah}(h]h ]h"]h$]h&]uh1jhj8^ubeh}(h]h ]h"]h$]h&]uh1jhjS^hMjhj]ubj)}(h-``unsigned int order`` allocation order size h](j)}(h``unsigned int order``h]jS)}(hjw^h]hunsigned int order}(hjy^hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhju^ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMkhjq^ubj)}(hhh]jM)}(hallocation order sizeh]hallocation order size}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj^hMkhj^ubah}(h]h ]h"]h$]h&]uh1jhjq^ubeh}(h]h ]h"]h$]h&]uh1jhj^hMkhj]ubeh}(h]h ]h"]h$]h&]uh1jhj]ubjM)}(h**Description**h]j)}(hj^h]h Description}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj^ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMmhj]ubjM)}(hX~Allocates pages of a given order from the given node. This is safe to call from any context where RCU is watching (from atomic, NMI, and also reentrant allocator -> tracepoint -> alloc_pages_nolock_noprof). Allocation is best effort and to be expected to fail easily so nobody should rely on the success. Failures are not reported via warn_alloc(). See always fail conditions below.h]hX~Allocates pages of a given order from the given node. This is safe to call from any context where RCU is watching (from atomic, NMI, and also reentrant allocator -> tracepoint -> alloc_pages_nolock_noprof). Allocation is best effort and to be expected to fail easily so nobody should rely on the success. Failures are not reported via warn_alloc(). See always fail conditions below.}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMlhj]ubjM)}(h **Return**h]j)}(hj^h]hReturn}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj^ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMshj]ubjM)}(hallocated page or NULL on failure. NULL does not mean EBUSY or EAGAIN. It means ENOMEM. There is no reason to call it again and expect !NULL.h]hallocated page or NULL on failure. NULL does not mean EBUSY or EAGAIN. It means ENOMEM. There is no reason to call it again and expect !NULL.}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:113: ./mm/page_alloc.chMthj]ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hnuma_nearest_node (C function)c.numa_nearest_nodehNtauh1hhjKhhhNhNubh)}(hhh](h)}(h4int numa_nearest_node (int node, unsigned int state)h]h)}(h3int numa_nearest_node(int node, unsigned int state)h](j)}(hinth]hint}(hj_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj_hhhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chM(ubj)}(h h]h }(hj-_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj_hhhj,_hM(ubh)}(hnuma_nearest_nodeh]j)}(hnuma_nearest_nodeh]hnuma_nearest_node}(hj?_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;_ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj_hhhj,_hM(ubj8)}(h(int node, unsigned int state)h](j>)}(hint nodeh](j)}(hinth]hint}(hj[_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjW_ubj)}(h h]h }(hji_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjW_ubj)}(hnodeh]hnode}(hjw_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjW_ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjS_ubj>)}(hunsigned int stateh](j)}(hunsignedh]hunsigned}(hj_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj_ubj)}(h h]h }(hj_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj_ubj)}(hinth]hint}(hj_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj_ubj)}(h h]h }(hj_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj_ubj)}(hstateh]hstate}(hj_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj_ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjS_ubeh}(h]h ]h"]h$]h&]jjuh1j7hj_hhhj,_hM(ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj_hhhj,_hM(ubah}(h]j_ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj,_hM(hj_hhubj4)}(hhh]jM)}(hFind nearest node by stateh]hFind nearest node by state}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chM(hj_hhubah}(h]h ]h"]h$]h&]uh1j3hj_hhhj,_hM(ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj `jHj `jIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``int node`` Node id to start the search ``unsigned int state`` State to filter the search **Description** Lookup the closest node by distance if **nid** is not in state. **Return** this **node** if it is in state, otherwise the closest node by distanceh](jM)}(h**Parameters**h]j)}(hj`h]h Parameters}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj`ubah}(h]h ]h"]h$]h&]uh1jLhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chM,hj`ubj)}(hhh](j)}(h)``int node`` Node id to start the search h](j)}(h ``int node``h]jS)}(hj3`h]hint node}(hj5`hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj1`ubah}(h]h ]h"]h$]h&]uh1jhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chM)hj-`ubj)}(hhh]jM)}(hNode id to start the searchh]hNode id to start the search}(hjL`hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjH`hM)hjI`ubah}(h]h ]h"]h$]h&]uh1jhj-`ubeh}(h]h ]h"]h$]h&]uh1jhjH`hM)hj*`ubj)}(h2``unsigned int state`` State to filter the search h](j)}(h``unsigned int state``h]jS)}(hjl`h]hunsigned int state}(hjn`hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjj`ubah}(h]h ]h"]h$]h&]uh1jhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chM*hjf`ubj)}(hhh]jM)}(hState to filter the searchh]hState to filter the search}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj`hM*hj`ubah}(h]h ]h"]h$]h&]uh1jhjf`ubeh}(h]h ]h"]h$]h&]uh1jhj`hM*hj*`ubeh}(h]h ]h"]h$]h&]uh1jhj`ubjM)}(h**Description**h]j)}(hj`h]h Description}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj`ubah}(h]h ]h"]h$]h&]uh1jLhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chM,hj`ubjM)}(h?Lookup the closest node by distance if **nid** is not in state.h](h'Lookup the closest node by distance if }(hj`hhhNhNubj)}(h**nid**h]hnid}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj`ubh is not in state.}(hj`hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chM+hj`ubjM)}(h **Return**h]j)}(hj`h]hReturn}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj`ubah}(h]h ]h"]h$]h&]uh1jLhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chM-hj`ubjM)}(hGthis **node** if it is in state, otherwise the closest node by distanceh](hthis }(hj`hhhNhNubj)}(h**node**h]hnode}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj`ubh: if it is in state, otherwise the closest node by distance}(hj`hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chM.hj`ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h"nearest_node_nodemask (C function)c.nearest_node_nodemaskhNtauh1hhjKhhhNhNubh)}(hhh](h)}(h6int nearest_node_nodemask (int node, nodemask_t *mask)h]h)}(h5int nearest_node_nodemask(int node, nodemask_t *mask)h](j)}(hinth]hint}(hj7ahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3ahhhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chMHubj)}(h h]h }(hjFahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3ahhhjEahMHubh)}(hnearest_node_nodemaskh]j)}(hnearest_node_nodemaskh]hnearest_node_nodemask}(hjXahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjTaubah}(h]h ](jjeh"]h$]h&]jjuh1hhj3ahhhjEahMHubj8)}(h(int node, nodemask_t *mask)h](j>)}(hint nodeh](j)}(hinth]hint}(hjtahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpaubj)}(h h]h }(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpaubj)}(hnodeh]hnode}(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpaubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjlaubj>)}(hnodemask_t *maskh](h)}(hhh]j)}(h nodemask_th]h nodemask_t}(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjamodnameN classnameNjj)}j]j)}jjZasbc.nearest_node_nodemaskasbuh1hhjaubj)}(h h]h }(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubjr)}(hjuh]h*}(hjahhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjaubj)}(hmaskh]hmask}(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjlaubeh}(h]h ]h"]h$]h&]jjuh1j7hj3ahhhjEahMHubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj/ahhhjEahMHubah}(h]j*aah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjEahMHhj,ahhubj4)}(hhh]jM)}(h@Find the node in **mask** at the nearest distance from **node**.h](hFind the node in }(hjbhhhNhNubj)}(h**mask**h]hmask}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjbubh at the nearest distance from }(hjbhhhNhNubj)}(h**node**h]hnode}(hj+bhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjbubh.}(hjbhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chMHhjbhhubah}(h]h ]h"]h$]h&]uh1j3hj,ahhhjEahMHubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjMbjHjMbjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``int node`` a valid node ID to start the search from. ``nodemask_t *mask`` a pointer to a nodemask representing the allowed nodes. **Description** This function iterates over all nodes in **mask** and calculates the distance from the starting **node**, then it returns the node ID that is the closest to **node**, or MAX_NUMNODES if no node is found. Note that **node** must be a valid node ID usable with node_distance(), providing an invalid node ID (e.g., NUMA_NO_NODE) may result in crashes or unexpected behavior.h](jM)}(h**Parameters**h]j)}(hjWbh]h Parameters}(hjYbhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjUbubah}(h]h ]h"]h$]h&]uh1jLhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chMLhjQbubj)}(hhh](j)}(h7``int node`` a valid node ID to start the search from. h](j)}(h ``int node``h]jS)}(hjvbh]hint node}(hjxbhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjtbubah}(h]h ]h"]h$]h&]uh1jhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chMKhjpbubj)}(hhh]jM)}(h)a valid node ID to start the search from.h]h)a valid node ID to start the search from.}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjbhMKhjbubah}(h]h ]h"]h$]h&]uh1jhjpbubeh}(h]h ]h"]h$]h&]uh1jhjbhMKhjmbubj)}(hM``nodemask_t *mask`` a pointer to a nodemask representing the allowed nodes. h](j)}(h``nodemask_t *mask``h]jS)}(hjbh]hnodemask_t *mask}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjbubah}(h]h ]h"]h$]h&]uh1jhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chMLhjbubj)}(hhh]jM)}(h7a pointer to a nodemask representing the allowed nodes.h]h7a pointer to a nodemask representing the allowed nodes.}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjbhMLhjbubah}(h]h ]h"]h$]h&]uh1jhjbubeh}(h]h ]h"]h$]h&]uh1jhjbhMLhjmbubeh}(h]h ]h"]h$]h&]uh1jhjQbubjM)}(h**Description**h]j)}(hjbh]h Description}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjbubah}(h]h ]h"]h$]h&]uh1jLhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chMNhjQbubjM)}(hThis function iterates over all nodes in **mask** and calculates the distance from the starting **node**, then it returns the node ID that is the closest to **node**, or MAX_NUMNODES if no node is found.h](h)This function iterates over all nodes in }(hjchhhNhNubj)}(h**mask**h]hmask}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jhjcubh/ and calculates the distance from the starting }(hjchhhNhNubj)}(h**node**h]hnode}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jhjcubh5, then it returns the node ID that is the closest to }(hjchhhNhNubj)}(h**node**h]hnode}(hj,chhhNhNubah}(h]h ]h"]h$]h&]uh1jhjcubh&, or MAX_NUMNODES if no node is found.}(hjchhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chMMhjQbubjM)}(hNote that **node** must be a valid node ID usable with node_distance(), providing an invalid node ID (e.g., NUMA_NO_NODE) may result in crashes or unexpected behavior.h](h Note that }(hjEchhhNhNubj)}(h**node**h]hnode}(hjMchhhNhNubah}(h]h ]h"]h$]h&]uh1jhjEcubh must be a valid node ID usable with node_distance(), providing an invalid node ID (e.g., NUMA_NO_NODE) may result in crashes or unexpected behavior.}(hjEchhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chMQhjQbubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h$folio_can_map_prot_numa (C function)c.folio_can_map_prot_numahNtauh1hhjKhhhNhNubh)}(hhh](h)}(hobool folio_can_map_prot_numa (struct folio *folio, struct vm_area_struct *vma, bool is_private_single_threaded)h]h)}(hnbool folio_can_map_prot_numa(struct folio *folio, struct vm_area_struct *vma, bool is_private_single_threaded)h](j)}(hjh]hbool}(hjchhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjchhhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chMJubj)}(h h]h }(hjchhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjchhhjchMJubh)}(hfolio_can_map_prot_numah]j)}(hfolio_can_map_prot_numah]hfolio_can_map_prot_numa}(hjchhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjcubah}(h]h ](jjeh"]h$]h&]jjuh1hhjchhhjchMJubj8)}(hR(struct folio *folio, struct vm_area_struct *vma, bool is_private_single_threaded)h](j>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hjchhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjcubj)}(h h]h }(hjchhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjcubh)}(hhh]j)}(hfolioh]hfolio}(hjchhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjcubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjcmodnameN classnameNjj)}j]j)}jjcsbc.folio_can_map_prot_numaasbuh1hhjcubj)}(h h]h }(hjdhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjcubjr)}(hjuh]h*}(hjdhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjcubj)}(hfolioh]hfolio}(hjdhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjcubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjcubj>)}(hstruct vm_area_struct *vmah](j)}(hjJ,h]hstruct}(hj4dhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0dubj)}(h h]h }(hjAdhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0dubh)}(hhh]j)}(hvm_area_structh]hvm_area_struct}(hjRdhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjOdubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjTdmodnameN classnameNjj)}j]jcc.folio_can_map_prot_numaasbuh1hhj0dubj)}(h h]h }(hjpdhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0dubjr)}(hjuh]h*}(hj~dhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj0dubj)}(hvmah]hvma}(hjdhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0dubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjcubj>)}(hbool is_private_single_threadedh](j)}(hjh]hbool}(hjdhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjdubj)}(h h]h }(hjdhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjdubj)}(his_private_single_threadedh]his_private_single_threaded}(hjdhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjdubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjcubeh}(h]h ]h"]h$]h&]jjuh1j7hjchhhjchMJubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj~chhhjchMJubah}(h]jycah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjchMJhj{chhubj4)}(hhh]jM)}(h)check whether the folio can map prot numah]h)check whether the folio can map prot numa}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chMJhjdhhubah}(h]h ]h"]h$]h&]uh1j3hj{chhhjchMJubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjejHjejIjJjKuh1hhhhjKhNhNubj)}(hXn**Parameters** ``struct folio *folio`` The folio whose mapping considered for being made NUMA hintable ``struct vm_area_struct *vma`` The VMA that the folio belongs to. ``bool is_private_single_threaded`` Is this a single-threaded private VMA or not **Description** This function checks to see if the folio actually indicates that we need to make the mapping one which causes a NUMA hinting fault, as there are cases where it's simply unnecessary, and the folio's access time is adjusted for memory tiering if prot numa needed. **Return** True if the mapping of the folio needs to be changed, false otherwise.h](jM)}(h**Parameters**h]j)}(hj eh]h Parameters}(hj ehhhNhNubah}(h]h ]h"]h$]h&]uh1jhj eubah}(h]h ]h"]h$]h&]uh1jLhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chMNhjeubj)}(hhh](j)}(hX``struct folio *folio`` The folio whose mapping considered for being made NUMA hintable h](j)}(h``struct folio *folio``h]jS)}(hj*eh]hstruct folio *folio}(hj,ehhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj(eubah}(h]h ]h"]h$]h&]uh1jhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chMKhj$eubj)}(hhh]jM)}(h?The folio whose mapping considered for being made NUMA hintableh]h?The folio whose mapping considered for being made NUMA hintable}(hjCehhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj?ehMKhj@eubah}(h]h ]h"]h$]h&]uh1jhj$eubeh}(h]h ]h"]h$]h&]uh1jhj?ehMKhj!eubj)}(hB``struct vm_area_struct *vma`` The VMA that the folio belongs to. h](j)}(h``struct vm_area_struct *vma``h]jS)}(hjceh]hstruct vm_area_struct *vma}(hjeehhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjaeubah}(h]h ]h"]h$]h&]uh1jhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chMLhj]eubj)}(hhh]jM)}(h"The VMA that the folio belongs to.h]h"The VMA that the folio belongs to.}(hj|ehhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjxehMLhjyeubah}(h]h ]h"]h$]h&]uh1jhj]eubeh}(h]h ]h"]h$]h&]uh1jhjxehMLhj!eubj)}(hQ``bool is_private_single_threaded`` Is this a single-threaded private VMA or not h](j)}(h#``bool is_private_single_threaded``h]jS)}(hjeh]hbool is_private_single_threaded}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjeubah}(h]h ]h"]h$]h&]uh1jhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chMMhjeubj)}(hhh]jM)}(h,Is this a single-threaded private VMA or noth]h,Is this a single-threaded private VMA or not}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjehMMhjeubah}(h]h ]h"]h$]h&]uh1jhjeubeh}(h]h ]h"]h$]h&]uh1jhjehMMhj!eubeh}(h]h ]h"]h$]h&]uh1jhjeubjM)}(h**Description**h]j)}(hjeh]h Description}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1jhjeubah}(h]h ]h"]h$]h&]uh1jLhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chMOhjeubjM)}(hXThis function checks to see if the folio actually indicates that we need to make the mapping one which causes a NUMA hinting fault, as there are cases where it's simply unnecessary, and the folio's access time is adjusted for memory tiering if prot numa needed.h]hX This function checks to see if the folio actually indicates that we need to make the mapping one which causes a NUMA hinting fault, as there are cases where it’s simply unnecessary, and the folio’s access time is adjusted for memory tiering if prot numa needed.}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1jLhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chMNhjeubjM)}(h **Return**h]j)}(hjeh]hReturn}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjeubah}(h]h ]h"]h$]h&]uh1jLhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chMShjeubjM)}(hFTrue if the mapping of the folio needs to be changed, false otherwise.h]hFTrue if the mapping of the folio needs to be changed, false otherwise.}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chMThjeubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](halloc_pages_mpol (C function)c.alloc_pages_mpolhNtauh1hhjKhhhNhNubh)}(hhh](h)}(hkstruct page * alloc_pages_mpol (gfp_t gfp, unsigned int order, struct mempolicy *pol, pgoff_t ilx, int nid)h]h)}(histruct page *alloc_pages_mpol(gfp_t gfp, unsigned int order, struct mempolicy *pol, pgoff_t ilx, int nid)h](j)}(hjJ,h]hstruct}(hjCfhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?fhhhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chM ubj)}(h h]h }(hjQfhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?fhhhjPfhM ubh)}(hhh]j)}(hpageh]hpage}(hjbfhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj_fubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjdfmodnameN classnameNjj)}j]j)}jalloc_pages_mpolsbc.alloc_pages_mpolasbuh1hhj?fhhhjPfhM ubj)}(h h]h }(hjfhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?fhhhjPfhM ubjr)}(hjuh]h*}(hjfhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj?fhhhjPfhM ubh)}(halloc_pages_mpolh]j)}(hjfh]halloc_pages_mpol}(hjfhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjfubah}(h]h ](jjeh"]h$]h&]jjuh1hhj?fhhhjPfhM ubj8)}(hL(gfp_t gfp, unsigned int order, struct mempolicy *pol, pgoff_t ilx, int nid)h](j>)}(h gfp_t gfph](h)}(hhh]j)}(hgfp_th]hgfp_t}(hjfhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjfubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjfmodnameN classnameNjj)}j]j~fc.alloc_pages_mpolasbuh1hhjfubj)}(h h]h }(hjfhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjfubj)}(hgfph]hgfp}(hjfhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjfubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjfubj>)}(hunsigned int orderh](j)}(hunsignedh]hunsigned}(hjghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubj)}(h h]h }(hjghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubj)}(hinth]hint}(hj!ghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubj)}(h h]h }(hj/ghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubj)}(horderh]horder}(hj=ghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjfubj>)}(hstruct mempolicy *polh](j)}(hjJ,h]hstruct}(hjVghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRgubj)}(h h]h }(hjcghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRgubh)}(hhh]j)}(h mempolicyh]h mempolicy}(hjtghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjqgubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjvgmodnameN classnameNjj)}j]j~fc.alloc_pages_mpolasbuh1hhjRgubj)}(h h]h }(hjghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRgubjr)}(hjuh]h*}(hjghhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjRgubj)}(hpolh]hpol}(hjghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRgubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjfubj>)}(h pgoff_t ilxh](h)}(hhh]j)}(hpgoff_th]hpgoff_t}(hjghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjgmodnameN classnameNjj)}j]j~fc.alloc_pages_mpolasbuh1hhjgubj)}(h h]h }(hjghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubj)}(hilxh]hilx}(hjghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjfubj>)}(hint nidh](j)}(hinth]hint}(hjhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hubj)}(h h]h }(hjhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hubj)}(hnidh]hnid}(hj*hhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjfubeh}(h]h ]h"]h$]h&]jjuh1j7hj?fhhhjPfhM ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj;fhhhjPfhM ubah}(h]j6fah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjPfhM hj8fhhubj4)}(hhh]jM)}(h+Allocate pages according to NUMA mempolicy.h]h+Allocate pages according to NUMA mempolicy.}(hjThhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chM hjQhhhubah}(h]h ]h"]h$]h&]uh1j3hj8fhhhjPfhM ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjlhjHjlhjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``gfp_t gfp`` GFP flags. ``unsigned int order`` Order of the page allocation. ``struct mempolicy *pol`` Pointer to the NUMA mempolicy. ``pgoff_t ilx`` Index for interleave mempolicy (also distinguishes alloc_pages()). ``int nid`` Preferred node (usually numa_node_id() but **mpol** may override it). **Return** The page on success or NULL if allocation fails.h](jM)}(h**Parameters**h]j)}(hjvhh]h Parameters}(hjxhhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjthubah}(h]h ]h"]h$]h&]uh1jLhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chM hjphubj)}(hhh](j)}(h``gfp_t gfp`` GFP flags. h](j)}(h ``gfp_t gfp``h]jS)}(hjhh]h gfp_t gfp}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjhubah}(h]h ]h"]h$]h&]uh1jhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chM hjhubj)}(hhh]jM)}(h GFP flags.h]h GFP flags.}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhhM hjhubah}(h]h ]h"]h$]h&]uh1jhjhubeh}(h]h ]h"]h$]h&]uh1jhjhhM hjhubj)}(h5``unsigned int order`` Order of the page allocation. h](j)}(h``unsigned int order``h]jS)}(hjhh]hunsigned int order}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjhubah}(h]h ]h"]h$]h&]uh1jhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chM hjhubj)}(hhh]jM)}(hOrder of the page allocation.h]hOrder of the page allocation.}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhhM hjhubah}(h]h ]h"]h$]h&]uh1jhjhubeh}(h]h ]h"]h$]h&]uh1jhjhhM hjhubj)}(h9``struct mempolicy *pol`` Pointer to the NUMA mempolicy. h](j)}(h``struct mempolicy *pol``h]jS)}(hjih]hstruct mempolicy *pol}(hj ihhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjiubah}(h]h ]h"]h$]h&]uh1jhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chM hjiubj)}(hhh]jM)}(hPointer to the NUMA mempolicy.h]hPointer to the NUMA mempolicy.}(hj ihhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjihM hjiubah}(h]h ]h"]h$]h&]uh1jhjiubeh}(h]h ]h"]h$]h&]uh1jhjihM hjhubj)}(hS``pgoff_t ilx`` Index for interleave mempolicy (also distinguishes alloc_pages()). h](j)}(h``pgoff_t ilx``h]jS)}(hj@ih]h pgoff_t ilx}(hjBihhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj>iubah}(h]h ]h"]h$]h&]uh1jhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chM hj:iubj)}(hhh]jM)}(hBIndex for interleave mempolicy (also distinguishes alloc_pages()).h]hBIndex for interleave mempolicy (also distinguishes alloc_pages()).}(hjYihhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjUihM hjViubah}(h]h ]h"]h$]h&]uh1jhj:iubeh}(h]h ]h"]h$]h&]uh1jhjUihM hjhubj)}(hR``int nid`` Preferred node (usually numa_node_id() but **mpol** may override it). h](j)}(h ``int nid``h]jS)}(hjyih]hint nid}(hj{ihhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjwiubah}(h]h ]h"]h$]h&]uh1jhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chM hjsiubj)}(hhh]jM)}(hEPreferred node (usually numa_node_id() but **mpol** may override it).h](h+Preferred node (usually numa_node_id() but }(hjihhhNhNubj)}(h**mpol**h]hmpol}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1jhjiubh may override it).}(hjihhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhjihM hjiubah}(h]h ]h"]h$]h&]uh1jhjsiubeh}(h]h ]h"]h$]h&]uh1jhjihM hjhubeh}(h]h ]h"]h$]h&]uh1jhjphubjM)}(h **Return**h]j)}(hjih]hReturn}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1jhjiubah}(h]h ]h"]h$]h&]uh1jLhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chM hjphubjM)}(h0The page on success or NULL if allocation fails.h]h0The page on success or NULL if allocation fails.}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1jLhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chM hjphubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hvma_alloc_folio (C function)c.vma_alloc_foliohNtauh1hhjKhhhNhNubh)}(hhh](h)}(hestruct folio * vma_alloc_folio (gfp_t gfp, int order, struct vm_area_struct *vma, unsigned long addr)h]h)}(hcstruct folio *vma_alloc_folio(gfp_t gfp, int order, struct vm_area_struct *vma, unsigned long addr)h](j)}(hjJ,h]hstruct}(hj jhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjjhhhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chM ubj)}(h h]h }(hjjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjjhhhjjhM ubh)}(hhh]j)}(hfolioh]hfolio}(hj*jhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj'jubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj,jmodnameN classnameNjj)}j]j)}jvma_alloc_foliosbc.vma_alloc_folioasbuh1hhjjhhhjjhM ubj)}(h h]h }(hjKjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjjhhhjjhM ubjr)}(hjuh]h*}(hjYjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjjhhhjjhM ubh)}(hvma_alloc_folioh]j)}(hjHjh]hvma_alloc_folio}(hjjjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjfjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjjhhhjjhM ubj8)}(hF(gfp_t gfp, int order, struct vm_area_struct *vma, unsigned long addr)h](j>)}(h gfp_t gfph](h)}(hhh]j)}(hgfp_th]hgfp_t}(hjjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjjmodnameN classnameNjj)}j]jFjc.vma_alloc_folioasbuh1hhjjubj)}(h h]h }(hjjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjjubj)}(hgfph]hgfp}(hjjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj}jubj>)}(h int orderh](j)}(hinth]hint}(hjjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjjubj)}(h h]h }(hjjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjjubj)}(horderh]horder}(hjjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj}jubj>)}(hstruct vm_area_struct *vmah](j)}(hjJ,h]hstruct}(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjjubj)}(h h]h }(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjjubh)}(hhh]j)}(hvm_area_structh]hvm_area_struct}(hj khhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjkubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj"kmodnameN classnameNjj)}j]jFjc.vma_alloc_folioasbuh1hhjjubj)}(h h]h }(hj>khhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjjubjr)}(hjuh]h*}(hjLkhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjjubj)}(hvmah]hvma}(hjYkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj}jubj>)}(hunsigned long addrh](j)}(hunsignedh]hunsigned}(hjrkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnkubj)}(h h]h }(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnkubj)}(hlongh]hlong}(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnkubj)}(h h]h }(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnkubj)}(haddrh]haddr}(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnkubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj}jubeh}(h]h ]h"]h$]h&]jjuh1j7hjjhhhjjhM ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjjhhhjjhM ubah}(h]jiah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjjhM hjjhhubj4)}(hhh]jM)}(hAllocate a folio for a VMA.h]hAllocate a folio for a VMA.}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chM hjkhhubah}(h]h ]h"]h$]h&]uh1j3hjjhhhjjhM ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjkjHjkjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``gfp_t gfp`` GFP flags. ``int order`` Order of the folio. ``struct vm_area_struct *vma`` Pointer to VMA. ``unsigned long addr`` Virtual address of the allocation. Must be inside **vma**. **Description** Allocate a folio for a specific address in **vma**, using the appropriate NUMA policy. The caller must hold the mmap_lock of the mm_struct of the VMA to prevent it from going away. Should be used for all allocations for folios that will be mapped into user space, excepting hugetlbfs, and excepting where direct use of folio_alloc_mpol() is more appropriate. **Return** The folio on success or NULL if allocation fails.h](jM)}(h**Parameters**h]j)}(hjkh]h Parameters}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjkubah}(h]h ]h"]h$]h&]uh1jLhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chM hjkubj)}(hhh](j)}(h``gfp_t gfp`` GFP flags. h](j)}(h ``gfp_t gfp``h]jS)}(hjlh]h gfp_t gfp}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjlubah}(h]h ]h"]h$]h&]uh1jhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chM hjlubj)}(hhh]jM)}(h GFP flags.h]h GFP flags.}(hj.lhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj*lhM hj+lubah}(h]h ]h"]h$]h&]uh1jhjlubeh}(h]h ]h"]h$]h&]uh1jhj*lhM hj lubj)}(h"``int order`` Order of the folio. h](j)}(h ``int order``h]jS)}(hjNlh]h int order}(hjPlhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjLlubah}(h]h ]h"]h$]h&]uh1jhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chM hjHlubj)}(hhh]jM)}(hOrder of the folio.h]hOrder of the folio.}(hjglhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjclhM hjdlubah}(h]h ]h"]h$]h&]uh1jhjHlubeh}(h]h ]h"]h$]h&]uh1jhjclhM hj lubj)}(h/``struct vm_area_struct *vma`` Pointer to VMA. h](j)}(h``struct vm_area_struct *vma``h]jS)}(hjlh]hstruct vm_area_struct *vma}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjlubah}(h]h ]h"]h$]h&]uh1jhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chM hjlubj)}(hhh]jM)}(hPointer to VMA.h]hPointer to VMA.}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjlhM hjlubah}(h]h ]h"]h$]h&]uh1jhjlubeh}(h]h ]h"]h$]h&]uh1jhjlhM hj lubj)}(hS``unsigned long addr`` Virtual address of the allocation. Must be inside **vma**. h](j)}(h``unsigned long addr``h]jS)}(hjlh]hunsigned long addr}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjlubah}(h]h ]h"]h$]h&]uh1jhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chM hjlubj)}(hhh]jM)}(h;Virtual address of the allocation. Must be inside **vma**.h](h3Virtual address of the allocation. Must be inside }(hjlhhhNhNubj)}(h**vma**h]hvma}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjlubh.}(hjlhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhjlhM hjlubah}(h]h ]h"]h$]h&]uh1jhjlubeh}(h]h ]h"]h$]h&]uh1jhjlhM hj lubeh}(h]h ]h"]h$]h&]uh1jhjkubjM)}(h**Description**h]j)}(hj mh]h Description}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj mubah}(h]h ]h"]h$]h&]uh1jLhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chM hjkubjM)}(hXhAllocate a folio for a specific address in **vma**, using the appropriate NUMA policy. The caller must hold the mmap_lock of the mm_struct of the VMA to prevent it from going away. Should be used for all allocations for folios that will be mapped into user space, excepting hugetlbfs, and excepting where direct use of folio_alloc_mpol() is more appropriate.h](h+Allocate a folio for a specific address in }(hj#mhhhNhNubj)}(h**vma**h]hvma}(hj+mhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj#mubhX6, using the appropriate NUMA policy. The caller must hold the mmap_lock of the mm_struct of the VMA to prevent it from going away. Should be used for all allocations for folios that will be mapped into user space, excepting hugetlbfs, and excepting where direct use of folio_alloc_mpol() is more appropriate.}(hj#mhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chM hjkubjM)}(h **Return**h]j)}(hjFmh]hReturn}(hjHmhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjDmubah}(h]h ]h"]h$]h&]uh1jLhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chM hjkubjM)}(h1The folio on success or NULL if allocation fails.h]h1The folio on success or NULL if allocation fails.}(hj\mhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chM hjkubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](halloc_pages (C function) c.alloc_pageshNtauh1hhjKhhhNhNubh)}(hhh](h)}(h9struct page * alloc_pages (gfp_t gfp, unsigned int order)h]h)}(h7struct page *alloc_pages(gfp_t gfp, unsigned int order)h](j)}(hjJ,h]hstruct}(hjmhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmhhhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chM ubj)}(h h]h }(hjmhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmhhhjmhM ubh)}(hhh]j)}(hpageh]hpage}(hjmhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmmodnameN classnameNjj)}j]j)}j alloc_pagessb c.alloc_pagesasbuh1hhjmhhhjmhM ubj)}(h h]h }(hjmhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmhhhjmhM ubjr)}(hjuh]h*}(hjmhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjmhhhjmhM ubh)}(h alloc_pagesh]j)}(hjmh]h alloc_pages}(hjmhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmubah}(h]h ](jjeh"]h$]h&]jjuh1hhjmhhhjmhM ubj8)}(h(gfp_t gfp, unsigned int order)h](j>)}(h gfp_t gfph](h)}(hhh]j)}(hgfp_th]hgfp_t}(hjnhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj nmodnameN classnameNjj)}j]jm c.alloc_pagesasbuh1hhjnubj)}(h h]h }(hj&nhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnubj)}(hgfph]hgfp}(hj4nhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjmubj>)}(hunsigned int orderh](j)}(hunsignedh]hunsigned}(hjMnhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjInubj)}(h h]h }(hj[nhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjInubj)}(hinth]hint}(hjinhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjInubj)}(h h]h }(hjwnhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjInubj)}(horderh]horder}(hjnhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjInubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjmubeh}(h]h ]h"]h$]h&]jjuh1j7hjmhhhjmhM ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjmhhhjmhM ubah}(h]j~mah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjmhM hjmhhubj4)}(hhh]jM)}(hAllocate pages.h]hAllocate pages.}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chM hjnhhubah}(h]h ]h"]h$]h&]uh1j3hjmhhhjmhM ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjnjHjnjIjJjKuh1hhhhjKhNhNubj)}(hX"**Parameters** ``gfp_t gfp`` GFP flags. ``unsigned int order`` Power of two of number of pages to allocate. **Description** Allocate 1 << **order** contiguous pages. The physical address of the first page is naturally aligned (eg an order-3 allocation will be aligned to a multiple of 8 * PAGE_SIZE bytes). The NUMA policy of the current process is honoured when in process context. **Context** Can be called from any context, providing the appropriate GFP flags are used. **Return** The page on success or NULL if allocation fails.h](jM)}(h**Parameters**h]j)}(hjnh]h Parameters}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjnubah}(h]h ]h"]h$]h&]uh1jLhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chM hjnubj)}(hhh](j)}(h``gfp_t gfp`` GFP flags. h](j)}(h ``gfp_t gfp``h]jS)}(hjnh]h gfp_t gfp}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjnubah}(h]h ]h"]h$]h&]uh1jhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chM hjnubj)}(hhh]jM)}(h GFP flags.h]h GFP flags.}(hj ohhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjohM hjoubah}(h]h ]h"]h$]h&]uh1jhjnubeh}(h]h ]h"]h$]h&]uh1jhjohM hjnubj)}(hD``unsigned int order`` Power of two of number of pages to allocate. h](j)}(h``unsigned int order``h]jS)}(hj)oh]hunsigned int order}(hj+ohhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj'oubah}(h]h ]h"]h$]h&]uh1jhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chM hj#oubj)}(hhh]jM)}(h,Power of two of number of pages to allocate.h]h,Power of two of number of pages to allocate.}(hjBohhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj>ohM hj?oubah}(h]h ]h"]h$]h&]uh1jhj#oubeh}(h]h ]h"]h$]h&]uh1jhj>ohM hjnubeh}(h]h ]h"]h$]h&]uh1jhjnubjM)}(h**Description**h]j)}(hjdoh]h Description}(hjfohhhNhNubah}(h]h ]h"]h$]h&]uh1jhjboubah}(h]h ]h"]h$]h&]uh1jLhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chM hjnubjM)}(hXAllocate 1 << **order** contiguous pages. The physical address of the first page is naturally aligned (eg an order-3 allocation will be aligned to a multiple of 8 * PAGE_SIZE bytes). The NUMA policy of the current process is honoured when in process context.h](hAllocate 1 << }(hjzohhhNhNubj)}(h **order**h]horder}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1jhjzoubh contiguous pages. The physical address of the first page is naturally aligned (eg an order-3 allocation will be aligned to a multiple of 8 * PAGE_SIZE bytes). The NUMA policy of the current process is honoured when in process context.}(hjzohhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chM hjnubjM)}(h **Context**h]j)}(hjoh]hContext}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1jhjoubah}(h]h ]h"]h$]h&]uh1jLhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chM# hjnubjM)}(hMCan be called from any context, providing the appropriate GFP flags are used.h]hMCan be called from any context, providing the appropriate GFP flags are used.}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1jLhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chM$ hjnubjM)}(h **Return**h]j)}(hjoh]hReturn}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1jhjoubah}(h]h ]h"]h$]h&]uh1jLhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chM' hjnubjM)}(h0The page on success or NULL if allocation fails.h]h0The page on success or NULL if allocation fails.}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1jLhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chM& hjnubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hmpol_misplaced (C function)c.mpol_misplacedhNtauh1hhjKhhhNhNubh)}(hhh](h)}(hRint mpol_misplaced (struct folio *folio, struct vm_fault *vmf, unsigned long addr)h]h)}(hQint mpol_misplaced(struct folio *folio, struct vm_fault *vmf, unsigned long addr)h](j)}(hinth]hint}(hj phhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjphhhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chM ubj)}(h h]h }(hjphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjphhhjphM ubh)}(hmpol_misplacedh]j)}(hmpol_misplacedh]hmpol_misplaced}(hj*phhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&pubah}(h]h ](jjeh"]h$]h&]jjuh1hhjphhhjphM ubj8)}(h?(struct folio *folio, struct vm_fault *vmf, unsigned long addr)h](j>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hjFphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBpubj)}(h h]h }(hjSphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBpubh)}(hhh]j)}(hfolioh]hfolio}(hjdphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjapubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjfpmodnameN classnameNjj)}j]j)}jj,psbc.mpol_misplacedasbuh1hhjBpubj)}(h h]h }(hjphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBpubjr)}(hjuh]h*}(hjphhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjBpubj)}(hfolioh]hfolio}(hjphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBpubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj>pubj>)}(hstruct vm_fault *vmfh](j)}(hjJ,h]hstruct}(hjphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpubj)}(h h]h }(hjphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpubh)}(hhh]j)}(hvm_faulth]hvm_fault}(hjphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjpmodnameN classnameNjj)}j]jpc.mpol_misplacedasbuh1hhjpubj)}(h h]h }(hjphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpubjr)}(hjuh]h*}(hjqhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjpubj)}(hvmfh]hvmf}(hjqhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj>pubj>)}(hunsigned long addrh](j)}(hunsignedh]hunsigned}(hj(qhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$qubj)}(h h]h }(hj6qhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$qubj)}(hlongh]hlong}(hjDqhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$qubj)}(h h]h }(hjRqhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$qubj)}(haddrh]haddr}(hj`qhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$qubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj>pubeh}(h]h ]h"]h$]h&]jjuh1j7hjphhhjphM ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjphhhjphM ubah}(h]joah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjphM hjohhubj4)}(hhh]jM)}(h3check whether current folio node is valid in policyh]h3check whether current folio node is valid in policy}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chM hjqhhubah}(h]h ]h"]h$]h&]uh1j3hjohhhjphM ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjqjHjqjIjJjKuh1hhhhjKhNhNubj)}(hX=**Parameters** ``struct folio *folio`` folio to be checked ``struct vm_fault *vmf`` structure describing the fault ``unsigned long addr`` virtual address in **vma** for shared policy lookup and interleave policy **Description** Lookup current policy node id for vma,addr and "compare to" folio's node id. Policy determination "mimics" alloc_page_vma(). Called from fault path where we know the vma and faulting address. **Return** NUMA_NO_NODE if the page is in a node that is valid for this policy, or a suitable node ID to allocate a replacement folio from.h](jM)}(h**Parameters**h]j)}(hjqh]h Parameters}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjqubah}(h]h ]h"]h$]h&]uh1jLhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chM hjqubj)}(hhh](j)}(h,``struct folio *folio`` folio to be checked h](j)}(h``struct folio *folio``h]jS)}(hjqh]hstruct folio *folio}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjqubah}(h]h ]h"]h$]h&]uh1jhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chM hjqubj)}(hhh]jM)}(hfolio to be checkedh]hfolio to be checked}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjqhM hjqubah}(h]h ]h"]h$]h&]uh1jhjqubeh}(h]h ]h"]h$]h&]uh1jhjqhM hjqubj)}(h8``struct vm_fault *vmf`` structure describing the fault h](j)}(h``struct vm_fault *vmf``h]jS)}(hjrh]hstruct vm_fault *vmf}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjrubah}(h]h ]h"]h$]h&]uh1jhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chM hjqubj)}(hhh]jM)}(hstructure describing the faulth]hstructure describing the fault}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjrhM hjrubah}(h]h ]h"]h$]h&]uh1jhjqubeh}(h]h ]h"]h$]h&]uh1jhjrhM hjqubj)}(ha``unsigned long addr`` virtual address in **vma** for shared policy lookup and interleave policy h](j)}(h``unsigned long addr``h]jS)}(hj=rh]hunsigned long addr}(hj?rhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj;rubah}(h]h ]h"]h$]h&]uh1jhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chM hj7rubj)}(hhh]jM)}(hIvirtual address in **vma** for shared policy lookup and interleave policyh](hvirtual address in }(hjVrhhhNhNubj)}(h**vma**h]hvma}(hj^rhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjVrubh/ for shared policy lookup and interleave policy}(hjVrhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhjRrhM hjSrubah}(h]h ]h"]h$]h&]uh1jhj7rubeh}(h]h ]h"]h$]h&]uh1jhjRrhM hjqubeh}(h]h ]h"]h$]h&]uh1jhjqubjM)}(h**Description**h]j)}(hjrh]h Description}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjrubah}(h]h ]h"]h$]h&]uh1jLhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chM hjqubjM)}(hLookup current policy node id for vma,addr and "compare to" folio's node id. Policy determination "mimics" alloc_page_vma(). Called from fault path where we know the vma and faulting address.h]hLookup current policy node id for vma,addr and “compare to” folio’s node id. Policy determination “mimics” alloc_page_vma(). Called from fault path where we know the vma and faulting address.}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chM hjqubjM)}(h **Return**h]j)}(hjrh]hReturn}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjrubah}(h]h ]h"]h$]h&]uh1jLhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chM hjqubjM)}(hNUMA_NO_NODE if the page is in a node that is valid for this policy, or a suitable node ID to allocate a replacement folio from.h]hNUMA_NO_NODE if the page is in a node that is valid for this policy, or a suitable node ID to allocate a replacement folio from.}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chM hjqubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h$mpol_shared_policy_init (C function)c.mpol_shared_policy_inithNtauh1hhjKhhhNhNubh)}(hhh](h)}(hOvoid mpol_shared_policy_init (struct shared_policy *sp, struct mempolicy *mpol)h]h)}(hNvoid mpol_shared_policy_init(struct shared_policy *sp, struct mempolicy *mpol)h](j)}(hvoidh]hvoid}(hjrhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjrhhhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chM ubj)}(h h]h }(hjshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjrhhhjshM ubh)}(hmpol_shared_policy_inith]j)}(hmpol_shared_policy_inith]hmpol_shared_policy_init}(hjshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjsubah}(h]h ](jjeh"]h$]h&]jjuh1hhjrhhhjshM ubj8)}(h2(struct shared_policy *sp, struct mempolicy *mpol)h](j>)}(hstruct shared_policy *sph](j)}(hjJ,h]hstruct}(hj3shhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/subj)}(h h]h }(hj@shhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/subh)}(hhh]j)}(h shared_policyh]h shared_policy}(hjQshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNsubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjSsmodnameN classnameNjj)}j]j)}jjssbc.mpol_shared_policy_initasbuh1hhj/subj)}(h h]h }(hjqshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/subjr)}(hjuh]h*}(hjshhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj/subj)}(hsph]hsp}(hjshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/subeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj+subj>)}(hstruct mempolicy *mpolh](j)}(hjJ,h]hstruct}(hjshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjsubj)}(h h]h }(hjshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjsubh)}(hhh]j)}(h mempolicyh]h mempolicy}(hjshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjsubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjsmodnameN classnameNjj)}j]jmsc.mpol_shared_policy_initasbuh1hhjsubj)}(h h]h }(hjshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjsubjr)}(hjuh]h*}(hjshhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjsubj)}(hmpolh]hmpol}(hjshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjsubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj+subeh}(h]h ]h"]h$]h&]jjuh1j7hjrhhhjshM ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjrhhhjshM ubah}(h]jrah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjshM hjrhhubj4)}(hhh]jM)}(h"initialize shared policy for inodeh]h"initialize shared policy for inode}(hj&thhhNhNubah}(h]h ]h"]h$]h&]uh1jLhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chM hj#thhubah}(h]h ]h"]h$]h&]uh1j3hjrhhhjshM ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj>tjHj>tjIjJjKuh1hhhhjKhNhNubj)}(hXv**Parameters** ``struct shared_policy *sp`` pointer to inode shared policy ``struct mempolicy *mpol`` struct mempolicy to install **Description** Install non-NULL **mpol** in inode's shared policy rb-tree. On entry, the current task has a reference on a non-NULL **mpol**. This must be released on exit. This is called at get_inode() calls and we can use GFP_KERNEL.h](jM)}(h**Parameters**h]j)}(hjHth]h Parameters}(hjJthhhNhNubah}(h]h ]h"]h$]h&]uh1jhjFtubah}(h]h ]h"]h$]h&]uh1jLhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chM hjBtubj)}(hhh](j)}(h<``struct shared_policy *sp`` pointer to inode shared policy h](j)}(h``struct shared_policy *sp``h]jS)}(hjgth]hstruct shared_policy *sp}(hjithhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjetubah}(h]h ]h"]h$]h&]uh1jhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chM hjatubj)}(hhh]jM)}(hpointer to inode shared policyh]hpointer to inode shared policy}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj|thM hj}tubah}(h]h ]h"]h$]h&]uh1jhjatubeh}(h]h ]h"]h$]h&]uh1jhj|thM hj^tubj)}(h7``struct mempolicy *mpol`` struct mempolicy to install h](j)}(h``struct mempolicy *mpol``h]jS)}(hjth]hstruct mempolicy *mpol}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjtubah}(h]h ]h"]h$]h&]uh1jhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chM hjtubj)}(hhh]jM)}(hstruct mempolicy to installh]hstruct mempolicy to install}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjthM hjtubah}(h]h ]h"]h$]h&]uh1jhjtubeh}(h]h ]h"]h$]h&]uh1jhjthM hj^tubeh}(h]h ]h"]h$]h&]uh1jhjBtubjM)}(h**Description**h]j)}(hjth]h Description}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jhjtubah}(h]h ]h"]h$]h&]uh1jLhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chM hjBtubjM)}(hInstall non-NULL **mpol** in inode's shared policy rb-tree. On entry, the current task has a reference on a non-NULL **mpol**. This must be released on exit. This is called at get_inode() calls and we can use GFP_KERNEL.h](hInstall non-NULL }(hjthhhNhNubj)}(h**mpol**h]hmpol}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jhjtubh^ in inode’s shared policy rb-tree. On entry, the current task has a reference on a non-NULL }(hjthhhNhNubj)}(h**mpol**h]hmpol}(hj uhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjtubh_. This must be released on exit. This is called at get_inode() calls and we can use GFP_KERNEL.}(hjthhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chM hjBtubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hmpol_parse_str (C function)c.mpol_parse_strhNtauh1hhjKhhhNhNubh)}(hhh](h)}(h7int mpol_parse_str (char *str, struct mempolicy **mpol)h]h)}(h6int mpol_parse_str(char *str, struct mempolicy **mpol)h](j)}(hinth]hint}(hjDuhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@uhhhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chMr ubj)}(h h]h }(hjSuhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@uhhhjRuhMr ubh)}(hmpol_parse_strh]j)}(hmpol_parse_strh]hmpol_parse_str}(hjeuhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjauubah}(h]h ](jjeh"]h$]h&]jjuh1hhj@uhhhjRuhMr ubj8)}(h$(char *str, struct mempolicy **mpol)h](j>)}(h char *strh](j)}(hcharh]hchar}(hjuhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj}uubj)}(h h]h }(hjuhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj}uubjr)}(hjuh]h*}(hjuhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj}uubj)}(hstrh]hstr}(hjuhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj}uubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjyuubj>)}(hstruct mempolicy **mpolh](j)}(hjJ,h]hstruct}(hjuhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjuubj)}(h h]h }(hjuhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjuubh)}(hhh]j)}(h mempolicyh]h mempolicy}(hjuhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjuubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjumodnameN classnameNjj)}j]j)}jjgusbc.mpol_parse_strasbuh1hhjuubj)}(h h]h }(hjvhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjuubjr)}(hjuh]h*}(hjvhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjuubjr)}(hjuh]h*}(hjvhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjuubj)}(hmpolh]hmpol}(hj)vhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjuubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjyuubeh}(h]h ]h"]h$]h&]jjuh1j7hj@uhhhjRuhMr ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj[=][:] **Return** ``0`` on success, else ``1``h](jM)}(h**Parameters**h]j)}(hjuvh]h Parameters}(hjwvhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjsvubah}(h]h ]h"]h$]h&]uh1jLhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chMv hjovubj)}(hhh](j)}(h3``char *str`` string containing mempolicy to parse h](j)}(h ``char *str``h]jS)}(hjvh]h char *str}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjvubah}(h]h ]h"]h$]h&]uh1jhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chMs hjvubj)}(hhh]jM)}(h$string containing mempolicy to parseh]h$string containing mempolicy to parse}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjvhMs hjvubah}(h]h ]h"]h$]h&]uh1jhjvubeh}(h]h ]h"]h$]h&]uh1jhjvhMs hjvubj)}(hV``struct mempolicy **mpol`` pointer to struct mempolicy pointer, returned on success. h](j)}(h``struct mempolicy **mpol``h]jS)}(hjvh]hstruct mempolicy **mpol}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjvubah}(h]h ]h"]h$]h&]uh1jhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chMt hjvubj)}(hhh]jM)}(h9pointer to struct mempolicy pointer, returned on success.h]h9pointer to struct mempolicy pointer, returned on success.}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjvhMt hjvubah}(h]h ]h"]h$]h&]uh1jhjvubeh}(h]h ]h"]h$]h&]uh1jhjvhMt hjvubeh}(h]h ]h"]h$]h&]uh1jhjovubjM)}(h**Description**h]j)}(hjwh]h Description}(hj whhhNhNubah}(h]h ]h"]h$]h&]uh1jhjwubah}(h]h ]h"]h$]h&]uh1jLhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chMv hjovubj)}(hhh]j)}(h/Format of input: [=][:] h](j)}(hFormat of input:h]hFormat of input:}(hj%whhhNhNubah}(h]h ]h"]h$]h&]uh1jhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chMv hj!wubj)}(hhh]jM)}(h[=][:]h]h[=][:]}(hj7whhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj3whMv hj4wubah}(h]h ]h"]h$]h&]uh1jhj!wubeh}(h]h ]h"]h$]h&]uh1jhj3whMv hjwubah}(h]h ]h"]h$]h&]uh1jhjovubjM)}(h **Return**h]j)}(hjYwh]hReturn}(hj[whhhNhNubah}(h]h ]h"]h$]h&]uh1jhjWwubah}(h]h ]h"]h$]h&]uh1jLhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chMx hjovubjM)}(h``0`` on success, else ``1``h](jS)}(h``0``h]h0}(hjswhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjowubh on success, else }(hjowhhhNhNubjS)}(h``1``h]h1}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjowubeh}(h]h ]h"]h$]h&]uh1jLhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chMy hjovubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hmpol_to_str (C function) c.mpol_to_strhNtauh1hhjKhhhNhNubh)}(hhh](h)}(hBvoid mpol_to_str (char *buffer, int maxlen, struct mempolicy *pol)h]h)}(hAvoid mpol_to_str(char *buffer, int maxlen, struct mempolicy *pol)h](j)}(hvoidh]hvoid}(hjwhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjwhhhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chM ubj)}(h h]h }(hjwhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjwhhhjwhM ubh)}(h mpol_to_strh]j)}(h mpol_to_strh]h mpol_to_str}(hjwhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjwubah}(h]h ](jjeh"]h$]h&]jjuh1hhjwhhhjwhM ubj8)}(h1(char *buffer, int maxlen, struct mempolicy *pol)h](j>)}(h char *bufferh](j)}(hcharh]hchar}(hjwhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjwubj)}(h h]h }(hjxhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjwubjr)}(hjuh]h*}(hjxhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjwubj)}(hbufferh]hbuffer}(hj xhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjwubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjwubj>)}(h int maxlenh](j)}(hinth]hint}(hj9xhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5xubj)}(h h]h }(hjGxhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5xubj)}(hmaxlenh]hmaxlen}(hjUxhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5xubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjwubj>)}(hstruct mempolicy *polh](j)}(hjJ,h]hstruct}(hjnxhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjjxubj)}(h h]h }(hj{xhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjjxubh)}(hhh]j)}(h mempolicyh]h mempolicy}(hjxhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjxubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjxmodnameN classnameNjj)}j]j)}jjwsb c.mpol_to_strasbuh1hhjjxubj)}(h h]h }(hjxhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjjxubjr)}(hjuh]h*}(hjxhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjjxubj)}(hpolh]hpol}(hjxhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjjxubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjwubeh}(h]h ]h"]h$]h&]jjuh1j7hjwhhhjwhM ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjwhhhjwhM ubah}(h]jwah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjwhM hjwhhubj4)}(hhh]jM)}(h)format a mempolicy structure for printingh]h)format a mempolicy structure for printing}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chM hjxhhubah}(h]h ]h"]h$]h&]uh1j3hjwhhhjwhM ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj yjHj yjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``char *buffer`` to contain formatted mempolicy string ``int maxlen`` length of **buffer** ``struct mempolicy *pol`` pointer to mempolicy to be formatted **Description** Convert **pol** into a string. If **buffer** is too short, truncate the string. Recommend a **maxlen** of at least 51 for the longest mode, "weighted interleave", plus the longest flag flags, "relative|balancing", and to display at least a few node ids.h](jM)}(h**Parameters**h]j)}(hjyh]h Parameters}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjyubah}(h]h ]h"]h$]h&]uh1jLhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chM hj yubj)}(hhh](j)}(h7``char *buffer`` to contain formatted mempolicy string h](j)}(h``char *buffer``h]jS)}(hj2yh]h char *buffer}(hj4yhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj0yubah}(h]h ]h"]h$]h&]uh1jhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chM hj,yubj)}(hhh]jM)}(h%to contain formatted mempolicy stringh]h%to contain formatted mempolicy string}(hjKyhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjGyhM hjHyubah}(h]h ]h"]h$]h&]uh1jhj,yubeh}(h]h ]h"]h$]h&]uh1jhjGyhM hj)yubj)}(h$``int maxlen`` length of **buffer** h](j)}(h``int maxlen``h]jS)}(hjkyh]h int maxlen}(hjmyhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjiyubah}(h]h ]h"]h$]h&]uh1jhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chM hjeyubj)}(hhh]jM)}(hlength of **buffer**h](h length of }(hjyhhhNhNubj)}(h **buffer**h]hbuffer}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjyubeh}(h]h ]h"]h$]h&]uh1jLhjyhM hjyubah}(h]h ]h"]h$]h&]uh1jhjeyubeh}(h]h ]h"]h$]h&]uh1jhjyhM hj)yubj)}(h?``struct mempolicy *pol`` pointer to mempolicy to be formatted h](j)}(h``struct mempolicy *pol``h]jS)}(hjyh]hstruct mempolicy *pol}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjyubah}(h]h ]h"]h$]h&]uh1jhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chM hjyubj)}(hhh]jM)}(h$pointer to mempolicy to be formattedh]h$pointer to mempolicy to be formatted}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjyhM hjyubah}(h]h ]h"]h$]h&]uh1jhjyubeh}(h]h ]h"]h$]h&]uh1jhjyhM hj)yubeh}(h]h ]h"]h$]h&]uh1jhj yubjM)}(h**Description**h]j)}(hjyh]h Description}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjyubah}(h]h ]h"]h$]h&]uh1jLhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chM hj yubjM)}(hConvert **pol** into a string. If **buffer** is too short, truncate the string. Recommend a **maxlen** of at least 51 for the longest mode, "weighted interleave", plus the longest flag flags, "relative|balancing", and to display at least a few node ids.h](hConvert }(hjzhhhNhNubj)}(h**pol**h]hpol}(hj zhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjzubh into a string. If }(hjzhhhNhNubj)}(h **buffer**h]hbuffer}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjzubh0 is too short, truncate the string. Recommend a }(hjzhhhNhNubj)}(h **maxlen**h]hmaxlen}(hj/zhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjzubh of at least 51 for the longest mode, “weighted interleave”, plus the longest flag flags, “relative|balancing”, and to display at least a few node ids.}(hjzhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhO/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:114: ./mm/mempolicy.chM hj yubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hsoftleaf_t (C type) c.softleaf_thNtauh1hhjKhhhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhNubh)}(hhh](h)}(h softleaf_th]h)}(htype softleaf_th](j)}(hjh]htype}(hjizhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjezhhhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhKubj)}(h h]h }(hjwzhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjezhhhjvzhKubh)}(h softleaf_th]j)}(hjczh]h softleaf_t}(hjzhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjzubah}(h]h ](jjeh"]h$]h&]jjuh1hhjezhhhjvzhKubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjazhhhjvzhKubah}(h]j[zah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjvzhKhj^zhhubj4)}(hhh]jM)}(h_Describes a page table software leaf entry, abstracted from its architecture-specific encoding.h]h_Describes a page table software leaf entry, abstracted from its architecture-specific encoding.}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhM#hjzhhubah}(h]h ]h"]h$]h&]uh1j3hj^zhhhjvzhKubeh}(h]h ](jAtypeeh"]h$]h&]jFjAjGjzjHjzjIjJjKuh1hhhhjKhj]zhNubjM)}(h**Description**h]j)}(hjzh]h Description}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjzubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhM%hjKhhubjM)}(hPage table leaf entries are those which do not reference any descendent page tables but rather either reference a data page, are an empty (or 'none' entry), or contain a non-present entry.h]hPage table leaf entries are those which do not reference any descendent page tables but rather either reference a data page, are an empty (or ‘none’ entry), or contain a non-present entry.}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhM$hjKhhubjM)}(hIf referencing another page table or a data page then the page table entry is pertinent to hardware - that is it tells the hardware how to decode the page table entry.h]hIf referencing another page table or a data page then the page table entry is pertinent to hardware - that is it tells the hardware how to decode the page table entry.}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhM(hjKhhubjM)}(hOtherwise it is a software-defined leaf page table entry, which this type describes. See leafops.h and specifically **softleaf_type** for a list of all possible kinds of software leaf entry.h](htOtherwise it is a software-defined leaf page table entry, which this type describes. See leafops.h and specifically }(hjzhhhNhNubj)}(h**softleaf_type**h]h softleaf_type}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjzubh9 for a list of all possible kinds of software leaf entry.}(hjzhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhM,hjKhhubjM)}(heA softleaf_t entry is abstracted from the hardware page table entry, so is not architecture-specific.h]heA softleaf_t entry is abstracted from the hardware page table entry, so is not architecture-specific.}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhM0hjKhhubjM)}(h**NOTE**h]j)}(hj/{h]hNOTE}(hj1{hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj-{ubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhM3hjKhhubj)}(hhh]j)}(hWhile we transition from the confusing swp_entry_t type used for this purpose, we simply alias this type. This will be removed once the transition is complete. h](j)}(hEWhile we transition from the confusing swp_entry_t type used for thish]hEWhile we transition from the confusing swp_entry_t type used for this}(hjL{hhhNhNubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhM:hjH{ubj)}(hhh]jM)}(hYpurpose, we simply alias this type. This will be removed once the transition is complete.h]hYpurpose, we simply alias this type. This will be removed once the transition is complete.}(hj^{hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhM6hj[{ubah}(h]h ]h"]h$]h&]uh1jhjH{ubeh}(h]h ]h"]h$]h&]uh1jhjZ{hM:hjE{ubah}(h]h ]h"]h$]h&]uh1jhjKhhhj]zhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfolio (C struct)c.foliohNtauh1hhjKhhhj]zhNubh)}(hhh](h)}(hfolioh]h)}(h struct folioh](j)}(hjJ,h]hstruct}(hj{hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{hhhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhM<ubj)}(h h]h }(hj{hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{hhhj{hM<ubh)}(hfolioh]j)}(hj{h]hfolio}(hj{hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj{hhhj{hM<ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj{hhhj{hM<ubah}(h]j{ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj{hM<hj{hhubj4)}(hhh]jM)}(h%Represents a contiguous set of bytes.h]h%Represents a contiguous set of bytes.}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMghj{hhubah}(h]h ]h"]h$]h&]uh1j3hj{hhhj{hM<ubeh}(h]h ](jAstructeh"]h$]h&]jFjAjGj{jHj{jIjJjKuh1hhhhjKhj]zhNubj)}(hX**Definition**:: struct folio { memdesc_flags_t flags; union { struct list_head lru; unsigned int mlock_count; struct dev_pagemap *pgmap; }; struct address_space *mapping; union { pgoff_t index; unsigned long share; }; union { void *private; swp_entry_t swap; unsigned long migrate_info; }; atomic_t _mapcount; atomic_t _refcount; #ifdef CONFIG_MEMCG; unsigned long memcg_data; #elif defined(CONFIG_SLAB_OBJ_EXT); unsigned long _unused_slab_obj_exts; #endif; #if defined(WANT_PAGE_VIRTUAL); void *virtual; #endif; #ifdef LAST_CPUPID_NOT_IN_PAGE_FLAGS; int _last_cpupid; #endif; atomic_t _large_mapcount; atomic_t _nr_pages_mapped; #ifdef CONFIG_64BIT; atomic_t _entire_mapcount; atomic_t _pincount; #endif ; mm_id_mapcount_t _mm_id_mapcount[2]; union { mm_id_t _mm_id[2]; unsigned long _mm_ids; }; #ifdef NR_PAGES_IN_LARGE_FOLIO; unsigned int _nr_pages; #endif ; struct list_head _deferred_list; #ifndef CONFIG_64BIT; atomic_t _entire_mapcount; atomic_t _pincount; #endif ; void *_hugetlb_subpool; void *_hugetlb_cgroup; void *_hugetlb_cgroup_rsvd; void *_hugetlb_hwpoison; }; **Members** ``flags`` Identical to the page flags. ``{unnamed_union}`` anonymous ``lru`` Least Recently Used list; tracks how recently this folio was used. ``mlock_count`` Number of times this folio has been pinned by mlock(). ``pgmap`` Metadata for ZONE_DEVICE mappings ``mapping`` The file this page belongs to, or refers to the anon_vma for anonymous memory. ``{unnamed_union}`` anonymous ``index`` Offset within the file, in units of pages. For anonymous memory, this is the index from the beginning of the mmap. ``share`` number of DAX mappings that reference this folio. See dax_associate_entry. ``{unnamed_union}`` anonymous ``private`` Filesystem per-folio data (see folio_attach_private()). ``swap`` Used for swp_entry_t if folio_test_swapcache(). ``migrate_info`` Stores migration state (anon_vma pointer and FOLIO_WAS_* markers). ``_mapcount`` Do not access this member directly. Use folio_mapcount() to find out how many times this folio is mapped by userspace. ``_refcount`` Do not access this member directly. Use folio_ref_count() to find how many references there are to this folio. ``memcg_data`` Memory Control Group data. ``_unused_slab_obj_exts`` Placeholder to match obj_exts in struct slab. ``virtual`` Virtual address in the kernel direct map. ``_last_cpupid`` IDs of last CPU and last process that accessed the folio. ``_large_mapcount`` Do not use directly, call folio_mapcount(). ``_nr_pages_mapped`` Do not use outside of rmap and debug code. ``_entire_mapcount`` Do not use directly, call folio_entire_mapcount(). ``_pincount`` Do not use directly, call folio_maybe_dma_pinned(). ``_mm_id_mapcount`` Do not use outside of rmap code. ``{unnamed_union}`` anonymous ``_mm_id`` Do not use outside of rmap code. ``_mm_ids`` Do not use outside of rmap code. ``_nr_pages`` Do not use directly, call folio_nr_pages(). ``_deferred_list`` Folios to be split under memory pressure. ``_entire_mapcount`` Do not use directly, call folio_entire_mapcount(). ``_pincount`` Do not use directly, call folio_maybe_dma_pinned(). ``_hugetlb_subpool`` Do not use directly, use accessor in hugetlb.h. ``_hugetlb_cgroup`` Do not use directly, use accessor in hugetlb_cgroup.h. ``_hugetlb_cgroup_rsvd`` Do not use directly, use accessor in hugetlb_cgroup.h. ``_hugetlb_hwpoison`` Do not use directly, call raw_hwp_list_head().h](jM)}(h**Definition**::h](j)}(h**Definition**h]h Definition}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj{ubh:}(hj{hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMkhj{ubj7 )}(hXstruct folio { memdesc_flags_t flags; union { struct list_head lru; unsigned int mlock_count; struct dev_pagemap *pgmap; }; struct address_space *mapping; union { pgoff_t index; unsigned long share; }; union { void *private; swp_entry_t swap; unsigned long migrate_info; }; atomic_t _mapcount; atomic_t _refcount; #ifdef CONFIG_MEMCG; unsigned long memcg_data; #elif defined(CONFIG_SLAB_OBJ_EXT); unsigned long _unused_slab_obj_exts; #endif; #if defined(WANT_PAGE_VIRTUAL); void *virtual; #endif; #ifdef LAST_CPUPID_NOT_IN_PAGE_FLAGS; int _last_cpupid; #endif; atomic_t _large_mapcount; atomic_t _nr_pages_mapped; #ifdef CONFIG_64BIT; atomic_t _entire_mapcount; atomic_t _pincount; #endif ; mm_id_mapcount_t _mm_id_mapcount[2]; union { mm_id_t _mm_id[2]; unsigned long _mm_ids; }; #ifdef NR_PAGES_IN_LARGE_FOLIO; unsigned int _nr_pages; #endif ; struct list_head _deferred_list; #ifndef CONFIG_64BIT; atomic_t _entire_mapcount; atomic_t _pincount; #endif ; void *_hugetlb_subpool; void *_hugetlb_cgroup; void *_hugetlb_cgroup_rsvd; void *_hugetlb_hwpoison; };h]hXstruct folio { memdesc_flags_t flags; union { struct list_head lru; unsigned int mlock_count; struct dev_pagemap *pgmap; }; struct address_space *mapping; union { pgoff_t index; unsigned long share; }; union { void *private; swp_entry_t swap; unsigned long migrate_info; }; atomic_t _mapcount; atomic_t _refcount; #ifdef CONFIG_MEMCG; unsigned long memcg_data; #elif defined(CONFIG_SLAB_OBJ_EXT); unsigned long _unused_slab_obj_exts; #endif; #if defined(WANT_PAGE_VIRTUAL); void *virtual; #endif; #ifdef LAST_CPUPID_NOT_IN_PAGE_FLAGS; int _last_cpupid; #endif; atomic_t _large_mapcount; atomic_t _nr_pages_mapped; #ifdef CONFIG_64BIT; atomic_t _entire_mapcount; atomic_t _pincount; #endif ; mm_id_mapcount_t _mm_id_mapcount[2]; union { mm_id_t _mm_id[2]; unsigned long _mm_ids; }; #ifdef NR_PAGES_IN_LARGE_FOLIO; unsigned int _nr_pages; #endif ; struct list_head _deferred_list; #ifndef CONFIG_64BIT; atomic_t _entire_mapcount; atomic_t _pincount; #endif ; void *_hugetlb_subpool; void *_hugetlb_cgroup; void *_hugetlb_cgroup_rsvd; void *_hugetlb_hwpoison; };}hj|sbah}(h]h ]h"]h$]h&]jjuh1j6 hY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMmhj{ubjM)}(h **Members**h]j)}(hj(|h]hMembers}(hj*|hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj&|ubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMhj{ubj)}(hhh](j)}(h'``flags`` Identical to the page flags. h](j)}(h ``flags``h]jS)}(hjG|h]hflags}(hjI|hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjE|ubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMihjA|ubj)}(hhh]jM)}(hIdentical to the page flags.h]hIdentical to the page flags.}(hj`|hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj\|hMihj]|ubah}(h]h ]h"]h$]h&]uh1jhjA|ubeh}(h]h ]h"]h$]h&]uh1jhj\|hMihj>|ubj)}(h``{unnamed_union}`` anonymous h](j)}(h``{unnamed_union}``h]jS)}(hj|h]h{unnamed_union}}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj~|ubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhKhjz|ubj)}(hhh]jM)}(h anonymoush]h anonymous}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj|hKhj|ubah}(h]h ]h"]h$]h&]uh1jhjz|ubeh}(h]h ]h"]h$]h&]uh1jhj|hKhj>|ubj)}(hK``lru`` Least Recently Used list; tracks how recently this folio was used. h](j)}(h``lru``h]jS)}(hj|h]hlru}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj|ubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMjhj|ubj)}(hhh]jM)}(hBLeast Recently Used list; tracks how recently this folio was used.h]hBLeast Recently Used list; tracks how recently this folio was used.}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj|hMjhj|ubah}(h]h ]h"]h$]h&]uh1jhj|ubeh}(h]h ]h"]h$]h&]uh1jhj|hMjhj>|ubj)}(hG``mlock_count`` Number of times this folio has been pinned by mlock(). h](j)}(h``mlock_count``h]jS)}(hj|h]h mlock_count}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj|ubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMkhj|ubj)}(hhh]jM)}(h6Number of times this folio has been pinned by mlock().h]h6Number of times this folio has been pinned by mlock().}(hj }hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj}hMkhj}ubah}(h]h ]h"]h$]h&]uh1jhj|ubeh}(h]h ]h"]h$]h&]uh1jhj}hMkhj>|ubj)}(h,``pgmap`` Metadata for ZONE_DEVICE mappings h](j)}(h ``pgmap``h]jS)}(hj+}h]hpgmap}(hj-}hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj)}ubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhM{hj%}ubj)}(hhh]jM)}(h!Metadata for ZONE_DEVICE mappingsh]h!Metadata for ZONE_DEVICE mappings}(hjD}hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj@}hM{hjA}ubah}(h]h ]h"]h$]h&]uh1jhj%}ubeh}(h]h ]h"]h$]h&]uh1jhj@}hM{hj>|ubj)}(h[``mapping`` The file this page belongs to, or refers to the anon_vma for anonymous memory. h](j)}(h ``mapping``h]jS)}(hjd}h]hmapping}(hjf}hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjb}ubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMmhj^}ubj)}(hhh]jM)}(hNThe file this page belongs to, or refers to the anon_vma for anonymous memory.h]hNThe file this page belongs to, or refers to the anon_vma for anonymous memory.}(hj}}hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMlhjz}ubah}(h]h ]h"]h$]h&]uh1jhj^}ubeh}(h]h ]h"]h$]h&]uh1jhjy}hMmhj>|ubj)}(h``{unnamed_union}`` anonymous h](j)}(h``{unnamed_union}``h]jS)}(hj}h]h{unnamed_union}}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj}ubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhKhj}ubj)}(hhh]jM)}(h anonymoush]h anonymous}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj}hKhj}ubah}(h]h ]h"]h$]h&]uh1jhj}ubeh}(h]h ]h"]h$]h&]uh1jhj}hKhj>|ubj)}(h~``index`` Offset within the file, in units of pages. For anonymous memory, this is the index from the beginning of the mmap. h](j)}(h ``index``h]jS)}(hj}h]hindex}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj}ubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMohj}ubj)}(hhh]jM)}(hsOffset within the file, in units of pages. For anonymous memory, this is the index from the beginning of the mmap.h]hsOffset within the file, in units of pages. For anonymous memory, this is the index from the beginning of the mmap.}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMnhj}ubah}(h]h ]h"]h$]h&]uh1jhj}ubeh}(h]h ]h"]h$]h&]uh1jhj}hMohj>|ubj)}(hU``share`` number of DAX mappings that reference this folio. See dax_associate_entry. h](j)}(h ``share``h]jS)}(hj~h]hshare}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj~ubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMqhj ~ubj)}(hhh]jM)}(hJnumber of DAX mappings that reference this folio. See dax_associate_entry.h]hJnumber of DAX mappings that reference this folio. See dax_associate_entry.}(hj*~hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMphj'~ubah}(h]h ]h"]h$]h&]uh1jhj ~ubeh}(h]h ]h"]h$]h&]uh1jhj&~hMqhj>|ubj)}(h``{unnamed_union}`` anonymous h](j)}(h``{unnamed_union}``h]jS)}(hjK~h]h{unnamed_union}}(hjM~hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjI~ubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhKhjE~ubj)}(hhh]jM)}(h anonymoush]h anonymous}(hjd~hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj`~hKhja~ubah}(h]h ]h"]h$]h&]uh1jhjE~ubeh}(h]h ]h"]h$]h&]uh1jhj`~hKhj>|ubj)}(hD``private`` Filesystem per-folio data (see folio_attach_private()). h](j)}(h ``private``h]jS)}(hj~h]hprivate}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj~ubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMrhj~~ubj)}(hhh]jM)}(h7Filesystem per-folio data (see folio_attach_private()).h]h7Filesystem per-folio data (see folio_attach_private()).}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj~hMrhj~ubah}(h]h ]h"]h$]h&]uh1jhj~~ubeh}(h]h ]h"]h$]h&]uh1jhj~hMrhj>|ubj)}(h9``swap`` Used for swp_entry_t if folio_test_swapcache(). h](j)}(h``swap``h]jS)}(hj~h]hswap}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj~ubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMshj~ubj)}(hhh]jM)}(h/Used for swp_entry_t if folio_test_swapcache().h]h/Used for swp_entry_t if folio_test_swapcache().}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj~hMshj~ubah}(h]h ]h"]h$]h&]uh1jhj~ubeh}(h]h ]h"]h$]h&]uh1jhj~hMshj>|ubj)}(hT``migrate_info`` Stores migration state (anon_vma pointer and FOLIO_WAS_* markers). h](j)}(h``migrate_info``h]jS)}(hj~h]h migrate_info}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj~ubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMuhj~ubj)}(hhh]jM)}(hBStores migration state (anon_vma pointer and FOLIO_WAS_* markers).h]hBStores migration state (anon_vma pointer and FOLIO_WAS_* markers).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMthj ubah}(h]h ]h"]h$]h&]uh1jhj~ubeh}(h]h ]h"]h$]h&]uh1jhj hMuhj>|ubj)}(h``_mapcount`` Do not access this member directly. Use folio_mapcount() to find out how many times this folio is mapped by userspace. h](j)}(h ``_mapcount``h]jS)}(hj0h]h _mapcount}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj.ubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMwhj*ubj)}(hhh]jM)}(hwDo not access this member directly. Use folio_mapcount() to find out how many times this folio is mapped by userspace.h]hwDo not access this member directly. Use folio_mapcount() to find out how many times this folio is mapped by userspace.}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMvhjFubah}(h]h ]h"]h$]h&]uh1jhj*ubeh}(h]h ]h"]h$]h&]uh1jhjEhMwhj>|ubj)}(h~``_refcount`` Do not access this member directly. Use folio_ref_count() to find how many references there are to this folio. h](j)}(h ``_refcount``h]jS)}(hjjh]h _refcount}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjhubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMyhjdubj)}(hhh]jM)}(hoDo not access this member directly. Use folio_ref_count() to find how many references there are to this folio.h]hoDo not access this member directly. Use folio_ref_count() to find how many references there are to this folio.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMxhjubah}(h]h ]h"]h$]h&]uh1jhjdubeh}(h]h ]h"]h$]h&]uh1jhjhMyhj>|ubj)}(h*``memcg_data`` Memory Control Group data. h](j)}(h``memcg_data``h]jS)}(hjh]h memcg_data}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMzhjubj)}(hhh]jM)}(hMemory Control Group data.h]hMemory Control Group data.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMzhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMzhj>|ubj)}(hH``_unused_slab_obj_exts`` Placeholder to match obj_exts in struct slab. h](j)}(h``_unused_slab_obj_exts``h]jS)}(hjh]h_unused_slab_obj_exts}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMhjubj)}(hhh]jM)}(h-Placeholder to match obj_exts in struct slab.h]h-Placeholder to match obj_exts in struct slab.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhj>|ubj)}(h6``virtual`` Virtual address in the kernel direct map. h](j)}(h ``virtual``h]jS)}(hjh]hvirtual}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhM|hjubj)}(hhh]jM)}(h)Virtual address in the kernel direct map.h]h)Virtual address in the kernel direct map.}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj+hM|hj,ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj+hM|hj>|ubj)}(hK``_last_cpupid`` IDs of last CPU and last process that accessed the folio. h](j)}(h``_last_cpupid``h]jS)}(hjOh]h _last_cpupid}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjMubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhM}hjIubj)}(hhh]jM)}(h9IDs of last CPU and last process that accessed the folio.h]h9IDs of last CPU and last process that accessed the folio.}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjdhM}hjeubah}(h]h ]h"]h$]h&]uh1jhjIubeh}(h]h ]h"]h$]h&]uh1jhjdhM}hj>|ubj)}(h@``_large_mapcount`` Do not use directly, call folio_mapcount(). h](j)}(h``_large_mapcount``h]jS)}(hjh]h_large_mapcount}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMhjubj)}(hhh]jM)}(h+Do not use directly, call folio_mapcount().h]h+Do not use directly, call folio_mapcount().}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhj>|ubj)}(h@``_nr_pages_mapped`` Do not use outside of rmap and debug code. h](j)}(h``_nr_pages_mapped``h]jS)}(hjh]h_nr_pages_mapped}(hjÀhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMhjubj)}(hhh]jM)}(h*Do not use outside of rmap and debug code.h]h*Do not use outside of rmap and debug code.}(hjڀhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjրhMhj׀ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjրhMhj>|ubj)}(hH``_entire_mapcount`` Do not use directly, call folio_entire_mapcount(). h](j)}(h``_entire_mapcount``h]jS)}(hjh]h_entire_mapcount}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhM~hjubj)}(hhh]jM)}(h2Do not use directly, call folio_entire_mapcount().h]h2Do not use directly, call folio_entire_mapcount().}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM~hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM~hj>|ubj)}(hB``_pincount`` Do not use directly, call folio_maybe_dma_pinned(). h](j)}(h ``_pincount``h]jS)}(hj3h]h _pincount}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj1ubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMhj-ubj)}(hhh]jM)}(h3Do not use directly, call folio_maybe_dma_pinned().h]h3Do not use directly, call folio_maybe_dma_pinned().}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjHhMhjIubah}(h]h ]h"]h$]h&]uh1jhj-ubeh}(h]h ]h"]h$]h&]uh1jhjHhMhj>|ubj)}(h5``_mm_id_mapcount`` Do not use outside of rmap code. h](j)}(h``_mm_id_mapcount``h]jS)}(hjlh]h_mm_id_mapcount}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjjubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMhjfubj)}(hhh]jM)}(h Do not use outside of rmap code.h]h Do not use outside of rmap code.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjfubeh}(h]h ]h"]h$]h&]uh1jhjhMhj>|ubj)}(h``{unnamed_union}`` anonymous h](j)}(h``{unnamed_union}``h]jS)}(hjh]h{unnamed_union}}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhKhjubj)}(hhh]jM)}(h anonymoush]h anonymous}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhj>|ubj)}(h,``_mm_id`` Do not use outside of rmap code. h](j)}(h ``_mm_id``h]jS)}(hjށh]h_mm_id}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj܁ubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMhj؁ubj)}(hhh]jM)}(h Do not use outside of rmap code.h]h Do not use outside of rmap code.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhj؁ubeh}(h]h ]h"]h$]h&]uh1jhjhMhj>|ubj)}(h-``_mm_ids`` Do not use outside of rmap code. h](j)}(h ``_mm_ids``h]jS)}(hjh]h_mm_ids}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMhjubj)}(hhh]jM)}(h Do not use outside of rmap code.h]h Do not use outside of rmap code.}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj,hMhj-ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj,hMhj>|ubj)}(h:``_nr_pages`` Do not use directly, call folio_nr_pages(). h](j)}(h ``_nr_pages``h]jS)}(hjPh]h _nr_pages}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjNubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMhjJubj)}(hhh]jM)}(h+Do not use directly, call folio_nr_pages().h]h+Do not use directly, call folio_nr_pages().}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjehMhjfubah}(h]h ]h"]h$]h&]uh1jhjJubeh}(h]h ]h"]h$]h&]uh1jhjehMhj>|ubj)}(h=``_deferred_list`` Folios to be split under memory pressure. h](j)}(h``_deferred_list``h]jS)}(hjh]h_deferred_list}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMhjubj)}(hhh]jM)}(h)Folios to be split under memory pressure.h]h)Folios to be split under memory pressure.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhj>|ubj)}(hH``_entire_mapcount`` Do not use directly, call folio_entire_mapcount(). h](j)}(h``_entire_mapcount``h]jS)}(hj‚h]h_entire_mapcount}(hjĂhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhM~hjubj)}(hhh]jM)}(h2Do not use directly, call folio_entire_mapcount().h]h2Do not use directly, call folio_entire_mapcount().}(hjۂhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjׂhM~hj؂ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjׂhM~hj>|ubj)}(hB``_pincount`` Do not use directly, call folio_maybe_dma_pinned(). h](j)}(h ``_pincount``h]jS)}(hjh]h _pincount}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMhjubj)}(hhh]jM)}(h3Do not use directly, call folio_maybe_dma_pinned().h]h3Do not use directly, call folio_maybe_dma_pinned().}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhj>|ubj)}(hE``_hugetlb_subpool`` Do not use directly, use accessor in hugetlb.h. h](j)}(h``_hugetlb_subpool``h]jS)}(hj4h]h_hugetlb_subpool}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj2ubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMhj.ubj)}(hhh]jM)}(h/Do not use directly, use accessor in hugetlb.h.h]h/Do not use directly, use accessor in hugetlb.h.}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjIhMhjJubah}(h]h ]h"]h$]h&]uh1jhj.ubeh}(h]h ]h"]h$]h&]uh1jhjIhMhj>|ubj)}(hK``_hugetlb_cgroup`` Do not use directly, use accessor in hugetlb_cgroup.h. h](j)}(h``_hugetlb_cgroup``h]jS)}(hjmh]h_hugetlb_cgroup}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjkubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMhjgubj)}(hhh]jM)}(h6Do not use directly, use accessor in hugetlb_cgroup.h.h]h6Do not use directly, use accessor in hugetlb_cgroup.h.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjgubeh}(h]h ]h"]h$]h&]uh1jhjhMhj>|ubj)}(hP``_hugetlb_cgroup_rsvd`` Do not use directly, use accessor in hugetlb_cgroup.h. h](j)}(h``_hugetlb_cgroup_rsvd``h]jS)}(hjh]h_hugetlb_cgroup_rsvd}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMhjubj)}(hhh]jM)}(h6Do not use directly, use accessor in hugetlb_cgroup.h.h]h6Do not use directly, use accessor in hugetlb_cgroup.h.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhj>|ubj)}(hD``_hugetlb_hwpoison`` Do not use directly, call raw_hwp_list_head().h](j)}(h``_hugetlb_hwpoison``h]jS)}(hj߃h]h_hugetlb_hwpoison}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj݃ubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMhjكubj)}(hhh]jM)}(h.Do not use directly, call raw_hwp_list_head().h]h.Do not use directly, call raw_hwp_list_head().}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMhjubah}(h]h ]h"]h$]h&]uh1jhjكubeh}(h]h ]h"]h$]h&]uh1jhjhMhj>|ubeh}(h]h ]h"]h$]h&]uh1jhj{ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhj]zhNubjM)}(h**Description**h]j)}(hj"h]h Description}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMhjKhhubjM)}(hXA folio is a physically, virtually and logically contiguous set of bytes. It is a power-of-two in size, and it is aligned to that same power-of-two. It is at least as large as ``PAGE_SIZE``. If it is in the page cache, it is at a file offset which is a multiple of that power-of-two. It may be mapped into userspace at an address which is at an arbitrary page offset, but its kernel virtual address is aligned to its size.h](hA folio is a physically, virtually and logically contiguous set of bytes. It is a power-of-two in size, and it is aligned to that same power-of-two. It is at least as large as }(hj8hhhNhNubjS)}(h ``PAGE_SIZE``h]h PAGE_SIZE}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj8ubh. If it is in the page cache, it is at a file offset which is a multiple of that power-of-two. It may be mapped into userspace at an address which is at an arbitrary page offset, but its kernel virtual address is aligned to its size.}(hj8hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMhjKhhubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hptdesc (C struct)c.ptdeschNtauh1hhjKhhhj]zhNubh)}(hhh](h)}(hptdesch]h)}(h struct ptdesch](j)}(hjJ,h]hstruct}(hjrhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnhhhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnhhhjhMubh)}(hptdesch]j)}(hjlh]hptdesc}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjnhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjjhhhjhMubah}(h]jeah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjghhubj4)}(hhh]jM)}(h"Memory descriptor for page tables.h]h"Memory descriptor for page tables.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhM*hjhhubah}(h]h ]h"]h$]h&]uh1j3hjghhhjhMubeh}(h]h ](jAstructeh"]h$]h&]jFjAjGj̄jHj̄jIjJjKuh1hhhhjKhj]zhNubj)}(hX**Definition**:: struct ptdesc { memdesc_flags_t pt_flags; union { struct rcu_head pt_rcu_head; struct list_head pt_list; struct { unsigned long _pt_pad_1; pgtable_t pmd_huge_pte; }; }; unsigned long __page_mapping; union { pgoff_t pt_index; struct mm_struct *pt_mm; atomic_t pt_frag_refcount; #ifdef CONFIG_HUGETLB_PMD_PAGE_TABLE_SHARING; atomic_t pt_share_count; #endif; }; union { unsigned long _pt_pad_2; #if ALLOC_SPLIT_PTLOCKS; spinlock_t *ptl; #else; spinlock_t ptl; #endif; }; unsigned int __page_type; atomic_t __page_refcount; #ifdef CONFIG_MEMCG; unsigned long pt_memcg_data; #endif; }; **Members** ``pt_flags`` enum pt_flags plus zone/node/section. ``{unnamed_union}`` anonymous ``pt_rcu_head`` For freeing page table pages. ``pt_list`` List of used page tables. Used for s390 gmap shadow pages (which are not linked into the user page tables) and x86 pgds. ``{unnamed_struct}`` anonymous ``_pt_pad_1`` Padding that aliases with page's compound head. ``pmd_huge_pte`` Protected by ptdesc->ptl, used for THPs. ``__page_mapping`` Aliases with page->mapping. Unused for page tables. ``{unnamed_union}`` anonymous ``pt_index`` Used for s390 gmap. ``pt_mm`` Used for x86 pgds. ``pt_frag_refcount`` For fragmented page table tracking. Powerpc only. ``pt_share_count`` Used for HugeTLB PMD page table share count. ``{unnamed_union}`` anonymous ``_pt_pad_2`` Padding to ensure proper alignment. ``ptl`` Lock for the page table. ``ptl`` Lock for the page table. ``__page_type`` Same as page->page_type. Unused for page tables. ``__page_refcount`` Same as page refcount. ``pt_memcg_data`` Memcg data. Tracked for page tables here.h](jM)}(h**Definition**::h](j)}(h**Definition**h]h Definition}(hj؄hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjԄubh:}(hjԄhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhM.hjЄubj7 )}(hXstruct ptdesc { memdesc_flags_t pt_flags; union { struct rcu_head pt_rcu_head; struct list_head pt_list; struct { unsigned long _pt_pad_1; pgtable_t pmd_huge_pte; }; }; unsigned long __page_mapping; union { pgoff_t pt_index; struct mm_struct *pt_mm; atomic_t pt_frag_refcount; #ifdef CONFIG_HUGETLB_PMD_PAGE_TABLE_SHARING; atomic_t pt_share_count; #endif; }; union { unsigned long _pt_pad_2; #if ALLOC_SPLIT_PTLOCKS; spinlock_t *ptl; #else; spinlock_t ptl; #endif; }; unsigned int __page_type; atomic_t __page_refcount; #ifdef CONFIG_MEMCG; unsigned long pt_memcg_data; #endif; };h]hXstruct ptdesc { memdesc_flags_t pt_flags; union { struct rcu_head pt_rcu_head; struct list_head pt_list; struct { unsigned long _pt_pad_1; pgtable_t pmd_huge_pte; }; }; unsigned long __page_mapping; union { pgoff_t pt_index; struct mm_struct *pt_mm; atomic_t pt_frag_refcount; #ifdef CONFIG_HUGETLB_PMD_PAGE_TABLE_SHARING; atomic_t pt_share_count; #endif; }; union { unsigned long _pt_pad_2; #if ALLOC_SPLIT_PTLOCKS; spinlock_t *ptl; #else; spinlock_t ptl; #endif; }; unsigned int __page_type; atomic_t __page_refcount; #ifdef CONFIG_MEMCG; unsigned long pt_memcg_data; #endif; };}hjsbah}(h]h ]h"]h$]h&]jjuh1j6 hY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhM0hjЄubjM)}(h **Members**h]j)}(hjh]hMembers}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMRhjЄubj)}(hhh](j)}(h3``pt_flags`` enum pt_flags plus zone/node/section. h](j)}(h ``pt_flags``h]jS)}(hj!h]hpt_flags}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhM,hjubj)}(hhh]jM)}(h%enum pt_flags plus zone/node/section.h]h%enum pt_flags plus zone/node/section.}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj6hM,hj7ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj6hM,hjubj)}(h``{unnamed_union}`` anonymous h](j)}(h``{unnamed_union}``h]jS)}(hjZh]h{unnamed_union}}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjXubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhKhjTubj)}(hhh]jM)}(h anonymoush]h anonymous}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjohKhjpubah}(h]h ]h"]h$]h&]uh1jhjTubeh}(h]h ]h"]h$]h&]uh1jhjohKhjubj)}(h.``pt_rcu_head`` For freeing page table pages. h](j)}(h``pt_rcu_head``h]jS)}(hjh]h pt_rcu_head}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhM-hjubj)}(hhh]jM)}(hFor freeing page table pages.h]hFor freeing page table pages.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM-hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM-hjubj)}(h``pt_list`` List of used page tables. Used for s390 gmap shadow pages (which are not linked into the user page tables) and x86 pgds. h](j)}(h ``pt_list``h]jS)}(hj̅h]hpt_list}(hj΅hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjʅubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhM0hjƅubj)}(hhh]jM)}(hxList of used page tables. Used for s390 gmap shadow pages (which are not linked into the user page tables) and x86 pgds.h]hxList of used page tables. Used for s390 gmap shadow pages (which are not linked into the user page tables) and x86 pgds.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhM.hjubah}(h]h ]h"]h$]h&]uh1jhjƅubeh}(h]h ]h"]h$]h&]uh1jhjhM0hjubj)}(h``{unnamed_struct}`` anonymous h](j)}(h``{unnamed_struct}``h]jS)}(hjh]h{unnamed_struct}}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhKhjubj)}(hhh]jM)}(h anonymoush]h anonymous}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubj)}(h>``_pt_pad_1`` Padding that aliases with page's compound head. h](j)}(h ``_pt_pad_1``h]jS)}(hj?h]h _pt_pad_1}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj=ubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhM1hj9ubj)}(hhh]jM)}(h/Padding that aliases with page's compound head.h]h1Padding that aliases with page’s compound head.}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjThM1hjUubah}(h]h ]h"]h$]h&]uh1jhj9ubeh}(h]h ]h"]h$]h&]uh1jhjThM1hjubj)}(h:``pmd_huge_pte`` Protected by ptdesc->ptl, used for THPs. h](j)}(h``pmd_huge_pte``h]jS)}(hjxh]h pmd_huge_pte}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjvubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhM2hjrubj)}(hhh]jM)}(h(Protected by ptdesc->ptl, used for THPs.h]h(Protected by ptdesc->ptl, used for THPs.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM2hjubah}(h]h ]h"]h$]h&]uh1jhjrubeh}(h]h ]h"]h$]h&]uh1jhjhM2hjubj)}(hG``__page_mapping`` Aliases with page->mapping. Unused for page tables. h](j)}(h``__page_mapping``h]jS)}(hjh]h__page_mapping}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhM3hjubj)}(hhh]jM)}(h3Aliases with page->mapping. Unused for page tables.h]h3Aliases with page->mapping. Unused for page tables.}(hjʆhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjƆhM3hjdžubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjƆhM3hjubj)}(h``{unnamed_union}`` anonymous h](j)}(h``{unnamed_union}``h]jS)}(hjh]h{unnamed_union}}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhKhjubj)}(hhh]jM)}(h anonymoush]h anonymous}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubj)}(h!``pt_index`` Used for s390 gmap. h](j)}(h ``pt_index``h]jS)}(hj#h]hpt_index}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj!ubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhM4hjubj)}(hhh]jM)}(hUsed for s390 gmap.h]hUsed for s390 gmap.}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj8hM4hj9ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj8hM4hjubj)}(h``pt_mm`` Used for x86 pgds. h](j)}(h ``pt_mm``h]jS)}(hj\h]hpt_mm}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjZubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhM5hjVubj)}(hhh]jM)}(hUsed for x86 pgds.h]hUsed for x86 pgds.}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjqhM5hjrubah}(h]h ]h"]h$]h&]uh1jhjVubeh}(h]h ]h"]h$]h&]uh1jhjqhM5hjubj)}(hG``pt_frag_refcount`` For fragmented page table tracking. Powerpc only. h](j)}(h``pt_frag_refcount``h]jS)}(hjh]hpt_frag_refcount}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhM6hjubj)}(hhh]jM)}(h1For fragmented page table tracking. Powerpc only.h]h1For fragmented page table tracking. Powerpc only.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM6hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM6hjubj)}(h@``pt_share_count`` Used for HugeTLB PMD page table share count. h](j)}(h``pt_share_count``h]jS)}(hj·h]hpt_share_count}(hjЇhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj̇ubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhM7hjȇubj)}(hhh]jM)}(h,Used for HugeTLB PMD page table share count.h]h,Used for HugeTLB PMD page table share count.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM7hjubah}(h]h ]h"]h$]h&]uh1jhjȇubeh}(h]h ]h"]h$]h&]uh1jhjhM7hjubj)}(h``{unnamed_union}`` anonymous h](j)}(h``{unnamed_union}``h]jS)}(hjh]h{unnamed_union}}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhKhjubj)}(hhh]jM)}(h anonymoush]h anonymous}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubj)}(h2``_pt_pad_2`` Padding to ensure proper alignment. h](j)}(h ``_pt_pad_2``h]jS)}(hj@h]h _pt_pad_2}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj>ubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhM8hj:ubj)}(hhh]jM)}(h#Padding to ensure proper alignment.h]h#Padding to ensure proper alignment.}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjUhM8hjVubah}(h]h ]h"]h$]h&]uh1jhj:ubeh}(h]h ]h"]h$]h&]uh1jhjUhM8hjubj)}(h!``ptl`` Lock for the page table. h](j)}(h``ptl``h]jS)}(hjyh]hptl}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjwubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhM9hjsubj)}(hhh]jM)}(hLock for the page table.h]hLock for the page table.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM9hjubah}(h]h ]h"]h$]h&]uh1jhjsubeh}(h]h ]h"]h$]h&]uh1jhjhM9hjubj)}(h!``ptl`` Lock for the page table. h](j)}(h``ptl``h]jS)}(hjh]hptl}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhM9hjubj)}(hhh]jM)}(hLock for the page table.h]hLock for the page table.}(hjˈhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjLjhM9hjȈubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjLjhM9hjubj)}(hA``__page_type`` Same as page->page_type. Unused for page tables. h](j)}(h``__page_type``h]jS)}(hjh]h __page_type}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhM:hjubj)}(hhh]jM)}(h0Same as page->page_type. Unused for page tables.h]h0Same as page->page_type. Unused for page tables.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM:hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM:hjubj)}(h+``__page_refcount`` Same as page refcount. h](j)}(h``__page_refcount``h]jS)}(hj$h]h__page_refcount}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj"ubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhM;hjubj)}(hhh]jM)}(hSame as page refcount.h]hSame as page refcount.}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj9hM;hj:ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj9hM;hjubj)}(h;``pt_memcg_data`` Memcg data. Tracked for page tables here.h](j)}(h``pt_memcg_data``h]jS)}(hj]h]h pt_memcg_data}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj[ubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhM;hjWubj)}(hhh]jM)}(h)Memcg data. Tracked for page tables here.h]h)Memcg data. Tracked for page tables here.}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhM<hjsubah}(h]h ]h"]h$]h&]uh1jhjWubeh}(h]h ]h"]h$]h&]uh1jhjrhM;hjubeh}(h]h ]h"]h$]h&]uh1jhjЄubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhj]zhNubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhM?hjKhhubjM)}(hcThis struct overlays struct page for now. Do not modify without a good understanding of the issues.h]hcThis struct overlays struct page for now. Do not modify without a good understanding of the issues.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhM<hjKhhubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hvm_fault_t (C type) c.vm_fault_thNtauh1hhjKhhhj]zhNubh)}(hhh](h)}(h vm_fault_th]h)}(htype vm_fault_th](j)}(hjh]htype}(hjމhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjډhhhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMBubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjډhhhjhMBubh)}(h vm_fault_th]j)}(hj؉h]h vm_fault_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjډhhhjhMBubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj։hhhjhMBubah}(h]jщah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMBhjӉhhubj4)}(hhh]jM)}(h$Return type for page fault handlers.h]h$Return type for page fault handlers.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMhjhhubah}(h]h ]h"]h$]h&]uh1j3hjӉhhhjhMBubeh}(h]h ](jAtypeeh"]h$]h&]jFjAjGj8jHj8jIjJjKuh1hhhhjKhj]zhNubjM)}(h**Description**h]j)}(hj>h]h Description}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj<ubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMhjKhhubjM)}(hfault installed the pte, not return page ``VM_FAULT_LOCKED`` ->fault locked the returned page ``VM_FAULT_RETRY`` ->fault blocked, must retry ``VM_FAULT_FALLBACK`` huge page fault failed, fall back to small ``VM_FAULT_DONE_COW`` ->fault has fully handled COW ``VM_FAULT_NEEDDSYNC`` ->fault did not modify page tables and needs fsync() to complete (for synchronous page faults in DAX) ``VM_FAULT_COMPLETED`` ->fault completed, meanwhile mmap lock released ``VM_FAULT_HINDEX_MASK`` mask HINDEX valueh](jM)}(h **Constants**h]j)}(hjh]h Constants}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMhjubj)}(hhh](j)}(h``VM_FAULT_OOM`` Out Of Memory h](j)}(h``VM_FAULT_OOM``h]jS)}(hjh]h VM_FAULT_OOM}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMhj ubj)}(hhh]jM)}(h Out Of Memoryh]h Out Of Memory}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj&hMhj'ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj&hMhjubj)}(h``VM_FAULT_SIGBUS`` Bad access h](j)}(h``VM_FAULT_SIGBUS``h]jS)}(hjJh]hVM_FAULT_SIGBUS}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjHubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMhjDubj)}(hhh]jM)}(h Bad accessh]h Bad access}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj_hMhj`ubah}(h]h ]h"]h$]h&]uh1jhjDubeh}(h]h ]h"]h$]h&]uh1jhj_hMhjubj)}(h*``VM_FAULT_MAJOR`` Page read from storage h](j)}(h``VM_FAULT_MAJOR``h]jS)}(hjh]hVM_FAULT_MAJOR}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMhj}ubj)}(hhh]jM)}(hPage read from storageh]hPage read from storage}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhj}ubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h.``VM_FAULT_HWPOISON`` Hit poisoned small page h](j)}(h``VM_FAULT_HWPOISON``h]jS)}(hjh]hVM_FAULT_HWPOISON}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMhjubj)}(hhh]jM)}(hHit poisoned small pageh]hHit poisoned small page}(hjՋhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjыhMhjҋubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjыhMhjubj)}(hQ``VM_FAULT_HWPOISON_LARGE`` Hit poisoned large page. Index encoded in upper bits h](j)}(h``VM_FAULT_HWPOISON_LARGE``h]jS)}(hjh]hVM_FAULT_HWPOISON_LARGE}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMhjubj)}(hhh]jM)}(h4Hit poisoned large page. Index encoded in upper bitsh]h4Hit poisoned large page. Index encoded in upper bits}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMhj ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj hMhjubj)}(h(``VM_FAULT_SIGSEGV`` segmentation fault h](j)}(h``VM_FAULT_SIGSEGV``h]jS)}(hj/h]hVM_FAULT_SIGSEGV}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj-ubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMhj)ubj)}(hhh]jM)}(hsegmentation faulth]hsegmentation fault}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjDhMhjEubah}(h]h ]h"]h$]h&]uh1jhj)ubeh}(h]h ]h"]h$]h&]uh1jhjDhMhjubj)}(h?``VM_FAULT_NOPAGE`` ->fault installed the pte, not return page h](j)}(h``VM_FAULT_NOPAGE``h]jS)}(hjhh]hVM_FAULT_NOPAGE}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjfubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMhjbubj)}(hhh]jM)}(h*->fault installed the pte, not return pageh]h*->fault installed the pte, not return page}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj}hMhj~ubah}(h]h ]h"]h$]h&]uh1jhjbubeh}(h]h ]h"]h$]h&]uh1jhj}hMhjubj)}(h5``VM_FAULT_LOCKED`` ->fault locked the returned page h](j)}(h``VM_FAULT_LOCKED``h]jS)}(hjh]hVM_FAULT_LOCKED}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMhjubj)}(hhh]jM)}(h ->fault locked the returned pageh]h ->fault locked the returned page}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h/``VM_FAULT_RETRY`` ->fault blocked, must retry h](j)}(h``VM_FAULT_RETRY``h]jS)}(hjڌh]hVM_FAULT_RETRY}(hj܌hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj،ubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMhjԌubj)}(hhh]jM)}(h->fault blocked, must retryh]h->fault blocked, must retry}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjԌubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(hA``VM_FAULT_FALLBACK`` huge page fault failed, fall back to small h](j)}(h``VM_FAULT_FALLBACK``h]jS)}(hjh]hVM_FAULT_FALLBACK}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMhj ubj)}(hhh]jM)}(h*huge page fault failed, fall back to smallh]h*huge page fault failed, fall back to small}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj(hMhj)ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj(hMhjubj)}(h4``VM_FAULT_DONE_COW`` ->fault has fully handled COW h](j)}(h``VM_FAULT_DONE_COW``h]jS)}(hjLh]hVM_FAULT_DONE_COW}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjJubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMhjFubj)}(hhh]jM)}(h->fault has fully handled COWh]h->fault has fully handled COW}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjahMhjbubah}(h]h ]h"]h$]h&]uh1jhjFubeh}(h]h ]h"]h$]h&]uh1jhjahMhjubj)}(h}``VM_FAULT_NEEDDSYNC`` ->fault did not modify page tables and needs fsync() to complete (for synchronous page faults in DAX) h](j)}(h``VM_FAULT_NEEDDSYNC``h]jS)}(hjh]hVM_FAULT_NEEDDSYNC}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMhjubj)}(hhh]jM)}(he->fault did not modify page tables and needs fsync() to complete (for synchronous page faults in DAX)h]he->fault did not modify page tables and needs fsync() to complete (for synchronous page faults in DAX)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(hG``VM_FAULT_COMPLETED`` ->fault completed, meanwhile mmap lock released h](j)}(h``VM_FAULT_COMPLETED``h]jS)}(hjh]hVM_FAULT_COMPLETED}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMhjubj)}(hhh]jM)}(h/->fault completed, meanwhile mmap lock releasedh]h/->fault completed, meanwhile mmap lock released}(hj؍hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjԍhMhjՍubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjԍhMhjubj)}(h*``VM_FAULT_HINDEX_MASK`` mask HINDEX valueh](j)}(h``VM_FAULT_HINDEX_MASK``h]jS)}(hjh]hVM_FAULT_HINDEX_MASK}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMhjubj)}(hhh]jM)}(hmask HINDEX valueh]hmask HINDEX value}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj hMhjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhj]zhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfault_flag (C enum) c.fault_flaghNtauh1hhjKhhhj]zhNubh)}(hhh](h)}(h fault_flagh]h)}(henum fault_flagh](j)}(hj#!h]henum}(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNhhhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMubj)}(h h]h }(hj`hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNhhhj_hMubh)}(h fault_flagh]j)}(hjLh]h fault_flag}(hjrhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnubah}(h]h ](jjeh"]h$]h&]jjuh1hhjNhhhj_hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjJhhhj_hMubah}(h]jEah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj_hMhjGhhubj4)}(hhh]jM)}(hFault flag definitions.h]hFault flag definitions.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhM hjhhubah}(h]h ]h"]h$]h&]uh1j3hjGhhhj_hMubeh}(h]h ](jAenumeh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhj]zhNubj)}(hX**Constants** ``FAULT_FLAG_WRITE`` Fault was a write fault. ``FAULT_FLAG_MKWRITE`` Fault was mkwrite of existing PTE. ``FAULT_FLAG_ALLOW_RETRY`` Allow to retry the fault if blocked. ``FAULT_FLAG_RETRY_NOWAIT`` Don't drop mmap_lock and wait when retrying. ``FAULT_FLAG_KILLABLE`` The fault task is in SIGKILL killable region. ``FAULT_FLAG_TRIED`` The fault has been tried once. ``FAULT_FLAG_USER`` The fault originated in userspace. ``FAULT_FLAG_REMOTE`` The fault is not for current task/mm. ``FAULT_FLAG_INSTRUCTION`` The fault was during an instruction fetch. ``FAULT_FLAG_INTERRUPTIBLE`` The fault can be interrupted by non-fatal signals. ``FAULT_FLAG_UNSHARE`` The fault is an unsharing request to break COW in a COW mapping, making sure that an exclusive anon page is mapped after the fault. ``FAULT_FLAG_ORIG_PTE_VALID`` whether the fault has vmf->orig_pte cached. We should only access orig_pte if this flag set. ``FAULT_FLAG_VMA_LOCK`` The fault is handled under VMA lock.h](jM)}(h **Constants**h]j)}(hjh]h Constants}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMhjubj)}(hhh](j)}(h.``FAULT_FLAG_WRITE`` Fault was a write fault. h](j)}(h``FAULT_FLAG_WRITE``h]jS)}(hjՎh]hFAULT_FLAG_WRITE}(hj׎hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjӎubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMhjώubj)}(hhh]jM)}(hFault was a write fault.h]hFault was a write fault.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjώubeh}(h]h ]h"]h$]h&]uh1jhjhMhj̎ubj)}(h:``FAULT_FLAG_MKWRITE`` Fault was mkwrite of existing PTE. h](j)}(h``FAULT_FLAG_MKWRITE``h]jS)}(hjh]hFAULT_FLAG_MKWRITE}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj ubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMhjubj)}(hhh]jM)}(h"Fault was mkwrite of existing PTE.h]h"Fault was mkwrite of existing PTE.}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj#hMhj$ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj#hMhj̎ubj)}(h@``FAULT_FLAG_ALLOW_RETRY`` Allow to retry the fault if blocked. h](j)}(h``FAULT_FLAG_ALLOW_RETRY``h]jS)}(hjGh]hFAULT_FLAG_ALLOW_RETRY}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjEubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMhjAubj)}(hhh]jM)}(h$Allow to retry the fault if blocked.h]h$Allow to retry the fault if blocked.}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj\hMhj]ubah}(h]h ]h"]h$]h&]uh1jhjAubeh}(h]h ]h"]h$]h&]uh1jhj\hMhj̎ubj)}(hI``FAULT_FLAG_RETRY_NOWAIT`` Don't drop mmap_lock and wait when retrying. h](j)}(h``FAULT_FLAG_RETRY_NOWAIT``h]jS)}(hjh]hFAULT_FLAG_RETRY_NOWAIT}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj~ubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMhjzubj)}(hhh]jM)}(h,Don't drop mmap_lock and wait when retrying.h]h.Don’t drop mmap_lock and wait when retrying.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjzubeh}(h]h ]h"]h$]h&]uh1jhjhMhj̎ubj)}(hF``FAULT_FLAG_KILLABLE`` The fault task is in SIGKILL killable region. h](j)}(h``FAULT_FLAG_KILLABLE``h]jS)}(hjh]hFAULT_FLAG_KILLABLE}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhM hjubj)}(hhh]jM)}(h-The fault task is in SIGKILL killable region.h]h-The fault task is in SIGKILL killable region.}(hjҏhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjΏhM hjϏubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjΏhM hj̎ubj)}(h4``FAULT_FLAG_TRIED`` The fault has been tried once. h](j)}(h``FAULT_FLAG_TRIED``h]jS)}(hjh]hFAULT_FLAG_TRIED}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhM#hjubj)}(hhh]jM)}(hThe fault has been tried once.h]hThe fault has been tried once.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM#hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM#hj̎ubj)}(h7``FAULT_FLAG_USER`` The fault originated in userspace. h](j)}(h``FAULT_FLAG_USER``h]jS)}(hj+h]hFAULT_FLAG_USER}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj)ubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhM&hj%ubj)}(hhh]jM)}(h"The fault originated in userspace.h]h"The fault originated in userspace.}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj@hM&hjAubah}(h]h ]h"]h$]h&]uh1jhj%ubeh}(h]h ]h"]h$]h&]uh1jhj@hM&hj̎ubj)}(h<``FAULT_FLAG_REMOTE`` The fault is not for current task/mm. h](j)}(h``FAULT_FLAG_REMOTE``h]jS)}(hjdh]hFAULT_FLAG_REMOTE}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjbubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhM)hj^ubj)}(hhh]jM)}(h%The fault is not for current task/mm.h]h%The fault is not for current task/mm.}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjyhM)hjzubah}(h]h ]h"]h$]h&]uh1jhj^ubeh}(h]h ]h"]h$]h&]uh1jhjyhM)hj̎ubj)}(hF``FAULT_FLAG_INSTRUCTION`` The fault was during an instruction fetch. h](j)}(h``FAULT_FLAG_INSTRUCTION``h]jS)}(hjh]hFAULT_FLAG_INSTRUCTION}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhM,hjubj)}(hhh]jM)}(h*The fault was during an instruction fetch.h]h*The fault was during an instruction fetch.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM,hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM,hj̎ubj)}(hP``FAULT_FLAG_INTERRUPTIBLE`` The fault can be interrupted by non-fatal signals. h](j)}(h``FAULT_FLAG_INTERRUPTIBLE``h]jS)}(hj֐h]hFAULT_FLAG_INTERRUPTIBLE}(hjؐhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjԐubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhM/hjАubj)}(hhh]jM)}(h2The fault can be interrupted by non-fatal signals.h]h2The fault can be interrupted by non-fatal signals.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM/hjubah}(h]h ]h"]h$]h&]uh1jhjАubeh}(h]h ]h"]h$]h&]uh1jhjhM/hj̎ubj)}(h``FAULT_FLAG_UNSHARE`` The fault is an unsharing request to break COW in a COW mapping, making sure that an exclusive anon page is mapped after the fault. h](j)}(h``FAULT_FLAG_UNSHARE``h]jS)}(hjh]hFAULT_FLAG_UNSHARE}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj ubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhM4hj ubj)}(hhh]jM)}(hThe fault is an unsharing request to break COW in a COW mapping, making sure that an exclusive anon page is mapped after the fault.h]hThe fault is an unsharing request to break COW in a COW mapping, making sure that an exclusive anon page is mapped after the fault.}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhM2hj%ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj$hM4hj̎ubj)}(h{``FAULT_FLAG_ORIG_PTE_VALID`` whether the fault has vmf->orig_pte cached. We should only access orig_pte if this flag set. h](j)}(h``FAULT_FLAG_ORIG_PTE_VALID``h]jS)}(hjIh]hFAULT_FLAG_ORIG_PTE_VALID}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjGubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhM8hjCubj)}(hhh]jM)}(h\whether the fault has vmf->orig_pte cached. We should only access orig_pte if this flag set.h]h\whether the fault has vmf->orig_pte cached. We should only access orig_pte if this flag set.}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhM7hj_ubah}(h]h ]h"]h$]h&]uh1jhjCubeh}(h]h ]h"]h$]h&]uh1jhj^hM8hj̎ubj)}(h<``FAULT_FLAG_VMA_LOCK`` The fault is handled under VMA lock.h](j)}(h``FAULT_FLAG_VMA_LOCK``h]jS)}(hjh]hFAULT_FLAG_VMA_LOCK}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhM:hj}ubj)}(hhh]jM)}(h$The fault is handled under VMA lock.h]h$The fault is handled under VMA lock.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhM;hjubah}(h]h ]h"]h$]h&]uh1jhj}ubeh}(h]h ]h"]h$]h&]uh1jhjhM:hj̎ubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhj]zhNubjM)}(h**Description**h]j)}(hjƑh]h Description}(hjȑhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjđubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhM=hjKhhubjM)}(hAbout **FAULT_FLAG_ALLOW_RETRY** and **FAULT_FLAG_TRIED**: we can specify whether we would allow page faults to retry by specifying these two fault flags correctly. Currently there can be three legal combinations:h](hAbout }(hjܑhhhNhNubj)}(h**FAULT_FLAG_ALLOW_RETRY**h]hFAULT_FLAG_ALLOW_RETRY}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjܑubh and }(hjܑhhhNhNubj)}(h**FAULT_FLAG_TRIED**h]hFAULT_FLAG_TRIED}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjܑubh: we can specify whether we would allow page faults to retry by specifying these two fault flags correctly. Currently there can be three legal combinations:}(hjܑhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhMhjKhhubjM)}(hhh](jc)}(htALLOW_RETRY and !TRIED: this means the page fault allows retry, and this is the first try h]j)}(hhh]j)}(h[ALLOW_RETRY and !TRIED: this means the page fault allows retry, and this is the first try h](j)}(hDALLOW_RETRY and !TRIED: this means the page fault allows retry, andh]hDALLOW_RETRY and !TRIED: this means the page fault allows retry, and}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhM#hjubj)}(hhh]jM)}(hthis is the first tryh]hthis is the first try}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj+hM#hj,ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj+hM#hjubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jbhjubjc)}(hALLOW_RETRY and TRIED: this means the page fault allows retry, and we've already tried at least once h]j)}(hhh]j)}(hgALLOW_RETRY and TRIED: this means the page fault allows retry, and we've already tried at least once h](j)}(hDALLOW_RETRY and TRIED: this means the page fault allows retry, andh]hDALLOW_RETRY and TRIED: this means the page fault allows retry, and}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhM&hj\ubj)}(hhh]jM)}(h!we've already tried at least onceh]h#we’ve already tried at least once}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjnhM&hjoubah}(h]h ]h"]h$]h&]uh1jhj\ubeh}(h]h ]h"]h$]h&]uh1jhjnhM&hjYubah}(h]h ]h"]h$]h&]uh1jhjUubah}(h]h ]h"]h$]h&]uh1jbhjubjc)}(hH!ALLOW_RETRY and !TRIED: this means the page fault does not allow retry h]jM)}(hG!ALLOW_RETRY and !TRIED: this means the page fault does not allow retryh]hG!ALLOW_RETRY and !TRIED: this means the page fault does not allow retry}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhM(hjubah}(h]h ]h"]h$]h&]uh1jbhjubeh}(h]h ]h"]h$]h&]j?N loweralphajANj?jBNj?uh1jMhjKhhhj]zhNubjM)}(hXThe unlisted combination (!ALLOW_RETRY && TRIED) is illegal and should never be used. Note that page faults can be allowed to retry for multiple times, in which case we'll have an initial fault with flags (a) then later on continuous faults with flags (b). We should always try to detect pending signals before a retry to make sure the continuous page faults can still be interrupted if necessary.h]hXThe unlisted combination (!ALLOW_RETRY && TRIED) is illegal and should never be used. Note that page faults can be allowed to retry for multiple times, in which case we’ll have an initial fault with flags (a) then later on continuous faults with flags (b). We should always try to detect pending signals before a retry to make sure the continuous page faults can still be interrupted if necessary.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhM*hjKhhubjM)}(hThe combination FAULT_FLAG_WRITE|FAULT_FLAG_UNSHARE is illegal. FAULT_FLAG_UNSHARE is ignored and treated like an ordinary read fault when applied to mappings that are not COW mappings.h]hThe combination FAULT_FLAG_WRITE|FAULT_FLAG_UNSHARE is illegal. FAULT_FLAG_UNSHARE is ignored and treated like an ordinary read fault when applied to mappings that are not COW mappings.}(hjǒhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:115: ./include/linux/mm_types.hhM1hjKhhubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfolio_is_file_lru (C function)c.folio_is_file_lruhNtauh1hhjKhhhNhNubh)}(hhh](h)}(h1int folio_is_file_lru (const struct folio *folio)h]h)}(h0int folio_is_file_lru(const struct folio *folio)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:117: ./include/linux/mm_inline.hhKubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhKubh)}(hfolio_is_file_lruh]j)}(hfolio_is_file_lruh]hfolio_is_file_lru}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhKubj8)}(h(const struct folio *folio)h]j>)}(hconst struct folio *folioh](j)}(hjh]hconst}(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(ubj)}(h h]h }(hj9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(ubj)}(hjJ,h]hstruct}(hjGhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(ubj)}(h h]h }(hjThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(ubh)}(hhh]j)}(hfolioh]hfolio}(hjehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjbubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjgmodnameN classnameNjj)}j]j)}jjsbc.folio_is_file_lruasbuh1hhj(ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(ubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj(ubj)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj$ubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhKubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhKubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhKhjhhubj4)}(hhh]jM)}(h.Should the folio be on a file LRU or anon LRU?h]h.Should the folio be on a file LRU or anon LRU?}(hjʓhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:117: ./include/linux/mm_inline.hhKhjǓhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhKubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hXX**Parameters** ``const struct folio *folio`` The folio to test. **Description** We would like to get this info without a page flag, but the state needs to survive until the folio is last deleted from the LRU, which could be as far down as __page_cache_release. **Return** An integer (not a boolean!) used to sort a folio onto the right LRU list and to account folios correctly. 1 if **folio** is a regular filesystem backed page cache folio or a lazily freed anonymous folio (e.g. via MADV_FREE). 0 if **folio** is a normal anonymous folio, a tmpfs folio or otherwise ram or swap backed folio.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:117: ./include/linux/mm_inline.hhKhjubj)}(hhh]j)}(h1``const struct folio *folio`` The folio to test. h](j)}(h``const struct folio *folio``h]jS)}(hj h]hconst struct folio *folio}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:117: ./include/linux/mm_inline.hhKhjubj)}(hhh]jM)}(hThe folio to test.h]hThe folio to test.}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj hKhj!ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj hKhjubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjFh]h Description}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjDubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:117: ./include/linux/mm_inline.hhKhjubjM)}(hWe would like to get this info without a page flag, but the state needs to survive until the folio is last deleted from the LRU, which could be as far down as __page_cache_release.h]hWe would like to get this info without a page flag, but the state needs to survive until the folio is last deleted from the LRU, which could be as far down as __page_cache_release.}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:117: ./include/linux/mm_inline.hhKhjubjM)}(h **Return**h]j)}(hjmh]hReturn}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1jhjkubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:117: ./include/linux/mm_inline.hhKhjubjM)}(hXAAn integer (not a boolean!) used to sort a folio onto the right LRU list and to account folios correctly. 1 if **folio** is a regular filesystem backed page cache folio or a lazily freed anonymous folio (e.g. via MADV_FREE). 0 if **folio** is a normal anonymous folio, a tmpfs folio or otherwise ram or swap backed folio.h](hoAn integer (not a boolean!) used to sort a folio onto the right LRU list and to account folios correctly. 1 if }(hjhhhNhNubj)}(h **folio**h]hfolio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhn is a regular filesystem backed page cache folio or a lazily freed anonymous folio (e.g. via MADV_FREE). 0 if }(hjhhhNhNubj)}(h **folio**h]hfolio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhR is a normal anonymous folio, a tmpfs folio or otherwise ram or swap backed folio.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:117: ./include/linux/mm_inline.hhKhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h$folio_flags_is_file_lru (C function)c.folio_flags_is_file_lruhNtauh1hhjKhhhNhNubh)}(hhh](h)}(h8int folio_flags_is_file_lru (const unsigned long *flags)h]h)}(h7int folio_flags_is_file_lru(const unsigned long *flags)h](j)}(hinth]hint}(hj֔hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjҔhhhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:117: ./include/linux/mm_inline.hhK"ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjҔhhhjhK"ubh)}(hfolio_flags_is_file_lruh]j)}(hfolio_flags_is_file_lruh]hfolio_flags_is_file_lru}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjҔhhhjhK"ubj8)}(h(const unsigned long *flags)h]j>)}(hconst unsigned long *flagsh](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hunsignedh]hunsigned}(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj<hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hlongh]hlong}(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjfhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hflagsh]hflags}(hjshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj ubah}(h]h ]h"]h$]h&]jjuh1j7hjҔhhhjhK"ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjΔhhhjhK"ubah}(h]jɔah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhK"hj˔hhubj4)}(hhh]jM)}(h.Should the folio be on a file LRU or anon LRU?h]h.Should the folio be on a file LRU or anon LRU?}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:117: ./include/linux/mm_inline.hhK"hjhhubah}(h]h ]h"]h$]h&]uh1j3hj˔hhhjhK"ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``const unsigned long *flags`` The folio's flags. **Description** Just like folio_is_file_lru but take the folio flags directly instead.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:117: ./include/linux/mm_inline.hhK&hjubj)}(hhh]j)}(h2``const unsigned long *flags`` The folio's flags. h](j)}(h``const unsigned long *flags``h]jS)}(hjޕh]hconst unsigned long *flags}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjܕubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:117: ./include/linux/mm_inline.hhK#hjؕubj)}(hhh]jM)}(hThe folio's flags.h]hThe folio’s flags.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhK#hjubah}(h]h ]h"]h$]h&]uh1jhjؕubeh}(h]h ]h"]h$]h&]uh1jhjhK#hjՕubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:117: ./include/linux/mm_inline.hhK%hjubjM)}(hFJust like folio_is_file_lru but take the folio flags directly instead.h]hFJust like folio_is_file_lru but take the folio flags directly instead.}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:117: ./include/linux/mm_inline.hhK$hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h$__folio_clear_lru_flags (C function)c.__folio_clear_lru_flagshNtauh1hhjKhhhNhNubh)}(hhh](h)}(h2void __folio_clear_lru_flags (struct folio *folio)h]h)}(h1void __folio_clear_lru_flags(struct folio *folio)h](j)}(hvoidh]hvoid}(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZhhhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:117: ./include/linux/mm_inline.hhKEubj)}(h h]h }(hjmhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZhhhjlhKEubh)}(h__folio_clear_lru_flagsh]j)}(h__folio_clear_lru_flagsh]h__folio_clear_lru_flags}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjZhhhjlhKEubj8)}(h(struct folio *folio)h]j>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsbc.__folio_clear_lru_flagsasbuh1hhjubj)}(h h]h }(hjٖhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjZhhhjlhKEubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjVhhhjlhKEubah}(h]jQah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjlhKEhjShhubj4)}(hhh]jM)}(h-Clear page lru flags before releasing a page.h]h-Clear page lru flags before releasing a page.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:117: ./include/linux/mm_inline.hhKEhjhhubah}(h]h ]h"]h$]h&]uh1j3hjShhhjlhKEubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj6jHj6jIjJjKuh1hhhhjKhNhNubj)}(ha**Parameters** ``struct folio *folio`` The folio that was on lru and now has a zero reference.h](jM)}(h**Parameters**h]j)}(hj@h]h Parameters}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj>ubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:117: ./include/linux/mm_inline.hhKIhj:ubj)}(hhh]j)}(hO``struct folio *folio`` The folio that was on lru and now has a zero reference.h](j)}(h``struct folio *folio``h]jS)}(hj_h]hstruct folio *folio}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj]ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:117: ./include/linux/mm_inline.hhKKhjYubj)}(hhh]jM)}(h7The folio that was on lru and now has a zero reference.h]h7The folio that was on lru and now has a zero reference.}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:117: ./include/linux/mm_inline.hhKFhjuubah}(h]h ]h"]h$]h&]uh1jhjYubeh}(h]h ]h"]h$]h&]uh1jhjthKKhjVubah}(h]h ]h"]h$]h&]uh1jhj:ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfolio_lru_list (C function)c.folio_lru_listhNtauh1hhjKhhhNhNubh)}(hhh](h)}(h8enum lru_list folio_lru_list (const struct folio *folio)h]h)}(h7enum lru_list folio_lru_list(const struct folio *folio)h](j)}(hj#!h]henum}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:117: ./include/linux/mm_inline.hhKWubj)}(h h]h }(hjǗhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjƗhKWubh)}(hhh]j)}(hlru_listh]hlru_list}(hjؗhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj՗ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjڗmodnameN classnameNjj)}j]j)}jfolio_lru_listsbc.folio_lru_listasbuh1hhjhhhjƗhKWubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjƗhKWubh)}(hfolio_lru_listh]j)}(hjh]hfolio_lru_list}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjƗhKWubj8)}(h(const struct folio *folio)h]j>)}(hconst struct folio *folioh](j)}(hjh]hconst}(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"ubj)}(h h]h }(hj3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"ubj)}(hjJ,h]hstruct}(hjAhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"ubj)}(h h]h }(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"ubh)}(hhh]j)}(hfolioh]hfolio}(hj_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjamodnameN classnameNjj)}j]jc.folio_lru_listasbuh1hhj"ubj)}(h h]h }(hj}hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"ubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj"ubj)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjƗhKWubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjƗhKWubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjƗhKWhjhhubj4)}(hhh]jM)}(h$Which LRU list should a folio be on?h]h$Which LRU list should a folio be on?}(hj˜hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:117: ./include/linux/mm_inline.hhKWhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjƗhKWubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjژjHjژjIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``const struct folio *folio`` The folio to test. **Return** The LRU list a folio should be on, as an index into the array of LRU lists.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:117: ./include/linux/mm_inline.hhK[hjޘubj)}(hhh]j)}(h1``const struct folio *folio`` The folio to test. h](j)}(h``const struct folio *folio``h]jS)}(hjh]hconst struct folio *folio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:117: ./include/linux/mm_inline.hhKXhjubj)}(hhh]jM)}(hThe folio to test.h]hThe folio to test.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhKXhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKXhjubah}(h]h ]h"]h$]h&]uh1jhjޘubjM)}(h **Return**h]j)}(hj>h]hReturn}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj<ubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:117: ./include/linux/mm_inline.hhKZhjޘubjM)}(hKThe LRU list a folio should be on, as an index into the array of LRU lists.h]hKThe LRU list a folio should be on, as an index into the array of LRU lists.}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:117: ./include/linux/mm_inline.hhKZhjޘubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hlru_set_gen_flags (C function)c.lru_set_gen_flagshNtauh1hhjKhhhNhNubh)}(hhh](h)}(h6void lru_set_gen_flags (unsigned long *flags, int gen)h]h)}(h5void lru_set_gen_flags(unsigned long *flags, int gen)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:117: ./include/linux/mm_inline.hhKubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhKubh)}(hlru_set_gen_flagsh]j)}(hlru_set_gen_flagsh]hlru_set_gen_flags}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhKubj8)}(h(unsigned long *flags, int gen)h](j>)}(hunsigned long *flagsh](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjΙhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hlongh]hlong}(hjܙhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hflagsh]hflags}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hint genh](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hgenh]hgen}(hj:hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhKubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj{hhhjhKubah}(h]jvah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhKhjxhhubj4)}(hhh]jM)}(h7Set the LRU generation number to specified folio flags.h]h7Set the LRU generation number to specified folio flags.}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:117: ./include/linux/mm_inline.hhKhjahhubah}(h]h ]h"]h$]h&]uh1j3hjxhhhjhKubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj|jHj|jIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``unsigned long *flags`` pointer to the folio flags ``int gen`` generation number, between 0 and (MAX_NR_GENS - 1), inclusive.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:117: ./include/linux/mm_inline.hhKhjubj)}(hhh](j)}(h4``unsigned long *flags`` pointer to the folio flags h](j)}(h``unsigned long *flags``h]jS)}(hjh]hunsigned long *flags}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:117: ./include/linux/mm_inline.hhKhjubj)}(hhh]jM)}(hpointer to the folio flagsh]hpointer to the folio flags}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubj)}(hJ``int gen`` generation number, between 0 and (MAX_NR_GENS - 1), inclusive.h](j)}(h ``int gen``h]jS)}(hjޚh]hint gen}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjܚubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:117: ./include/linux/mm_inline.hhKhjؚubj)}(hhh]jM)}(h>generation number, between 0 and (MAX_NR_GENS - 1), inclusive.h]h>generation number, between 0 and (MAX_NR_GENS - 1), inclusive.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:117: ./include/linux/mm_inline.hhKhjubah}(h]h ]h"]h$]h&]uh1jhjؚubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hlru_get_gen_flags (C function)c.lru_get_gen_flagshNtauh1hhjKhhhNhNubh)}(hhh](h)}(h+int lru_get_gen_flags (unsigned long flags)h]h)}(h*int lru_get_gen_flags(unsigned long flags)h](j)}(hinth]hint}(hj8hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4hhhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:117: ./include/linux/mm_inline.hhKubj)}(h h]h }(hjGhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4hhhjFhKubh)}(hlru_get_gen_flagsh]j)}(hlru_get_gen_flagsh]hlru_get_gen_flags}(hjYhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjUubah}(h]h ](jjeh"]h$]h&]jjuh1hhj4hhhjFhKubj8)}(h(unsigned long flags)h]j>)}(hunsigned long flagsh](j)}(hunsignedh]hunsigned}(hjuhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjqubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjqubj)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjqubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjqubj)}(hflagsh]hflags}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjqubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjmubah}(h]h ]h"]h$]h&]jjuh1j7hj4hhhjFhKubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj0hhhjFhKubah}(h]j+ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjFhKhj-hhubj4)}(hhh]jM)}(h2Return the LRU generation number from folio flags.h]h2Return the LRU generation number from folio flags.}(hjכhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:117: ./include/linux/mm_inline.hhKhjԛhhubah}(h]h ]h"]h$]h&]uh1j3hj-hhhjFhKubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``unsigned long flags`` folio flags **Return** A number between 0 and (MAX_NR_GENS - 1), inclusive. Returns -1 if the flags indicate the folio is off the list (e.g., isolated).h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:117: ./include/linux/mm_inline.hhKhjubj)}(hhh]j)}(h$``unsigned long flags`` folio flags h](j)}(h``unsigned long flags``h]jS)}(hjh]hunsigned long flags}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:117: ./include/linux/mm_inline.hhKhjubj)}(hhh]jM)}(h folio flagsh]h folio flags}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj-hKhj.ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj-hKhjubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h **Return**h]j)}(hjSh]hReturn}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjQubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:117: ./include/linux/mm_inline.hhKhjubjM)}(hA number between 0 and (MAX_NR_GENS - 1), inclusive. Returns -1 if the flags indicate the folio is off the list (e.g., isolated).h]hA number between 0 and (MAX_NR_GENS - 1), inclusive. Returns -1 if the flags indicate the folio is off the list (e.g., isolated).}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:117: ./include/linux/mm_inline.hhKhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hlru_set_refs_flags (C function)c.lru_set_refs_flagshNtauh1hhjKhhhNhNubh)}(hhh](h)}(hAvoid lru_set_refs_flags (unsigned long *flags, unsigned int refs)h]h)}(h@void lru_set_refs_flags(unsigned long *flags, unsigned int refs)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:117: ./include/linux/mm_inline.hhKubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhKubh)}(hlru_set_refs_flagsh]j)}(hlru_set_refs_flagsh]hlru_set_refs_flags}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhKubj8)}(h)(unsigned long *flags, unsigned int refs)h](j>)}(hunsigned long *flagsh](j)}(hunsignedh]hunsigned}(hj՜hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjќubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjќubj)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjќubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjќubjr)}(hjuh]h*}(hj hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjќubj)}(hflagsh]hflags}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjќubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj͜ubj>)}(hunsigned int refsh](j)}(hunsignedh]hunsigned}(hj3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/ubj)}(h h]h }(hjAhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/ubj)}(hinth]hint}(hjOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/ubj)}(h h]h }(hj]hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/ubj)}(hrefsh]hrefs}(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj͜ubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhKubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhKubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhKhjhhubj4)}(hhh]jM)}(h,Set the LRU referenced count to folio flags.h]h,Set the LRU referenced count to folio flags.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:117: ./include/linux/mm_inline.hhKhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhKubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``unsigned long *flags`` pointer to the folio flags ``unsigned int refs`` referenced / access count number, between 0 and LRU_REFS_MAX, inclusive. **Description** For MGLRU, PG_referenced holds the first ref, and the extra bits hold the remaining refs. For classical LRU the extra bits are not used, so it can also be seen as the refs count never exceeds 1. In both cases, refs == 1 means PG_referenced is set and the extra bits are zero, and refs == 0 means PG_referenced and the extra bits are all unset.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:117: ./include/linux/mm_inline.hhKhjubj)}(hhh](j)}(h4``unsigned long *flags`` pointer to the folio flags h](j)}(h``unsigned long *flags``h]jS)}(hj֝h]hunsigned long *flags}(hj؝hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjԝubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:117: ./include/linux/mm_inline.hhKhjНubj)}(hhh]jM)}(hpointer to the folio flagsh]hpointer to the folio flags}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjНubeh}(h]h ]h"]h$]h&]uh1jhjhKhj͝ubj)}(h_``unsigned int refs`` referenced / access count number, between 0 and LRU_REFS_MAX, inclusive. h](j)}(h``unsigned int refs``h]jS)}(hjh]hunsigned int refs}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:117: ./include/linux/mm_inline.hhKhj ubj)}(hhh]jM)}(hHreferenced / access count number, between 0 and LRU_REFS_MAX, inclusive.h]hHreferenced / access count number, between 0 and LRU_REFS_MAX, inclusive.}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj$hKhj%ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj$hKhj͝ubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjJh]h Description}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjHubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:117: ./include/linux/mm_inline.hhKhjubjM)}(hXWFor MGLRU, PG_referenced holds the first ref, and the extra bits hold the remaining refs. For classical LRU the extra bits are not used, so it can also be seen as the refs count never exceeds 1. In both cases, refs == 1 means PG_referenced is set and the extra bits are zero, and refs == 0 means PG_referenced and the extra bits are all unset.h]hXWFor MGLRU, PG_referenced holds the first ref, and the extra bits hold the remaining refs. For classical LRU the extra bits are not used, so it can also be seen as the refs count never exceeds 1. In both cases, refs == 1 means PG_referenced is set and the extra bits are zero, and refs == 0 means PG_referenced and the extra bits are all unset.}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:117: ./include/linux/mm_inline.hhKhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hlru_get_refs_flags (C function)c.lru_get_refs_flagshNtauh1hhjKhhhNhNubh)}(hhh](h)}(h,int lru_get_refs_flags (unsigned long flags)h]h)}(h+int lru_get_refs_flags(unsigned long flags)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:117: ./include/linux/mm_inline.hhKubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhKubh)}(hlru_get_refs_flagsh]j)}(hlru_get_refs_flagsh]hlru_get_refs_flags}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhKubj8)}(h(unsigned long flags)h]j>)}(hunsigned long flagsh](j)}(hunsignedh]hunsigned}(hj̞hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjȞubj)}(h h]h }(hjڞhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjȞubj)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjȞubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjȞubj)}(hflagsh]hflags}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjȞubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjĞubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhKubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhKubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhKhjhhubj4)}(hhh]jM)}(h6Return LRU referenced / access count from folio flags.h]h6Return LRU referenced / access count from folio flags.}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:117: ./include/linux/mm_inline.hhKhj+hhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhKubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjFjHjFjIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``unsigned long flags`` folio flags **Description** Reads the LRU referenced count set by lru_set_refs_flags().h](jM)}(h**Parameters**h]j)}(hjPh]h Parameters}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjNubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:117: ./include/linux/mm_inline.hhKhjJubj)}(hhh]j)}(h$``unsigned long flags`` folio flags h](j)}(h``unsigned long flags``h]jS)}(hjoh]hunsigned long flags}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjmubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:117: ./include/linux/mm_inline.hhKhjiubj)}(hhh]jM)}(h folio flagsh]h folio flags}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjiubeh}(h]h ]h"]h$]h&]uh1jhjhKhjfubah}(h]h ]h"]h$]h&]uh1jhjJubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:117: ./include/linux/mm_inline.hhKhjJubjM)}(h;Reads the LRU referenced count set by lru_set_refs_flags().h]h;Reads the LRU referenced count set by lru_set_refs_flags().}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:117: ./include/linux/mm_inline.hhKhjJubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h#folio_migrate_lru_refs (C function)c.folio_migrate_lru_refshNtauh1hhjKhhhNhNubh)}(hhh](h)}(hHvoid folio_migrate_lru_refs (struct folio *new, const struct folio *old)h]h)}(hGvoid folio_migrate_lru_refs(struct folio *new, const struct folio *old)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:117: ./include/linux/mm_inline.hhMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh)}(hfolio_migrate_lru_refsh]j)}(hfolio_migrate_lru_refsh]hfolio_migrate_lru_refs}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMubj8)}(h,(struct folio *new, const struct folio *old)h](j>)}(hstruct folio *newh](j)}(hjJ,h]hstruct}(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(ubj)}(h h]h }(hj9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(ubh)}(hhh]j)}(hfolioh]hfolio}(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjLmodnameN classnameNjj)}j]j)}jjsbc.folio_migrate_lru_refsasbuh1hhj(ubj)}(h h]h }(hjjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(ubjr)}(hjuh]h*}(hjxhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj(ubj)}(hnewh]hnew}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj$ubj>)}(hconst struct folio *oldh](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjƠhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hfolioh]hfolio}(hjנhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjԠubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj٠modnameN classnameNjj)}j]jfc.folio_migrate_lru_refsasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(holdh]hold}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj$ubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]jM)}(h'copy the reference state to a new folioh]h'copy the reference state to a new folio}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:117: ./include/linux/mm_inline.hhMhj7hhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjRjHjRjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct folio *new`` the destination folio ``const struct folio *old`` the source folio **Description** Transfer the reference state to **new** during migration: the MGLRU refs count, including PG_referenced, or just PG_referenced for the active/inactive LRU.h](jM)}(h**Parameters**h]j)}(hj\h]h Parameters}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjZubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:117: ./include/linux/mm_inline.hhMhjVubj)}(hhh](j)}(h,``struct folio *new`` the destination folio h](j)}(h``struct folio *new``h]jS)}(hj{h]hstruct folio *new}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjyubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:117: ./include/linux/mm_inline.hhMhjuubj)}(hhh]jM)}(hthe destination folioh]hthe destination folio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjuubeh}(h]h ]h"]h$]h&]uh1jhjhMhjrubj)}(h-``const struct folio *old`` the source folio h](j)}(h``const struct folio *old``h]jS)}(hjh]hconst struct folio *old}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:117: ./include/linux/mm_inline.hhMhjubj)}(hhh]jM)}(hthe source folioh]hthe source folio}(hj͡hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjɡhMhjʡubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjɡhMhjrubeh}(h]h ]h"]h$]h&]uh1jhjVubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:117: ./include/linux/mm_inline.hhMhjVubjM)}(hTransfer the reference state to **new** during migration: the MGLRU refs count, including PG_referenced, or just PG_referenced for the active/inactive LRU.h](h Transfer the reference state to }(hjhhhNhNubj)}(h**new**h]hnew}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubht during migration: the MGLRU refs count, including PG_referenced, or just PG_referenced for the active/inactive LRU.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:117: ./include/linux/mm_inline.hhMhjVubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h!num_pages_contiguous (C function)c.num_pages_contiguoushNtauh1hhjKhhhNhNubh)}(hhh](h)}(hBsize_t num_pages_contiguous (struct page **pages, size_t nr_pages)h]h)}(hAsize_t num_pages_contiguous(struct page **pages, size_t nr_pages)h](h)}(hhh]j)}(hsize_th]hsize_t}(hjIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjKmodnameN classnameNjj)}j]j)}jnum_pages_contiguoussbc.num_pages_contiguousasbuh1hhjBhhhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:117: ./include/linux/mm_inline.hhMubj)}(h h]h }(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBhhhjjhMubh)}(hnum_pages_contiguoush]j)}(hjgh]hnum_pages_contiguous}(hj}hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyubah}(h]h ](jjeh"]h$]h&]jjuh1hhjBhhhjjhMubj8)}(h&(struct page **pages, size_t nr_pages)h](j>)}(hstruct page **pagesh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hpageh]hpage}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jec.num_pages_contiguousasbuh1hhjubj)}(h h]h }(hjԢhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hpagesh]hpages}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hsize_t nr_pagesh](h)}(hhh]j)}(hsize_th]hsize_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jec.num_pages_contiguousasbuh1hhjubj)}(h h]h }(hj6hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hnr_pagesh]hnr_pages}(hjDhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjBhhhjjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj>hhhjjhMubah}(h]j9ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjjhMhj;hhubj4)}(hhh]jM)}(hGdetermine the number of contiguous pages that represent contiguous PFNsh]hGdetermine the number of contiguous pages that represent contiguous PFNs}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:117: ./include/linux/mm_inline.hhMhjkhhubah}(h]h ]h"]h$]h&]uh1j3hj;hhhjjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hX6**Parameters** ``struct page **pages`` an array of page pointers ``size_t nr_pages`` length of the array, at least 1 **Description** Determine the number of contiguous pages that represent contiguous PFNs in **pages**, starting from the first page. In some kernel configs contiguous PFNs will not have contiguous struct pages. In these configurations num_pages_contiguous() will return a num smaller than ideal number. The caller should continue to check for pfn contiguity after each call to num_pages_contiguous(). Returns the number of contiguous pages.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:117: ./include/linux/mm_inline.hhMhjubj)}(hhh](j)}(h2``struct page **pages`` an array of page pointers h](j)}(h``struct page **pages``h]jS)}(hjh]hstruct page **pages}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:117: ./include/linux/mm_inline.hhMhjubj)}(hhh]jM)}(han array of page pointersh]han array of page pointers}(hjȣhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjģhMhjţubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjģhMhjubj)}(h4``size_t nr_pages`` length of the array, at least 1 h](j)}(h``size_t nr_pages``h]jS)}(hjh]hsize_t nr_pages}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:117: ./include/linux/mm_inline.hhMhjubj)}(hhh]jM)}(hlength of the array, at least 1h]hlength of the array, at least 1}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hj#h]h Description}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj!ubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:117: ./include/linux/mm_inline.hhMhjubjM)}(hsDetermine the number of contiguous pages that represent contiguous PFNs in **pages**, starting from the first page.h](hKDetermine the number of contiguous pages that represent contiguous PFNs in }(hj9hhhNhNubj)}(h **pages**h]hpages}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj9ubh, starting from the first page.}(hj9hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:117: ./include/linux/mm_inline.hhMhjubjM)}(hX In some kernel configs contiguous PFNs will not have contiguous struct pages. In these configurations num_pages_contiguous() will return a num smaller than ideal number. The caller should continue to check for pfn contiguity after each call to num_pages_contiguous().h]hX In some kernel configs contiguous PFNs will not have contiguous struct pages. In these configurations num_pages_contiguous() will return a num smaller than ideal number. The caller should continue to check for pfn contiguity after each call to num_pages_contiguous().}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:117: ./include/linux/mm_inline.hhMhjubjM)}(h'Returns the number of contiguous pages.h]h'Returns the number of contiguous pages.}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1jLhZ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:117: ./include/linux/mm_inline.hhMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hpage_folio (C macro) c.page_foliohNtauh1hhjKhhhNhNubh)}(hhh](h)}(h page_folioh]h)}(h page_folioh]h)}(h page_folioh]j)}(hjh]h page_folio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhMubah}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]h}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAmacroeh"]h$]h&]jFjAjGjȤjHjȤjIjJjKuh1hhhhjKhNhNubjM)}(h``page_folio (p)``h]jS)}(hjΤh]hpage_folio (p)}(hjФhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj̤ubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhMhjKhhubji)}(hConverts from page to folio. h]jM)}(hConverts from page to folio.h]hConverts from page to folio.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhMhjubah}(h]h ]h"]h$]h&]uh1jhhjhMhjKhhubj)}(hX**Parameters** ``p`` The page. **Description** Every page is part of a folio. This function cannot be called on a NULL pointer. **Context** No reference, nor lock is required on **page**. If the caller does not hold a reference, this call may race with a folio split, so it should re-check the folio still contains this page after gaining a reference on the folio. **Return** The folio which contains this page.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhMhjubj)}(hhh]j)}(h``p`` The page. h](j)}(h``p``h]jS)}(hj"h]hp}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj ubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhMhjubj)}(hhh]jM)}(h The page.h]h The page.}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj7hMhj8ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj7hMhjubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hj]h]h Description}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj[ubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhMhjubjM)}(hQEvery page is part of a folio. This function cannot be called on a NULL pointer.h]hQEvery page is part of a folio. This function cannot be called on a NULL pointer.}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhMhjubjM)}(h **Context**h]j)}(hjh]hContext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhM hjubjM)}(hNo reference, nor lock is required on **page**. If the caller does not hold a reference, this call may race with a folio split, so it should re-check the folio still contains this page after gaining a reference on the folio.h](h&No reference, nor lock is required on }(hjhhhNhNubj)}(h**page**h]hpage}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh. If the caller does not hold a reference, this call may race with a folio split, so it should re-check the folio still contains this page after gaining a reference on the folio.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhM!hjubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhM&hjubjM)}(h#The folio which contains this page.h]h#The folio which contains this page.}(hjӥhhhNhNubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhM%hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfolio_page (C macro) c.folio_pagehNtauh1hhjKhhhNhNubh)}(hhh](h)}(h folio_pageh]h)}(h folio_pageh]h)}(h folio_pageh]j)}(hjh]h folio_page}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhM,ubah}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhM,ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhM,hjhhubj4)}(hhh]h}(h]h ]h"]h$]h&]uh1j3hjhhhjhM,ubeh}(h]h ](jAmacroeh"]h$]h&]jFjAjGj2jHj2jIjJjKuh1hhhhjKhNhNubjM)}(h``folio_page (folio, n)``h]jS)}(hj8h]hfolio_page (folio, n)}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj6ubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhM.hjKhhubji)}(hReturn a page from a folio. h]jM)}(hReturn a page from a folio.h]hReturn a page from a folio.}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhM,hjNubah}(h]h ]h"]h$]h&]uh1jhhj`hM,hjKhhubj)}(hX **Parameters** ``folio`` The folio. ``n`` The page number to return. **Description** **n** is relative to the start of the folio. This function does not check that the page number lies within **folio**; the caller is presumed to have a reference to the page.h](jM)}(h**Parameters**h]j)}(hjmh]h Parameters}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1jhjkubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhM0hjgubj)}(hhh](j)}(h``folio`` The folio. h](j)}(h ``folio``h]jS)}(hjh]hfolio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhM-hjubj)}(hhh]jM)}(h The folio.h]h The folio.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM-hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM-hjubj)}(h!``n`` The page number to return. h](j)}(h``n``h]jS)}(hjŦh]hn}(hjǦhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjæubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhM.hjubj)}(hhh]jM)}(hThe page number to return.h]hThe page number to return.}(hjަhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjڦhM.hjۦubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjڦhM.hjubeh}(h]h ]h"]h$]h&]uh1jhjgubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhM0hjgubjM)}(h**n** is relative to the start of the folio. This function does not check that the page number lies within **folio**; the caller is presumed to have a reference to the page.h](j)}(h**n**h]hn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhg is relative to the start of the folio. This function does not check that the page number lies within }(hjhhhNhNubj)}(h **folio**h]hfolio}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh9; the caller is presumed to have a reference to the page.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhM/hjgubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h(folio_xor_flags_has_waiters (C function)c.folio_xor_flags_has_waitershNtauh1hhjKhhhNhNubh)}(hhh](h)}(hJbool folio_xor_flags_has_waiters (struct folio *folio, unsigned long mask)h]h)}(hIbool folio_xor_flags_has_waiters(struct folio *folio, unsigned long mask)h](j)}(hjh]hbool}(hjehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjahhh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhMubj)}(h h]h }(hjshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjahhhjrhMubh)}(hfolio_xor_flags_has_waitersh]j)}(hfolio_xor_flags_has_waitersh]hfolio_xor_flags_has_waiters}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjahhhjrhMubj8)}(h)(struct folio *folio, unsigned long mask)h](j>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsbc.folio_xor_flags_has_waitersasbuh1hhjubj)}(h h]h }(hjߧhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hunsigned long maskh](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hlongh]hlong}(hj/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hmaskh]hmask}(hjKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjahhhjrhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj]hhhjrhMubah}(h]jXah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjrhMhjZhhubj4)}(hhh]jM)}(hChange some folio flags.h]hChange some folio flags.}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhMhjrhhubah}(h]h ]h"]h$]h&]uh1j3hjZhhhjrhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct folio *folio`` The folio. ``unsigned long mask`` Bits set in this word will be changed. **Description** This must only be used for flags which are changed with the folio lock held. For example, it is unsafe to use for PG_dirty as that can be set without the folio lock held. It can also only be used on flags which are in the range 0-6 as some of the implementations only affect those bits. **Return** Whether there are tasks waiting on the folio.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhMhjubj)}(hhh](j)}(h#``struct folio *folio`` The folio. h](j)}(h``struct folio *folio``h]jS)}(hjh]hstruct folio *folio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhMhjubj)}(hhh]jM)}(h The folio.h]h The folio.}(hjϨhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj˨hMhj̨ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj˨hMhjubj)}(h>``unsigned long mask`` Bits set in this word will be changed. h](j)}(h``unsigned long mask``h]jS)}(hjh]hunsigned long mask}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhMhjubj)}(hhh]jM)}(h&Bits set in this word will be changed.h]h&Bits set in this word will be changed.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hj*h]h Description}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj(ubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhMhjubjM)}(hX This must only be used for flags which are changed with the folio lock held. For example, it is unsafe to use for PG_dirty as that can be set without the folio lock held. It can also only be used on flags which are in the range 0-6 as some of the implementations only affect those bits.h]hX This must only be used for flags which are changed with the folio lock held. For example, it is unsafe to use for PG_dirty as that can be set without the folio lock held. It can also only be used on flags which are in the range 0-6 as some of the implementations only affect those bits.}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhMhjubjM)}(h **Return**h]j)}(hjQh]hReturn}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1jhjOubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhMhjubjM)}(h-Whether there are tasks waiting on the folio.h]h-Whether there are tasks waiting on the folio.}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h folio_test_uptodate (C function)c.folio_test_uptodatehNtauh1hhjKhhhNhNubh)}(hhh](h)}(h4bool folio_test_uptodate (const struct folio *folio)h]h)}(h3bool folio_test_uptodate(const struct folio *folio)h](j)}(hjh]hbool}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhM ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM ubh)}(hfolio_test_uptodateh]j)}(hfolio_test_uptodateh]hfolio_test_uptodate}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhM ubj8)}(h(const struct folio *folio)h]j>)}(hconst struct folio *folioh](j)}(hjh]hconst}(hjҩhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjΩubj)}(h h]h }(hjߩhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjΩubj)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjΩubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjΩubh)}(hhh]j)}(hfolioh]hfolio}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj modnameN classnameNjj)}j]j)}jjsbc.folio_test_uptodateasbuh1hhjΩubj)}(h h]h }(hj+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjΩubjr)}(hjuh]h*}(hj9hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjΩubj)}(hfolioh]hfolio}(hjFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjΩubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjʩubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhM ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhM ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhM hjhhubj4)}(hhh]jM)}(hIs this folio up to date?h]hIs this folio up to date?}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhM hjmhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhM ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hXn**Parameters** ``const struct folio *folio`` The folio. **Description** The uptodate flag is set on a folio when every byte in the folio is at least as new as the corresponding bytes on storage. Anonymous and CoW folios are always uptodate. If the folio is not uptodate, some of the bytes in it may be; see the is_partially_uptodate() address_space operation.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhMhjubj)}(hhh]j)}(h)``const struct folio *folio`` The folio. h](j)}(h``const struct folio *folio``h]jS)}(hjh]hconst struct folio *folio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhM hjubj)}(hhh]jM)}(h The folio.h]h The folio.}(hjʪhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjƪhM hjǪubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjƪhM hjubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhMhjubjM)}(hX!The uptodate flag is set on a folio when every byte in the folio is at least as new as the corresponding bytes on storage. Anonymous and CoW folios are always uptodate. If the folio is not uptodate, some of the bytes in it may be; see the is_partially_uptodate() address_space operation.h]hX!The uptodate flag is set on a folio when every byte in the folio is at least as new as the corresponding bytes on storage. Anonymous and CoW folios are always uptodate. If the folio is not uptodate, some of the bytes in it may be; see the is_partially_uptodate() address_space operation.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfolio_test_large (C function)c.folio_test_largehNtauh1hhjKhhhNhNubh)}(hhh](h)}(h1bool folio_test_large (const struct folio *folio)h]h)}(h0bool folio_test_large(const struct folio *folio)h](j)}(hjh]hbool}(hj1hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-hhh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhM^ubj)}(h h]h }(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-hhhj>hM^ubh)}(hfolio_test_largeh]j)}(hfolio_test_largeh]hfolio_test_large}(hjQhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjMubah}(h]h ](jjeh"]h$]h&]jjuh1hhj-hhhj>hM^ubj8)}(h(const struct folio *folio)h]j>)}(hconst struct folio *folioh](j)}(hjh]hconst}(hjmhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjiubj)}(h h]h }(hjzhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjiubj)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjiubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjiubh)}(hhh]j)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjSsbc.folio_test_largeasbuh1hhjiubj)}(h h]h }(hjƫhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjiubjr)}(hjuh]h*}(hjԫhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjiubj)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjiubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjeubah}(h]h ]h"]h$]h&]jjuh1j7hj-hhhj>hM^ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj)hhhj>hM^ubah}(h]j$ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj>hM^hj&hhubj4)}(hhh]jM)}(h+Does this folio contain more than one page?h]h+Does this folio contain more than one page?}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhM^hjhhubah}(h]h ]h"]h$]h&]uh1j3hj&hhhj>hM^ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj#jHj#jIjJjKuh1hhhhjKhNhNubj)}(hz**Parameters** ``const struct folio *folio`` The folio to test. **Return** True if the folio is larger than one page.h](jM)}(h**Parameters**h]j)}(hj-h]h Parameters}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj+ubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhMbhj'ubj)}(hhh]j)}(h1``const struct folio *folio`` The folio to test. h](j)}(h``const struct folio *folio``h]jS)}(hjLh]hconst struct folio *folio}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjJubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhM_hjFubj)}(hhh]jM)}(hThe folio to test.h]hThe folio to test.}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjahM_hjbubah}(h]h ]h"]h$]h&]uh1jhjFubeh}(h]h ]h"]h$]h&]uh1jhjahM_hjCubah}(h]h ]h"]h$]h&]uh1jhj'ubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhMahj'ubjM)}(h*True if the folio is larger than one page.h]h*True if the folio is larger than one page.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhMahj'ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hPageHuge (C function) c.PageHugehNtauh1hhjKhhhNhNubh)}(hhh](h)}(h'bool PageHuge (const struct page *page)h]h)}(h&bool PageHuge(const struct page *page)h](j)}(hjh]hbool}(hj̬hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjȬhhh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhMubj)}(h h]h }(hjڬhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjȬhhhj٬hMubh)}(hPageHugeh]j)}(hPageHugeh]hPageHuge}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjȬhhhj٬hMubj8)}(h(const struct page *page)h]j>)}(hconst struct page *pageh](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjJ,h]hstruct}(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hpageh]hpage}(hjAhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjCmodnameN classnameNjj)}j]j)}jjsb c.PageHugeasbuh1hhjubj)}(h h]h }(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjohhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hpageh]hpage}(hj|hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjȬhhhj٬hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjĬhhhj٬hMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj٬hMhjhhubj4)}(hhh]jM)}(h*Determine if the page belongs to hugetlbfsh]h*Determine if the page belongs to hugetlbfs}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhMhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhj٬hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``const struct page *page`` The page to test. **Context** Any context. **Return** True for hugetlbfs pages, false for anon pages or pages belonging to other filesystems.h](jM)}(h**Parameters**h]j)}(hjȭh]h Parameters}(hjʭhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjƭubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhMhj­ubj)}(hhh]j)}(h.``const struct page *page`` The page to test. h](j)}(h``const struct page *page``h]jS)}(hjh]hconst struct page *page}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhMhjubj)}(hhh]jM)}(hThe page to test.h]hThe page to test.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjޭubah}(h]h ]h"]h$]h&]uh1jhj­ubjM)}(h **Context**h]j)}(hj"h]hContext}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhMhj­ubjM)}(h Any context.h]h Any context.}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhMhj­ubjM)}(h **Return**h]j)}(hjIh]hReturn}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjGubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhMhj­ubjM)}(hWTrue for hugetlbfs pages, false for anon pages or pages belonging to other filesystems.h]hWTrue for hugetlbfs pages, false for anon pages or pages belonging to other filesystems.}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhMhj­ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h!page_has_movable_ops (C function)c.page_has_movable_opshNtauh1hhjKhhhNhNubh)}(hhh](h)}(h3bool page_has_movable_ops (const struct page *page)h]h)}(h2bool page_has_movable_ops(const struct page *page)h](j)}(hjh]hbool}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhM_ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM_ubh)}(hpage_has_movable_opsh]j)}(hpage_has_movable_opsh]hpage_has_movable_ops}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhM_ubj8)}(h(const struct page *page)h]j>)}(hconst struct page *pageh](j)}(hjh]hconst}(hjʮhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjƮubj)}(h h]h }(hj׮hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjƮubj)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjƮubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjƮubh)}(hhh]j)}(hpageh]hpage}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsbc.page_has_movable_opsasbuh1hhjƮubj)}(h h]h }(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjƮubjr)}(hjuh]h*}(hj1hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjƮubj)}(hpageh]hpage}(hj>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjƮubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj®ubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhM_ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhM_ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhM_hjhhubj4)}(hhh]jM)}(htest for a movable_ops pageh]htest for a movable_ops page}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhM_hjehhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhM_ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``const struct page *page`` The page to test. **Description** Test whether this is a movable_ops page. Such pages will stay that way until freed. Returns true if this is a movable_ops page, otherwise false.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhMchjubj)}(hhh]j)}(h.``const struct page *page`` The page to test. h](j)}(h``const struct page *page``h]jS)}(hjh]hconst struct page *page}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhM`hjubj)}(hhh]jM)}(hThe page to test.h]hThe page to test.}(hj¯hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM`hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM`hjubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhMbhjubjM)}(hSTest whether this is a movable_ops page. Such pages will stay that way until freed.h]hSTest whether this is a movable_ops page. Such pages will stay that way until freed.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhMahjubjM)}(h)}(hconst struct folio *folioh](j)}(hjh]hconst}(hjthhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpubj)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpubh)}(hhh]j)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjZsbc.folio_has_attached_privateasbuh1hhjpubj)}(h h]h }(hjͰhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpubjr)}(hjuh]h*}(hj۰hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjpubj)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjlubah}(h]h ]h"]h$]h&]jjuh1j7hj4hhhjEhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj0hhhjEhMubah}(h]j+ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjEhMhj-hhubj4)}(hhh]jM)}(h,check if the folio has private data attachedh]h,check if the folio has private data attached}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhMhjhhubah}(h]h ]h"]h$]h&]uh1j3hj-hhhjEhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj*jHj*jIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``const struct folio *folio`` The folio to check. **Description** Use this in code that may encounter swapcache or hugetlb folios but only wants to detect attached private data. **Return** true if the folio has private data attached.h](jM)}(h**Parameters**h]j)}(hj4h]h Parameters}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj2ubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhMhj.ubj)}(hhh]j)}(h2``const struct folio *folio`` The folio to check. h](j)}(h``const struct folio *folio``h]jS)}(hjSh]hconst struct folio *folio}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjQubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhMhjMubj)}(hhh]jM)}(hThe folio to check.h]hThe folio to check.}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhhMhjiubah}(h]h ]h"]h$]h&]uh1jhjMubeh}(h]h ]h"]h$]h&]uh1jhjhhMhjJubah}(h]h ]h"]h$]h&]uh1jhj.ubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhMhj.ubjM)}(hoUse this in code that may encounter swapcache or hugetlb folios but only wants to detect attached private data.h]hoUse this in code that may encounter swapcache or hugetlb folios but only wants to detect attached private data.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhMhj.ubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhMhj.ubjM)}(h,true if the folio has private data attached.h]h,true if the folio has private data attached.}(hj˱hhhNhNubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhMhj.ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfolio_has_private (C function)c.folio_has_privatehNtauh1hhjKhhhNhNubh)}(hhh](h)}(h1int folio_has_private (const struct folio *folio)h]h)}(h0int folio_has_private(const struct folio *folio)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhMubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh)}(hfolio_has_privateh]j)}(hfolio_has_privateh]hfolio_has_private}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMubj8)}(h(const struct folio *folio)h]j>)}(hconst struct folio *folioh](j)}(hjh]hconst}(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3ubj)}(h h]h }(hjDhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3ubj)}(hjJ,h]hstruct}(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3ubj)}(h h]h }(hj_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3ubh)}(hhh]j)}(hfolioh]hfolio}(hjphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjrmodnameN classnameNjj)}j]j)}jjsbc.folio_has_privateasbuh1hhj3ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3ubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj3ubj)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj/ubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]jM)}(h$Determine if folio has private stuffh]h$Determine if folio has private stuff}(hjղhhhNhNubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhMhjҲhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``const struct folio *folio`` The folio to be checked **Description** Determine if a folio has private stuff, indicating that release routines should be invoked upon it.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhMhjubj)}(hhh]j)}(h6``const struct folio *folio`` The folio to be checked h](j)}(h``const struct folio *folio``h]jS)}(hjh]hconst struct folio *folio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhMhjubj)}(hhh]jM)}(hThe folio to be checkedh]hThe folio to be checked}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj+hMhj,ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj+hMhj ubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjQh]h Description}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1jhjOubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhMhjubjM)}(hcDetermine if a folio has private stuff, indicating that release routines should be invoked upon it.h]hcDetermine if a folio has private stuff, indicating that release routines should be invoked upon it.}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:118: ./include/linux/page-flags.hhMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfolio_page_idx (C function)c.folio_page_idxhNtauh1hhjKhhhNhNubh)}(hhh](h)}(hQunsigned long folio_page_idx (const struct folio *folio, const struct page *page)h]h)}(hPunsigned long folio_page_idx(const struct folio *folio, const struct page *page)h](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhKubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhKubj)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhKubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhKubh)}(hfolio_page_idxh]j)}(hfolio_page_idxh]hfolio_page_idx}(hjӳhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjϳubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhKubj8)}(h4(const struct folio *folio, const struct page *page)h](j>)}(hconst struct folio *folioh](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjJ,h]hstruct}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hfolioh]hfolio}(hj(hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj*modnameN classnameNjj)}j]j)}jjճsbc.folio_page_idxasbuh1hhjubj)}(h h]h }(hjHhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjVhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hfolioh]hfolio}(hjchhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hconst struct page *pageh](j)}(hjh]hconst}(hj|hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjxubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjxubj)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjxubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjxubh)}(hhh]j)}(hpageh]hpage}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jDc.folio_page_idxasbuh1hhjxubj)}(h h]h }(hjӴhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjxubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjxubj)}(hpageh]hpage}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjxubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhKubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhKubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhKhjhhubj4)}(hhh]jM)}(h'Return the number of a page in a folio.h]h'Return the number of a page in a folio.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhKhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhKubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj0jHj0jIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``const struct folio *folio`` The folio. ``const struct page *page`` The folio page. **Description** This function expects that the page is actually part of the folio. The returned number is relative to the start of the folio.h](jM)}(h**Parameters**h]j)}(hj:h]h Parameters}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj8ubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhKhj4ubj)}(hhh](j)}(h)``const struct folio *folio`` The folio. h](j)}(h``const struct folio *folio``h]jS)}(hjYh]hconst struct folio *folio}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjWubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhKhjSubj)}(hhh]jM)}(h The folio.h]h The folio.}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjnhKhjoubah}(h]h ]h"]h$]h&]uh1jhjSubeh}(h]h ]h"]h$]h&]uh1jhjnhKhjPubj)}(h,``const struct page *page`` The folio page. h](j)}(h``const struct page *page``h]jS)}(hjh]hconst struct page *page}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhKhjubj)}(hhh]jM)}(hThe folio page.h]hThe folio page.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjPubeh}(h]h ]h"]h$]h&]uh1jhj4ubjM)}(h**Description**h]j)}(hj͵h]h Description}(hjϵhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj˵ubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhKhj4ubjM)}(h}This function expects that the page is actually part of the folio. The returned number is relative to the start of the folio.h]h}This function expects that the page is actually part of the folio. The returned number is relative to the start of the folio.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhKhj4ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hvma_flag_t (C type) c.vma_flag_thNtauh1hhjKhhhNhNubh)}(hhh](h)}(h vma_flag_th]h)}(htype vma_flag_th](j)}(hjh]htype}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhKubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhKubh)}(h vma_flag_th]j)}(hj h]h vma_flag_t}(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj.ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhKubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj hhhjhKubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhKhjhhubj4)}(hhh]jM)}(h/specifies an individual VMA flag by bit number.h]h/specifies an individual VMA flag by bit number.}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjQhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhKubeh}(h]h ](jAtypeeh"]h$]h&]jFjAjGjljHjljIjJjKuh1hhhhjKhNhNubjM)}(h**Description**h]j)}(hjrh]h Description}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jhjpubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjKhhubjM)}(hSThis value is made type safe by sparse to avoid passing invalid flag values around.h]hSThis value is made type safe by sparse to avoid passing invalid flag values around.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjKhhubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h)fault_flag_allow_retry_first (C function)c.fault_flag_allow_retry_firsthNtauh1hhjKhhhNhNubh)}(hhh](h)}(h9bool fault_flag_allow_retry_first (enum fault_flag flags)h]h)}(h8bool fault_flag_allow_retry_first(enum fault_flag flags)h](j)}(hjh]hbool}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh)}(hfault_flag_allow_retry_firsth]j)}(hfault_flag_allow_retry_firsth]hfault_flag_allow_retry_first}(hjжhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj̶ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMubj8)}(h(enum fault_flag flags)h]j>)}(henum fault_flag flagsh](j)}(hj#!h]henum}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(h fault_flagh]h fault_flag}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj modnameN classnameNjj)}j]j)}jjҶsbc.fault_flag_allow_retry_firstasbuh1hhjubj)}(h h]h }(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hflagsh]hflags}(hj8hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]jM)}(h check ALLOW_RETRY the first timeh]h check ALLOW_RETRY the first time}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhj_hhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjzjHjzjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``enum fault_flag flags`` Fault flags. **Description** This is mostly used for places where we want to try to avoid taking the mmap_lock for too long a time when waiting for another condition to change, in which case we can try to be polite to release the mmap_lock in the first round to avoid potential starvation of other processes that would also want the mmap_lock. **Return** true if the page fault allows retry and this is the first attempt of the fault handling; false otherwise.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhj~ubj)}(hhh]j)}(h'``enum fault_flag flags`` Fault flags. h](j)}(h``enum fault_flag flags``h]jS)}(hjh]henum fault_flag flags}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjubj)}(hhh]jM)}(h Fault flags.h]h Fault flags.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubah}(h]h ]h"]h$]h&]uh1jhj~ubjM)}(h**Description**h]j)}(hj޷h]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjܷubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhj~ubjM)}(hX:This is mostly used for places where we want to try to avoid taking the mmap_lock for too long a time when waiting for another condition to change, in which case we can try to be polite to release the mmap_lock in the first round to avoid potential starvation of other processes that would also want the mmap_lock.h]hX:This is mostly used for places where we want to try to avoid taking the mmap_lock for too long a time when waiting for another condition to change, in which case we can try to be polite to release the mmap_lock in the first round to avoid potential starvation of other processes that would also want the mmap_lock.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhj~ubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhj~ubjM)}(hitrue if the page fault allows retry and this is the first attempt of the fault handling; false otherwise.h]hitrue if the page fault allows retry and this is the first attempt of the fault handling; false otherwise.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhj~ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h!vma_flags_is_hugetlb (C function)c.vma_flags_is_hugetlbhNtauh1hhjKhhhNhNubh)}(hhh](h)}(h4bool vma_flags_is_hugetlb (const vma_flags_t *flags)h]h)}(h3bool vma_flags_is_hugetlb(const vma_flags_t *flags)h](j)}(hjh]hbool}(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFhhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMFubj)}(h h]h }(hjXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFhhhjWhMFubh)}(hvma_flags_is_hugetlbh]j)}(hvma_flags_is_hugetlbh]hvma_flags_is_hugetlb}(hjjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjfubah}(h]h ](jjeh"]h$]h&]jjuh1hhjFhhhjWhMFubj8)}(h(const vma_flags_t *flags)h]j>)}(hconst vma_flags_t *flagsh](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(h vma_flags_th]h vma_flags_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjlsbc.vma_flags_is_hugetlbasbuh1hhjubj)}(h h]h }(hjĸhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjҸhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hflagsh]hflags}(hj߸hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj~ubah}(h]h ]h"]h$]h&]jjuh1j7hjFhhhjWhMFubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjBhhhjWhMFubah}(h]j=ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjWhMFhj?hhubj4)}(hhh]jM)}(hFDo the specified VMA flags indicate that the VMA is a hugetlb mapping?h]hFDo the specified VMA flags indicate that the VMA is a hugetlb mapping?}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMFhjhhubah}(h]h ]h"]h$]h&]uh1j3hj?hhhjWhMFubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj!jHj!jIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``const vma_flags_t *flags`` The VMA flags to test. **Return** true if the flags indicate a hugetlb mapping, false otherwise.h](jM)}(h**Parameters**h]j)}(hj+h]h Parameters}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj)ubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMJhj%ubj)}(hhh]j)}(h4``const vma_flags_t *flags`` The VMA flags to test. h](j)}(h``const vma_flags_t *flags``h]jS)}(hjJh]hconst vma_flags_t *flags}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjHubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMHhjDubj)}(hhh]jM)}(hThe VMA flags to test.h]hThe VMA flags to test.}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj_hMHhj`ubah}(h]h ]h"]h$]h&]uh1jhjDubeh}(h]h ]h"]h$]h&]uh1jhj_hMHhjAubah}(h]h ]h"]h$]h&]uh1jhj%ubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMJhj%ubjM)}(h>true if the flags indicate a hugetlb mapping, false otherwise.h]h>true if the flags indicate a hugetlb mapping, false otherwise.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMJhj%ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hvma_is_hugetlb (C function)c.vma_is_hugetlbhNtauh1hhjKhhhNhNubh)}(hhh](h)}(h6bool vma_is_hugetlb (const struct vm_area_struct *vma)h]h)}(h5bool vma_is_hugetlb(const struct vm_area_struct *vma)h](j)}(hjh]hbool}(hjʹhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjƹhhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMSubj)}(h h]h }(hjعhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjƹhhhj׹hMSubh)}(hvma_is_hugetlbh]j)}(hvma_is_hugetlbh]hvma_is_hugetlb}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjƹhhhj׹hMSubj8)}(h"(const struct vm_area_struct *vma)h]j>)}(h const struct vm_area_struct *vmah](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjJ,h]hstruct}(hj!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hvm_area_structh]hvm_area_struct}(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj<ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjAmodnameN classnameNjj)}j]j)}jjsbc.vma_is_hugetlbasbuh1hhjubj)}(h h]h }(hj_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjmhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hvmah]hvma}(hjzhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjƹhhhj׹hMSubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj¹hhhj׹hMSubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj׹hMShjhhubj4)}(hhh]jM)}(hIs **vma** a hugetlb mapping?h](hIs }(hjhhhNhNubj)}(h**vma**h]hvma}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh a hugetlb mapping?}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMShjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhj׹hMSubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjκjHjκjIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``const struct vm_area_struct *vma`` The VMA to test. **Return** true if **vma** is a hugetlb mapping, false otherwise.h](jM)}(h**Parameters**h]j)}(hjغh]h Parameters}(hjںhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjֺubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMWhjҺubj)}(hhh]j)}(h6``const struct vm_area_struct *vma`` The VMA to test. h](j)}(h$``const struct vm_area_struct *vma``h]jS)}(hjh]h const struct vm_area_struct *vma}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMThjubj)}(hhh]jM)}(hThe VMA to test.h]hThe VMA to test.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj hMThj ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj hMThjubah}(h]h ]h"]h$]h&]uh1jhjҺubjM)}(h **Return**h]j)}(hj2h]hReturn}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj0ubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMVhjҺubjM)}(h6true if **vma** is a hugetlb mapping, false otherwise.h](htrue if }(hjHhhhNhNubj)}(h**vma**h]hvma}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjHubh' is a hugetlb mapping, false otherwise.}(hjHhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMVhjҺubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h$vma_flags_is_mm_managed (C function)c.vma_flags_is_mm_managedhNtauh1hhjKhhhNhNubh)}(hhh](h)}(h7bool vma_flags_is_mm_managed (const vma_flags_t *flags)h]h)}(h6bool vma_flags_is_mm_managed(const vma_flags_t *flags)h](j)}(hjh]hbool}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM^ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM^ubh)}(hvma_flags_is_mm_managedh]j)}(hvma_flags_is_mm_managedh]hvma_flags_is_mm_managed}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhM^ubj8)}(h(const vma_flags_t *flags)h]j>)}(hconst vma_flags_t *flagsh](j)}(hjh]hconst}(hjŻhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjһhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(h vma_flags_th]h vma_flags_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsbc.vma_flags_is_mm_managedasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hflagsh]hflags}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhM^ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhM^ubah}(h]j|ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhM^hj~hhubj4)}(hhh]jM)}(hXDo the specified VMA flags indicate that the contents of the VMA are managed by core mm?h]hXDo the specified VMA flags indicate that the contents of the VMA are managed by core mm?}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM^hjEhhubah}(h]h ]h"]h$]h&]uh1j3hj~hhhjhM^ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj`jHj`jIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``const vma_flags_t *flags`` The VMA flags to test. **Description** Such a mapping is one established by a simple mmap() or brk() with no driver or other kernel component involved. They are rmappable, and core mm services rmap operations including reclaim, as well as population, CoW and merge/split (if eligible). Mappings which fail this test are those where this is not the case - e.g. MMIO, user-mapped kernel pages, udmabuf (pfnmap shmem), etc. **Return** true if the flags indicate an mm-managed mapping.h](jM)}(h**Parameters**h]j)}(hjjh]h Parameters}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjhubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMbhjdubj)}(hhh]j)}(h4``const vma_flags_t *flags`` The VMA flags to test. h](j)}(h``const vma_flags_t *flags``h]jS)}(hjh]hconst vma_flags_t *flags}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM`hjubj)}(hhh]jM)}(hThe VMA flags to test.h]hThe VMA flags to test.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM`hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM`hjubah}(h]h ]h"]h$]h&]uh1jhjdubjM)}(h**Description**h]j)}(hjļh]h Description}(hjƼhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj¼ubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMbhjdubjM)}(hpSuch a mapping is one established by a simple mmap() or brk() with no driver or other kernel component involved.h]hpSuch a mapping is one established by a simple mmap() or brk() with no driver or other kernel component involved.}(hjڼhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMahjdubjM)}(hThey are rmappable, and core mm services rmap operations including reclaim, as well as population, CoW and merge/split (if eligible).h]hThey are rmappable, and core mm services rmap operations including reclaim, as well as population, CoW and merge/split (if eligible).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMdhjdubjM)}(hMappings which fail this test are those where this is not the case - e.g. MMIO, user-mapped kernel pages, udmabuf (pfnmap shmem), etc.h]hMappings which fail this test are those where this is not the case - e.g. MMIO, user-mapped kernel pages, udmabuf (pfnmap shmem), etc.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMghjdubjM)}(h **Return**h]j)}(hj h]hReturn}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMjhjdubjM)}(h1true if the flags indicate an mm-managed mapping.h]h1true if the flags indicate an mm-managed mapping.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMkhjdubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hvma_is_mm_managed (C function)c.vma_is_mm_managedhNtauh1hhjKhhhNhNubh)}(hhh](h)}(h9bool vma_is_mm_managed (const struct vm_area_struct *vma)h]h)}(h8bool vma_is_mm_managed(const struct vm_area_struct *vma)h](j)}(hjh]hbool}(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJhhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMsubj)}(h h]h }(hj\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJhhhj[hMsubh)}(hvma_is_mm_managedh]j)}(hvma_is_mm_managedh]hvma_is_mm_managed}(hjnhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjJhhhj[hMsubj8)}(h"(const struct vm_area_struct *vma)h]j>)}(h const struct vm_area_struct *vmah](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hvm_area_structh]hvm_area_struct}(hjýhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjŽmodnameN classnameNjj)}j]j)}jjpsbc.vma_is_mm_managedasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hvmah]hvma}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjJhhhj[hMsubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjFhhhj[hMsubah}(h]jAah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj[hMshjChhubj4)}(hhh]jM)}(h/Are the contents of **vma** managed by core mm?h](hAre the contents of }(hj(hhhNhNubj)}(h**vma**h]hvma}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj(ubh managed by core mm?}(hj(hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMshj%hhubah}(h]h ]h"]h$]h&]uh1j3hjChhhj[hMsubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjRjHjRjIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``const struct vm_area_struct *vma`` The VMA to test. **Description** See vma_flags_is_mm_managed() for a description of this property. **Return** true if the VMA is mm-managed.h](jM)}(h**Parameters**h]j)}(hj\h]h Parameters}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjZubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMwhjVubj)}(hhh]j)}(h6``const struct vm_area_struct *vma`` The VMA to test. h](j)}(h$``const struct vm_area_struct *vma``h]jS)}(hj{h]h const struct vm_area_struct *vma}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjyubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMthjuubj)}(hhh]jM)}(hThe VMA to test.h]hThe VMA to test.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMthjubah}(h]h ]h"]h$]h&]uh1jhjuubeh}(h]h ]h"]h$]h&]uh1jhjhMthjrubah}(h]h ]h"]h$]h&]uh1jhjVubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMvhjVubjM)}(hASee vma_flags_is_mm_managed() for a description of this property.h]hASee vma_flags_is_mm_managed() for a description of this property.}(hj̾hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMuhjVubjM)}(h **Return**h]j)}(hjݾh]hReturn}(hj߾hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj۾ubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMwhjVubjM)}(htrue if the VMA is mm-managed.h]htrue if the VMA is mm-managed.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMxhjVubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h'vma_flags_is_fixed_mapping (C function)c.vma_flags_is_fixed_mappinghNtauh1hhjKhhhNhNubh)}(hhh](h)}(h:bool vma_flags_is_fixed_mapping (const vma_flags_t *flags)h]h)}(h9bool vma_flags_is_fixed_mapping(const vma_flags_t *flags)h](j)}(hjh]hbool}(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMubj)}(h h]h }(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhj/hMubh)}(hvma_flags_is_fixed_mappingh]j)}(hvma_flags_is_fixed_mappingh]hvma_flags_is_fixed_mapping}(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhj/hMubj8)}(h(const vma_flags_t *flags)h]j>)}(hconst vma_flags_t *flagsh](j)}(hjh]hconst}(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZubj)}(h h]h }(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZubh)}(hhh]j)}(h vma_flags_th]h vma_flags_t}(hj|hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj~modnameN classnameNjj)}j]j)}jjDsbc.vma_flags_is_fixed_mappingasbuh1hhjZubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjZubj)}(hflagsh]hflags}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjVubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhj/hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhj/hMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj/hMhjhhubj4)}(hhh]jM)}(hcDo the specified VMA flags indicate that this is a fixed mapping that cannot be expanded or merged?h]hcDo the specified VMA flags indicate that this is a fixed mapping that cannot be expanded or merged?}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhj޿hhubah}(h]h ]h"]h$]h&]uh1j3hjhhhj/hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hXE**Parameters** ``const vma_flags_t *flags`` The VMA flags to test. **Description** Fixed mappings are those whose size is set at the point of mmap (for instance, a mapping of a fixed range of memory established by a driver), and thus cannot be expanded or merged. **Return** true if the flags indicate a fixed mapping.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjubj)}(hhh]j)}(h4``const vma_flags_t *flags`` The VMA flags to test. h](j)}(h``const vma_flags_t *flags``h]jS)}(hj"h]hconst vma_flags_t *flags}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjubj)}(hhh]jM)}(hThe VMA flags to test.h]hThe VMA flags to test.}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj7hMhj8ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj7hMhjubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hj]h]h Description}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj[ubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjubjM)}(hFixed mappings are those whose size is set at the point of mmap (for instance, a mapping of a fixed range of memory established by a driver), and thus cannot be expanded or merged.h]hFixed mappings are those whose size is set at the point of mmap (for instance, a mapping of a fixed range of memory established by a driver), and thus cannot be expanded or merged.}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjubjM)}(h+true if the flags indicate a fixed mapping.h]h+true if the flags indicate a fixed mapping.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h!vma_is_fixed_mapping (C function)c.vma_is_fixed_mappinghNtauh1hhjKhhhNhNubh)}(hhh](h)}(h)}(h const struct vm_area_struct *vmah](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjJ,h]hstruct}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hvm_area_structh]hvm_area_struct}(hj>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj@modnameN classnameNjj)}j]j)}jjsbc.vma_is_fixed_mappingasbuh1hhjubj)}(h h]h }(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjlhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hvmah]hvma}(hjyhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]jM)}(h>Is this VMA a fixed mapping that cannot be expanded or merged?h]h>Is this VMA a fixed mapping that cannot be expanded or merged?}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``const struct vm_area_struct *vma`` The VMA to test. **Description** See vma_flags_is_fixed_mapping() for a description of this property. **Return** true if the VMA maps a fixed mapping.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjubj)}(hhh]j)}(h6``const struct vm_area_struct *vma`` The VMA to test. h](j)}(h$``const struct vm_area_struct *vma``h]jS)}(hjh]h const struct vm_area_struct *vma}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjubj)}(hhh]jM)}(hThe VMA to test.h]hThe VMA to test.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjubjM)}(hDSee vma_flags_is_fixed_mapping() for a description of this property.h]hDSee vma_flags_is_fixed_mapping() for a description of this property.}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjubjM)}(h **Return**h]j)}(hjFh]hReturn}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjDubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjubjM)}(h%true if the VMA maps a fixed mapping.h]h%true if the VMA maps a fixed mapping.}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h#vma_flags_is_mm_backed (C function)c.vma_flags_is_mm_backedhNtauh1hhjKhhhNhNubh)}(hhh](h)}(h6bool vma_flags_is_mm_backed (const vma_flags_t *flags)h]h)}(h5bool vma_flags_is_mm_backed(const vma_flags_t *flags)h](j)}(hjh]hbool}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh)}(hvma_flags_is_mm_backedh]j)}(hvma_flags_is_mm_backedh]hvma_flags_is_mm_backed}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMubj8)}(h(const vma_flags_t *flags)h]j>)}(hconst vma_flags_t *flagsh](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(h vma_flags_th]h vma_flags_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsbc.vma_flags_is_mm_backedasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hflagsh]hflags}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]j~ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]jM)}(hBDo the specified VMA flags imply the mapping is backed by core mm?h]hBDo the specified VMA flags imply the mapping is backed by core mm?}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjGhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjbjHjbjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``const vma_flags_t *flags`` The VMA flags to test. **Description** An mm-backed mapping is one managed by core mm (see vma_flags_is_mm_managed()) whose contents are established by core mm's own fault path rather than a custom ->fault handler. Mappings not managed by core mm are populated by their owner, and fixed mappings may be mm-managed but have their contents established by a custom ->fault handler, so neither are mm-backed. hugetlb mappings are fixed, but core mm owns them entirely, so they are. These are the only mappings which can sensibly be merged, locked, dumped or be subject to uffd faulting, as all of these assume core mm and core mm alone manages their contents. **Return** true if the flags imply an mm-backed mapping, otherwise false.h](jM)}(h**Parameters**h]j)}(hjlh]h Parameters}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjfubj)}(hhh]j)}(h4``const vma_flags_t *flags`` The VMA flags to test. h](j)}(h``const vma_flags_t *flags``h]jS)}(hjh]hconst vma_flags_t *flags}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjubj)}(hhh]jM)}(hThe VMA flags to test.h]hThe VMA flags to test.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjfubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjfubjM)}(hAn mm-backed mapping is one managed by core mm (see vma_flags_is_mm_managed()) whose contents are established by core mm's own fault path rather than a custom ->fault handler.h]hAn mm-backed mapping is one managed by core mm (see vma_flags_is_mm_managed()) whose contents are established by core mm’s own fault path rather than a custom ->fault handler.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjfubjM)}(hXMappings not managed by core mm are populated by their owner, and fixed mappings may be mm-managed but have their contents established by a custom ->fault handler, so neither are mm-backed. hugetlb mappings are fixed, but core mm owns them entirely, so they are.h]hXMappings not managed by core mm are populated by their owner, and fixed mappings may be mm-managed but have their contents established by a custom ->fault handler, so neither are mm-backed. hugetlb mappings are fixed, but core mm owns them entirely, so they are.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjfubjM)}(hThese are the only mappings which can sensibly be merged, locked, dumped or be subject to uffd faulting, as all of these assume core mm and core mm alone manages their contents.h]hThese are the only mappings which can sensibly be merged, locked, dumped or be subject to uffd faulting, as all of these assume core mm and core mm alone manages their contents.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjfubjM)}(h **Return**h]j)}(hj h]hReturn}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM>hjfubjM)}(h>true if the flags imply an mm-backed mapping, otherwise false.h]h>true if the flags imply an mm-backed mapping, otherwise false.}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjfubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hvma_is_mm_backed (C function)c.vma_is_mm_backedhNtauh1hhjKhhhNhNubh)}(hhh](h)}(h8bool vma_is_mm_backed (const struct vm_area_struct *vma)h]h)}(h7bool vma_is_mm_backed(const struct vm_area_struct *vma)h](j)}(hjh]hbool}(hjPhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjLhhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMubj)}(h h]h }(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjLhhhj]hMubh)}(hvma_is_mm_backedh]j)}(hvma_is_mm_backedh]hvma_is_mm_backed}(hjphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjlubah}(h]h ](jjeh"]h$]h&]jjuh1hhjLhhhj]hMubj8)}(h"(const struct vm_area_struct *vma)h]j>)}(h const struct vm_area_struct *vmah](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hvm_area_structh]hvm_area_struct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjrsbc.vma_is_mm_backedasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hvmah]hvma}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjLhhhj]hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjHhhhj]hMubah}(h]jCah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj]hMhjEhhubj4)}(hhh]jM)}(hIs **vma** backed by core mm?h](hIs }(hj*hhhNhNubj)}(h**vma**h]hvma}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj*ubh backed by core mm?}(hj*hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhj'hhubah}(h]h ]h"]h$]h&]uh1j3hjEhhhj]hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjTjHjTjIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``const struct vm_area_struct *vma`` The VMA to test. **Description** See vma_flags_is_mm_backed() for details. **Return** true if the VMA is mm-backed, otherwise false.h](jM)}(h**Parameters**h]j)}(hj^h]h Parameters}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj\ubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjXubj)}(hhh]j)}(h6``const struct vm_area_struct *vma`` The VMA to test. h](j)}(h$``const struct vm_area_struct *vma``h]jS)}(hj}h]h const struct vm_area_struct *vma}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj{ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjwubj)}(hhh]jM)}(hThe VMA to test.h]hThe VMA to test.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjwubeh}(h]h ]h"]h$]h&]uh1jhjhMhjtubah}(h]h ]h"]h$]h&]uh1jhjXubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjXubjM)}(h)See vma_flags_is_mm_backed() for details.h]h)See vma_flags_is_mm_backed() for details.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjXubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjXubjM)}(h.true if the VMA is mm-backed, otherwise false.h]h.true if the VMA is mm-backed, otherwise false.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjXubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h vma_flags_can_merge (C function)c.vma_flags_can_mergehNtauh1hhjKhhhNhNubh)}(hhh](h)}(h3bool vma_flags_can_merge (const vma_flags_t *flags)h]h)}(h2bool vma_flags_can_merge(const vma_flags_t *flags)h](j)}(hjh]hbool}(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMubj)}(h h]h }(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhj1hMubh)}(hvma_flags_can_mergeh]j)}(hvma_flags_can_mergeh]hvma_flags_can_merge}(hjDhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj hhhj1hMubj8)}(h(const vma_flags_t *flags)h]j>)}(hconst vma_flags_t *flagsh](j)}(hjh]hconst}(hj`hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\ubj)}(h h]h }(hjmhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\ubh)}(hhh]j)}(h vma_flags_th]h vma_flags_t}(hj~hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjFsbc.vma_flags_can_mergeasbuh1hhj\ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\ubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj\ubj)}(hflagsh]hflags}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjXubah}(h]h ]h"]h$]h&]jjuh1j7hj hhhj1hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhj1hMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj1hMhjhhubj4)}(hhh]jM)}(hDDo the specified VMA flags permit the VMA to be merged with another?h]hDDo the specified VMA flags permit the VMA to be merged with another?}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhj1hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``const vma_flags_t *flags`` The VMA flags to test. **Return** true if the flags permit merging, false otherwise.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjubj)}(hhh]j)}(h4``const vma_flags_t *flags`` The VMA flags to test. h](j)}(h``const vma_flags_t *flags``h]jS)}(hj$h]hconst vma_flags_t *flags}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj"ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjubj)}(hhh]jM)}(hThe VMA flags to test.h]hThe VMA flags to test.}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj9hMhj:ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj9hMhjubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h **Return**h]j)}(hj_h]hReturn}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1jhj]ubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjubjM)}(h2true if the flags permit merging, false otherwise.h]h2true if the flags permit merging, false otherwise.}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hvma_can_merge (C function)c.vma_can_mergehNtauh1hhjKhhhNhNubh)}(hhh](h)}(h5bool vma_can_merge (const struct vm_area_struct *vma)h]h)}(h4bool vma_can_merge(const struct vm_area_struct *vma)h](j)}(hjh]hbool}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh)}(h vma_can_mergeh]j)}(h vma_can_mergeh]h vma_can_merge}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMubj8)}(h"(const struct vm_area_struct *vma)h]j>)}(h const struct vm_area_struct *vmah](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hvm_area_structh]hvm_area_struct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsbc.vma_can_mergeasbuh1hhjubj)}(h h]h }(hj9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjGhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hvmah]hvma}(hjThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]jM)}(h;Do **vma**'s flags permit it to be merged with another VMA?h](hDo }(hj~hhhNhNubj)}(h**vma**h]hvma}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj~ubh3’s flags permit it to be merged with another VMA?}(hj~hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhj{hhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``const struct vm_area_struct *vma`` The VMA to test. **Return** true if the flags permit merging, otherwise false.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjubj)}(hhh]j)}(h6``const struct vm_area_struct *vma`` The VMA to test. h](j)}(h$``const struct vm_area_struct *vma``h]jS)}(hjh]h const struct vm_area_struct *vma}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjubj)}(hhh]jM)}(hThe VMA to test.h]hThe VMA to test.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h **Return**h]j)}(hj h]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjubjM)}(h2true if the flags permit merging, otherwise false.h]h2true if the flags permit merging, otherwise false.}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h vma_kernel_pagesize (C function)c.vma_kernel_pagesizehNtauh1hhjKhhhNhNubh)}(hhh](h)}(h>unsigned long vma_kernel_pagesize (struct vm_area_struct *vma)h]h)}(h=unsigned long vma_kernel_pagesize(struct vm_area_struct *vma)h](j)}(hunsignedh]hunsigned}(hjQhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjMhhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMubj)}(h h]h }(hj`hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjMhhhj_hMubj)}(hlongh]hlong}(hjnhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjMhhhj_hMubj)}(h h]h }(hj|hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjMhhhj_hMubh)}(hvma_kernel_pagesizeh]j)}(hvma_kernel_pagesizeh]hvma_kernel_pagesize}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjMhhhj_hMubj8)}(h(struct vm_area_struct *vma)h]j>)}(hstruct vm_area_struct *vmah](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hvm_area_structh]hvm_area_struct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsbc.vma_kernel_pagesizeasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hvmah]hvma}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjMhhhj_hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjIhhhj_hMubah}(h]jDah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj_hMhjFhhubj4)}(hhh]jM)}(h+Default page size granularity for this VMA.h]h+Default page size granularity for this VMA.}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhj*hhubah}(h]h ]h"]h$]h&]uh1j3hjFhhhj_hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjEjHjEjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct vm_area_struct *vma`` The user mapping. **Description** The kernel page size specifies in which granularity VMA modifications can be performed. Folios in this VMA will be aligned to, and at least the size of the number of bytes returned by this function. The default kernel page size is not affected by Transparent Huge Pages being in effect. **Return** The default page size granularity for this VMA.h](jM)}(h**Parameters**h]j)}(hjOh]h Parameters}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjMubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjIubj)}(hhh]j)}(h1``struct vm_area_struct *vma`` The user mapping. h](j)}(h``struct vm_area_struct *vma``h]jS)}(hjnh]hstruct vm_area_struct *vma}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjlubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjhubj)}(hhh]jM)}(hThe user mapping.h]hThe user mapping.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjhubeh}(h]h ]h"]h$]h&]uh1jhjhMhjeubah}(h]h ]h"]h$]h&]uh1jhjIubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjIubjM)}(hThe kernel page size specifies in which granularity VMA modifications can be performed. Folios in this VMA will be aligned to, and at least the size of the number of bytes returned by this function.h]hThe kernel page size specifies in which granularity VMA modifications can be performed. Folios in this VMA will be aligned to, and at least the size of the number of bytes returned by this function.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjIubjM)}(hWThe default kernel page size is not affected by Transparent Huge Pages being in effect.h]hWThe default kernel page size is not affected by Transparent Huge Pages being in effect.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjIubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjIubjM)}(h/The default page size granularity for this VMA.h]h/The default page size granularity for this VMA.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjIubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfolio_order (C function) c.folio_orderhNtauh1hhjKhhhNhNubh)}(hhh](h)}(h4unsigned int folio_order (const struct folio *folio)h]h)}(h3unsigned int folio_order(const struct folio *folio)h](j)}(hunsignedh]hunsigned}(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMubj)}(h h]h }(hj3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhj2hMubj)}(hinth]hint}(hjAhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhj2hMubj)}(h h]h }(hjOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhj2hMubh)}(h folio_orderh]j)}(h folio_orderh]h folio_order}(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj]ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj hhhj2hMubj8)}(h(const struct folio *folio)h]j>)}(hconst struct folio *folioh](j)}(hjh]hconst}(hj}hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyubj)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyubh)}(hhh]j)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjcsb c.folio_orderasbuh1hhjyubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjyubj)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjuubah}(h]h ]h"]h$]h&]jjuh1j7hj hhhj2hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhj2hMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj2hMhjhhubj4)}(hhh]jM)}(h The allocation order of a folio.h]h The allocation order of a folio.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhj2hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj3jHj3jIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``const struct folio *folio`` The folio. **Description** A folio is composed of 2^order pages. See get_order() for the definition of order. **Return** The order of the folio.h](jM)}(h**Parameters**h]j)}(hj=h]h Parameters}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj;ubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhj7ubj)}(hhh]j)}(h)``const struct folio *folio`` The folio. h](j)}(h``const struct folio *folio``h]jS)}(hj\h]hconst struct folio *folio}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjZubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjVubj)}(hhh]jM)}(h The folio.h]h The folio.}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjqhMhjrubah}(h]h ]h"]h$]h&]uh1jhjVubeh}(h]h ]h"]h$]h&]uh1jhjqhMhjSubah}(h]h ]h"]h$]h&]uh1jhj7ubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhj7ubjM)}(hSA folio is composed of 2^order pages. See get_order() for the definition of order.h]hSA folio is composed of 2^order pages. See get_order() for the definition of order.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhj7ubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhj7ubjM)}(hThe order of the folio.h]hThe order of the folio.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhj7ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfolio_reset_order (C function)c.folio_reset_orderhNtauh1hhjKhhhNhNubh)}(hhh](h)}(h,void folio_reset_order (struct folio *folio)h]h)}(h+void folio_reset_order(struct folio *folio)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh)}(hfolio_reset_orderh]j)}(hfolio_reset_orderh]hfolio_reset_order}(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMubj8)}(h(struct folio *folio)h]j>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hj@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj<ubj)}(h h]h }(hjMhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj<ubh)}(hhh]j)}(hfolioh]hfolio}(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj[ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj`modnameN classnameNjj)}j]j)}jj&sbc.folio_reset_orderasbuh1hhj<ubj)}(h h]h }(hj~hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj<ubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj<ubj)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj<ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj8ubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]jM)}(h+Reset the folio order and derived _nr_pagesh]h+Reset the folio order and derived _nr_pages}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``struct folio *folio`` The folio. **Description** Reset the order and derived _nr_pages to 0. Must only be used in the process of splitting large folios.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjubj)}(hhh]j)}(h#``struct folio *folio`` The folio. h](j)}(h``struct folio *folio``h]jS)}(hjh]hstruct folio *folio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjubj)}(hhh]jM)}(h The folio.h]h The folio.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hj?h]h Description}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj=ubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjubjM)}(hgReset the order and derived _nr_pages to 0. Must only be used in the process of splitting large folios.h]hgReset the order and derived _nr_pages to 0. Must only be used in the process of splitting large folios.}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfolio_mapcount (C function)c.folio_mapcounthNtauh1hhjKhhhNhNubh)}(hhh](h)}(h.int folio_mapcount (const struct folio *folio)h]h)}(h-int folio_mapcount(const struct folio *folio)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh)}(hfolio_mapcounth]j)}(hfolio_mapcounth]hfolio_mapcount}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMubj8)}(h(const struct folio *folio)h]j>)}(hconst struct folio *folioh](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsbc.folio_mapcountasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hj(hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hfolioh]hfolio}(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj|hhhjhMubah}(h]jwah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjyhhubj4)}(hhh]jM)}(h!Number of mappings of this folio.h]h!Number of mappings of this folio.}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhj\hhubah}(h]h ]h"]h$]h&]uh1j3hjyhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjwjHjwjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``const struct folio *folio`` The folio. **Description** The folio mapcount corresponds to the number of present user page table entries that reference any part of a folio. Each such present user page table entry must be paired with exactly on folio reference. For ordindary folios, each user page table entry (PTE/PMD/PUD/...) counts exactly once. For hugetlb folios, each abstracted "hugetlb" user page table entry that references the entire folio counts exactly once, even when such special page table entries are comprised of multiple ordinary page table entries. Will report 0 for pages which cannot be mapped into userspace, such as slab, page tables and similar. **Return** The number of times this folio is mapped.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhj{ubj)}(hhh]j)}(h)``const struct folio *folio`` The folio. h](j)}(h``const struct folio *folio``h]jS)}(hjh]hconst struct folio *folio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjubj)}(hhh]jM)}(h The folio.h]h The folio.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubah}(h]h ]h"]h$]h&]uh1jhj{ubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhj{ubjM)}(hThe folio mapcount corresponds to the number of present user page table entries that reference any part of a folio. Each such present user page table entry must be paired with exactly on folio reference.h]hThe folio mapcount corresponds to the number of present user page table entries that reference any part of a folio. Each such present user page table entry must be paired with exactly on folio reference.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhj{ubjM)}(hWFor ordindary folios, each user page table entry (PTE/PMD/PUD/...) counts exactly once.h]hWFor ordindary folios, each user page table entry (PTE/PMD/PUD/...) counts exactly once.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhj{ubjM)}(hFor hugetlb folios, each abstracted "hugetlb" user page table entry that references the entire folio counts exactly once, even when such special page table entries are comprised of multiple ordinary page table entries.h]hFor hugetlb folios, each abstracted “hugetlb” user page table entry that references the entire folio counts exactly once, even when such special page table entries are comprised of multiple ordinary page table entries.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhj{ubjM)}(heWill report 0 for pages which cannot be mapped into userspace, such as slab, page tables and similar.h]heWill report 0 for pages which cannot be mapped into userspace, such as slab, page tables and similar.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM!hj{ubjM)}(h **Return**h]j)}(hj/h]hReturn}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj-ubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM$hj{ubjM)}(h)The number of times this folio is mapped.h]h)The number of times this folio is mapped.}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM%hj{ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfolio_mapped (C function)c.folio_mappedhNtauh1hhjKhhhNhNubh)}(hhh](h)}(h-bool folio_mapped (const struct folio *folio)h]h)}(h,bool folio_mapped(const struct folio *folio)h](j)}(hjh]hbool}(hjthhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjphhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM5ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjphhhjhM5ubh)}(h folio_mappedh]j)}(h folio_mappedh]h folio_mapped}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjphhhjhM5ubj8)}(h(const struct folio *folio)h]j>)}(hconst struct folio *folioh](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsbc.folio_mappedasbuh1hhjubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hfolioh]hfolio}(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjphhhjhM5ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjlhhhjhM5ubah}(h]jgah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhM5hjihhubj4)}(hhh]jM)}(h$Is this folio mapped into userspace?h]h$Is this folio mapped into userspace?}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM5hjKhhubah}(h]h ]h"]h$]h&]uh1j3hjihhhjhM5ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjfjHjfjIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``const struct folio *folio`` The folio. **Return** True if any page in this folio is referenced by user page tables.h](jM)}(h**Parameters**h]j)}(hjph]h Parameters}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjnubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM9hjjubj)}(hhh]j)}(h)``const struct folio *folio`` The folio. h](j)}(h``const struct folio *folio``h]jS)}(hjh]hconst struct folio *folio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM6hjubj)}(hhh]jM)}(h The folio.h]h The folio.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM6hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM6hjubah}(h]h ]h"]h$]h&]uh1jhjjubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM8hjjubjM)}(hATrue if any page in this folio is referenced by user page tables.h]hATrue if any page in this folio is referenced by user page tables.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM8hjjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hthp_order (C function) c.thp_orderhNtauh1hhjKhhhNhNubh)}(hhh](h)}(h*unsigned int thp_order (struct page *page)h]h)}(h)unsigned int thp_order(struct page *page)h](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMbubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhjhMbubj)}(hinth]hint}(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhjhMbubj)}(h h]h }(hj:hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhjhMbubh)}(h thp_orderh]j)}(h thp_orderh]h thp_order}(hjLhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHubah}(h]h ](jjeh"]h$]h&]jjuh1hhj hhhjhMbubj8)}(h(struct page *page)h]j>)}(hstruct page *pageh](j)}(hjJ,h]hstruct}(hjhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjdubj)}(h h]h }(hjuhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjdubh)}(hhh]j)}(hpageh]hpage}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjNsb c.thp_orderasbuh1hhjdubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjdubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjdubj)}(hpageh]hpage}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjdubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj`ubah}(h]h ]h"]h$]h&]jjuh1j7hj hhhjhMbubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMbubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMbhjhhubj4)}(hhh]jM)}(h!Order of a transparent huge page.h]h!Order of a transparent huge page.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMbhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMbubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hM**Parameters** ``struct page *page`` Head page of a transparent huge page.h](jM)}(h**Parameters**h]j)}(hj h]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMfhjubj)}(hhh]j)}(h;``struct page *page`` Head page of a transparent huge page.h](j)}(h``struct page *page``h]jS)}(hj,h]hstruct page *page}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj*ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhhj&ubj)}(hhh]jM)}(h%Head page of a transparent huge page.h]h%Head page of a transparent huge page.}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMchjBubah}(h]h ]h"]h$]h&]uh1jhj&ubeh}(h]h ]h"]h$]h&]uh1jhjAhMhhj#ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hthp_size (C function) c.thp_sizehNtauh1hhjKhhhNhNubh)}(hhh](h)}(h*unsigned long thp_size (struct page *page)h]h)}(h)unsigned long thp_size(struct page *page)h](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMlubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMlubj)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMlubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMlubh)}(hthp_sizeh]j)}(hthp_sizeh]hthp_size}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMlubj8)}(h(struct page *page)h]j>)}(hstruct page *pageh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hpageh]hpage}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsb c.thp_sizeasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hj+hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hpageh]hpage}(hj8hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMlubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj~hhhjhMlubah}(h]jyah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMlhj{hhubj4)}(hhh]jM)}(h Size of a transparent huge page.h]h Size of a transparent huge page.}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMlhj_hhubah}(h]h ]h"]h$]h&]uh1j3hj{hhhjhMlubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjzjHjzjIjJjKuh1hhhhjKhNhNubj)}(hx**Parameters** ``struct page *page`` Head page of a transparent huge page. **Return** Number of bytes in this page.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMphj~ubj)}(hhh]j)}(h<``struct page *page`` Head page of a transparent huge page. h](j)}(h``struct page *page``h]jS)}(hjh]hstruct page *page}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMmhjubj)}(hhh]jM)}(h%Head page of a transparent huge page.h]h%Head page of a transparent huge page.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMmhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMmhjubah}(h]h ]h"]h$]h&]uh1jhj~ubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMohj~ubjM)}(hNumber of bytes in this page.h]hNumber of bytes in this page.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMohj~ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfolio_get (C function) c.folio_gethNtauh1hhjKhhhNhNubh)}(hhh](h)}(h$void folio_get (struct folio *folio)h]h)}(h#void folio_get(struct folio *folio)h](j)}(hvoidh]hvoid}(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMubj)}(h h]h }(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhj1hMubh)}(h folio_geth]j)}(h folio_geth]h folio_get}(hjDhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhj1hMubj8)}(h(struct folio *folio)h]j>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hj`hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\ubj)}(h h]h }(hjmhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\ubh)}(hhh]j)}(hfolioh]hfolio}(hj~hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjFsb c.folio_getasbuh1hhj\ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\ubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj\ubj)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjXubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhj1hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhj1hMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj1hMhjhhubj4)}(hhh]jM)}(h)Increment the reference count on a folio.h]h)Increment the reference count on a folio.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhj1hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``struct folio *folio`` The folio. **Context** May be called in any context, as long as you know that you have a refcount on the folio. If you do not already have one, folio_try_get() may be the right interface for you to use.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjubj)}(hhh]j)}(h#``struct folio *folio`` The folio. h](j)}(h``struct folio *folio``h]jS)}(hj$h]hstruct folio *folio}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj"ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjubj)}(hhh]jM)}(h The folio.h]h The folio.}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj9hMhj:ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj9hMhjubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h **Context**h]j)}(hj_h]hContext}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1jhj]ubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjubjM)}(hMay be called in any context, as long as you know that you have a refcount on the folio. If you do not already have one, folio_try_get() may be the right interface for you to use.h]hMay be called in any context, as long as you know that you have a refcount on the folio. If you do not already have one, folio_try_get() may be the right interface for you to use.}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfolio_put (C function) c.folio_puthNtauh1hhjKhhhNhNubh)}(hhh](h)}(h$void folio_put (struct folio *folio)h]h)}(h#void folio_put(struct folio *folio)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh)}(h folio_puth]j)}(h folio_puth]h folio_put}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMubj8)}(h(struct folio *folio)h]j>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsb c.folio_putasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hj-hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hfolioh]hfolio}(hj:hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]jM)}(h)Decrement the reference count on a folio.h]h)Decrement the reference count on a folio.}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjahhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj|jHj|jIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct folio *folio`` The folio. **Description** If the folio's reference count reaches zero, the memory will be released back to the page allocator and may be used by another allocation immediately. Do not access the memory or the struct folio after calling folio_put() unless you can be sure that it wasn't the last reference. **Context** May be called in process or interrupt context, but not in NMI context. May be called while holding a spinlock.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjubj)}(hhh]j)}(h#``struct folio *folio`` The folio. h](j)}(h``struct folio *folio``h]jS)}(hjh]hstruct folio *folio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjubj)}(hhh]jM)}(h The folio.h]h The folio.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjubjM)}(hXIf the folio's reference count reaches zero, the memory will be released back to the page allocator and may be used by another allocation immediately. Do not access the memory or the struct folio after calling folio_put() unless you can be sure that it wasn't the last reference.h]hXIf the folio’s reference count reaches zero, the memory will be released back to the page allocator and may be used by another allocation immediately. Do not access the memory or the struct folio after calling folio_put() unless you can be sure that it wasn’t the last reference.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjubjM)}(h **Context**h]j)}(hjh]hContext}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjubjM)}(hoMay be called in process or interrupt context, but not in NMI context. May be called while holding a spinlock.h]hoMay be called in process or interrupt context, but not in NMI context. May be called while holding a spinlock.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfolio_put_refs (C function)c.folio_put_refshNtauh1hhjKhhhNhNubh)}(hhh](h)}(h3void folio_put_refs (struct folio *folio, int refs)h]h)}(h2void folio_put_refs(struct folio *folio, int refs)h](j)}(hvoidh]hvoid}(hjLhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHhhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM ubj)}(h h]h }(hj[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHhhhjZhM ubh)}(hfolio_put_refsh]j)}(hfolio_put_refsh]hfolio_put_refs}(hjmhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjiubah}(h]h ](jjeh"]h$]h&]jjuh1hhjHhhhjZhM ubj8)}(h(struct folio *folio, int refs)h](j>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjosbc.folio_put_refsasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hint refsh](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hrefsh]hrefs}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjHhhhjZhM ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjDhhhjZhM ubah}(h]j?ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjZhM hjAhhubj4)}(hhh]jM)}(h&Reduce the reference count on a folio.h]h&Reduce the reference count on a folio.}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hj>hhubah}(h]h ]h"]h$]h&]uh1j3hjAhhhjZhM ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjYjHjYjIjJjKuh1hhhhjKhNhNubj)}(hX0**Parameters** ``struct folio *folio`` The folio. ``int refs`` The amount to subtract from the folio's reference count. **Description** If the folio's reference count reaches zero, the memory will be released back to the page allocator and may be used by another allocation immediately. Do not access the memory or the struct folio after calling folio_put_refs() unless you can be sure that these weren't the last references. **Context** May be called in process or interrupt context, but not in NMI context. May be called while holding a spinlock.h](jM)}(h**Parameters**h]j)}(hjch]h Parameters}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1jhjaubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hj]ubj)}(hhh](j)}(h#``struct folio *folio`` The folio. h](j)}(h``struct folio *folio``h]jS)}(hjh]hstruct folio *folio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hj|ubj)}(hhh]jM)}(h The folio.h]h The folio.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM hjubah}(h]h ]h"]h$]h&]uh1jhj|ubeh}(h]h ]h"]h$]h&]uh1jhjhM hjyubj)}(hF``int refs`` The amount to subtract from the folio's reference count. h](j)}(h ``int refs``h]jS)}(hjh]hint refs}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjubj)}(hhh]jM)}(h8The amount to subtract from the folio's reference count.h]h:The amount to subtract from the folio’s reference count.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hjyubeh}(h]h ]h"]h$]h&]uh1jhj]ubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hj]ubjM)}(hX"If the folio's reference count reaches zero, the memory will be released back to the page allocator and may be used by another allocation immediately. Do not access the memory or the struct folio after calling folio_put_refs() unless you can be sure that these weren't the last references.h]hX&If the folio’s reference count reaches zero, the memory will be released back to the page allocator and may be used by another allocation immediately. Do not access the memory or the struct folio after calling folio_put_refs() unless you can be sure that these weren’t the last references.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hj]ubjM)}(h **Context**h]j)}(hjh]hContext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hj]ubjM)}(hoMay be called in process or interrupt context, but not in NMI context. May be called while holding a spinlock.h]hoMay be called in process or interrupt context, but not in NMI context. May be called while holding a spinlock.}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hj]ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfolios_put (C function) c.folios_puthNtauh1hhjKhhhNhNubh)}(hhh](h)}(h,void folios_put (struct folio_batch *folios)h]h)}(h+void folios_put(struct folio_batch *folios)h](j)}(hvoidh]hvoid}(hjbhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^hhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM* ubj)}(h h]h }(hjqhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^hhhjphM* ubh)}(h folios_puth]j)}(h folios_puth]h folios_put}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhj^hhhjphM* ubj8)}(h(struct folio_batch *folios)h]j>)}(hstruct folio_batch *foliosh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(h folio_batchh]h folio_batch}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsb c.folios_putasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hfoliosh]hfolios}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hj^hhhjphM* ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjZhhhjphM* ubah}(h]jUah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjphM* hjWhhubj4)}(hhh]jM)}(h4Decrement the reference count on an array of folios.h]h4Decrement the reference count on an array of folios.}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM* hjhhubah}(h]h ]h"]h$]h&]uh1j3hjWhhhjphM* ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj:jHj:jIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct folio_batch *folios`` The folios. **Description** Like folio_put(), but for a batch of folios. This is more efficient than writing the loop yourself as it will optimise the locks which need to be taken if the folios are freed. The folios batch is returned empty and ready to be reused for another batch; there is no need to reinitialise it. **Context** May be called in process or interrupt context, but not in NMI context. May be called while holding a spinlock.h](jM)}(h**Parameters**h]j)}(hjDh]h Parameters}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjBubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM. hj>ubj)}(hhh]j)}(h+``struct folio_batch *folios`` The folios. h](j)}(h``struct folio_batch *folios``h]jS)}(hjch]hstruct folio_batch *folios}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjaubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM+ hj]ubj)}(hhh]jM)}(h The folios.h]h The folios.}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjxhM+ hjyubah}(h]h ]h"]h$]h&]uh1jhj]ubeh}(h]h ]h"]h$]h&]uh1jhjxhM+ hjZubah}(h]h ]h"]h$]h&]uh1jhj>ubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM- hj>ubjM)}(hX$Like folio_put(), but for a batch of folios. This is more efficient than writing the loop yourself as it will optimise the locks which need to be taken if the folios are freed. The folios batch is returned empty and ready to be reused for another batch; there is no need to reinitialise it.h]hX$Like folio_put(), but for a batch of folios. This is more efficient than writing the loop yourself as it will optimise the locks which need to be taken if the folios are freed. The folios batch is returned empty and ready to be reused for another batch; there is no need to reinitialise it.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM, hj>ubjM)}(h **Context**h]j)}(hjh]hContext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM2 hj>ubjM)}(hoMay be called in process or interrupt context, but not in NMI context. May be called while holding a spinlock.h]hoMay be called in process or interrupt context, but not in NMI context. May be called while holding a spinlock.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM3 hj>ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h%vma_flags_is_cow_mapping (C function)c.vma_flags_is_cow_mappinghNtauh1hhjKhhhNhNubh)}(hhh](h)}(h8bool vma_flags_is_cow_mapping (const vma_flags_t *flags)h]h)}(h7bool vma_flags_is_cow_mapping(const vma_flags_t *flags)h](j)}(hjh]hbool}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMp ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMp ubh)}(hvma_flags_is_cow_mappingh]j)}(hvma_flags_is_cow_mappingh]hvma_flags_is_cow_mapping}(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMp ubj8)}(h(const vma_flags_t *flags)h]j>)}(hconst vma_flags_t *flagsh](j)}(hjh]hconst}(hjFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubj)}(h h]h }(hjShhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubh)}(hhh]j)}(h vma_flags_th]h vma_flags_t}(hjdhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjfmodnameN classnameNjj)}j]j)}jj,sbc.vma_flags_is_cow_mappingasbuh1hhjBubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjBubj)}(hflagsh]hflags}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj>ubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMp ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMp ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMp hjhhubj4)}(hhh]jM)}(h'Do these VMA flags imply a CoW mapping?h]h'Do these VMA flags imply a CoW mapping?}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMp hjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMp ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``const vma_flags_t *flags`` The VMA flags to check. **Description** Mappings which could be CoW'd (subject to Copy-On-Write faults) are described as CoW mappings. All mappings backed by anonymous folios (all anonymous mappings and most MAP_PRIVATE-file backed ranges) are CoW mappings. All other mappings (including all MAP_SHARED mappings) are non-CoW. The criteria are !VMA_SHARED_BIT, VMA_MAYWRITE_BIT. VMA_MAYWRITE_BIT is checked instead of VMA_WRITE_BIT to account for both future mprotect() calls which can render a read-only mapping writable, and GUP with FOLL_FORCE (e.g. ptrace) which can CoW a read-only mapping. - No anonymous mapping can ever clear VMA_MAYWRITE_BIT. - Writes to anonymous mappings do not immediately result in CoW faults but may do so after the process is forked or if a read is followed by a write. - Writes to MAP_PRIVATE file-backed mappings result in CoW faults and may do so again after fork. - MAP_SHARED mappings of a file opened read-only are transformed into VMA_MAYSHARE_BIT, !VMA_SHARED_BIT, !VMA_MAYWRITE_BIT mappings, so remain non-CoW. - Drivers may clear VMA_MAYWRITE_BIT but do so at mmap() time and cannot mark themselves anonymous. Having cleared this flag it is not valid for them to leave the VMA_WRITE_BIT flag set. As a consequence, the anonymous reverse mapping only tracks CoW mappings. **Return** true if the flags indicate a CoW mapping, otherwise false.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMt hjubj)}(hhh]j)}(h5``const vma_flags_t *flags`` The VMA flags to check. h](j)}(h``const vma_flags_t *flags``h]jS)}(hj h]hconst vma_flags_t *flags}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMq hjubj)}(hhh]jM)}(hThe VMA flags to check.h]hThe VMA flags to check.}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMq hj ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMq hjubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjEh]h Description}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjCubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMs hjubjM)}(h^Mappings which could be CoW'd (subject to Copy-On-Write faults) are described as CoW mappings.h]h`Mappings which could be CoW’d (subject to Copy-On-Write faults) are described as CoW mappings.}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMr hjubjM)}(hzAll mappings backed by anonymous folios (all anonymous mappings and most MAP_PRIVATE-file backed ranges) are CoW mappings.h]hzAll mappings backed by anonymous folios (all anonymous mappings and most MAP_PRIVATE-file backed ranges) are CoW mappings.}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMu hjubjM)}(hCAll other mappings (including all MAP_SHARED mappings) are non-CoW.h]hCAll other mappings (including all MAP_SHARED mappings) are non-CoW.}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMx hjubjM)}(h3The criteria are !VMA_SHARED_BIT, VMA_MAYWRITE_BIT.h]h3The criteria are !VMA_SHARED_BIT, VMA_MAYWRITE_BIT.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMz hjubjM)}(hVMA_MAYWRITE_BIT is checked instead of VMA_WRITE_BIT to account for both future mprotect() calls which can render a read-only mapping writable, and GUP with FOLL_FORCE (e.g. ptrace) which can CoW a read-only mapping.h]hVMA_MAYWRITE_BIT is checked instead of VMA_WRITE_BIT to account for both future mprotect() calls which can render a read-only mapping writable, and GUP with FOLL_FORCE (e.g. ptrace) which can CoW a read-only mapping.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM| hjubj^)}(hhh](jc)}(h6No anonymous mapping can ever clear VMA_MAYWRITE_BIT. h]jM)}(h5No anonymous mapping can ever clear VMA_MAYWRITE_BIT.h]h5No anonymous mapping can ever clear VMA_MAYWRITE_BIT.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjubah}(h]h ]h"]h$]h&]uh1jbhjubjc)}(hWrites to anonymous mappings do not immediately result in CoW faults but may do so after the process is forked or if a read is followed by a write. h]jM)}(hWrites to anonymous mappings do not immediately result in CoW faults but may do so after the process is forked or if a read is followed by a write.h]hWrites to anonymous mappings do not immediately result in CoW faults but may do so after the process is forked or if a read is followed by a write.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjubah}(h]h ]h"]h$]h&]uh1jbhjubjc)}(h`Writes to MAP_PRIVATE file-backed mappings result in CoW faults and may do so again after fork. h]jM)}(h_Writes to MAP_PRIVATE file-backed mappings result in CoW faults and may do so again after fork.h]h_Writes to MAP_PRIVATE file-backed mappings result in CoW faults and may do so again after fork.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjubah}(h]h ]h"]h$]h&]uh1jbhjubjc)}(hMAP_SHARED mappings of a file opened read-only are transformed into VMA_MAYSHARE_BIT, !VMA_SHARED_BIT, !VMA_MAYWRITE_BIT mappings, so remain non-CoW. h]jM)}(hMAP_SHARED mappings of a file opened read-only are transformed into VMA_MAYSHARE_BIT, !VMA_SHARED_BIT, !VMA_MAYWRITE_BIT mappings, so remain non-CoW.h]hMAP_SHARED mappings of a file opened read-only are transformed into VMA_MAYSHARE_BIT, !VMA_SHARED_BIT, !VMA_MAYWRITE_BIT mappings, so remain non-CoW.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjubah}(h]h ]h"]h$]h&]uh1jbhjubjc)}(hDrivers may clear VMA_MAYWRITE_BIT but do so at mmap() time and cannot mark themselves anonymous. Having cleared this flag it is not valid for them to leave the VMA_WRITE_BIT flag set. h]jM)}(hDrivers may clear VMA_MAYWRITE_BIT but do so at mmap() time and cannot mark themselves anonymous. Having cleared this flag it is not valid for them to leave the VMA_WRITE_BIT flag set.h]hDrivers may clear VMA_MAYWRITE_BIT but do so at mmap() time and cannot mark themselves anonymous. Having cleared this flag it is not valid for them to leave the VMA_WRITE_BIT flag set.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hj ubah}(h]h ]h"]h$]h&]uh1jbhjubeh}(h]h ]h"]h$]h&]jjuh1j]hjhM hjubjM)}(hIAs a consequence, the anonymous reverse mapping only tracks CoW mappings.h]hIAs a consequence, the anonymous reverse mapping only tracks CoW mappings.}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjubjM)}(h **Return**h]j)}(hj=h]hReturn}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj;ubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjubjM)}(h:true if the flags indicate a CoW mapping, otherwise false.h]h:true if the flags indicate a CoW mapping, otherwise false.}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hvma_is_cow_mapping (C function)c.vma_is_cow_mappinghNtauh1hhjKhhhNhNubh)}(hhh](h)}(h:bool vma_is_cow_mapping (const struct vm_area_struct *vma)h]h)}(h9bool vma_is_cow_mapping(const struct vm_area_struct *vma)h](j)}(hjh]hbool}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~hhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~hhhjhM ubh)}(hvma_is_cow_mappingh]j)}(hvma_is_cow_mappingh]hvma_is_cow_mapping}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhj~hhhjhM ubj8)}(h"(const struct vm_area_struct *vma)h]j>)}(h const struct vm_area_struct *vmah](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hvm_area_structh]hvm_area_struct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsbc.vma_is_cow_mappingasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hj%hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hvmah]hvma}(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hj~hhhjhM ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjzhhhjhM ubah}(h]juah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhM hjwhhubj4)}(hhh]jM)}(hIs this VMA a CoW mapping?h]hIs this VMA a CoW mapping?}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjYhhubah}(h]h ]h"]h$]h&]uh1j3hjwhhhjhM ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjtjHjtjIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``const struct vm_area_struct *vma`` The VMA to check. **Description** See vma_flags_is_cow_mapping() for details. **Return** true if the VMA is a CoW mapping, otherwise false.h](jM)}(h**Parameters**h]j)}(hj~h]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj|ubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjxubj)}(hhh]j)}(h7``const struct vm_area_struct *vma`` The VMA to check. h](j)}(h$``const struct vm_area_struct *vma``h]jS)}(hjh]h const struct vm_area_struct *vma}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjubj)}(hhh]jM)}(hThe VMA to check.h]hThe VMA to check.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjxubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjxubjM)}(h+See vma_flags_is_cow_mapping() for details.h]h+See vma_flags_is_cow_mapping() for details.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjxubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjxubjM)}(h2true if the VMA is a CoW mapping, otherwise false.h]h2true if the VMA is a CoW mapping, otherwise false.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjxubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h$vma_desc_is_cow_mapping (C function)c.vma_desc_is_cow_mappinghNtauh1hhjKhhhNhNubh)}(hhh](h)}(h8bool vma_desc_is_cow_mapping (struct vm_area_desc *desc)h]h)}(h7bool vma_desc_is_cow_mapping(struct vm_area_desc *desc)h](j)}(hjh]hbool}(hjDhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@hhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM ubj)}(h h]h }(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@hhhjQhM ubh)}(hvma_desc_is_cow_mappingh]j)}(hvma_desc_is_cow_mappingh]hvma_desc_is_cow_mapping}(hjdhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj`ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj@hhhjQhM ubj8)}(h(struct vm_area_desc *desc)h]j>)}(hstruct vm_area_desc *desch](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|ubh)}(hhh]j)}(h vm_area_desch]h vm_area_desc}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjfsbc.vma_desc_is_cow_mappingasbuh1hhj|ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|ubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj|ubj)}(hdesch]hdesc}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjxubah}(h]h ]h"]h$]h&]jjuh1j7hj@hhhjQhM ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj<hhhjQhM ubah}(h]j7ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjQhM hj9hhubj4)}(hhh]jM)}(h%Is this VMA descriptor a CoW mapping?h]h%Is this VMA descriptor a CoW mapping?}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjhhubah}(h]h ]h"]h$]h&]uh1j3hj9hhhjQhM ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``struct vm_area_desc *desc`` The VMA descriptor to check. **Description** See vma_flags_is_cow_mapping() for details. **Return** true if the VMA descriptor describes a CoW mapping, otherwise false.h](jM)}(h**Parameters**h]j)}(hj%h]h Parameters}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj#ubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjubj)}(hhh]j)}(h;``struct vm_area_desc *desc`` The VMA descriptor to check. h](j)}(h``struct vm_area_desc *desc``h]jS)}(hjDh]hstruct vm_area_desc *desc}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjBubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hj>ubj)}(hhh]jM)}(hThe VMA descriptor to check.h]hThe VMA descriptor to check.}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjYhM hjZubah}(h]h ]h"]h$]h&]uh1jhj>ubeh}(h]h ]h"]h$]h&]uh1jhjYhM hj;ubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj}ubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjubjM)}(h+See vma_flags_is_cow_mapping() for details.h]h+See vma_flags_is_cow_mapping() for details.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjubjM)}(hDtrue if the VMA descriptor describes a CoW mapping, otherwise false.h]hDtrue if the VMA descriptor describes a CoW mapping, otherwise false.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfolio_pfn (C function) c.folio_pfnhNtauh1hhjKhhhNhNubh)}(hhh](h)}(h3unsigned long folio_pfn (const struct folio *folio)h]h)}(h2unsigned long folio_pfn(const struct folio *folio)h](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM ubj)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM ubh)}(h folio_pfnh]j)}(h folio_pfnh]h folio_pfn}(hj(hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhM ubj8)}(h(const struct folio *folio)h]j>)}(hconst struct folio *folioh](j)}(hjh]hconst}(hjDhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@ubj)}(h h]h }(hjQhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@ubj)}(hjJ,h]hstruct}(hj_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@ubj)}(h h]h }(hjlhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@ubh)}(hhh]j)}(hfolioh]hfolio}(hj}hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjzubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jj*sb c.folio_pfnasbuh1hhj@ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@ubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj@ubj)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj<ubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhM ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhM ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhM hjhhubj4)}(hhh]jM)}(h(Return the Page Frame Number of a folio.h]h(Return the Page Frame Number of a folio.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhM ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``const struct folio *folio`` The folio. **Description** A folio may contain multiple pages. The pages have consecutive Page Frame Numbers. **Return** The Page Frame Number of the first page in the folio.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjubj)}(hhh]j)}(h)``const struct folio *folio`` The folio. h](j)}(h``const struct folio *folio``h]jS)}(hj#h]hconst struct folio *folio}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj!ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjubj)}(hhh]jM)}(h The folio.h]h The folio.}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj8hM hj9ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj8hM hjubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hj^h]h Description}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj\ubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjubjM)}(hSA folio may contain multiple pages. The pages have consecutive Page Frame Numbers.h]hSA folio may contain multiple pages. The pages have consecutive Page Frame Numbers.}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjubjM)}(h5The Page Frame Number of the first page in the folio.h]h5The Page Frame Number of the first page in the folio.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfolio_mk_pte (C function)c.folio_mk_ptehNtauh1hhjKhhhNhNubh)}(hhh](h)}(h?pte_t folio_mk_pte (const struct folio *folio, pgprot_t pgprot)h]h)}(h>pte_t folio_mk_pte(const struct folio *folio, pgprot_t pgprot)h](h)}(hhh]j)}(hpte_th]hpte_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}j folio_mk_ptesbc.folio_mk_pteasbuh1hhjhhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM ubh)}(h folio_mk_pteh]j)}(hjh]h folio_mk_pte}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhM ubj8)}(h,(const struct folio *folio, pgprot_t pgprot)h](j>)}(hconst struct folio *folioh](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjJ,h]hstruct}(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjDhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hfolioh]hfolio}(hjUhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjWmodnameN classnameNjj)}j]jc.folio_mk_pteasbuh1hhjubj)}(h h]h }(hjshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hpgprot_t pgproth](h)}(hhh]j)}(hpgprot_th]hpgprot_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.folio_mk_pteasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hpgproth]hpgprot}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhM ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhM ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhM hjhhubj4)}(hhh]jM)}(hCreate a PTE for this folioh]hCreate a PTE for this folio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhM ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hX?**Parameters** ``const struct folio *folio`` The folio to create a PTE for ``pgprot_t pgprot`` The page protection bits to use **Description** Create a page table entry for the first page of this folio. This is suitable for passing to set_ptes(). **Return** A page table entry suitable for mapping this folio.h](jM)}(h**Parameters**h]j)}(hj"h]h Parameters}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjubj)}(hhh](j)}(h<``const struct folio *folio`` The folio to create a PTE for h](j)}(h``const struct folio *folio``h]jS)}(hjAh]hconst struct folio *folio}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj?ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hj;ubj)}(hhh]jM)}(hThe folio to create a PTE forh]hThe folio to create a PTE for}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjVhM hjWubah}(h]h ]h"]h$]h&]uh1jhj;ubeh}(h]h ]h"]h$]h&]uh1jhjVhM hj8ubj)}(h4``pgprot_t pgprot`` The page protection bits to use h](j)}(h``pgprot_t pgprot``h]jS)}(hjzh]hpgprot_t pgprot}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjxubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjtubj)}(hhh]jM)}(hThe page protection bits to useh]hThe page protection bits to use}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjtubeh}(h]h ]h"]h$]h&]uh1jhjhM hj8ubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjubjM)}(hgCreate a page table entry for the first page of this folio. This is suitable for passing to set_ptes().h]hgCreate a page table entry for the first page of this folio. This is suitable for passing to set_ptes().}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjubjM)}(h3A page table entry suitable for mapping this folio.h]h3A page table entry suitable for mapping this folio.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfolio_mk_pmd (C function)c.folio_mk_pmdhNtauh1hhjKhhhNhNubh)}(hhh](h)}(h?pmd_t folio_mk_pmd (const struct folio *folio, pgprot_t pgprot)h]h)}(h>pmd_t folio_mk_pmd(const struct folio *folio, pgprot_t pgprot)h](h)}(hhh]j)}(hpmd_th]hpmd_t}(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj&modnameN classnameNjj)}j]j)}j folio_mk_pmdsbc.folio_mk_pmdasbuh1hhjhhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM% ubj)}(h h]h }(hjFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjEhM% ubh)}(h folio_mk_pmdh]j)}(hjBh]h folio_mk_pmd}(hjXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjTubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjEhM% ubj8)}(h,(const struct folio *folio, pgprot_t pgprot)h](j>)}(hconst struct folio *folioh](j)}(hjh]hconst}(hjshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjoubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjoubj)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjoubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjoubh)}(hhh]j)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j@c.folio_mk_pmdasbuh1hhjoubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjoubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjoubj)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjoubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjkubj>)}(hpgprot_t pgproth](h)}(hhh]j)}(hpgprot_th]hpgprot_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j@c.folio_mk_pmdasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hpgproth]hpgprot}(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjkubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjEhM% ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjEhM% ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjEhM% hjhhubj4)}(hhh]jM)}(hCreate a PMD for this folioh]hCreate a PMD for this folio}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM% hjThhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjEhM% ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjojHjojIjJjKuh1hhhhjKhNhNubj)}(hXA**Parameters** ``const struct folio *folio`` The folio to create a PMD for ``pgprot_t pgprot`` The page protection bits to use **Description** Create a page table entry for the first page of this folio. This is suitable for passing to set_pmd_at(). **Return** A page table entry suitable for mapping this folio.h](jM)}(h**Parameters**h]j)}(hjyh]h Parameters}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjwubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM) hjsubj)}(hhh](j)}(h<``const struct folio *folio`` The folio to create a PMD for h](j)}(h``const struct folio *folio``h]jS)}(hjh]hconst struct folio *folio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM& hjubj)}(hhh]jM)}(hThe folio to create a PMD forh]hThe folio to create a PMD for}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM& hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM& hjubj)}(h4``pgprot_t pgprot`` The page protection bits to use h](j)}(h``pgprot_t pgprot``h]jS)}(hjh]hpgprot_t pgprot}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM' hjubj)}(hhh]jM)}(hThe page protection bits to useh]hThe page protection bits to use}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM' hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM' hjubeh}(h]h ]h"]h$]h&]uh1jhjsubjM)}(h**Description**h]j)}(hj h]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM) hjsubjM)}(hiCreate a page table entry for the first page of this folio. This is suitable for passing to set_pmd_at().h]hiCreate a page table entry for the first page of this folio. This is suitable for passing to set_pmd_at().}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM( hjsubjM)}(h **Return**h]j)}(hj3h]hReturn}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj1ubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM+ hjsubjM)}(h3A page table entry suitable for mapping this folio.h]h3A page table entry suitable for mapping this folio.}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM, hjsubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfolio_mk_pud (C function)c.folio_mk_pudhNtauh1hhjKhhhNhNubh)}(hhh](h)}(h?pud_t folio_mk_pud (const struct folio *folio, pgprot_t pgprot)h]h)}(h>pud_t folio_mk_pud(const struct folio *folio, pgprot_t pgprot)h](h)}(hhh]j)}(hpud_th]hpud_t}(hj{hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjxubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj}modnameN classnameNjj)}j]j)}j folio_mk_pudsbc.folio_mk_pudasbuh1hhjthhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM5 ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjthhhjhM5 ubh)}(h folio_mk_pudh]j)}(hjh]h folio_mk_pud}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjthhhjhM5 ubj8)}(h,(const struct folio *folio, pgprot_t pgprot)h](j>)}(hconst struct folio *folioh](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.folio_mk_pudasbuh1hhjubj)}(h h]h }(hj!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hj/hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hfolioh]hfolio}(hj<hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hpgprot_t pgproth](h)}(hhh]j)}(hpgprot_th]hpgprot_t}(hjXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjUubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjZmodnameN classnameNjj)}j]jc.folio_mk_pudasbuh1hhjQubj)}(h h]h }(hjvhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjQubj)}(hpgproth]hpgprot}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjQubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjthhhjhM5 ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjphhhjhM5 ubah}(h]jkah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhM5 hjmhhubj4)}(hhh]jM)}(hCreate a PUD for this folioh]hCreate a PUD for this folio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM5 hjhhubah}(h]h ]h"]h$]h&]uh1j3hjmhhhjhM5 ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hXA**Parameters** ``const struct folio *folio`` The folio to create a PUD for ``pgprot_t pgprot`` The page protection bits to use **Description** Create a page table entry for the first page of this folio. This is suitable for passing to set_pud_at(). **Return** A page table entry suitable for mapping this folio.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM9 hjubj)}(hhh](j)}(h<``const struct folio *folio`` The folio to create a PUD for h](j)}(h``const struct folio *folio``h]jS)}(hjh]hconst struct folio *folio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM6 hjubj)}(hhh]jM)}(hThe folio to create a PUD forh]hThe folio to create a PUD for}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM6 hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM6 hjubj)}(h4``pgprot_t pgprot`` The page protection bits to use h](j)}(h``pgprot_t pgprot``h]jS)}(hj(h]hpgprot_t pgprot}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj&ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM7 hj"ubj)}(hhh]jM)}(hThe page protection bits to useh]hThe page protection bits to use}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj=hM7 hj>ubah}(h]h ]h"]h$]h&]uh1jhj"ubeh}(h]h ]h"]h$]h&]uh1jhj=hM7 hjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjch]h Description}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1jhjaubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM9 hjubjM)}(hiCreate a page table entry for the first page of this folio. This is suitable for passing to set_pud_at().h]hiCreate a page table entry for the first page of this folio. This is suitable for passing to set_pud_at().}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM8 hjubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM; hjubjM)}(h3A page table entry suitable for mapping this folio.h]h3A page table entry suitable for mapping this folio.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM< hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h#folio_maybe_dma_pinned (C function)c.folio_maybe_dma_pinnedhNtauh1hhjKhhhNhNubh)}(hhh](h)}(h1bool folio_maybe_dma_pinned (struct folio *folio)h]h)}(h0bool folio_maybe_dma_pinned(struct folio *folio)h](j)}(hjh]hbool}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMN ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMN ubh)}(hfolio_maybe_dma_pinnedh]j)}(hfolio_maybe_dma_pinnedh]hfolio_maybe_dma_pinned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMN ubj8)}(h(struct folio *folio)h]j>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hfolioh]hfolio}(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj+modnameN classnameNjj)}j]j)}jjsbc.folio_maybe_dma_pinnedasbuh1hhjubj)}(h h]h }(hjIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjWhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hfolioh]hfolio}(hjdhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMN ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMN ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMN hjhhubj4)}(hhh]jM)}(h(Report if a folio may be pinned for DMA.h]h(Report if a folio may be pinned for DMA.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMN hjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMN ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hX **Parameters** ``struct folio *folio`` The folio. **Description** This function checks if a folio has been pinned via a call to a function in the pin_user_pages() family. For small folios, the return value is partially fuzzy: false is not fuzzy, because it means "definitely not pinned for DMA", but true means "probably pinned for DMA, but possibly a false positive due to having at least GUP_PIN_COUNTING_BIAS worth of normal folio references". False positives are OK, because: a) it's unlikely for a folio to get that many refcounts, and b) all the callers of this routine are expected to be able to deal gracefully with a false positive. For most large folios, the result will be exactly correct. That's because we have more tracking data available: the _pincount field is used instead of the GUP_PIN_COUNTING_BIAS scheme. For more information, please see Documentation/core-api/pin_user_pages.rst. **Return** True, if it is likely that the folio has been "dma-pinned". False, if the folio is definitely not dma-pinned.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMR hjubj)}(hhh]j)}(h#``struct folio *folio`` The folio. h](j)}(h``struct folio *folio``h]jS)}(hjh]hstruct folio *folio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMO hjubj)}(hhh]jM)}(h The folio.h]h The folio.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMO hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMO hjubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hj h]h Description}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMQ hjubjM)}(hhThis function checks if a folio has been pinned via a call to a function in the pin_user_pages() family.h]hhThis function checks if a folio has been pinned via a call to a function in the pin_user_pages() family.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMP hjubjM)}(hXFor small folios, the return value is partially fuzzy: false is not fuzzy, because it means "definitely not pinned for DMA", but true means "probably pinned for DMA, but possibly a false positive due to having at least GUP_PIN_COUNTING_BIAS worth of normal folio references".h]hXFor small folios, the return value is partially fuzzy: false is not fuzzy, because it means “definitely not pinned for DMA”, but true means “probably pinned for DMA, but possibly a false positive due to having at least GUP_PIN_COUNTING_BIAS worth of normal folio references”.}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMS hjubjM)}(hFalse positives are OK, because: a) it's unlikely for a folio to get that many refcounts, and b) all the callers of this routine are expected to be able to deal gracefully with a false positive.h]hFalse positives are OK, because: a) it’s unlikely for a folio to get that many refcounts, and b) all the callers of this routine are expected to be able to deal gracefully with a false positive.}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMX hjubjM)}(hFor most large folios, the result will be exactly correct. That's because we have more tracking data available: the _pincount field is used instead of the GUP_PIN_COUNTING_BIAS scheme.h]hFor most large folios, the result will be exactly correct. That’s because we have more tracking data available: the _pincount field is used instead of the GUP_PIN_COUNTING_BIAS scheme.}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM\ hjubjM)}(hKFor more information, please see Documentation/core-api/pin_user_pages.rst.h]hKFor more information, please see Documentation/core-api/pin_user_pages.rst.}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM` hjubjM)}(h **Return**h]j)}(hjmh]hReturn}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1jhjkubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMb hjubjM)}(hmTrue, if it is likely that the folio has been "dma-pinned". False, if the folio is definitely not dma-pinned.h]hqTrue, if it is likely that the folio has been “dma-pinned”. False, if the folio is definitely not dma-pinned.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMc hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](his_zero_page (C function)c.is_zero_pagehNtauh1hhjKhhhNhNubh)}(hhh](h)}(h+bool is_zero_page (const struct page *page)h]h)}(h*bool is_zero_page(const struct page *page)h](j)}(hjh]hbool}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM ubh)}(h is_zero_pageh]j)}(h is_zero_pageh]h is_zero_page}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhM ubj8)}(h(const struct page *page)h]j>)}(hconst struct page *pageh](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjJ,h]hstruct}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hpageh]hpage}(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj)modnameN classnameNjj)}j]j)}jjsbc.is_zero_pageasbuh1hhjubj)}(h h]h }(hjGhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjUhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hpageh]hpage}(hjbhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhM ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhM ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhM hjhhubj4)}(hhh]jM)}(hQuery if a page is a zero pageh]hQuery if a page is a zero page}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhM ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``const struct page *page`` The page to query **Description** This returns true if **page** is one of the permanent zero pages.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjubj)}(hhh]j)}(h.``const struct page *page`` The page to query h](j)}(h``const struct page *page``h]jS)}(hjh]hconst struct page *page}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjubj)}(hhh]jM)}(hThe page to queryh]hThe page to query}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjubjM)}(hAThis returns true if **page** is one of the permanent zero pages.h](hThis returns true if }(hjhhhNhNubj)}(h**page**h]hpage}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh$ is one of the permanent zero pages.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](his_zero_folio (C function)c.is_zero_foliohNtauh1hhjKhhhNhNubh)}(hhh](h)}(h.bool is_zero_folio (const struct folio *folio)h]h)}(h-bool is_zero_folio(const struct folio *folio)h](j)}(hjh]hbool}(hj_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj[hhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM ubj)}(h h]h }(hjmhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj[hhhjlhM ubh)}(h is_zero_folioh]j)}(h is_zero_folioh]h is_zero_folio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj[hhhjlhM ubj8)}(h(const struct folio *folio)h]j>)}(hconst struct folio *folioh](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsbc.is_zero_folioasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hj[hhhjlhM ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjWhhhjlhM ubah}(h]jRah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjlhM hjThhubj4)}(hhh]jM)}(hQuery if a folio is a zero pageh]hQuery if a folio is a zero page}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hj6hhubah}(h]h ]h"]h$]h&]uh1j3hjThhhjlhM ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjQjHjQjIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``const struct folio *folio`` The folio to query **Description** This returns true if **folio** is one of the permanent zero pages.h](jM)}(h**Parameters**h]j)}(hj[h]h Parameters}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjYubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjUubj)}(hhh]j)}(h1``const struct folio *folio`` The folio to query h](j)}(h``const struct folio *folio``h]jS)}(hjzh]hconst struct folio *folio}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjxubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjtubj)}(hhh]jM)}(hThe folio to queryh]hThe folio to query}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjtubeh}(h]h ]h"]h$]h&]uh1jhjhM hjqubah}(h]h ]h"]h$]h&]uh1jhjUubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjUubjM)}(hBThis returns true if **folio** is one of the permanent zero pages.h](hThis returns true if }(hjhhhNhNubj)}(h **folio**h]hfolio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh$ is one of the permanent zero pages.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjUubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfolio_nr_pages (C function)c.folio_nr_pageshNtauh1hhjKhhhNhNubh)}(hhh](h)}(h8unsigned long folio_nr_pages (const struct folio *folio)h]h)}(h7unsigned long folio_nr_pages(const struct folio *folio)h](j)}(hunsignedh]hunsigned}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM ubj)}(hlongh]hlong}(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM ubj)}(h h]h }(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM ubh)}(hfolio_nr_pagesh]j)}(hfolio_nr_pagesh]hfolio_nr_pages}(hjIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhM ubj8)}(h(const struct folio *folio)h]j>)}(hconst struct folio *folioh](j)}(hjh]hconst}(hjehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubj)}(h h]h }(hjrhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubj)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubh)}(hhh]j)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjKsbc.folio_nr_pagesasbuh1hhjaubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjaubj)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj]ubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhM ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhM ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhM hjhhubj4)}(hhh]jM)}(h!The number of pages in the folio.h]h!The number of pages in the folio.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhM ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(h`**Parameters** ``const struct folio *folio`` The folio. **Return** A positive power of two.h](jM)}(h**Parameters**h]j)}(hj%h]h Parameters}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj#ubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjubj)}(hhh]j)}(h)``const struct folio *folio`` The folio. h](j)}(h``const struct folio *folio``h]jS)}(hjDh]hconst struct folio *folio}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjBubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hj>ubj)}(hhh]jM)}(h The folio.h]h The folio.}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjYhM hjZubah}(h]h ]h"]h$]h&]uh1jhj>ubeh}(h]h ]h"]h$]h&]uh1jhjYhM hj;ubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj}ubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjubjM)}(hA positive power of two.h]hA positive power of two.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfolio_next (C function) c.folio_nexthNtauh1hhjKhhhNhNubh)}(hhh](h)}(h/struct folio * folio_next (struct folio *folio)h]h)}(h-struct folio *folio_next(struct folio *folio)h](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM ubh)}(hhh]j)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}j folio_nextsb c.folio_nextasbuh1hhjhhhjhM ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM ubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjhhhjhM ubh)}(h folio_nexth]j)}(hjh]h folio_next}(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhM ubj8)}(h(struct folio *folio)h]j>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hj>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:ubj)}(h h]h }(hjKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:ubh)}(hhh]j)}(hfolioh]hfolio}(hj\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjYubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj^modnameN classnameNjj)}j]j c.folio_nextasbuh1hhj:ubj)}(h h]h }(hjzhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:ubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj:ubj)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj6ubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhM ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhM ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhM hjhhubj4)}(hhh]jM)}(h Move to the next physical folio.h]h Move to the next physical folio.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhM ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hXa**Parameters** ``struct folio *folio`` The folio we're currently operating on. **Description** If you have physically contiguous memory which may span more than one folio (eg a :c:type:`struct bio_vec `), use this function to move from one folio to the next. Do not use it if the memory is only virtually contiguous as the folios are almost certainly not adjacent to each other. This is the folio equivalent to writing ``page++``. **Context** We assume that the folios are refcounted and/or locked at a higher level and do not adjust the reference counts. **Return** The next struct folio.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjubj)}(hhh]j)}(h@``struct folio *folio`` The folio we're currently operating on. h](j)}(h``struct folio *folio``h]jS)}(hjh]hstruct folio *folio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjubj)}(hhh]jM)}(h'The folio we're currently operating on.h]h)The folio we’re currently operating on.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hj;h]h Description}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj9ubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjubjM)}(hXZIf you have physically contiguous memory which may span more than one folio (eg a :c:type:`struct bio_vec `), use this function to move from one folio to the next. Do not use it if the memory is only virtually contiguous as the folios are almost certainly not adjacent to each other. This is the folio equivalent to writing ``page++``.h](hRIf you have physically contiguous memory which may span more than one folio (eg a }(hjQhhhNhNubh)}(h":c:type:`struct bio_vec `h]jS)}(hj[h]hstruct bio_vec}(hj]hhhNhNubah}(h]h ](j%4jAc-typeeh"]h$]h&]uh1jRhjYubah}(h]h ]h"]h$]h&]refdocj14 refdomainjAreftypetype refexplicitrefwarnjj74j:4bio_vecuh1hhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjQubh), use this function to move from one folio to the next. Do not use it if the memory is only virtually contiguous as the folios are almost certainly not adjacent to each other. This is the folio equivalent to writing }(hjQhhhNhNubjS)}(h ``page++``h]hpage++}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjQubh.}(hjQhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhjxhM hjubjM)}(h **Context**h]j)}(hjh]hContext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjubjM)}(hpWe assume that the folios are refcounted and/or locked at a higher level and do not adjust the reference counts.h]hpWe assume that the folios are refcounted and/or locked at a higher level and do not adjust the reference counts.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjubjM)}(hThe next struct folio.h]hThe next struct folio.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfolio_shift (C function) c.folio_shifthNtauh1hhjKhhhNhNubh)}(hhh](h)}(h4unsigned int folio_shift (const struct folio *folio)h]h)}(h3unsigned int folio_shift(const struct folio *folio)h](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM ubj)}(hinth]hint}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM ubj)}(h h]h }(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM ubh)}(h folio_shifth]j)}(h folio_shifth]h folio_shift}(hj@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj<ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhM ubj8)}(h(const struct folio *folio)h]j>)}(hconst struct folio *folioh](j)}(hjh]hconst}(hj\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjXubj)}(h h]h }(hjihhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjXubj)}(hjJ,h]hstruct}(hjwhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjXubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjXubh)}(hhh]j)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjBsb c.folio_shiftasbuh1hhjXubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjXubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjXubj)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjXubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjTubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhM ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhM ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhM hjhhubj4)}(hhh]jM)}(h/The size of the memory described by this folio.h]h/The size of the memory described by this folio.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhM ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``const struct folio *folio`` The folio. **Description** A folio represents a number of bytes which is a power-of-two in size. This function tells you which power-of-two the folio is. See also folio_size() and folio_order(). **Context** The caller should have a reference on the folio to prevent it from being split. It is not necessary for the folio to be locked. **Return** The base-2 logarithm of the size of this folio.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjubj)}(hhh]j)}(h)``const struct folio *folio`` The folio. h](j)}(h``const struct folio *folio``h]jS)}(hj;h]hconst struct folio *folio}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj9ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hj5ubj)}(hhh]jM)}(h The folio.h]h The folio.}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjPhM hjQubah}(h]h ]h"]h$]h&]uh1jhj5ubeh}(h]h ]h"]h$]h&]uh1jhjPhM hj2ubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjvh]h Description}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjtubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjubjM)}(hA folio represents a number of bytes which is a power-of-two in size. This function tells you which power-of-two the folio is. See also folio_size() and folio_order().h]hA folio represents a number of bytes which is a power-of-two in size. This function tells you which power-of-two the folio is. See also folio_size() and folio_order().}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjubjM)}(h **Context**h]j)}(hjh]hContext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjubjM)}(hThe caller should have a reference on the folio to prevent it from being split. It is not necessary for the folio to be locked.h]hThe caller should have a reference on the folio to prevent it from being split. It is not necessary for the folio to be locked.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjubjM)}(h/The base-2 logarithm of the size of this folio.h]h/The base-2 logarithm of the size of this folio.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfolio_size (C function) c.folio_sizehNtauh1hhjKhhhNhNubh)}(hhh](h)}(h-size_t folio_size (const struct folio *folio)h]h)}(h,size_t folio_size(const struct folio *folio)h](h)}(hhh]j)}(hsize_th]hsize_t}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}j folio_sizesb c.folio_sizeasbuh1hhjhhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM ubj)}(h h]h }(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhj-hM ubh)}(h folio_sizeh]j)}(hj*h]h folio_size}(hj@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj<ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhj-hM ubj8)}(h(const struct folio *folio)h]j>)}(hconst struct folio *folioh](j)}(hjh]hconst}(hj[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjWubj)}(h h]h }(hjhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjWubj)}(hjJ,h]hstruct}(hjvhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjWubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjWubh)}(hhh]j)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j( c.folio_sizeasbuh1hhjWubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjWubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjWubj)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjWubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjSubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhj-hM ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhj-hM ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj-hM hjhhubj4)}(hhh]jM)}(hThe number of bytes in a folio.h]hThe number of bytes in a folio.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhj-hM ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``const struct folio *folio`` The folio. **Context** The caller should have a reference on the folio to prevent it from being split. It is not necessary for the folio to be locked. **Return** The number of bytes in this folio.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjubj)}(hhh]j)}(h)``const struct folio *folio`` The folio. h](j)}(h``const struct folio *folio``h]jS)}(hj8h]hconst struct folio *folio}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj6ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hj2ubj)}(hhh]jM)}(h The folio.h]h The folio.}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjMhM hjNubah}(h]h ]h"]h$]h&]uh1jhj2ubeh}(h]h ]h"]h$]h&]uh1jhjMhM hj/ubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h **Context**h]j)}(hjsh]hContext}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjqubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjubjM)}(hThe caller should have a reference on the folio to prevent it from being split. It is not necessary for the folio to be locked.h]hThe caller should have a reference on the folio to prevent it from being split. It is not necessary for the folio to be locked.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjubjM)}(h"The number of bytes in this folio.h]h"The number of bytes in this folio.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h&folio_maybe_mapped_shared (C function)c.folio_maybe_mapped_sharedhNtauh1hhjKhhhNhNubh)}(hhh](h)}(h4bool folio_maybe_mapped_shared (struct folio *folio)h]h)}(h3bool folio_maybe_mapped_shared(struct folio *folio)h](j)}(hjh]hbool}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM# ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM# ubh)}(hfolio_maybe_mapped_sharedh]j)}(hfolio_maybe_mapped_sharedh]hfolio_maybe_mapped_shared}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhM# ubj8)}(h(struct folio *folio)h]j>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj(hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hfolioh]hfolio}(hj9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj6ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj;modnameN classnameNjj)}j]j)}jjsbc.folio_maybe_mapped_sharedasbuh1hhjubj)}(h h]h }(hjYhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjghhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hfolioh]hfolio}(hjthhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhM# ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhM# ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhM# hjhhubj4)}(hhh]jM)}(hDWhether the folio is mapped into the page tables of more than one MMh]hDWhether the folio is mapped into the page tables of more than one MM}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM# hjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhM# ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hXd**Parameters** ``struct folio *folio`` The folio. **Description** This function checks if the folio maybe currently mapped into more than one MM ("maybe mapped shared"), or if the folio is certainly mapped into a single MM ("mapped exclusively"). For KSM folios, this function also returns "mapped shared" when a folio is mapped multiple times into the same MM, because the individual page mappings are independent. For small anonymous folios and anonymous hugetlb folios, the return value will be exactly correct: non-KSM folios can only be mapped at most once into an MM, and they cannot be partially mapped. KSM folios are considered shared even if mapped multiple times into the same MM. For other folios, the result can be fuzzy: #. For partially-mappable large folios (THP), the return value can wrongly indicate "mapped shared" (false positive) if a folio was mapped by more than two MMs at one point in time. #. For pagecache folios (including hugetlb), the return value can wrongly indicate "mapped shared" (false positive) when two VMAs in the same MM cover the same file range. Further, this function only considers current page table mappings that are tracked using the folio mapcount(s). This function does not consider: #. If the folio might get mapped in the (near) future (e.g., swapcache, pagecache, temporary unmapping for migration). #. If the folio is mapped differently (VM_PFNMAP). #. If hugetlb page table sharing applies. Callers might want to check hugetlb_pmd_shared(). **Return** Whether the folio is estimated to be mapped into more than one MM.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM' hjubj)}(hhh]j)}(h#``struct folio *folio`` The folio. h](j)}(h``struct folio *folio``h]jS)}(hjh]hstruct folio *folio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM% hjubj)}(hhh]jM)}(h The folio.h]h The folio.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM% hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM% hjubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM' hjubjM)}(hThis function checks if the folio maybe currently mapped into more than one MM ("maybe mapped shared"), or if the folio is certainly mapped into a single MM ("mapped exclusively").h]hThis function checks if the folio maybe currently mapped into more than one MM (“maybe mapped shared”), or if the folio is certainly mapped into a single MM (“mapped exclusively”).}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM& hjubjM)}(hFor KSM folios, this function also returns "mapped shared" when a folio is mapped multiple times into the same MM, because the individual page mappings are independent.h]hFor KSM folios, this function also returns “mapped shared” when a folio is mapped multiple times into the same MM, because the individual page mappings are independent.}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM* hjubjM)}(hXFor small anonymous folios and anonymous hugetlb folios, the return value will be exactly correct: non-KSM folios can only be mapped at most once into an MM, and they cannot be partially mapped. KSM folios are considered shared even if mapped multiple times into the same MM.h]hXFor small anonymous folios and anonymous hugetlb folios, the return value will be exactly correct: non-KSM folios can only be mapped at most once into an MM, and they cannot be partially mapped. KSM folios are considered shared even if mapped multiple times into the same MM.}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM. hjubj)}(hhh]j)}(hXFor other folios, the result can be fuzzy: #. For partially-mappable large folios (THP), the return value can wrongly indicate "mapped shared" (false positive) if a folio was mapped by more than two MMs at one point in time. #. For pagecache folios (including hugetlb), the return value can wrongly indicate "mapped shared" (false positive) when two VMAs in the same MM cover the same file range. h](j)}(h*For other folios, the result can be fuzzy:h]h*For other folios, the result can be fuzzy:}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM9 hj`ubj)}(hhh]jM)}(hhh](jc)}(hFor partially-mappable large folios (THP), the return value can wrongly indicate "mapped shared" (false positive) if a folio was mapped by more than two MMs at one point in time.h]jM)}(hFor partially-mappable large folios (THP), the return value can wrongly indicate "mapped shared" (false positive) if a folio was mapped by more than two MMs at one point in time.h]hFor partially-mappable large folios (THP), the return value can wrongly indicate “mapped shared” (false positive) if a folio was mapped by more than two MMs at one point in time.}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM4 hjyubah}(h]h ]h"]h$]h&]uh1jbhjvubjc)}(hFor pagecache folios (including hugetlb), the return value can wrongly indicate "mapped shared" (false positive) when two VMAs in the same MM cover the same file range. h]jM)}(hFor pagecache folios (including hugetlb), the return value can wrongly indicate "mapped shared" (false positive) when two VMAs in the same MM cover the same file range.h]hFor pagecache folios (including hugetlb), the return value can wrongly indicate “mapped shared” (false positive) when two VMAs in the same MM cover the same file range.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM7 hjubah}(h]h ]h"]h$]h&]uh1jbhjvubeh}(h]h ]h"]h$]h&]j?Nj@NjANhjBNjCNuh1jMhjsubah}(h]h ]h"]h$]h&]uh1jhj`ubeh}(h]h ]h"]h$]h&]uh1jhjrhM9 hj]ubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(hoFurther, this function only considers current page table mappings that are tracked using the folio mapcount(s).h]hoFurther, this function only considers current page table mappings that are tracked using the folio mapcount(s).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM; hjubj)}(hhh]j)}(hX-This function does not consider: #. If the folio might get mapped in the (near) future (e.g., swapcache, pagecache, temporary unmapping for migration). #. If the folio is mapped differently (VM_PFNMAP). #. If hugetlb page table sharing applies. Callers might want to check hugetlb_pmd_shared(). h](j)}(h This function does not consider:h]h This function does not consider:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMC hjubj)}(hhh]jM)}(hhh](jc)}(hsIf the folio might get mapped in the (near) future (e.g., swapcache, pagecache, temporary unmapping for migration).h]jM)}(hsIf the folio might get mapped in the (near) future (e.g., swapcache, pagecache, temporary unmapping for migration).h]hsIf the folio might get mapped in the (near) future (e.g., swapcache, pagecache, temporary unmapping for migration).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM? hjubah}(h]h ]h"]h$]h&]uh1jbhjubjc)}(h/If the folio is mapped differently (VM_PFNMAP).h]jM)}(hj h]h/If the folio is mapped differently (VM_PFNMAP).}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMA hjubah}(h]h ]h"]h$]h&]uh1jbhjubjc)}(hYIf hugetlb page table sharing applies. Callers might want to check hugetlb_pmd_shared(). h]jM)}(hXIf hugetlb page table sharing applies. Callers might want to check hugetlb_pmd_shared().h]hXIf hugetlb page table sharing applies. Callers might want to check hugetlb_pmd_shared().}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMB hjubah}(h]h ]h"]h$]h&]uh1jbhjubeh}(h]h ]h"]h$]h&]j?Nj@NjANhjBNjCNuh1jMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMC hjubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h **Return**h]j)}(hjRh]hReturn}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jhjPubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhME hjubjM)}(hBWhether the folio is estimated to be mapped into more than one MM.h]hBWhether the folio is estimated to be mapped into more than one MM.}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMF hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h%folio_expected_ref_count (C function)c.folio_expected_ref_counthNtauh1hhjKhhhNhNubh)}(hhh](h)}(h8int folio_expected_ref_count (const struct folio *folio)h]h)}(h7int folio_expected_ref_count(const struct folio *folio)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMc ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMc ubh)}(hfolio_expected_ref_counth]j)}(hfolio_expected_ref_counth]hfolio_expected_ref_count}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMc ubj8)}(h(const struct folio *folio)h]j>)}(hconst struct folio *folioh](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hfolioh]hfolio}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsbc.folio_expected_ref_countasbuh1hhjubj)}(h h]h }(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hj;hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hfolioh]hfolio}(hjHhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMc ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMc ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMc hjhhubj4)}(hhh]jM)}(h%calculate the expected folio refcounth]h%calculate the expected folio refcount}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMc hjohhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMc ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hX@**Parameters** ``const struct folio *folio`` the folio **Description** Calculate the expected folio refcount, taking references from the pagecache, swapcache, private data (folio->private != NULL) and page table mappings into account. Useful in combination with folio_ref_count() to detect unexpected references (e.g., GUP or other temporary references). Does currently not consider references from the LRU cache. If the folio was isolated from the LRU (which is the case during migration or split), the LRU cache does not apply. Calling this function on an unmapped folio -- !folio_mapped() -- that is locked will return a stable result. Calling this function on a mapped folio will not result in a stable result, because nothing stops additional page table mappings from coming (e.g., fork()) or going (e.g., munmap()). Calling this function without the folio lock will also not result in a stable result: for example, the folio might get dropped from the swapcache concurrently. However, even when called without the folio lock or on a mapped folio, this function can be used to detect unexpected references early (for example, if it makes sense to even lock the folio and unmap it). The caller must add any reference (e.g., from folio_try_get()) it might be holding itself to the result. **Return** the expected folio refcount.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMg hjubj)}(hhh]j)}(h(``const struct folio *folio`` the folio h](j)}(h``const struct folio *folio``h]jS)}(hjh]hconst struct folio *folio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMd hjubj)}(hhh]jM)}(h the folioh]h the folio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMd hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMd hjubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMf hjubjM)}(hXCalculate the expected folio refcount, taking references from the pagecache, swapcache, private data (folio->private != NULL) and page table mappings into account. Useful in combination with folio_ref_count() to detect unexpected references (e.g., GUP or other temporary references).h]hXCalculate the expected folio refcount, taking references from the pagecache, swapcache, private data (folio->private != NULL) and page table mappings into account. Useful in combination with folio_ref_count() to detect unexpected references (e.g., GUP or other temporary references).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMe hjubjM)}(hDoes currently not consider references from the LRU cache. If the folio was isolated from the LRU (which is the case during migration or split), the LRU cache does not apply.h]hDoes currently not consider references from the LRU cache. If the folio was isolated from the LRU (which is the case during migration or split), the LRU cache does not apply.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMj hjubjM)}(hlCalling this function on an unmapped folio -- !folio_mapped() -- that is locked will return a stable result.h]hlCalling this function on an unmapped folio -- !folio_mapped() -- that is locked will return a stable result.}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMn hjubjM)}(hCalling this function on a mapped folio will not result in a stable result, because nothing stops additional page table mappings from coming (e.g., fork()) or going (e.g., munmap()).h]hCalling this function on a mapped folio will not result in a stable result, because nothing stops additional page table mappings from coming (e.g., fork()) or going (e.g., munmap()).}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMq hjubjM)}(hCalling this function without the folio lock will also not result in a stable result: for example, the folio might get dropped from the swapcache concurrently.h]hCalling this function without the folio lock will also not result in a stable result: for example, the folio might get dropped from the swapcache concurrently.}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMu hjubjM)}(hHowever, even when called without the folio lock or on a mapped folio, this function can be used to detect unexpected references early (for example, if it makes sense to even lock the folio and unmap it).h]hHowever, even when called without the folio lock or on a mapped folio, this function can be used to detect unexpected references early (for example, if it makes sense to even lock the folio and unmap it).}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMy hjubjM)}(hhThe caller must add any reference (e.g., from folio_try_get()) it might be holding itself to the result.h]hhThe caller must add any reference (e.g., from folio_try_get()) it might be holding itself to the result.}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM} hjubjM)}(h **Return**h]j)}(hjoh]hReturn}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjmubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjubjM)}(hthe expected folio refcount.h]hthe expected folio refcount.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hzap_vma (C function) c.zap_vmahNtauh1hhjKhhhNhNubh)}(hhh](h)}(h)void zap_vma (struct vm_area_struct *vma)h]h)}(h(void zap_vma(struct vm_area_struct *vma)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM1 ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM1 ubh)}(hzap_vmah]j)}(hzap_vmah]hzap_vma}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhM1 ubj8)}(h(struct vm_area_struct *vma)h]j>)}(hstruct vm_area_struct *vmah](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hvm_area_structh]hvm_area_struct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsb c.zap_vmaasbuh1hhjubj)}(h h]h }(hj/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hj=hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hvmah]hvma}(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhM1 ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhM1 ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhM1 hjhhubj4)}(hhh]jM)}(h#zap all page table entries in a vmah]h#zap all page table entries in a vma}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM1 hjqhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhM1 ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(h@**Parameters** ``struct vm_area_struct *vma`` The vma to zap.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM5 hjubj)}(hhh]j)}(h.``struct vm_area_struct *vma`` The vma to zap.h](j)}(h``struct vm_area_struct *vma``h]jS)}(hjh]hstruct vm_area_struct *vma}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM7 hjubj)}(hhh]jM)}(hThe vma to zap.h]hThe vma to zap.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM2 hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM7 hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hptdesc_address (C function)c.ptdesc_addresshNtauh1hhjKhhhNhNubh)}(hhh](h)}(h/void * ptdesc_address (const struct ptdesc *pt)h]h)}(h-void *ptdesc_address(const struct ptdesc *pt)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM*ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhjhM*ubjr)}(hjuh]h*}(hj,hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj hhhjhM*ubh)}(hptdesc_addressh]j)}(hptdesc_addressh]hptdesc_address}(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj hhhjhM*ubj8)}(h(const struct ptdesc *pt)h]j>)}(hconst struct ptdesc *pth](j)}(hjh]hconst}(hjYhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjUubj)}(h h]h }(hjfhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjUubj)}(hjJ,h]hstruct}(hjthhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjUubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjUubh)}(hhh]j)}(hptdesch]hptdesc}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jj?sbc.ptdesc_addressasbuh1hhjUubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjUubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjUubj)}(hpth]hpt}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjUubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjQubah}(h]h ]h"]h$]h&]jjuh1j7hj hhhjhM*ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhM*ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhM*hjhhubj4)}(hhh]jM)}(hVirtual address of page table.h]hVirtual address of page table.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM*hjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhM*ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``const struct ptdesc *pt`` Page table descriptor. **Return** The first byte of the page table described by **pt**.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM.hjubj)}(hhh]j)}(h3``const struct ptdesc *pt`` Page table descriptor. h](j)}(h``const struct ptdesc *pt``h]jS)}(hj8h]hconst struct ptdesc *pt}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj6ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM+hj2ubj)}(hhh]jM)}(hPage table descriptor.h]hPage table descriptor.}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjMhM+hjNubah}(h]h ]h"]h$]h&]uh1jhj2ubeh}(h]h ]h"]h$]h&]uh1jhjMhM+hj/ubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h **Return**h]j)}(hjsh]hReturn}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjqubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM-hjubjM)}(h5The first byte of the page table described by **pt**.h](h.The first byte of the page table described by }(hjhhhNhNubj)}(h**pt**h]hpt}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM-hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hptdesc_set_kernel (C function)c.ptdesc_set_kernelhNtauh1hhjKhhhNhNubh)}(hhh](h)}(h.void ptdesc_set_kernel (struct ptdesc *ptdesc)h]h)}(h-void ptdesc_set_kernel(struct ptdesc *ptdesc)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM:ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM:ubh)}(hptdesc_set_kernelh]j)}(hptdesc_set_kernelh]hptdesc_set_kernel}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhM:ubj8)}(h(struct ptdesc *ptdesc)h]j>)}(hstruct ptdesc *ptdesch](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hptdesch]hptdesc}(hj%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj'modnameN classnameNjj)}j]j)}jjsbc.ptdesc_set_kernelasbuh1hhjubj)}(h h]h }(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjShhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hptdesch]hptdesc}(hj`hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhM:ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhM:ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhM:hjhhubj4)}(hhh]jM)}(h$Mark a ptdesc used to map the kernelh]h$Mark a ptdesc used to map the kernel}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM:hjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhM:ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``struct ptdesc *ptdesc`` The ptdesc to be marked **Description** Kernel page tables often need special handling. Set a flag so that the handling code knows this ptdesc will not be used for userspace.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM>hjubj)}(hhh]j)}(h2``struct ptdesc *ptdesc`` The ptdesc to be marked h](j)}(h``struct ptdesc *ptdesc``h]jS)}(hjh]hstruct ptdesc *ptdesc}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM;hjubj)}(hhh]jM)}(hThe ptdesc to be markedh]hThe ptdesc to be marked}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM;hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM;hjubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM=hjubjM)}(hKernel page tables often need special handling. Set a flag so that the handling code knows this ptdesc will not be used for userspace.h]hKernel page tables often need special handling. Set a flag so that the handling code knows this ptdesc will not be used for userspace.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM<hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h ptdesc_clear_kernel (C function)c.ptdesc_clear_kernelhNtauh1hhjKhhhNhNubh)}(hhh](h)}(h0void ptdesc_clear_kernel (struct ptdesc *ptdesc)h]h)}(h/void ptdesc_clear_kernel(struct ptdesc *ptdesc)h](j)}(hvoidh]hvoid}(hjKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGhhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMFubj)}(h h]h }(hjZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGhhhjYhMFubh)}(hptdesc_clear_kernelh]j)}(hptdesc_clear_kernelh]hptdesc_clear_kernel}(hjlhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhubah}(h]h ](jjeh"]h$]h&]jjuh1hhjGhhhjYhMFubj8)}(h(struct ptdesc *ptdesc)h]j>)}(hstruct ptdesc *ptdesch](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hptdesch]hptdesc}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjnsbc.ptdesc_clear_kernelasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hptdesch]hptdesc}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjGhhhjYhMFubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjChhhjYhMFubah}(h]j>ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjYhMFhj@hhubj4)}(hhh]jM)}(h1Mark a ptdesc as no longer used to map the kernelh]h1Mark a ptdesc as no longer used to map the kernel}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMFhjhhubah}(h]h ]h"]h$]h&]uh1j3hj@hhhjYhMFubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj#jHj#jIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``struct ptdesc *ptdesc`` The ptdesc to be unmarked **Description** Use when the ptdesc is no longer used to map the kernel and no longer needs special handling.h](jM)}(h**Parameters**h]j)}(hj-h]h Parameters}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj+ubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMJhj'ubj)}(hhh]j)}(h4``struct ptdesc *ptdesc`` The ptdesc to be unmarked h](j)}(h``struct ptdesc *ptdesc``h]jS)}(hjLh]hstruct ptdesc *ptdesc}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjJubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMGhjFubj)}(hhh]jM)}(hThe ptdesc to be unmarkedh]hThe ptdesc to be unmarked}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjahMGhjbubah}(h]h ]h"]h$]h&]uh1jhjFubeh}(h]h ]h"]h$]h&]uh1jhjahMGhjCubah}(h]h ]h"]h$]h&]uh1jhj'ubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMIhj'ubjM)}(h]Use when the ptdesc is no longer used to map the kernel and no longer needs special handling.h]h]Use when the ptdesc is no longer used to map the kernel and no longer needs special handling.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMHhj'ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hptdesc_test_kernel (C function)c.ptdesc_test_kernelhNtauh1hhjKhhhNhNubh)}(hhh](h)}(h5bool ptdesc_test_kernel (const struct ptdesc *ptdesc)h]h)}(h4bool ptdesc_test_kernel(const struct ptdesc *ptdesc)h](j)}(hjh]hbool}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMWubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMWubh)}(hptdesc_test_kernelh]j)}(hptdesc_test_kernelh]hptdesc_test_kernel}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMWubj8)}(h(const struct ptdesc *ptdesc)h]j>)}(hconst struct ptdesc *ptdesch](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjJ,h]hstruct}(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hptdesch]hptdesc}(hjAhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjCmodnameN classnameNjj)}j]j)}jjsbc.ptdesc_test_kernelasbuh1hhjubj)}(h h]h }(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjohhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hptdesch]hptdesc}(hj|hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMWubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMWubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMWhjhhubj4)}(hhh]jM)}(h+Check if a ptdesc is used to map the kernelh]h+Check if a ptdesc is used to map the kernel}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMWhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMWubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``const struct ptdesc *ptdesc`` The ptdesc being tested **Description** Call to tell if the ptdesc used to map the kernel.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM[hjubj)}(hhh]j)}(h8``const struct ptdesc *ptdesc`` The ptdesc being tested h](j)}(h``const struct ptdesc *ptdesc``h]jS)}(hjh]hconst struct ptdesc *ptdesc}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMXhjubj)}(hhh]jM)}(hThe ptdesc being testedh]hThe ptdesc being tested}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMXhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMXhjubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hj"h]h Description}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMZhjubjM)}(h2Call to tell if the ptdesc used to map the kernel.h]h2Call to tell if the ptdesc used to map the kernel.}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMYhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hpagetable_alloc (C function)c.pagetable_allochNtauh1hhjKhhhNhNubh)}(hhh](h)}(h?struct ptdesc * pagetable_alloc (gfp_t gfp, unsigned int order)h]h)}(h=struct ptdesc *pagetable_alloc(gfp_t gfp, unsigned int order)h](j)}(hjJ,h]hstruct}(hjghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjchhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMbubj)}(h h]h }(hjuhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjchhhjthMbubh)}(hhh]j)}(hptdesch]hptdesc}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jpagetable_allocsbc.pagetable_allocasbuh1hhjchhhjthMbubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjchhhjthMbubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjchhhjthMbubh)}(hpagetable_alloch]j)}(hjh]hpagetable_alloc}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjchhhjthMbubj8)}(h(gfp_t gfp, unsigned int order)h](j>)}(h gfp_t gfph](h)}(hhh]j)}(hgfp_th]hgfp_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.pagetable_allocasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hgfph]hgfp}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hunsigned int orderh](j)}(hunsignedh]hunsigned}(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%ubj)}(h h]h }(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%ubj)}(hinth]hint}(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%ubj)}(h h]h }(hjShhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%ubj)}(horderh]horder}(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjchhhjthMbubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj_hhhjthMbubah}(h]jZah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjthMbhj\hhubj4)}(hhh]jM)}(hAllocate pagetablesh]hAllocate pagetables}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMbhjhhubah}(h]h ]h"]h$]h&]uh1j3hj\hhhjthMbubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``gfp_t gfp`` GFP flags ``unsigned int order`` desired pagetable order **Description** pagetable_alloc allocates memory for page tables as well as a page table descriptor to describe that memory. **Return** The ptdesc describing the allocated page tables.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMfhjubj)}(hhh](j)}(h``gfp_t gfp`` GFP flags h](j)}(h ``gfp_t gfp``h]jS)}(hjh]h gfp_t gfp}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMchjubj)}(hhh]jM)}(h GFP flagsh]h GFP flags}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMchjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMchjubj)}(h/``unsigned int order`` desired pagetable order h](j)}(h``unsigned int order``h]jS)}(hjh]hunsigned int order}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMdhjubj)}(hhh]jM)}(hdesired pagetable orderh]hdesired pagetable order}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMdhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMdhjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hj@h]h Description}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj>ubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMfhjubjM)}(hlpagetable_alloc allocates memory for page tables as well as a page table descriptor to describe that memory.h]hlpagetable_alloc allocates memory for page tables as well as a page table descriptor to describe that memory.}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMehjubjM)}(h **Return**h]j)}(hjgh]hReturn}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1jhjeubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhhjubjM)}(h0The ptdesc describing the allocated page tables.h]h0The ptdesc describing the allocated page tables.}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMihjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hpagetable_free (C function)c.pagetable_freehNtauh1hhjKhhhNhNubh)}(hhh](h)}(h'void pagetable_free (struct ptdesc *pt)h]h)}(h&void pagetable_free(struct ptdesc *pt)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh)}(hpagetable_freeh]j)}(hpagetable_freeh]hpagetable_free}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMubj8)}(h(struct ptdesc *pt)h]j>)}(hstruct ptdesc *pth](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hptdesch]hptdesc}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj modnameN classnameNjj)}j]j)}jjsbc.pagetable_freeasbuh1hhjubj)}(h h]h }(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hj5hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hpth]hpt}(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]jM)}(hFree pagetablesh]hFree pagetables}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjihhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``struct ptdesc *pt`` The page table descriptor **Description** pagetable_free frees the memory of all page tables described by a page table descriptor and the memory for the descriptor itself.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjubj)}(hhh]j)}(h0``struct ptdesc *pt`` The page table descriptor h](j)}(h``struct ptdesc *pt``h]jS)}(hjh]hstruct ptdesc *pt}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjubj)}(hhh]jM)}(hThe page table descriptorh]hThe page table descriptor}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjubjM)}(hpagetable_free frees the memory of all page tables described by a page table descriptor and the memory for the descriptor itself.h]hpagetable_free frees the memory of all page tables described by a page table descriptor and the memory for the descriptor itself.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hvma_lookup (C function) c.vma_lookuphNtauh1hhjKhhhNhNubh)}(hhh](h)}(hMstruct vm_area_struct * vma_lookup (struct mm_struct *mm, unsigned long addr)h]h)}(hKstruct vm_area_struct *vma_lookup(struct mm_struct *mm, unsigned long addr)h](j)}(hjJ,h]hstruct}(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)hhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMubj)}(h h]h }(hj;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)hhhj:hMubh)}(hhh]j)}(hvm_area_structh]hvm_area_struct}(hjLhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjNmodnameN classnameNjj)}j]j)}j vma_lookupsb c.vma_lookupasbuh1hhj)hhhj:hMubj)}(h h]h }(hjmhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)hhhj:hMubjr)}(hjuh]h*}(hj{hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj)hhhj:hMubh)}(h vma_lookuph]j)}(hjjh]h vma_lookup}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhj)hhhj:hMubj8)}(h*(struct mm_struct *mm, unsigned long addr)h](j>)}(hstruct mm_struct *mmh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(h mm_structh]h mm_struct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jh c.vma_lookupasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hmmh]hmm}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hunsigned long addrh](j)}(hunsignedh]hunsigned}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h h]h }(hj% hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(hlongh]hlong}(hj3 hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h h]h }(hjA hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(haddrh]haddr}(hjO hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hj)hhhj:hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj%hhhj:hMubah}(h]j ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj:hMhj"hhubj4)}(hhh]jM)}(h Find a VMA at a specific addressh]h Find a VMA at a specific address}(hjy hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjv hhubah}(h]h ]h"]h$]h&]uh1j3hj"hhhj:hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj jHj jIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``struct mm_struct *mm`` The process address space. ``unsigned long addr`` The user address. **Return** The vm_area_struct at the given address, ``NULL`` otherwise.h](jM)}(h**Parameters**h]j)}(hj h]h Parameters}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhj ubj)}(hhh](j)}(h4``struct mm_struct *mm`` The process address space. h](j)}(h``struct mm_struct *mm``h]jS)}(hj h]hstruct mm_struct *mm}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhj ubj)}(hhh]jM)}(hThe process address space.h]hThe process address space.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj hMhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hMhj ubj)}(h)``unsigned long addr`` The user address. h](j)}(h``unsigned long addr``h]jS)}(hj h]hunsigned long addr}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhj ubj)}(hhh]jM)}(hThe user address.h]hThe user address.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj hMhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hMhj ubeh}(h]h ]h"]h$]h&]uh1jhj ubjM)}(h **Return**h]j)}(hj. h]hReturn}(hj0 hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj, ubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhj ubjM)}(h)}(h const struct vm_area_struct *vmah](j)}(hjh]hconst}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(hjJ,h]hstruct}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubh)}(hhh]j)}(hvm_area_structh]hvm_area_struct}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj modnameN classnameNjj)}j]j c.vma_start_pgoffasbuh1hhj ubj)}(h h]h }(hj. hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubjr)}(hjuh]h*}(hj< hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj ubj)}(hvmah]hvma}(hjI hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj ubah}(h]h ]h"]h$]h&]jjuh1j7hj hhhj hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj} hhhj hMubah}(h]jx ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj hMhjz hhubj4)}(hhh]jM)}(h+Get the page offset of the start of **vma**h](h$Get the page offset of the start of }(hjs hhhNhNubj)}(h**vma**h]hvma}(hj{ hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjs ubeh}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjp hhubah}(h]h ]h"]h$]h&]uh1j3hjz hhhj hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj jHj jIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``const struct vm_area_struct *vma`` The VMA whose page offset is required. **Description** If the VMA is file-backed, this is the page offset into the file. If **vma** is anonymous, this is the virtual page offset of the start of the VMA - if unfaulted, then vma->vm_start >> PAGE_SHIFT, if faulted then the virtual page offset at the time of first fault. If **vma** is a MAP_PRIVATE file-backed mapping, then this returns the page offset within the file. Edge cases: nommu does not abide by these and CoW MAP_PRIVATE-pfnmap regions have their page offset set to the first PFN in the range. **Return** The page offset of the start of **vma**.h](jM)}(h**Parameters**h]j)}(hj h]h Parameters}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhj ubj)}(hhh]j)}(hL``const struct vm_area_struct *vma`` The VMA whose page offset is required. h](j)}(h$``const struct vm_area_struct *vma``h]jS)}(hj h]h const struct vm_area_struct *vma}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhj ubj)}(hhh]jM)}(h&The VMA whose page offset is required.h]h&The VMA whose page offset is required.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj hMhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hMhj ubah}(h]h ]h"]h$]h&]uh1jhj ubjM)}(h**Description**h]j)}(hj h]h Description}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhj ubjM)}(hAIf the VMA is file-backed, this is the page offset into the file.h]hAIf the VMA is file-backed, this is the page offset into the file.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhj ubjM)}(hIf **vma** is anonymous, this is the virtual page offset of the start of the VMA - if unfaulted, then vma->vm_start >> PAGE_SHIFT, if faulted then the virtual page offset at the time of first fault.h](hIf }(hj" hhhNhNubj)}(h**vma**h]hvma}(hj* hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj" ubh is anonymous, this is the virtual page offset of the start of the VMA - if unfaulted, then vma->vm_start >> PAGE_SHIFT, if faulted then the virtual page offset at the time of first fault.}(hj" hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhj ubjM)}(hcIf **vma** is a MAP_PRIVATE file-backed mapping, then this returns the page offset within the file.h](hIf }(hjC hhhNhNubj)}(h**vma**h]hvma}(hjK hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjC ubhY is a MAP_PRIVATE file-backed mapping, then this returns the page offset within the file.}(hjC hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhj ubjM)}(hEdge cases: nommu does not abide by these and CoW MAP_PRIVATE-pfnmap regions have their page offset set to the first PFN in the range.h]hEdge cases: nommu does not abide by these and CoW MAP_PRIVATE-pfnmap regions have their page offset set to the first PFN in the range.}(hjd hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhj ubjM)}(h **Return**h]j)}(hju h]hReturn}(hjw hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjs ubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhj ubjM)}(h(The page offset of the start of **vma**.h](h The page offset of the start of }(hj hhhNhNubj)}(h**vma**h]hvma}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubh.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhj ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hvma_end_pgoff (C function)c.vma_end_pgoffhNtauh1hhjKhhhNhNubh)}(hhh](h)}(h8pgoff_t vma_end_pgoff (const struct vm_area_struct *vma)h]h)}(h7pgoff_t vma_end_pgoff(const struct vm_area_struct *vma)h](h)}(hhh]j)}(hpgoff_th]hpgoff_t}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj modnameN classnameNjj)}j]j)}j vma_end_pgoffsbc.vma_end_pgoffasbuh1hhj hhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhj hMubh)}(h vma_end_pgoffh]j)}(hj h]h vma_end_pgoff}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj hhhj hMubj8)}(h"(const struct vm_area_struct *vma)h]j>)}(h const struct vm_area_struct *vmah](j)}(hjh]hconst}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h h]h }(hj+ hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(hjJ,h]hstruct}(hj9 hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h h]h }(hjF hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubh)}(hhh]j)}(hvm_area_structh]hvm_area_struct}(hjW hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjT ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjY modnameN classnameNjj)}j]j c.vma_end_pgoffasbuh1hhj ubj)}(h h]h }(hju hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubjr)}(hjuh]h*}(hj hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj ubj)}(hvmah]hvma}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj ubah}(h]h ]h"]h$]h&]jjuh1j7hj hhhj hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj hhhj hMubah}(h]j ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj hMhj hhubj4)}(hhh]jM)}(h3Get the page offset of the exclusive end of **vma**h](h,Get the page offset of the exclusive end of }(hj hhhNhNubj)}(h**vma**h]hvma}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhj hhubah}(h]h ]h"]h$]h&]uh1j3hj hhhj hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj jHj jIjJjKuh1hhhhjKhNhNubj)}(hXe**Parameters** ``const struct vm_area_struct *vma`` The VMA whose end page offset is required. **Description** This returns the exclusive end page offset of **vma**, which is useful for expressing page offset ranges. See the description of vma_start_pgoff() for a description of VMA page offsets. **Return** The exclusive end page offset of **vma**.h](jM)}(h**Parameters**h]j)}(hj h]h Parameters}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhj ubj)}(hhh]j)}(hP``const struct vm_area_struct *vma`` The VMA whose end page offset is required. h](j)}(h$``const struct vm_area_struct *vma``h]jS)}(hj h]h const struct vm_area_struct *vma}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjubj)}(hhh]jM)}(h*The VMA whose end page offset is required.h]h*The VMA whose end page offset is required.}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubah}(h]h ]h"]h$]h&]uh1jhj ubjM)}(h**Description**h]j)}(hjDh]h Description}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjBubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhj ubjM)}(hiThis returns the exclusive end page offset of **vma**, which is useful for expressing page offset ranges.h](h.This returns the exclusive end page offset of }(hjZhhhNhNubj)}(h**vma**h]hvma}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjZubh4, which is useful for expressing page offset ranges.}(hjZhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhj ubjM)}(hOSee the description of vma_start_pgoff() for a description of VMA page offsets.h]hOSee the description of vma_start_pgoff() for a description of VMA page offsets.}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhj ubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhj ubjM)}(h)The exclusive end page offset of **vma**.h](h!The exclusive end page offset of }(hjhhhNhNubj)}(h**vma**h]hvma}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhj ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hvma_last_pgoff (C function)c.vma_last_pgoffhNtauh1hhjKhhhNhNubh)}(hhh](h)}(h9pgoff_t vma_last_pgoff (const struct vm_area_struct *vma)h]h)}(h8pgoff_t vma_last_pgoff(const struct vm_area_struct *vma)h](h)}(hhh]j)}(hpgoff_th]hpgoff_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jvma_last_pgoffsbc.vma_last_pgoffasbuh1hhjhhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh)}(hvma_last_pgoffh]j)}(hjh]hvma_last_pgoff}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMubj8)}(h"(const struct vm_area_struct *vma)h]j>)}(h const struct vm_area_struct *vmah](j)}(hjh]hconst}(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj1ubj)}(h h]h }(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj1ubj)}(hjJ,h]hstruct}(hjPhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj1ubj)}(h h]h }(hj]hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj1ubh)}(hhh]j)}(hvm_area_structh]hvm_area_struct}(hjnhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjkubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjpmodnameN classnameNjj)}j]jc.vma_last_pgoffasbuh1hhj1ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj1ubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj1ubj)}(hvmah]hvma}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj1ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj-ubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]jM)}(h/Get the page offset of the last page in **vma**h](h(Get the page offset of the last page in }(hjhhhNhNubj)}(h**vma**h]hvma}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hX/**Parameters** ``const struct vm_area_struct *vma`` The VMA whose last page offset is required. **Description** This returns the last page offset contained within **vma**. See the description of vma_start_pgoff() for a description of VMA page offsets. **Return** The last page offset of **vma**.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjubj)}(hhh]j)}(hQ``const struct vm_area_struct *vma`` The VMA whose last page offset is required. h](j)}(h$``const struct vm_area_struct *vma``h]jS)}(hj h]h const struct vm_area_struct *vma}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjubj)}(hhh]jM)}(h+The VMA whose last page offset is required.h]h+The VMA whose last page offset is required.}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj5hMhj6ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj5hMhjubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hj[h]h Description}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjYubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjubjM)}(h;This returns the last page offset contained within **vma**.h](h3This returns the last page offset contained within }(hjqhhhNhNubj)}(h**vma**h]hvma}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjqubh.}(hjqhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjubjM)}(hOSee the description of vma_start_pgoff() for a description of VMA page offsets.h]hOSee the description of vma_start_pgoff() for a description of VMA page offsets.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjubjM)}(h The last page offset of **vma**.h](hThe last page offset of }(hjhhhNhNubj)}(h**vma**h]hvma}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h!vma_start_anon_pgoff (C function)c.vma_start_anon_pgoffhNtauh1hhjKhhhNhNubh)}(hhh](h)}(h?pgoff_t vma_start_anon_pgoff (const struct vm_area_struct *vma)h]h)}(h>pgoff_t vma_start_anon_pgoff(const struct vm_area_struct *vma)h](h)}(hhh]j)}(hpgoff_th]hpgoff_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jvma_start_anon_pgoffsbc.vma_start_anon_pgoffasbuh1hhjhhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh)}(hvma_start_anon_pgoffh]j)}(hjh]hvma_start_anon_pgoff}(hj1hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMubj8)}(h"(const struct vm_area_struct *vma)h]j>)}(h const struct vm_area_struct *vmah](j)}(hjh]hconst}(hjLhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHubj)}(h h]h }(hjYhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHubj)}(hjJ,h]hstruct}(hjghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHubj)}(h h]h }(hjthhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHubh)}(hhh]j)}(hvm_area_structh]hvm_area_struct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.vma_start_anon_pgoffasbuh1hhjHubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjHubj)}(hvmah]hvma}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjDubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]jM)}(h5Get the anonymous page offset of the start of **vma**h](h.Get the anonymous page offset of the start of }(hjhhhNhNubj)}(h**vma**h]hvma}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``const struct vm_area_struct *vma`` The VMA whose anonymous page offset is required. **Description** If unfaulted, then this is vma->vm_start >> PAGE_SHIFT, if faulted then the anonymous page offset at the time of first fault. If the VMA is anonymous, this returns the same value as vma_start_pgoff(). This value is used for tracking MAP_PRIVATE file-backed mappings by their anonymous page offset. **Return** The anonymous page offset of the start of **vma**.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjubj)}(hhh]j)}(hV``const struct vm_area_struct *vma`` The VMA whose anonymous page offset is required. h](j)}(h$``const struct vm_area_struct *vma``h]jS)}(hj7h]h const struct vm_area_struct *vma}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj5ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhj1ubj)}(hhh]jM)}(h0The VMA whose anonymous page offset is required.h]h0The VMA whose anonymous page offset is required.}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjLhMhjMubah}(h]h ]h"]h$]h&]uh1jhj1ubeh}(h]h ]h"]h$]h&]uh1jhjLhMhj.ubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjrh]h Description}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jhjpubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjubjM)}(h}If unfaulted, then this is vma->vm_start >> PAGE_SHIFT, if faulted then the anonymous page offset at the time of first fault.h]h}If unfaulted, then this is vma->vm_start >> PAGE_SHIFT, if faulted then the anonymous page offset at the time of first fault.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjubjM)}(hJIf the VMA is anonymous, this returns the same value as vma_start_pgoff().h]hJIf the VMA is anonymous, this returns the same value as vma_start_pgoff().}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjubjM)}(h`This value is used for tracking MAP_PRIVATE file-backed mappings by their anonymous page offset.h]h`This value is used for tracking MAP_PRIVATE file-backed mappings by their anonymous page offset.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjubjM)}(h2The anonymous page offset of the start of **vma**.h](h*The anonymous page offset of the start of }(hjhhhNhNubj)}(h**vma**h]hvma}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hvma_end_anon_pgoff (C function)c.vma_end_anon_pgoffhNtauh1hhjKhhhNhNubh)}(hhh](h)}(h=pgoff_t vma_end_anon_pgoff (const struct vm_area_struct *vma)h]h)}(h)}(h const struct vm_area_struct *vmah](j)}(hjh]hconst}(hj`hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\ubj)}(h h]h }(hjmhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\ubj)}(hjJ,h]hstruct}(hj{hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\ubh)}(hhh]j)}(hvm_area_structh]hvm_area_struct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j-c.vma_end_anon_pgoffasbuh1hhj\ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\ubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj\ubj)}(hvmah]hvma}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjXubah}(h]h ]h"]h$]h&]jjuh1j7hj hhhj2hM ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhj2hM ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj2hM hjhhubj4)}(hhh]jM)}(h>Get the anonymous page offset of the exclusive end of **vma**.h](h6Get the anonymous page offset of the exclusive end of }(hjhhhNhNubj)}(h**vma**h]hvma}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhj2hM ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj&jHj&jIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``const struct vm_area_struct *vma`` The VMA whose end anonymous page offset is required. **Description** This returns the anonymous exclusive end page offset of **vma**, which is useful for expressing page offset ranges. See the description of vma_start_anon_pgoff() for a description of VMA anonymous page offsets. **Return** The exclusive end anonymous page offset of **vma**.h](jM)}(h**Parameters**h]j)}(hj0h]h Parameters}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj.ubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM$hj*ubj)}(hhh]j)}(hZ``const struct vm_area_struct *vma`` The VMA whose end anonymous page offset is required. h](j)}(h$``const struct vm_area_struct *vma``h]jS)}(hjOh]h const struct vm_area_struct *vma}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjMubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM"hjIubj)}(hhh]jM)}(h4The VMA whose end anonymous page offset is required.h]h4The VMA whose end anonymous page offset is required.}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjdhM"hjeubah}(h]h ]h"]h$]h&]uh1jhjIubeh}(h]h ]h"]h$]h&]uh1jhjdhM"hjFubah}(h]h ]h"]h$]h&]uh1jhj*ubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM$hj*ubjM)}(hsThis returns the anonymous exclusive end page offset of **vma**, which is useful for expressing page offset ranges.h](h8This returns the anonymous exclusive end page offset of }(hjhhhNhNubj)}(h**vma**h]hvma}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh4, which is useful for expressing page offset ranges.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM#hj*ubjM)}(h^See the description of vma_start_anon_pgoff() for a description of VMA anonymous page offsets.h]h^See the description of vma_start_anon_pgoff() for a description of VMA anonymous page offsets.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM&hj*ubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM)hj*ubjM)}(h3The exclusive end anonymous page offset of **vma**.h](h+The exclusive end anonymous page offset of }(hjhhhNhNubj)}(h**vma**h]hvma}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM*hj*ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h vma_last_anon_pgoff (C function)c.vma_last_anon_pgoffhNtauh1hhjKhhhNhNubh)}(hhh](h)}(h>pgoff_t vma_last_anon_pgoff (const struct vm_area_struct *vma)h]h)}(h=pgoff_t vma_last_anon_pgoff(const struct vm_area_struct *vma)h](h)}(hhh]j)}(hpgoff_th]hpgoff_t}(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj.modnameN classnameNjj)}j]j)}jvma_last_anon_pgoffsbc.vma_last_anon_pgoffasbuh1hhj%hhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM2ubj)}(h h]h }(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%hhhjMhM2ubh)}(hvma_last_anon_pgoffh]j)}(hjJh]hvma_last_anon_pgoff}(hj`hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj%hhhjMhM2ubj8)}(h"(const struct vm_area_struct *vma)h]j>)}(h const struct vm_area_struct *vmah](j)}(hjh]hconst}(hj{hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjwubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjwubj)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjwubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjwubh)}(hhh]j)}(hvm_area_structh]hvm_area_struct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jHc.vma_last_anon_pgoffasbuh1hhjwubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjwubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjwubj)}(hvmah]hvma}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjwubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjsubah}(h]h ]h"]h$]h&]jjuh1j7hj%hhhjMhM2ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj!hhhjMhM2ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjMhM2hjhhubj4)}(hhh]jM)}(h:Get the anonymous page offset of the last page in **vma**.h](h2Get the anonymous page offset of the last page in }(hjhhhNhNubj)}(h**vma**h]hvma}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM2hjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjMhM2ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjAjHjAjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``const struct vm_area_struct *vma`` The VMA whose last anonymous page offset is required. **Description** See the description of vma_start_anon_pgoff() for a description of VMA anonymous page offsets. **Return** The last anonymous page offset of **vma**.h](jM)}(h**Parameters**h]j)}(hjKh]h Parameters}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjIubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM6hjEubj)}(hhh]j)}(h[``const struct vm_area_struct *vma`` The VMA whose last anonymous page offset is required. h](j)}(h$``const struct vm_area_struct *vma``h]jS)}(hjjh]h const struct vm_area_struct *vma}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjhubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM4hjdubj)}(hhh]jM)}(h5The VMA whose last anonymous page offset is required.h]h5The VMA whose last anonymous page offset is required.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM4hjubah}(h]h ]h"]h$]h&]uh1jhjdubeh}(h]h ]h"]h$]h&]uh1jhjhM4hjaubah}(h]h ]h"]h$]h&]uh1jhjEubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM6hjEubjM)}(h^See the description of vma_start_anon_pgoff() for a description of VMA anonymous page offsets.h]h^See the description of vma_start_anon_pgoff() for a description of VMA anonymous page offsets.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM5hjEubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM8hjEubjM)}(h*The last anonymous page offset of **vma**.h](h"The last anonymous page offset of }(hjhhhNhNubj)}(h**vma**h]hvma}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM9hjEubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hmmap_action_remap (C function)c.mmap_action_remaphNtauh1hhjKhhhNhNubh)}(hhh](h)}(htvoid mmap_action_remap (struct vm_area_desc *desc, unsigned long start, unsigned long start_pfn, unsigned long size)h]h)}(hsvoid mmap_action_remap(struct vm_area_desc *desc, unsigned long start, unsigned long start_pfn, unsigned long size)h](j)}(hvoidh]hvoid}(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMKubj)}(h h]h }(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhj1hMKubh)}(hmmap_action_remaph]j)}(hmmap_action_remaph]hmmap_action_remap}(hjDhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhj1hMKubj8)}(h](struct vm_area_desc *desc, unsigned long start, unsigned long start_pfn, unsigned long size)h](j>)}(hstruct vm_area_desc *desch](j)}(hjJ,h]hstruct}(hj`hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\ubj)}(h h]h }(hjmhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\ubh)}(hhh]j)}(h vm_area_desch]h vm_area_desc}(hj~hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjFsbc.mmap_action_remapasbuh1hhj\ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\ubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj\ubj)}(hdesch]hdesc}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjXubj>)}(hunsigned long starth](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hstarth]hstart}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjXubj>)}(hunsigned long start_pfnh](j)}(hunsignedh]hunsigned}(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj1hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hlongh]hlong}(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjMhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h start_pfnh]h start_pfn}(hj[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjXubj>)}(hunsigned long sizeh](j)}(hunsignedh]hunsigned}(hjthhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpubj)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpubj)}(hsizeh]hsize}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjXubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhj1hMKubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhj1hMKubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj1hMKhjhhubj4)}(hhh]jM)}(hJhelper for mmap_prepare hook to specify that a pure PFN remap is required.h]hJhelper for mmap_prepare hook to specify that a pure PFN remap is required.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMKhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhj1hMKubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hXq**Parameters** ``struct vm_area_desc *desc`` The VMA descriptor for the VMA requiring remap. ``unsigned long start`` The virtual address to start the remap from, must be within the VMA. ``unsigned long start_pfn`` The first PFN in the range to remap. ``unsigned long size`` The size of the range to remap, in bytes, at most spanning to the end of the VMA.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMOhjubj)}(hhh](j)}(hN``struct vm_area_desc *desc`` The VMA descriptor for the VMA requiring remap. h](j)}(h``struct vm_area_desc *desc``h]jS)}(hjh]hstruct vm_area_desc *desc}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMMhjubj)}(hhh]jM)}(h/The VMA descriptor for the VMA requiring remap.h]h/The VMA descriptor for the VMA requiring remap.}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj,hMMhj-ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj,hMMhjubj)}(h]``unsigned long start`` The virtual address to start the remap from, must be within the VMA. h](j)}(h``unsigned long start``h]jS)}(hjPh]hunsigned long start}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjNubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMNhjJubj)}(hhh]jM)}(hDThe virtual address to start the remap from, must be within the VMA.h]hDThe virtual address to start the remap from, must be within the VMA.}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjehMNhjfubah}(h]h ]h"]h$]h&]uh1jhjJubeh}(h]h ]h"]h$]h&]uh1jhjehMNhjubj)}(hA``unsigned long start_pfn`` The first PFN in the range to remap. h](j)}(h``unsigned long start_pfn``h]jS)}(hjh]hunsigned long start_pfn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMOhjubj)}(hhh]jM)}(h$The first PFN in the range to remap.h]h$The first PFN in the range to remap.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMOhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMOhjubj)}(hh``unsigned long size`` The size of the range to remap, in bytes, at most spanning to the end of the VMA.h](j)}(h``unsigned long size``h]jS)}(hjh]hunsigned long size}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMPhjubj)}(hhh]jM)}(hQThe size of the range to remap, in bytes, at most spanning to the end of the VMA.h]hQThe size of the range to remap, in bytes, at most spanning to the end of the VMA.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMPhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMPhjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h#mmap_action_remap_full (C function)c.mmap_action_remap_fullhNtauh1hhjKhhhNhNubh)}(hhh](h)}(hPvoid mmap_action_remap_full (struct vm_area_desc *desc, unsigned long start_pfn)h]h)}(hOvoid mmap_action_remap_full(struct vm_area_desc *desc, unsigned long start_pfn)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMfubj)}(h h]h }(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhj)hMfubh)}(hmmap_action_remap_fullh]j)}(hmmap_action_remap_fullh]hmmap_action_remap_full}(hj<hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj8ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhj)hMfubj8)}(h4(struct vm_area_desc *desc, unsigned long start_pfn)h](j>)}(hstruct vm_area_desc *desch](j)}(hjJ,h]hstruct}(hjXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjTubj)}(h h]h }(hjehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjTubh)}(hhh]j)}(h vm_area_desch]h vm_area_desc}(hjvhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjsubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjxmodnameN classnameNjj)}j]j)}jj>sbc.mmap_action_remap_fullasbuh1hhjTubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjTubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjTubj)}(hdesch]hdesc}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjTubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjPubj>)}(hunsigned long start_pfnh](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h start_pfnh]h start_pfn}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjPubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhj)hMfubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhj)hMfubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj)hMfhjhhubj4)}(hhh]jM)}(hZhelper for mmap_prepare hook to specify that the entirety of a VMA should be PFN remapped.h]hZhelper for mmap_prepare hook to specify that the entirety of a VMA should be PFN remapped.}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMfhj)hhubah}(h]h ]h"]h$]h&]uh1j3hjhhhj)hMfubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjDjHjDjIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``struct vm_area_desc *desc`` The VMA descriptor for the VMA requiring remap. ``unsigned long start_pfn`` The first PFN in the range to remap.h](jM)}(h**Parameters**h]j)}(hjNh]h Parameters}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjLubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMjhjHubj)}(hhh](j)}(hN``struct vm_area_desc *desc`` The VMA descriptor for the VMA requiring remap. h](j)}(h``struct vm_area_desc *desc``h]jS)}(hjmh]hstruct vm_area_desc *desc}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjkubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhhjgubj)}(hhh]jM)}(h/The VMA descriptor for the VMA requiring remap.h]h/The VMA descriptor for the VMA requiring remap.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhhjubah}(h]h ]h"]h$]h&]uh1jhjgubeh}(h]h ]h"]h$]h&]uh1jhjhMhhjdubj)}(h@``unsigned long start_pfn`` The first PFN in the range to remap.h](j)}(h``unsigned long start_pfn``h]jS)}(hjh]hunsigned long start_pfn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMjhjubj)}(hhh]jM)}(h$The first PFN in the range to remap.h]h$The first PFN in the range to remap.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMihjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMjhjdubeh}(h]h ]h"]h$]h&]uh1jhjHubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h mmap_action_ioremap (C function)c.mmap_action_ioremaphNtauh1hhjKhhhNhNubh)}(hhh](h)}(hvvoid mmap_action_ioremap (struct vm_area_desc *desc, unsigned long start, unsigned long start_pfn, unsigned long size)h]h)}(huvoid mmap_action_ioremap(struct vm_area_desc *desc, unsigned long start, unsigned long start_pfn, unsigned long size)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMrubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMrubh)}(hmmap_action_ioremaph]j)}(hmmap_action_ioremaph]hmmap_action_ioremap}(hj!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMrubj8)}(h](struct vm_area_desc *desc, unsigned long start, unsigned long start_pfn, unsigned long size)h](j>)}(hstruct vm_area_desc *desch](j)}(hjJ,h]hstruct}(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9ubj)}(h h]h }(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9ubh)}(hhh]j)}(h vm_area_desch]h vm_area_desc}(hj[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjXubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj]modnameN classnameNjj)}j]j)}jj#sbc.mmap_action_ioremapasbuh1hhj9ubj)}(h h]h }(hj{hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9ubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj9ubj)}(hdesch]hdesc}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj5ubj>)}(hunsigned long starth](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hstarth]hstart}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj5ubj>)}(hunsigned long start_pfnh](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h start_pfnh]h start_pfn}(hj8hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj5ubj>)}(hunsigned long sizeh](j)}(hunsignedh]hunsigned}(hjQhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjMubj)}(h h]h }(hj_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjMubj)}(hlongh]hlong}(hjmhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjMubj)}(h h]h }(hj{hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjMubj)}(hsizeh]hsize}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjMubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj5ubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMrubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMrubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMrhjhhubj4)}(hhh]jM)}(hNhelper for mmap_prepare hook to specify that a pure PFN I/O remap is required.h]hNhelper for mmap_prepare hook to specify that a pure PFN I/O remap is required.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMrhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMrubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hXq**Parameters** ``struct vm_area_desc *desc`` The VMA descriptor for the VMA requiring remap. ``unsigned long start`` The virtual address to start the remap from, must be within the VMA. ``unsigned long start_pfn`` The first PFN in the range to remap. ``unsigned long size`` The size of the range to remap, in bytes, at most spanning to the end of the VMA.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMvhjubj)}(hhh](j)}(hN``struct vm_area_desc *desc`` The VMA descriptor for the VMA requiring remap. h](j)}(h``struct vm_area_desc *desc``h]jS)}(hjh]hstruct vm_area_desc *desc}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMthjubj)}(hhh]jM)}(h/The VMA descriptor for the VMA requiring remap.h]h/The VMA descriptor for the VMA requiring remap.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj hMthj ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj hMthjubj)}(h]``unsigned long start`` The virtual address to start the remap from, must be within the VMA. h](j)}(h``unsigned long start``h]jS)}(hj-h]hunsigned long start}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj+ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMuhj'ubj)}(hhh]jM)}(hDThe virtual address to start the remap from, must be within the VMA.h]hDThe virtual address to start the remap from, must be within the VMA.}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjBhMuhjCubah}(h]h ]h"]h$]h&]uh1jhj'ubeh}(h]h ]h"]h$]h&]uh1jhjBhMuhjubj)}(hA``unsigned long start_pfn`` The first PFN in the range to remap. h](j)}(h``unsigned long start_pfn``h]jS)}(hjfh]hunsigned long start_pfn}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjdubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMvhj`ubj)}(hhh]jM)}(h$The first PFN in the range to remap.h]h$The first PFN in the range to remap.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj{hMvhj|ubah}(h]h ]h"]h$]h&]uh1jhj`ubeh}(h]h ]h"]h$]h&]uh1jhj{hMvhjubj)}(hh``unsigned long size`` The size of the range to remap, in bytes, at most spanning to the end of the VMA.h](j)}(h``unsigned long size``h]jS)}(hjh]hunsigned long size}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMwhjubj)}(hhh]jM)}(hQThe size of the range to remap, in bytes, at most spanning to the end of the VMA.h]hQThe size of the range to remap, in bytes, at most spanning to the end of the VMA.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMwhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMwhjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h%mmap_action_ioremap_full (C function)c.mmap_action_ioremap_fullhNtauh1hhjKhhhNhNubh)}(hhh](h)}(hRvoid mmap_action_ioremap_full (struct vm_area_desc *desc, unsigned long start_pfn)h]h)}(hQvoid mmap_action_ioremap_full(struct vm_area_desc *desc, unsigned long start_pfn)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh)}(hmmap_action_ioremap_fullh]j)}(hmmap_action_ioremap_fullh]hmmap_action_ioremap_full}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMubj8)}(h4(struct vm_area_desc *desc, unsigned long start_pfn)h](j>)}(hstruct vm_area_desc *desch](j)}(hjJ,h]hstruct}(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj1ubj)}(h h]h }(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj1ubh)}(hhh]j)}(h vm_area_desch]h vm_area_desc}(hjShhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjPubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjUmodnameN classnameNjj)}j]j)}jjsbc.mmap_action_ioremap_fullasbuh1hhj1ubj)}(h h]h }(hjshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj1ubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj1ubj)}(hdesch]hdesc}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj1ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj-ubj>)}(hunsigned long start_pfnh](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h start_pfnh]h start_pfn}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj-ubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]jM)}(h^helper for mmap_prepare hook to specify that the entirety of a VMA should be PFN I/O remapped.h]h^helper for mmap_prepare hook to specify that the entirety of a VMA should be PFN I/O remapped.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhj hhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj! jHj! jIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``struct vm_area_desc *desc`` The VMA descriptor for the VMA requiring remap. ``unsigned long start_pfn`` The first PFN in the range to remap.h](jM)}(h**Parameters**h]j)}(hj+ h]h Parameters}(hj- hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj) ubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhj% ubj)}(hhh](j)}(hN``struct vm_area_desc *desc`` The VMA descriptor for the VMA requiring remap. h](j)}(h``struct vm_area_desc *desc``h]jS)}(hjJ h]hstruct vm_area_desc *desc}(hjL hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjH ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjD ubj)}(hhh]jM)}(h/The VMA descriptor for the VMA requiring remap.h]h/The VMA descriptor for the VMA requiring remap.}(hjc hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj_ hMhj` ubah}(h]h ]h"]h$]h&]uh1jhjD ubeh}(h]h ]h"]h$]h&]uh1jhj_ hMhjA ubj)}(h@``unsigned long start_pfn`` The first PFN in the range to remap.h](j)}(h``unsigned long start_pfn``h]jS)}(hj h]hunsigned long start_pfn}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhj} ubj)}(hhh]jM)}(h$The first PFN in the range to remap.h]h$The first PFN in the range to remap.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhj ubah}(h]h ]h"]h$]h&]uh1jhj} ubeh}(h]h ]h"]h$]h&]uh1jhj hMhjA ubeh}(h]h ]h"]h$]h&]uh1jhj% ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h'mmap_action_simple_ioremap (C function)c.mmap_action_simple_ioremaphNtauh1hhjKhhhNhNubh)}(hhh](h)}(hlvoid mmap_action_simple_ioremap (struct vm_area_desc *desc, phys_addr_t start_phys_addr, unsigned long size)h]h)}(hkvoid mmap_action_simple_ioremap(struct vm_area_desc *desc, phys_addr_t start_phys_addr, unsigned long size)h](j)}(hvoidh]hvoid}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhj hMubh)}(hmmap_action_simple_ioremaph]j)}(hmmap_action_simple_ioremaph]hmmap_action_simple_ioremap}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj hhhj hMubj8)}(hL(struct vm_area_desc *desc, phys_addr_t start_phys_addr, unsigned long size)h](j>)}(hstruct vm_area_desc *desch](j)}(hjJ,h]hstruct}(hj!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubj)}(h h]h }(hj'!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubh)}(hhh]j)}(h vm_area_desch]h vm_area_desc}(hj8!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5!ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj:!modnameN classnameNjj)}j]j)}jj!sbc.mmap_action_simple_ioremapasbuh1hhj!ubj)}(h h]h }(hjX!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubjr)}(hjuh]h*}(hjf!hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj!ubj)}(hdesch]hdesc}(hjs!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj!ubj>)}(hphys_addr_t start_phys_addrh](h)}(hhh]j)}(h phys_addr_th]h phys_addr_t}(hj!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj!modnameN classnameNjj)}j]jT!c.mmap_action_simple_ioremapasbuh1hhj!ubj)}(h h]h }(hj!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubj)}(hstart_phys_addrh]hstart_phys_addr}(hj!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj!ubj>)}(hunsigned long sizeh](j)}(hunsignedh]hunsigned}(hj!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubj)}(h h]h }(hj!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubj)}(hlongh]hlong}(hj!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubj)}(h h]h }(hj!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubj)}(hsizeh]hsize}(hj "hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj!ubeh}(h]h ]h"]h$]h&]jjuh1j7hj hhhj hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj hhhj hMubah}(h]j ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj hMhj hhubj4)}(hhh]jM)}(hhelper for mmap_prepare hook to specify that the physical range in [start_phys_addr, start_phys_addr + size) should be I/O remapped.h]hhelper for mmap_prepare hook to specify that the physical range in [start_phys_addr, start_phys_addr + size) should be I/O remapped.}(hj6"hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhj3"hhubah}(h]h ]h"]h$]h&]uh1j3hj hhhj hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjN"jHjN"jIjJjKuh1hhhhjKhNhNubj)}(hXF**Parameters** ``struct vm_area_desc *desc`` The VMA descriptor for the VMA requiring remap. ``phys_addr_t start_phys_addr`` Start of the physical memory to be mapped. ``unsigned long size`` Size of the area to map. **NOTE** Some drivers might want to tweak desc->page_prot for purposes of write-combine or similar.h](jM)}(h**Parameters**h]j)}(hjX"h]h Parameters}(hjZ"hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjV"ubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjR"ubj)}(hhh](j)}(hN``struct vm_area_desc *desc`` The VMA descriptor for the VMA requiring remap. h](j)}(h``struct vm_area_desc *desc``h]jS)}(hjw"h]hstruct vm_area_desc *desc}(hjy"hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhju"ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjq"ubj)}(hhh]jM)}(h/The VMA descriptor for the VMA requiring remap.h]h/The VMA descriptor for the VMA requiring remap.}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj"hMhj"ubah}(h]h ]h"]h$]h&]uh1jhjq"ubeh}(h]h ]h"]h$]h&]uh1jhj"hMhjn"ubj)}(hK``phys_addr_t start_phys_addr`` Start of the physical memory to be mapped. h](j)}(h``phys_addr_t start_phys_addr``h]jS)}(hj"h]hphys_addr_t start_phys_addr}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj"ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhj"ubj)}(hhh]jM)}(h*Start of the physical memory to be mapped.h]h*Start of the physical memory to be mapped.}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj"hMhj"ubah}(h]h ]h"]h$]h&]uh1jhj"ubeh}(h]h ]h"]h$]h&]uh1jhj"hMhjn"ubj)}(h0``unsigned long size`` Size of the area to map. h](j)}(h``unsigned long size``h]jS)}(hj"h]hunsigned long size}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj"ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhj"ubj)}(hhh]jM)}(hSize of the area to map.h]hSize of the area to map.}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj"hMhj"ubah}(h]h ]h"]h$]h&]uh1jhj"ubeh}(h]h ]h"]h$]h&]uh1jhj"hMhjn"ubeh}(h]h ]h"]h$]h&]uh1jhjR"ubjM)}(h**NOTE**h]j)}(hj$#h]hNOTE}(hj&#hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj"#ubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjR"ubjM)}(hZSome drivers might want to tweak desc->page_prot for purposes of write-combine or similar.h]hZSome drivers might want to tweak desc->page_prot for purposes of write-combine or similar.}(hj:#hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjR"ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h)mmap_action_map_kernel_pages (C function)c.mmap_action_map_kernel_pageshNtauh1hhjKhhhNhNubh)}(hhh](h)}(hvoid mmap_action_map_kernel_pages (struct vm_area_desc *desc, unsigned long start, struct page **pages, unsigned long nr_pages)h]h)}(h~void mmap_action_map_kernel_pages(struct vm_area_desc *desc, unsigned long start, struct page **pages, unsigned long nr_pages)h](j)}(hvoidh]hvoid}(hji#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhje#hhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMubj)}(h h]h }(hjx#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhje#hhhjw#hMubh)}(hmmap_action_map_kernel_pagesh]j)}(hmmap_action_map_kernel_pagesh]hmmap_action_map_kernel_pages}(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#ubah}(h]h ](jjeh"]h$]h&]jjuh1hhje#hhhjw#hMubj8)}(h](struct vm_area_desc *desc, unsigned long start, struct page **pages, unsigned long nr_pages)h](j>)}(hstruct vm_area_desc *desch](j)}(hjJ,h]hstruct}(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#ubj)}(h h]h }(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#ubh)}(hhh]j)}(h vm_area_desch]h vm_area_desc}(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj#modnameN classnameNjj)}j]j)}jj#sbc.mmap_action_map_kernel_pagesasbuh1hhj#ubj)}(h h]h }(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#ubjr)}(hjuh]h*}(hj#hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj#ubj)}(hdesch]hdesc}(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj#ubj>)}(hunsigned long starth](j)}(hunsignedh]hunsigned}(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$ubj)}(h h]h }(hj&$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$ubj)}(hlongh]hlong}(hj4$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$ubj)}(h h]h }(hjB$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$ubj)}(hstarth]hstart}(hjP$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj#ubj>)}(hstruct page **pagesh](j)}(hjJ,h]hstruct}(hji$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhje$ubj)}(h h]h }(hjv$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhje$ubh)}(hhh]j)}(hpageh]hpage}(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj$modnameN classnameNjj)}j]j#c.mmap_action_map_kernel_pagesasbuh1hhje$ubj)}(h h]h }(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhje$ubjr)}(hjuh]h*}(hj$hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhje$ubjr)}(hjuh]h*}(hj$hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhje$ubj)}(hpagesh]hpages}(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhje$ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj#ubj>)}(hunsigned long nr_pagesh](j)}(hunsignedh]hunsigned}(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$ubj)}(h h]h }(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$ubj)}(hlongh]hlong}(hj%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$ubj)}(h h]h }(hj%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$ubj)}(hnr_pagesh]hnr_pages}(hj%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj#ubeh}(h]h ]h"]h$]h&]jjuh1j7hje#hhhjw#hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hja#hhhjw#hMubah}(h]j\#ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjw#hMhj^#hhubj4)}(hhh]jM)}(hhelper for mmap_prepare hook to specify that **num** kernel pages contained in the **pages** array should be mapped to userland starting at virtual address **start**.h](h-helper for mmap_prepare hook to specify that }(hjH%hhhNhNubj)}(h**num**h]hnum}(hjP%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjH%ubh kernel pages contained in the }(hjH%hhhNhNubj)}(h **pages**h]hpages}(hjb%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjH%ubh@ array should be mapped to userland starting at virtual address }(hjH%hhhNhNubj)}(h **start**h]hstart}(hjt%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjH%ubh.}(hjH%hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjE%hhubah}(h]h ]h"]h$]h&]uh1j3hj^#hhhjw#hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj%jHj%jIjJjKuh1hhhhjKhNhNubj)}(hX_**Parameters** ``struct vm_area_desc *desc`` The VMA descriptor for the VMA requiring kernel pags to be mapped. ``unsigned long start`` The virtual address from which to map them. ``struct page **pages`` An array of struct page pointers describing the memory to map. ``unsigned long nr_pages`` The number of entries in the **pages** array.h](jM)}(h**Parameters**h]j)}(hj%h]h Parameters}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj%ubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhj%ubj)}(hhh](j)}(ha``struct vm_area_desc *desc`` The VMA descriptor for the VMA requiring kernel pags to be mapped. h](j)}(h``struct vm_area_desc *desc``h]jS)}(hj%h]hstruct vm_area_desc *desc}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj%ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhj%ubj)}(hhh]jM)}(hBThe VMA descriptor for the VMA requiring kernel pags to be mapped.h]hBThe VMA descriptor for the VMA requiring kernel pags to be mapped.}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj%hMhj%ubah}(h]h ]h"]h$]h&]uh1jhj%ubeh}(h]h ]h"]h$]h&]uh1jhj%hMhj%ubj)}(hD``unsigned long start`` The virtual address from which to map them. h](j)}(h``unsigned long start``h]jS)}(hj%h]hunsigned long start}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj%ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhj%ubj)}(hhh]jM)}(h+The virtual address from which to map them.h]h+The virtual address from which to map them.}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj &hMhj&ubah}(h]h ]h"]h$]h&]uh1jhj%ubeh}(h]h ]h"]h$]h&]uh1jhj &hMhj%ubj)}(hW``struct page **pages`` An array of struct page pointers describing the memory to map. h](j)}(h``struct page **pages``h]jS)}(hj1&h]hstruct page **pages}(hj3&hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj/&ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhj+&ubj)}(hhh]jM)}(h>An array of struct page pointers describing the memory to map.h]h>An array of struct page pointers describing the memory to map.}(hjJ&hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjF&hMhjG&ubah}(h]h ]h"]h$]h&]uh1jhj+&ubeh}(h]h ]h"]h$]h&]uh1jhjF&hMhj%ubj)}(hH``unsigned long nr_pages`` The number of entries in the **pages** array.h](j)}(h``unsigned long nr_pages``h]jS)}(hjj&h]hunsigned long nr_pages}(hjl&hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjh&ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjd&ubj)}(hhh]jM)}(h-The number of entries in the **pages** array.h](hThe number of entries in the }(hj&hhhNhNubj)}(h **pages**h]hpages}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj&ubh array.}(hj&hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhj&ubah}(h]h ]h"]h$]h&]uh1jhjd&ubeh}(h]h ]h"]h$]h&]uh1jhj&hMhj%ubeh}(h]h ]h"]h$]h&]uh1jhj%ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h.mmap_action_map_kernel_pages_full (C function)#c.mmap_action_map_kernel_pages_fullhNtauh1hhjKhhhNhNubh)}(hhh](h)}(hWvoid mmap_action_map_kernel_pages_full (struct vm_area_desc *desc, struct page **pages)h]h)}(hVvoid mmap_action_map_kernel_pages_full(struct vm_area_desc *desc, struct page **pages)h](j)}(hvoidh]hvoid}(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&hhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMubj)}(h h]h }(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&hhhj&hMubh)}(h!mmap_action_map_kernel_pages_fullh]j)}(h!mmap_action_map_kernel_pages_fullh]h!mmap_action_map_kernel_pages_full}(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj&hhhj&hMubj8)}(h0(struct vm_area_desc *desc, struct page **pages)h](j>)}(hstruct vm_area_desc *desch](j)}(hjJ,h]hstruct}(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj'ubj)}(h h]h }(hj 'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj'ubh)}(hhh]j)}(h vm_area_desch]h vm_area_desc}(hj1'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj.'ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj3'modnameN classnameNjj)}j]j)}jj&sb#c.mmap_action_map_kernel_pages_fullasbuh1hhj'ubj)}(h h]h }(hjQ'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj'ubjr)}(hjuh]h*}(hj_'hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj'ubj)}(hdesch]hdesc}(hjl'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj'ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj 'ubj>)}(hstruct page **pagesh](j)}(hjJ,h]hstruct}(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj'ubj)}(h h]h }(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj'ubh)}(hhh]j)}(hpageh]hpage}(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj'ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj'modnameN classnameNjj)}j]jM'#c.mmap_action_map_kernel_pages_fullasbuh1hhj'ubj)}(h h]h }(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj'ubjr)}(hjuh]h*}(hj'hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj'ubjr)}(hjuh]h*}(hj'hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj'ubj)}(hpagesh]hpages}(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj'ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj 'ubeh}(h]h ]h"]h$]h&]jjuh1j7hj&hhhj&hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj&hhhj&hMubah}(h]j&ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj&hMhj&hhubj4)}(hhh]jM)}(hhelper for mmap_prepare hook to specify that kernel pages contained in the **pages** array should be mapped to userland from **desc->start** to **desc->end**.h](hKhelper for mmap_prepare hook to specify that kernel pages contained in the }(hj(hhhNhNubj)}(h **pages**h]hpages}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj(ubh) array should be mapped to userland from }(hj(hhhNhNubj)}(h**desc->start**h]h desc->start}(hj-(hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj(ubh to }(hj(hhhNhNubj)}(h **desc->end**h]h desc->end}(hj?(hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj(ubh.}(hj(hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhj(hhubah}(h]h ]h"]h$]h&]uh1j3hj&hhhj&hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGja(jHja(jIjJjKuh1hhhhjKhNhNubj)}(hXQ**Parameters** ``struct vm_area_desc *desc`` The VMA descriptor for the VMA requiring kernel pags to be mapped. ``struct page **pages`` An array of struct page pointers describing the memory to map. **Description** The caller must ensure that **pages** contains sufficient entries to cover the entire range described by **desc**.h](jM)}(h**Parameters**h]j)}(hjk(h]h Parameters}(hjm(hhhNhNubah}(h]h ]h"]h$]h&]uh1jhji(ubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhje(ubj)}(hhh](j)}(ha``struct vm_area_desc *desc`` The VMA descriptor for the VMA requiring kernel pags to be mapped. h](j)}(h``struct vm_area_desc *desc``h]jS)}(hj(h]hstruct vm_area_desc *desc}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj(ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhj(ubj)}(hhh]jM)}(hBThe VMA descriptor for the VMA requiring kernel pags to be mapped.h]hBThe VMA descriptor for the VMA requiring kernel pags to be mapped.}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj(hMhj(ubah}(h]h ]h"]h$]h&]uh1jhj(ubeh}(h]h ]h"]h$]h&]uh1jhj(hMhj(ubj)}(hW``struct page **pages`` An array of struct page pointers describing the memory to map. h](j)}(h``struct page **pages``h]jS)}(hj(h]hstruct page **pages}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj(ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhj(ubj)}(hhh]jM)}(h>An array of struct page pointers describing the memory to map.h]h>An array of struct page pointers describing the memory to map.}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj(hMhj(ubah}(h]h ]h"]h$]h&]uh1jhj(ubeh}(h]h ]h"]h$]h&]uh1jhj(hMhj(ubeh}(h]h ]h"]h$]h&]uh1jhje(ubjM)}(h**Description**h]j)}(hj(h]h Description}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj(ubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhje(ubjM)}(hrThe caller must ensure that **pages** contains sufficient entries to cover the entire range described by **desc**.h](hThe caller must ensure that }(hj)hhhNhNubj)}(h **pages**h]hpages}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj)ubhD contains sufficient entries to cover the entire range described by }(hj)hhhNhNubj)}(h**desc**h]hdesc}(hj.)hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj)ubh.}(hj)hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhje(ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hrange_is_subset (C function)c.range_is_subsethNtauh1hhjKhhhNhNubh)}(hhh](h)}(h}bool range_is_subset (unsigned long outer_start, unsigned long outer_end, unsigned long inner_start, unsigned long inner_end)h]h)}(h|bool range_is_subset(unsigned long outer_start, unsigned long outer_end, unsigned long inner_start, unsigned long inner_end)h](j)}(hjh]hbool}(hjg)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjc)hhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMubj)}(h h]h }(hju)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjc)hhhjt)hMubh)}(hrange_is_subseth]j)}(hrange_is_subseth]hrange_is_subset}(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjc)hhhjt)hMubj8)}(hh(unsigned long outer_start, unsigned long outer_end, unsigned long inner_start, unsigned long inner_end)h](j>)}(hunsigned long outer_starth](j)}(hunsignedh]hunsigned}(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubj)}(h h]h }(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubj)}(hlongh]hlong}(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubj)}(h h]h }(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubj)}(h outer_starth]h outer_start}(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj)ubj>)}(hunsigned long outer_endh](j)}(hunsignedh]hunsigned}(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubj)}(h h]h }(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubj)}(hlongh]hlong}(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubj)}(h h]h }(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubj)}(h outer_endh]h outer_end}(hj,*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj)ubj>)}(hunsigned long inner_starth](j)}(hunsignedh]hunsigned}(hjE*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjA*ubj)}(h h]h }(hjS*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjA*ubj)}(hlongh]hlong}(hja*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjA*ubj)}(h h]h }(hjo*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjA*ubj)}(h inner_starth]h inner_start}(hj}*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjA*ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj)ubj>)}(hunsigned long inner_endh](j)}(hunsignedh]hunsigned}(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*ubj)}(h h]h }(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*ubj)}(hlongh]hlong}(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*ubj)}(h h]h }(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*ubj)}(h inner_endh]h inner_end}(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj)ubeh}(h]h ]h"]h$]h&]jjuh1j7hjc)hhhjt)hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj_)hhhjt)hMubah}(h]jZ)ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjt)hMhj\)hhubj4)}(hhh]jM)}(h9Is the specified inner range a subset of the outer range?h]h9Is the specified inner range a subset of the outer range?}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhj*hhubah}(h]h ]h"]h$]h&]uh1j3hj\)hhhjt)hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj+jHj+jIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``unsigned long outer_start`` The start of the outer range. ``unsigned long outer_end`` The exclusive end of the outer range. ``unsigned long inner_start`` The start of the inner range. ``unsigned long inner_end`` The exclusive end of the inner range. **Return** ``true`` if [inner_start, inner_end) is a subset of [outer_start, outer_end), otherwise ``false``.h](jM)}(h**Parameters**h]j)}(hj+h]h Parameters}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj+ubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hj+ubj)}(hhh](j)}(h<``unsigned long outer_start`` The start of the outer range. h](j)}(h``unsigned long outer_start``h]jS)}(hj9+h]hunsigned long outer_start}(hj;+hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj7+ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hj3+ubj)}(hhh]jM)}(hThe start of the outer range.h]hThe start of the outer range.}(hjR+hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjN+hM hjO+ubah}(h]h ]h"]h$]h&]uh1jhj3+ubeh}(h]h ]h"]h$]h&]uh1jhjN+hM hj0+ubj)}(hB``unsigned long outer_end`` The exclusive end of the outer range. h](j)}(h``unsigned long outer_end``h]jS)}(hjr+h]hunsigned long outer_end}(hjt+hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjp+ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hjl+ubj)}(hhh]jM)}(h%The exclusive end of the outer range.h]h%The exclusive end of the outer range.}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj+hM hj+ubah}(h]h ]h"]h$]h&]uh1jhjl+ubeh}(h]h ]h"]h$]h&]uh1jhj+hM hj0+ubj)}(h<``unsigned long inner_start`` The start of the inner range. h](j)}(h``unsigned long inner_start``h]jS)}(hj+h]hunsigned long inner_start}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj+ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hj+ubj)}(hhh]jM)}(hThe start of the inner range.h]hThe start of the inner range.}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj+hM hj+ubah}(h]h ]h"]h$]h&]uh1jhj+ubeh}(h]h ]h"]h$]h&]uh1jhj+hM hj0+ubj)}(hB``unsigned long inner_end`` The exclusive end of the inner range. h](j)}(h``unsigned long inner_end``h]jS)}(hj+h]hunsigned long inner_end}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj+ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM hj+ubj)}(hhh]jM)}(h%The exclusive end of the inner range.h]h%The exclusive end of the inner range.}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj+hM hj+ubah}(h]h ]h"]h$]h&]uh1jhj+ubeh}(h]h ]h"]h$]h&]uh1jhj+hM hj0+ubeh}(h]h ]h"]h$]h&]uh1jhj+ubjM)}(h **Return**h]j)}(hj,h]hReturn}(hj!,hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj,ubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhj+ubjM)}(hb``true`` if [inner_start, inner_end) is a subset of [outer_start, outer_end), otherwise ``false``.h](jS)}(h``true``h]htrue}(hj9,hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj5,ubhP if [inner_start, inner_end) is a subset of [outer_start, outer_end), otherwise }(hj5,hhhNhNubjS)}(h ``false``h]hfalse}(hjK,hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj5,ubh.}(hj5,hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhj+ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hrange_in_vma (C function)c.range_in_vmahNtauh1hhjKhhhNhNubh)}(hhh](h)}(h\bool range_in_vma (const struct vm_area_struct *vma, unsigned long start, unsigned long end)h]h)}(h[bool range_in_vma(const struct vm_area_struct *vma, unsigned long start, unsigned long end)h](j)}(hjh]hbool}(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,hhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMubj)}(h h]h }(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,hhhj,hMubh)}(h range_in_vmah]j)}(h range_in_vmah]h range_in_vma}(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj,hhhj,hMubj8)}(hJ(const struct vm_area_struct *vma, unsigned long start, unsigned long end)h](j>)}(h const struct vm_area_struct *vmah](j)}(hjh]hconst}(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,ubj)}(h h]h }(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,ubj)}(hjJ,h]hstruct}(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,ubj)}(h h]h }(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,ubh)}(hhh]j)}(hvm_area_structh]hvm_area_struct}(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj,modnameN classnameNjj)}j]j)}jj,sbc.range_in_vmaasbuh1hhj,ubj)}(h h]h }(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,ubjr)}(hjuh]h*}(hj'-hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj,ubj)}(hvmah]hvma}(hj4-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj,ubj>)}(hunsigned long starth](j)}(hunsignedh]hunsigned}(hjM-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjI-ubj)}(h h]h }(hj[-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjI-ubj)}(hlongh]hlong}(hji-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjI-ubj)}(h h]h }(hjw-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjI-ubj)}(hstarth]hstart}(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjI-ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj,ubj>)}(hunsigned long endh](j)}(hunsignedh]hunsigned}(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-ubj)}(h h]h }(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-ubj)}(hlongh]hlong}(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-ubj)}(h h]h }(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-ubj)}(hendh]hend}(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj,ubeh}(h]h ]h"]h$]h&]jjuh1j7hj,hhhj,hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj|,hhhj,hMubah}(h]jw,ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj,hMhjy,hhubj4)}(hhh]jM)}(h@is the specified [**start**, **end**) range a subset of the VMA?h](his the specified [}(hj.hhhNhNubj)}(h **start**h]hstart}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj.ubh, }(hj.hhhNhNubj)}(h**end**h]hend}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj.ubh) range a subset of the VMA?}(hj.hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhj-hhubah}(h]h ]h"]h$]h&]uh1j3hjy,hhhj,hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj<.jHj<.jIjJjKuh1hhhhjKhNhNubj)}(hXy**Parameters** ``const struct vm_area_struct *vma`` The VMA against which we want to check [**start**, **end**). ``unsigned long start`` The start of the range we wish to check. ``unsigned long end`` The exclusive end of the range we wish to check. **Return** ``true`` if [**start**, **end**) is a subset of [**vma->vm_start**, **vma->vm_end**), ``false`` otherwise.h](jM)}(h**Parameters**h]j)}(hjF.h]h Parameters}(hjH.hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjD.ubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhj@.ubj)}(hhh](j)}(hb``const struct vm_area_struct *vma`` The VMA against which we want to check [**start**, **end**). h](j)}(h$``const struct vm_area_struct *vma``h]jS)}(hje.h]h const struct vm_area_struct *vma}(hjg.hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjc.ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhj_.ubj)}(hhh]jM)}(hvm_start**, **vma->vm_end**), ``false`` otherwise.h](jS)}(h``true``h]htrue}(hjP/hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjL/ubh if [}(hjL/hhhNhNubj)}(h **start**h]hstart}(hjb/hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjL/ubh, }(hjL/hhhNhNubj)}(h**end**h]hend}(hjt/hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjL/ubh) is a subset of [}(hjL/hhhNhNubj)}(h**vma->vm_start**h]h vma->vm_start}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjL/ubh, }(hjL/hhhNhNubj)}(h**vma->vm_end**h]h vma->vm_end}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjL/ubh), }(hjL/hhhNhNubjS)}(h ``false``h]hfalse}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjL/ubh otherwise.}(hjL/hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhj@.ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hrange_in_vma_desc (C function)c.range_in_vma_deschNtauh1hhjKhhhNhNubh)}(hhh](h)}(h`bool range_in_vma_desc (const struct vm_area_desc *desc, unsigned long start, unsigned long end)h]h)}(h_bool range_in_vma_desc(const struct vm_area_desc *desc, unsigned long start, unsigned long end)h](j)}(hjh]hbool}(hj/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/hhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM,ubj)}(h h]h }(hj/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/hhhj/hM,ubh)}(hrange_in_vma_desch]j)}(hrange_in_vma_desch]hrange_in_vma_desc}(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj/hhhj/hM,ubj8)}(hI(const struct vm_area_desc *desc, unsigned long start, unsigned long end)h](j>)}(hconst struct vm_area_desc *desch](j)}(hjh]hconst}(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubj)}(h h]h }(hj,0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubj)}(hjJ,h]hstruct}(hj:0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubj)}(h h]h }(hjG0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubh)}(hhh]j)}(h vm_area_desch]h vm_area_desc}(hjX0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjU0ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjZ0modnameN classnameNjj)}j]j)}jj0sbc.range_in_vma_descasbuh1hhj0ubj)}(h h]h }(hjx0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubjr)}(hjuh]h*}(hj0hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj0ubj)}(hdesch]hdesc}(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj0ubj>)}(hunsigned long starth](j)}(hunsignedh]hunsigned}(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubj)}(h h]h }(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubj)}(hlongh]hlong}(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubj)}(h h]h }(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubj)}(hstarth]hstart}(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj0ubj>)}(hunsigned long endh](j)}(hunsignedh]hunsigned}(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubj)}(h h]h }(hj 1hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubj)}(hlongh]hlong}(hj1hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubj)}(h h]h }(hj'1hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubj)}(hendh]hend}(hj51hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj0ubeh}(h]h ]h"]h$]h&]jjuh1j7hj/hhhj/hM,ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj/hhhj/hM,ubah}(h]j/ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj/hM,hj/hhubj4)}(hhh]jM)}(hhis the specified [**start**, **end**) range a subset of the VMA described by **desc**, a VMA descriptor?h](his the specified [}(hj_1hhhNhNubj)}(h **start**h]hstart}(hjg1hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj_1ubh, }(hj_1hhhNhNubj)}(h**end**h]hend}(hjy1hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj_1ubh)) range a subset of the VMA described by }(hj_1hhhNhNubj)}(h**desc**h]hdesc}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj_1ubh, a VMA descriptor?}(hj_1hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM,hj\1hhubah}(h]h ]h"]h$]h&]uh1j3hj/hhhj/hM,ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj1jHj1jIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``const struct vm_area_desc *desc`` The VMA descriptor against which we want to check [**start**, **end**). ``unsigned long start`` The start of the range we wish to check. ``unsigned long end`` The exclusive end of the range we wish to check. **Return** ``true`` if [**start**, **end**) is a subset of [**desc->start**, **desc->end**), ``false`` otherwise.h](jM)}(h**Parameters**h]j)}(hj1h]h Parameters}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj1ubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM0hj1ubj)}(hhh](j)}(hl``const struct vm_area_desc *desc`` The VMA descriptor against which we want to check [**start**, **end**). h](j)}(h#``const struct vm_area_desc *desc``h]jS)}(hj1h]hconst struct vm_area_desc *desc}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj1ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM.hj1ubj)}(hhh]jM)}(hGThe VMA descriptor against which we want to check [**start**, **end**).h](h3The VMA descriptor against which we want to check [}(hj1hhhNhNubj)}(h **start**h]hstart}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj1ubh, }(hj1hhhNhNubj)}(h**end**h]hend}(hj 2hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj1ubh).}(hj1hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhj1hM.hj1ubah}(h]h ]h"]h$]h&]uh1jhj1ubeh}(h]h ]h"]h$]h&]uh1jhj1hM.hj1ubj)}(hA``unsigned long start`` The start of the range we wish to check. h](j)}(h``unsigned long start``h]jS)}(hj32h]hunsigned long start}(hj52hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj12ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM/hj-2ubj)}(hhh]jM)}(h(The start of the range we wish to check.h]h(The start of the range we wish to check.}(hjL2hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjH2hM/hjI2ubah}(h]h ]h"]h$]h&]uh1jhj-2ubeh}(h]h ]h"]h$]h&]uh1jhjH2hM/hj1ubj)}(hG``unsigned long end`` The exclusive end of the range we wish to check. h](j)}(h``unsigned long end``h]jS)}(hjl2h]hunsigned long end}(hjn2hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjj2ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM0hjf2ubj)}(hhh]jM)}(h0The exclusive end of the range we wish to check.h]h0The exclusive end of the range we wish to check.}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj2hM0hj2ubah}(h]h ]h"]h$]h&]uh1jhjf2ubeh}(h]h ]h"]h$]h&]uh1jhj2hM0hj1ubeh}(h]h ]h"]h$]h&]uh1jhj1ubjM)}(h **Return**h]j)}(hj2h]hReturn}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj2ubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM2hj1ubjM)}(hf``true`` if [**start**, **end**) is a subset of [**desc->start**, **desc->end**), ``false`` otherwise.h](jS)}(h``true``h]htrue}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj2ubh if [}(hj2hhhNhNubj)}(h **start**h]hstart}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj2ubh, }(hj2hhhNhNubj)}(h**end**h]hend}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj2ubh) is a subset of [}(hj2hhhNhNubj)}(h**desc->start**h]h desc->start}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj2ubh, }hj2sbj)}(h **desc->end**h]h desc->end}(hj 3hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj2ubh), }(hj2hhhNhNubjS)}(h ``false``h]hfalse}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj2ubh otherwise.}(hj2hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhM2hj1ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hclear_pages (C function) c.clear_pageshNtauh1hhjKhhhNhNubh)}(hhh](h)}(h2void clear_pages (void *addr, unsigned int npages)h]h)}(h1void clear_pages(void *addr, unsigned int npages)h](j)}(hvoidh]hvoid}(hjT3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjP3hhhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMubj)}(h h]h }(hjc3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjP3hhhjb3hMubh)}(h clear_pagesh]j)}(h clear_pagesh]h clear_pages}(hju3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjq3ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjP3hhhjb3hMubj8)}(h!(void *addr, unsigned int npages)h](j>)}(h void *addrh](j)}(hvoidh]hvoid}(hj3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3ubj)}(h h]h }(hj3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3ubjr)}(hjuh]h*}(hj3hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj3ubj)}(haddrh]haddr}(hj3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj3ubj>)}(hunsigned int npagesh](j)}(hunsignedh]hunsigned}(hj3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3ubj)}(h h]h }(hj3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3ubj)}(hinth]hint}(hj3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3ubj)}(h h]h }(hj3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3ubj)}(hnpagesh]hnpages}(hj 4hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj3ubeh}(h]h ]h"]h$]h&]jjuh1j7hjP3hhhjb3hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjL3hhhjb3hMubah}(h]jG3ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjb3hMhjI3hhubj4)}(hhh]jM)}(h+clear a page range for kernel-internal use.h]h+clear a page range for kernel-internal use.}(hj54hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhj24hhubah}(h]h ]h"]h$]h&]uh1j3hjI3hhhjb3hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjM4jHjM4jIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``void *addr`` start address ``unsigned int npages`` number of pages **Description** Use clear_user_pages() instead when clearing a page range to be mapped to user space. Does absolutely no exception handling. Note that even though the clearing operation is preemptible, clear_pages() does not (and on architectures where it reduces to a few long-running instructions, might not be able to) call cond_resched() to check if rescheduling is required. When running under preemptible models this is not a problem. Under cooperatively scheduled models, however, the caller is expected to limit **npages** to no more than PROCESS_PAGES_NON_PREEMPT_BATCH.h](jM)}(h**Parameters**h]j)}(hjW4h]h Parameters}(hjY4hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjU4ubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjQ4ubj)}(hhh](j)}(h``void *addr`` start address h](j)}(h``void *addr``h]jS)}(hjv4h]h void *addr}(hjx4hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjt4ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjp4ubj)}(hhh]jM)}(h start addressh]h start address}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj4hMhj4ubah}(h]h ]h"]h$]h&]uh1jhjp4ubeh}(h]h ]h"]h$]h&]uh1jhj4hMhjm4ubj)}(h(``unsigned int npages`` number of pages h](j)}(h``unsigned int npages``h]jS)}(hj4h]hunsigned int npages}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj4ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhj4ubj)}(hhh]jM)}(hnumber of pagesh]hnumber of pages}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj4hMhj4ubah}(h]h ]h"]h$]h&]uh1jhj4ubeh}(h]h ]h"]h$]h&]uh1jhj4hMhjm4ubeh}(h]h ]h"]h$]h&]uh1jhjQ4ubjM)}(h**Description**h]j)}(hj4h]h Description}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj4ubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjQ4ubjM)}(hUUse clear_user_pages() instead when clearing a page range to be mapped to user space.h]hUUse clear_user_pages() instead when clearing a page range to be mapped to user space.}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjQ4ubjM)}(h&Does absolutely no exception handling.h]h&Does absolutely no exception handling.}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjQ4ubjM)}(hNote that even though the clearing operation is preemptible, clear_pages() does not (and on architectures where it reduces to a few long-running instructions, might not be able to) call cond_resched() to check if rescheduling is required.h]hNote that even though the clearing operation is preemptible, clear_pages() does not (and on architectures where it reduces to a few long-running instructions, might not be able to) call cond_resched() to check if rescheduling is required.}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjQ4ubjM)}(hWhen running under preemptible models this is not a problem. Under cooperatively scheduled models, however, the caller is expected to limit **npages** to no more than PROCESS_PAGES_NON_PREEMPT_BATCH.h](hWhen running under preemptible models this is not a problem. Under cooperatively scheduled models, however, the caller is expected to limit }(hj-5hhhNhNubj)}(h **npages**h]hnpages}(hj55hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj-5ubh1 to no more than PROCESS_PAGES_NON_PREEMPT_BATCH.}(hj-5hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhS/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:119: ./include/linux/mm.hhMhjQ4ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfolio_ref_count (C function)c.folio_ref_counthNtauh1hhjKhhhNhNubh)}(hhh](h)}(h/int folio_ref_count (const struct folio *folio)h]h)}(h.int folio_ref_count(const struct folio *folio)h](j)}(hinth]hint}(hjn5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjj5hhhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:121: ./include/linux/page_ref.hhKGubj)}(h h]h }(hj}5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjj5hhhj|5hKGubh)}(hfolio_ref_counth]j)}(hfolio_ref_counth]hfolio_ref_count}(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjj5hhhj|5hKGubj8)}(h(const struct folio *folio)h]j>)}(hconst struct folio *folioh](j)}(hjh]hconst}(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5ubj)}(h h]h }(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5ubj)}(hjJ,h]hstruct}(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5ubj)}(h h]h }(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5ubh)}(hhh]j)}(hfolioh]hfolio}(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj5modnameN classnameNjj)}j]j)}jj5sbc.folio_ref_countasbuh1hhj5ubj)}(h h]h }(hj6hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5ubjr)}(hjuh]h*}(hj6hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj5ubj)}(hfolioh]hfolio}(hj6hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj5ubah}(h]h ]h"]h$]h&]jjuh1j7hjj5hhhj|5hKGubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjf5hhhj|5hKGubah}(h]ja5ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj|5hKGhjc5hhubj4)}(hhh]jM)}(h"The reference count on this folio.h]h"The reference count on this folio.}(hjI6hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:121: ./include/linux/page_ref.hhKGhjF6hhubah}(h]h ]h"]h$]h&]uh1j3hjc5hhhj|5hKGubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGja6jHja6jIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``const struct folio *folio`` The folio. **Description** Folios contain a reference count. When that reference count reaches zero, the folio is referred to as frozen. At this point, it will usually be returned to the memory allocator, but some parts of the kernel freeze folios in order to perform unusual operations on them such as splitting or migration. The refcount is usually incremented by calls to folio_get() and decremented by calls to folio_put(). Some typical users of the folio refcount: - Each reference from a page table - The page cache - Filesystem private data - The LRU list - Pipes - Direct IO which references this page in the process address space The reference count has three components: expected, temporary and spurious. The expected reference count of a folio is that which we would logically expect it to be from just reading the code. Temporary refcounts are gained by threads which need a temporary reference to make sure the folio isn't reallocated while they use it. Spurious refcounts are gained by threads which, thanks to RCU walks of the page tables or file cache, find a stale pointer to a folio. These threads will drop the refcount after discoveering the pointer is stale, but it can surprise other users to see the spurious refcount on a freshly allocated folio (eg they may see a refcount of 2 instead of 1). **Return** The number of references to this folio.h](jM)}(h**Parameters**h]j)}(hjk6h]h Parameters}(hjm6hhhNhNubah}(h]h ]h"]h$]h&]uh1jhji6ubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:121: ./include/linux/page_ref.hhKKhje6ubj)}(hhh]j)}(h)``const struct folio *folio`` The folio. h](j)}(h``const struct folio *folio``h]jS)}(hj6h]hconst struct folio *folio}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj6ubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:121: ./include/linux/page_ref.hhKHhj6ubj)}(hhh]jM)}(h The folio.h]h The folio.}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj6hKHhj6ubah}(h]h ]h"]h$]h&]uh1jhj6ubeh}(h]h ]h"]h$]h&]uh1jhj6hKHhj6ubah}(h]h ]h"]h$]h&]uh1jhje6ubjM)}(h**Description**h]j)}(hj6h]h Description}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj6ubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:121: ./include/linux/page_ref.hhKJhje6ubjM)}(hX-Folios contain a reference count. When that reference count reaches zero, the folio is referred to as frozen. At this point, it will usually be returned to the memory allocator, but some parts of the kernel freeze folios in order to perform unusual operations on them such as splitting or migration.h]hX-Folios contain a reference count. When that reference count reaches zero, the folio is referred to as frozen. At this point, it will usually be returned to the memory allocator, but some parts of the kernel freeze folios in order to perform unusual operations on them such as splitting or migration.}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:121: ./include/linux/page_ref.hhKIhje6ubjM)}(hThe refcount is usually incremented by calls to folio_get() and decremented by calls to folio_put(). Some typical users of the folio refcount:h]hThe refcount is usually incremented by calls to folio_get() and decremented by calls to folio_put(). Some typical users of the folio refcount:}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:121: ./include/linux/page_ref.hhKOhje6ubj^)}(hhh](jc)}(h Each reference from a page tableh]jM)}(hj6h]h Each reference from a page table}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:121: ./include/linux/page_ref.hhKShj6ubah}(h]h ]h"]h$]h&]uh1jbhj6ubjc)}(hThe page cacheh]jM)}(hj7h]hThe page cache}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:121: ./include/linux/page_ref.hhKThj7ubah}(h]h ]h"]h$]h&]uh1jbhj6ubjc)}(hFilesystem private datah]jM)}(hj.7h]hFilesystem private data}(hj07hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:121: ./include/linux/page_ref.hhKUhj,7ubah}(h]h ]h"]h$]h&]uh1jbhj6ubjc)}(h The LRU listh]jM)}(hjF7h]h The LRU list}(hjH7hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:121: ./include/linux/page_ref.hhKVhjD7ubah}(h]h ]h"]h$]h&]uh1jbhj6ubjc)}(hPipesh]jM)}(hj^7h]hPipes}(hj`7hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:121: ./include/linux/page_ref.hhKWhj\7ubah}(h]h ]h"]h$]h&]uh1jbhj6ubjc)}(hBDirect IO which references this page in the process address space h]jM)}(hADirect IO which references this page in the process address spaceh]hADirect IO which references this page in the process address space}(hjx7hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:121: ./include/linux/page_ref.hhKXhjt7ubah}(h]h ]h"]h$]h&]uh1jbhj6ubeh}(h]h ]h"]h$]h&]jjuh1j]hj 7hKShje6ubjM)}(hXThe reference count has three components: expected, temporary and spurious. The expected reference count of a folio is that which we would logically expect it to be from just reading the code. Temporary refcounts are gained by threads which need a temporary reference to make sure the folio isn't reallocated while they use it. Spurious refcounts are gained by threads which, thanks to RCU walks of the page tables or file cache, find a stale pointer to a folio. These threads will drop the refcount after discoveering the pointer is stale, but it can surprise other users to see the spurious refcount on a freshly allocated folio (eg they may see a refcount of 2 instead of 1).h]hXThe reference count has three components: expected, temporary and spurious. The expected reference count of a folio is that which we would logically expect it to be from just reading the code. Temporary refcounts are gained by threads which need a temporary reference to make sure the folio isn’t reallocated while they use it. Spurious refcounts are gained by threads which, thanks to RCU walks of the page tables or file cache, find a stale pointer to a folio. These threads will drop the refcount after discoveering the pointer is stale, but it can surprise other users to see the spurious refcount on a freshly allocated folio (eg they may see a refcount of 2 instead of 1).}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:121: ./include/linux/page_ref.hhKZhje6ubjM)}(h **Return**h]j)}(hj7h]hReturn}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj7ubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:121: ./include/linux/page_ref.hhKfhje6ubjM)}(h'The number of references to this folio.h]h'The number of references to this folio.}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:121: ./include/linux/page_ref.hhKghje6ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfolio_try_get (C function)c.folio_try_gethNtauh1hhjKhhhNhNubh)}(hhh](h)}(h(bool folio_try_get (struct folio *folio)h]h)}(h'bool folio_try_get(struct folio *folio)h](j)}(hjh]hbool}(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7hhhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:121: ./include/linux/page_ref.hhMubj)}(h h]h }(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7hhhj7hMubh)}(h folio_try_geth]j)}(h folio_try_geth]h folio_try_get}(hj 8hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj8ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj7hhhj7hMubj8)}(h(struct folio *folio)h]j>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hj%8hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!8ubj)}(h h]h }(hj28hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!8ubh)}(hhh]j)}(hfolioh]hfolio}(hjC8hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@8ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjE8modnameN classnameNjj)}j]j)}jj 8sbc.folio_try_getasbuh1hhj!8ubj)}(h h]h }(hjc8hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!8ubjr)}(hjuh]h*}(hjq8hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj!8ubj)}(hfolioh]hfolio}(hj~8hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!8ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj8ubah}(h]h ]h"]h$]h&]jjuh1j7hj7hhhj7hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj7hhhj7hMubah}(h]j7ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj7hMhj7hhubj4)}(hhh]jM)}(h,Attempt to increase the refcount on a folio.h]h,Attempt to increase the refcount on a folio.}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:121: ./include/linux/page_ref.hhMhj8hhubah}(h]h ]h"]h$]h&]uh1j3hj7hhhj7hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj8jHj8jIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct folio *folio`` The folio. **Description** If you do not already have a reference to a folio, you can attempt to get one using this function. It may fail if, for example, the folio has been freed since you found a pointer to it, or it is frozen for the purposes of splitting or migration. **Return** True if the reference count was successfully incremented.h](jM)}(h**Parameters**h]j)}(hj8h]h Parameters}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj8ubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:121: ./include/linux/page_ref.hhM hj8ubj)}(hhh]j)}(h#``struct folio *folio`` The folio. h](j)}(h``struct folio *folio``h]jS)}(hj8h]hstruct folio *folio}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj8ubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:121: ./include/linux/page_ref.hhM hj8ubj)}(hhh]jM)}(h The folio.h]h The folio.}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj8hM hj8ubah}(h]h ]h"]h$]h&]uh1jhj8ubeh}(h]h ]h"]h$]h&]uh1jhj8hM hj8ubah}(h]h ]h"]h$]h&]uh1jhj8ubjM)}(h**Description**h]j)}(hj$9h]h Description}(hj&9hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj"9ubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:121: ./include/linux/page_ref.hhM hj8ubjM)}(hIf you do not already have a reference to a folio, you can attempt to get one using this function. It may fail if, for example, the folio has been freed since you found a pointer to it, or it is frozen for the purposes of splitting or migration.h]hIf you do not already have a reference to a folio, you can attempt to get one using this function. It may fail if, for example, the folio has been freed since you found a pointer to it, or it is frozen for the purposes of splitting or migration.}(hj:9hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:121: ./include/linux/page_ref.hhM hj8ubjM)}(h **Return**h]j)}(hjK9h]hReturn}(hjM9hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjI9ubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:121: ./include/linux/page_ref.hhMhj8ubjM)}(h9True if the reference count was successfully incremented.h]h9True if the reference count was successfully incremented.}(hja9hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhY/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:121: ./include/linux/page_ref.hhMhj8ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hzone_is_contiguous (C function)c.zone_is_contiguoushNtauh1hhjKhhhNhNubh)}(hhh](h)}(h1bool zone_is_contiguous (const struct zone *zone)h]h)}(h0bool zone_is_contiguous(const struct zone *zone)h](j)}(hjh]hbool}(hj9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9hhhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhMubj)}(h h]h }(hj9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9hhhj9hMubh)}(hzone_is_contiguoush]j)}(hzone_is_contiguoush]hzone_is_contiguous}(hj9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj9hhhj9hMubj8)}(h(const struct zone *zone)h]j>)}(hconst struct zone *zoneh](j)}(hjh]hconst}(hj9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9ubj)}(h h]h }(hj9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9ubj)}(hjJ,h]hstruct}(hj9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9ubj)}(h h]h }(hj9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9ubh)}(hhh]j)}(hzoneh]hzone}(hj:hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj:modnameN classnameNjj)}j]j)}jj9sbc.zone_is_contiguousasbuh1hhj9ubj)}(h h]h }(hj%:hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9ubjr)}(hjuh]h*}(hj3:hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj9ubj)}(hzoneh]hzone}(hj@:hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj9ubah}(h]h ]h"]h$]h&]jjuh1j7hj9hhhj9hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj9hhhj9hMubah}(h]j9ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj9hMhj9hhubj4)}(hhh]jM)}(h!test whether a zone is contiguoush]h!test whether a zone is contiguous}(hjj:hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhMhjg:hhubah}(h]h ]h"]h$]h&]uh1j3hj9hhhj9hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj:jHj:jIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``const struct zone *zone`` the zone to test. **Description** In a contiguous zone, it is valid to call pfn_to_page() on any PFN in the spanned zone without requiring pfn_valid() or pfn_to_online_page() checks. Note that missing synchronization with memory offlining makes any PFN traversal prone to races. ZONE_DEVICE zones are always marked non-contiguous. **Return** true if contiguous, otherwise false.h](jM)}(h**Parameters**h]j)}(hj:h]h Parameters}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj:ubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhMhj:ubj)}(hhh]j)}(h.``const struct zone *zone`` the zone to test. h](j)}(h``const struct zone *zone``h]jS)}(hj:h]hconst struct zone *zone}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj:ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhMhj:ubj)}(hhh]jM)}(hthe zone to test.h]hthe zone to test.}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj:hMhj:ubah}(h]h ]h"]h$]h&]uh1jhj:ubeh}(h]h ]h"]h$]h&]uh1jhj:hMhj:ubah}(h]h ]h"]h$]h&]uh1jhj:ubjM)}(h**Description**h]j)}(hj:h]h Description}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj:ubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhMhj:ubjM)}(hIn a contiguous zone, it is valid to call pfn_to_page() on any PFN in the spanned zone without requiring pfn_valid() or pfn_to_online_page() checks.h]hIn a contiguous zone, it is valid to call pfn_to_page() on any PFN in the spanned zone without requiring pfn_valid() or pfn_to_online_page() checks.}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhMhj:ubjM)}(h_Note that missing synchronization with memory offlining makes any PFN traversal prone to races.h]h_Note that missing synchronization with memory offlining makes any PFN traversal prone to races.}(hj ;hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhMhj:ubjM)}(h3ZONE_DEVICE zones are always marked non-contiguous.h]h3ZONE_DEVICE zones are always marked non-contiguous.}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhMhj:ubjM)}(h **Return**h]j)}(hj+;h]hReturn}(hj-;hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj);ubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhMhj:ubjM)}(h$true if contiguous, otherwise false.h]h$true if contiguous, otherwise false.}(hjA;hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhMhj:ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](his_highmem (C function) c.is_highmemhNtauh1hhjKhhhNhNubh)}(hhh](h)}(h(int is_highmem (const struct zone *zone)h]h)}(h'int is_highmem(const struct zone *zone)h](j)}(hinth]hint}(hjp;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjl;hhhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhMubj)}(h h]h }(hj;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjl;hhhj~;hMubh)}(h is_highmemh]j)}(h is_highmemh]h is_highmem}(hj;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjl;hhhj~;hMubj8)}(h(const struct zone *zone)h]j>)}(hconst struct zone *zoneh](j)}(hjh]hconst}(hj;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;ubj)}(h h]h }(hj;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;ubj)}(hjJ,h]hstruct}(hj;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;ubj)}(h h]h }(hj;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;ubh)}(hhh]j)}(hzoneh]hzone}(hj;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj;modnameN classnameNjj)}j]j)}jj;sb c.is_highmemasbuh1hhj;ubj)}(h h]h }(hj<hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;ubjr)}(hjuh]h*}(hj<hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj;ubj)}(hzoneh]hzone}(hj!<hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj;ubah}(h]h ]h"]h$]h&]jjuh1j7hjl;hhhj~;hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjh;hhhj~;hMubah}(h]jc;ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj~;hMhje;hhubj4)}(hhh]jM)}(hhelper function to quickly check if a struct zone is a highmem zone or not. This is an attempt to keep references to ZONE_{DMA/NORMAL/HIGHMEM/etc} in general code to a minimum.h]hhelper function to quickly check if a struct zone is a highmem zone or not. This is an attempt to keep references to ZONE_{DMA/NORMAL/HIGHMEM/etc} in general code to a minimum.}(hjK<hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhMhjH<hhubah}(h]h ]h"]h$]h&]uh1j3hje;hhhj~;hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjc<jHjc<jIjJjKuh1hhhhjKhNhNubj)}(h|**Parameters** ``const struct zone *zone`` pointer to struct zone variable **Return** 1 for a highmem zone, 0 otherwiseh](jM)}(h**Parameters**h]j)}(hjm<h]h Parameters}(hjo<hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjk<ubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhMhjg<ubj)}(hhh]j)}(h<``const struct zone *zone`` pointer to struct zone variable h](j)}(h``const struct zone *zone``h]jS)}(hj<h]hconst struct zone *zone}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj<ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhMhj<ubj)}(hhh]jM)}(hpointer to struct zone variableh]hpointer to struct zone variable}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj<hMhj<ubah}(h]h ]h"]h$]h&]uh1jhj<ubeh}(h]h ]h"]h$]h&]uh1jhj<hMhj<ubah}(h]h ]h"]h$]h&]uh1jhjg<ubjM)}(h **Return**h]j)}(hj<h]hReturn}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj<ubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhMhjg<ubjM)}(h!1 for a highmem zone, 0 otherwiseh]h!1 for a highmem zone, 0 otherwise}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhMhjg<ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfor_each_online_pgdat (C macro)c.for_each_online_pgdathNtauh1hhjKhhhNhNubh)}(hhh](h)}(hfor_each_online_pgdath]h)}(hfor_each_online_pgdath]h)}(hfor_each_online_pgdath]j)}(hj=h]hfor_each_online_pgdat}(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj =ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj=hhhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhM%ubah}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj=hhhj#=hM%ubah}(h]j<ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj#=hM%hj=hhubj4)}(hhh]h}(h]h ]h"]h$]h&]uh1j3hj=hhhj#=hM%ubeh}(h]h ](jAmacroeh"]h$]h&]jFjAjGj<=jHj<=jIjJjKuh1hhhhjKhNhNubjM)}(h!``for_each_online_pgdat (pgdat)``h]jS)}(hjB=h]hfor_each_online_pgdat (pgdat)}(hjD=hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj@=ubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhM'hjKhhubji)}(h.helper macro to iterate over all online nodes h]jM)}(h-helper macro to iterate over all online nodesh]h-helper macro to iterate over all online nodes}(hj\=hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhM%hjX=ubah}(h]h ]h"]h$]h&]uh1jhhjj=hM%hjKhhubj)}(h;**Parameters** ``pgdat`` pointer to a pg_data_t variableh](jM)}(h**Parameters**h]j)}(hjw=h]h Parameters}(hjy=hhhNhNubah}(h]h ]h"]h$]h&]uh1jhju=ubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhM)hjq=ubj)}(hhh]j)}(h)``pgdat`` pointer to a pg_data_t variableh](j)}(h ``pgdat``h]jS)}(hj=h]hpgdat}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj=ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhM+hj=ubj)}(hhh]jM)}(hpointer to a pg_data_t variableh]hpointer to a pg_data_t variable}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhM&hj=ubah}(h]h ]h"]h$]h&]uh1jhj=ubeh}(h]h ]h"]h$]h&]uh1jhj=hM+hj=ubah}(h]h ]h"]h$]h&]uh1jhjq=ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfor_each_zone (C macro)c.for_each_zonehNtauh1hhjKhhhNhNubh)}(hhh](h)}(h for_each_zoneh]h)}(h for_each_zoneh]h)}(h for_each_zoneh]j)}(hj=h]h for_each_zone}(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj=hhhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhM-ubah}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj=hhhj>hM-ubah}(h]j=ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj>hM-hj=hhubj4)}(hhh]h}(h]h ]h"]h$]h&]uh1j3hj=hhhj>hM-ubeh}(h]h ](jAmacroeh"]h$]h&]jFjAjGj >jHj >jIjJjKuh1hhhhjKhNhNubjM)}(h``for_each_zone (zone)``h]jS)}(hj&>h]hfor_each_zone (zone)}(hj(>hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj$>ubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhM/hjKhhubji)}(h.helper macro to iterate over all memory zones h]jM)}(h-helper macro to iterate over all memory zonesh]h-helper macro to iterate over all memory zones}(hj@>hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhM-hj<>ubah}(h]h ]h"]h$]h&]uh1jhhjN>hM-hjKhhubj)}(h**Parameters** ``zone`` pointer to struct zone variable **Description** The user only needs to declare the zone variable, for_each_zone fills it in.h](jM)}(h**Parameters**h]j)}(hj[>h]h Parameters}(hj]>hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjY>ubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhM1hjU>ubj)}(hhh]j)}(h)``zone`` pointer to struct zone variable h](j)}(h``zone``h]jS)}(hjz>h]hzone}(hj|>hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjx>ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhM.hjt>ubj)}(hhh]jM)}(hpointer to struct zone variableh]hpointer to struct zone variable}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj>hM.hj>ubah}(h]h ]h"]h$]h&]uh1jhjt>ubeh}(h]h ]h"]h$]h&]uh1jhj>hM.hjq>ubah}(h]h ]h"]h$]h&]uh1jhjU>ubjM)}(h**Description**h]j)}(hj>h]h Description}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj>ubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhM0hjU>ubjM)}(hLThe user only needs to declare the zone variable, for_each_zone fills it in.h]hLThe user only needs to declare the zone variable, for_each_zone fills it in.}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhM/hjU>ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h next_zones_zonelist (C function)c.next_zones_zonelisthNtauh1hhjKhhhNhNubh)}(hhh](h)}(hqstruct zoneref * next_zones_zonelist (struct zoneref *z, enum zone_type highest_zoneidx, const nodemask_t *nodes)h]h)}(hostruct zoneref *next_zones_zonelist(struct zoneref *z, enum zone_type highest_zoneidx, const nodemask_t *nodes)h](j)}(hjJ,h]hstruct}(hj>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>hhhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhMTubj)}(h h]h }(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>hhhj?hMTubh)}(hhh]j)}(hzonerefh]hzoneref}(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj?modnameN classnameNjj)}j]j)}jnext_zones_zonelistsbc.next_zones_zonelistasbuh1hhj>hhhj?hMTubj)}(h h]h }(hj:?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>hhhj?hMTubjr)}(hjuh]h*}(hjH?hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj>hhhj?hMTubh)}(hnext_zones_zonelisth]j)}(hj7?h]hnext_zones_zonelist}(hjY?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjU?ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj>hhhj?hMTubj8)}(hL(struct zoneref *z, enum zone_type highest_zoneidx, const nodemask_t *nodes)h](j>)}(hstruct zoneref *zh](j)}(hjJ,h]hstruct}(hjt?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjp?ubj)}(h h]h }(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjp?ubh)}(hhh]j)}(hzonerefh]hzoneref}(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj?modnameN classnameNjj)}j]j5?c.next_zones_zonelistasbuh1hhjp?ubj)}(h h]h }(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjp?ubjr)}(hjuh]h*}(hj?hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjp?ubj)}(hzh]hz}(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjp?ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjl?ubj>)}(henum zone_type highest_zoneidxh](j)}(hj#!h]henum}(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?ubj)}(h h]h }(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?ubh)}(hhh]j)}(h zone_typeh]h zone_type}(hj@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj@modnameN classnameNjj)}j]j5?c.next_zones_zonelistasbuh1hhj?ubj)}(h h]h }(hj @hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?ubj)}(hhighest_zoneidxh]hhighest_zoneidx}(hj.@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjl?ubj>)}(hconst nodemask_t *nodesh](j)}(hjh]hconst}(hjG@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjC@ubj)}(h h]h }(hjT@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjC@ubh)}(hhh]j)}(h nodemask_th]h nodemask_t}(hje@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjb@ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjg@modnameN classnameNjj)}j]j5?c.next_zones_zonelistasbuh1hhjC@ubj)}(h h]h }(hj@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjC@ubjr)}(hjuh]h*}(hj@hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjC@ubj)}(hnodesh]hnodes}(hj@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjC@ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjl?ubeh}(h]h ]h"]h$]h&]jjuh1j7hj>hhhj?hMTubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj>hhhj?hMTubah}(h]j>ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj?hMThj>hhubj4)}(hhh]jM)}(hReturns the next zone at or below highest_zoneidx within the allowed nodemask using a cursor within a zonelist as a starting pointh]hReturns the next zone at or below highest_zoneidx within the allowed nodemask using a cursor within a zonelist as a starting point}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhMThj@hhubah}(h]h ]h"]h$]h&]uh1j3hj>hhhj?hMTubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj@jHj@jIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct zoneref *z`` The cursor used as a starting point for the search ``enum zone_type highest_zoneidx`` The zone index of the highest zone to return ``const nodemask_t *nodes`` An optional nodemask to filter the zonelist with **Description** This function returns the next zone at or below a given zone index that is within the allowed nodemask using a cursor as the starting point for the search. The zoneref returned is a cursor that represents the current zone being examined. It should be advanced by one before calling next_zones_zonelist again. **Return** the next zone at or below highest_zoneidx within the allowed nodemask using a cursor within a zonelist as a starting pointh](jM)}(h**Parameters**h]j)}(hj@h]h Parameters}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj@ubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhMXhj@ubj)}(hhh](j)}(hI``struct zoneref *z`` The cursor used as a starting point for the search h](j)}(h``struct zoneref *z``h]jS)}(hj Ah]hstruct zoneref *z}(hj AhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjAubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhMUhjAubj)}(hhh]jM)}(h2The cursor used as a starting point for the searchh]h2The cursor used as a starting point for the search}(hj"AhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjAhMUhjAubah}(h]h ]h"]h$]h&]uh1jhjAubeh}(h]h ]h"]h$]h&]uh1jhjAhMUhjAubj)}(hP``enum zone_type highest_zoneidx`` The zone index of the highest zone to return h](j)}(h"``enum zone_type highest_zoneidx``h]jS)}(hjBAh]henum zone_type highest_zoneidx}(hjDAhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj@Aubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhMVhjBubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjCBmodnameN classnameNjj)}j]j)}jfirst_zones_zonelistsbc.first_zones_zonelistasbuh1hhjBhhhj/BhMlubj)}(h h]h }(hjbBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBhhhj/BhMlubjr)}(hjuh]h*}(hjpBhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjBhhhj/BhMlubh)}(hfirst_zones_zonelisth]j)}(hj_Bh]hfirst_zones_zonelist}(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj}Bubah}(h]h ](jjeh"]h$]h&]jjuh1hhjBhhhj/BhMlubj8)}(hT(struct zonelist *zonelist, enum zone_type highest_zoneidx, const nodemask_t *nodes)h](j>)}(hstruct zonelist *zonelisth](j)}(hjJ,h]hstruct}(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubj)}(h h]h }(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubh)}(hhh]j)}(hzonelisth]hzonelist}(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjBmodnameN classnameNjj)}j]j]Bc.first_zones_zonelistasbuh1hhjBubj)}(h h]h }(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubjr)}(hjuh]h*}(hjBhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjBubj)}(hzonelisth]hzonelist}(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjBubj>)}(henum zone_type highest_zoneidxh](j)}(hj#!h]henum}(hj ChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCubj)}(h h]h }(hjChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCubh)}(hhh]j)}(h zone_typeh]h zone_type}(hj*ChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj'Cubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj,CmodnameN classnameNjj)}j]j]Bc.first_zones_zonelistasbuh1hhjCubj)}(h h]h }(hjHChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCubj)}(hhighest_zoneidxh]hhighest_zoneidx}(hjVChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjBubj>)}(hconst nodemask_t *nodesh](j)}(hjh]hconst}(hjoChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjkCubj)}(h h]h }(hj|ChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjkCubh)}(hhh]j)}(h nodemask_th]h nodemask_t}(hjChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjCmodnameN classnameNjj)}j]j]Bc.first_zones_zonelistasbuh1hhjkCubj)}(h h]h }(hjChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjkCubjr)}(hjuh]h*}(hjChhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjkCubj)}(hnodesh]hnodes}(hjChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjkCubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjBubeh}(h]h ]h"]h$]h&]jjuh1j7hjBhhhj/BhMlubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjBhhhj/BhMlubah}(h]jBah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj/BhMlhjBhhubj4)}(hhh]jM)}(h\Returns the first zone at or below highest_zoneidx within the allowed nodemask in a zonelisth]h\Returns the first zone at or below highest_zoneidx within the allowed nodemask in a zonelist}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhMlhjChhubah}(h]h ]h"]h$]h&]uh1j3hjBhhhj/BhMlubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjDjHjDjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct zonelist *zonelist`` The zonelist to search for a suitable zone ``enum zone_type highest_zoneidx`` The zone index of the highest zone to return ``const nodemask_t *nodes`` An optional nodemask to filter the zonelist with **Description** This function returns the first zone at or below a given zone index that is within the allowed nodemask. The zoneref returned is a cursor that can be used to iterate the zonelist with next_zones_zonelist by advancing it by one before calling. When no eligible zone is found, zoneref->zone is NULL (zoneref itself is never NULL). This may happen either genuinely, or due to concurrent nodemask update due to cpuset modification. **Return** Zoneref pointer for the first suitable zone foundh](jM)}(h**Parameters**h]j)}(hjDh]h Parameters}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjDubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhMphj Dubj)}(hhh](j)}(hI``struct zonelist *zonelist`` The zonelist to search for a suitable zone h](j)}(h``struct zonelist *zonelist``h]jS)}(hj1Dh]hstruct zonelist *zonelist}(hj3DhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj/Dubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhMmhj+Dubj)}(hhh]jM)}(h*The zonelist to search for a suitable zoneh]h*The zonelist to search for a suitable zone}(hjJDhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjFDhMmhjGDubah}(h]h ]h"]h$]h&]uh1jhj+Dubeh}(h]h ]h"]h$]h&]uh1jhjFDhMmhj(Dubj)}(hP``enum zone_type highest_zoneidx`` The zone index of the highest zone to return h](j)}(h"``enum zone_type highest_zoneidx``h]jS)}(hjjDh]henum zone_type highest_zoneidx}(hjlDhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjhDubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhMnhjdDubj)}(hhh]jM)}(h,The zone index of the highest zone to returnh]h,The zone index of the highest zone to return}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjDhMnhjDubah}(h]h ]h"]h$]h&]uh1jhjdDubeh}(h]h ]h"]h$]h&]uh1jhjDhMnhj(Dubj)}(hM``const nodemask_t *nodes`` An optional nodemask to filter the zonelist with h](j)}(h``const nodemask_t *nodes``h]jS)}(hjDh]hconst nodemask_t *nodes}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjDubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhMohjDubj)}(hhh]jM)}(h0An optional nodemask to filter the zonelist withh]h0An optional nodemask to filter the zonelist with}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjDhMohjDubah}(h]h ]h"]h$]h&]uh1jhjDubeh}(h]h ]h"]h$]h&]uh1jhjDhMohj(Dubeh}(h]h ]h"]h$]h&]uh1jhj DubjM)}(h**Description**h]j)}(hjDh]h Description}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjDubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhMqhj DubjM)}(hThis function returns the first zone at or below a given zone index that is within the allowed nodemask. The zoneref returned is a cursor that can be used to iterate the zonelist with next_zones_zonelist by advancing it by one before calling.h]hThis function returns the first zone at or below a given zone index that is within the allowed nodemask. The zoneref returned is a cursor that can be used to iterate the zonelist with next_zones_zonelist by advancing it by one before calling.}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhMphj DubjM)}(hWhen no eligible zone is found, zoneref->zone is NULL (zoneref itself is never NULL). This may happen either genuinely, or due to concurrent nodemask update due to cpuset modification.h]hWhen no eligible zone is found, zoneref->zone is NULL (zoneref itself is never NULL). This may happen either genuinely, or due to concurrent nodemask update due to cpuset modification.}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhMuhj DubjM)}(h **Return**h]j)}(hjEh]hReturn}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjEubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhMyhj DubjM)}(h1Zoneref pointer for the first suitable zone foundh]h1Zoneref pointer for the first suitable zone found}(hj*EhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhMzhj Dubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h)for_each_zone_zonelist_nodemask (C macro)!c.for_each_zone_zonelist_nodemaskhNtauh1hhjKhhhNhNubh)}(hhh](h)}(hfor_each_zone_zonelist_nodemaskh]h)}(hfor_each_zone_zonelist_nodemaskh]h)}(hfor_each_zone_zonelist_nodemaskh]j)}(hjSEh]hfor_each_zone_zonelist_nodemask}(hj]EhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjYEubah}(h]h ](jjeh"]h$]h&]jjuh1hhjUEhhhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhMubah}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjQEhhhjpEhMubah}(h]jLEah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjpEhMhjNEhhubj4)}(hhh]h}(h]h ]h"]h$]h&]uh1j3hjNEhhhjpEhMubeh}(h]h ](jAmacroeh"]h$]h&]jFjAjGjEjHjEjIjJjKuh1hhhhjKhNhNubjM)}(hG``for_each_zone_zonelist_nodemask (zone, z, zlist, highidx, nodemask)``h]jS)}(hjEh]hCfor_each_zone_zonelist_nodemask (zone, z, zlist, highidx, nodemask)}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjEubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhMhjKhhubji)}(hlhelper macro to iterate over valid zones in a zonelist at or below a given zone index and within a nodemask h]jM)}(hkhelper macro to iterate over valid zones in a zonelist at or below a given zone index and within a nodemaskh]hkhelper macro to iterate over valid zones in a zonelist at or below a given zone index and within a nodemask}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhMhjEubah}(h]h ]h"]h$]h&]uh1jhhjEhMhjKhhubj)}(hX**Parameters** ``zone`` The current zone in the iterator ``z`` The current pointer within zonelist->_zonerefs being iterated ``zlist`` The zonelist being iterated ``highidx`` The zone index of the highest zone to return ``nodemask`` Nodemask allowed by the allocator **Description** This iterator iterates though all zones at or below a given zone index and within a given nodemaskh](jM)}(h**Parameters**h]j)}(hjEh]h Parameters}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjEubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhMhjEubj)}(hhh](j)}(h*``zone`` The current zone in the iterator h](j)}(h``zone``h]jS)}(hjEh]hzone}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjEubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhMhjEubj)}(hhh]jM)}(h The current zone in the iteratorh]h The current zone in the iterator}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjEhMhjEubah}(h]h ]h"]h$]h&]uh1jhjEubeh}(h]h ]h"]h$]h&]uh1jhjEhMhjEubj)}(hD``z`` The current pointer within zonelist->_zonerefs being iterated h](j)}(h``z``h]jS)}(hjFh]hz}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjFubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhMhjFubj)}(hhh]jM)}(h=The current pointer within zonelist->_zonerefs being iteratedh]h=The current pointer within zonelist->_zonerefs being iterated}(hj5FhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj1FhMhj2Fubah}(h]h ]h"]h$]h&]uh1jhjFubeh}(h]h ]h"]h$]h&]uh1jhj1FhMhjEubj)}(h&``zlist`` The zonelist being iterated h](j)}(h ``zlist``h]jS)}(hjUFh]hzlist}(hjWFhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjSFubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhMhjOFubj)}(hhh]jM)}(hThe zonelist being iteratedh]hThe zonelist being iterated}(hjnFhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjjFhMhjkFubah}(h]h ]h"]h$]h&]uh1jhjOFubeh}(h]h ]h"]h$]h&]uh1jhjjFhMhjEubj)}(h9``highidx`` The zone index of the highest zone to return h](j)}(h ``highidx``h]jS)}(hjFh]hhighidx}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjFubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhMhjFubj)}(hhh]jM)}(h,The zone index of the highest zone to returnh]h,The zone index of the highest zone to return}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjFhMhjFubah}(h]h ]h"]h$]h&]uh1jhjFubeh}(h]h ]h"]h$]h&]uh1jhjFhMhjEubj)}(h/``nodemask`` Nodemask allowed by the allocator h](j)}(h ``nodemask``h]jS)}(hjFh]hnodemask}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjFubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhMhjFubj)}(hhh]jM)}(h!Nodemask allowed by the allocatorh]h!Nodemask allowed by the allocator}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjFhMhjFubah}(h]h ]h"]h$]h&]uh1jhjFubeh}(h]h ]h"]h$]h&]uh1jhjFhMhjEubeh}(h]h ]h"]h$]h&]uh1jhjEubjM)}(h**Description**h]j)}(hjGh]h Description}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjGubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhMhjEubjM)}(hbThis iterator iterates though all zones at or below a given zone index and within a given nodemaskh]hbThis iterator iterates though all zones at or below a given zone index and within a given nodemask}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhMhjEubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h for_each_zone_zonelist (C macro)c.for_each_zone_zonelisthNtauh1hhjKhhhNhNubh)}(hhh](h)}(hfor_each_zone_zonelisth]h)}(hfor_each_zone_zonelisth]h)}(hfor_each_zone_zonelisth]j)}(hjAGh]hfor_each_zone_zonelist}(hjKGhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGGubah}(h]h ](jjeh"]h$]h&]jjuh1hhjCGhhhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhMubah}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj?Ghhhj^GhMubah}(h]j:Gah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj^GhMhjzones being iterated ``zlist`` The zonelist being iterated ``highidx`` The zone index of the highest zone to return **Description** This iterator iterates though all zones at or below a given zone index.h](jM)}(h**Parameters**h]j)}(hjGh]h Parameters}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjGubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhMhjGubj)}(hhh](j)}(h*``zone`` The current zone in the iterator h](j)}(h``zone``h]jS)}(hjGh]hzone}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjGubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhMhjGubj)}(hhh]jM)}(h The current zone in the iteratorh]h The current zone in the iterator}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjGhMhjGubah}(h]h ]h"]h$]h&]uh1jhjGubeh}(h]h ]h"]h$]h&]uh1jhjGhMhjGubj)}(h@``z`` The current pointer within zonelist->zones being iterated h](j)}(h``z``h]jS)}(hj Hh]hz}(hj HhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjHubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhMhjHubj)}(hhh]jM)}(h9The current pointer within zonelist->zones being iteratedh]h9The current pointer within zonelist->zones being iterated}(hj#HhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjHhMhj Hubah}(h]h ]h"]h$]h&]uh1jhjHubeh}(h]h ]h"]h$]h&]uh1jhjHhMhjGubj)}(h&``zlist`` The zonelist being iterated h](j)}(h ``zlist``h]jS)}(hjCHh]hzlist}(hjEHhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjAHubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhMhj=Hubj)}(hhh]jM)}(hThe zonelist being iteratedh]hThe zonelist being iterated}(hj\HhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjXHhMhjYHubah}(h]h ]h"]h$]h&]uh1jhj=Hubeh}(h]h ]h"]h$]h&]uh1jhjXHhMhjGubj)}(h9``highidx`` The zone index of the highest zone to return h](j)}(h ``highidx``h]jS)}(hj|Hh]hhighidx}(hj~HhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjzHubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhMhjvHubj)}(hhh]jM)}(h,The zone index of the highest zone to returnh]h,The zone index of the highest zone to return}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjHhMhjHubah}(h]h ]h"]h$]h&]uh1jhjvHubeh}(h]h ]h"]h$]h&]uh1jhjHhMhjGubeh}(h]h ]h"]h$]h&]uh1jhjGubjM)}(h**Description**h]j)}(hjHh]h Description}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjHubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhMhjGubjM)}(hGThis iterator iterates though all zones at or below a given zone index.h]hGThis iterator iterates though all zones at or below a given zone index.}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhMhjGubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hpfn_valid (C function) c.pfn_validhNtauh1hhjKhhhNhNubh)}(hhh](h)}(h!int pfn_valid (unsigned long pfn)h]h)}(h int pfn_valid(unsigned long pfn)h](j)}(hinth]hint}(hjHhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHhhhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhMubj)}(h h]h }(hj IhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHhhhj IhMubh)}(h pfn_validh]j)}(h pfn_validh]h pfn_valid}(hjIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIubah}(h]h ](jjeh"]h$]h&]jjuh1hhjHhhhj IhMubj8)}(h(unsigned long pfn)h]j>)}(hunsigned long pfnh](j)}(hunsignedh]hunsigned}(hj9IhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5Iubj)}(h h]h }(hjGIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5Iubj)}(hlongh]hlong}(hjUIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5Iubj)}(h h]h }(hjcIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5Iubj)}(hpfnh]hpfn}(hjqIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5Iubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj1Iubah}(h]h ]h"]h$]h&]jjuh1j7hjHhhhj IhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjHhhhj IhMubah}(h]jHah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj IhMhjHhhubj4)}(hhh]jM)}(h4check if there is a valid memory map entry for a PFNh]h4check if there is a valid memory map entry for a PFN}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhMhjIhhubah}(h]h ]h"]h$]h&]uh1j3hjHhhhj IhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjIjHjIjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``unsigned long pfn`` the page frame number to check **Description** Check if there is a valid memory map entry aka struct page for the **pfn**. Note, that availability of the memory map entry does not imply that there is actual usable memory at that **pfn**. The struct page may represent a hole or an unusable page frame. **Return** 1 for PFNs that have memory map entries and 0 otherwiseh](jM)}(h**Parameters**h]j)}(hjIh]h Parameters}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjIubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhMhjIubj)}(hhh]j)}(h5``unsigned long pfn`` the page frame number to check h](j)}(h``unsigned long pfn``h]jS)}(hjIh]hunsigned long pfn}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjIubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhMhjIubj)}(hhh]jM)}(hthe page frame number to checkh]hthe page frame number to check}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjIhMhjIubah}(h]h ]h"]h$]h&]uh1jhjIubeh}(h]h ]h"]h$]h&]uh1jhjIhMhjIubah}(h]h ]h"]h$]h&]uh1jhjIubjM)}(h**Description**h]j)}(hjJh]h Description}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjJubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhMhjIubjM)}(hCheck if there is a valid memory map entry aka struct page for the **pfn**. Note, that availability of the memory map entry does not imply that there is actual usable memory at that **pfn**. The struct page may represent a hole or an unusable page frame.h](hCCheck if there is a valid memory map entry aka struct page for the }(hj-JhhhNhNubj)}(h**pfn**h]hpfn}(hj5JhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj-Jubhl. Note, that availability of the memory map entry does not imply that there is actual usable memory at that }(hj-JhhhNhNubj)}(h**pfn**h]hpfn}(hjGJhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj-JubhA. The struct page may represent a hole or an unusable page frame.}(hj-JhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhMhjIubjM)}(h **Return**h]j)}(hjbJh]hReturn}(hjdJhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj`Jubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhMhjIubjM)}(h71 for PFNs that have memory map entries and 0 otherwiseh]h71 for PFNs that have memory map entries and 0 otherwise}(hjxJhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhW/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:122: ./include/linux/mmzone.hhMhjIubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfolio_mapping (C function)c.folio_mappinghNtauh1hhjKhhhNhNubh)}(hhh](h)}(h@struct address_space * folio_mapping (const struct folio *folio)h]h)}(h>struct address_space *folio_mapping(const struct folio *folio)h](j)}(hjJ,h]hstruct}(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJhhhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:123: ./mm/util.chMubj)}(h h]h }(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJhhhjJhMubh)}(hhh]j)}(h address_spaceh]h address_space}(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjJmodnameN classnameNjj)}j]j)}j folio_mappingsbc.folio_mappingasbuh1hhjJhhhjJhMubj)}(h h]h }(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJhhhjJhMubjr)}(hjuh]h*}(hjJhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjJhhhjJhMubh)}(h folio_mappingh]j)}(hjJh]h folio_mapping}(hjKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjKubah}(h]h ](jjeh"]h$]h&]jjuh1hhjJhhhjJhMubj8)}(h(const struct folio *folio)h]j>)}(hconst struct folio *folioh](j)}(hjh]hconst}(hj!KhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjKubj)}(h h]h }(hj.KhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjKubj)}(hjJ,h]hstruct}(hj)}(hstruct vm_area_struct *vmah](j)}(hjJ,h]hstruct}(hjLhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjLubj)}(h h]h }(hjLhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjLubh)}(hhh]j)}(hvm_area_structh]hvm_area_struct}(hjLhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjLubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjLmodnameN classnameNjj)}j]j)}jjLsbc.__anon_vma_prepareasbuh1hhjLubj)}(h h]h }(hjMhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjLubjr)}(hjuh]h*}(hjMhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjLubj)}(hvmah]hvma}(hj#MhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjLubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjLubah}(h]h ]h"]h$]h&]jjuh1j7hjLhhhjLhKubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjLhhhjLhKubah}(h]jLah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjLhKhjLhhubj4)}(hhh]jM)}(h%attach an anon_vma to a memory regionh]h%attach an anon_vma to a memory region}(hjMMhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chKhjJMhhubah}(h]h ]h"]h$]h&]uh1j3hjLhhhjLhKubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjeMjHjeMjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct vm_area_struct *vma`` the memory region in question **Description** This makes sure the memory mapping described by 'vma' has an 'anon_vma' attached to it, so that we can associate the anonymous pages mapped into it with that anon_vma. The common case will be that we already have one, which is handled inline by anon_vma_prepare(). But if not we either need to find an adjacent mapping that we can re-use the anon_vma from (very common when the only reason for splitting a vma has been mprotect()), or we allocate a new one. Anon-vma allocations are very subtle, because we may have optimistically looked up an anon_vma in folio_lock_anon_vma_read() and that may actually touch the rwsem even in the newly allocated vma (it depends on RCU to make sure that the anon_vma isn't actually destroyed). As a result, we need to do proper anon_vma locking even for the new allocation. At the same time, we do not want to do any locking for the common case of already having an anon_vma.h](jM)}(h**Parameters**h]j)}(hjoMh]h Parameters}(hjqMhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjmMubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chKhjiMubj)}(hhh]j)}(h=``struct vm_area_struct *vma`` the memory region in question h](j)}(h``struct vm_area_struct *vma``h]jS)}(hjMh]hstruct vm_area_struct *vma}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjMubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chKhjMubj)}(hhh]jM)}(hthe memory region in questionh]hthe memory region in question}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjMhKhjMubah}(h]h ]h"]h$]h&]uh1jhjMubeh}(h]h ]h"]h$]h&]uh1jhjMhKhjMubah}(h]h ]h"]h$]h&]uh1jhjiMubjM)}(h**Description**h]j)}(hjMh]h Description}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjMubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chKhjiMubjM)}(hThis makes sure the memory mapping described by 'vma' has an 'anon_vma' attached to it, so that we can associate the anonymous pages mapped into it with that anon_vma.h]hThis makes sure the memory mapping described by ‘vma’ has an ‘anon_vma’ attached to it, so that we can associate the anonymous pages mapped into it with that anon_vma.}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chKhjiMubjM)}(hX!The common case will be that we already have one, which is handled inline by anon_vma_prepare(). But if not we either need to find an adjacent mapping that we can re-use the anon_vma from (very common when the only reason for splitting a vma has been mprotect()), or we allocate a new one.h]hX!The common case will be that we already have one, which is handled inline by anon_vma_prepare(). But if not we either need to find an adjacent mapping that we can re-use the anon_vma from (very common when the only reason for splitting a vma has been mprotect()), or we allocate a new one.}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chKhjiMubjM)}(hXAnon-vma allocations are very subtle, because we may have optimistically looked up an anon_vma in folio_lock_anon_vma_read() and that may actually touch the rwsem even in the newly allocated vma (it depends on RCU to make sure that the anon_vma isn't actually destroyed).h]hXAnon-vma allocations are very subtle, because we may have optimistically looked up an anon_vma in folio_lock_anon_vma_read() and that may actually touch the rwsem even in the newly allocated vma (it depends on RCU to make sure that the anon_vma isn’t actually destroyed).}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chKhjiMubjM)}(hAs a result, we need to do proper anon_vma locking even for the new allocation. At the same time, we do not want to do any locking for the common case of already having an anon_vma.h]hAs a result, we need to do proper anon_vma locking even for the new allocation. At the same time, we do not want to do any locking for the common case of already having an anon_vma.}(hj NhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chKhjiMubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hanon_vma_clone (C function)c.anon_vma_clonehNtauh1hhjKhhhNhNubh)}(hhh](h)}(hiint anon_vma_clone (struct vm_area_struct *dst, struct vm_area_struct *src, enum vma_operation operation)h]h)}(hhint anon_vma_clone(struct vm_area_struct *dst, struct vm_area_struct *src, enum vma_operation operation)h](j)}(hinth]hint}(hj;NhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7NhhhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM'ubj)}(h h]h }(hjJNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7NhhhjINhM'ubh)}(hanon_vma_cloneh]j)}(hanon_vma_cloneh]hanon_vma_clone}(hj\NhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjXNubah}(h]h ](jjeh"]h$]h&]jjuh1hhj7NhhhjINhM'ubj8)}(hV(struct vm_area_struct *dst, struct vm_area_struct *src, enum vma_operation operation)h](j>)}(hstruct vm_area_struct *dsth](j)}(hjJ,h]hstruct}(hjxNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjtNubj)}(h h]h }(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjtNubh)}(hhh]j)}(hvm_area_structh]hvm_area_struct}(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjNmodnameN classnameNjj)}j]j)}jj^Nsbc.anon_vma_cloneasbuh1hhjtNubj)}(h h]h }(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjtNubjr)}(hjuh]h*}(hjNhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjtNubj)}(hdsth]hdst}(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjtNubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjpNubj>)}(hstruct vm_area_struct *srch](j)}(hjJ,h]hstruct}(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubj)}(h h]h }(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubh)}(hhh]j)}(hvm_area_structh]hvm_area_struct}(hjOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjOubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj OmodnameN classnameNjj)}j]jNc.anon_vma_cloneasbuh1hhjNubj)}(h h]h }(hj&OhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubjr)}(hjuh]h*}(hj4OhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjNubj)}(hsrch]hsrc}(hjAOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjpNubj>)}(henum vma_operation operationh](j)}(hj#!h]henum}(hjZOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVOubj)}(h h]h }(hjgOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVOubh)}(hhh]j)}(h vma_operationh]h vma_operation}(hjxOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjuOubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjzOmodnameN classnameNjj)}j]jNc.anon_vma_cloneasbuh1hhjVOubj)}(h h]h }(hjOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVOubj)}(h operationh]h operation}(hjOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVOubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjpNubeh}(h]h ]h"]h$]h&]jjuh1j7hj7NhhhjINhM'ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj3NhhhjINhM'ubah}(h]j.Nah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjINhM'hj0Nhhubj4)}(hhh]jM)}(hEstablishes new anon_vma_chain objects in **dst** linking to all of the anon_vma objects contained within **src** anon_vma_chain's.h](h*Establishes new anon_vma_chain objects in }(hjOhhhNhNubj)}(h**dst**h]hdst}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjOubh9 linking to all of the anon_vma objects contained within }(hjOhhhNhNubj)}(h**src**h]hsrc}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjOubh anon_vma_chain’s.}(hjOhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM'hjOhhubah}(h]h ]h"]h$]h&]uh1j3hj0NhhhjINhM'ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj PjHj PjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct vm_area_struct *dst`` The destination VMA with an empty anon_vma_chain. ``struct vm_area_struct *src`` The source VMA we wish to duplicate. ``enum vma_operation operation`` The type of operation which resulted in the clone. **Description** This is the heart of the VMA side of the anon_vma implementation - we invoke this function whenever we need to set up a new VMA's anon_vma state. This is invoked for: - VMA Merge, but only when **dst** is unfaulted and **src** is faulted - meaning we clone **src** into **dst**. - VMA split. - VMA (m)remap. - Fork of faulted VMA. In all cases other than fork this is simply a duplication. Fork additionally adds a new active anon_vma. ONLY in the case of fork do we try to 'reuse' existing anon_vma's in an anon_vma hierarchy, reusing anon_vma's which have no VMA associated with them but do have a single child. This is to avoid waste of memory when repeatedly forking. **Return** 0 on success, -ENOMEM on failure.h](jM)}(h**Parameters**h]j)}(hjPh]h Parameters}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjPubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM+hjPubj)}(hhh](j)}(hQ``struct vm_area_struct *dst`` The destination VMA with an empty anon_vma_chain. h](j)}(h``struct vm_area_struct *dst``h]jS)}(hj3Ph]hstruct vm_area_struct *dst}(hj5PhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj1Pubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM)hj-Pubj)}(hhh]jM)}(h1The destination VMA with an empty anon_vma_chain.h]h1The destination VMA with an empty anon_vma_chain.}(hjLPhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjHPhM)hjIPubah}(h]h ]h"]h$]h&]uh1jhj-Pubeh}(h]h ]h"]h$]h&]uh1jhjHPhM)hj*Pubj)}(hD``struct vm_area_struct *src`` The source VMA we wish to duplicate. h](j)}(h``struct vm_area_struct *src``h]jS)}(hjlPh]hstruct vm_area_struct *src}(hjnPhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjjPubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM*hjfPubj)}(hhh]jM)}(h$The source VMA we wish to duplicate.h]h$The source VMA we wish to duplicate.}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjPhM*hjPubah}(h]h ]h"]h$]h&]uh1jhjfPubeh}(h]h ]h"]h$]h&]uh1jhjPhM*hj*Pubj)}(hT``enum vma_operation operation`` The type of operation which resulted in the clone. h](j)}(h ``enum vma_operation operation``h]jS)}(hjPh]henum vma_operation operation}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjPubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM+hjPubj)}(hhh]jM)}(h2The type of operation which resulted in the clone.h]h2The type of operation which resulted in the clone.}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjPhM+hjPubah}(h]h ]h"]h$]h&]uh1jhjPubeh}(h]h ]h"]h$]h&]uh1jhjPhM+hj*Pubeh}(h]h ]h"]h$]h&]uh1jhjPubjM)}(h**Description**h]j)}(hjPh]h Description}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjPubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM-hjPubjM)}(hThis is the heart of the VMA side of the anon_vma implementation - we invoke this function whenever we need to set up a new VMA's anon_vma state.h]hThis is the heart of the VMA side of the anon_vma implementation - we invoke this function whenever we need to set up a new VMA’s anon_vma state.}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM,hjPubjM)}(hThis is invoked for:h]hThis is invoked for:}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM/hjPubj^)}(hhh](jc)}(hmVMA Merge, but only when **dst** is unfaulted and **src** is faulted - meaning we clone **src** into **dst**.h]jM)}(hmVMA Merge, but only when **dst** is unfaulted and **src** is faulted - meaning we clone **src** into **dst**.h](hVMA Merge, but only when }(hjQhhhNhNubj)}(h**dst**h]hdst}(hj#QhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjQubh is unfaulted and }(hjQhhhNhNubj)}(h**src**h]hsrc}(hj5QhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjQubh is faulted - meaning we clone }(hjQhhhNhNubj)}(h**src**h]hsrc}(hjGQhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjQubh into }(hjQhhhNhNubj)}(h**dst**h]hdst}(hjYQhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjQubh.}(hjQhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM1hjQubah}(h]h ]h"]h$]h&]uh1jbhjQubjc)}(h VMA split.h]jM)}(hjzQh]h VMA split.}(hj|QhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM3hjxQubah}(h]h ]h"]h$]h&]uh1jbhjQubjc)}(h VMA (m)remap.h]jM)}(hjQh]h VMA (m)remap.}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM4hjQubah}(h]h ]h"]h$]h&]uh1jbhjQubjc)}(hFork of faulted VMA. h]jM)}(hFork of faulted VMA.h]hFork of faulted VMA.}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM5hjQubah}(h]h ]h"]h$]h&]uh1jbhjQubeh}(h]h ]h"]h$]h&]jjuh1j]hjqQhM1hjPubjM)}(hhIn all cases other than fork this is simply a duplication. Fork additionally adds a new active anon_vma.h]hhIn all cases other than fork this is simply a duplication. Fork additionally adds a new active anon_vma.}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM7hjPubjM)}(hONLY in the case of fork do we try to 'reuse' existing anon_vma's in an anon_vma hierarchy, reusing anon_vma's which have no VMA associated with them but do have a single child. This is to avoid waste of memory when repeatedly forking.h]hONLY in the case of fork do we try to ‘reuse’ existing anon_vma’s in an anon_vma hierarchy, reusing anon_vma’s which have no VMA associated with them but do have a single child. This is to avoid waste of memory when repeatedly forking.}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM:hjPubjM)}(h **Return**h]j)}(hjQh]hReturn}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjQubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM?hjPubjM)}(h!0 on success, -ENOMEM on failure.h]h!0 on success, -ENOMEM on failure.}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM@hjPubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hunlink_anon_vmas (C function)c.unlink_anon_vmashNtauh1hhjKhhhNhNubh)}(hhh](h)}(h2void unlink_anon_vmas (struct vm_area_struct *vma)h]h)}(h1void unlink_anon_vmas(struct vm_area_struct *vma)h](j)}(hvoidh]hvoid}(hj,RhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(RhhhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMubj)}(h h]h }(hj;RhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(Rhhhj:RhMubh)}(hunlink_anon_vmash]j)}(hunlink_anon_vmash]hunlink_anon_vmas}(hjMRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIRubah}(h]h ](jjeh"]h$]h&]jjuh1hhj(Rhhhj:RhMubj8)}(h(struct vm_area_struct *vma)h]j>)}(hstruct vm_area_struct *vmah](j)}(hjJ,h]hstruct}(hjiRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeRubj)}(h h]h }(hjvRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeRubh)}(hhh]j)}(hvm_area_structh]hvm_area_struct}(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjRmodnameN classnameNjj)}j]j)}jjORsbc.unlink_anon_vmasasbuh1hhjeRubj)}(h h]h }(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeRubjr)}(hjuh]h*}(hjRhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjeRubj)}(hvmah]hvma}(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeRubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjaRubah}(h]h ]h"]h$]h&]jjuh1j7hj(Rhhhj:RhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj$Rhhhj:RhMubah}(h]jRah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj:RhMhj!Rhhubj4)}(hhh]jM)}(hNremove all links between a VMA and anon_vma's, freeing anon_vma_chain objects.h]hPremove all links between a VMA and anon_vma’s, freeing anon_vma_chain objects.}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhjRhhubah}(h]h ]h"]h$]h&]uh1j3hj!Rhhhj:RhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjSjHjSjIjJjKuh1hhhhjKhNhNubj)}(hXK**Parameters** ``struct vm_area_struct *vma`` The VMA whose links to anon_vma objects is to be severed. **Description** As part of the process anon_vma_chain's are freed, anon_vma->num_children,num_active_vmas is updated as required and, if the relevant anon_vma references no further VMAs, its reference count is decremented.h](jM)}(h**Parameters**h]j)}(hjSh]h Parameters}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1jhj Subah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhjSubj)}(hhh]j)}(hY``struct vm_area_struct *vma`` The VMA whose links to anon_vma objects is to be severed. h](j)}(h``struct vm_area_struct *vma``h]jS)}(hj-Sh]hstruct vm_area_struct *vma}(hj/ShhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj+Subah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhj'Subj)}(hhh]jM)}(h9The VMA whose links to anon_vma objects is to be severed.h]h9The VMA whose links to anon_vma objects is to be severed.}(hjFShhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjBShMhjCSubah}(h]h ]h"]h$]h&]uh1jhj'Subeh}(h]h ]h"]h$]h&]uh1jhjBShMhj$Subah}(h]h ]h"]h$]h&]uh1jhjSubjM)}(h**Description**h]j)}(hjhSh]h Description}(hjjShhhNhNubah}(h]h ]h"]h$]h&]uh1jhjfSubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhjSubjM)}(hAs part of the process anon_vma_chain's are freed, anon_vma->num_children,num_active_vmas is updated as required and, if the relevant anon_vma references no further VMAs, its reference count is decremented.h]hAs part of the process anon_vma_chain’s are freed, anon_vma->num_children,num_active_vmas is updated as required and, if the relevant anon_vma references no further VMAs, its reference count is decremented.}(hj~ShhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhjSubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h page_address_in_vma (C function)c.page_address_in_vmahNtauh1hhjKhhhNhNubh)}(hhh](h)}(hxunsigned long page_address_in_vma (const struct folio *folio, const struct page *page, const struct vm_area_struct *vma)h]h)}(hwunsigned long page_address_in_vma(const struct folio *folio, const struct page *page, const struct vm_area_struct *vma)h](j)}(hunsignedh]hunsigned}(hjShhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjShhhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMIubj)}(h h]h }(hjShhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjShhhjShMIubj)}(hlongh]hlong}(hjShhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjShhhjShMIubj)}(h h]h }(hjShhhNhNubah}(Ah]h ]jah"]h$]h&]uh1jhjShhhjShMIubh)}(hpage_address_in_vmah]j)}(hpage_address_in_vmah]hpage_address_in_vma}(hjShhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSubah}(h]h ](jjeh"]h$]h&]jjuh1hhjShhhjShMIubj8)}(hV(const struct folio *folio, const struct page *page, const struct vm_area_struct *vma)h](j>)}(hconst struct folio *folioh](j)}(hjh]hconst}(hjThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjTubj)}(h h]h }(hjThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjTubj)}(hjJ,h]hstruct}(hj!ThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjTubj)}(h h]h }(hj.ThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjTubh)}(hhh]j)}(hfolioh]hfolio}(hj?ThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)}(hconst struct page *pageh](j)}(hjh]hconst}(hjThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjTubj)}(h h]h }(hjThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjTubj)}(hjJ,h]hstruct}(hjThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjTubj)}(h h]h }(hjThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjTubh)}(hhh]j)}(hpageh]hpage}(hjThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjTubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjTmodnameN classnameNjj)}j]j[Tc.page_address_in_vmaasbuh1hhjTubj)}(h h]h }(hjThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjTubjr)}(hjuh]h*}(hjThhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjTubj)}(hpageh]hpage}(hjUhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjTubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjSubj>)}(h const struct vm_area_struct *vmah](j)}(hjh]hconst}(hjUhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjUubj)}(h h]h }(hj+UhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjUubj)}(hjJ,h]hstruct}(hj9UhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjUubj)}(h h]h }(hjFUhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjUubh)}(hhh]j)}(hvm_area_structh]hvm_area_struct}(hjWUhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjTUubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjYUmodnameN classnameNjj)}j]j[Tc.page_address_in_vmaasbuh1hhjUubj)}(h h]h }(hjuUhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjUubjr)}(hjuh]h*}(hjUhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjUubj)}(hvmah]hvma}(hjUhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjUubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjSubeh}(h]h ]h"]h$]h&]jjuh1j7hjShhhjShMIubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjShhhjShMIubah}(h]jSah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjShMIhjShhubj4)}(hhh]jM)}(h*The virtual address of a page in this VMA.h]h*The virtual address of a page in this VMA.}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMIhjUhhubah}(h]h ]h"]h$]h&]uh1j3hjShhhjShMIubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjUjHjUjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``const struct folio *folio`` The folio containing the page. ``const struct page *page`` The page within the folio. ``const struct vm_area_struct *vma`` The VMA we need to know the address in. **Description** Calculates the user virtual address of this page in the specified VMA. It is the caller's responsibility to check the page is actually within the VMA. There may not currently be a PTE pointing at this page, but if a page fault occurs at this address, this is the page which will be accessed. **Context** Caller should hold a reference to the folio. Caller should hold a lock (eg the i_mmap_lock or the mmap_lock) which keeps the VMA from being altered. **Return** The virtual address corresponding to this page in the VMA.h](jM)}(h**Parameters**h]j)}(hjUh]h Parameters}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjUubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMMhjUubj)}(hhh](j)}(h=``const struct folio *folio`` The folio containing the page. h](j)}(h``const struct folio *folio``h]jS)}(hjUh]hconst struct folio *folio}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjUubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMJhjUubj)}(hhh]jM)}(hThe folio containing the page.h]hThe folio containing the page.}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjVhMJhjVubah}(h]h ]h"]h$]h&]uh1jhjUubeh}(h]h ]h"]h$]h&]uh1jhjVhMJhjUubj)}(h7``const struct page *page`` The page within the folio. h](j)}(h``const struct page *page``h]jS)}(hj4Vh]hconst struct page *page}(hj6VhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj2Vubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMKhj.Vubj)}(hhh]jM)}(hThe page within the folio.h]hThe page within the folio.}(hjMVhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjIVhMKhjJVubah}(h]h ]h"]h$]h&]uh1jhj.Vubeh}(h]h ]h"]h$]h&]uh1jhjIVhMKhjUubj)}(hM``const struct vm_area_struct *vma`` The VMA we need to know the address in. h](j)}(h$``const struct vm_area_struct *vma``h]jS)}(hjmVh]h const struct vm_area_struct *vma}(hjoVhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjkVubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMLhjgVubj)}(hhh]jM)}(h'The VMA we need to know the address in.h]h'The VMA we need to know the address in.}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjVhMLhjVubah}(h]h ]h"]h$]h&]uh1jhjgVubeh}(h]h ]h"]h$]h&]uh1jhjVhMLhjUubeh}(h]h ]h"]h$]h&]uh1jhjUubjM)}(h**Description**h]j)}(hjVh]h Description}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjVubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMNhjUubjM)}(hX$Calculates the user virtual address of this page in the specified VMA. It is the caller's responsibility to check the page is actually within the VMA. There may not currently be a PTE pointing at this page, but if a page fault occurs at this address, this is the page which will be accessed.h]hX&Calculates the user virtual address of this page in the specified VMA. It is the caller’s responsibility to check the page is actually within the VMA. There may not currently be a PTE pointing at this page, but if a page fault occurs at this address, this is the page which will be accessed.}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMMhjUubjM)}(h **Context**h]j)}(hjVh]hContext}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjVubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMShjUubjM)}(hCaller should hold a reference to the folio. Caller should hold a lock (eg the i_mmap_lock or the mmap_lock) which keeps the VMA from being altered.h]hCaller should hold a reference to the folio. Caller should hold a lock (eg the i_mmap_lock or the mmap_lock) which keeps the VMA from being altered.}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMThjUubjM)}(h **Return**h]j)}(hjVh]hReturn}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjVubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMXhjUubjM)}(h:The virtual address corresponding to this page in the VMA.h]h:The virtual address corresponding to this page in the VMA.}(hj WhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMXhjUubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfolio_referenced (C function)c.folio_referencedhNtauh1hhjKhhhNhNubh)}(hhh](h)}(hkint folio_referenced (struct folio *folio, int is_locked, struct mem_cgroup *memcg, vma_flags_t *vma_flags)h]h)}(hjint folio_referenced(struct folio *folio, int is_locked, struct mem_cgroup *memcg, vma_flags_t *vma_flags)h](j)}(hinth]hint}(hj;WhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7WhhhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM#ubj)}(h h]h }(hjJWhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7WhhhjIWhM#ubh)}(hfolio_referencedh]j)}(hfolio_referencedh]hfolio_referenced}(hj\WhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjXWubah}(h]h ](jjeh"]h$]h&]jjuh1hhj7WhhhjIWhM#ubj8)}(hV(struct folio *folio, int is_locked, struct mem_cgroup *memcg, vma_flags_t *vma_flags)h](j>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hjxWhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjtWubj)}(h h]h }(hjWhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjtWubh)}(hhh]j)}(hfolioh]hfolio}(hjWhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjWubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjWmodnameN classnameNjj)}j]j)}jj^Wsbc.folio_referencedasbuh1hhjtWubj)}(h h]h }(hjWhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjtWubjr)}(hjuh]h*}(hjWhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjtWubj)}(hfolioh]hfolio}(hjWhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjtWubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjpWubj>)}(h int is_lockedh](j)}(hinth]hint}(hjWhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjWubj)}(h h]h }(hjWhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjWubj)}(h is_lockedh]h is_locked}(hjXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjWubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjpWubj>)}(hstruct mem_cgroup *memcgh](j)}(hjJ,h]hstruct}(hjXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjXubj)}(h h]h }(hj,XhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjXubh)}(hhh]j)}(h mem_cgrouph]h mem_cgroup}(hj=XhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:Xubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj?XmodnameN classnameNjj)}j]jWc.folio_referencedasbuh1hhjXubj)}(h h]h }(hj[XhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjXubjr)}(hjuh]h*}(hjiXhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjXubj)}(hmemcgh]hmemcg}(hjvXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjXubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjpWubj>)}(hvma_flags_t *vma_flagsh](h)}(hhh]j)}(h vma_flags_th]h vma_flags_t}(hjXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjXubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjXmodnameN classnameNjj)}j]jWc.folio_referencedasbuh1hhjXubj)}(h h]h }(hjXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjXubjr)}(hjuh]h*}(hjXhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjXubj)}(h vma_flagsh]h vma_flags}(hjXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjXubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjpWubeh}(h]h ]h"]h$]h&]jjuh1j7hj7WhhhjIWhM#ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj3WhhhjIWhM#ubah}(h]j.Wah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjIWhM#hj0Whhubj4)}(hhh]jM)}(h!Test if the folio was referenced.h]h!Test if the folio was referenced.}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM#hjXhhubah}(h]h ]h"]h$]h&]uh1j3hj0WhhhjIWhM#ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj YjHj YjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct folio *folio`` The folio to test. ``int is_locked`` Caller holds lock on the folio. ``struct mem_cgroup *memcg`` target memory cgroup ``vma_flags_t *vma_flags`` A combination of all the vma->flags which referenced the folio. **Description** Quick test_and_clear_referenced for all mappings of a folio, **Return** The number of mappings which referenced the folio. Return -1 if the function bailed out due to rmap lock contention.h](jM)}(h**Parameters**h]j)}(hjYh]h Parameters}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjYubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM'hjYubj)}(hhh](j)}(h+``struct folio *folio`` The folio to test. h](j)}(h``struct folio *folio``h]jS)}(hj6Yh]hstruct folio *folio}(hj8YhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj4Yubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM$hj0Yubj)}(hhh]jM)}(hThe folio to test.h]hThe folio to test.}(hjOYhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjKYhM$hjLYubah}(h]h ]h"]h$]h&]uh1jhj0Yubeh}(h]h ]h"]h$]h&]uh1jhjKYhM$hj-Yubj)}(h2``int is_locked`` Caller holds lock on the folio. h](j)}(h``int is_locked``h]jS)}(hjoYh]h int is_locked}(hjqYhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjmYubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM%hjiYubj)}(hhh]jM)}(hCaller holds lock on the folio.h]hCaller holds lock on the folio.}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjYhM%hjYubah}(h]h ]h"]h$]h&]uh1jhjiYubeh}(h]h ]h"]h$]h&]uh1jhjYhM%hj-Yubj)}(h2``struct mem_cgroup *memcg`` target memory cgroup h](j)}(h``struct mem_cgroup *memcg``h]jS)}(hjYh]hstruct mem_cgroup *memcg}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjYubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM&hjYubj)}(hhh]jM)}(htarget memory cgrouph]htarget memory cgroup}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjYhM&hjYubah}(h]h ]h"]h$]h&]uh1jhjYubeh}(h]h ]h"]h$]h&]uh1jhjYhM&hj-Yubj)}(h[``vma_flags_t *vma_flags`` A combination of all the vma->flags which referenced the folio. h](j)}(h``vma_flags_t *vma_flags``h]jS)}(hjYh]hvma_flags_t *vma_flags}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjYubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM'hjYubj)}(hhh]jM)}(h?A combination of all the vma->flags which referenced the folio.h]h?A combination of all the vma->flags which referenced the folio.}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjYhM'hjYubah}(h]h ]h"]h$]h&]uh1jhjYubeh}(h]h ]h"]h$]h&]uh1jhjYhM'hj-Yubeh}(h]h ]h"]h$]h&]uh1jhjYubjM)}(h**Description**h]j)}(hjZh]h Description}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjZubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM)hjYubjM)}(h)}(hstruct address_space *mappingh](j)}(hjJ,h]hstruct}(hjZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZubj)}(h h]h }(hjZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZubh)}(hhh]j)}(h address_spaceh]h address_space}(hjZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjZmodnameN classnameNjj)}j]j)}jjZsbc.mapping_wrprotect_rangeasbuh1hhjZubj)}(h h]h }(hj[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZubjr)}(hjuh]h*}(hj[hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjZubj)}(hmappingh]hmapping}(hj[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjZubj>)}(h pgoff_t pgoffh](h)}(hhh]j)}(hpgoff_th]hpgoff_t}(hj:[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7[ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj<[modnameN classnameNjj)}j]jZc.mapping_wrprotect_rangeasbuh1hhj3[ubj)}(h h]h }(hjX[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3[ubj)}(hpgoffh]hpgoff}(hjf[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3[ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjZubj>)}(hunsigned long pfnh](j)}(hunsignedh]hunsigned}(hj[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{[ubj)}(h h]h }(hj[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{[ubj)}(hlongh]hlong}(hj[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{[ubj)}(h h]h }(hj[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{[ubj)}(hpfnh]hpfn}(hj[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{[ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjZubj>)}(hunsigned long nr_pagesh](j)}(hunsignedh]hunsigned}(hj[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj[ubj)}(h h]h }(hj[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj[ubj)}(hlongh]hlong}(hj[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj[ubj)}(h h]h }(hj[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj[ubj)}(hnr_pagesh]hnr_pages}(hj\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj[ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjZubeh}(h]h ]h"]h$]h&]jjuh1j7hjZhhhjZhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjZhhhjZhMubah}(h]j{Zah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjZhMhj}Zhhubj4)}(hhh]jM)}(h0Write-protect all mappings in a specified range.h]h0Write-protect all mappings in a specified range.}(hj2\hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhj/\hhubah}(h]h ]h"]h$]h&]uh1j3hj}ZhhhjZhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjJ\jHjJ\jIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct address_space *mapping`` The mapping whose reverse mapping should be traversed. ``pgoff_t pgoff`` The page offset at which **pfn** is mapped within **mapping**. ``unsigned long pfn`` The PFN of the page mapped in **mapping** at **pgoff**. ``unsigned long nr_pages`` The number of physically contiguous base pages spanned. **Description** Traverses the reverse mapping, finding all VMAs which contain a shared mapping of the pages in the specified range in **mapping**, and write-protects them (that is, updates the page tables to mark the mappings read-only such that a write protection fault arises when the mappings are written to). The **pfn** value need not refer to a folio, but rather can reference a kernel allocation which is mapped into userland. We therefore do not require that the page maps to a folio with a valid mapping or index field, rather the caller specifies these in **mapping** and **pgoff**. **Return** the number of write-protected PTEs, or an error.h](jM)}(h**Parameters**h]j)}(hjT\h]h Parameters}(hjV\hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjR\ubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhjN\ubj)}(hhh](j)}(hY``struct address_space *mapping`` The mapping whose reverse mapping should be traversed. h](j)}(h!``struct address_space *mapping``h]jS)}(hjs\h]hstruct address_space *mapping}(hju\hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjq\ubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhjm\ubj)}(hhh]jM)}(h6The mapping whose reverse mapping should be traversed.h]h6The mapping whose reverse mapping should be traversed.}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj\hMhj\ubah}(h]h ]h"]h$]h&]uh1jhjm\ubeh}(h]h ]h"]h$]h&]uh1jhj\hMhjj\ubj)}(hQ``pgoff_t pgoff`` The page offset at which **pfn** is mapped within **mapping**. h](j)}(h``pgoff_t pgoff``h]jS)}(hj\h]h pgoff_t pgoff}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj\ubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhj\ubj)}(hhh]jM)}(h>The page offset at which **pfn** is mapped within **mapping**.h](hThe page offset at which }(hj\hhhNhNubj)}(h**pfn**h]hpfn}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj\ubh is mapped within }(hj\hhhNhNubj)}(h **mapping**h]hmapping}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj\ubh.}(hj\hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhj\hMhj\ubah}(h]h ]h"]h$]h&]uh1jhj\ubeh}(h]h ]h"]h$]h&]uh1jhj\hMhjj\ubj)}(hN``unsigned long pfn`` The PFN of the page mapped in **mapping** at **pgoff**. h](j)}(h``unsigned long pfn``h]jS)}(hj ]h]hunsigned long pfn}(hj ]hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj]ubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhj]ubj)}(hhh]jM)}(h7The PFN of the page mapped in **mapping** at **pgoff**.h](hThe PFN of the page mapped in }(hj"]hhhNhNubj)}(h **mapping**h]hmapping}(hj*]hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj"]ubh at }(hj"]hhhNhNubj)}(h **pgoff**h]hpgoff}(hj<]hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj"]ubh.}(hj"]hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhj]hMhj]ubah}(h]h ]h"]h$]h&]uh1jhj]ubeh}(h]h ]h"]h$]h&]uh1jhj]hMhjj\ubj)}(hS``unsigned long nr_pages`` The number of physically contiguous base pages spanned. h](j)}(h``unsigned long nr_pages``h]jS)}(hjf]h]hunsigned long nr_pages}(hjh]hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjd]ubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhj`]ubj)}(hhh]jM)}(h7The number of physically contiguous base pages spanned.h]h7The number of physically contiguous base pages spanned.}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj{]hMhj|]ubah}(h]h ]h"]h$]h&]uh1jhj`]ubeh}(h]h ]h"]h$]h&]uh1jhj{]hMhjj\ubeh}(h]h ]h"]h$]h&]uh1jhjN\ubjM)}(h**Description**h]j)}(hj]h]h Description}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj]ubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhjN\ubjM)}(hX(Traverses the reverse mapping, finding all VMAs which contain a shared mapping of the pages in the specified range in **mapping**, and write-protects them (that is, updates the page tables to mark the mappings read-only such that a write protection fault arises when the mappings are written to).h](hvTraverses the reverse mapping, finding all VMAs which contain a shared mapping of the pages in the specified range in }(hj]hhhNhNubj)}(h **mapping**h]hmapping}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj]ubh, and write-protects them (that is, updates the page tables to mark the mappings read-only such that a write protection fault arises when the mappings are written to).}(hj]hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhjN\ubjM)}(hXThe **pfn** value need not refer to a folio, but rather can reference a kernel allocation which is mapped into userland. We therefore do not require that the page maps to a folio with a valid mapping or index field, rather the caller specifies these in **mapping** and **pgoff**.h](hThe }(hj]hhhNhNubj)}(h**pfn**h]hpfn}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj]ubh value need not refer to a folio, but rather can reference a kernel allocation which is mapped into userland. We therefore do not require that the page maps to a folio with a valid mapping or index field, rather the caller specifies these in }(hj]hhhNhNubj)}(h **mapping**h]hmapping}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj]ubh and }(hj]hhhNhNubj)}(h **pgoff**h]hpgoff}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj]ubh.}(hj]hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhjN\ubjM)}(h **Return**h]j)}(hj^h]hReturn}(hj!^hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj^ubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhjN\ubjM)}(h0the number of write-protected PTEs, or an error.h]h0the number of write-protected PTEs, or an error.}(hj5^hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhjN\ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hpfn_mkclean_range (C function)c.pfn_mkclean_rangehNtauh1hhjKhhhNhNubh)}(hhh](h)}(hlint pfn_mkclean_range (unsigned long pfn, unsigned long nr_pages, pgoff_t pgoff, struct vm_area_struct *vma)h]h)}(hkint pfn_mkclean_range(unsigned long pfn, unsigned long nr_pages, pgoff_t pgoff, struct vm_area_struct *vma)h](j)}(hinth]hint}(hjd^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj`^hhhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMubj)}(h h]h }(hjs^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj`^hhhjr^hMubh)}(hpfn_mkclean_rangeh]j)}(hpfn_mkclean_rangeh]hpfn_mkclean_range}(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj`^hhhjr^hMubj8)}(hV(unsigned long pfn, unsigned long nr_pages, pgoff_t pgoff, struct vm_area_struct *vma)h](j>)}(hunsigned long pfnh](j)}(hunsignedh]hunsigned}(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^ubj)}(h h]h }(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^ubj)}(hlongh]hlong}(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^ubj)}(h h]h }(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^ubj)}(hpfnh]hpfn}(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj^ubj>)}(hunsigned long nr_pagesh](j)}(hunsignedh]hunsigned}(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^ubj)}(h h]h }(hj_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^ubj)}(hlongh]hlong}(hj_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^ubj)}(h h]h }(hj_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^ubj)}(hnr_pagesh]hnr_pages}(hj*_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj^ubj>)}(h pgoff_t pgoffh](h)}(hhh]j)}(hpgoff_th]hpgoff_t}(hjF_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjC_ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjH_modnameN classnameNjj)}j]j)}jj^sbc.pfn_mkclean_rangeasbuh1hhj?_ubj)}(h h]h }(hjf_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?_ubj)}(hpgoffh]hpgoff}(hjt_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?_ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj^ubj>)}(hstruct vm_area_struct *vmah](j)}(hjJ,h]hstruct}(hj_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj_ubj)}(h h]h }(hj_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj_ubh)}(hhh]j)}(hvm_area_structh]hvm_area_struct}(hj_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj_ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj_modnameN classnameNjj)}j]jb_c.pfn_mkclean_rangeasbuh1hhj_ubj)}(h h]h }(hj_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj_ubjr)}(hjuh]h*}(hj_hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj_ubj)}(hvmah]hvma}(hj_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj_ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj^ubeh}(h]h ]h"]h$]h&]jjuh1j7hj`^hhhjr^hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj\^hhhjr^hMubah}(h]jW^ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjr^hMhjY^hhubj4)}(hhh]jM)}(hCleans the PTEs (including PMDs) mapped with range of [**pfn**, **pfn** + **nr_pages**) at the specific offset (**pgoff**) within the **vma** of shared mappings. And since clean PTEs should also be readonly, write protects them too.h](h7Cleans the PTEs (including PMDs) mapped with range of [}(hj`hhhNhNubj)}(h**pfn**h]hpfn}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj`ubh, }(hj`hhhNhNubj)}(h**pfn**h]hpfn}(hj(`hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj`ubh + }(hj`hhhNhNubj)}(h **nr_pages**h]hnr_pages}(hj:`hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj`ubh) at the specific offset (}(hj`hhhNhNubj)}(h **pgoff**h]hpgoff}(hjL`hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj`ubh ) within the }(hj`hhhNhNubj)}(h**vma**h]hvma}(hj^`hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj`ubh[ of shared mappings. And since clean PTEs should also be readonly, write protects them too.}(hj`hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhj `hhubah}(h]h ]h"]h$]h&]uh1j3hjY^hhhjr^hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj`jHj`jIjJjKuh1hhhhjKhNhNubj)}(hXU**Parameters** ``unsigned long pfn`` start pfn. ``unsigned long nr_pages`` number of physically contiguous pages srarting with **pfn**. ``pgoff_t pgoff`` page offset that the **pfn** mapped with. ``struct vm_area_struct *vma`` vma that **pfn** mapped within. **Description** Returns the number of cleaned PTEs (including PMDs).h](jM)}(h**Parameters**h]j)}(hj`h]h Parameters}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj`ubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhj`ubj)}(hhh](j)}(h!``unsigned long pfn`` start pfn. h](j)}(h``unsigned long pfn``h]jS)}(hj`h]hunsigned long pfn}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj`ubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhj`ubj)}(hhh]jM)}(h start pfn.h]h start pfn.}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj`hMhj`ubah}(h]h ]h"]h$]h&]uh1jhj`ubeh}(h]h ]h"]h$]h&]uh1jhj`hMhj`ubj)}(hX``unsigned long nr_pages`` number of physically contiguous pages srarting with **pfn**. h](j)}(h``unsigned long nr_pages``h]jS)}(hj`h]hunsigned long nr_pages}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj`ubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhj`ubj)}(hhh]jM)}(h)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hjGbhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCbubj)}(h h]h }(hjTbhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCbubh)}(hhh]j)}(hfolioh]hfolio}(hjebhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjbbubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjgbmodnameN classnameNjj)}j]j)}jj-bsbc.folio_move_anon_rmapasbuh1hhjCbubj)}(h h]h }(hjbhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCbubjr)}(hjuh]h*}(hjbhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjCbubj)}(hfolioh]hfolio}(hjbhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCbubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj?bubj>)}(hstruct vm_area_struct *vmah](j)}(hjJ,h]hstruct}(hjbhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjbubj)}(h h]h }(hjbhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjbubh)}(hhh]j)}(hvm_area_structh]hvm_area_struct}(hjbhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjbubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjbmodnameN classnameNjj)}j]jbc.folio_move_anon_rmapasbuh1hhjbubj)}(h h]h }(hjbhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjbubjr)}(hjuh]h*}(hjchhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjbubj)}(hvmah]hvma}(hjchhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjbubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj?bubeh}(h]h ]h"]h$]h&]jjuh1j7hjbhhhjbhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjbhhhjbhMubah}(h]jaah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjbhMhjahhubj4)}(hhh]jM)}(hmove a folio to our anon_vmah]hmove a folio to our anon_vma}(hj:chhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhj7chhubah}(h]h ]h"]h$]h&]uh1j3hjahhhjbhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjRcjHjRcjIjJjKuh1hhhhjKhNhNubj)}(hXn**Parameters** ``struct folio *folio`` The folio to move to our anon_vma ``struct vm_area_struct *vma`` The vma the folio belongs to **Description** When a folio belongs exclusively to one process after a COW event, that folio can be moved into the anon_vma that belongs to just that process, so the rmap code will not search the parent or sibling processes.h](jM)}(h**Parameters**h]j)}(hj\ch]h Parameters}(hj^chhhNhNubah}(h]h ]h"]h$]h&]uh1jhjZcubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhjVcubj)}(hhh](j)}(h:``struct folio *folio`` The folio to move to our anon_vma h](j)}(h``struct folio *folio``h]jS)}(hj{ch]hstruct folio *folio}(hj}chhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjycubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhjucubj)}(hhh]jM)}(h!The folio to move to our anon_vmah]h!The folio to move to our anon_vma}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjchMhjcubah}(h]h ]h"]h$]h&]uh1jhjucubeh}(h]h ]h"]h$]h&]uh1jhjchMhjrcubj)}(h<``struct vm_area_struct *vma`` The vma the folio belongs to h](j)}(h``struct vm_area_struct *vma``h]jS)}(hjch]hstruct vm_area_struct *vma}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjcubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhjcubj)}(hhh]jM)}(hThe vma the folio belongs toh]hThe vma the folio belongs to}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjchMhjcubah}(h]h ]h"]h$]h&]uh1jhjcubeh}(h]h ]h"]h$]h&]uh1jhjchMhjrcubeh}(h]h ]h"]h$]h&]uh1jhjVcubjM)}(h**Description**h]j)}(hjch]h Description}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jhjcubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhjVcubjM)}(hWhen a folio belongs exclusively to one process after a COW event, that folio can be moved into the anon_vma that belongs to just that process, so the rmap code will not search the parent or sibling processes.h]hWhen a folio belongs exclusively to one process after a COW event, that folio can be moved into the anon_vma that belongs to just that process, so the rmap code will not search the parent or sibling processes.}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhjVcubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h__folio_set_anon (C function)c.__folio_set_anonhNtauh1hhjKhhhNhNubh)}(hhh](h)}(hnvoid __folio_set_anon (struct folio *folio, struct vm_area_struct *vma, unsigned long address, bool exclusive)h]h)}(hmvoid __folio_set_anon(struct folio *folio, struct vm_area_struct *vma, unsigned long address, bool exclusive)h](j)}(hvoidh]hvoid}(hj4dhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0dhhhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMubj)}(h h]h }(hjCdhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0dhhhjBdhMubh)}(h__folio_set_anonh]j)}(h__folio_set_anonh]h__folio_set_anon}(hjUdhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjQdubah}(h]h ](jjeh"]h$]h&]jjuh1hhj0dhhhjBdhMubj8)}(hX(struct folio *folio, struct vm_area_struct *vma, unsigned long address, bool exclusive)h](j>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hjqdhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmdubj)}(h h]h }(hj~dhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmdubh)}(hhh]j)}(hfolioh]hfolio}(hjdhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjdubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjdmodnameN classnameNjj)}j]j)}jjWdsbc.__folio_set_anonasbuh1hhjmdubj)}(h h]h }(hjdhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmdubjr)}(hjuh]h*}(hjdhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjmdubj)}(hfolioh]hfolio}(hjdhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmdubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjidubj>)}(hstruct vm_area_struct *vmah](j)}(hjJ,h]hstruct}(hjdhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjdubj)}(h h]h }(hjdhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjdubh)}(hhh]j)}(hvm_area_structh]hvm_area_struct}(hjehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjdubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjemodnameN classnameNjj)}j]jdc.__folio_set_anonasbuh1hhjdubj)}(h h]h }(hjehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjdubjr)}(hjuh]h*}(hj-ehhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjdubj)}(hvmah]hvma}(hj:ehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjdubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjidubj>)}(hunsigned long addressh](j)}(hunsignedh]hunsigned}(hjSehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjOeubj)}(h h]h }(hjaehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjOeubj)}(hlongh]hlong}(hjoehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjOeubj)}(h h]h }(hj}ehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjOeubj)}(haddressh]haddress}(hjehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjOeubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjidubj>)}(hbool exclusiveh](j)}(hjh]hbool}(hjehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubj)}(h h]h }(hjehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubj)}(h exclusiveh]h exclusive}(hjehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjidubeh}(h]h ]h"]h$]h&]jjuh1j7hj0dhhhjBdhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj,dhhhjBdhMubah}(h]j'dah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjBdhMhj)dhhubj4)}(hhh]jM)}(h'set up a new anonymous rmap for a folioh]h'set up a new anonymous rmap for a folio}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhjehhubah}(h]h ]h"]h$]h&]uh1j3hj)dhhhjBdhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjfjHjfjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct folio *folio`` The folio to set up the new anonymous rmap for. ``struct vm_area_struct *vma`` VM area to add the folio to. ``unsigned long address`` User virtual address of the mapping ``bool exclusive`` Whether the folio is exclusive to the process.h](jM)}(h**Parameters**h]j)}(hj fh]h Parameters}(hj fhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj fubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhjfubj)}(hhh](j)}(hH``struct folio *folio`` The folio to set up the new anonymous rmap for. h](j)}(h``struct folio *folio``h]jS)}(hj*fh]hstruct folio *folio}(hj,fhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj(fubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhj$fubj)}(hhh]jM)}(h/The folio to set up the new anonymous rmap for.h]h/The folio to set up the new anonymous rmap for.}(hjCfhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj?fhMhj@fubah}(h]h ]h"]h$]h&]uh1jhj$fubeh}(h]h ]h"]h$]h&]uh1jhj?fhMhj!fubj)}(h<``struct vm_area_struct *vma`` VM area to add the folio to. h](j)}(h``struct vm_area_struct *vma``h]jS)}(hjcfh]hstruct vm_area_struct *vma}(hjefhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjafubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhj]fubj)}(hhh]jM)}(hVM area to add the folio to.h]hVM area to add the folio to.}(hj|fhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjxfhMhjyfubah}(h]h ]h"]h$]h&]uh1jhj]fubeh}(h]h ]h"]h$]h&]uh1jhjxfhMhj!fubj)}(h>``unsigned long address`` User virtual address of the mapping h](j)}(h``unsigned long address``h]jS)}(hjfh]hunsigned long address}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjfubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhjfubj)}(hhh]jM)}(h#User virtual address of the mappingh]h#User virtual address of the mapping}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjfhMhjfubah}(h]h ]h"]h$]h&]uh1jhjfubeh}(h]h ]h"]h$]h&]uh1jhjfhMhj!fubj)}(hA``bool exclusive`` Whether the folio is exclusive to the process.h](j)}(h``bool exclusive``h]jS)}(hjfh]hbool exclusive}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjfubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhjfubj)}(hhh]jM)}(h.Whether the folio is exclusive to the process.h]h.Whether the folio is exclusive to the process.}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhjfubah}(h]h ]h"]h$]h&]uh1jhjfubeh}(h]h ]h"]h$]h&]uh1jhjfhMhj!fubeh}(h]h ]h"]h$]h&]uh1jhjfubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h#__page_check_anon_rmap (C function)c.__page_check_anon_rmaphNtauh1hhjKhhhNhNubh)}(hhh](h)}(hvoid __page_check_anon_rmap (const struct folio *folio, const struct page *page, struct vm_area_struct *vma, unsigned long address)h]h)}(hvoid __page_check_anon_rmap(const struct folio *folio, const struct page *page, struct vm_area_struct *vma, unsigned long address)h](j)}(hvoidh]hvoid}(hj/ghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ghhhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMubj)}(h h]h }(hj>ghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ghhhj=ghMubh)}(h__page_check_anon_rmaph]j)}(h__page_check_anon_rmaph]h__page_check_anon_rmap}(hjPghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjLgubah}(h]h ](jjeh"]h$]h&]jjuh1hhj+ghhhj=ghMubj8)}(hg(const struct folio *folio, const struct page *page, struct vm_area_struct *vma, unsigned long address)h](j>)}(hconst struct folio *folioh](j)}(hjh]hconst}(hjlghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhgubj)}(h h]h }(hjyghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhgubj)}(hjJ,h]hstruct}(hjghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhgubj)}(h h]h }(hjghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhgubh)}(hhh]j)}(hfolioh]hfolio}(hjghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjgmodnameN classnameNjj)}j]j)}jjRgsbc.__page_check_anon_rmapasbuh1hhjhgubj)}(h h]h }(hjghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhgubjr)}(hjuh]h*}(hjghhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjhgubj)}(hfolioh]hfolio}(hjghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhgubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjdgubj>)}(hconst struct page *pageh](j)}(hjh]hconst}(hjghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubj)}(h h]h }(hjhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubj)}(hjJ,h]hstruct}(hjhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubj)}(h h]h }(hj!hhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubh)}(hhh]j)}(hpageh]hpage}(hj2hhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/hubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj4hmodnameN classnameNjj)}j]jgc.__page_check_anon_rmapasbuh1hhjgubj)}(h h]h }(hjPhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubjr)}(hjuh]h*}(hj^hhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjgubj)}(hpageh]hpage}(hjkhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjdgubj>)}(hstruct vm_area_struct *vmah](j)}(hjJ,h]hstruct}(hjhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhubj)}(h h]h }(hjhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhubh)}(hhh]j)}(hvm_area_structh]hvm_area_struct}(hjhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjhmodnameN classnameNjj)}j]jgc.__page_check_anon_rmapasbuh1hhjhubj)}(h h]h }(hjhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhubjr)}(hjuh]h*}(hjhhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjhubj)}(hvmah]hvma}(hjhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjdgubj>)}(hunsigned long addressh](j)}(hunsignedh]hunsigned}(hjhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhubj)}(h h]h }(hjihhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhubj)}(hlongh]hlong}(hjihhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhubj)}(h h]h }(hjihhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhubj)}(haddressh]haddress}(hj,ihhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjdgubeh}(h]h ]h"]h$]h&]jjuh1j7hj+ghhhj=ghMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj'ghhhj=ghMubah}(h]j"gah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj=ghMhj$ghhubj4)}(hhh]jM)}(h$sanity check anonymous rmap additionh]h$sanity check anonymous rmap addition}(hjVihhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhjSihhubah}(h]h ]h"]h$]h&]uh1j3hj$ghhhj=ghMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjnijHjnijIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``const struct folio *folio`` The folio containing **page**. ``const struct page *page`` the page to check the mapping of ``struct vm_area_struct *vma`` the vm area in which the mapping is added ``unsigned long address`` the user virtual address mappedh](jM)}(h**Parameters**h]j)}(hjxih]h Parameters}(hjzihhhNhNubah}(h]h ]h"]h$]h&]uh1jhjviubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhjriubj)}(hhh](j)}(h=``const struct folio *folio`` The folio containing **page**. h](j)}(h``const struct folio *folio``h]jS)}(hjih]hconst struct folio *folio}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjiubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhjiubj)}(hhh]jM)}(hThe folio containing **page**.h](hThe folio containing }(hjihhhNhNubj)}(h**page**h]hpage}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1jhjiubh.}(hjihhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhjihMhjiubah}(h]h ]h"]h$]h&]uh1jhjiubeh}(h]h ]h"]h$]h&]uh1jhjihMhjiubj)}(h=``const struct page *page`` the page to check the mapping of h](j)}(h``const struct page *page``h]jS)}(hjih]hconst struct page *page}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjiubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhjiubj)}(hhh]jM)}(h the page to check the mapping ofh]h the page to check the mapping of}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjihMhjiubah}(h]h ]h"]h$]h&]uh1jhjiubeh}(h]h ]h"]h$]h&]uh1jhjihMhjiubj)}(hI``struct vm_area_struct *vma`` the vm area in which the mapping is added h](j)}(h``struct vm_area_struct *vma``h]jS)}(hjjh]hstruct vm_area_struct *vma}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjjubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhjjubj)}(hhh]jM)}(h)the vm area in which the mapping is addedh]h)the vm area in which the mapping is added}(hj4jhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj0jhMhj1jubah}(h]h ]h"]h$]h&]uh1jhjjubeh}(h]h ]h"]h$]h&]uh1jhj0jhMhjiubj)}(h9``unsigned long address`` the user virtual address mappedh](j)}(h``unsigned long address``h]jS)}(hjTjh]hunsigned long address}(hjVjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjRjubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.cvhMhjNjubj)}(hhh]jM)}(hthe user virtual address mappedh]hthe user virtual address mapped}(hjmjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhjjjubah}(h]h ]h"]h$]h&]uh1jhjNjubeh}(h]h ]h"]h$]h&]uh1jhjijhMhjiubeh}(h]h ]h"]h$]h&]uh1jhjriubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h%folio_add_anon_rmap_ptes (C function)c.folio_add_anon_rmap_pteshNtauh1hhjKhhhNhNubh)}(hhh](h)}(hvoid folio_add_anon_rmap_ptes (struct folio *folio, struct page *page, int nr_pages, struct vm_area_struct *vma, unsigned long address, rmap_t flags)h]h)}(hvoid folio_add_anon_rmap_ptes(struct folio *folio, struct page *page, int nr_pages, struct vm_area_struct *vma, unsigned long address, rmap_t flags)h](j)}(hvoidh]hvoid}(hjjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjjhhhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM4ubj)}(h h]h }(hjjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjjhhhjjhM4ubh)}(hfolio_add_anon_rmap_ptesh]j)}(hfolio_add_anon_rmap_ptesh]hfolio_add_anon_rmap_ptes}(hjjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjjhhhjjhM4ubj8)}(hw(struct folio *folio, struct page *page, int nr_pages, struct vm_area_struct *vma, unsigned long address, rmap_t flags)h](j>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hjjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjjubj)}(h h]h }(hjjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjjubh)}(hhh]j)}(hfolioh]hfolio}(hj khhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjkubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj kmodnameN classnameNjj)}j]j)}jjjsbc.folio_add_anon_rmap_ptesasbuh1hhjjubj)}(h h]h }(hj)khhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjjubjr)}(hjuh]h*}(hj7khhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjjubj)}(hfolioh]hfolio}(hjDkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjjubj>)}(hstruct page *pageh](j)}(hjJ,h]hstruct}(hj]khhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjYkubj)}(h h]h }(hjjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjYkubh)}(hhh]j)}(hpageh]hpage}(hj{khhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjxkubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj}kmodnameN classnameNjj)}j]j%kc.folio_add_anon_rmap_ptesasbuh1hhjYkubj)}(h h]h }(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjYkubjr)}(hjuh]h*}(hjkhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjYkubj)}(hpageh]hpage}(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjYkubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjjubj>)}(h int nr_pagesh](j)}(hinth]hint}(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjkubj)}(h h]h }(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjkubj)}(hnr_pagesh]hnr_pages}(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjkubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjjubj>)}(hstruct vm_area_struct *vmah](j)}(hjJ,h]hstruct}(hjlhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjkubj)}(h h]h }(hjlhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjkubh)}(hhh]j)}(hvm_area_structh]hvm_area_struct}(hj lhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjlubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj"lmodnameN classnameNjj)}j]j%kc.folio_add_anon_rmap_ptesasbuh1hhjkubj)}(h h]h }(hj>lhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjkubjr)}(hjuh]h*}(hjLlhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjkubj)}(hvmah]hvma}(hjYlhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjkubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjjubj>)}(hunsigned long addressh](j)}(hunsignedh]hunsigned}(hjrlhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnlubj)}(h h]h }(hjlhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnlubj)}(hlongh]hlong}(hjlhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnlubj)}(h h]h }(hjlhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnlubj)}(haddressh]haddress}(hjlhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnlubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjjubj>)}(h rmap_t flagsh](h)}(hhh]j)}(hrmap_th]hrmap_t}(hjlhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjlubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjlmodnameN classnameNjj)}j]j%kc.folio_add_anon_rmap_ptesasbuh1hhjlubj)}(h h]h }(hjlhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjlubj)}(hflagsh]hflags}(hjlhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjlubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjjubeh}(h]h ]h"]h$]h&]jjuh1j7hjjhhhjjhM4ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjjhhhjjhM4ubah}(h]jjah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjjhM4hjjhhubj4)}(hhh]jM)}(h1add PTE mappings to a page range of an anon folioh]h1add PTE mappings to a page range of an anon folio}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM4hjmhhubah}(h]h ]h"]h$]h&]uh1j3hjjhhhjjhM4ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj4mjHj4mjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct folio *folio`` The folio to add the mappings to ``struct page *page`` The first page to add ``int nr_pages`` The number of pages which will be mapped ``struct vm_area_struct *vma`` The vm area in which the mappings are added ``unsigned long address`` The user virtual address of the first page to map ``rmap_t flags`` The rmap flags **Description** The page range of folio is defined by [first_page, first_page + nr_pages) The caller needs to hold the page table lock, and the page must be locked in the anon_vma case: to serialize mapping,index checking after setting, and to ensure that an anon folio is not being upgraded racily to a KSM folio (but KSM folios are never downgraded).h](jM)}(h**Parameters**h]j)}(hj>mh]h Parameters}(hj@mhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hjFohhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBoubj)}(h h]h }(hjSohhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBoubh)}(hhh]j)}(hfolioh]hfolio}(hjdohhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaoubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjfomodnameN classnameNjj)}j]j)}jj,osbc.folio_add_anon_rmap_pmdasbuh1hhjBoubj)}(h h]h }(hjohhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBoubjr)}(hjuh]h*}(hjohhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjBoubj)}(hfolioh]hfolio}(hjohhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBoubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj>oubj>)}(hstruct page *pageh](j)}(hjJ,h]hstruct}(hjohhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjoubj)}(h h]h }(hjohhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjoubh)}(hhh]j)}(hpageh]hpage}(hjohhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjoubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjomodnameN classnameNjj)}j]joc.folio_add_anon_rmap_pmdasbuh1hhjoubj)}(h h]h }(hjohhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjoubjr)}(hjuh]h*}(hjphhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjoubj)}(hpageh]hpage}(hjphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjoubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj>oubj>)}(hstruct vm_area_struct *vmah](j)}(hjJ,h]hstruct}(hj(phhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$pubj)}(h h]h }(hj5phhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$pubh)}(hhh]j)}(hvm_area_structh]hvm_area_struct}(hjFphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCpubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjHpmodnameN classnameNjj)}j]joc.folio_add_anon_rmap_pmdasbuh1hhj$pubj)}(h h]h }(hjdphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$pubjr)}(hjuh]h*}(hjrphhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj$pubj)}(hvmah]hvma}(hjphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$pubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj>oubj>)}(hunsigned long addressh](j)}(hunsignedh]hunsigned}(hjphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpubj)}(h h]h }(hjphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpubj)}(hlongh]hlong}(hjphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpubj)}(h h]h }(hjphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpubj)}(haddressh]haddress}(hjphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj>oubj>)}(h rmap_t flagsh](h)}(hhh]j)}(hrmap_th]hrmap_t}(hjphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjpmodnameN classnameNjj)}j]joc.folio_add_anon_rmap_pmdasbuh1hhjpubj)}(h h]h }(hj qhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpubj)}(hflagsh]hflags}(hjqhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj>oubeh}(h]h ]h"]h$]h&]jjuh1j7hjohhhjohMLubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjohhhjohMLubah}(h]jnah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjohMLhjnhhubj4)}(hhh]jM)}(h2add a PMD mapping to a page range of an anon folioh]h2add a PMD mapping to a page range of an anon folio}(hjBqhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMLhj?qhhubah}(h]h ]h"]h$]h&]uh1j3hjnhhhjohMLubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjZqjHjZqjIjJjKuh1hhhhjKhNhNubj)}(hX***Parameters** ``struct folio *folio`` The folio to add the mapping to ``struct page *page`` The first page to add ``struct vm_area_struct *vma`` The vm area in which the mapping is added ``unsigned long address`` The user virtual address of the first page to map ``rmap_t flags`` The rmap flags **Description** The page range of folio is defined by [first_page, first_page + HPAGE_PMD_NR) The caller needs to hold the page table lock, and the page must be locked in the anon_vma case: to serialize mapping,index checking after setting.h](jM)}(h**Parameters**h]j)}(hjdqh]h Parameters}(hjfqhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjbqubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMPhj^qubj)}(hhh](j)}(h8``struct folio *folio`` The folio to add the mapping to h](j)}(h``struct folio *folio``h]jS)}(hjqh]hstruct folio *folio}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjqubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMMhj}qubj)}(hhh]jM)}(hThe folio to add the mapping toh]hThe folio to add the mapping to}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjqhMMhjqubah}(h]h ]h"]h$]h&]uh1jhj}qubeh}(h]h ]h"]h$]h&]uh1jhjqhMMhjzqubj)}(h,``struct page *page`` The first page to add h](j)}(h``struct page *page``h]jS)}(hjqh]hstruct page *page}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjqubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMNhjqubj)}(hhh]jM)}(hThe first page to addh]hThe first page to add}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjqhMNhjqubah}(h]h ]h"]h$]h&]uh1jhjqubeh}(h]h ]h"]h$]h&]uh1jhjqhMNhjzqubj)}(hI``struct vm_area_struct *vma`` The vm area in which the mapping is added h](j)}(h``struct vm_area_struct *vma``h]jS)}(hjqh]hstruct vm_area_struct *vma}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjqubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMOhjqubj)}(hhh]jM)}(h)The vm area in which the mapping is addedh]h)The vm area in which the mapping is added}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj rhMOhj rubah}(h]h ]h"]h$]h&]uh1jhjqubeh}(h]h ]h"]h$]h&]uh1jhj rhMOhjzqubj)}(hL``unsigned long address`` The user virtual address of the first page to map h](j)}(h``unsigned long address``h]jS)}(hj.rh]hunsigned long address}(hj0rhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj,rubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMPhj(rubj)}(hhh]jM)}(h1The user virtual address of the first page to maph]h1The user virtual address of the first page to map}(hjGrhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjCrhMPhjDrubah}(h]h ]h"]h$]h&]uh1jhj(rubeh}(h]h ]h"]h$]h&]uh1jhjCrhMPhjzqubj)}(h ``rmap_t flags`` The rmap flags h](j)}(h``rmap_t flags``h]jS)}(hjgrh]h rmap_t flags}(hjirhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjerubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMQhjarubj)}(hhh]jM)}(hThe rmap flagsh]hThe rmap flags}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj|rhMQhj}rubah}(h]h ]h"]h$]h&]uh1jhjarubeh}(h]h ]h"]h$]h&]uh1jhj|rhMQhjzqubeh}(h]h ]h"]h$]h&]uh1jhj^qubjM)}(h**Description**h]j)}(hjrh]h Description}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjrubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMShj^qubjM)}(hMThe page range of folio is defined by [first_page, first_page + HPAGE_PMD_NR)h]hMThe page range of folio is defined by [first_page, first_page + HPAGE_PMD_NR)}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMRhj^qubjM)}(hThe caller needs to hold the page table lock, and the page must be locked in the anon_vma case: to serialize mapping,index checking after setting.h]hThe caller needs to hold the page table lock, and the page must be locked in the anon_vma case: to serialize mapping,index checking after setting.}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMThj^qubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h$folio_add_new_anon_rmap (C function)c.folio_add_new_anon_rmaphNtauh1hhjKhhhNhNubh)}(hhh](h)}(hsvoid folio_add_new_anon_rmap (struct folio *folio, struct vm_area_struct *vma, unsigned long address, rmap_t flags)h]h)}(hrvoid folio_add_new_anon_rmap(struct folio *folio, struct vm_area_struct *vma, unsigned long address, rmap_t flags)h](j)}(hvoidh]hvoid}(hjrhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjrhhhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMdubj)}(h h]h }(hjshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjrhhhjshMdubh)}(hfolio_add_new_anon_rmaph]j)}(hfolio_add_new_anon_rmaph]hfolio_add_new_anon_rmap}(hjshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjsubah}(h]h ](jjeh"]h$]h&]jjuh1hhjrhhhjshMdubj8)}(hV(struct folio *folio, struct vm_area_struct *vma, unsigned long address, rmap_t flags)h](j>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hj3shhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/subj)}(h h]h }(hj@shhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/subh)}(hhh]j)}(hfolioh]hfolio}(hjQshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNsubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjSsmodnameN classnameNjj)}j]j)}jjssbc.folio_add_new_anon_rmapasbuh1hhj/subj)}(h h]h }(hjqshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/subjr)}(hjuh]h*}(hjshhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj/subj)}(hfolioh]hfolio}(hjshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/subeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj+subj>)}(hstruct vm_area_struct *vmah](j)}(hjJ,h]hstruct}(hjshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjsubj)}(h h]h }(hjshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjsubh)}(hhh]j)}(hvm_area_structh]hvm_area_struct}(hjshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjsubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjsmodnameN classnameNjj)}j]jmsc.folio_add_new_anon_rmapasbuh1hhjsubj)}(h h]h }(hjshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjsubjr)}(hjuh]h*}(hjshhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjsubj)}(hvmah]hvma}(hjshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjsubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj+subj>)}(hunsigned long addressh](j)}(hunsignedh]hunsigned}(hjthhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjtubj)}(h h]h }(hj#thhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjtubj)}(hlongh]hlong}(hj1thhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjtubj)}(h h]h }(hj?thhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjtubj)}(haddressh]haddress}(hjMthhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjtubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj+subj>)}(h rmap_t flagsh](h)}(hhh]j)}(hrmap_th]hrmap_t}(hjithhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjftubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjktmodnameN classnameNjj)}j]jmsc.folio_add_new_anon_rmapasbuh1hhjbtubj)}(h h]h }(hjthhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjbtubj)}(hflagsh]hflags}(hjthhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjbtubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj+subeh}(h]h ]h"]h$]h&]jjuh1j7hjrhhhjshMdubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjrhhhjshMdubah}(h]jrah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjshMdhjrhhubj4)}(hhh]jM)}(h%Add mapping to a new anonymous folio.h]h%Add mapping to a new anonymous folio.}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMdhjthhubah}(h]h ]h"]h$]h&]uh1j3hjrhhhjshMdubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjtjHjtjIjJjKuh1hhhhjKhNhNubj)}(hXS**Parameters** ``struct folio *folio`` The folio to add the mapping to. ``struct vm_area_struct *vma`` the vm area in which the mapping is added ``unsigned long address`` the user virtual address mapped ``rmap_t flags`` The rmap flags **Description** Like folio_add_anon_rmap_*() but must only be called on *new* folios. This means the inc-and-test can be bypassed. The folio doesn't necessarily need to be locked while it's exclusive unless two threads map it concurrently. However, the folio must be locked if it's shared. If the folio is pmd-mappable, it is accounted as a THP.h](jM)}(h**Parameters**h]j)}(hjth]h Parameters}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jhjtubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhhjtubj)}(hhh](j)}(h9``struct folio *folio`` The folio to add the mapping to. h](j)}(h``struct folio *folio``h]jS)}(hjuh]hstruct folio *folio}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjtubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMehjtubj)}(hhh]jM)}(h The folio to add the mapping to.h]h The folio to add the mapping to.}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjuhMehjuubah}(h]h ]h"]h$]h&]uh1jhjtubeh}(h]h ]h"]h$]h&]uh1jhjuhMehjtubj)}(hI``struct vm_area_struct *vma`` the vm area in which the mapping is added h](j)}(h``struct vm_area_struct *vma``h]jS)}(hj9uh]hstruct vm_area_struct *vma}(hj;uhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj7uubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMfhj3uubj)}(hhh]jM)}(h)the vm area in which the mapping is addedh]h)the vm area in which the mapping is added}(hjRuhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjNuhMfhjOuubah}(h]h ]h"]h$]h&]uh1jhj3uubeh}(h]h ]h"]h$]h&]uh1jhjNuhMfhjtubj)}(h:``unsigned long address`` the user virtual address mapped h](j)}(h``unsigned long address``h]jS)}(hjruh]hunsigned long address}(hjtuhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjpuubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMghjluubj)}(hhh]jM)}(hthe user virtual address mappedh]hthe user virtual address mapped}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjuhMghjuubah}(h]h ]h"]h$]h&]uh1jhjluubeh}(h]h ]h"]h$]h&]uh1jhjuhMghjtubj)}(h ``rmap_t flags`` The rmap flags h](j)}(h``rmap_t flags``h]jS)}(hjuh]h rmap_t flags}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjuubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhhjuubj)}(hhh]jM)}(hThe rmap flagsh]hThe rmap flags}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjuhMhhjuubah}(h]h ]h"]h$]h&]uh1jhjuubeh}(h]h ]h"]h$]h&]uh1jhjuhMhhjtubeh}(h]h ]h"]h$]h&]uh1jhjtubjM)}(h**Description**h]j)}(hjuh]h Description}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjuubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMjhjtubjM)}(hXLike folio_add_anon_rmap_*() but must only be called on *new* folios. This means the inc-and-test can be bypassed. The folio doesn't necessarily need to be locked while it's exclusive unless two threads map it concurrently. However, the folio must be locked if it's shared.h](h8Like folio_add_anon_rmap_*() but must only be called on }(hjuhhhNhNubj )}(h*new*h]hnew}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1j hjuubh folios. This means the inc-and-test can be bypassed. The folio doesn’t necessarily need to be locked while it’s exclusive unless two threads map it concurrently. However, the folio must be locked if it’s shared.}(hjuhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMihjtubjM)}(h7If the folio is pmd-mappable, it is accounted as a THP.h]h7If the folio is pmd-mappable, it is accounted as a THP.}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMohjtubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h%folio_add_file_rmap_ptes (C function)c.folio_add_file_rmap_pteshNtauh1hhjKhhhNhNubh)}(hhh](h)}(hpvoid folio_add_file_rmap_ptes (struct folio *folio, struct page *page, int nr_pages, struct vm_area_struct *vma)h]h)}(hovoid folio_add_file_rmap_ptes(struct folio *folio, struct page *page, int nr_pages, struct vm_area_struct *vma)h](j)}(hvoidh]hvoid}(hjLvhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHvhhhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMubj)}(h h]h }(hj[vhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHvhhhjZvhMubh)}(hfolio_add_file_rmap_ptesh]j)}(hfolio_add_file_rmap_ptesh]hfolio_add_file_rmap_ptes}(hjmvhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjivubah}(h]h ](jjeh"]h$]h&]jjuh1hhjHvhhhjZvhMubj8)}(hR(struct folio *folio, struct page *page, int nr_pages, struct vm_area_struct *vma)h](j>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hjvhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvubj)}(h h]h }(hjvhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvubh)}(hhh]j)}(hfolioh]hfolio}(hjvhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjvmodnameN classnameNjj)}j]j)}jjovsbc.folio_add_file_rmap_ptesasbuh1hhjvubj)}(h h]h }(hjvhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvubjr)}(hjuh]h*}(hjvhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjvubj)}(hfolioh]hfolio}(hjvhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjvubj>)}(hstruct page *pageh](j)}(hjJ,h]hstruct}(hjvhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvubj)}(h h]h }(hjwhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvubh)}(hhh]j)}(hpageh]hpage}(hjwhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjwubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjwmodnameN classnameNjj)}j]jvc.folio_add_file_rmap_ptesasbuh1hhjvubj)}(h h]h }(hj7whhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvubjr)}(hjuh]h*}(hjEwhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjvubj)}(hpageh]hpage}(hjRwhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjvubj>)}(h int nr_pagesh](j)}(hinth]hint}(hjkwhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgwubj)}(h h]h }(hjywhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgwubj)}(hnr_pagesh]hnr_pages}(hjwhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgwubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjvubj>)}(hstruct vm_area_struct *vmah](j)}(hjJ,h]hstruct}(hjwhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjwubj)}(h h]h }(hjwhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjwubh)}(hhh]j)}(hvm_area_structh]hvm_area_struct}(hjwhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjwubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjwmodnameN classnameNjj)}j]jvc.folio_add_file_rmap_ptesasbuh1hhjwubj)}(h h]h }(hjwhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjwubjr)}(hjuh]h*}(hjwhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjwubj)}(hvmah]hvma}(hjwhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjwubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjvubeh}(h]h ]h"]h$]h&]jjuh1j7hjHvhhhjZvhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjDvhhhjZvhMubah}(h]j?vah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjZvhMhjAvhhubj4)}(hhh]jM)}(h+add PTE mappings to a page range of a folioh]h+add PTE mappings to a page range of a folio}(hj!xhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhjxhhubah}(h]h ]h"]h$]h&]uh1j3hjAvhhhjZvhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj9xjHj9xjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct folio *folio`` The folio to add the mappings to ``struct page *page`` The first page to add ``int nr_pages`` The number of pages that will be mapped using PTEs ``struct vm_area_struct *vma`` The vm area in which the mappings are added **Description** The page range of the folio is defined by [page, page + nr_pages) The caller needs to hold the page table lock.h](jM)}(h**Parameters**h]j)}(hjCxh]h Parameters}(hjExhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjAxubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhj=xubj)}(hhh](j)}(h9``struct folio *folio`` The folio to add the mappings to h](j)}(h``struct folio *folio``h]jS)}(hjbxh]hstruct folio *folio}(hjdxhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj`xubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhj\xubj)}(hhh]jM)}(h The folio to add the mappings toh]h The folio to add the mappings to}(hj{xhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjwxhMhjxxubah}(h]h ]h"]h$]h&]uh1jhj\xubeh}(h]h ]h"]h$]h&]uh1jhjwxhMhjYxubj)}(h,``struct page *page`` The first page to add h](j)}(h``struct page *page``h]jS)}(hjxh]hstruct page *page}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjxubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhjxubj)}(hhh]jM)}(hThe first page to addh]hThe first page to add}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjxhMhjxubah}(h]h ]h"]h$]h&]uh1jhjxubeh}(h]h ]h"]h$]h&]uh1jhjxhMhjYxubj)}(hD``int nr_pages`` The number of pages that will be mapped using PTEs h](j)}(h``int nr_pages``h]jS)}(hjxh]h int nr_pages}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjxubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhjxubj)}(hhh]jM)}(h2The number of pages that will be mapped using PTEsh]h2The number of pages that will be mapped using PTEs}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjxhMhjxubah}(h]h ]h"]h$]h&]uh1jhjxubeh}(h]h ]h"]h$]h&]uh1jhjxhMhjYxubj)}(hK``struct vm_area_struct *vma`` The vm area in which the mappings are added h](j)}(h``struct vm_area_struct *vma``h]jS)}(hj yh]hstruct vm_area_struct *vma}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj yubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhjyubj)}(hhh]jM)}(h+The vm area in which the mappings are addedh]h+The vm area in which the mappings are added}(hj&yhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj"yhMhj#yubah}(h]h ]h"]h$]h&]uh1jhjyubeh}(h]h ]h"]h$]h&]uh1jhj"yhMhjYxubeh}(h]h ]h"]h$]h&]uh1jhj=xubjM)}(h**Description**h]j)}(hjHyh]h Description}(hjJyhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjFyubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhj=xubjM)}(hAThe page range of the folio is defined by [page, page + nr_pages)h]hAThe page range of the folio is defined by [page, page + nr_pages)}(hj^yhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhj=xubjM)}(h-The caller needs to hold the page table lock.h]h-The caller needs to hold the page table lock.}(hjmyhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhj=xubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h$folio_add_file_rmap_pmd (C function)c.folio_add_file_rmap_pmdhNtauh1hhjKhhhNhNubh)}(hhh](h)}(havoid folio_add_file_rmap_pmd (struct folio *folio, struct page *page, struct vm_area_struct *vma)h]h)}(h`void folio_add_file_rmap_pmd(struct folio *folio, struct page *page, struct vm_area_struct *vma)h](j)}(hvoidh]hvoid}(hjyhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyhhhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMubj)}(h h]h }(hjyhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyhhhjyhMubh)}(hfolio_add_file_rmap_pmdh]j)}(hfolio_add_file_rmap_pmdh]hfolio_add_file_rmap_pmd}(hjyhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyubah}(h]h ](jjeh"]h$]h&]jjuh1hhjyhhhjyhMubj8)}(hD(struct folio *folio, struct page *page, struct vm_area_struct *vma)h](j>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hjyhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyubj)}(h h]h }(hjyhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyubh)}(hhh]j)}(hfolioh]hfolio}(hjyhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjymodnameN classnameNjj)}j]j)}jjysbc.folio_add_file_rmap_pmdasbuh1hhjyubj)}(h h]h }(hjzhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyubjr)}(hjuh]h*}(hj%zhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjyubj)}(hfolioh]hfolio}(hj2zhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjyubj>)}(hstruct page *pageh](j)}(hjJ,h]hstruct}(hjKzhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGzubj)}(h h]h }(hjXzhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGzubh)}(hhh]j)}(hpageh]hpage}(hjizhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjfzubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjkzmodnameN classnameNjj)}j]jzc.folio_add_file_rmap_pmdasbuh1hhjGzubj)}(h h]h }(hjzhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGzubjr)}(hjuh]h*}(hjzhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjGzubj)}(hpageh]hpage}(hjzhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGzubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjyubj>)}(hstruct vm_area_struct *vmah](j)}(hjJ,h]hstruct}(hjzhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjzubj)}(h h]h }(hjzhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjzubh)}(hhh]j)}(hvm_area_structh]hvm_area_struct}(hjzhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjzubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjzmodnameN classnameNjj)}j]jzc.folio_add_file_rmap_pmdasbuh1hhjzubj)}(h h]h }(hjzhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjzubjr)}(hjuh]h*}(hj{hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjzubj)}(hvmah]hvma}(hj{hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjzubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjyubeh}(h]h ]h"]h$]h&]jjuh1j7hjyhhhjyhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjyhhhjyhMubah}(h]jyah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjyhMhjyhhubj4)}(hhh]jM)}(h,add a PMD mapping to a page range of a folioh]h,add a PMD mapping to a page range of a folio}(hj<{hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhj9{hhubah}(h]h ]h"]h$]h&]uh1j3hjyhhhjyhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjT{jHjT{jIjJjKuh1hhhhjKhNhNubj)}(hXK**Parameters** ``struct folio *folio`` The folio to add the mapping to ``struct page *page`` The first page to add ``struct vm_area_struct *vma`` The vm area in which the mapping is added **Description** The page range of the folio is defined by [page, page + HPAGE_PMD_NR) The caller needs to hold the page table lock.h](jM)}(h**Parameters**h]j)}(hj^{h]h Parameters}(hj`{hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj\{ubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhjX{ubj)}(hhh](j)}(h8``struct folio *folio`` The folio to add the mapping to h](j)}(h``struct folio *folio``h]jS)}(hj}{h]hstruct folio *folio}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj{{ubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhjw{ubj)}(hhh]jM)}(hThe folio to add the mapping toh]hThe folio to add the mapping to}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj{hMhj{ubah}(h]h ]h"]h$]h&]uh1jhjw{ubeh}(h]h ]h"]h$]h&]uh1jhj{hMhjt{ubj)}(h,``struct page *page`` The first page to add h](j)}(h``struct page *page``h]jS)}(hj{h]hstruct page *page}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj{ubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhj{ubj)}(hhh]jM)}(hThe first page to addh]hThe first page to add}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj{hMhj{ubah}(h]h ]h"]h$]h&]uh1jhj{ubeh}(h]h ]h"]h$]h&]uh1jhj{hMhjt{ubj)}(hI``struct vm_area_struct *vma`` The vm area in which the mapping is added h](j)}(h``struct vm_area_struct *vma``h]jS)}(hj{h]hstruct vm_area_struct *vma}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj{ubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhj{ubj)}(hhh]jM)}(h)The vm area in which the mapping is addedh]h)The vm area in which the mapping is added}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj|hMhj|ubah}(h]h ]h"]h$]h&]uh1jhj{ubeh}(h]h ]h"]h$]h&]uh1jhj|hMhjt{ubeh}(h]h ]h"]h$]h&]uh1jhjX{ubjM)}(h**Description**h]j)}(hj*|h]h Description}(hj,|hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj(|ubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhjX{ubjM)}(hEThe page range of the folio is defined by [page, page + HPAGE_PMD_NR)h]hEThe page range of the folio is defined by [page, page + HPAGE_PMD_NR)}(hj@|hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhjX{ubjM)}(h-The caller needs to hold the page table lock.h]h-The caller needs to hold the page table lock.}(hjO|hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhjX{ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h$folio_add_file_rmap_pud (C function)c.folio_add_file_rmap_pudhNtauh1hhjKhhhNhNubh)}(hhh](h)}(havoid folio_add_file_rmap_pud (struct folio *folio, struct page *page, struct vm_area_struct *vma)h]h)}(h`void folio_add_file_rmap_pud(struct folio *folio, struct page *page, struct vm_area_struct *vma)h](j)}(hvoidh]hvoid}(hj~|hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjz|hhhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMubj)}(h h]h }(hj|hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjz|hhhj|hMubh)}(hfolio_add_file_rmap_pudh]j)}(hfolio_add_file_rmap_pudh]hfolio_add_file_rmap_pud}(hj|hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjz|hhhj|hMubj8)}(hD(struct folio *folio, struct page *page, struct vm_area_struct *vma)h](j>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hj|hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|ubj)}(h h]h }(hj|hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|ubh)}(hhh]j)}(hfolioh]hfolio}(hj|hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj|modnameN classnameNjj)}j]j)}jj|sbc.folio_add_file_rmap_pudasbuh1hhj|ubj)}(h h]h }(hj|hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|ubjr)}(hjuh]h*}(hj}hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj|ubj)}(hfolioh]hfolio}(hj}hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj|ubj>)}(hstruct page *pageh](j)}(hjJ,h]hstruct}(hj-}hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)}ubj)}(h h]h }(hj:}hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)}ubh)}(hhh]j)}(hpageh]hpage}(hjK}hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjH}ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjM}modnameN classnameNjj)}j]j|c.folio_add_file_rmap_pudasbuh1hhj)}ubj)}(h h]h }(hji}hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)}ubjr)}(hjuh]h*}(hjw}hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj)}ubj)}(hpageh]hpage}(hj}hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)}ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj|ubj>)}(hstruct vm_area_struct *vmah](j)}(hjJ,h]hstruct}(hj}hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj}ubj)}(h h]h }(hj}hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj}ubh)}(hhh]j)}(hvm_area_structh]hvm_area_struct}(hj}hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj}ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj}modnameN classnameNjj)}j]j|c.folio_add_file_rmap_pudasbuh1hhj}ubj)}(h h]h }(hj}hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj}ubjr)}(hjuh]h*}(hj}hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj}ubj)}(hvmah]hvma}(hj}hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj}ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj|ubeh}(h]h ]h"]h$]h&]jjuh1j7hjz|hhhj|hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjv|hhhj|hMubah}(h]jq|ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj|hMhjs|hhubj4)}(hhh]jM)}(h,add a PUD mapping to a page range of a folioh]h,add a PUD mapping to a page range of a folio}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhj~hhubah}(h]h ]h"]h$]h&]uh1j3hjs|hhhj|hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj6~jHj6~jIjJjKuh1hhhhjKhNhNubj)}(hXK**Parameters** ``struct folio *folio`` The folio to add the mapping to ``struct page *page`` The first page to add ``struct vm_area_struct *vma`` The vm area in which the mapping is added **Description** The page range of the folio is defined by [page, page + HPAGE_PUD_NR) The caller needs to hold the page table lock.h](jM)}(h**Parameters**h]j)}(hj@~h]h Parameters}(hjB~hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj>~ubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhj:~ubj)}(hhh](j)}(h8``struct folio *folio`` The folio to add the mapping to h](j)}(h``struct folio *folio``h]jS)}(hj_~h]hstruct folio *folio}(hja~hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj]~ubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhjY~ubj)}(hhh]jM)}(hThe folio to add the mapping toh]hThe folio to add the mapping to}(hjx~hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjt~hMhju~ubah}(h]h ]h"]h$]h&]uh1jhjY~ubeh}(h]h ]h"]h$]h&]uh1jhjt~hMhjV~ubj)}(h,``struct page *page`` The first page to add h](j)}(h``struct page *page``h]jS)}(hj~h]hstruct page *page}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj~ubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhj~ubj)}(hhh]jM)}(hThe first page to addh]hThe first page to add}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj~hMhj~ubah}(h]h ]h"]h$]h&]uh1jhj~ubeh}(h]h ]h"]h$]h&]uh1jhj~hMhjV~ubj)}(hI``struct vm_area_struct *vma`` The vm area in which the mapping is added h](j)}(h``struct vm_area_struct *vma``h]jS)}(hj~h]hstruct vm_area_struct *vma}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj~ubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhj~ubj)}(hhh]jM)}(h)The vm area in which the mapping is addedh]h)The vm area in which the mapping is added}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj~hMhj~ubah}(h]h ]h"]h$]h&]uh1jhj~ubeh}(h]h ]h"]h$]h&]uh1jhj~hMhjV~ubeh}(h]h ]h"]h$]h&]uh1jhj:~ubjM)}(h**Description**h]j)}(hj h]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhj:~ubjM)}(hEThe page range of the folio is defined by [page, page + HPAGE_PUD_NR)h]hEThe page range of the folio is defined by [page, page + HPAGE_PUD_NR)}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhj:~ubjM)}(h-The caller needs to hold the page table lock.h]h-The caller needs to hold the page table lock.}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhj:~ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h#folio_remove_rmap_ptes (C function)c.folio_remove_rmap_pteshNtauh1hhjKhhhNhNubh)}(hhh](h)}(hnvoid folio_remove_rmap_ptes (struct folio *folio, struct page *page, int nr_pages, struct vm_area_struct *vma)h]h)}(hmvoid folio_remove_rmap_ptes(struct folio *folio, struct page *page, int nr_pages, struct vm_area_struct *vma)h](j)}(hvoidh]hvoid}(hj`hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\hhhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMgubj)}(h h]h }(hjohhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\hhhjnhMgubh)}(hfolio_remove_rmap_ptesh]j)}(hfolio_remove_rmap_ptesh]hfolio_remove_rmap_ptes}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj}ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj\hhhjnhMgubj8)}(hR(struct folio *folio, struct page *page, int nr_pages, struct vm_area_struct *vma)h](j>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsbc.folio_remove_rmap_ptesasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hstruct page *pageh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubh)}(hhh]j)}(hpageh]hpage}(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj/modnameN classnameNjj)}j]jc.folio_remove_rmap_ptesasbuh1hhj ubj)}(h h]h }(hjKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubjr)}(hjuh]h*}(hjYhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj ubj)}(hpageh]hpage}(hjfhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(h int nr_pagesh](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{ubj)}(hnr_pagesh]hnr_pages}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hstruct vm_area_struct *vmah](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hvm_area_structh]hvm_area_struct}(hjҀhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjπubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjԀmodnameN classnameNjj)}j]jc.folio_remove_rmap_ptesasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hvmah]hvma}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hj\hhhjnhMgubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjXhhhjnhMgubah}(h]jSah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjnhMghjUhhubj4)}(hhh]jM)}(h0remove PTE mappings from a page range of a folioh]h0remove PTE mappings from a page range of a folio}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMghj2hhubah}(h]h ]h"]h$]h&]uh1j3hjUhhhjnhMgubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjMjHjMjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct folio *folio`` The folio to remove the mappings from ``struct page *page`` The first page to remove ``int nr_pages`` The number of pages that will be removed from the mapping ``struct vm_area_struct *vma`` The vm area from which the mappings are removed **Description** The page range of the folio is defined by [page, page + nr_pages) The caller needs to hold the page table lock.7h](jM)}(h**Parameters**h]j)}(hjWh]h Parameters}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjUubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMkhjQubj)}(hhh](j)}(h>``struct folio *folio`` The folio to remove the mappings from h](j)}(h``struct folio *folio``h]jS)}(hjvh]hstruct folio *folio}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjtubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhhjpubj)}(hhh]jM)}(h%The folio to remove the mappings fromh]h%The folio to remove the mappings from}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhhjubah}(h]h ]h"]h$]h&]uh1jhjpubeh}(h]h ]h"]h$]h&]uh1jhjhMhhjmubj)}(h/``struct page *page`` The first page to remove h](j)}(h``struct page *page``h]jS)}(hjh]hstruct page *page}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMihjubj)}(hhh]jM)}(hThe first page to removeh]hThe first page to remove}(hjȁhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjāhMihjŁubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjāhMihjmubj)}(hK``int nr_pages`` The number of pages that will be removed from the mapping h](j)}(h``int nr_pages``h]jS)}(hjh]h int nr_pages}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMjhjubj)}(hhh]jM)}(h9The number of pages that will be removed from the mappingh]h9The number of pages that will be removed from the mapping}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMjhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMjhjmubj)}(hO``struct vm_area_struct *vma`` The vm area from which the mappings are removed h](j)}(h``struct vm_area_struct *vma``h]jS)}(hj!h]hstruct vm_area_struct *vma}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMkhjubj)}(hhh]jM)}(h/The vm area from which the mappings are removedh]h/The vm area from which the mappings are removed}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj6hMkhj7ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj6hMkhjmubeh}(h]h ]h"]h$]h&]uh1jhjQubjM)}(h**Description**h]j)}(hj\h]h Description}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjZubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMmhjQubjM)}(hAThe page range of the folio is defined by [page, page + nr_pages)h]hAThe page range of the folio is defined by [page, page + nr_pages)}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMlhjQubjM)}(h-The caller needs to hold the page table lock.h]h-The caller needs to hold the page table lock.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMnhjQubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h"folio_remove_rmap_pmd (C function)c.folio_remove_rmap_pmdhNtauh1hhjKhhhNhNubh)}(hhh](h)}(h_void folio_remove_rmap_pmd (struct folio *folio, struct page *page, struct vm_area_struct *vma)h]h)}(h^void folio_remove_rmap_pmd(struct folio *folio, struct page *page, struct vm_area_struct *vma)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMxubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMxubh)}(hfolio_remove_rmap_pmdh]j)}(hfolio_remove_rmap_pmdh]hfolio_remove_rmap_pmd}(hjтhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj͂ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMxubj8)}(hD(struct folio *folio, struct page *page, struct vm_area_struct *vma)h](j>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hfolioh]hfolio}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj modnameN classnameNjj)}j]j)}jjӂsbc.folio_remove_rmap_pmdasbuh1hhjubj)}(h h]h }(hj+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hj9hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hfolioh]hfolio}(hjFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hstruct page *pageh](j)}(hjJ,h]hstruct}(hj_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj[ubj)}(h h]h }(hjlhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj[ubh)}(hhh]j)}(hpageh]hpage}(hj}hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjzubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j'c.folio_remove_rmap_pmdasbuh1hhj[ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj[ubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj[ubj)}(hpageh]hpage}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj[ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hstruct vm_area_struct *vmah](j)}(hjJ,h]hstruct}(hjσhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj˃ubj)}(h h]h }(hj܃hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj˃ubh)}(hhh]j)}(hvm_area_structh]hvm_area_struct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j'c.folio_remove_rmap_pmdasbuh1hhj˃ubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj˃ubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj˃ubj)}(hvmah]hvma}(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj˃ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMxubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMxubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMxhjhhubj4)}(hhh]jM)}(h1remove a PMD mapping from a page range of a folioh]h1remove a PMD mapping from a page range of a folio}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMxhjMhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMxubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjhjHjhjIjJjKuh1hhhhjKhNhNubj)}(hXW**Parameters** ``struct folio *folio`` The folio to remove the mapping from ``struct page *page`` The first page to remove ``struct vm_area_struct *vma`` The vm area from which the mapping is removed **Description** The page range of the folio is defined by [page, page + HPAGE_PMD_NR) The caller needs to hold the page table lock.h](jM)}(h**Parameters**h]j)}(hjrh]h Parameters}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jhjpubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM|hjlubj)}(hhh](j)}(h=``struct folio *folio`` The folio to remove the mapping from h](j)}(h``struct folio *folio``h]jS)}(hjh]hstruct folio *folio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMyhjubj)}(hhh]jM)}(h$The folio to remove the mapping fromh]h$The folio to remove the mapping from}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMyhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMyhjubj)}(h/``struct page *page`` The first page to remove h](j)}(h``struct page *page``h]jS)}(hjʄh]hstruct page *page}(hj̄hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjȄubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMzhjĄubj)}(hhh]jM)}(hThe first page to removeh]hThe first page to remove}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj߄hMzhjubah}(h]h ]h"]h$]h&]uh1jhjĄubeh}(h]h ]h"]h$]h&]uh1jhj߄hMzhjubj)}(hM``struct vm_area_struct *vma`` The vm area from which the mapping is removed h](j)}(h``struct vm_area_struct *vma``h]jS)}(hjh]hstruct vm_area_struct *vma}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM{hjubj)}(hhh]jM)}(h-The vm area from which the mapping is removedh]h-The vm area from which the mapping is removed}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM{hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM{hjubeh}(h]h ]h"]h$]h&]uh1jhjlubjM)}(h**Description**h]j)}(hj>h]h Description}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj<ubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM}hjlubjM)}(hEThe page range of the folio is defined by [page, page + HPAGE_PMD_NR)h]hEThe page range of the folio is defined by [page, page + HPAGE_PMD_NR)}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM|hjlubjM)}(h-The caller needs to hold the page table lock.h]h-The caller needs to hold the page table lock.}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM~hjlubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h"folio_remove_rmap_pud (C function)c.folio_remove_rmap_pudhNtauh1hhjKhhhNhNubh)}(hhh](h)}(h_void folio_remove_rmap_pud (struct folio *folio, struct page *page, struct vm_area_struct *vma)h]h)}(h^void folio_remove_rmap_pud(struct folio *folio, struct page *page, struct vm_area_struct *vma)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh)}(hfolio_remove_rmap_pudh]j)}(hfolio_remove_rmap_pudh]hfolio_remove_rmap_pud}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMubj8)}(hD(struct folio *folio, struct page *page, struct vm_area_struct *vma)h](j>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hjυhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj˅ubj)}(h h]h }(hj܅hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj˅ubh)}(hhh]j)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsbc.folio_remove_rmap_pudasbuh1hhj˅ubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj˅ubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj˅ubj)}(hfolioh]hfolio}(hj(hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj˅ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjDžubj>)}(hstruct page *pageh](j)}(hjJ,h]hstruct}(hjAhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=ubj)}(h h]h }(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=ubh)}(hhh]j)}(hpageh]hpage}(hj_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjamodnameN classnameNjj)}j]j c.folio_remove_rmap_pudasbuh1hhj=ubj)}(h h]h }(hj}hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=ubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj=ubj)}(hpageh]hpage}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjDžubj>)}(hstruct vm_area_struct *vmah](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hvm_area_structh]hvm_area_struct}(hjφhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj̆ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjцmodnameN classnameNjj)}j]j c.folio_remove_rmap_pudasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hvmah]hvma}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjDžubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]jM)}(h1remove a PUD mapping from a page range of a folioh]h1remove a PUD mapping from a page range of a folio}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhj/hhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjJjHjJjIjJjKuh1hhhhjKhNhNubj)}(hXW**Parameters** ``struct folio *folio`` The folio to remove the mapping from ``struct page *page`` The first page to remove ``struct vm_area_struct *vma`` The vm area from which the mapping is removed **Description** The page range of the folio is defined by [page, page + HPAGE_PUD_NR) The caller needs to hold the page table lock.h](jM)}(h**Parameters**h]j)}(hjTh]h Parameters}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjRubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhjNubj)}(hhh](j)}(h=``struct folio *folio`` The folio to remove the mapping from h](j)}(h``struct folio *folio``h]jS)}(hjsh]hstruct folio *folio}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjqubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhjmubj)}(hhh]jM)}(h$The folio to remove the mapping fromh]h$The folio to remove the mapping from}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjmubeh}(h]h ]h"]h$]h&]uh1jhjhMhjjubj)}(h/``struct page *page`` The first page to remove h](j)}(h``struct page *page``h]jS)}(hjh]hstruct page *page}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhjubj)}(hhh]jM)}(hThe first page to removeh]hThe first page to remove}(hjŇhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhj‡ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjjubj)}(hM``struct vm_area_struct *vma`` The vm area from which the mapping is removed h](j)}(h``struct vm_area_struct *vma``h]jS)}(hjh]hstruct vm_area_struct *vma}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhj߇ubj)}(hhh]jM)}(h-The vm area from which the mapping is removedh]h-The vm area from which the mapping is removed}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhj߇ubeh}(h]h ]h"]h$]h&]uh1jhjhMhjjubeh}(h]h ]h"]h$]h&]uh1jhjNubjM)}(h**Description**h]j)}(hj h]h Description}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhjNubjM)}(hEThe page range of the folio is defined by [page, page + HPAGE_PUD_NR)h]hEThe page range of the folio is defined by [page, page + HPAGE_PUD_NR)}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhjNubjM)}(h-The caller needs to hold the page table lock.h]h-The caller needs to hold the page table lock.}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMhjNubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](htry_to_unmap (C function)c.try_to_unmaphNtauh1hhjKhhhNhNubh)}(hhh](h)}(h=void try_to_unmap (struct folio *folio, enum ttu_flags flags)h]h)}(h)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hfolioh]hfolio}(hjψhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj̈ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjшmodnameN classnameNjj)}j]j)}jjsbc.try_to_unmapasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hfolioh]hfolio}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(henum ttu_flags flagsh](j)}(hj#!h]henum}(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(h ttu_flagsh]h ttu_flags}(hjAhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjCmodnameN classnameNjj)}j]jc.try_to_unmapasbuh1hhjubj)}(h h]h }(hj_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hflagsh]hflags}(hjmhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjphhhjhMw ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjlhhhjhMw ubah}(h]jgah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMw hjihhubj4)}(hhh]jM)}(h1Try to remove all page table mappings to a folio.h]h1Try to remove all page table mappings to a folio.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMw hjhhubah}(h]h ]h"]h$]h&]uh1j3hjihhhjhMw ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hXs**Parameters** ``struct folio *folio`` The folio to unmap. ``enum ttu_flags flags`` action and flags **Description** Tries to remove all the page table entries which are mapping this folio. It is the caller's responsibility to check if the folio is still mapped if needed (use TTU_SYNC to prevent accounting races). **Context** Caller must hold the folio lock.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM{ hjubj)}(hhh](j)}(h,``struct folio *folio`` The folio to unmap. h](j)}(h``struct folio *folio``h]jS)}(hj؉h]hstruct folio *folio}(hjډhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj։ubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMx hj҉ubj)}(hhh]jM)}(hThe folio to unmap.h]hThe folio to unmap.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMx hjubah}(h]h ]h"]h$]h&]uh1jhj҉ubeh}(h]h ]h"]h$]h&]uh1jhjhMx hjωubj)}(h*``enum ttu_flags flags`` action and flags h](j)}(h``enum ttu_flags flags``h]jS)}(hjh]henum ttu_flags flags}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMy hj ubj)}(hhh]jM)}(haction and flagsh]haction and flags}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj&hMy hj'ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj&hMy hjωubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjLh]h Description}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjJubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM{ hjubjM)}(hTries to remove all the page table entries which are mapping this folio. It is the caller's responsibility to check if the folio is still mapped if needed (use TTU_SYNC to prevent accounting races).h]hTries to remove all the page table entries which are mapping this folio. It is the caller’s responsibility to check if the folio is still mapped if needed (use TTU_SYNC to prevent accounting races).}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chMz hjubjM)}(h **Context**h]j)}(hjsh]hContext}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjqubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM~ hjubjM)}(h Caller must hold the folio lock.h]h Caller must hold the folio lock.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](htry_to_migrate (C function)c.try_to_migratehNtauh1hhjKhhhNhNubh)}(hhh](h)}(h?void try_to_migrate (struct folio *folio, enum ttu_flags flags)h]h)}(h>void try_to_migrate(struct folio *folio, enum ttu_flags flags)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM ubj)}(h h]h }(hjNJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjƊhM ubh)}(htry_to_migrateh]j)}(htry_to_migrateh]htry_to_migrate}(hjيhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjՊubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjƊhM ubj8)}(h+(struct folio *folio, enum ttu_flags flags)h](j>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjۊsbc.try_to_migrateasbuh1hhjubj)}(h h]h }(hj3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjAhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hfolioh]hfolio}(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(henum ttu_flags flagsh](j)}(hj#!h]henum}(hjghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjcubj)}(h h]h }(hjthhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjcubh)}(hhh]j)}(h ttu_flagsh]h ttu_flags}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j/c.try_to_migrateasbuh1hhjcubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjcubj)}(hflagsh]hflags}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjcubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjƊhM ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjƊhM ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjƊhM hjhhubj4)}(hhh]jM)}(h8try to replace all page table mappings with swap entriesh]h8try to replace all page table mappings with swap entries}(hjۋhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM hj؋hhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjƊhM ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hX)**Parameters** ``struct folio *folio`` the folio to replace page table entries for ``enum ttu_flags flags`` action and flags **Description** Tries to remove all the page table entries which are mapping this folio and replace them with special swap entries. Caller must hold the folio lock.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM hjubj)}(hhh](j)}(hD``struct folio *folio`` the folio to replace page table entries for h](j)}(h``struct folio *folio``h]jS)}(hjh]hstruct folio *folio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM hjubj)}(hhh]jM)}(h+the folio to replace page table entries forh]h+the folio to replace page table entries for}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj1hM hj2ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj1hM hjubj)}(h*``enum ttu_flags flags`` action and flags h](j)}(h``enum ttu_flags flags``h]jS)}(hjUh]henum ttu_flags flags}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjSubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM hjOubj)}(hhh]jM)}(haction and flagsh]haction and flags}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjjhM hjkubah}(h]h ]h"]h$]h&]uh1jhjOubeh}(h]h ]h"]h$]h&]uh1jhjjhM hjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM hjubjM)}(hTries to remove all the page table entries which are mapping this folio and replace them with special swap entries. Caller must hold the folio lock.h]hTries to remove all the page table entries which are mapping this folio and replace them with special swap entries. Caller must hold the folio lock.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h"make_device_exclusive (C function)c.make_device_exclusivehNtauh1hhjKhhhNhNubh)}(hhh](h)}(hrstruct page * make_device_exclusive (struct mm_struct *mm, unsigned long addr, void *owner, struct folio **foliop)h]h)}(hpstruct page *make_device_exclusive(struct mm_struct *mm, unsigned long addr, void *owner, struct folio **foliop)h](j)}(hjJ,h]hstruct}(hjՌhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjьhhhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjьhhhjhM ubh)}(hhh]j)}(hpageh]hpage}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jmake_device_exclusivesbc.make_device_exclusiveasbuh1hhjьhhhjhM ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjьhhhjhM ubjr)}(hjuh]h*}(hj#hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjьhhhjhM ubh)}(hmake_device_exclusiveh]j)}(hjh]hmake_device_exclusive}(hj4hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjьhhhjhM ubj8)}(hN(struct mm_struct *mm, unsigned long addr, void *owner, struct folio **foliop)h](j>)}(hstruct mm_struct *mmh](j)}(hjJ,h]hstruct}(hjOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjKubj)}(h h]h }(hj\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjKubh)}(hhh]j)}(h mm_structh]h mm_struct}(hjmhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjomodnameN classnameNjj)}j]jc.make_device_exclusiveasbuh1hhjKubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjKubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjKubj)}(hmmh]hmm}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjKubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjGubj>)}(hunsigned long addrh](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj͍hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hlongh]hlong}(hjۍhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(haddrh]haddr}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjGubj>)}(h void *ownerh](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubjr)}(hjuh]h*}(hj,hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj ubj)}(hownerh]howner}(hj9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjGubj>)}(hstruct folio **folioph](j)}(hjJ,h]hstruct}(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubj)}(h h]h }(hj_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubh)}(hhh]j)}(hfolioh]hfolio}(hjphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjrmodnameN classnameNjj)}j]jc.make_device_exclusiveasbuh1hhjNubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjNubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjNubj)}(hfolioph]hfoliop}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjGubeh}(h]h ]h"]h$]h&]jjuh1j7hjьhhhjhM ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj͌hhhjhM ubah}(h]jȌah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhM hjʌhhubj4)}(hhh]jM)}(h)Mark a page for exclusive use by a deviceh]h)Mark a page for exclusive use by a device}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM hjݎhhubah}(h]h ]h"]h$]h&]uh1j3hjʌhhhjhM ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct mm_struct *mm`` mm_struct of associated target process ``unsigned long addr`` the virtual address to mark for exclusive device access ``void *owner`` passed to MMU_NOTIFY_EXCLUSIVE range notifier to allow filtering ``struct folio **foliop`` folio pointer will be stored here on success. **Description** This function looks up the page mapped at the given address, grabs a folio reference, locks the folio and replaces the PTE with special device-exclusive PFN swap entry, preventing access through the process page tables. The function will return with the folio locked and referenced. On fault, the device-exclusive entries are replaced with the original PTE under folio lock, after calling MMU notifiers. Only anonymous non-hugetlb folios are supported and the VMA must have write permissions such that we can fault in the anonymous page writable in order to mark it exclusive. The caller must hold the mmap_lock in read mode. A driver using this to program access from a device must use a mmu notifier critical section to hold a device specific lock during programming. Once programming is complete it should drop the folio lock and reference after which point CPU access to the page will revoke the exclusive access. **Notes** #. This function always operates on individual PTEs mapping individual pages. PMD-sized THPs are first remapped to be mapped by PTEs before the conversion happens on a single PTE corresponding to **addr**. #. While concurrent access through the process page tables is prevented, concurrent access through other page references (e.g., earlier GUP invocation) is not handled and not supported. #. device-exclusive entries are considered "clean" and "old" by core-mm. Device drivers must update the folio state when informed by MMU notifiers. **Return** pointer to mapped page on success, otherwise a negative error.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM hjubj)}(hhh](j)}(h@``struct mm_struct *mm`` mm_struct of associated target process h](j)}(h``struct mm_struct *mm``h]jS)}(hj!h]hstruct mm_struct *mm}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM hjubj)}(hhh]jM)}(h&mm_struct of associated target processh]h&mm_struct of associated target process}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj6hM hj7ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj6hM hjubj)}(hO``unsigned long addr`` the virtual address to mark for exclusive device access h](j)}(h``unsigned long addr``h]jS)}(hjZh]hunsigned long addr}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjXubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM hjTubj)}(hhh]jM)}(h7the virtual address to mark for exclusive device accessh]h7the virtual address to mark for exclusive device access}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjohM hjpubah}(h]h ]h"]h$]h&]uh1jhjTubeh}(h]h ]h"]h$]h&]uh1jhjohM hjubj)}(hQ``void *owner`` passed to MMU_NOTIFY_EXCLUSIVE range notifier to allow filtering h](j)}(h``void *owner``h]jS)}(hjh]h void *owner}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM hjubj)}(hhh]jM)}(h@passed to MMU_NOTIFY_EXCLUSIVE range notifier to allow filteringh]h@passed to MMU_NOTIFY_EXCLUSIVE range notifier to allow filtering}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hjubj)}(hH``struct folio **foliop`` folio pointer will be stored here on success. h](j)}(h``struct folio **foliop``h]jS)}(hj̏h]hstruct folio **foliop}(hjΏhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjʏubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM hjƏubj)}(hhh]jM)}(h-folio pointer will be stored here on success.h]h-folio pointer will be stored here on success.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjƏubeh}(h]h ]h"]h$]h&]uh1jhjhM hjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM hjubjM)}(hXThis function looks up the page mapped at the given address, grabs a folio reference, locks the folio and replaces the PTE with special device-exclusive PFN swap entry, preventing access through the process page tables. The function will return with the folio locked and referenced.h]hXThis function looks up the page mapped at the given address, grabs a folio reference, locks the folio and replaces the PTE with special device-exclusive PFN swap entry, preventing access through the process page tables. The function will return with the folio locked and referenced.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM hjubjM)}(hxOn fault, the device-exclusive entries are replaced with the original PTE under folio lock, after calling MMU notifiers.h]hxOn fault, the device-exclusive entries are replaced with the original PTE under folio lock, after calling MMU notifiers.}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM hjubjM)}(hOnly anonymous non-hugetlb folios are supported and the VMA must have write permissions such that we can fault in the anonymous page writable in order to mark it exclusive. The caller must hold the mmap_lock in read mode.h]hOnly anonymous non-hugetlb folios are supported and the VMA must have write permissions such that we can fault in the anonymous page writable in order to mark it exclusive. The caller must hold the mmap_lock in read mode.}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM hjubjM)}(hX#A driver using this to program access from a device must use a mmu notifier critical section to hold a device specific lock during programming. Once programming is complete it should drop the folio lock and reference after which point CPU access to the page will revoke the exclusive access.h]hX#A driver using this to program access from a device must use a mmu notifier critical section to hold a device specific lock during programming. Once programming is complete it should drop the folio lock and reference after which point CPU access to the page will revoke the exclusive access.}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM hjubjM)}(h **Notes**h]j)}(hj[h]hNotes}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjYubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM hjubji)}(hX.#. This function always operates on individual PTEs mapping individual pages. PMD-sized THPs are first remapped to be mapped by PTEs before the conversion happens on a single PTE corresponding to **addr**. #. While concurrent access through the process page tables is prevented, concurrent access through other page references (e.g., earlier GUP invocation) is not handled and not supported. #. device-exclusive entries are considered "clean" and "old" by core-mm. Device drivers must update the folio state when informed by MMU notifiers. h]jM)}(hhh](jc)}(hThis function always operates on individual PTEs mapping individual pages. PMD-sized THPs are first remapped to be mapped by PTEs before the conversion happens on a single PTE corresponding to **addr**.h]jM)}(hThis function always operates on individual PTEs mapping individual pages. PMD-sized THPs are first remapped to be mapped by PTEs before the conversion happens on a single PTE corresponding to **addr**.h](hThis function always operates on individual PTEs mapping individual pages. PMD-sized THPs are first remapped to be mapped by PTEs before the conversion happens on a single PTE corresponding to }(hj|hhhNhNubj)}(h**addr**h]haddr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj|ubh.}(hj|hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM hjxubah}(h]h ]h"]h$]h&]uh1jbhjuubjc)}(hWhile concurrent access through the process page tables is prevented, concurrent access through other page references (e.g., earlier GUP invocation) is not handled and not supported.h]jM)}(hWhile concurrent access through the process page tables is prevented, concurrent access through other page references (e.g., earlier GUP invocation) is not handled and not supported.h]hWhile concurrent access through the process page tables is prevented, concurrent access through other page references (e.g., earlier GUP invocation) is not handled and not supported.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM! hjubah}(h]h ]h"]h$]h&]uh1jbhjuubjc)}(hdevice-exclusive entries are considered "clean" and "old" by core-mm. Device drivers must update the folio state when informed by MMU notifiers. h]jM)}(hdevice-exclusive entries are considered "clean" and "old" by core-mm. Device drivers must update the folio state when informed by MMU notifiers.h]hdevice-exclusive entries are considered “clean” and “old” by core-mm. Device drivers must update the folio state when informed by MMU notifiers.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM$ hjubah}(h]h ]h"]h$]h&]uh1jbhjuubeh}(h]h ]h"]h$]h&]j?Nj@NjANhjBNjCNuh1jMhjqubah}(h]h ]h"]h$]h&]uh1jhhjhM hjubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM( hjubjM)}(h>pointer to mapped page on success, otherwise a negative error.h]h>pointer to mapped page on success, otherwise a negative error.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM) hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h__rmap_walk_file (C function)c.__rmap_walk_filehNtauh1hhjKhhhNhNubh)}(hhh](h)}(hvoid __rmap_walk_file (struct folio *folio, struct address_space *mapping, pgoff_t pgoff_start, unsigned long nr_pages, struct rmap_walk_control *rwc, bool locked)h]h)}(hvoid __rmap_walk_file(struct folio *folio, struct address_space *mapping, pgoff_t pgoff_start, unsigned long nr_pages, struct rmap_walk_control *rwc, bool locked)h](j)}(hvoidh]hvoid}(hj(hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$hhhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM ubj)}(h h]h }(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$hhhj6hM ubh)}(h__rmap_walk_fileh]j)}(h__rmap_walk_fileh]h__rmap_walk_file}(hjIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEubah}(h]h ](jjeh"]h$]h&]jjuh1hhj$hhhj6hM ubj8)}(h(struct folio *folio, struct address_space *mapping, pgoff_t pgoff_start, unsigned long nr_pages, struct rmap_walk_control *rwc, bool locked)h](j>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hjehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubj)}(h h]h }(hjrhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubh)}(hhh]j)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjKsbc.__rmap_walk_fileasbuh1hhjaubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjaubj)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj]ubj>)}(hstruct address_space *mappingh](j)}(hjJ,h]hstruct}(hjבhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjӑubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjӑubh)}(hhh]j)}(h address_spaceh]h address_space}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.__rmap_walk_fileasbuh1hhjӑubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjӑubjr)}(hjuh]h*}(hj!hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjӑubj)}(hmappingh]hmapping}(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjӑubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj]ubj>)}(hpgoff_t pgoff_starth](h)}(hhh]j)}(hpgoff_th]hpgoff_t}(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjLmodnameN classnameNjj)}j]jc.__rmap_walk_fileasbuh1hhjCubj)}(h h]h }(hjhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCubj)}(h pgoff_starth]h pgoff_start}(hjvhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj]ubj>)}(hunsigned long nr_pagesh](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hnr_pagesh]hnr_pages}(hjǒhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj]ubj>)}(hstruct rmap_walk_control *rwch](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjܒubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjܒubh)}(hhh]j)}(hrmap_walk_controlh]hrmap_walk_control}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.__rmap_walk_fileasbuh1hhjܒubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjܒubjr)}(hjuh]h*}(hj*hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjܒubj)}(hrwch]hrwc}(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjܒubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj]ubj>)}(h bool lockedh](j)}(hjh]hbool}(hjPhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjLubj)}(h h]h }(hj]hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjLubj)}(hlockedh]hlocked}(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjLubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj]ubeh}(h]h ]h"]h$]h&]jjuh1j7hj$hhhj6hM ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj hhhj6hM ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj6hM hjhhubj4)}(hhh]jM)}(hTraverse the reverse mapping for a file-backed mapping of a page mapped within a specified page cache object at a specified offset.h]hTraverse the reverse mapping for a file-backed mapping of a page mapped within a specified page cache object at a specified offset.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM hjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhj6hM ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct folio *folio`` Either the folio whose mappings to traverse, or if NULL, the callbacks specified in **rwc** will be configured such as to be able to look up mappings correctly. ``struct address_space *mapping`` The page cache object whose mapping VMAs we intend to traverse. If **folio** is non-NULL, this should be equal to folio_mapping(folio). ``pgoff_t pgoff_start`` The offset within **mapping** of the page which we are looking up. If **folio** is non-NULL, this should be equal to folio_pgoff(folio). ``unsigned long nr_pages`` The number of pages mapped by the mapping. If **folio** is non-NULL, this should be equal to folio_nr_pages(folio). ``struct rmap_walk_control *rwc`` The reverse mapping walk control object describing how the traversal should proceed. ``bool locked`` Is the **mapping** already locked? If not, we acquire the lock.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM hjubj)}(hhh](j)}(h``struct folio *folio`` Either the folio whose mappings to traverse, or if NULL, the callbacks specified in **rwc** will be configured such as to be able to look up mappings correctly. h](j)}(h``struct folio *folio``h]jS)}(hj֓h]hstruct folio *folio}(hjؓhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjԓubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM hjГubj)}(hhh]jM)}(hEither the folio whose mappings to traverse, or if NULL, the callbacks specified in **rwc** will be configured such as to be able to look up mappings correctly.h](hTEither the folio whose mappings to traverse, or if NULL, the callbacks specified in }(hjhhhNhNubj)}(h**rwc**h]hrwc}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhE will be configured such as to be able to look up mappings correctly.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM hjubah}(h]h ]h"]h$]h&]uh1jhjГubeh}(h]h ]h"]h$]h&]uh1jhjhM hj͓ubj)}(h``struct address_space *mapping`` The page cache object whose mapping VMAs we intend to traverse. If **folio** is non-NULL, this should be equal to folio_mapping(folio). h](j)}(h!``struct address_space *mapping``h]jS)}(hj"h]hstruct address_space *mapping}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj ubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM hjubj)}(hhh]jM)}(hThe page cache object whose mapping VMAs we intend to traverse. If **folio** is non-NULL, this should be equal to folio_mapping(folio).h](hCThe page cache object whose mapping VMAs we intend to traverse. If }(hj;hhhNhNubj)}(h **folio**h]hfolio}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1jhj;ubh; is non-NULL, this should be equal to folio_mapping(folio).}(hj;hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM hj8ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj7hM hj͓ubj)}(h``pgoff_t pgoff_start`` The offset within **mapping** of the page which we are looking up. If **folio** is non-NULL, this should be equal to folio_pgoff(folio). h](j)}(h``pgoff_t pgoff_start``h]jS)}(hjnh]hpgoff_t pgoff_start}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjlubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM hjhubj)}(hhh]jM)}(hThe offset within **mapping** of the page which we are looking up. If **folio** is non-NULL, this should be equal to folio_pgoff(folio).h](hThe offset within }(hjhhhNhNubj)}(h **mapping**h]hmapping}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh) of the page which we are looking up. If }(hjhhhNhNubj)}(h **folio**h]hfolio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh9 is non-NULL, this should be equal to folio_pgoff(folio).}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM hjubah}(h]h ]h"]h$]h&]uh1jhjhubeh}(h]h ]h"]h$]h&]uh1jhjhM hj͓ubj)}(h``unsigned long nr_pages`` The number of pages mapped by the mapping. If **folio** is non-NULL, this should be equal to folio_nr_pages(folio). h](j)}(h``unsigned long nr_pages``h]jS)}(hj̔h]hunsigned long nr_pages}(hjΔhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjʔubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM hjƔubj)}(hhh]jM)}(hsThe number of pages mapped by the mapping. If **folio** is non-NULL, this should be equal to folio_nr_pages(folio).h](h.The number of pages mapped by the mapping. If }(hjhhhNhNubj)}(h **folio**h]hfolio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh< is non-NULL, this should be equal to folio_nr_pages(folio).}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM hjubah}(h]h ]h"]h$]h&]uh1jhjƔubeh}(h]h ]h"]h$]h&]uh1jhjhM hj͓ubj)}(hw``struct rmap_walk_control *rwc`` The reverse mapping walk control object describing how the traversal should proceed. h](j)}(h!``struct rmap_walk_control *rwc``h]jS)}(hjh]hstruct rmap_walk_control *rwc}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM hjubj)}(hhh]jM)}(hTThe reverse mapping walk control object describing how the traversal should proceed.h]hTThe reverse mapping walk control object describing how the traversal should proceed.}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM hj.ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj-hM hj͓ubj)}(hO``bool locked`` Is the **mapping** already locked? If not, we acquire the lock.h](j)}(h``bool locked``h]jS)}(hjRh]h bool locked}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjPubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:126: ./mm/rmap.chM hjLubj)}(hhh]jM)}(h?Is the **mapping** already locked? If not, we acquire the lock.h](hIs the }(hjkhhhNhNubj)}(h **mapping**h]hmapping}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1jhjkubh- already locked? If not, we acquire the lock.}(hjkhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhjghM hjhubah}(h]h ]h"]h$]h&]uh1jhjLubeh}(h]h ]h"]h$]h&]uh1jhjghM hj͓ubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h%isolate_movable_ops_page (C function)c.isolate_movable_ops_pagehNtauh1hhjKhhhNhNubh)}(hhh](h)}(hFbool isolate_movable_ops_page (struct page *page, isolate_mode_t mode)h]h)}(hEbool isolate_movable_ops_page(struct page *page, isolate_mode_t mode)h](j)}(hjh]hbool}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:127: ./mm/migrate.chKeubj)}(h h]h }(hj˕hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjʕhKeubh)}(hisolate_movable_ops_pageh]j)}(hisolate_movable_ops_pageh]hisolate_movable_ops_page}(hjݕhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjٕubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjʕhKeubj8)}(h((struct page *page, isolate_mode_t mode)h](j>)}(hstruct page *pageh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hpageh]hpage}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjߕsbc.isolate_movable_ops_pageasbuh1hhjubj)}(h h]h }(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjEhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hpageh]hpage}(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hisolate_mode_t modeh](h)}(hhh]j)}(hisolate_mode_th]hisolate_mode_t}(hjnhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjkubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjpmodnameN classnameNjj)}j]j3c.isolate_movable_ops_pageasbuh1hhjgubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubj)}(hmodeh]hmode}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjʕhKeubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjʕhKeubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjʕhKehjhhubj4)}(hhh]jM)}(h(isolate a movable_ops page for migrationh]h(isolate a movable_ops page for migration}(hjĖhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:127: ./mm/migrate.chKehjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjʕhKeubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjܖjHjܖjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct page *page`` The page. ``isolate_mode_t mode`` The isolation mode. **Description** Try to isolate a movable_ops page for migration. Will fail if the page is not a movable_ops page, if the page is already isolated for migration or if the page was just was released by its owner. Once isolated, the page cannot get freed until it is either putback or migrated. Returns true if isolation succeeded, otherwise false.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:127: ./mm/migrate.chKihjubj)}(hhh](j)}(h ``struct page *page`` The page. h](j)}(h``struct page *page``h]jS)}(hjh]hstruct page *page}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:127: ./mm/migrate.chKfhjubj)}(hhh]jM)}(h The page.h]h The page.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhKfhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKfhjubj)}(h,``isolate_mode_t mode`` The isolation mode. h](j)}(h``isolate_mode_t mode``h]jS)}(hj>h]hisolate_mode_t mode}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj<ubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:127: ./mm/migrate.chKghj8ubj)}(hhh]jM)}(hThe isolation mode.h]hThe isolation mode.}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjShKghjTubah}(h]h ]h"]h$]h&]uh1jhj8ubeh}(h]h ]h"]h$]h&]uh1jhjShKghjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjyh]h Description}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjwubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:127: ./mm/migrate.chKihjubjM)}(hTry to isolate a movable_ops page for migration. Will fail if the page is not a movable_ops page, if the page is already isolated for migration or if the page was just was released by its owner.h]hTry to isolate a movable_ops page for migration. Will fail if the page is not a movable_ops page, if the page is already isolated for migration or if the page was just was released by its owner.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:127: ./mm/migrate.chKhhjubjM)}(hPOnce isolated, the page cannot get freed until it is either putback or migrated.h]hPOnce isolated, the page cannot get freed until it is either putback or migrated.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:127: ./mm/migrate.chKlhjubjM)}(h5Returns true if isolation succeeded, otherwise false.h]h5Returns true if isolation succeeded, otherwise false.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:127: ./mm/migrate.chKohjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h%putback_movable_ops_page (C function)c.putback_movable_ops_pagehNtauh1hhjKhhhNhNubh)}(hhh](h)}(h1void putback_movable_ops_page (struct page *page)h]h)}(h0void putback_movable_ops_page(struct page *page)h](j)}(hvoidh]hvoid}(hjܗhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjؗhhhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:127: ./mm/migrate.chKubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjؗhhhjhKubh)}(hputback_movable_ops_pageh]j)}(hputback_movable_ops_pageh]hputback_movable_ops_page}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjؗhhhjhKubj8)}(h(struct page *page)h]j>)}(hstruct page *pageh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hpageh]hpage}(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj9modnameN classnameNjj)}j]j)}jjsbc.putback_movable_ops_pageasbuh1hhjubj)}(h h]h }(hjWhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjehhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hpageh]hpage}(hjrhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjؗhhhjhKubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjԗhhhjhKubah}(h]jϗah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhKhjїhhubj4)}(hhh]jM)}(h$putback an isolated movable_ops pageh]h$putback an isolated movable_ops page}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:127: ./mm/migrate.chKhjhhubah}(h]h ]h"]h$]h&]uh1j3hjїhhhjhKubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``struct page *page`` The isolated page. **Description** Putback an isolated movable_ops page. After the page was putback, it might get freed instantly.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:127: ./mm/migrate.chKhjubj)}(hhh]j)}(h)``struct page *page`` The isolated page. h](j)}(h``struct page *page``h]jS)}(hjݘh]hstruct page *page}(hjߘhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjۘubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:127: ./mm/migrate.chKhjטubj)}(hhh]jM)}(hThe isolated page.h]hThe isolated page.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjטubeh}(h]h ]h"]h$]h&]uh1jhjhKhjԘubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:127: ./mm/migrate.chKhjubjM)}(h%Putback an isolated movable_ops page.h]h%Putback an isolated movable_ops page.}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:127: ./mm/migrate.chKhjubjM)}(h9After the page was putback, it might get freed instantly.h]h9After the page was putback, it might get freed instantly.}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:127: ./mm/migrate.chKhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h%migrate_movable_ops_page (C function)c.migrate_movable_ops_pagehNtauh1hhjKhhhNhNubh)}(hhh](h)}(hYint migrate_movable_ops_page (struct page *dst, struct page *src, enum migrate_mode mode)h]h)}(hXint migrate_movable_ops_page(struct page *dst, struct page *src, enum migrate_mode mode)h](j)}(hinth]hint}(hjlhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:127: ./mm/migrate.chKubj)}(h h]h }(hj{hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhhjzhKubh)}(hmigrate_movable_ops_pageh]j)}(hmigrate_movable_ops_pageh]hmigrate_movable_ops_page}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhhjzhKubj8)}(h<(struct page *dst, struct page *src, enum migrate_mode mode)h](j>)}(hstruct page *dsth](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hpageh]hpage}(hjǙhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjęubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjəmodnameN classnameNjj)}j]j)}jjsbc.migrate_movable_ops_pageasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hdsth]hdst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hstruct page *srch](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj(hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hpageh]hpage}(hj9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj6ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj;modnameN classnameNjj)}j]jc.migrate_movable_ops_pageasbuh1hhjubj)}(h h]h }(hjWhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjehhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hsrch]hsrc}(hjrhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(henum migrate_mode modeh](j)}(hj#!h]henum}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(h migrate_modeh]h migrate_mode}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.migrate_movable_ops_pageasbuh1hhjubj)}(h h]h }(hjǚhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hmodeh]hmode}(hj՚hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhhjzhKubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjdhhhjzhKubah}(h]j_ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjzhKhjahhubj4)}(hhh]jM)}(h$migrate an isolated movable_ops pageh]h$migrate an isolated movable_ops page}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:127: ./mm/migrate.chKhjhhubah}(h]h ]h"]h$]h&]uh1j3hjahhhjzhKubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct page *dst`` The destination page. ``struct page *src`` The source page. ``enum migrate_mode mode`` The migration mode. **Description** Migrate an isolated movable_ops page. If the src page was already released by its owner, the src page is un-isolated (putback) and migration succeeds; the migration core will be the owner of both pages. If the src page was not released by its owner and the migration was successful, the owner of the src page and the dst page are swapped and the src page is un-isolated. If migration fails, the ownership stays unmodified and the src page remains isolated: migration may be retried later or the page can be putback. TODO: migration core will treat both pages as folios and lock them before this call to unlock them after this call. Further, the folio refcounts on src and dst are also released by migration core. These pages will not be folios in the future, so that must be reworked. Returns 0 on success, otherwise a negative error code.h](jM)}(h**Parameters**h]j)}(hj!h]h Parameters}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:127: ./mm/migrate.chKhjubj)}(hhh](j)}(h+``struct page *dst`` The destination page. h](j)}(h``struct page *dst``h]jS)}(hj@h]hstruct page *dst}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj>ubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:127: ./mm/migrate.chKhj:ubj)}(hhh]jM)}(hThe destination page.h]hThe destination page.}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjUhKhjVubah}(h]h ]h"]h$]h&]uh1jhj:ubeh}(h]h ]h"]h$]h&]uh1jhjUhKhj7ubj)}(h&``struct page *src`` The source page. h](j)}(h``struct page *src``h]jS)}(hjyh]hstruct page *src}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjwubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:127: ./mm/migrate.chKhjsubj)}(hhh]jM)}(hThe source page.h]hThe source page.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjsubeh}(h]h ]h"]h$]h&]uh1jhjhKhj7ubj)}(h/``enum migrate_mode mode`` The migration mode. h](j)}(h``enum migrate_mode mode``h]jS)}(hjh]henum migrate_mode mode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:127: ./mm/migrate.chKhjubj)}(hhh]jM)}(hThe migration mode.h]hThe migration mode.}(hj˛hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjǛhKhjțubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjǛhKhj7ubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:127: ./mm/migrate.chKhjubjM)}(h%Migrate an isolated movable_ops page.h]h%Migrate an isolated movable_ops page.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:127: ./mm/migrate.chKhjubjM)}(hIf the src page was already released by its owner, the src page is un-isolated (putback) and migration succeeds; the migration core will be the owner of both pages.h]hIf the src page was already released by its owner, the src page is un-isolated (putback) and migration succeeds; the migration core will be the owner of both pages.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:127: ./mm/migrate.chKhjubjM)}(hIf the src page was not released by its owner and the migration was successful, the owner of the src page and the dst page are swapped and the src page is un-isolated.h]hIf the src page was not released by its owner and the migration was successful, the owner of the src page and the dst page are swapped and the src page is un-isolated.}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:127: ./mm/migrate.chKhjubjM)}(hIf migration fails, the ownership stays unmodified and the src page remains isolated: migration may be retried later or the page can be putback.h]hIf migration fails, the ownership stays unmodified and the src page remains isolated: migration may be retried later or the page can be putback.}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:127: ./mm/migrate.chKhjubjM)}(hX TODO: migration core will treat both pages as folios and lock them before this call to unlock them after this call. Further, the folio refcounts on src and dst are also released by migration core. These pages will not be folios in the future, so that must be reworked.h]hX TODO: migration core will treat both pages as folios and lock them before this call to unlock them after this call. Further, the folio refcounts on src and dst are also released by migration core. These pages will not be folios in the future, so that must be reworked.}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:127: ./mm/migrate.chKhjubjM)}(h6Returns 0 on success, otherwise a negative error code.h]h6Returns 0 on success, otherwise a negative error code.}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:127: ./mm/migrate.chKhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hmigrate_folio (C function)c.migrate_foliohNtauh1hhjKhhhNhNubh)}(hhh](h)}(hoint migrate_folio (struct address_space *mapping, struct folio *dst, struct folio *src, enum migrate_mode mode)h]h)}(hnint migrate_folio(struct address_space *mapping, struct folio *dst, struct folio *src, enum migrate_mode mode)h](j)}(hinth]hint}(hj}hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyhhhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:127: ./mm/migrate.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyhhhjhMubh)}(h migrate_folioh]j)}(h migrate_folioh]h migrate_folio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjyhhhjhMubj8)}(h](struct address_space *mapping, struct folio *dst, struct folio *src, enum migrate_mode mode)h](j>)}(hstruct address_space *mappingh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjǜhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(h address_spaceh]h address_space}(hj؜hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj՜ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjڜmodnameN classnameNjj)}j]j)}jjsbc.migrate_folioasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hmappingh]hmapping}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hstruct folio *dsth](j)}(hjJ,h]hstruct}(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(ubj)}(h h]h }(hj9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(ubh)}(hhh]j)}(hfolioh]hfolio}(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjLmodnameN classnameNjj)}j]jc.migrate_folioasbuh1hhj(ubj)}(h h]h }(hjhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(ubjr)}(hjuh]h*}(hjvhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj(ubj)}(hdsth]hdst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hstruct folio *srch](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.migrate_folioasbuh1hhjubj)}(h h]h }(hj؝hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hsrch]hsrc}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(henum migrate_mode modeh](j)}(hj#!h]henum}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(h migrate_modeh]h migrate_mode}(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj'ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj,modnameN classnameNjj)}j]jc.migrate_folioasbuh1hhjubj)}(h h]h }(hjHhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hmodeh]hmode}(hjVhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjyhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjuhhhjhMubah}(h]jpah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjrhhubj4)}(hhh]jM)}(hSimple folio migration.h]hSimple folio migration.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:127: ./mm/migrate.chMhj}hhubah}(h]h ]h"]h$]h&]uh1j3hjrhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct address_space *mapping`` The address_space containing the folio. ``struct folio *dst`` The folio to migrate the data to. ``struct folio *src`` The folio containing the current data. ``enum migrate_mode mode`` How to migrate the folio. **Description** Common logic to directly migrate a single LRU folio suitable for folios that do not have private data. Folios are locked upon entry and exit.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:127: ./mm/migrate.chMhjubj)}(hhh](j)}(hJ``struct address_space *mapping`` The address_space containing the folio. h](j)}(h!``struct address_space *mapping``h]jS)}(hjh]hstruct address_space *mapping}(hjÞhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:127: ./mm/migrate.chMhjubj)}(hhh]jM)}(h'The address_space containing the folio.h]h'The address_space containing the folio.}(hjڞhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj֞hMhjמubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj֞hMhjubj)}(h8``struct folio *dst`` The folio to migrate the data to. h](j)}(h``struct folio *dst``h]jS)}(hjh]hstruct folio *dst}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:127: ./mm/migrate.chMhjubj)}(hhh]jM)}(h!The folio to migrate the data to.h]h!The folio to migrate the data to.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h=``struct folio *src`` The folio containing the current data. h](j)}(h``struct folio *src``h]jS)}(hj3h]hstruct folio *src}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj1ubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:127: ./mm/migrate.chMhj-ubj)}(hhh]jM)}(h&The folio containing the current data.h]h&The folio containing the current data.}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjHhMhjIubah}(h]h ]h"]h$]h&]uh1jhj-ubeh}(h]h ]h"]h$]h&]uh1jhjHhMhjubj)}(h5``enum migrate_mode mode`` How to migrate the folio. h](j)}(h``enum migrate_mode mode``h]jS)}(hjlh]henum migrate_mode mode}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:127: ./mm/migrate.chMhjfubj)}(hhh]jM)}(hHow to migrate the folio.h]hHow to migrate the folio.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjfubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:127: ./mm/migrate.chMhjubjM)}(hfCommon logic to directly migrate a single LRU folio suitable for folios that do not have private data.h]hfCommon logic to directly migrate a single LRU folio suitable for folios that do not have private data.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:127: ./mm/migrate.chMhjubjM)}(h&Folios are locked upon entry and exit.h]h&Folios are locked upon entry and exit.}(hj̟hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:127: ./mm/migrate.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h!buffer_migrate_folio (C function)c.buffer_migrate_foliohNtauh1hhjKhhhNhNubh)}(hhh](h)}(hvint buffer_migrate_folio (struct address_space *mapping, struct folio *dst, struct folio *src, enum migrate_mode mode)h]h)}(huint buffer_migrate_folio(struct address_space *mapping, struct folio *dst, struct folio *src, enum migrate_mode mode)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:127: ./mm/migrate.chMubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhj hMubh)}(hbuffer_migrate_folioh]j)}(hbuffer_migrate_folioh]hbuffer_migrate_folio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhj hMubj8)}(h](struct address_space *mapping, struct folio *dst, struct folio *src, enum migrate_mode mode)h](j>)}(hstruct address_space *mappingh](j)}(hjJ,h]hstruct}(hj8hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4ubj)}(h h]h }(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4ubh)}(hhh]j)}(h address_spaceh]h address_space}(hjVhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjXmodnameN classnameNjj)}j]j)}jjsbc.buffer_migrate_folioasbuh1hhj4ubj)}(h h]h }(hjvhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4ubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj4ubj)}(hmappingh]hmapping}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj0ubj>)}(hstruct folio *dsth](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hfolioh]hfolio}(hjȠhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjŠubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjʠmodnameN classnameNjj)}j]jrc.buffer_migrate_folioasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hdsth]hdst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj0ubj>)}(hstruct folio *srch](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hfolioh]hfolio}(hj8hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj:modnameN classnameNjj)}j]jrc.buffer_migrate_folioasbuh1hhjubj)}(h h]h }(hjVhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjdhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hsrch]hsrc}(hjqhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj0ubj>)}(henum migrate_mode modeh](j)}(hj#!h]henum}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(h migrate_modeh]h migrate_mode}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jrc.buffer_migrate_folioasbuh1hhjubj)}(h h]h }(hjơhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hmodeh]hmode}(hjԡhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj0ubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhj hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhj hMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj hMhjhhubj4)}(hhh]jM)}(h+Migration function for folios with buffers.h]h+Migration function for folios with buffers.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:127: ./mm/migrate.chMhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhj hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hXi**Parameters** ``struct address_space *mapping`` The address space containing **src**. ``struct folio *dst`` The folio to migrate to. ``struct folio *src`` The folio to migrate from. ``enum migrate_mode mode`` How to migrate the folio. **Description** This function can only be used if the underlying filesystem guarantees that no other references to **src** exist. For example attached buffer heads are accessed only under the folio lock. If your filesystem cannot provide this guarantee, buffer_migrate_folio_norefs() may be more appropriate. **Return** 0 on success or a negative errno on failure.h](jM)}(h**Parameters**h]j)}(hj h]h Parameters}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:127: ./mm/migrate.chMhjubj)}(hhh](j)}(hH``struct address_space *mapping`` The address space containing **src**. h](j)}(h!``struct address_space *mapping``h]jS)}(hj?h]hstruct address_space *mapping}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj=ubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:127: ./mm/migrate.chMhj9ubj)}(hhh]jM)}(h%The address space containing **src**.h](hThe address space containing }(hjXhhhNhNubj)}(h**src**h]hsrc}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjXubh.}(hjXhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhjThMhjUubah}(h]h ]h"]h$]h&]uh1jhj9ubeh}(h]h ]h"]h$]h&]uh1jhjThMhj6ubj)}(h/``struct folio *dst`` The folio to migrate to. h](j)}(h``struct folio *dst``h]jS)}(hjh]hstruct folio *dst}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:127: ./mm/migrate.chMhjubj)}(hhh]jM)}(hThe folio to migrate to.h]hThe folio to migrate to.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhj6ubj)}(h1``struct folio *src`` The folio to migrate from. h](j)}(h``struct folio *src``h]jS)}(hjâh]hstruct folio *src}(hjŢhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:127: ./mm/migrate.chMhjubj)}(hhh]jM)}(hThe folio to migrate from.h]hThe folio to migrate from.}(hjܢhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjآhMhj٢ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjآhMhj6ubj)}(h5``enum migrate_mode mode`` How to migrate the folio. h](j)}(h``enum migrate_mode mode``h]jS)}(hjh]henum migrate_mode mode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:127: ./mm/migrate.chMhjubj)}(hhh]jM)}(hHow to migrate the folio.h]hHow to migrate the folio.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhj6ubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hj7h]h Description}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj5ubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:127: ./mm/migrate.chMhjubjM)}(hX%This function can only be used if the underlying filesystem guarantees that no other references to **src** exist. For example attached buffer heads are accessed only under the folio lock. If your filesystem cannot provide this guarantee, buffer_migrate_folio_norefs() may be more appropriate.h](hcThis function can only be used if the underlying filesystem guarantees that no other references to }(hjMhhhNhNubj)}(h**src**h]hsrc}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjMubh exist. For example attached buffer heads are accessed only under the folio lock. If your filesystem cannot provide this guarantee, buffer_migrate_folio_norefs() may be more appropriate.}(hjMhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:127: ./mm/migrate.chMhjubjM)}(h **Return**h]j)}(hjph]hReturn}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjnubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:127: ./mm/migrate.chMhjubjM)}(h,0 on success or a negative errno on failure.h]h,0 on success or a negative errno on failure.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:127: ./mm/migrate.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h(buffer_migrate_folio_norefs (C function)c.buffer_migrate_folio_norefshNtauh1hhjKhhhNhNubh)}(hhh](h)}(h}int buffer_migrate_folio_norefs (struct address_space *mapping, struct folio *dst, struct folio *src, enum migrate_mode mode)h]h)}(h|int buffer_migrate_folio_norefs(struct address_space *mapping, struct folio *dst, struct folio *src, enum migrate_mode mode)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:127: ./mm/migrate.chMubj)}(h h]h }(hjģhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjãhMubh)}(hbuffer_migrate_folio_norefsh]j)}(hbuffer_migrate_folio_norefsh]hbuffer_migrate_folio_norefs}(hj֣hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjңubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjãhMubj8)}(h](struct address_space *mapping, struct folio *dst, struct folio *src, enum migrate_mode mode)h](j>)}(hstruct address_space *mappingh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(h address_spaceh]h address_space}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjأsbc.buffer_migrate_folio_norefsasbuh1hhjubj)}(h h]h }(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hj>hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hmappingh]hmapping}(hjKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hstruct folio *dsth](j)}(hjJ,h]hstruct}(hjdhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj`ubj)}(h h]h }(hjqhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj`ubh)}(hhh]j)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j,c.buffer_migrate_folio_norefsasbuh1hhj`ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj`ubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj`ubj)}(hdsth]hdst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj`ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hstruct folio *srch](j)}(hjJ,h]hstruct}(hjԤhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjФubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjФubh)}(hhh]j)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j,c.buffer_migrate_folio_norefsasbuh1hhjФubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjФubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjФubj)}(hsrch]hsrc}(hj+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjФubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(henum migrate_mode modeh](j)}(hj#!h]henum}(hjDhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@ubj)}(h h]h }(hjQhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@ubh)}(hhh]j)}(h migrate_modeh]h migrate_mode}(hjbhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj_ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjdmodnameN classnameNjj)}j]j,c.buffer_migrate_folio_norefsasbuh1hhj@ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@ubj)}(hmodeh]hmode}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjãhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjãhMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjãhMhjhhubj4)}(hhh]jM)}(h+Migration function for folios with buffers.h]h+Migration function for folios with buffers.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:127: ./mm/migrate.chMhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjãhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjХjHjХjIjJjKuh1hhhhjKhNhNubj)}(hXH**Parameters** ``struct address_space *mapping`` The address space containing **src**. ``struct folio *dst`` The folio to migrate to. ``struct folio *src`` The folio to migrate from. ``enum migrate_mode mode`` How to migrate the folio. **Description** Like buffer_migrate_folio() except that this variant is more careful and checks that there are also no buffer head references. This function is the right one for mappings where buffer heads are directly looked up and referenced (such as block device mappings). **Return** 0 on success or a negative errno on failure.h](jM)}(h**Parameters**h]j)}(hjڥh]h Parameters}(hjܥhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjإubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:127: ./mm/migrate.chMhjԥubj)}(hhh](j)}(hH``struct address_space *mapping`` The address space containing **src**. h](j)}(h!``struct address_space *mapping``h]jS)}(hjh]hstruct address_space *mapping}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:127: ./mm/migrate.chMhjubj)}(hhh]jM)}(h%The address space containing **src**.h](hThe address space containing }(hjhhhNhNubj)}(h**src**h]hsrc}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h/``struct folio *dst`` The folio to migrate to. h](j)}(h``struct folio *dst``h]jS)}(hjDh]hstruct folio *dst}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjBubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:127: ./mm/migrate.chMhj>ubj)}(hhh]jM)}(hThe folio to migrate to.h]hThe folio to migrate to.}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjYhMhjZubah}(h]h ]h"]h$]h&]uh1jhj>ubeh}(h]h ]h"]h$]h&]uh1jhjYhMhjubj)}(h1``struct folio *src`` The folio to migrate from. h](j)}(h``struct folio *src``h]jS)}(hj}h]hstruct folio *src}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj{ubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:127: ./mm/migrate.chMhjwubj)}(hhh]jM)}(hThe folio to migrate from.h]hThe folio to migrate from.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjwubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h5``enum migrate_mode mode`` How to migrate the folio. h](j)}(h``enum migrate_mode mode``h]jS)}(hjh]henum migrate_mode mode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:127: ./mm/migrate.chMhjubj)}(hhh]jM)}(hHow to migrate the folio.h]hHow to migrate the folio.}(hjϦhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj˦hMhj̦ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj˦hMhjubeh}(h]h ]h"]h$]h&]uh1jhjԥubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:127: ./mm/migrate.chMhjԥubjM)}(hXLike buffer_migrate_folio() except that this variant is more careful and checks that there are also no buffer head references. This function is the right one for mappings where buffer heads are directly looked up and referenced (such as block device mappings).h]hXLike buffer_migrate_folio() except that this variant is more careful and checks that there are also no buffer head references. This function is the right one for mappings where buffer heads are directly looked up and referenced (such as block device mappings).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:127: ./mm/migrate.chMhjԥubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:127: ./mm/migrate.chMhjԥubjM)}(h,0 on success or a negative errno on failure.h]h,0 on success or a negative errno on failure.}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:127: ./mm/migrate.chMhjԥubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hdo_mmap (C function) c.do_mmaphNtauh1hhjKhhhNhNubh)}(hhh](h)}(hunsigned long do_mmap (struct file *file, unsigned long addr, unsigned long len, unsigned long prot, unsigned long flags, vma_flags_t vma_flags, unsigned long pgoff, unsigned long *populate, struct list_head *uf)h]h)}(hunsigned long do_mmap(struct file *file, unsigned long addr, unsigned long len, unsigned long prot, unsigned long flags, vma_flags_t vma_flags, unsigned long pgoff, unsigned long *populate, struct list_head *uf)h](j)}(hunsignedh]hunsigned}(hj]hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjYhhhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:128: ./mm/mmap.chMubj)}(h h]h }(hjlhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjYhhhjkhMubj)}(hlongh]hlong}(hjzhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjYhhhjkhMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjYhhhjkhMubh)}(hdo_mmaph]j)}(hdo_mmaph]hdo_mmap}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjYhhhjkhMubj8)}(h(struct file *file, unsigned long addr, unsigned long len, unsigned long prot, unsigned long flags, vma_flags_t vma_flags, unsigned long pgoff, unsigned long *populate, struct list_head *uf)h](j>)}(hstruct file *fileh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjçhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hfileh]hfile}(hjԧhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjѧubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj֧modnameN classnameNjj)}j]j)}jjsb c.do_mmapasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hfileh]hfile}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hunsigned long addrh](j)}(hunsignedh]hunsigned}(hj(hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$ubj)}(h h]h }(hj6hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$ubj)}(hlongh]hlong}(hjDhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$ubj)}(h h]h }(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$ubj)}(haddrh]haddr}(hj`hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hunsigned long lenh](j)}(hunsignedh]hunsigned}(hjyhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjuubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjuubj)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjuubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjuubj)}(hlenh]hlen}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjuubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hunsigned long proth](j)}(hunsignedh]hunsigned}(hjʨhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjƨubj)}(h h]h }(hjبhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjƨubj)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjƨubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjƨubj)}(hproth]hprot}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjƨubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hunsigned long flagsh](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hlongh]hlong}(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hflagsh]hflags}(hjShhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hvma_flags_t vma_flagsh](h)}(hhh]j)}(h vma_flags_th]h vma_flags_t}(hjohhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjlubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjqmodnameN classnameNjj)}j]j c.do_mmapasbuh1hhjhubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhubj)}(h vma_flagsh]h vma_flags}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hunsigned long pgoffh](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj©hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hlongh]hlong}(hjЩhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjީhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hpgoffh]hpgoff}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hunsigned long *populateh](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hlongh]hlong}(hj!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hj=hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hpopulateh]hpopulate}(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hstruct list_head *ufh](j)}(hjJ,h]hstruct}(hjchhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj_ubj)}(h h]h }(hjphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj_ubh)}(hhh]j)}(h list_headh]h list_head}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j c.do_mmapasbuh1hhj_ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj_ubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj_ubj)}(hufh]huf}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj_ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjYhhhjkhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjUhhhjkhMubah}(h]jPah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjkhMhjRhhubj4)}(hhh]jM)}(hXaPerform a userland memory mapping into the current process address space of length **len** with protection bits **prot**, mmap flags **flags** (from which VMA flags will be inferred), and any additional VMA flags to apply **vma_flags**. If this is a file-backed mapping then the file is specified in **file** and page offset into the file via **pgoff**.h](hSPerform a userland memory mapping into the current process address space of length }(hjhhhNhNubj)}(h**len**h]hlen}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh with protection bits }(hjhhhNhNubj)}(h**prot**h]hprot}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh , mmap flags }(hjhhhNhNubj)}(h **flags**h]hflags}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhP (from which VMA flags will be inferred), and any additional VMA flags to apply }(hjhhhNhNubj)}(h **vma_flags**h]h vma_flags}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhA. If this is a file-backed mapping then the file is specified in }(hjhhhNhNubj)}(h**file**h]hfile}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh# and page offset into the file via }(hjhhhNhNubj)}(h **pgoff**h]hpgoff}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:128: ./mm/mmap.chMhjhhubah}(h]h ]h"]h$]h&]uh1j3hjRhhhjkhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjhjHjhjIjJjKuh1hhhhjKhNhNubj)}(hX5 **Parameters** ``struct file *file`` An optional struct file pointer describing the file which is to be mapped, if a file-backed mapping. ``unsigned long addr`` If non-zero, hints at (or if **flags** has MAP_FIXED set, specifies) the address at which to perform this mapping. See mmap (2) for details. Must be page-aligned. ``unsigned long len`` The length of the mapping. Will be page-aligned and must be at least 1 page in size. ``unsigned long prot`` Protection bits describing access required to the mapping. See mmap (2) for details. ``unsigned long flags`` Flags specifying how the mapping should be performed, see mmap (2) for details. ``vma_flags_t vma_flags`` VMA flags which should be set by default, or EMPTY_VMA_FLAGS otherwise. ``unsigned long pgoff`` Page offset into the **file** if file-backed, should be 0 otherwise. ``unsigned long *populate`` A pointer to a value which will be set to 0 if no population of the range is required, or the number of bytes to populate if it is. Must be non-NULL. See mmap (2) for details as to under what circumstances population of the range occurs. ``struct list_head *uf`` An optional pointer to a list head to track userfaultfd unmap events should unmapping events arise. If provided, it is up to the caller to manage this. **Description** This function does not perform security checks on the file and assumes, if **uf** is non-NULL, the caller has provided a list head to track unmap events for userfaultfd **uf**. It also simply indicates whether memory population is required by setting **populate**, which must be non-NULL, expecting the caller to actually perform this task itself if appropriate. This function will invoke architecture-specific (and if provided and relevant, file system-specific) logic to determine the most appropriate unmapped area in which to place the mapping if not MAP_FIXED. Callers which require userland mmap() behaviour should invoke vm_mmap(), which is also exported for module use. Those which require this behaviour less security checks, userfaultfd and populate behaviour, and who handle the mmap write lock themselves, should call this function. Note that the returned address may reside within a merged VMA if an appropriate merge were to take place, so it doesn't necessarily specify the start of a VMA, rather only the start of a valid mapped range of length **len** bytes, rounded down to the nearest page size. The caller must write-lock current->mm->mmap_lock. **Return** Either an error, or the address at which the requested mapping has been performed.h](jM)}(h**Parameters**h]j)}(hjrh]h Parameters}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jhjpubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:128: ./mm/mmap.chMhjlubj)}(hhh](j)}(h{``struct file *file`` An optional struct file pointer describing the file which is to be mapped, if a file-backed mapping. h](j)}(h``struct file *file``h]jS)}(hjh]hstruct file *file}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:128: ./mm/mmap.chM:hjubj)}(hhh]jM)}(hdAn optional struct file pointer describing the file which is to be mapped, if a file-backed mapping.h]hdAn optional struct file pointer describing the file which is to be mapped, if a file-backed mapping.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:128: ./mm/mmap.chM9hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM:hjubj)}(h``unsigned long addr`` If non-zero, hints at (or if **flags** has MAP_FIXED set, specifies) the address at which to perform this mapping. See mmap (2) for details. Must be page-aligned. h](j)}(h``unsigned long addr``h]jS)}(hj˫h]hunsigned long addr}(hjͫhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjɫubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:128: ./mm/mmap.chM=hjūubj)}(hhh]jM)}(hIf non-zero, hints at (or if **flags** has MAP_FIXED set, specifies) the address at which to perform this mapping. See mmap (2) for details. Must be page-aligned.h](hIf non-zero, hints at (or if }(hjhhhNhNubj)}(h **flags**h]hflags}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh| has MAP_FIXED set, specifies) the address at which to perform this mapping. See mmap (2) for details. Must be page-aligned.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:128: ./mm/mmap.chM;hjubah}(h]h ]h"]h$]h&]uh1jhjūubeh}(h]h ]h"]h$]h&]uh1jhjhM=hjubj)}(hk``unsigned long len`` The length of the mapping. Will be page-aligned and must be at least 1 page in size. h](j)}(h``unsigned long len``h]jS)}(hjh]hunsigned long len}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:128: ./mm/mmap.chM?hjubj)}(hhh]jM)}(hTThe length of the mapping. Will be page-aligned and must be at least 1 page in size.h]hTThe length of the mapping. Will be page-aligned and must be at least 1 page in size.}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:128: ./mm/mmap.chM>hj-ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj,hM?hjubj)}(hl``unsigned long prot`` Protection bits describing access required to the mapping. See mmap (2) for details. h](j)}(h``unsigned long prot``h]jS)}(hjQh]hunsigned long prot}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjOubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:128: ./mm/mmap.chMAhjKubj)}(hhh]jM)}(hTProtection bits describing access required to the mapping. See mmap (2) for details.h]hTProtection bits describing access required to the mapping. See mmap (2) for details.}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:128: ./mm/mmap.chM@hjgubah}(h]h ]h"]h$]h&]uh1jhjKubeh}(h]h ]h"]h$]h&]uh1jhjfhMAhjubj)}(hh``unsigned long flags`` Flags specifying how the mapping should be performed, see mmap (2) for details. h](j)}(h``unsigned long flags``h]jS)}(hjh]hunsigned long flags}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:128: ./mm/mmap.chMChjubj)}(hhh]jM)}(hOFlags specifying how the mapping should be performed, see mmap (2) for details.h]hOFlags specifying how the mapping should be performed, see mmap (2) for details.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:128: ./mm/mmap.chMBhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMChjubj)}(hb``vma_flags_t vma_flags`` VMA flags which should be set by default, or EMPTY_VMA_FLAGS otherwise. h](j)}(h``vma_flags_t vma_flags``h]jS)}(hjŬh]hvma_flags_t vma_flags}(hjǬhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjìubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:128: ./mm/mmap.chMEhjubj)}(hhh]jM)}(hGVMA flags which should be set by default, or EMPTY_VMA_FLAGS otherwise.h]hGVMA flags which should be set by default, or EMPTY_VMA_FLAGS otherwise.}(hjެhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:128: ./mm/mmap.chMDhj۬ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjڬhMEhjubj)}(h]``unsigned long pgoff`` Page offset into the **file** if file-backed, should be 0 otherwise. h](j)}(h``unsigned long pgoff``h]jS)}(hjh]hunsigned long pgoff}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:128: ./mm/mmap.chMFhjubj)}(hhh]jM)}(hDPage offset into the **file** if file-backed, should be 0 otherwise.h](hPage offset into the }(hjhhhNhNubj)}(h**file**h]hfile}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh' if file-backed, should be 0 otherwise.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhjhMFhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMFhjubj)}(hX ``unsigned long *populate`` A pointer to a value which will be set to 0 if no population of the range is required, or the number of bytes to populate if it is. Must be non-NULL. See mmap (2) for details as to under what circumstances population of the range occurs. h](j)}(h``unsigned long *populate``h]jS)}(hjJh]hunsigned long *populate}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjHubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:128: ./mm/mmap.chMJhjDubj)}(hhh]jM)}(hA pointer to a value which will be set to 0 if no population of the range is required, or the number of bytes to populate if it is. Must be non-NULL. See mmap (2) for details as to under what circumstances population of the range occurs.h]hA pointer to a value which will be set to 0 if no population of the range is required, or the number of bytes to populate if it is. Must be non-NULL. See mmap (2) for details as to under what circumstances population of the range occurs.}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:128: ./mm/mmap.chMGhj`ubah}(h]h ]h"]h$]h&]uh1jhjDubeh}(h]h ]h"]h$]h&]uh1jhj_hMJhjubj)}(h``struct list_head *uf`` An optional pointer to a list head to track userfaultfd unmap events should unmapping events arise. If provided, it is up to the caller to manage this. h](j)}(h``struct list_head *uf``h]jS)}(hjh]hstruct list_head *uf}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:128: ./mm/mmap.chMMhj~ubj)}(hhh]jM)}(hAn optional pointer to a list head to track userfaultfd unmap events should unmapping events arise. If provided, it is up to the caller to manage this.h]hAn optional pointer to a list head to track userfaultfd unmap events should unmapping events arise. If provided, it is up to the caller to manage this.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:128: ./mm/mmap.chMKhjubah}(h]h ]h"]h$]h&]uh1jhj~ubeh}(h]h ]h"]h$]h&]uh1jhjhMMhjubeh}(h]h ]h"]h$]h&]uh1jhjlubjM)}(h**Description**h]j)}(hjh]h Description}(hj­hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:128: ./mm/mmap.chMOhjlubjM)}(hThis function does not perform security checks on the file and assumes, if **uf** is non-NULL, the caller has provided a list head to track unmap events for userfaultfd **uf**.h](hKThis function does not perform security checks on the file and assumes, if }(hj֭hhhNhNubj)}(h**uf**h]huf}(hjޭhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj֭ubhX is non-NULL, the caller has provided a list head to track unmap events for userfaultfd }(hj֭hhhNhNubj)}(h**uf**h]huf}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj֭ubh.}(hj֭hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:128: ./mm/mmap.chMhjlubjM)}(hIt also simply indicates whether memory population is required by setting **populate**, which must be non-NULL, expecting the caller to actually perform this task itself if appropriate.h](hJIt also simply indicates whether memory population is required by setting }(hj hhhNhNubj)}(h **populate**h]hpopulate}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubhc, which must be non-NULL, expecting the caller to actually perform this task itself if appropriate.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:128: ./mm/mmap.chMhjlubjM)}(hThis function will invoke architecture-specific (and if provided and relevant, file system-specific) logic to determine the most appropriate unmapped area in which to place the mapping if not MAP_FIXED.h]hThis function will invoke architecture-specific (and if provided and relevant, file system-specific) logic to determine the most appropriate unmapped area in which to place the mapping if not MAP_FIXED.}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:128: ./mm/mmap.chM"hjlubjM)}(hoCallers which require userland mmap() behaviour should invoke vm_mmap(), which is also exported for module use.h]hoCallers which require userland mmap() behaviour should invoke vm_mmap(), which is also exported for module use.}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:128: ./mm/mmap.chM&hjlubjM)}(hThose which require this behaviour less security checks, userfaultfd and populate behaviour, and who handle the mmap write lock themselves, should call this function.h]hThose which require this behaviour less security checks, userfaultfd and populate behaviour, and who handle the mmap write lock themselves, should call this function.}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:128: ./mm/mmap.chM)hjlubjM)}(hX Note that the returned address may reside within a merged VMA if an appropriate merge were to take place, so it doesn't necessarily specify the start of a VMA, rather only the start of a valid mapped range of length **len** bytes, rounded down to the nearest page size.h](hNote that the returned address may reside within a merged VMA if an appropriate merge were to take place, so it doesn’t necessarily specify the start of a VMA, rather only the start of a valid mapped range of length }(hjWhhhNhNubj)}(h**len**h]hlen}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjWubh. bytes, rounded down to the nearest page size.}(hjWhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:128: ./mm/mmap.chM-hjlubjM)}(h2The caller must write-lock current->mm->mmap_lock.h]h2The caller must write-lock current->mm->mmap_lock.}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:128: ./mm/mmap.chM2hjlubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:128: ./mm/mmap.chM4hjlubjM)}(hREither an error, or the address at which the requested mapping has been performed.h]hREither an error, or the address at which the requested mapping has been performed.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:128: ./mm/mmap.chMOhjlubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h"find_vma_intersection (C function)c.find_vma_intersectionhNtauh1hhjKhhhNhNubh)}(hhh](h)}(hvstruct vm_area_struct * find_vma_intersection (struct mm_struct *mm, unsigned long start_addr, unsigned long end_addr)h]h)}(htstruct vm_area_struct *find_vma_intersection(struct mm_struct *mm, unsigned long start_addr, unsigned long end_addr)h](j)}(hjJ,h]hstruct}(hjήhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjʮhhhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:128: ./mm/mmap.chM{ubj)}(h h]h }(hjܮhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjʮhhhjۮhM{ubh)}(hhh]j)}(hvm_area_structh]hvm_area_struct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jfind_vma_intersectionsbc.find_vma_intersectionasbuh1hhjʮhhhjۮhM{ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjʮhhhjۮhM{ubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjʮhhhjۮhM{ubh)}(hfind_vma_intersectionh]j)}(hj h]hfind_vma_intersection}(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjʮhhhjۮhM{ubj8)}(hH(struct mm_struct *mm, unsigned long start_addr, unsigned long end_addr)h](j>)}(hstruct mm_struct *mmh](j)}(hjJ,h]hstruct}(hjHhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjDubj)}(h h]h }(hjUhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjDubh)}(hhh]j)}(h mm_structh]h mm_struct}(hjfhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjcubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjhmodnameN classnameNjj)}j]j c.find_vma_intersectionasbuh1hhjDubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjDubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjDubj)}(hmmh]hmm}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjDubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj@ubj>)}(hunsigned long start_addrh](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjƯhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hlongh]hlong}(hjԯhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h start_addrh]h start_addr}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj@ubj>)}(hunsigned long end_addrh](j)}(hunsignedh]hunsigned}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hlongh]hlong}(hj%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hend_addrh]hend_addr}(hjAhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj@ubeh}(h]h ]h"]h$]h&]jjuh1j7hjʮhhhjۮhM{ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjƮhhhjۮhM{ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjۮhM{hjîhhubj4)}(hhh]jM)}(h3Look up the first VMA which intersects the intervalh]h3Look up the first VMA which intersects the interval}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:128: ./mm/mmap.chM{hjhhhubah}(h]h ]h"]h$]h&]uh1j3hjîhhhjۮhM{ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hX/**Parameters** ``struct mm_struct *mm`` The process address space. ``unsigned long start_addr`` The inclusive start user address. ``unsigned long end_addr`` The exclusive end user address. **Return** The first VMA within the provided range, ``NULL`` otherwise. Assumes start_addr < end_addr.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:128: ./mm/mmap.chMhjubj)}(hhh](j)}(h4``struct mm_struct *mm`` The process address space. h](j)}(h``struct mm_struct *mm``h]jS)}(hjh]hstruct mm_struct *mm}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:128: ./mm/mmap.chM|hjubj)}(hhh]jM)}(hThe process address space.h]hThe process address space.}(hjŰhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM|hj°ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM|hjubj)}(h?``unsigned long start_addr`` The inclusive start user address. h](j)}(h``unsigned long start_addr``h]jS)}(hjh]hunsigned long start_addr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:128: ./mm/mmap.chM}hj߰ubj)}(hhh]jM)}(h!The inclusive start user address.h]h!The inclusive start user address.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM}hjubah}(h]h ]h"]h$]h&]uh1jhj߰ubeh}(h]h ]h"]h$]h&]uh1jhjhM}hjubj)}(h;``unsigned long end_addr`` The exclusive end user address. h](j)}(h``unsigned long end_addr``h]jS)}(hjh]hunsigned long end_addr}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:128: ./mm/mmap.chM~hjubj)}(hhh]jM)}(hThe exclusive end user address.h]hThe exclusive end user address.}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj3hM~hj4ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj3hM~hjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h **Return**h]j)}(hjYh]hReturn}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjWubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:128: ./mm/mmap.chMhjubjM)}(h\The first VMA within the provided range, ``NULL`` otherwise. Assumes start_addr < end_addr.h](h)The first VMA within the provided range, }(hjohhhNhNubjS)}(h``NULL``h]hNULL}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjoubh+ otherwise. Assumes start_addr < end_addr.}(hjohhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:128: ./mm/mmap.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfind_vma (C function) c.find_vmahNtauh1hhjKhhhNhNubh)}(hhh](h)}(hKstruct vm_area_struct * find_vma (struct mm_struct *mm, unsigned long addr)h]h)}(hIstruct vm_area_struct *find_vma(struct mm_struct *mm, unsigned long addr)h](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:128: ./mm/mmap.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh)}(hhh]j)}(hvm_area_structh]hvm_area_struct}(hjϱhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj̱ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjѱmodnameN classnameNjj)}j]j)}jfind_vmasb c.find_vmaasbuh1hhjhhhjhMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjhhhjhMubh)}(hfind_vmah]j)}(hjh]hfind_vma}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMubj8)}(h*(struct mm_struct *mm, unsigned long addr)h](j>)}(hstruct mm_struct *mmh](j)}(hjJ,h]hstruct}(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubj)}(h h]h }(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubh)}(hhh]j)}(h mm_structh]h mm_struct}(hjHhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjJmodnameN classnameNjj)}j]j c.find_vmaasbuh1hhj&ubj)}(h h]h }(hjfhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubjr)}(hjuh]h*}(hjthhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj&ubj)}(hmmh]hmm}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj"ubj>)}(hunsigned long addrh](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjIJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(haddrh]haddr}(hjҲhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj"ubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]jM)}(h2Find the VMA for a given address, or the next VMA.h]h2Find the VMA for a given address, or the next VMA.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:128: ./mm/mmap.chMhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``struct mm_struct *mm`` The mm_struct to check ``unsigned long addr`` The address **Return** The VMA associated with addr, or the next VMA. May return ``NULL`` in the case of no VMA at addr or above.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:128: ./mm/mmap.chMhjubj)}(hhh](j)}(h0``struct mm_struct *mm`` The mm_struct to check h](j)}(h``struct mm_struct *mm``h]jS)}(hj=h]hstruct mm_struct *mm}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj;ubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:128: ./mm/mmap.chMhj7ubj)}(hhh]jM)}(hThe mm_struct to checkh]hThe mm_struct to check}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjRhMhjSubah}(h]h ]h"]h$]h&]uh1jhj7ubeh}(h]h ]h"]h$]h&]uh1jhjRhMhj4ubj)}(h#``unsigned long addr`` The address h](j)}(h``unsigned long addr``h]jS)}(hjvh]hunsigned long addr}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjtubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:128: ./mm/mmap.chMhjpubj)}(hhh]jM)}(h The addressh]h The address}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjpubeh}(h]h ]h"]h$]h&]uh1jhjhMhj4ubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:128: ./mm/mmap.chMhjubjM)}(hjThe VMA associated with addr, or the next VMA. May return ``NULL`` in the case of no VMA at addr or above.h](h:The VMA associated with addr, or the next VMA. May return }(hjdzhhhNhNubjS)}(h``NULL``h]hNULL}(hjϳhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjdzubh( in the case of no VMA at addr or above.}(hjdzhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:128: ./mm/mmap.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfind_vma_prev (C function)c.find_vma_prevhNtauh1hhjKhhhNhNubh)}(hhh](h)}(hostruct vm_area_struct * find_vma_prev (struct mm_struct *mm, unsigned long addr, struct vm_area_struct **pprev)h]h)}(hmstruct vm_area_struct *find_vma_prev(struct mm_struct *mm, unsigned long addr, struct vm_area_struct **pprev)h](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:128: ./mm/mmap.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh)}(hhh]j)}(hvm_area_structh]hvm_area_struct}(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj)modnameN classnameNjj)}j]j)}j find_vma_prevsbc.find_vma_prevasbuh1hhjhhhjhMubj)}(h h]h }(hjHhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubjr)}(hjuh]h*}(hjVhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjhhhjhMubh)}(h find_vma_prevh]j)}(hjEh]h find_vma_prev}(hjghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjcubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMubj8)}(hI(struct mm_struct *mm, unsigned long addr, struct vm_area_struct **pprev)h](j>)}(hstruct mm_struct *mmh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~ubh)}(hhh]j)}(h mm_structh]h mm_struct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jCc.find_vma_prevasbuh1hhj~ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~ubjr)}(hjuh]h*}(hj̴hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj~ubj)}(hmmh]hmm}(hjٴhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjzubj>)}(hunsigned long addrh](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(haddrh]haddr}(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjzubj>)}(hstruct vm_area_struct **pprevh](j)}(hjJ,h]hstruct}(hjChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?ubj)}(h h]h }(hjPhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?ubh)}(hhh]j)}(hvm_area_structh]hvm_area_struct}(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjcmodnameN classnameNjj)}j]jCc.find_vma_prevasbuh1hhj?ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?ubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj?ubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj?ubj)}(hpprevh]hpprev}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjzubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]jM)}(h`Find the VMA for a given address, or the next vma and set ``pprev`` to the previous VMA, if any.h](h:Find the VMA for a given address, or the next vma and set }(hjѵhhhNhNubjS)}(h ``pprev``h]hpprev}(hjٵhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjѵubh to the previous VMA, if any.}(hjѵhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:128: ./mm/mmap.chMhjεhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct mm_struct *mm`` The mm_struct to check ``unsigned long addr`` The address ``struct vm_area_struct **pprev`` The pointer to set to the previous VMA **Description** Note that RCU lock is missing here since the external mmap_lock() is used instead. **Return** The VMA associated with **addr**, or the next vma. May return ``NULL`` in the case of no vma at addr or above.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:128: ./mm/mmap.chMhjubj)}(hhh](j)}(h0``struct mm_struct *mm`` The mm_struct to check h](j)}(h``struct mm_struct *mm``h]jS)}(hj$h]hstruct mm_struct *mm}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj"ubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:128: ./mm/mmap.chMhjubj)}(hhh]jM)}(hThe mm_struct to checkh]hThe mm_struct to check}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj9hMhj:ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj9hMhjubj)}(h#``unsigned long addr`` The address h](j)}(h``unsigned long addr``h]jS)}(hj]h]hunsigned long addr}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj[ubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:128: ./mm/mmap.chMhjWubj)}(hhh]jM)}(h The addressh]h The address}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjrhMhjsubah}(h]h ]h"]h$]h&]uh1jhjWubeh}(h]h ]h"]h$]h&]uh1jhjrhMhjubj)}(hI``struct vm_area_struct **pprev`` The pointer to set to the previous VMA h](j)}(h!``struct vm_area_struct **pprev``h]jS)}(hjh]hstruct vm_area_struct **pprev}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:128: ./mm/mmap.chMhjubj)}(hhh]jM)}(h&The pointer to set to the previous VMAh]h&The pointer to set to the previous VMA}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjѶh]h Description}(hjӶhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj϶ubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:128: ./mm/mmap.chMhjubjM)}(hRNote that RCU lock is missing here since the external mmap_lock() is used instead.h]hRNote that RCU lock is missing here since the external mmap_lock() is used instead.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:128: ./mm/mmap.chMhjubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:128: ./mm/mmap.chMhjubjM)}(hnThe VMA associated with **addr**, or the next vma. May return ``NULL`` in the case of no vma at addr or above.h](hThe VMA associated with }(hjhhhNhNubj)}(h**addr**h]haddr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh, or the next vma. May return }(hjhhhNhNubjS)}(h``NULL``h]hNULL}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubh( in the case of no vma at addr or above.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhJ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:128: ./mm/mmap.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hkmemleak_alloc (C function)c.kmemleak_allochNtauh1hhjKhhhNhNubh)}(hhh](h)}(hRvoid __ref kmemleak_alloc (const void *ptr, size_t size, int min_count, gfp_t gfp)h]h)}(hQvoid __ref kmemleak_alloc(const void *ptr, size_t size, int min_count, gfp_t gfp)h](j)}(hvoidh]hvoid}(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj]hhhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMKubj)}(h h]h }(hjphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj]hhhjohMKubh__ref}(hj]hhhNhNubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj]hhhjohMKubh)}(hkmemleak_alloch]j)}(hkmemleak_alloch]hkmemleak_alloc}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhj]hhhjohMKubj8)}(h8(const void *ptr, size_t size, int min_count, gfp_t gfp)h](j>)}(hconst void *ptrh](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hvoidh]hvoid}(hj˷hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjٷhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hptrh]hptr}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(h size_t sizeh](h)}(hhh]j)}(hsize_th]hsize_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsbc.kmemleak_allocasbuh1hhj ubj)}(h h]h }(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(hsizeh]hsize}(hj>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(h int min_counth](j)}(hinth]hint}(hjWhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSubj)}(h h]h }(hjehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSubj)}(h min_counth]h min_count}(hjshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(h gfp_t gfph](h)}(hhh]j)}(hgfp_th]hgfp_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j,c.kmemleak_allocasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hgfph]hgfp}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hj]hhhjohMKubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjYhhhjohMKubah}(h]jTah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjohMKhjVhhubj4)}(hhh]jM)}(h!register a newly allocated objecth]h!register a newly allocated object}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMKhjhhubah}(h]h ]h"]h$]h&]uh1j3hjVhhhjohMKubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``const void *ptr`` pointer to beginning of the object ``size_t size`` size of the object ``int min_count`` minimum number of references to this object. If during memory scanning a number of references less than **min_count** is found, the object is reported as a memory leak. If **min_count** is 0, the object is never reported as a leak. If **min_count** is -1, the object is ignored (not scanned and not reported as a leak) ``gfp_t gfp`` kmalloc() flags used for kmemleak internal memory allocations **Description** This function is called from the kernel allocators when a new object (memory block) is allocated (kmem_cache_alloc, kmalloc etc.).h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMOhjubj)}(hhh](j)}(h7``const void *ptr`` pointer to beginning of the object h](j)}(h``const void *ptr``h]jS)}(hj&h]hconst void *ptr}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj$ubah}(h]h ]h"]h$]h&]uh1jhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMLhj ubj)}(hhh]jM)}(h"pointer to beginning of the objecth]h"pointer to beginning of the object}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj;hMLhj<ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj;hMLhjubj)}(h#``size_t size`` size of the object h](j)}(h``size_t size``h]jS)}(hj_h]h size_t size}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj]ubah}(h]h ]h"]h$]h&]uh1jhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMMhjYubj)}(hhh]jM)}(hsize of the objecth]hsize of the object}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjthMMhjuubah}(h]h ]h"]h$]h&]uh1jhjYubeh}(h]h ]h"]h$]h&]uh1jhjthMMhjubj)}(hXQ``int min_count`` minimum number of references to this object. If during memory scanning a number of references less than **min_count** is found, the object is reported as a memory leak. If **min_count** is 0, the object is never reported as a leak. If **min_count** is -1, the object is ignored (not scanned and not reported as a leak) h](j)}(h``int min_count``h]jS)}(hjh]h int min_count}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMRhjubj)}(hhh]jM)}(hX>minimum number of references to this object. If during memory scanning a number of references less than **min_count** is found, the object is reported as a memory leak. If **min_count** is 0, the object is never reported as a leak. If **min_count** is -1, the object is ignored (not scanned and not reported as a leak)h](hhminimum number of references to this object. If during memory scanning a number of references less than }(hjhhhNhNubj)}(h **min_count**h]h min_count}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh7 is found, the object is reported as a memory leak. If }(hjhhhNhNubj)}(h **min_count**h]h min_count}(hj˹hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh2 is 0, the object is never reported as a leak. If }(hjhhhNhNubj)}(h **min_count**h]h min_count}(hjݹhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhF is -1, the object is ignored (not scanned and not reported as a leak)}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMNhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMRhjubj)}(hL``gfp_t gfp`` kmalloc() flags used for kmemleak internal memory allocations h](j)}(h ``gfp_t gfp``h]jS)}(hjh]h gfp_t gfp}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMShjubj)}(hhh]jM)}(h=kmalloc() flags used for kmemleak internal memory allocationsh]h=kmalloc() flags used for kmemleak internal memory allocations}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMShjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMShjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjCh]h Description}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjAubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMUhjubjM)}(hThis function is called from the kernel allocators when a new object (memory block) is allocated (kmem_cache_alloc, kmalloc etc.).h]hThis function is called from the kernel allocators when a new object (memory block) is allocated (kmem_cache_alloc, kmalloc etc.).}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMThjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h"kmemleak_alloc_percpu (C function)c.kmemleak_alloc_percpuhNtauh1hhjKhhhNhNubh)}(hhh](h)}(hSvoid __ref kmemleak_alloc_percpu (const void __percpu *ptr, size_t size, gfp_t gfp)h]h)}(hRvoid __ref kmemleak_alloc_percpu(const void __percpu *ptr, size_t size, gfp_t gfp)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMcubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMcubh__ref}(hjhhhNhNubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMcubh)}(hkmemleak_alloc_percpuh]j)}(hkmemleak_alloc_percpuh]hkmemleak_alloc_percpu}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMcubj8)}(h2(const void __percpu *ptr, size_t size, gfp_t gfp)h](j>)}(hconst void __percpu *ptrh](j)}(hjh]hconst}(hj׺hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjӺubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjӺubj)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjӺubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjӺubh__percpu}(hjӺhhhNhNubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjӺubjr)}(hjuh]h*}(hj hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjӺubj)}(hptrh]hptr}(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjӺubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjϺubj>)}(h size_t sizeh](h)}(hhh]j)}(hsize_th]hsize_t}(hjIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjKmodnameN classnameNjj)}j]j)}jjsbc.kmemleak_alloc_percpuasbuh1hhjBubj)}(h h]h }(hjihhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubj)}(hsizeh]hsize}(hjwhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjϺubj>)}(h gfp_t gfph](h)}(hhh]j)}(hgfp_th]hgfp_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jec.kmemleak_alloc_percpuasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hgfph]hgfp}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjϺubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMcubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMcubah}(h]j{ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMchj}hhubj4)}(hhh]jM)}(h*register a newly allocated __percpu objecth]h*register a newly allocated __percpu object}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMchjhhubah}(h]h ]h"]h$]h&]uh1j3hj}hhhjhMcubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hXN**Parameters** ``const void __percpu *ptr`` __percpu pointer to beginning of the object ``size_t size`` size of the object ``gfp_t gfp`` flags used for kmemleak internal memory allocations **Description** This function is called from the kernel percpu allocator when a new object (memory block) is allocated (alloc_percpu).h](jM)}(h**Parameters**h]j)}(hj h]h Parameters}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMghjubj)}(hhh](j)}(hI``const void __percpu *ptr`` __percpu pointer to beginning of the object h](j)}(h``const void __percpu *ptr``h]jS)}(hj*h]hconst void __percpu *ptr}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj(ubah}(h]h ]h"]h$]h&]uh1jhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMdhj$ubj)}(hhh]jM)}(h+__percpu pointer to beginning of the objecth]h+__percpu pointer to beginning of the object}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj?hMdhj@ubah}(h]h ]h"]h$]h&]uh1jhj$ubeh}(h]h ]h"]h$]h&]uh1jhj?hMdhj!ubj)}(h#``size_t size`` size of the object h](j)}(h``size_t size``h]jS)}(hjch]h size_t size}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjaubah}(h]h ]h"]h$]h&]uh1jhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMehj]ubj)}(hhh]jM)}(hsize of the objecth]hsize of the object}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjxhMehjyubah}(h]h ]h"]h$]h&]uh1jhj]ubeh}(h]h ]h"]h$]h&]uh1jhjxhMehj!ubj)}(hB``gfp_t gfp`` flags used for kmemleak internal memory allocations h](j)}(h ``gfp_t gfp``h]jS)}(hjh]h gfp_t gfp}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMfhjubj)}(hhh]jM)}(h3flags used for kmemleak internal memory allocationsh]h3flags used for kmemleak internal memory allocations}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMfhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMfhj!ubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hj׼h]h Description}(hjټhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjռubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMhhjubjM)}(hvThis function is called from the kernel percpu allocator when a new object (memory block) is allocated (alloc_percpu).h]hvThis function is called from the kernel percpu allocator when a new object (memory block) is allocated (alloc_percpu).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMghjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hkmemleak_vmalloc (C function)c.kmemleak_vmallochNtauh1hhjKhhhNhNubh)}(hhh](h)}(hRvoid __ref kmemleak_vmalloc (const struct vm_struct *area, size_t size, gfp_t gfp)h]h)}(hQvoid __ref kmemleak_vmalloc(const struct vm_struct *area, size_t size, gfp_t gfp)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMvubj)}(h h]h }(hj+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhj*hMvubh__ref}(hjhhhNhNubj)}(h h]h }(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhj*hMvubh)}(hkmemleak_vmalloch]j)}(hkmemleak_vmalloch]hkmemleak_vmalloc}(hjOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjKubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhj*hMvubj8)}(h6(const struct vm_struct *area, size_t size, gfp_t gfp)h](j>)}(hconst struct vm_struct *areah](j)}(hjh]hconst}(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubj)}(h h]h }(hjxhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubj)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubh)}(hhh]j)}(h vm_structh]h vm_struct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjQsbc.kmemleak_vmallocasbuh1hhjgubj)}(h h]h }(hjĽhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubjr)}(hjuh]h*}(hjҽhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjgubj)}(hareah]harea}(hj߽hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjcubj>)}(h size_t sizeh](h)}(hhh]j)}(hsize_th]hsize_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.kmemleak_vmallocasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hsizeh]hsize}(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjcubj>)}(h gfp_t gfph](h)}(hhh]j)}(hgfp_th]hgfp_t}(hjChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjEmodnameN classnameNjj)}j]jc.kmemleak_vmallocasbuh1hhj<ubj)}(h h]h }(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj<ubj)}(hgfph]hgfp}(hjohhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj<ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjcubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhj*hMvubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhj*hMvubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj*hMvhjhhubj4)}(hhh]jM)}(h"register a newly vmalloc'ed objecth]h$register a newly vmalloc’ed object}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMvhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhj*hMvubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hX;**Parameters** ``const struct vm_struct *area`` pointer to vm_struct ``size_t size`` size of the object ``gfp_t gfp`` __vmalloc() flags used for kmemleak internal memory allocations **Description** This function is called from the vmalloc() kernel allocator when a new object (memory block) is allocated.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMzhjubj)}(hhh](j)}(h6``const struct vm_struct *area`` pointer to vm_struct h](j)}(h ``const struct vm_struct *area``h]jS)}(hjھh]hconst struct vm_struct *area}(hjܾhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjؾubah}(h]h ]h"]h$]h&]uh1jhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMwhjԾubj)}(hhh]jM)}(hpointer to vm_structh]hpointer to vm_struct}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMwhjubah}(h]h ]h"]h$]h&]uh1jhjԾubeh}(h]h ]h"]h$]h&]uh1jhjhMwhjѾubj)}(h#``size_t size`` size of the object h](j)}(h``size_t size``h]jS)}(hjh]h size_t size}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMxhj ubj)}(hhh]jM)}(hsize of the objecth]hsize of the object}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj(hMxhj)ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj(hMxhjѾubj)}(hN``gfp_t gfp`` __vmalloc() flags used for kmemleak internal memory allocations h](j)}(h ``gfp_t gfp``h]jS)}(hjLh]h gfp_t gfp}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjJubah}(h]h ]h"]h$]h&]uh1jhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMyhjFubj)}(hhh]jM)}(h?__vmalloc() flags used for kmemleak internal memory allocationsh]h?__vmalloc() flags used for kmemleak internal memory allocations}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjahMyhjbubah}(h]h ]h"]h$]h&]uh1jhjFubeh}(h]h ]h"]h$]h&]uh1jhjahMyhjѾubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chM{hjubjM)}(hjThis function is called from the vmalloc() kernel allocator when a new object (memory block) is allocated.h]hjThis function is called from the vmalloc() kernel allocator when a new object (memory block) is allocated.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMzhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hkmemleak_free (C function)c.kmemleak_freehNtauh1hhjKhhhNhNubh)}(hhh](h)}(h*void __ref kmemleak_free (const void *ptr)h]h)}(h)void __ref kmemleak_free(const void *ptr)h](j)}(hvoidh]hvoid}(hj̿hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjȿhhhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMubj)}(h h]h }(hjۿhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjȿhhhjڿhMubh__ref}(hjȿhhhNhNubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjȿhhhjڿhMubh)}(h kmemleak_freeh]j)}(h kmemleak_freeh]h kmemleak_free}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjȿhhhjڿhMubj8)}(h(const void *ptr)h]j>)}(hconst void *ptrh](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj(hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hvoidh]hvoid}(hj6hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjDhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjRhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hptrh]hptr}(hj_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjȿhhhjڿhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjĿhhhjڿhMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjڿhMhjhhubj4)}(hhh]jM)}(h)unregister a previously registered objecth]h)unregister a previously registered object}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjڿhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``const void *ptr`` pointer to beginning of the object **Description** This function is called from the kernel allocators when an object (memory block) is freed (kmem_cache_free, kfree, vfree etc.).h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMhjubj)}(hhh]j)}(h7``const void *ptr`` pointer to beginning of the object h](j)}(h``const void *ptr``h]jS)}(hjh]hconst void *ptr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMhjubj)}(hhh]jM)}(h"pointer to beginning of the objecth]h"pointer to beginning of the object}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMhjubjM)}(hThis function is called from the kernel allocators when an object (memory block) is freed (kmem_cache_free, kfree, vfree etc.).h]hThis function is called from the kernel allocators when an object (memory block) is freed (kmem_cache_free, kfree, vfree etc.).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hkmemleak_free_part (C function)c.kmemleak_free_parthNtauh1hhjKhhhNhNubh)}(hhh](h)}(h)}(hconst void *ptrh](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hptrh]hptr}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(h size_t sizeh](h)}(hhh]j)}(hsize_th]hsize_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsbc.kmemleak_free_partasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hsizeh]hsize}(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjFhhhjXhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjBhhhjXhMubah}(h]j=ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjXhMhj?hhubj4)}(hhh]jM)}(h3partially unregister a previously registered objecth]h3partially unregister a previously registered object}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMhjNhhubah}(h]h ]h"]h$]h&]uh1j3hj?hhhjXhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjijHjijIjJjKuh1hhhhjKhNhNubj)}(hX5**Parameters** ``const void *ptr`` pointer to the beginning or inside the object. This also represents the start of the range to be freed ``size_t size`` size to be unregistered **Description** This function is called when only a part of a memory block is freed (usually from the bootmem allocator).h](jM)}(h**Parameters**h]j)}(hjsh]h Parameters}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjqubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMhjmubj)}(hhh](j)}(h{``const void *ptr`` pointer to the beginning or inside the object. This also represents the start of the range to be freed h](j)}(h``const void *ptr``h]jS)}(hjh]hconst void *ptr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMhjubj)}(hhh]jM)}(hfpointer to the beginning or inside the object. This also represents the start of the range to be freedh]hfpointer to the beginning or inside the object. This also represents the start of the range to be freed}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h(``size_t size`` size to be unregistered h](j)}(h``size_t size``h]jS)}(hjh]h size_t size}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMhjubj)}(hhh]jM)}(hsize to be unregisteredh]hsize to be unregistered}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubeh}(h]h ]h"]h$]h&]uh1jhjmubjM)}(h**Description**h]j)}(hjh]h Description}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMhjmubjM)}(hiThis function is called when only a part of a memory block is freed (usually from the bootmem allocator).h]hiThis function is called when only a part of a memory block is freed (usually from the bootmem allocator).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMhjmubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h!kmemleak_free_percpu (C function)c.kmemleak_free_percpuhNtauh1hhjKhhhNhNubh)}(hhh](h)}(h:void __ref kmemleak_free_percpu (const void __percpu *ptr)h]h)}(h9void __ref kmemleak_free_percpu(const void __percpu *ptr)h](j)}(hvoidh]hvoid}(hjLhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHhhhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMubj)}(h h]h }(hj[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHhhhjZhMubh__ref}(hjHhhhNhNubj)}(h h]h }(hjmhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHhhhjZhMubh)}(hkmemleak_free_percpuh]j)}(hkmemleak_free_percpuh]hkmemleak_free_percpu}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjHhhhjZhMubj8)}(h(const void __percpu *ptr)h]j>)}(hconst void __percpu *ptrh](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh__percpu}(hjhhhNhNubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hptrh]hptr}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjHhhhjZhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjDhhhjZhMubah}(h]j?ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjZhMhjAhhubj4)}(hhh]jM)}(h2unregister a previously registered __percpu objecth]h2unregister a previously registered __percpu object}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMhjhhubah}(h]h ]h"]h$]h&]uh1j3hjAhhhjZhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj3jHj3jIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``const void __percpu *ptr`` __percpu pointer to beginning of the object **Description** This function is called from the kernel percpu allocator when an object (memory block) is freed (free_percpu).h](jM)}(h**Parameters**h]j)}(hj=h]h Parameters}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj;ubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMhj7ubj)}(hhh]j)}(hI``const void __percpu *ptr`` __percpu pointer to beginning of the object h](j)}(h``const void __percpu *ptr``h]jS)}(hj\h]hconst void __percpu *ptr}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjZubah}(h]h ]h"]h$]h&]uh1jhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMhjVubj)}(hhh]jM)}(h+__percpu pointer to beginning of the objecth]h+__percpu pointer to beginning of the object}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjqhMhjrubah}(h]h ]h"]h$]h&]uh1jhjVubeh}(h]h ]h"]h$]h&]uh1jhjqhMhjSubah}(h]h ]h"]h$]h&]uh1jhj7ubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMhj7ubjM)}(hnThis function is called from the kernel percpu allocator when an object (memory block) is freed (free_percpu).h]hnThis function is called from the kernel percpu allocator when an object (memory block) is freed (free_percpu).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMhj7ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h"kmemleak_update_trace (C function)c.kmemleak_update_tracehNtauh1hhjKhhhNhNubh)}(hhh](h)}(h2void __ref kmemleak_update_trace (const void *ptr)h]h)}(h1void __ref kmemleak_update_trace(const void *ptr)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh__ref}(hjhhhNhNubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh)}(hkmemleak_update_traceh]j)}(hkmemleak_update_traceh]hkmemleak_update_trace}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMubj8)}(h(const void *ptr)h]j>)}(hconst void *ptrh](j)}(hjh]hconst}(hj+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj'ubj)}(h h]h }(hj8hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj'ubj)}(hvoidh]hvoid}(hjFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj'ubj)}(h h]h }(hjThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj'ubjr)}(hjuh]h*}(hjbhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj'ubj)}(hptrh]hptr}(hjohhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj'ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj#ubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]jM)}(h$update object allocation stack traceh]h$update object allocation stack trace}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``const void *ptr`` pointer to beginning of the object **Description** Override the object allocation stack trace for cases where the actual allocation place is not always useful.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMhjubj)}(hhh]j)}(h7``const void *ptr`` pointer to beginning of the object h](j)}(h``const void *ptr``h]jS)}(hjh]hconst void *ptr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMhjubj)}(hhh]jM)}(h"pointer to beginning of the objecth]h"pointer to beginning of the object}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMhjubjM)}(hlOverride the object allocation stack trace for cases where the actual allocation place is not always useful.h]hlOverride the object allocation stack trace for cases where the actual allocation place is not always useful.}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hkmemleak_not_leak (C function)c.kmemleak_not_leakhNtauh1hhjKhhhNhNubh)}(hhh](h)}(h.void __ref kmemleak_not_leak (const void *ptr)h]h)}(h-void __ref kmemleak_not_leak(const void *ptr)h](j)}(hvoidh]hvoid}(hjZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVhhhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMubj)}(h h]h }(hjihhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVhhhjhhMubh__ref}(hjVhhhNhNubj)}(h h]h }(hj{hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVhhhjhhMubh)}(hkmemleak_not_leakh]j)}(hkmemleak_not_leakh]hkmemleak_not_leak}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjVhhhjhhMubj8)}(h(const void *ptr)h]j>)}(hconst void *ptrh](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hptrh]hptr}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjVhhhjhhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjRhhhjhhMubah}(h]jMah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhhMhjOhhubj4)}(hhh]jM)}(h*mark an allocated object as false positiveh]h*mark an allocated object as false positive}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMhjhhubah}(h]h ]h"]h$]h&]uh1j3hjOhhhjhhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj/jHj/jIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``const void *ptr`` pointer to beginning of the object **Description** Calling this function on an object will cause the memory block to no longer be reported as leak and always be scanned.h](jM)}(h**Parameters**h]j)}(hj9h]h Parameters}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj7ubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMhj3ubj)}(hhh]j)}(h7``const void *ptr`` pointer to beginning of the object h](j)}(h``const void *ptr``h]jS)}(hjXh]hconst void *ptr}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjVubah}(h]h ]h"]h$]h&]uh1jhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMhjRubj)}(hhh]jM)}(h"pointer to beginning of the objecth]h"pointer to beginning of the object}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjmhMhjnubah}(h]h ]h"]h$]h&]uh1jhjRubeh}(h]h ]h"]h$]h&]uh1jhjmhMhjOubah}(h]h ]h"]h$]h&]uh1jhj3ubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMhj3ubjM)}(hvCalling this function on an object will cause the memory block to no longer be reported as leak and always be scanned.h]hvCalling this function on an object will cause the memory block to no longer be reported as leak and always be scanned.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMhj3ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h$kmemleak_transient_leak (C function)c.kmemleak_transient_leakhNtauh1hhjKhhhNhNubh)}(hhh](h)}(h4void __ref kmemleak_transient_leak (const void *ptr)h]h)}(h3void __ref kmemleak_transient_leak(const void *ptr)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh__ref}(hjhhhNhNubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh)}(hkmemleak_transient_leakh]j)}(hkmemleak_transient_leakh]hkmemleak_transient_leak}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMubj8)}(h(const void *ptr)h]j>)}(hconst void *ptrh](j)}(hjh]hconst}(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#ubj)}(h h]h }(hj4hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#ubj)}(hvoidh]hvoid}(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#ubj)}(h h]h }(hjPhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#ubjr)}(hjuh]h*}(hj^hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj#ubj)}(hptrh]hptr}(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]jM)}(h4mark an allocated object as transient false positiveh]h4mark an allocated object as transient false positive}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hX:**Parameters** ``const void *ptr`` pointer to beginning of the object **Description** Calling this function on an object will cause the memory block to not be reported as a leak temporarily. This may happen, for example, if the object is part of a singly linked list and the ->next reference to it is changed.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMhjubj)}(hhh]j)}(h7``const void *ptr`` pointer to beginning of the object h](j)}(h``const void *ptr``h]jS)}(hjh]hconst void *ptr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMhjubj)}(hhh]jM)}(h"pointer to beginning of the objecth]h"pointer to beginning of the object}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMhjubjM)}(hCalling this function on an object will cause the memory block to not be reported as a leak temporarily. This may happen, for example, if the object is part of a singly linked list and the ->next reference to it is changed.h]hCalling this function on an object will cause the memory block to not be reported as a leak temporarily. This may happen, for example, if the object is part of a singly linked list and the ->next reference to it is changed.}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h#kmemleak_ignore_percpu (C function)c.kmemleak_ignore_percpuhNtauh1hhjKhhhNhNubh)}(hhh](h)}(h)}(hconst void __percpu *ptrh](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh__percpu}(hjhhhNhNubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hptrh]hptr}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjRhhhjdhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjNhhhjdhMubah}(h]jIah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjdhMhjKhhubj4)}(hhh]jM)}(h?similar to kmemleak_ignore but taking a percpu address argumenth]h?similar to kmemleak_ignore but taking a percpu address argument}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMhj"hhubah}(h]h ]h"]h$]h&]uh1j3hjKhhhjdhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj=jHj=jIjJjKuh1hhhhjKhNhNubj)}(hK**Parameters** ``const void __percpu *ptr`` percpu address of the objecth](jM)}(h**Parameters**h]j)}(hjGh]h Parameters}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjEubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chM hjAubj)}(hhh]j)}(h9``const void __percpu *ptr`` percpu address of the objecth](j)}(h``const void __percpu *ptr``h]jS)}(hjfh]hconst void __percpu *ptr}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjdubah}(h]h ]h"]h$]h&]uh1jhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chM hj`ubj)}(hhh]jM)}(hpercpu address of the objecth]hpercpu address of the object}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMhj|ubah}(h]h ]h"]h$]h&]uh1jhj`ubeh}(h]h ]h"]h$]h&]uh1jhj{hM hj]ubah}(h]h ]h"]h$]h&]uh1jhjAubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hkmemleak_ignore (C function)c.kmemleak_ignorehNtauh1hhjKhhhNhNubh)}(hhh](h)}(h,void __ref kmemleak_ignore (const void *ptr)h]h)}(h+void __ref kmemleak_ignore(const void *ptr)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh__ref}(hjhhhNhNubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh)}(hkmemleak_ignoreh]j)}(hkmemleak_ignoreh]hkmemleak_ignore}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMubj8)}(h(const void *ptr)h]j>)}(hconst void *ptrh](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(hvoidh]hvoid}(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h h]h }(hj8hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubjr)}(hjuh]h*}(hjFhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj ubj)}(hptrh]hptr}(hjShhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]jM)}(hignore an allocated objecth]hignore an allocated object}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMhjzhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hXh**Parameters** ``const void *ptr`` pointer to beginning of the object **Description** Calling this function on an object will cause the memory block to be ignored (not scanned and not reported as a leak). This is usually done when it is known that the corresponding block is not a leak and does not contain any references to other allocated memory blocks.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMhjubj)}(hhh]j)}(h7``const void *ptr`` pointer to beginning of the object h](j)}(h``const void *ptr``h]jS)}(hjh]hconst void *ptr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMhjubj)}(hhh]jM)}(h"pointer to beginning of the objecth]h"pointer to beginning of the object}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMhjubjM)}(hX Calling this function on an object will cause the memory block to be ignored (not scanned and not reported as a leak). This is usually done when it is known that the corresponding block is not a leak and does not contain any references to other allocated memory blocks.h]hX Calling this function on an object will cause the memory block to be ignored (not scanned and not reported as a leak). This is usually done when it is known that the corresponding block is not a leak and does not contain any references to other allocated memory blocks.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hkmemleak_scan_area (C function)c.kmemleak_scan_areahNtauh1hhjKhhhNhNubh)}(hhh](h)}(hGvoid __ref kmemleak_scan_area (const void *ptr, size_t size, gfp_t gfp)h]h)}(hFvoid __ref kmemleak_scan_area(const void *ptr, size_t size, gfp_t gfp)h](j)}(hvoidh]hvoid}(hj>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:hhhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chM&ubj)}(h h]h }(hjMhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:hhhjLhM&ubh__ref}(hj:hhhNhNubj)}(h h]h }(hj_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:hhhjLhM&ubh)}(hkmemleak_scan_areah]j)}(hkmemleak_scan_areah]hkmemleak_scan_area}(hjqhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmubah}(h]h ](jjeh"]h$]h&]jjuh1hhj:hhhjLhM&ubj8)}(h)(const void *ptr, size_t size, gfp_t gfp)h](j>)}(hconst void *ptrh](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hptrh]hptr}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(h size_t sizeh](h)}(hhh]j)}(hsize_th]hsize_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjssbc.kmemleak_scan_areaasbuh1hhjubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hsizeh]hsize}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(h gfp_t gfph](h)}(hhh]j)}(hgfp_th]hgfp_t}(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj9modnameN classnameNjj)}j]j c.kmemleak_scan_areaasbuh1hhj0ubj)}(h h]h }(hjUhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubj)}(hgfph]hgfp}(hjchhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hj:hhhjLhM&ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj6hhhjLhM&ubah}(h]j1ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjLhM&hj3hhubj4)}(hhh]jM)}(h4limit the range to be scanned in an allocated objecth]h4limit the range to be scanned in an allocated object}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chM&hjhhubah}(h]h ]h"]h$]h&]uh1j3hj3hhhjLhM&ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``const void *ptr`` pointer to beginning or inside the object. This also represents the start of the scan area ``size_t size`` size of the scan area ``gfp_t gfp`` kmalloc() flags used for kmemleak internal memory allocations **Description** This function is used when it is known that only certain parts of an object contain references to other objects. Kmemleak will only scan these areas reducing the number false negatives.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chM*hjubj)}(hhh](j)}(ho``const void *ptr`` pointer to beginning or inside the object. This also represents the start of the scan area h](j)}(h``const void *ptr``h]jS)}(hjh]hconst void *ptr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chM(hjubj)}(hhh]jM)}(hZpointer to beginning or inside the object. This also represents the start of the scan areah]hZpointer to beginning or inside the object. This also represents the start of the scan area}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chM'hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM(hjubj)}(h&``size_t size`` size of the scan area h](j)}(h``size_t size``h]jS)}(hjh]h size_t size}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chM)hjubj)}(hhh]jM)}(hsize of the scan areah]hsize of the scan area}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM)hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM)hjubj)}(hL``gfp_t gfp`` kmalloc() flags used for kmemleak internal memory allocations h](j)}(h ``gfp_t gfp``h]jS)}(hjAh]h gfp_t gfp}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj?ubah}(h]h ]h"]h$]h&]uh1jhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chM*hj;ubj)}(hhh]jM)}(h=kmalloc() flags used for kmemleak internal memory allocationsh]h=kmalloc() flags used for kmemleak internal memory allocations}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjVhM*hjWubah}(h]h ]h"]h$]h&]uh1jhj;ubeh}(h]h ]h"]h$]h&]uh1jhjVhM*hjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hj|h]h Description}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjzubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chM,hjubjM)}(hThis function is used when it is known that only certain parts of an object contain references to other objects. Kmemleak will only scan these areas reducing the number false negatives.h]hThis function is used when it is known that only certain parts of an object contain references to other objects. Kmemleak will only scan these areas reducing the number false negatives.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chM+hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hkmemleak_no_scan (C function)c.kmemleak_no_scanhNtauh1hhjKhhhNhNubh)}(hhh](h)}(h-void __ref kmemleak_no_scan (const void *ptr)h]h)}(h,void __ref kmemleak_no_scan(const void *ptr)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chM:ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM:ubh__ref}(hjhhhNhNubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM:ubh)}(hkmemleak_no_scanh]j)}(hkmemleak_no_scanh]hkmemleak_no_scan}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhM:ubj8)}(h(const void *ptr)h]j>)}(hconst void *ptrh](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(hvoidh]hvoid}(hj+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h h]h }(hj9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubjr)}(hjuh]h*}(hjGhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj ubj)}(hptrh]hptr}(hjThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhM:ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhM:ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhM:hjhhubj4)}(hhh]jM)}(hdo not scan an allocated objecth]hdo not scan an allocated object}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chM:hj{hhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhM:ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hXY**Parameters** ``const void *ptr`` pointer to beginning of the object **Description** This function notifies kmemleak not to scan the given memory block. Useful in situations where it is known that the given object does not contain any references to other objects. Kmemleak will not scan such objects reducing the number of false negatives.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chM>hjubj)}(hhh]j)}(h7``const void *ptr`` pointer to beginning of the object h](j)}(h``const void *ptr``h]jS)}(hjh]hconst void *ptr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chM;hjubj)}(hhh]jM)}(h"pointer to beginning of the objecth]h"pointer to beginning of the object}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM;hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM;hjubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chM=hjubjM)}(hThis function notifies kmemleak not to scan the given memory block. Useful in situations where it is known that the given object does not contain any references to other objects. Kmemleak will not scan such objects reducing the number of false negatives.h]hThis function notifies kmemleak not to scan the given memory block. Useful in situations where it is known that the given object does not contain any references to other objects. Kmemleak will not scan such objects reducing the number of false negatives.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chM<hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h kmemleak_alloc_phys (C function)c.kmemleak_alloc_physhNtauh1hhjKhhhNhNubh)}(hhh](h)}(hIvoid __ref kmemleak_alloc_phys (phys_addr_t phys, size_t size, gfp_t gfp)h]h)}(hHvoid __ref kmemleak_alloc_phys(phys_addr_t phys, size_t size, gfp_t gfp)h](j)}(hvoidh]hvoid}(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;hhhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMLubj)}(h h]h }(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;hhhjMhMLubh__ref}(hj;hhhNhNubj)}(h h]h }(hj`hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;hhhjMhMLubh)}(hkmemleak_alloc_physh]j)}(hkmemleak_alloc_physh]hkmemleak_alloc_phys}(hjrhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnubah}(h]h ](jjeh"]h$]h&]jjuh1hhj;hhhjMhMLubj8)}(h*(phys_addr_t phys, size_t size, gfp_t gfp)h](j>)}(hphys_addr_t physh](h)}(hhh]j)}(h phys_addr_th]h phys_addr_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjtsbc.kmemleak_alloc_physasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hphysh]hphys}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(h size_t sizeh](h)}(hhh]j)}(hsize_th]hsize_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.kmemleak_alloc_physasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hsizeh]hsize}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(h gfp_t gfph](h)}(hhh]j)}(hgfp_th]hgfp_t}(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj%modnameN classnameNjj)}j]jc.kmemleak_alloc_physasbuh1hhjubj)}(h h]h }(hjAhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hgfph]hgfp}(hjOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hj;hhhjMhMLubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj7hhhjMhMLubah}(h]j2ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjMhMLhj4hhubj4)}(hhh]jM)}(h@similar to kmemleak_alloc but taking a physical address argumenth]h@similar to kmemleak_alloc but taking a physical address argument}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMLhjvhhubah}(h]h ]h"]h$]h&]uh1j3hj4hhhjMhMLubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``phys_addr_t phys`` physical address of the object ``size_t size`` size of the object ``gfp_t gfp`` kmalloc() flags used for kmemleak internal memory allocationsh](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMPhjubj)}(hhh](j)}(h4``phys_addr_t phys`` physical address of the object h](j)}(h``phys_addr_t phys``h]jS)}(hjh]hphys_addr_t phys}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMNhjubj)}(hhh]jM)}(hphysical address of the objecth]hphysical address of the object}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMNhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMNhjubj)}(h#``size_t size`` size of the object h](j)}(h``size_t size``h]jS)}(hjh]h size_t size}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMOhjubj)}(hhh]jM)}(hsize of the objecth]hsize of the object}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMOhj ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMOhjubj)}(hK``gfp_t gfp`` kmalloc() flags used for kmemleak internal memory allocationsh](j)}(h ``gfp_t gfp``h]jS)}(hj,h]h gfp_t gfp}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj*ubah}(h]h ]h"]h$]h&]uh1jhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMQhj&ubj)}(hhh]jM)}(h=kmalloc() flags used for kmemleak internal memory allocationsh]h=kmalloc() flags used for kmemleak internal memory allocations}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMPhjBubah}(h]h ]h"]h$]h&]uh1jhj&ubeh}(h]h ]h"]h$]h&]uh1jhjAhMQhjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h$kmemleak_free_part_phys (C function)c.kmemleak_free_part_physhNtauh1hhjKhhhNhNubh)}(hhh](h)}(hBvoid __ref kmemleak_free_part_phys (phys_addr_t phys, size_t size)h]h)}(hAvoid __ref kmemleak_free_part_phys(phys_addr_t phys, size_t size)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chM`ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM`ubh__ref}(hjhhhNhNubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM`ubh)}(hkmemleak_free_part_physh]j)}(hkmemleak_free_part_physh]hkmemleak_free_part_phys}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhM`ubj8)}(h(phys_addr_t phys, size_t size)h](j>)}(hphys_addr_t physh](h)}(hhh]j)}(h phys_addr_th]h phys_addr_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsbc.kmemleak_free_part_physasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hphysh]hphys}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(h size_t sizeh](h)}(hhh]j)}(hsize_th]hsize_t}(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj$modnameN classnameNjj)}j]jc.kmemleak_free_part_physasbuh1hhjubj)}(h h]h }(hj@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hsizeh]hsize}(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhM`ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj~hhhjhM`ubah}(h]jyah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhM`hj{hhubj4)}(hhh]jM)}(hDsimilar to kmemleak_free_part but taking a physical address argumenth]hDsimilar to kmemleak_free_part but taking a physical address argument}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chM`hjuhhubah}(h]h ]h"]h$]h&]uh1j3hj{hhhjhM`ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``phys_addr_t phys`` physical address if the beginning or inside an object. This also represents the start of the range to be freed ``size_t size`` size to be unregisteredh](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMdhjubj)}(hhh](j)}(h``phys_addr_t phys`` physical address if the beginning or inside an object. This also represents the start of the range to be freed h](j)}(h``phys_addr_t phys``h]jS)}(hjh]hphys_addr_t phys}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMchjubj)}(hhh]jM)}(hnphysical address if the beginning or inside an object. This also represents the start of the range to be freedh]hnphysical address if the beginning or inside an object. This also represents the start of the range to be freed}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMbhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMchjubj)}(h'``size_t size`` size to be unregisteredh](j)}(h``size_t size``h]jS)}(hjh]h size_t size}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMehjubj)}(hhh]jM)}(hsize to be unregisteredh]hsize to be unregistered}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMdhj ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMehjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h!kmemleak_ignore_phys (C function)c.kmemleak_ignore_physhNtauh1hhjKhhhNhNubh)}(hhh](h)}(h2void __ref kmemleak_ignore_phys (phys_addr_t phys)h]h)}(h1void __ref kmemleak_ignore_phys(phys_addr_t phys)h](j)}(hvoidh]hvoid}(hjMhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIhhhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMpubj)}(h h]h }(hj\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIhhhj[hMpubh__ref}(hjIhhhNhNubj)}(h h]h }(hjnhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIhhhj[hMpubh)}(hkmemleak_ignore_physh]j)}(hkmemleak_ignore_physh]hkmemleak_ignore_phys}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjIhhhj[hMpubj8)}(h(phys_addr_t phys)h]j>)}(hphys_addr_t physh](h)}(hhh]j)}(h phys_addr_th]h phys_addr_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsbc.kmemleak_ignore_physasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hphysh]hphys}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjIhhhj[hMpubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjEhhhj[hMpubah}(h]j@ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj[hMphjBhhubj4)}(hhh]jM)}(hAsimilar to kmemleak_ignore but taking a physical address argumenth]hAsimilar to kmemleak_ignore but taking a physical address argument}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMphjhhubah}(h]h ]h"]h$]h&]uh1j3hjBhhhj[hMpubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hE**Parameters** ``phys_addr_t phys`` physical address of the objecth](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMthjubj)}(hhh]j)}(h3``phys_addr_t phys`` physical address of the objecth](j)}(h``phys_addr_t phys``h]jS)}(hj8h]hphys_addr_t phys}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj6ubah}(h]h ]h"]h$]h&]uh1jhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMvhj2ubj)}(hhh]jM)}(hphysical address of the objecth]hphysical address of the object}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:129: ./mm/kmemleak.chMrhjNubah}(h]h ]h"]h$]h&]uh1jhj2ubeh}(h]h ]h"]h$]h&]uh1jhjMhMvhj/ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubhcomment)}(h'#kernel-doc:: mm/hmm.c (build warnings)h]h'#kernel-doc:: mm/hmm.c (build warnings)}hj{sbah}(h]h ]h"]h$]h&]jjuh1jyhjKhhhhhKubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h devm_memremap_pages (C function)c.devm_memremap_pageshNtauh1hhjKhhhNhNubh)}(hhh](h)}(hJvoid * devm_memremap_pages (struct device *dev, struct dev_pagemap *pgmap)h]h)}(hHvoid *devm_memremap_pages(struct device *dev, struct dev_pagemap *pgmap)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:131: ./mm/memremap.chMcubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMcubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjhhhjhMcubh)}(hdevm_memremap_pagesh]j)}(hdevm_memremap_pagesh]hdevm_memremap_pages}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMcubj8)}(h/(struct device *dev, struct dev_pagemap *pgmap)h](j>)}(hstruct device *devh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hdeviceh]hdevice}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj modnameN classnameNjj)}j]j)}jjsbc.devm_memremap_pagesasbuh1hhjubj)}(h h]h }(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hj8hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hdevh]hdev}(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hstruct dev_pagemap *pgmaph](j)}(hjJ,h]hstruct}(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZubj)}(h h]h }(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZubh)}(hhh]j)}(h dev_pagemaph]h dev_pagemap}(hj|hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj~modnameN classnameNjj)}j]j&c.devm_memremap_pagesasbuh1hhjZubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjZubj)}(hpgmaph]hpgmap}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMcubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMcubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMchjhhubj4)}(hhh]jM)}(h7remap and provide memmap backing for the given resourceh]h7remap and provide memmap backing for the given resource}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:131: ./mm/memremap.chMchjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMcubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct device *dev`` hosting device for **res** ``struct dev_pagemap *pgmap`` pointer to a struct dev_pagemap **Notes** 1/ At a minimum the range and type members of **pgmap** must be initialized by the caller before passing it to this function 2/ The altmap field may optionally be initialized, in which case PGMAP_ALTMAP_VALID must be set in pgmap->flags. 3/ The ref field may optionally be provided, in which pgmap->ref must be 'live' on entry and will be killed and reaped at devm_memremap_pages_release() time, or if this routine fails. 4/ range is expected to be a host memory range that could feasibly be treated as a "System RAM" range, i.e. not a device mmio range, but this is not enforced.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:131: ./mm/memremap.chMghjubj)}(hhh](j)}(h2``struct device *dev`` hosting device for **res** h](j)}(h``struct device *dev``h]jS)}(hj h]hstruct device *dev}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:131: ./mm/memremap.chMdhjubj)}(hhh]jM)}(hhosting device for **res**h](hhosting device for }(hj9hhhNhNubj)}(h**res**h]hres}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj9ubeh}(h]h ]h"]h$]h&]uh1jLhj5hMdhj6ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj5hMdhjubj)}(h>``struct dev_pagemap *pgmap`` pointer to a struct dev_pagemap h](j)}(h``struct dev_pagemap *pgmap``h]jS)}(hjgh]hstruct dev_pagemap *pgmap}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjeubah}(h]h ]h"]h$]h&]uh1jhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:131: ./mm/memremap.chMehjaubj)}(hhh]jM)}(hpointer to a struct dev_pagemaph]hpointer to a struct dev_pagemap}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj|hMehj}ubah}(h]h ]h"]h$]h&]uh1jhjaubeh}(h]h ]h"]h$]h&]uh1jhj|hMehjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h **Notes**h]j)}(hjh]hNotes}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:131: ./mm/memremap.chMghjubj)}(hhh](j)}(h}1/ At a minimum the range and type members of **pgmap** must be initialized by the caller before passing it to this function h](j)}(hK1/ At a minimum the range and type members of **pgmap** must be initializedh](h.1/ At a minimum the range and type members of }(hjhhhNhNubj)}(h **pgmap**h]hpgmap}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh must be initialized}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:131: ./mm/memremap.chMhhjubj)}(hhh]jM)}(h0by the caller before passing it to this functionh]h0by the caller before passing it to this function}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhhjubj)}(hq2/ The altmap field may optionally be initialized, in which case PGMAP_ALTMAP_VALID must be set in pgmap->flags. h](j)}(h@2/ The altmap field may optionally be initialized, in which caseh]h@2/ The altmap field may optionally be initialized, in which case}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:131: ./mm/memremap.chMkhjubj)}(hhh]jM)}(h/PGMAP_ALTMAP_VALID must be set in pgmap->flags.h]h/PGMAP_ALTMAP_VALID must be set in pgmap->flags.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMkhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMkhjubj)}(h3/ The ref field may optionally be provided, in which pgmap->ref must be 'live' on entry and will be killed and reaped at devm_memremap_pages_release() time, or if this routine fails. h](j)}(hH3/ The ref field may optionally be provided, in which pgmap->ref must beh]hH3/ The ref field may optionally be provided, in which pgmap->ref must be}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:131: ./mm/memremap.chMohj-ubj)}(hhh]jM)}(hn'live' on entry and will be killed and reaped at devm_memremap_pages_release() time, or if this routine fails.h]hr‘live’ on entry and will be killed and reaped at devm_memremap_pages_release() time, or if this routine fails.}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:131: ./mm/memremap.chMnhj@ubah}(h]h ]h"]h$]h&]uh1jhj-ubeh}(h]h ]h"]h$]h&]uh1jhj?hMohjubj)}(h4/ range is expected to be a host memory range that could feasibly be treated as a "System RAM" range, i.e. not a device mmio range, but this is not enforced.h](j)}(hE4/ range is expected to be a host memory range that could feasibly beh]hE4/ range is expected to be a host memory range that could feasibly be}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1jhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:131: ./mm/memremap.chMrhj^ubj)}(hhh]jM)}(hXtreated as a "System RAM" range, i.e. not a device mmio range, but this is not enforced.h]h\treated as a “System RAM” range, i.e. not a device mmio range, but this is not enforced.}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjphMrhjqubah}(h]h ]h"]h$]h&]uh1jhj^ubeh}(h]h ]h"]h$]h&]uh1jhjphMrhjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hget_dev_pagemap (C function)c.get_dev_pagemaphNtauh1hhjKhhhNhNubh)}(hhh](h)}(h8struct dev_pagemap * get_dev_pagemap (unsigned long pfn)h]h)}(h6struct dev_pagemap *get_dev_pagemap(unsigned long pfn)h](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:131: ./mm/memremap.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh)}(hhh]j)}(h dev_pagemaph]h dev_pagemap}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jget_dev_pagemapsbc.get_dev_pagemapasbuh1hhjhhhjhMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjhhhjhMubh)}(hget_dev_pagemaph]j)}(hjh]hget_dev_pagemap}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMubj8)}(h(unsigned long pfn)h]j>)}(hunsigned long pfnh](j)}(hunsignedh]hunsigned}(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*ubj)}(h h]h }(hj<hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*ubj)}(hlongh]hlong}(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*ubj)}(h h]h }(hjXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*ubj)}(hpfnh]hpfn}(hjfhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj&ubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]jM)}(h8take a new live reference on the dev_pagemap for **pfn**h](h1take a new live reference on the dev_pagemap for }(hjhhhNhNubj)}(h**pfn**h]hpfn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:131: ./mm/memremap.chMhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hL**Parameters** ``unsigned long pfn`` page frame number to lookup page_maph](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:131: ./mm/memremap.chMhjubj)}(hhh]j)}(h:``unsigned long pfn`` page frame number to lookup page_maph](j)}(h``unsigned long pfn``h]jS)}(hjh]hunsigned long pfn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:131: ./mm/memremap.chMhjubj)}(hhh]jM)}(h$page frame number to lookup page_maph]h$page frame number to lookup page_map}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhN/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:131: ./mm/memremap.chMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h hugetlb_alloc_folio (C function)c.hugetlb_alloc_foliohNtauh1hhjKhhhNhNubh)}(hhh](h)}(hstruct folio * hugetlb_alloc_folio (struct hstate *h, struct mempolicy_interpreted *mpoli, struct mm_struct *mm, u8 alloc_flags)h]h)}(h~struct folio *hugetlb_alloc_folio(struct hstate *h, struct mempolicy_interpreted *mpoli, struct mm_struct *mm, u8 alloc_flags)h](j)}(hjJ,h]hstruct}(hj9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5hhhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:132: ./mm/hugetlb.chM4 ubj)}(h h]h }(hjGhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5hhhjFhM4 ubh)}(hhh]j)}(hfolioh]hfolio}(hjXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjUubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjZmodnameN classnameNjj)}j]j)}jhugetlb_alloc_foliosbc.hugetlb_alloc_folioasbuh1hhj5hhhjFhM4 ubj)}(h h]h }(hjyhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5hhhjFhM4 ubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj5hhhjFhM4 ubh)}(hhugetlb_alloc_folioh]j)}(hjvh]hhugetlb_alloc_folio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhj5hhhjFhM4 ubj8)}(h](struct hstate *h, struct mempolicy_interpreted *mpoli, struct mm_struct *mm, u8 alloc_flags)h](j>)}(hstruct hstate *hh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hhstateh]hhstate}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jtc.hugetlb_alloc_folioasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hhh]hh}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(h#struct mempolicy_interpreted *mpolih](j)}(hjJ,h]hstruct}(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hmempolicy_interpretedh]hmempolicy_interpreted}(hjAhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjCmodnameN classnameNjj)}j]jtc.hugetlb_alloc_folioasbuh1hhjubj)}(h h]h }(hj_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjmhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hmpolih]hmpoli}(hjzhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hstruct mm_struct *mmh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(h mm_structh]h mm_struct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jtc.hugetlb_alloc_folioasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hmmh]hmm}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hu8 alloc_flagsh](h)}(hhh]j)}(hu8h]hu8}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jtc.hugetlb_alloc_folioasbuh1hhjubj)}(h h]h }(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h alloc_flagsh]h alloc_flags}(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hj5hhhjFhM4 ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj1hhhjFhM4 ubah}(h]j,ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjFhM4 hj.hhubj4)}(hhh]jM)}(hAllocate a hugetlb folio.h]hAllocate a hugetlb folio.}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:132: ./mm/hugetlb.chM4 hjYhhubah}(h]h ]h"]h$]h&]uh1j3hj.hhhjFhM4 ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjtjHjtjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct hstate *h`` Hugetlb state control block. ``struct mempolicy_interpreted *mpoli`` Interpreted memory policy to use for allocation. ``struct mm_struct *mm`` Memory descriptor of the allocation target. ``u8 alloc_flags`` Flags controlling the allocation behavior. **Description** Allocates a hugetlb folio and handles cgroup charging and global hstate reservations. **Return** A pointer to the allocated folio, or an ERR_PTR on failure. -ENOSPC if cgroup charging fails or no folio is available.h](jM)}(h**Parameters**h]j)}(hj~h]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj|ubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:132: ./mm/hugetlb.chM8 hjxubj)}(hhh](j)}(h2``struct hstate *h`` Hugetlb state control block. h](j)}(h``struct hstate *h``h]jS)}(hjh]hstruct hstate *h}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:132: ./mm/hugetlb.chM5 hjubj)}(hhh]jM)}(hHugetlb state control block.h]hHugetlb state control block.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM5 hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM5 hjubj)}(hY``struct mempolicy_interpreted *mpoli`` Interpreted memory policy to use for allocation. h](j)}(h'``struct mempolicy_interpreted *mpoli``h]jS)}(hjh]h#struct mempolicy_interpreted *mpoli}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:132: ./mm/hugetlb.chM6 hjubj)}(hhh]jM)}(h0Interpreted memory policy to use for allocation.h]h0Interpreted memory policy to use for allocation.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM6 hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM6 hjubj)}(hE``struct mm_struct *mm`` Memory descriptor of the allocation target. h](j)}(h``struct mm_struct *mm``h]jS)}(hjh]hstruct mm_struct *mm}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj ubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:132: ./mm/hugetlb.chM7 hj ubj)}(hhh]jM)}(h+Memory descriptor of the allocation target.h]h+Memory descriptor of the allocation target.}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj$hM7 hj%ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj$hM7 hjubj)}(h>``u8 alloc_flags`` Flags controlling the allocation behavior. h](j)}(h``u8 alloc_flags``h]jS)}(hjHh]hu8 alloc_flags}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjFubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:132: ./mm/hugetlb.chM8 hjBubj)}(hhh]jM)}(h*Flags controlling the allocation behavior.h]h*Flags controlling the allocation behavior.}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj]hM8 hj^ubah}(h]h ]h"]h$]h&]uh1jhjBubeh}(h]h ]h"]h$]h&]uh1jhj]hM8 hjubeh}(h]h ]h"]h$]h&]uh1jhjxubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:132: ./mm/hugetlb.chM: hjxubjM)}(hUAllocates a hugetlb folio and handles cgroup charging and global hstate reservations.h]hUAllocates a hugetlb folio and handles cgroup charging and global hstate reservations.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:132: ./mm/hugetlb.chM9 hjxubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:132: ./mm/hugetlb.chM< hjxubjM)}(hvA pointer to the allocated folio, or an ERR_PTR on failure. -ENOSPC if cgroup charging fails or no folio is available.h]hvA pointer to the allocated folio, or an ERR_PTR on failure. -ENOSPC if cgroup charging fails or no folio is available.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:132: ./mm/hugetlb.chM= hjxubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hhuge_pmd_unshare (C function)c.huge_pmd_unsharehNtauh1hhjKhhhNhNubh)}(hhh](h)}(hjint huge_pmd_unshare (struct mmu_gather *tlb, struct vm_area_struct *vma, unsigned long addr, pte_t *ptep)h]h)}(hiint huge_pmd_unshare(struct mmu_gather *tlb, struct vm_area_struct *vma, unsigned long addr, pte_t *ptep)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:132: ./mm/hugetlb.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh)}(hhuge_pmd_unshareh]j)}(hhuge_pmd_unshareh]hhuge_pmd_unshare}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMubj8)}(hU(struct mmu_gather *tlb, struct vm_area_struct *vma, unsigned long addr, pte_t *ptep)h](j>)}(hstruct mmu_gather *tlbh](j)}(hjJ,h]hstruct}(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(ubj)}(h h]h }(hj9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(ubh)}(hhh]j)}(h mmu_gatherh]h mmu_gather}(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjLmodnameN classnameNjj)}j]j)}jjsbc.huge_pmd_unshareasbuh1hhj(ubj)}(h h]h }(hjjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(ubjr)}(hjuh]h*}(hjxhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj(ubj)}(htlbh]htlb}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj$ubj>)}(hstruct vm_area_struct *vmah](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hvm_area_structh]hvm_area_struct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jfc.huge_pmd_unshareasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hvmah]hvma}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj$ubj>)}(hunsigned long addrh](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(hlongh]hlong}(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h h]h }(hj8hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(haddrh]haddr}(hjFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj$ubj>)}(h pte_t *pteph](h)}(hhh]j)}(hpte_th]hpte_t}(hjbhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj_ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjdmodnameN classnameNjj)}j]jfc.huge_pmd_unshareasbuh1hhj[ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj[ubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj[ubj)}(hpteph]hptep}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj[ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj$ubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]jM)}(h3Unmap a pmd table if it is shared by multiple usersh]h3Unmap a pmd table if it is shared by multiple users}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:132: ./mm/hugetlb.chMhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hXH**Parameters** ``struct mmu_gather *tlb`` the current mmu_gather. ``struct vm_area_struct *vma`` the vma covering the pmd table. ``unsigned long addr`` the address we are trying to unshare. ``pte_t *ptep`` pointer into the (pmd) page table. **Description** Called with the page table lock held, the i_mmap_rwsem held in write mode and the hugetlb vma lock held in write mode. **Note** The caller must call huge_pmd_unshare_flush() before dropping the i_mmap_rwsem. **Return** 1 if it was a shared PMD table and it got unmapped, or 0 if it was not a shared PMD table.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:132: ./mm/hugetlb.chMhjubj)}(hhh](j)}(h3``struct mmu_gather *tlb`` the current mmu_gather. h](j)}(h``struct mmu_gather *tlb``h]jS)}(hjh]hstruct mmu_gather *tlb}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:132: ./mm/hugetlb.chMhjubj)}(hhh]jM)}(hthe current mmu_gather.h]hthe current mmu_gather.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h?``struct vm_area_struct *vma`` the vma covering the pmd table. h](j)}(h``struct vm_area_struct *vma``h]jS)}(hj?h]hstruct vm_area_struct *vma}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj=ubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:132: ./mm/hugetlb.chMhj9ubj)}(hhh]jM)}(hthe vma covering the pmd table.h]hthe vma covering the pmd table.}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjThMhjUubah}(h]h ]h"]h$]h&]uh1jhj9ubeh}(h]h ]h"]h$]h&]uh1jhjThMhjubj)}(h=``unsigned long addr`` the address we are trying to unshare. h](j)}(h``unsigned long addr``h]jS)}(hjxh]hunsigned long addr}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjvubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:132: ./mm/hugetlb.chMhjrubj)}(hhh]jM)}(h%the address we are trying to unshare.h]h%the address we are trying to unshare.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjrubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h3``pte_t *ptep`` pointer into the (pmd) page table. h](j)}(h``pte_t *ptep``h]jS)}(hjh]h pte_t *ptep}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:132: ./mm/hugetlb.chMhjubj)}(hhh]jM)}(h"pointer into the (pmd) page table.h]h"pointer into the (pmd) page table.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:132: ./mm/hugetlb.chMhjubjM)}(hvCalled with the page table lock held, the i_mmap_rwsem held in write mode and the hugetlb vma lock held in write mode.h]hvCalled with the page table lock held, the i_mmap_rwsem held in write mode and the hugetlb vma lock held in write mode.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:132: ./mm/hugetlb.chMhjubjM)}(h**Note**h]j)}(hjh]hNote}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:132: ./mm/hugetlb.chMhjubjM)}(hOThe caller must call huge_pmd_unshare_flush() before dropping the i_mmap_rwsem.h]hOThe caller must call huge_pmd_unshare_flush() before dropping the i_mmap_rwsem.}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:132: ./mm/hugetlb.chMhjubjM)}(h **Return**h]j)}(hj:h]hReturn}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj8ubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:132: ./mm/hugetlb.chMhjubjM)}(hZ1 if it was a shared PMD table and it got unmapped, or 0 if it was not a shared PMD table.h]hZ1 if it was a shared PMD table and it got unmapped, or 0 if it was not a shared PMD table.}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:132: ./mm/hugetlb.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h"folio_isolate_hugetlb (C function)c.folio_isolate_hugetlbhNtauh1hhjKhhhNhNubh)}(hhh](h)}(hHbool folio_isolate_hugetlb (struct folio *folio, struct list_head *list)h]h)}(hGbool folio_isolate_hugetlb(struct folio *folio, struct list_head *list)h](j)}(hjh]hbool}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{hhhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:132: ./mm/hugetlb.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{hhhjhMubh)}(hfolio_isolate_hugetlbh]j)}(hfolio_isolate_hugetlbh]hfolio_isolate_hugetlb}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhj{hhhjhMubj8)}(h-(struct folio *folio, struct list_head *list)h](j>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsbc.folio_isolate_hugetlbasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hstruct list_head *listh](j)}(hjJ,h]hstruct}(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubj)}(h h]h }(hj:hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubh)}(hhh]j)}(h list_headh]h list_head}(hjKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjMmodnameN classnameNjj)}j]jc.folio_isolate_hugetlbasbuh1hhj)ubj)}(h h]h }(hjihhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubjr)}(hjuh]h*}(hjwhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj)ubj)}(hlisth]hlist}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hj{hhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjwhhhjhMubah}(h]jrah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjthhubj4)}(hhh]jM)}(h)try to isolate an allocated hugetlb folioh]h)try to isolate an allocated hugetlb folio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:132: ./mm/hugetlb.chMhjhhubah}(h]h ]h"]h$]h&]uh1j3hjthhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hXN**Parameters** ``struct folio *folio`` the folio to isolate ``struct list_head *list`` the list to add the folio to on success **Description** Isolate an allocated (refcount > 0) hugetlb folio, marking it as isolated/non-migratable, and moving it from the active list to the given list. Isolation will fail if **folio** is not an allocated hugetlb folio, or if it is already isolated/non-migratable. On success, an additional folio reference is taken that must be dropped using folio_putback_hugetlb() to undo the isolation. **Return** True if isolation worked, otherwise False.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:132: ./mm/hugetlb.chMhjubj)}(hhh](j)}(h-``struct folio *folio`` the folio to isolate h](j)}(h``struct folio *folio``h]jS)}(hjh]hstruct folio *folio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:132: ./mm/hugetlb.chMhjubj)}(hhh]jM)}(hthe folio to isolateh]hthe folio to isolate}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(hC``struct list_head *list`` the list to add the folio to on success h](j)}(h``struct list_head *list``h]jS)}(hj(h]hstruct list_head *list}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj&ubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:132: ./mm/hugetlb.chMhj"ubj)}(hhh]jM)}(h'the list to add the folio to on successh]h'the list to add the folio to on success}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj=hMhj>ubah}(h]h ]h"]h$]h&]uh1jhj"ubeh}(h]h ]h"]h$]h&]uh1jhj=hMhjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjch]h Description}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1jhjaubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:132: ./mm/hugetlb.chMhjubjM)}(hIsolate an allocated (refcount > 0) hugetlb folio, marking it as isolated/non-migratable, and moving it from the active list to the given list.h]hIsolate an allocated (refcount > 0) hugetlb folio, marking it as isolated/non-migratable, and moving it from the active list to the given list.}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:132: ./mm/hugetlb.chMhjubjM)}(hpIsolation will fail if **folio** is not an allocated hugetlb folio, or if it is already isolated/non-migratable.h](hIsolation will fail if }(hjhhhNhNubj)}(h **folio**h]hfolio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhP is not an allocated hugetlb folio, or if it is already isolated/non-migratable.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:132: ./mm/hugetlb.chMhjubjM)}(h|On success, an additional folio reference is taken that must be dropped using folio_putback_hugetlb() to undo the isolation.h]h|On success, an additional folio reference is taken that must be dropped using folio_putback_hugetlb() to undo the isolation.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:132: ./mm/hugetlb.chMhjubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:132: ./mm/hugetlb.chMhjubjM)}(h*True if isolation worked, otherwise False.h]h*True if isolation worked, otherwise False.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:132: ./mm/hugetlb.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h"folio_putback_hugetlb (C function)c.folio_putback_hugetlbhNtauh1hhjKhhhNhNubh)}(hhh](h)}(h0void folio_putback_hugetlb (struct folio *folio)h]h)}(h/void folio_putback_hugetlb(struct folio *folio)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:132: ./mm/hugetlb.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhj hMubh)}(hfolio_putback_hugetlbh]j)}(hfolio_putback_hugetlbh]hfolio_putback_hugetlb}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhj hMubj8)}(h(struct folio *folio)h]j>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hj<hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj8ubj)}(h h]h }(hjIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj8ubh)}(hhh]j)}(hfolioh]hfolio}(hjZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjWubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj\modnameN classnameNjj)}j]j)}jj"sbc.folio_putback_hugetlbasbuh1hhj8ubj)}(h h]h }(hjzhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj8ubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj8ubj)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj8ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj4ubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhj hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhj hMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj hMhjhhubj4)}(hhh]jM)}(hunisolate a hugetlb folioh]hunisolate a hugetlb folio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:132: ./mm/hugetlb.chMhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhj hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hXV**Parameters** ``struct folio *folio`` the isolated hugetlb folio **Description** Putback/un-isolate the hugetlb folio that was previous isolated using folio_isolate_hugetlb(): marking it non-isolated/migratable and putting it back onto the active list. Will drop the additional folio reference obtained through folio_isolate_hugetlb().h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:132: ./mm/hugetlb.chMhjubj)}(hhh]j)}(h3``struct folio *folio`` the isolated hugetlb folio h](j)}(h``struct folio *folio``h]jS)}(hjh]hstruct folio *folio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:132: ./mm/hugetlb.chMhjubj)}(hhh]jM)}(hthe isolated hugetlb folioh]hthe isolated hugetlb folio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hj;h]h Description}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj9ubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:132: ./mm/hugetlb.chMhjubjM)}(hPutback/un-isolate the hugetlb folio that was previous isolated using folio_isolate_hugetlb(): marking it non-isolated/migratable and putting it back onto the active list.h]hPutback/un-isolate the hugetlb folio that was previous isolated using folio_isolate_hugetlb(): marking it non-isolated/migratable and putting it back onto the active list.}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:132: ./mm/hugetlb.chMhjubjM)}(hRWill drop the additional folio reference obtained through folio_isolate_hugetlb().h]hRWill drop the additional folio reference obtained through folio_isolate_hugetlb().}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:132: ./mm/hugetlb.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h folio_mark_accessed (C function)c.folio_mark_accessedhNtauh1hhjKhhhNhNubh)}(hhh](h)}(h.void folio_mark_accessed (struct folio *folio)h]h)}(h-void folio_mark_accessed(struct folio *folio)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh)}(hfolio_mark_accessedh]j)}(hfolio_mark_accessedh]hfolio_mark_accessed}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMubj8)}(h(struct folio *folio)h]j>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsbc.folio_mark_accessedasbuh1hhjubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hfolioh]hfolio}(hj%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]jM)}(h%Mark a folio as having seen activity.h]h%Mark a folio as having seen activity.}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chMhjLhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjgjHjgjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct folio *folio`` The folio to mark. **Description** This function will perform one of the following transitions: * inactive,unreferenced -> inactive,referenced * inactive,referenced -> active,unreferenced * active,unreferenced -> active,referenced When a newly allocated folio is not yet visible, so safe for non-atomic ops, __folio_set_referenced() may be substituted for folio_mark_accessed().h](jM)}(h**Parameters**h]j)}(hjqh]h Parameters}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1jhjoubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chMhjkubj)}(hhh]j)}(h+``struct folio *folio`` The folio to mark. h](j)}(h``struct folio *folio``h]jS)}(hjh]hstruct folio *folio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chMhjubj)}(hhh]jM)}(hThe folio to mark.h]hThe folio to mark.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjkubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chMhjkubjM)}(h inactive,referencedh]jM)}(hjh]h6inactive,unreferenced -> inactive,referenced}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chMhjubah}(h]h ]h"]h$]h&]uh1jbhjubjc)}(h6inactive,referenced -> active,unreferencedh]jM)}(hj h]h6inactive,referenced -> active,unreferenced}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chMhj ubah}(h]h ]h"]h$]h&]uh1jbhjubjc)}(h5active,unreferenced -> active,referenced h]jM)}(h4active,unreferenced -> active,referencedh]h4active,unreferenced -> active,referenced}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chMhj#ubah}(h]h ]h"]h$]h&]uh1jbhjubeh}(h]h ]h"]h$]h&]jjuuh1j]hjhMhjkubjM)}(hWhen a newly allocated folio is not yet visible, so safe for non-atomic ops, __folio_set_referenced() may be substituted for folio_mark_accessed().h]hWhen a newly allocated folio is not yet visible, so safe for non-atomic ops, __folio_set_referenced() may be substituted for folio_mark_accessed().}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chMhjkubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfolio_add_lru (C function)c.folio_add_lruhNtauh1hhjKhhhNhNubh)}(hhh](h)}(h(void folio_add_lru (struct folio *folio)h]h)}(h'void folio_add_lru(struct folio *folio)h](j)}(hvoidh]hvoid}(hjqhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmhhhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmhhhjhMubh)}(h folio_add_lruh]j)}(h folio_add_lruh]h folio_add_lru}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjmhhhjhMubj8)}(h(struct folio *folio)h]j>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsbc.folio_add_lruasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjmhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjihhhjhMubah}(h]jdah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjfhhubj4)}(hhh]jM)}(hAdd a folio to an LRU list.h]hAdd a folio to an LRU list.}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chMhj.hhubah}(h]h ]h"]h$]h&]uh1j3hjfhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjIjHjIjIjJjKuh1hhhhjKhNhNubj)}(hXz**Parameters** ``struct folio *folio`` The folio to be added to the LRU. **Description** Queue the folio for addition to the LRU. The decision on whether to add the page to the [in]active [file|anon] list is deferred until the folio_batch is drained. This gives a chance for the caller of folio_add_lru() have the folio added to the active list using folio_mark_accessed().h](jM)}(h**Parameters**h]j)}(hjSh]h Parameters}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjQubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chMhjMubj)}(hhh]j)}(h:``struct folio *folio`` The folio to be added to the LRU. h](j)}(h``struct folio *folio``h]jS)}(hjrh]hstruct folio *folio}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjpubah}(h]h ]h"]h$]h&]uh1jhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chMhjlubj)}(hhh]jM)}(h!The folio to be added to the LRU.h]h!The folio to be added to the LRU.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjlubeh}(h]h ]h"]h$]h&]uh1jhjhMhjiubah}(h]h ]h"]h$]h&]uh1jhjMubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chMhjMubjM)}(hXQueue the folio for addition to the LRU. The decision on whether to add the page to the [in]active [file|anon] list is deferred until the folio_batch is drained. This gives a chance for the caller of folio_add_lru() have the folio added to the active list using folio_mark_accessed().h]hXQueue the folio for addition to the LRU. The decision on whether to add the page to the [in]active [file|anon] list is deferred until the folio_batch is drained. This gives a chance for the caller of folio_add_lru() have the folio added to the active list using folio_mark_accessed().}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chMhjMubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfolio_add_lru_vma (C function)c.folio_add_lru_vmahNtauh1hhjKhhhNhNubh)}(hhh](h)}(hHvoid folio_add_lru_vma (struct folio *folio, struct vm_area_struct *vma)h]h)}(hGvoid folio_add_lru_vma(struct folio *folio, struct vm_area_struct *vma)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh)}(hfolio_add_lru_vmah]j)}(hfolio_add_lru_vmah]hfolio_add_lru_vma}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMubj8)}(h1(struct folio *folio, struct vm_area_struct *vma)h](j>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hj/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubj)}(h h]h }(hj<hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubh)}(hhh]j)}(hfolioh]hfolio}(hjMhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjOmodnameN classnameNjj)}j]j)}jjsbc.folio_add_lru_vmaasbuh1hhj+ubj)}(h h]h }(hjmhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubjr)}(hjuh]h*}(hj{hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj+ubj)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj'ubj>)}(hstruct vm_area_struct *vmah](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hvm_area_structh]hvm_area_struct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jic.folio_add_lru_vmaasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hvmah]hvma}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj'ubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]jM)}(h5Add a folio to the appropriate LRU list for this VMA.h]h5Add a folio to the appropriate LRU list for this VMA.}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chMhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj:jHj:jIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct folio *folio`` The folio to be added to the LRU. ``struct vm_area_struct *vma`` VMA in which the folio is mapped. **Description** If the VMA is mlocked, **folio** is added to the unevictable list. Otherwise, it is treated the same way as folio_add_lru().h](jM)}(h**Parameters**h]j)}(hjDh]h Parameters}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjBubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chMhj>ubj)}(hhh](j)}(h:``struct folio *folio`` The folio to be added to the LRU. h](j)}(h``struct folio *folio``h]jS)}(hjch]hstruct folio *folio}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjaubah}(h]h ]h"]h$]h&]uh1jhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chMhj]ubj)}(hhh]jM)}(h!The folio to be added to the LRU.h]h!The folio to be added to the LRU.}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjxhMhjyubah}(h]h ]h"]h$]h&]uh1jhj]ubeh}(h]h ]h"]h$]h&]uh1jhjxhMhjZubj)}(hA``struct vm_area_struct *vma`` VMA in which the folio is mapped. h](j)}(h``struct vm_area_struct *vma``h]jS)}(hjh]hstruct vm_area_struct *vma}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chMhjubj)}(hhh]jM)}(h!VMA in which the folio is mapped.h]h!VMA in which the folio is mapped.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjZubeh}(h]h ]h"]h$]h&]uh1jhj>ubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chMhj>ubjM)}(h|If the VMA is mlocked, **folio** is added to the unevictable list. Otherwise, it is treated the same way as folio_add_lru().h](hIf the VMA is mlocked, }(hjhhhNhNubj)}(h **folio**h]hfolio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh\ is added to the unevictable list. Otherwise, it is treated the same way as folio_add_lru().}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chMhj>ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h"deactivate_file_folio (C function)c.deactivate_file_foliohNtauh1hhjKhhhNhNubh)}(hhh](h)}(h0void deactivate_file_folio (struct folio *folio)h]h)}(h/void deactivate_file_folio(struct folio *folio)h](j)}(hvoidh]hvoid}(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*hhhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chMubj)}(h h]h }(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*hhhj<hMubh)}(hdeactivate_file_folioh]j)}(hdeactivate_file_folioh]hdeactivate_file_folio}(hjOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjKubah}(h]h ](jjeh"]h$]h&]jjuh1hhj*hhhj<hMubj8)}(h(struct folio *folio)h]j>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubj)}(h h]h }(hjxhhhNhNubah0}(h]h ]jah"]h$]h&]uh1jhjgubh)}(hhh]j)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjQsbc.deactivate_file_folioasbuh1hhjgubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjgubj)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjcubah}(h]h ]h"]h$]h&]jjuh1j7hj*hhhj<hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj&hhhj<hMubah}(h]j!ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj<hMhj#hhubj4)}(hhh]jM)}(hDeactivate a file folio.h]hDeactivate a file folio.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chMhjhhubah}(h]h ]h"]h$]h&]uh1j3hj#hhhj<hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hX&**Parameters** ``struct folio *folio`` Folio to deactivate. **Description** This function hints to the VM that **folio** is a good reclaim candidate, for example if its invalidation fails due to the folio being dirty or under writeback. **Context** Caller holds a reference on the folio.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chMhj ubj)}(hhh]j)}(h-``struct folio *folio`` Folio to deactivate. h](j)}(h``struct folio *folio``h]jS)}(hj/h]hstruct folio *folio}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj-ubah}(h]h ]h"]h$]h&]uh1jhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chMhj)ubj)}(hhh]jM)}(hFolio to deactivate.h]hFolio to deactivate.}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjDhMhjEubah}(h]h ]h"]h$]h&]uh1jhj)ubeh}(h]h ]h"]h$]h&]uh1jhjDhMhj&ubah}(h]h ]h"]h$]h&]uh1jhj ubjM)}(h**Description**h]j)}(hjjh]h Description}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjhubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chMhj ubjM)}(hThis function hints to the VM that **folio** is a good reclaim candidate, for example if its invalidation fails due to the folio being dirty or under writeback.h](h#This function hints to the VM that }(hjhhhNhNubj)}(h **folio**h]hfolio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubht is a good reclaim candidate, for example if its invalidation fails due to the folio being dirty or under writeback.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chMhj ubjM)}(h **Context**h]j)}(hjh]hContext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chMhj ubjM)}(h&Caller holds a reference on the folio.h]h&Caller holds a reference on the folio.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chMhj ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h folio_mark_lazyfree (C function)c.folio_mark_lazyfreehNtauh1hhjKhhhNhNubh)}(hhh](h)}(h.void folio_mark_lazyfree (struct folio *folio)h]h)}(h-void folio_mark_lazyfree(struct folio *folio)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh)}(hfolio_mark_lazyfreeh]j)}(hfolio_mark_lazyfreeh]hfolio_mark_lazyfree}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMubj8)}(h(struct folio *folio)h]j>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hj%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubj)}(h h]h }(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubh)}(hhh]j)}(hfolioh]hfolio}(hjChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjEmodnameN classnameNjj)}j]j)}jj sbc.folio_mark_lazyfreeasbuh1hhj!ubj)}(h h]h }(hjchhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubjr)}(hjuh]h*}(hjqhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj!ubj)}(hfolioh]hfolio}(hj~hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]jM)}(hmake an anon folio lazyfreeh]hmake an anon folio lazyfree}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chMhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``struct folio *folio`` folio to deactivate **Description** folio_mark_lazyfree() moves **folio** to the inactive file list. This is done to accelerate the reclaim of **folio**.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chMhjubj)}(hhh]j)}(h,``struct folio *folio`` folio to deactivate h](j)}(h``struct folio *folio``h]jS)}(hjh]hstruct folio *folio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chMhjubj)}(hhh]jM)}(hfolio to deactivateh]hfolio to deactivate}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hj$h]h Description}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj"ubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chMhjubjM)}(hufolio_mark_lazyfree() moves **folio** to the inactive file list. This is done to accelerate the reclaim of **folio**.h](hfolio_mark_lazyfree() moves }(hj:hhhNhNubj)}(h **folio**h]hfolio}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj:ubhF to the inactive file list. This is done to accelerate the reclaim of }(hj:hhhNhNubj)}(h **folio**h]hfolio}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jhj:ubh.}(hj:hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h&lru_cache_drain_for_folio (C function)c.lru_cache_drain_for_foliohNtauh1hhjKhhhNhNubh)}(hhh](h)}(htvoid lru_cache_drain_for_folio (const struct folio *folio, unsigned int extra_refs, enum lru_cache_drained *drained)h]h)}(hsvoid lru_cache_drain_for_folio(const struct folio *folio, unsigned int extra_refs, enum lru_cache_drained *drained)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chMyubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMyubh)}(hlru_cache_drain_for_folioh]j)}(hlru_cache_drain_for_folioh]hlru_cache_drain_for_folio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMyubj8)}(hU(const struct folio *folio, unsigned int extra_refs, enum lru_cache_drained *drained)h](j>)}(hconst struct folio *folioh](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsbc.lru_cache_drain_for_folioasbuh1hhjubj)}(h h]h }(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hj1hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hfolioh]hfolio}(hj>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hunsigned int extra_refsh](j)}(hunsignedh]hunsigned}(hjWhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSubj)}(h h]h }(hjehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSubj)}(hinth]hint}(hjshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSubj)}(h extra_refsh]h extra_refs}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(henum lru_cache_drained *drainedh](j)}(hj#!h]henum}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hlru_cache_drainedh]hlru_cache_drained}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.lru_cache_drain_for_folioasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hdrainedh]hdrained}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMyubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMyubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMyhjhhubj4)}(hhh]jM)}(h:drain LRU caches if the caches might hold folio referencesh]h:drain LRU caches if the caches might hold folio references}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chMyhj&hhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMyubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjAjHjAjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``const struct folio *folio`` The folio. ``unsigned int extra_refs`` Extra folio references held by the caller. ``enum lru_cache_drained *drained`` Drain status for batch folio processing. **Description** Drain LRU caches if the caches might hold folio references. Start with a local LRU cache drain, to then drain LRU caches on all CPUs if local draining was insufficient. This function detects LRU cache references by comparing the folio refcount with the sum of the expected folio refcount + extra references held by the caller. Note that we cannot rely on PG_lru to reliably detect all LRU cache references, and there are rare scenarios (concurrent folio (un)mapping) where this function might miss detecting LRU cache references. If **drained** is not NULL, the function will avoid re-draining LRU caches when processing multiple folios in a row. In that case, the variable **drained** points at must be initialized to LRU_CACHE_NOT_DRAINED before the first invocation by the caller.h](jM)}(h**Parameters**h]j)}(hjKh]h Parameters}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjIubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chM}hjEubj)}(hhh](j)}(h)``const struct folio *folio`` The folio. h](j)}(h``const struct folio *folio``h]jS)}(hjjh]hconst struct folio *folio}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjhubah}(h]h ]h"]h$]h&]uh1jhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chM{hjdubj)}(hhh]jM)}(h The folio.h]h The folio.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM{hjubah}(h]h ]h"]h$]h&]uh1jhjdubeh}(h]h ]h"]h$]h&]uh1jhjhM{hjaubj)}(hG``unsigned int extra_refs`` Extra folio references held by the caller. h](j)}(h``unsigned int extra_refs``h]jS)}(hjh]hunsigned int extra_refs}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chM|hjubj)}(hhh]jM)}(h*Extra folio references held by the caller.h]h*Extra folio references held by the caller.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM|hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM|hjaubj)}(hM``enum lru_cache_drained *drained`` Drain status for batch folio processing. h](j)}(h#``enum lru_cache_drained *drained``h]jS)}(hjh]henum lru_cache_drained *drained}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chM}hjubj)}(hhh]jM)}(h(Drain status for batch folio processing.h]h(Drain status for batch folio processing.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM}hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM}hjaubeh}(h]h ]h"]h$]h&]uh1jhjEubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chMhjEubjM)}(hDrain LRU caches if the caches might hold folio references. Start with a local LRU cache drain, to then drain LRU caches on all CPUs if local draining was insufficient.h]hDrain LRU caches if the caches might hold folio references. Start with a local LRU cache drain, to then drain LRU caches on all CPUs if local draining was insufficient.}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chM~hjEubjM)}(hXhThis function detects LRU cache references by comparing the folio refcount with the sum of the expected folio refcount + extra references held by the caller. Note that we cannot rely on PG_lru to reliably detect all LRU cache references, and there are rare scenarios (concurrent folio (un)mapping) where this function might miss detecting LRU cache references.h]hXhThis function detects LRU cache references by comparing the folio refcount with the sum of the expected folio refcount + extra references held by the caller. Note that we cannot rely on PG_lru to reliably detect all LRU cache references, and there are rare scenarios (concurrent folio (un)mapping) where this function might miss detecting LRU cache references.}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chMhjEubjM)}(hIf **drained** is not NULL, the function will avoid re-draining LRU caches when processing multiple folios in a row. In that case, the variable **drained** points at must be initialized to LRU_CACHE_NOT_DRAINED before the first invocation by the caller.h](hIf }(hjKhhhNhNubj)}(h **drained**h]hdrained}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1jhjKubh is not NULL, the function will avoid re-draining LRU caches when processing multiple folios in a row. In that case, the variable }(hjKhhhNhNubj)}(h **drained**h]hdrained}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1jhjKubhb points at must be initialized to LRU_CACHE_NOT_DRAINED before the first invocation by the caller.}(hjKhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chMhjEubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfolios_put_refs (C function)c.folios_put_refshNtauh1hhjKhhhNhNubh)}(hhh](h)}(hEvoid folios_put_refs (struct folio_batch *folios, unsigned int *refs)h]h)}(hDvoid folios_put_refs(struct folio_batch *folios, unsigned int *refs)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh)}(hfolios_put_refsh]j)}(hfolios_put_refsh]hfolios_put_refs}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMubj8)}(h0(struct folio_batch *folios, unsigned int *refs)h](j>)}(hstruct folio_batch *foliosh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(h folio_batchh]h folio_batch}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsbc.folios_put_refsasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hj'hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hfoliosh]hfolios}(hj4hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hunsigned int *refsh](j)}(hunsignedh]hunsigned}(hjMhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIubj)}(h h]h }(hj[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIubj)}(hinth]hint}(hjihhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIubj)}(h h]h }(hjwhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjIubj)}(hrefsh]hrefs}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]jM)}(h0Reduce the reference count on a batch of folios.h]h0Reduce the reference count on a batch of folios.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chMhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hX{**Parameters** ``struct folio_batch *folios`` The folios. ``unsigned int *refs`` The number of refs to subtract from each folio. **Description** Like folio_put(), but for a batch of folios. This is more efficient than writing the loop yourself as it will optimise the locks which need to be taken if the folios are freed. The folios batch is returned empty and ready to be reused for another batch; there is no need to reinitialise it. If **refs** is NULL, we subtract one from each folio refcount. **Context** May be called in process or interrupt context, but not in NMI context. May be called while holding a spinlock.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chMhjubj)}(hhh](j)}(h+``struct folio_batch *folios`` The folios. h](j)}(h``struct folio_batch *folios``h]jS)}(hjh]hstruct folio_batch *folios}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chMhjubj)}(hhh]jM)}(h The folios.h]h The folios.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(hG``unsigned int *refs`` The number of refs to subtract from each folio. h](j)}(h``unsigned int *refs``h]jS)}(hj6h]hunsigned int *refs}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj4ubah}(h]h ]h"]h$]h&]uh1jhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chMhj0ubj)}(hhh]jM)}(h/The number of refs to subtract from each folio.h]h/The number of refs to subtract from each folio.}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjKhMhjLubah}(h]h ]h"]h$]h&]uh1jhj0ubeh}(h]h ]h"]h$]h&]uh1jhjKhMhjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjqh]h Description}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1jhjoubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chMhjubjM)}(hXdLike folio_put(), but for a batch of folios. This is more efficient than writing the loop yourself as it will optimise the locks which need to be taken if the folios are freed. The folios batch is returned empty and ready to be reused for another batch; there is no need to reinitialise it. If **refs** is NULL, we subtract one from each folio refcount.h](hX)Like folio_put(), but for a batch of folios. This is more efficient than writing the loop yourself as it will optimise the locks which need to be taken if the folios are freed. The folios batch is returned empty and ready to be reused for another batch; there is no need to reinitialise it. If }(hjhhhNhNubj)}(h**refs**h]hrefs}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh3 is NULL, we subtract one from each folio refcount.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chMhjubjM)}(h **Context**h]j)}(hjh]hContext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chMhjubjM)}(hoMay be called in process or interrupt context, but not in NMI context. May be called while holding a spinlock.h]hoMay be called in process or interrupt context, but not in NMI context. May be called while holding a spinlock.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hrelease_pages (C function)c.release_pageshNtauh1hhjKhhhNhNubh)}(hhh](h)}(h2void release_pages (release_pages_arg arg, int nr)h]h)}(h1void release_pages(release_pages_arg arg, int nr)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh)}(h release_pagesh]j)}(h release_pagesh]h release_pages}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMubj8)}(h(release_pages_arg arg, int nr)h](j>)}(hrelease_pages_arg argh](h)}(hhh]j)}(hrelease_pages_argh]hrelease_pages_arg}(hj/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj1modnameN classnameNjj)}j]j)}jjsbc.release_pagesasbuh1hhj(ubj)}(h h]h }(hjOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(ubj)}(hargh]harg}(hj]hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj$ubj>)}(hint nrh](j)}(hinth]hint}(hjvhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjrubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjrubj)}(hnrh]hnr}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjrubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj$ubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]jM)}(hbatched put_page()h]hbatched put_page()}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chMhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``release_pages_arg arg`` array of pages to release ``int nr`` number of pages **Description** Decrement the reference count on all the pages in **arg**. If it fell to zero, remove the page from the LRU and free it. Note that the argument can be an array of pages, encoded pages, or folio pointers. We ignore any encoded bits, and turn any of them into just a folio that gets free'd.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chMhjubj)}(hhh](j)}(h4``release_pages_arg arg`` array of pages to release h](j)}(h``release_pages_arg arg``h]jS)}(hjh]hrelease_pages_arg arg}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chMhjubj)}(hhh]jM)}(harray of pages to releaseh]harray of pages to release}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h``int nr`` number of pages h](j)}(h ``int nr``h]jS)}(hj6h]hint nr}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj4ubah}(h]h ]h"]h$]h&]uh1jhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chMhj0ubj)}(hhh]jM)}(hnumber of pagesh]hnumber of pages}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjKhMhjLubah}(h]h ]h"]h$]h&]uh1jhj0ubeh}(h]h ]h"]h$]h&]uh1jhjKhMhjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjqh]h Description}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1jhjoubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chMhjubjM)}(hyDecrement the reference count on all the pages in **arg**. If it fell to zero, remove the page from the LRU and free it.h](h2Decrement the reference count on all the pages in }(hjhhhNhNubj)}(h**arg**h]harg}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh@. If it fell to zero, remove the page from the LRU and free it.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chMhjubjM)}(hNote that the argument can be an array of pages, encoded pages, or folio pointers. We ignore any encoded bits, and turn any of them into just a folio that gets free'd.h]hNote that the argument can be an array of pages, encoded pages, or folio pointers. We ignore any encoded bits, and turn any of them into just a folio that gets free’d.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h,folio_batch_remove_exceptionals (C function)!c.folio_batch_remove_exceptionalshNtauh1hhjKhhhNhNubh)}(hhh](h)}(hAvoid folio_batch_remove_exceptionals (struct folio_batch *fbatch)h]h)}(h@void folio_batch_remove_exceptionals(struct folio_batch *fbatch)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chMPubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMPubh)}(hfolio_batch_remove_exceptionalsh]j)}(hfolio_batch_remove_exceptionalsh]hfolio_batch_remove_exceptionals}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMPubj8)}(h(struct folio_batch *fbatch)h]j>)}(hstruct folio_batch *fbatchh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(h folio_batchh]h folio_batch}(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj4modnameN classnameNjj)}j]j)}jjsb!c.folio_batch_remove_exceptionalsasbuh1hhjubj)}(h h]h }(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hj`hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hfbatchh]hfbatch}(hjmhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj ubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMPubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMPubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMPhjhhubj4)}(hhh]jM)}(hPrune non-folios from a batch.h]hPrune non-folios from a batch.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chMPhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMPubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hX7**Parameters** ``struct folio_batch *fbatch`` The batch to prune **Description** find_get_entries() fills a batch with both folios and shadow/swap/DAX entries. This function prunes all the non-folio entries from **fbatch** without leaving holes, so that it can be passed on to folio-only batch operations.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chMThjubj)}(hhh]j)}(h2``struct folio_batch *fbatch`` The batch to prune h](j)}(h``struct folio_batch *fbatch``h]jS)}(hjh]hstruct folio_batch *fbatch}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chMQhjubj)}(hhh]jM)}(hThe batch to pruneh]hThe batch to prune}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMQhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMQhjubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chMShjubjM)}(hfind_get_entries() fills a batch with both folios and shadow/swap/DAX entries. This function prunes all the non-folio entries from **fbatch** without leaving holes, so that it can be passed on to folio-only batch operations.h](hfind_get_entries() fills a batch with both folios and shadow/swap/DAX entries. This function prunes all the non-folio entries from }(hj)hhhNhNubj)}(h **fbatch**h]hfbatch}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj)ubhS without leaving holes, so that it can be passed on to folio-only batch operations.}(hj)hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:133: ./mm/folio.chMRhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h*get_mem_cgroup_css_from_folio (C function)c.get_mem_cgroup_css_from_foliohNtauh1hhjKhhhNhNubh)}(hhh](h)}(hVstruct cgroup_subsys_state * get_mem_cgroup_css_from_folio (const struct folio *folio)h]h)}(hTstruct cgroup_subsys_state *get_mem_cgroup_css_from_folio(const struct folio *folio)h](j)}(hjJ,h]hstruct}(hjjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjfhhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMUubj)}(h h]h }(hjxhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjfhhhjwhMUubh)}(hhh]j)}(hcgroup_subsys_stateh]hcgroup_subsys_state}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jget_mem_cgroup_css_from_foliosbc.get_mem_cgroup_css_from_folioasbuh1hhjfhhhjwhMUubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjfhhhjwhMUubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjfhhhjwhMUubh)}(hget_mem_cgroup_css_from_folioh]j)}(hjh]hget_mem_cgroup_css_from_folio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjfhhhjwhMUubj8)}(h(const struct folio *folio)h]j>)}(hconst struct folio *folioh](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.get_mem_cgroup_css_from_folioasbuh1hhjubj)}(h h]h }(hj;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjIhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hfolioh]hfolio}(hjVhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjfhhhjwhMUubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjbhhhjwhMUubah}(h]j]ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjwhMUhj_hhubj4)}(hhh]jM)}(h2acquire a css of the memcg associated with a folioh]h2acquire a css of the memcg associated with a folio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMUhj}hhubah}(h]h ]h"]h$]h&]uh1j3hj_hhhjwhMUubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hXX**Parameters** ``const struct folio *folio`` folio of interest **Description** If memcg is bound to the default hierarchy, css of the memcg associated with **folio** is returned. The returned css remains associated with **folio** until it is released. If memcg is bound to a traditional hierarchy, the css of root_mem_cgroup is returned.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMYhjubj)}(hhh]j)}(h0``const struct folio *folio`` folio of interest h](j)}(h``const struct folio *folio``h]jS)}(hjh]hconst struct folio *folio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMVhjubj)}(hhh]jM)}(hfolio of interesth]hfolio of interest}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMVhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMVhjubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMXhjubjM)}(hIf memcg is bound to the default hierarchy, css of the memcg associated with **folio** is returned. The returned css remains associated with **folio** until it is released.h](hMIf memcg is bound to the default hierarchy, css of the memcg associated with }(hjhhhNhNubj)}(h **folio**h]hfolio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh8 is returned. The returned css remains associated with }(hjhhhNhNubj)}(h **folio**h]hfolio}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh until it is released.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMWhjubjM)}(hUIf memcg is bound to a traditional hierarchy, the css of root_mem_cgroup is returned.h]hUIf memcg is bound to a traditional hierarchy, the css of root_mem_cgroup is returned.}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM[hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hpage_cgroup_ino (C function)c.page_cgroup_inohNtauh1hhjKhhhNhNubh)}(hhh](h)}(h/ino_t page_cgroup_ino (const struct page *page)h]h)}(h.ino_t page_cgroup_ino(const struct page *page)h](h)}(hhh]j)}(hino_th]hino_t}(hjwhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjtubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjymodnameN classnameNjj)}j]j)}jpage_cgroup_inosbc.page_cgroup_inoasbuh1hhjphhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMlubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjphhhjhMlubh)}(hpage_cgroup_inoh]j)}(hjh]hpage_cgroup_ino}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjphhhjhMlubj8)}(h(const struct page *page)h]j>)}(hconst struct page *pageh](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hpageh]hpage}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.page_cgroup_inoasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hj+hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hpageh]hpage}(hj8hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjphhhjhMlubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjlhhhjhMlubah}(h]jgah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMlhjihhubj4)}(hhh]jM)}(h5return inode number of the memcg a page is charged toh]h5return inode number of the memcg a page is charged to}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMlhj_hhubah}(h]h ]h"]h$]h&]uh1j3hjihhhjhMlubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjzjHjzjIjJjKuh1hhhhjKhNhNubj)}(hX;**Parameters** ``const struct page *page`` the page **Description** Look up the closest online ancestor of the memory cgroup **page** is charged to and return its inode number or 0 if **page** is not charged to any cgroup. It is safe to call this function without holding a reference to **page**. Note, this function is inherently racy, because there is nothing to prevent the cgroup inode from getting torn down and potentially reallocated a moment after page_cgroup_ino() returns, so it only should be used by callers that do not care (such as procfs interfaces).h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMphj~ubj)}(hhh]j)}(h%``const struct page *page`` the page h](j)}(h``const struct page *page``h]jS)}(hjh]hconst struct page *page}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMmhjubj)}(hhh]jM)}(hthe pageh]hthe page}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMmhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMmhjubah}(h]h ]h"]h$]h&]uh1jhj~ubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMohj~ubjM)}(hLook up the closest online ancestor of the memory cgroup **page** is charged to and return its inode number or 0 if **page** is not charged to any cgroup. It is safe to call this function without holding a reference to **page**.h](h9Look up the closest online ancestor of the memory cgroup }(hjhhhNhNubj)}(h**page**h]hpage}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh3 is charged to and return its inode number or 0 if }(hjhhhNhNubj)}(h**page**h]hpage}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh_ is not charged to any cgroup. It is safe to call this function without holding a reference to }(hjhhhNhNubj)}(h**page**h]hpage}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMnhj~ubjM)}(hX Note, this function is inherently racy, because there is nothing to prevent the cgroup inode from getting torn down and potentially reallocated a moment after page_cgroup_ino() returns, so it only should be used by callers that do not care (such as procfs interfaces).h]hX Note, this function is inherently racy, because there is nothing to prevent the cgroup inode from getting torn down and potentially reallocated a moment after page_cgroup_ino() returns, so it only should be used by callers that do not care (such as procfs interfaces).}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMrhj~ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h(lruvec_page_state_monotonic (C function)c.lruvec_page_state_monotonichNtauh1hhjKhhhNhNubh)}(hhh](h)}(h`unsigned long lruvec_page_state_monotonic (const struct lruvec *lruvec, enum node_stat_item idx)h]h)}(h_unsigned long lruvec_page_state_monotonic(const struct lruvec *lruvec, enum node_stat_item idx)h](j)}(hunsignedh]hunsigned}(hjhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjdhhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMubj)}(h h]h }(hjwhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjdhhhjvhMubj)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjdhhhjvhMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjdhhhjvhMubh)}(hlruvec_page_state_monotonich]j)}(hlruvec_page_state_monotonich]hlruvec_page_state_monotonic}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjdhhhjvhMubj8)}(h6(const struct lruvec *lruvec, enum node_stat_item idx)h](j>)}(hconst struct lruvec *lruvech](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hlruvech]hlruvec}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsbc.lruvec_page_state_monotonicasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hj(hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hlruvech]hlruvec}(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(henum node_stat_item idxh](j)}(hj#!h]henum}(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJubj)}(h h]h }(hj[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJubh)}(hhh]j)}(hnode_stat_itemh]hnode_stat_item}(hjlhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjiubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjnmodnameN classnameNjj)}j]jc.lruvec_page_state_monotonicasbuh1hhjJubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJubj)}(hidxh]hidx}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjdhhhjvhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj`hhhjvhMubah}(h]j[ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjvhMhj]hhubj4)}(hhh]jM)}(h0non-clamping lruvec stat read for delta samplingh]h0non-clamping lruvec stat read for delta sampling}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjhhubah}(h]h ]h"]h$]h&]uh1j3hj]hhhjvhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hX5**Parameters** ``const struct lruvec *lruvec`` the LRU vector to read from ``enum node_stat_item idx`` the node_stat_item to read **Description** Returns the raw state[idx] value cast to unsigned long, skipping the clamp-negative-to-zero step in lruvec_page_state(). Intended for callers that snapshot a monotonically-incremented counter and subtract two samples: unsigned modular arithmetic then yields the correct delta across a signed-long wraparound (a real hazard on 32-bit) that the clamp would otherwise turn into a huge spurious delta. Do NOT use for non-monotonic page-count reads where a transient negative reading from per-CPU delta skew must present as zero. XXX: This helper (and its node/global peers) exists because some monotonically-incremented event counters are stored in enum node_stat_item.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjubj)}(hhh](j)}(h<``const struct lruvec *lruvec`` the LRU vector to read from h](j)}(h``const struct lruvec *lruvec``h]jS)}(hjh]hconst struct lruvec *lruvec}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjubj)}(hhh]jM)}(hthe LRU vector to read fromh]hthe LRU vector to read from}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h7``enum node_stat_item idx`` the node_stat_item to read h](j)}(h``enum node_stat_item idx``h]jS)}(hj<h]henum node_stat_item idx}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj:ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj6ubj)}(hhh]jM)}(hthe node_stat_item to readh]hthe node_stat_item to read}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjQhMhjRubah}(h]h ]h"]h$]h&]uh1jhj6ubeh}(h]h ]h"]h$]h&]uh1jhjQhMhjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjwh]h Description}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjuubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjubjM)}(hXReturns the raw state[idx] value cast to unsigned long, skipping the clamp-negative-to-zero step in lruvec_page_state(). Intended for callers that snapshot a monotonically-incremented counter and subtract two samples: unsigned modular arithmetic then yields the correct delta across a signed-long wraparound (a real hazard on 32-bit) that the clamp would otherwise turn into a huge spurious delta.h]hXReturns the raw state[idx] value cast to unsigned long, skipping the clamp-negative-to-zero step in lruvec_page_state(). Intended for callers that snapshot a monotonically-incremented counter and subtract two samples: unsigned modular arithmetic then yields the correct delta across a signed-long wraparound (a real hazard on 32-bit) that the clamp would otherwise turn into a huge spurious delta.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjubjM)}(h~Do NOT use for non-monotonic page-count reads where a transient negative reading from per-CPU delta skew must present as zero.h]h~Do NOT use for non-monotonic page-count reads where a transient negative reading from per-CPU delta skew must present as zero.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjubjM)}(hXXX: This helper (and its node/global peers) exists because some monotonically-incremented event counters are stored in enum node_stat_item.h]hXXX: This helper (and its node/global peers) exists because some monotonically-incremented event counters are stored in enum node_stat_item.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM!hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hmod_memcg_state (C function)c.mod_memcg_statehNtauh1hhjKhhhNhNubh)}(hhh](h)}(hRvoid mod_memcg_state (struct mem_cgroup *memcg, enum memcg_stat_item idx, int val)h]h)}(hQvoid mod_memcg_state(struct mem_cgroup *memcg, enum memcg_stat_item idx, int val)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh)}(hmod_memcg_stateh]j)}(hmod_memcg_stateh]hmod_memcg_state}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMubj8)}(h=(struct mem_cgroup *memcg, enum memcg_stat_item idx, int val)h](j>)}(hstruct mem_cgroup *memcgh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(h mem_cgrouph]h mem_cgroup}(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj7modnameN classnameNjj)}j]j)}jjsbc.mod_memcg_stateasbuh1hhjubj)}(h h]h }(hjUhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjchhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hmemcgh]hmemcg}(hjphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(henum memcg_stat_item idxh](j)}(hj#!h]henum}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hmemcg_stat_itemh]hmemcg_stat_item}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jQc.mod_memcg_stateasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hidxh]hidx}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hint valh](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hvalh]hval}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]jM)}(hupdate cgroup memory statisticsh]hupdate cgroup memory statistics}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj/hhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjJjHjJjIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``struct mem_cgroup *memcg`` the memory cgroup ``enum memcg_stat_item idx`` the stat item - can be enum memcg_stat_item or enum node_stat_item ``int val`` delta to add to the counter, can be negativeh](jM)}(h**Parameters**h]j)}(hjTh]h Parameters}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjRubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjNubj)}(hhh](j)}(h/``struct mem_cgroup *memcg`` the memory cgroup h](j)}(h``struct mem_cgroup *memcg``h]jS)}(hjsh]hstruct mem_cgroup *memcg}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjqubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjmubj)}(hhh]jM)}(hthe memory cgrouph]hthe memory cgroup}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjmubeh}(h]h ]h"]h$]h&]uh1jhjhMhjjubj)}(h```enum memcg_stat_item idx`` the stat item - can be enum memcg_stat_item or enum node_stat_item h](j)}(h``enum memcg_stat_item idx``h]jS)}(hjh]henum memcg_stat_item idx}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjubj)}(hhh]jM)}(hBthe stat item - can be enum memcg_stat_item or enum node_stat_itemh]hBthe stat item - can be enum memcg_stat_item or enum node_stat_itemz}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjjubj)}(h8``int val`` delta to add to the counter, can be negativeh](j)}(h ``int val``h]jS)}(hjh]hint val}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjubj)}(hhh]jM)}(h,delta to add to the counter, can be negativeh]h,delta to add to the counter, can be negative}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjjubeh}(h]h ]h"]h$]h&]uh1jhjNubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hmod_lruvec_state (C function)c.mod_lruvec_statehNtauh1hhjKhhhNhNubh)}(hhh](h)}(hOvoid mod_lruvec_state (struct lruvec *lruvec, enum node_stat_item idx, int val)h]h)}(hNvoid mod_lruvec_state(struct lruvec *lruvec, enum node_stat_item idx, int val)h](j)}(hvoidh]hvoid}(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;hhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM ubj)}(h h]h }(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;hhhjMhM ubh)}(hmod_lruvec_stateh]j)}(hmod_lruvec_stateh]hmod_lruvec_state}(hj`hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj;hhhjMhM ubj8)}(h9(struct lruvec *lruvec, enum node_stat_item idx, int val)h](j>)}(hstruct lruvec *lruvech](j)}(hjJ,h]hstruct}(hj|hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjxubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjxubh)}(hhh]j)}(hlruvech]hlruvec}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjbsbc.mod_lruvec_stateasbuh1hhjxubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjxubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjxubj)}(hlruvech]hlruvec}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjxubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjtubj>)}(henum node_stat_item idxh](j)}(hj#!h]henum}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hnode_stat_itemh]hnode_stat_item}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.mod_lruvec_stateasbuh1hhjubj)}(h h]h }(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hidxh]hidx}(hj8hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjtubj>)}(hint valh](j)}(hinth]hint}(hjQhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjMubj)}(h h]h }(hj_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjMubj)}(hvalh]hval}(hjmhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjMubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjtubeh}(h]h ]h"]h$]h&]jjuh1j7hj;hhhjMhM ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj7hhhjMhM ubah}(h]j2ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjMhM hj4hhubj4)}(hhh]jM)}(hupdate lruvec memory statisticsh]hupdate lruvec memory statistics}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM hjhhubah}(h]h ]h"]h$]h&]uh1j3hj4hhhjMhM ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hXt**Parameters** ``struct lruvec *lruvec`` the lruvec ``enum node_stat_item idx`` the stat item ``int val`` delta to add to the counter, can be negative **Description** The lruvec is the intersection of the NUMA node and a cgroup. This function updates the all three counters that are affected by a change of state at this level: per-node, per-cgroup, per-lruvec.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjubj)}(hhh](j)}(h%``struct lruvec *lruvec`` the lruvec h](j)}(h``struct lruvec *lruvec``h]jS)}(hjh]hstruct lruvec *lruvec}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM hjubj)}(hhh]jM)}(h the lruvech]h the lruvec}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hjubj)}(h*``enum node_stat_item idx`` the stat item h](j)}(h``enum node_stat_item idx``h]jS)}(hjh]henum node_stat_item idx}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj ubj)}(hhh]jM)}(h the stat itemh]h the stat item}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj&hMhj'ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj&hMhjubj)}(h9``int val`` delta to add to the counter, can be negative h](j)}(h ``int val``h]jS)}(hjJh]hint val}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjHubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjDubj)}(hhh]jM)}(h,delta to add to the counter, can be negativeh]h,delta to add to the counter, can be negative}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj_hMhj`ubah}(h]h ]h"]h$]h&]uh1jhjDubeh}(h]h ]h"]h$]h&]uh1jhj_hMhjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjubjM)}(hThe lruvec is the intersection of the NUMA node and a cgroup. This function updates the all three counters that are affected by a change of state at this level: per-node, per-cgroup, per-lruvec.h]hThe lruvec is the intersection of the NUMA node and a cgroup. This function updates the all three counters that are affected by a change of state at this level: per-node, per-cgroup, per-lruvec.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hcount_memcg_events (C function)c.count_memcg_eventshNtauh1hhjKhhhNhNubh)}(hhh](h)}(h_void count_memcg_events (struct mem_cgroup *memcg, enum vm_event_item idx, unsigned long count)h]h)}(h^void count_memcg_events(struct mem_cgroup *memcg, enum vm_event_item idx, unsigned long count)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMOubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMOubh)}(hcount_memcg_eventsh]j)}(hcount_memcg_eventsh]hcount_memcg_events}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMOubj8)}(hG(struct mem_cgroup *memcg, enum vm_event_item idx, unsigned long count)h](j>)}(hstruct mem_cgroup *memcgh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(h mem_cgrouph]h mem_cgroup}(hj%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj'modnameN classnameNjj)}j]j)}jjsbc.count_memcg_eventsasbuh1hhjubj)}(h h]h }(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjShhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hmemcgh]hmemcg}(hj`hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(henum vm_event_item idxh](j)}(hj#!h]henum}(hjyhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjuubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjuubh)}(hhh]j)}(h vm_event_itemh]h vm_event_item}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jAc.count_memcg_eventsasbuh1hhjuubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjuubj)}(hidxh]hidx}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjuubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hunsigned long counth](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hcounth]hcount}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMOubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMOubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMOhjhhubj4)}(hhh]jM)}(haccount VM events in a cgrouph]haccount VM events in a cgroup}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMOhj;hhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMOubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjVjHjVjIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``struct mem_cgroup *memcg`` the memory cgroup ``enum vm_event_item idx`` the event item ``unsigned long count`` the number of events that occurredh](jM)}(h**Parameters**h]j)}(hj`h]h Parameters}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj^ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMShjZubj)}(hhh](j)}(h/``struct mem_cgroup *memcg`` the memory cgroup h](j)}(h``struct mem_cgroup *memcg``h]jS)}(hjh]hstruct mem_cgroup *memcg}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj}ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMPhjyubj)}(hhh]jM)}(hthe memory cgrouph]hthe memory cgroup}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMPhjubah}(h]h ]h"]h$]h&]uh1jhjyubeh}(h]h ]h"]h$]h&]uh1jhjhMPhjvubj)}(h*``enum vm_event_item idx`` the event item h](j)}(h``enum vm_event_item idx``h]jS)}(hjh]henum vm_event_item idx}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMQhjubj)}(hhh]jM)}(hthe event itemh]hthe event item}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMQhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMQhjvubj)}(h:``unsigned long count`` the number of events that occurredh](j)}(h``unsigned long count``h]jS)}(hjh]hunsigned long count}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMShjubj)}(hhh]jM)}(h"the number of events that occurredh]h"the number of events that occurred}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMRhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMShjvubeh}(h]h ]h"]h$]h&]uh1jhjZubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h#get_mem_cgroup_from_mm (C function)c.get_mem_cgroup_from_mmhNtauh1hhjKhhhNhNubh)}(hhh](h)}(hAstruct mem_cgroup * get_mem_cgroup_from_mm (struct mm_struct *mm)h]h)}(h?struct mem_cgroup *get_mem_cgroup_from_mm(struct mm_struct *mm)h](j)}(hjJ,h]hstruct}(hjKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGhhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMubj)}(h h]h }(hjYhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGhhhjXhMubh)}(hhh]j)}(h mem_cgrouph]h mem_cgroup}(hjjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjlmodnameN classnameNjj)}j]j)}jget_mem_cgroup_from_mmsbc.get_mem_cgroup_from_mmasbuh1hhjGhhhjXhMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGhhhjXhMubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjGhhhjXhMubh)}(hget_mem_cgroup_from_mmh]j)}(hjh]hget_mem_cgroup_from_mm}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjGhhhjXhMubj8)}(h(struct mm_struct *mm)h]j>)}(hstruct mm_struct *mmh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(h mm_structh]h mm_struct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.get_mem_cgroup_from_mmasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hmmh]hmm}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjGhhhjXhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjChhhjXhMubah}(h]j>ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjXhMhj@hhubj4)}(hhh]jM)}(h.Obtain a reference on given mm_struct's memcg.h]h0Obtain a reference on given mm_struct’s memcg.}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjChhubah}(h]h ]h"]h$]h&]uh1j3hj@hhhjXhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj^jHj^jIjJjKuh1hhhhjKhNhNubj)}(hXc**Parameters** ``struct mm_struct *mm`` mm from which memcg should be extracted. It can be NULL. **Description** Obtain a reference on mm->memcg and returns it if successful. If mm is NULL, then the memcg is chosen as follows: 1) The active memcg, if set. 2) current->mm->memcg, if available 3) root memcg If mem_cgroup is disabled, NULL is returned.h](jM)}(h**Parameters**h]j)}(hjhh]h Parameters}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjfubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjbubj)}(hhh]j)}(hR``struct mm_struct *mm`` mm from which memcg should be extracted. It can be NULL. h](j)}(h``struct mm_struct *mm``h]jS)}(hjh]hstruct mm_struct *mm}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjubj)}(hhh]jM)}(h8mm from which memcg should be extracted. It can be NULL.h]h8mm from which memcg should be extracted. It can be NULL.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhj~ubah}(h]h ]h"]h$]h&]uh1jhjbubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjbubjM)}(hObtain a reference on mm->memcg and returns it if successful. If mm is NULL, then the memcg is chosen as follows: 1) The active memcg, if set. 2) current->mm->memcg, if available 3) root memcg If mem_cgroup is disabled, NULL is returned.h]hObtain a reference on mm->memcg and returns it if successful. If mm is NULL, then the memcg is chosen as follows: 1) The active memcg, if set. 2) current->mm->memcg, if available 3) root memcg If mem_cgroup is disabled, NULL is returned.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjbubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h(get_mem_cgroup_from_current (C function)c.get_mem_cgroup_from_currenthNtauh1hhjKhhhNhNubh)}(hhh](h)}(h6struct mem_cgroup * get_mem_cgroup_from_current (void)h]h)}(h4struct mem_cgroup *get_mem_cgroup_from_current(void)h](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh)}(hhh]j)}(h mem_cgrouph]h mem_cgroup}(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj(modnameN classnameNjj)}j]j)}jget_mem_cgroup_from_currentsbc.get_mem_cgroup_from_currentasbuh1hhjhhhjhMubj)}(h h]h }(hjGhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubjr)}(hjuh]h*}(hjUhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjhhhjhMubh)}(hget_mem_cgroup_from_currenth]j)}(hjDh]hget_mem_cgroup_from_current}(hjfhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjbubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMubj8)}(h(void)h]j>)}(hvoidh]j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj}ubah}(h]h ]h"]h$]h&]noemphjjuh1j=hjyubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]jM)}(h+Obtain a reference on current task's memcg.h]h-Obtain a reference on current task’s memcg.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(h'**Parameters** ``void`` no argumentsh](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjubj)}(hhh]j)}(h``void`` no argumentsh](j)}(h``void``h]jS)}(hjh]hvoid}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjubj)}(hhh]jM)}(h no argumentsh]h no arguments}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h&get_mem_cgroup_from_folio (C function)c.get_mem_cgroup_from_foliohNtauh1hhjKhhhNhNubh)}(hhh](h)}(hIstruct mem_cgroup * get_mem_cgroup_from_folio (const struct folio *folio)h]h)}(hGstruct mem_cgroup *get_mem_cgroup_from_folio(const struct folio *folio)h](j)}(hjJ,h]hstruct}(hjFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBhhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMubj)}(h h]h }(hjThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBhhhjShMubh)}(hhh]j)}(h mem_cgrouph]h mem_cgroup}(hjehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjbubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjgmodnameN classnameNjj)}j]j)}jget_mem_cgroup_from_foliosbc.get_mem_cgroup_from_folioasbuh1hhjBhhhjShMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBhhhjShMubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjBhhhjShMubh)}(hget_mem_cgroup_from_folioh]j)}(hjh]hget_mem_cgroup_from_folio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjBhhhjShMubj8)}(h(const struct folio *folio)h]j>)}(hconst struct folio *folioh](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.get_mem_cgroup_from_folioasbuh1hhjubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hj% hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hfolioh]hfolio}(hj2 hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjBhhhjShMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj>hhhjShMubah}(h]j9ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjShMhj;hhubj4)}(hhh]jM)}(h,Obtain a reference on a given folio's memcg.h]h.Obtain a reference on a given folio’s memcg.}(hj\ hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjY hhubah}(h]h ]h"]h$]h&]uh1j3hj;hhhjShMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjt jHjt jIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``const struct folio *folio`` folio from which memcg should be extracted. **Description** See folio_memcg() for folio->objcg/memcg binding rules.h](jM)}(h**Parameters**h]j)}(hj~ h]h Parameters}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj| ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjx ubj)}(hhh]j)}(hJ``const struct folio *folio`` folio from which memcg should be extracted. h](j)}(h``const struct folio *folio``h]jS)}(hj h]hconst struct folio *folio}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj ubj)}(hhh]jM)}(h+folio from which memcg should be extracted.h]h+folio from which memcg should be extracted.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj hMhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hMhj ubah}(h]h ]h"]h$]h&]uh1jhjx ubjM)}(h**Description**h]j)}(hj h]h Description}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjx ubjM)}(h7See folio_memcg() for folio->objcg/memcg binding rules.h]h7See folio_memcg() for folio->objcg/memcg binding rules.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjx ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hmem_cgroup_iter (C function)c.mem_cgroup_iterhNtauh1hhjKhhhNhNubh)}(hhh](h)}(hstruct mem_cgroup * mem_cgroup_iter (struct mem_cgroup *root, struct mem_cgroup *prev, struct mem_cgroup_reclaim_cookie *reclaim)h]h)}(hstruct mem_cgroup *mem_cgroup_iter(struct mem_cgroup *root, struct mem_cgroup *prev, struct mem_cgroup_reclaim_cookie *reclaim)h](j)}(hjJ,h]hstruct}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMubj)}(h h]h }(hj+ hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhj* hMubh)}(hhh]j)}(h mem_cgrouph]h mem_cgroup}(hj< hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9 ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj> modnameN classnameNjj)}j]j)}jmem_cgroup_itersbc.mem_cgroup_iterasbuh1hhj hhhj* hMubj)}(h h]h }(hj] hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhj* hMubjr)}(hjuh]h*}(hjk hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj hhhj* hMubh)}(hmem_cgroup_iterh]j)}(hjZ h]hmem_cgroup_iter}(hj| hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjx ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj hhhj* hMubj8)}(h](struct mem_cgroup *root, struct mem_cgroup *prev, struct mem_cgroup_reclaim_cookie *reclaim)h](j>)}(hstruct mem_cgroup *rooth](j)}(hjJ,h]hstruct}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubh)}(hhh]j)}(h mem_cgrouph]h mem_cgroup}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj modnameN classnameNjj)}j]jX c.mem_cgroup_iterasbuh1hhj ubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubjr)}(hjuh]h*}(hj hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj ubj)}(hrooth]hroot}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj ubj>)}(hstruct mem_cgroup *prevh](j)}(hjJ,h]hstruct}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubh)}(hhh]j)}(h mem_cgrouph]h mem_cgroup}(hj% hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj" ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj' modnameN classnameNjj)}j]jX c.mem_cgroup_iterasbuh1hhj ubj)}(h h]h }(hjC hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubjr)}(hjuh]h*}(hjQ hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj ubj)}(hprevh]hprev}(hj^ hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj ubj>)}(h)struct mem_cgroup_reclaim_cookie *reclaimh](j)}(hjJ,h]hstruct}(hjw hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjs ubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjs ubh)}(hhh]j)}(hmem_cgroup_reclaim_cookieh]hmem_cgroup_reclaim_cookie}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj modnameN classnameNjj)}j]jX c.mem_cgroup_iterasbuh1hhjs ubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjs ubjr)}(hjuh]h*}(hj hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjs ubj)}(hreclaimh]hreclaim}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjs ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj ubeh}(h]h ]h"]h$]h&]jjuh1j7hj hhhj* hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj hhhj* hMubah}(h]j ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj* hMhj hhubj4)}(hhh]jM)}(h$iterate over memory cgroup hierarchyh]h$iterate over memory cgroup hierarchy}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj hhubah}(h]h ]h"]h$]h&]uh1j3hj hhhj* hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj jHj jIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct mem_cgroup *root`` hierarchy root ``struct mem_cgroup *prev`` previously returned memcg, NULL on first invocation ``struct mem_cgroup_reclaim_cookie *reclaim`` cookie for shared reclaim walks, NULL for full walks **Description** Returns references to children of the hierarchy below **root**, or **root** itself, or ``NULL`` after a full round-trip. Caller must pass the return value in **prev** on subsequent invocations for reference counting, or use mem_cgroup_iter_break() to cancel a hierarchy walk before the round-trip is complete. Reclaimers can specify a node in **reclaim** to divide up the memcgs in the hierarchy among all concurrent reclaimers operating on the same node.h](jM)}(h**Parameters**h]j)}(hj h]h Parameters}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj ubj)}(hhh](j)}(h+``struct mem_cgroup *root`` hierarchy root h](j)}(h``struct mem_cgroup *root``h]jS)}(hj9 h]hstruct mem_cgroup *root}(hj; hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj7 ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj3 ubj)}(hhh]jM)}(hhierarchy rooth]hhierarchy root}(hjR hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjN hMhjO ubah}(h]h ]h"]h$]h&]uh1jhj3 ubeh}(h]h ]h"]h$]h&]uh1jhjN hMhj0 ubj)}(hP``struct mem_cgroup *prev`` previously returned memcg, NULL on first invocation h](j)}(h``struct mem_cgroup *prev``h]jS)}(hjr h]hstruct mem_cgroup *prev}(hjt hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjp ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjl ubj)}(hhh]jM)}(h3previously returned memcg, NULL on first invocationh]h3previously returned memcg, NULL on first invocation}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj hMhj ubah}(h]h ]h"]h$]h&]uh1jhjl ubeh}(h]h ]h"]h$]h&]uh1jhj hMhj0 ubj)}(hc``struct mem_cgroup_reclaim_cookie *reclaim`` cookie for shared reclaim walks, NULL for full walks h](j)}(h-``struct mem_cgroup_reclaim_cookie *reclaim``h]jS)}(hj h]h)struct mem_cgroup_reclaim_cookie *reclaim}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj ubj)}(hhh]jM)}(h4cookie for shared reclaim walks, NULL for full walksh]h4cookie for shared reclaim walks, NULL for full walks}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj hMhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hMhj0 ubeh}(h]h ]h"]h$]h&]uh1jhj ubjM)}(h**Description**h]j)}(hj h]h Description}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj ubjM)}(hxReturns references to children of the hierarchy below **root**, or **root** itself, or ``NULL`` after a full round-trip.h](h6Returns references to children of the hierarchy below }(hj hhhNhNubj)}(h**root**h]hroot}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubh, or }(hj hhhNhNubj)}(h**root**h]hroot}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubh itself, or }(hj hhhNhNubjS)}(h``NULL``h]hNULL}(hj( hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj ubh after a full round-trip.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj ubjM)}(hCaller must pass the return value in **prev** on subsequent invocations for reference counting, or use mem_cgroup_iter_break() to cancel a hierarchy walk before the round-trip is complete.h](h%Caller must pass the return value in }(hjA hhhNhNubj)}(h**prev**h]hprev}(hjI hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjA ubh on subsequent invocations for reference counting, or use mem_cgroup_iter_break() to cancel a hierarchy walk before the round-trip is complete.}(hjA hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj ubjM)}(hReclaimers can specify a node in **reclaim** to divide up the memcgs in the hierarchy among all concurrent reclaimers operating on the same node.h](h!Reclaimers can specify a node in }(hjb hhhNhNubj)}(h **reclaim**h]hreclaim}(hjj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjb ubhe to divide up the memcgs in the hierarchy among all concurrent reclaimers operating on the same node.}(hjb hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h"mem_cgroup_iter_break (C function)c.mem_cgroup_iter_breakhNtauh1hhjKhhhNhNubh)}(hhh](h)}(hMvoid mem_cgroup_iter_break (struct mem_cgroup *root, struct mem_cgroup *prev)h]h)}(hLvoid mem_cgroup_iter_break(struct mem_cgroup *root, struct mem_cgroup *prev)h](j)}(hvoidh]hvoid}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMeubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhj hMeubh)}(hmem_cgroup_iter_breakh]j)}(hmem_cgroup_iter_breakh]hmem_cgroup_iter_break}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj hhhj hMeubj8)}(h2(struct mem_cgroup *root, struct mem_cgroup *prev)h](j>)}(hstruct mem_cgroup *rooth](j)}(hjJ,h]hstruct}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubh)}(hhh]j)}(h mem_cgrouph]h mem_cgroup}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jj sbc.mem_cgroup_iter_breakasbuh1hhj ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubjr)}(hjuh]h*}(hj,hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj ubj)}(hrooth]hroot}(hj9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj ubj>)}(hstruct mem_cgroup *prevh](j)}(hjJ,h]hstruct}(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubj)}(h h]h }(hj_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubh)}(hhh]j)}(h mem_cgrouph]h mem_cgroup}(hjphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjrmodnameN classnameNjj)}j]jc.mem_cgroup_iter_breakasbuh1hhjNubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjNubj)}(hprevh]hprev}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj ubeh}(h]h ]h"]h$]h&]jjuh1j7hj hhhj hMeubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj hhhj hMeubah}(h]j ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj hMehj hhubj4)}(hhh]jM)}(h"abort a hierarchy walk prematurelyh]h"abort a hierarchy walk prematurely}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMehjhhubah}(h]h ]h"]h$]h&]uh1j3hj hhhj hMeubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``struct mem_cgroup *root`` hierarchy root ``struct mem_cgroup *prev`` last visited hierarchy member as returned by mem_cgroup_iter()h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMihjubj)}(hhh](j)}(h+``struct mem_cgroup *root`` hierarchy root h](j)}(h``struct mem_cgroup *root``h]jS)}(hjh]hstruct mem_cgroup *root}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMfhjubj)}(hhh]jM)}(hhierarchy rooth]hhierarchy root}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj)hMfhj*ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj)hMfhj ubj)}(hZ``struct mem_cgroup *prev`` last visited hierarchy member as returned by mem_cgroup_iter()h](j)}(h``struct mem_cgroup *prev``h]jS)}(hjMh]hstruct mem_cgroup *prev}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjKubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhhjGubj)}(hhh]jM)}(h>last visited hierarchy member as returned by mem_cgroup_iter()h]h>last visited hierarchy member as returned by mem_cgroup_iter()}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMghjcubah}(h]h ]h"]h$]h&]uh1jhjGubeh}(h]h ]h"]h$]h&]uh1jhjbhMhhj ubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h"mem_cgroup_scan_tasks (C function)c.mem_cgroup_scan_taskshNtauh1hhjKhhhNhNubh)}(hhh](h)}(hivoid mem_cgroup_scan_tasks (struct mem_cgroup *memcg, int (*fn)(struct task_struct *, void *), void *arg)h]h)}(hfvoid mem_cgroup_scan_tasks(struct mem_cgroup *memcg, int (*fn)(struct task_struct*, void*), void *arg)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh)}(hmem_cgroup_scan_tasksh]j)}(hmem_cgroup_scan_tasksh]hmem_cgroup_scan_tasks}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMubj8)}(hL(struct mem_cgroup *memcg, int (*fn)(struct task_struct*, void*), void *arg)h](j>)}(hstruct mem_cgroup *memcgh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(h mem_cgrouph]h mem_cgroup}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsbc.mem_cgroup_scan_tasksasbuh1hhjubj)}(h h]h }(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hj0hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hmemcgh]hmemcg}(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(h%int (*fn)(struct task_struct*, void*)h](j)}(hinth]hint}(hjVhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRubj)}(h h]h }(hjdhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRubjr)}(hj?h]h(}(hjrhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjRubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjRubj)}(hfnh]hfn}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRubjr)}(hj?h]h)}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjRubjr)}(hj?h]h(}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjRubj)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRubh)}(hhh]j)}(h task_structh]h task_struct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.mem_cgroup_scan_tasksasbuh1hhjRubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjRubjr)}(h,h]h,}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjRubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRubj)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRubjr)}(hjuh]h*}(hj'hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjRubjr)}(hj?h]h)}(hj4hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjRubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(h void *argh](j)}(hvoidh]hvoid}(hjLhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHubj)}(h h]h }(hjZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHubjr)}(hjuh]h*}(hjhhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjHubj)}(hargh]harg}(hjuhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]jM)}(h/iterate over tasks of a memory cgroup hierarchyh]h/iterate over tasks of a memory cgroup hierarchy}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct mem_cgroup *memcg`` hierarchy root ``int (*fn)(struct task_struct *, void *)`` function to call for each task ``void *arg`` argument passed to **fn** **Description** This function iterates over tasks attached to **memcg** or to any of its descendants and calls **fn** for each task. If **fn** returns a non-zero value, the function breaks the iteration loop. Otherwise, it will iterate over all tasks and return 0. This function must not be called for the root memory cgroup.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjubj)}(hhh](j)}(h,``struct mem_cgroup *memcg`` hierarchy root h](j)}(h``struct mem_cgroup *memcg``h]jS)}(hjh]hstruct mem_cgroup *memcg}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjubj)}(hhh]jM)}(hhierarchy rooth]hhierarchy root}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(hK``int (*fn)(struct task_struct *, void *)`` function to call for each task h](j)}(h+``int (*fn)(struct task_struct *, void *)``h]jS)}(hjh]h'int (*fn)(struct task_struct *, void *)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjubj)}(hhh]jM)}(hfunction to call for each taskh]hfunction to call for each task}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj.hMhj/ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj.hMhjubj)}(h(``void *arg`` argument passed to **fn** h](j)}(h ``void *arg``h]jS)}(hjRh]h void *arg}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjPubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjLubj)}(hhh]jM)}(hargument passed to **fn**h](hargument passed to }(hjkhhhNhNubj)}(h**fn**h]hfn}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1jhjkubeh}(h]h ]h"]h$]h&]uh1jLhjghMhjhubah}(h]h ]h"]h$]h&]uh1jhjLubeh}(h]h ]h"]h$]h&]uh1jhjghMhjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjubjM)}(hThis function iterates over tasks attached to **memcg** or to any of its descendants and calls **fn** for each task. If **fn** returns a non-zero value, the function breaks the iteration loop. Otherwise, it will iterate over all tasks and return 0.h](h.This function iterates over tasks attached to }(hjhhhNhNubj)}(h **memcg**h]hmemcg}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh( or to any of its descendants and calls }(hjhhhNhNubj)}(h**fn**h]hfn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh for each task. If }(hjhhhNhNubj)}(h**fn**h]hfn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhz returns a non-zero value, the function breaks the iteration loop. Otherwise, it will iterate over all tasks and return 0.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjubjM)}(h)}(hconst struct folio *folioh](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j`c.folio_lruvec_lockasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hj!hhhj2hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhj2hMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj2hMhjhhubj4)}(hhh]jM)}(hLock the lruvec for a folio.h]hLock the lruvec for a folio.}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj8hhubah}(h]h ]h"]h$]h&]uh1j3hjhhhj2hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjSjHjSjIjJjKuh1hhhhjKhNhNubj)}(hX7**Parameters** ``const struct folio *folio`` Pointer to the folio. **Description** These functions are safe to use under any of the following conditions: - folio locked - folio_test_lru false - folio frozen (refcount of 0) **Return** The lruvec this folio is on with its lock held and rcu read lock held.h](jM)}(h**Parameters**h]j)}(hj]h]h Parameters}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj[ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjWubj)}(hhh]j)}(h4``const struct folio *folio`` Pointer to the folio. h](j)}(h``const struct folio *folio``h]jS)}(hj|h]hconst struct folio *folio}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjzubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjvubj)}(hhh]jM)}(hPointer to the folio.h]hPointer to the folio.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjvubeh}(h]h ]h"]h$]h&]uh1jhjhMhjsubah}(h]h ]h"]h$]h&]uh1jhjWubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjWubjM)}(hThese functions are safe to use under any of the following conditions: - folio locked - folio_test_lru false - folio frozen (refcount of 0)h]hThese functions are safe to use under any of the following conditions: - folio locked - folio_test_lru false - folio frozen (refcount of 0)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjWubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjWubjM)}(hFThe lruvec this folio is on with its lock held and rcu read lock held.h]hFThe lruvec this folio is on with its lock held and rcu read lock held.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjWubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h"folio_lruvec_lock_irq (C function)c.folio_lruvec_lock_irqhNtauh1hhjKhhhNhNubh)}(hhh](h)}(hAstruct lruvec * folio_lruvec_lock_irq (const struct folio *folio)h]h)}(h?struct lruvec *folio_lruvec_lock_irq(const struct folio *folio)h](j)}(hjJ,h]hstruct}(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMubj)}(h h]h }(hj1hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhj0hMubh)}(hhh]j)}(hlruvech]hlruvec}(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjDmodnameN classnameNjj)}j]j)}jfolio_lruvec_lock_irqsbc.folio_lruvec_lock_irqasbuh1hhjhhhj0hMubj)}(h h]h }(hjchhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhj0hMubjr)}(hjuh]h*}(hjqhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjhhhj0hMubh)}(hfolio_lruvec_lock_irqh]j)}(hj`h]hfolio_lruvec_lock_irq}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhj0hMubj8)}(h(const struct folio *folio)h]j>)}(hconst struct folio *folioh](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j^c.folio_lruvec_lock_irqasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhj0hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhj0hMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj0hMhjhhubj4)}(hhh]jM)}(hLock the lruvec for a folio.h]hLock the lruvec for a folio.}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj6hhubah}(h]h ]h"]h$]h&]uh1j3hjhhhj0hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjQjHjQjIjJjKuh1hhhhjKhNhNubj)}(hXO**Parameters** ``const struct folio *folio`` Pointer to the folio. **Description** These functions are safe to use under any of the following conditions: - folio locked - folio_test_lru false - folio frozen (refcount of 0) **Return** The lruvec this folio is on with its lock held and interrupts disabled and rcu read lock held.h](jM)}(h**Parameters**h]j)}(hj[h]h Parameters}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjYubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjUubj)}(hhh]j)}(h4``const struct folio *folio`` Pointer to the folio. h](j)}(h``const struct folio *folio``h]jS)}(hjzh]hconst struct folio *folio}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjxubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjtubj)}(hhh]jM)}(hPointer to the folio.h]hPointer to the folio.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjtubeh}(h]h ]h"]h$]h&]uh1jhjhMhjqubah}(h]h ]h"]h$]h&]uh1jhjUubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjUubjM)}(hThese functions are safe to use under any of the following conditions: - folio locked - folio_test_lru false - folio frozen (refcount of 0)h]hThese functions are safe to use under any of the following conditions: - folio locked - folio_test_lru false - folio frozen (refcount of 0)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjUubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjUubjM)}(h^The lruvec this folio is on with its lock held and interrupts disabled and rcu read lock held.h]h^The lruvec this folio is on with its lock held and interrupts disabled and rcu read lock held.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjUubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h&folio_lruvec_lock_irqsave (C function)c.folio_lruvec_lock_irqsavehNtauh1hhjKhhhNhNubh)}(hhh](h)}(h[struct lruvec * folio_lruvec_lock_irqsave (const struct folio *folio, unsigned long *flags)h]h)}(hYstruct lruvec *folio_lruvec_lock_irqsave(const struct folio *folio, unsigned long *flags)h](j)}(hjJ,h]hstruct}(hj!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMubj)}(h h]h }(hj/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhj.hMubh)}(hhh]j)}(hlruvech]hlruvec}(hj@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjBmodnameN classnameNjj)}j]j)}jfolio_lruvec_lock_irqsavesbc.folio_lruvec_lock_irqsaveasbuh1hhjhhhj.hMubj)}(h h]h }(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhj.hMubjr)}(hjuh]h*}(hjohhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjhhhj.hMubh)}(hfolio_lruvec_lock_irqsaveh]j)}(hj^h]hfolio_lruvec_lock_irqsave}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhj.hMubj8)}(h1(const struct folio *folio, unsigned long *flags)h](j>)}(hconst struct folio *folioh](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j\c.folio_lruvec_lock_irqsaveasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hfolioh]hfolio}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hunsigned long *flagsh](j)}(hunsignedh]hunsigned}(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"ubj)}(h h]h }(hj4hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"ubj)}(hlongh]hlong}(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"ubj)}(h h]h }(hjPhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"ubjr)}(hjuh]h*}(hj^hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj"ubj)}(hflagsh]hflags}(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhj.hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhj.hMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj.hMhjhhubj4)}(hhh]jM)}(hLock the lruvec for a folio.h]hLock the lruvec for a folio.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhj.hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``const struct folio *folio`` Pointer to the folio. ``unsigned long *flags`` Pointer to irqsave flags. **Description** These functions are safe to use under any of the following conditions: - folio locked - folio_test_lru false - folio frozen (refcount of 0) **Return** The lruvec this folio is on with its lock held and interrupts disabled and rcu read lock held.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjubj)}(hhh](j)}(h4``const struct folio *folio`` Pointer to the folio. h](j)}(h``const struct folio *folio``h]jS)}(hjh]hconst struct folio *folio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjubj)}(hhh]jM)}(hPointer to the folio.h]hPointer to the folio.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h3``unsigned long *flags`` Pointer to irqsave flags. h](j)}(h``unsigned long *flags``h]jS)}(hjh]hunsigned long *flags}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj ubj)}(hhh]jM)}(hPointer to irqsave flags.h]hPointer to irqsave flags.}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj$hMhj%ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj$hMhjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjJh]h Description}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjHubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjubjM)}(hThese functions are safe to use under any of the following conditions: - folio locked - folio_test_lru false - folio frozen (refcount of 0)h]hThese functions are safe to use under any of the following conditions: - folio locked - folio_test_lru false - folio frozen (refcount of 0)}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjubjM)}(h **Return**h]j)}(hjqh]hReturn}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1jhjoubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjubjM)}(h^The lruvec this folio is on with its lock held and interrupts disabled and rcu read lock held.h]h^The lruvec this folio is on with its lock held and interrupts disabled and rcu read lock held.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h'mem_cgroup_update_lru_size (C function)c.mem_cgroup_update_lru_sizehNtauh1hhjKhhhNhNubh)}(hhh](h)}(hbvoid mem_cgroup_update_lru_size (struct lruvec *lruvec, enum lru_list lru, int zid, long nr_pages)h]h)}(havoid mem_cgroup_update_lru_size(struct lruvec *lruvec, enum lru_list lru, int zid, long nr_pages)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh)}(hmem_cgroup_update_lru_sizeh]j)}(hmem_cgroup_update_lru_sizeh]hmem_cgroup_update_lru_size}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMubj8)}(hB(struct lruvec *lruvec, enum lru_list lru, int zid, long nr_pages)h](j>)}(hstruct lruvec *lruvech](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hlruvech]hlruvec}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsbc.mem_cgroup_update_lru_sizeasbuh1hhjubj)}(h h]h }(hj1hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hj?hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hlruvech]hlruvec}(hjLhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(henum lru_list lruh](j)}(hj#!h]henum}(hjehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubj)}(h h]h }(hjrhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubh)}(hhh]j)}(hlru_listh]hlru_list}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j-c.mem_cgroup_update_lru_sizeasbuh1hhjaubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubj)}(hlruh]hlru}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hint zidh](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hzidh]hzid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(h long nr_pagesh](j)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hnr_pagesh]hnr_pages}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]jM)}(h*account for adding or removing an lru pageh]h*account for adding or removing an lru page}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj@hhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj[jHj[jIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct lruvec *lruvec`` mem_cgroup per zone lru vector ``enum lru_list lru`` index of lru list the page is sitting on ``int zid`` zone id of the accounted pages ``long nr_pages`` positive when adding or negative when removing **Description** This function must be called under lru_lock, just before a page is added to or just after a page is removed from an lru list.h](jM)}(h**Parameters**h]j)}(hjeh]h Parameters}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1jhjcubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj_ubj)}(hhh](j)}(h9``struct lruvec *lruvec`` mem_cgroup per zone lru vector h](j)}(h``struct lruvec *lruvec``h]jS)}(hjh]hstruct lruvec *lruvec}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj~ubj)}(hhh]jM)}(hmem_cgroup per zone lru vectorh]hmem_cgroup per zone lru vector}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhj~ubeh}(h]h ]h"]h$]h&]uh1jhjhMhj{ubj)}(h?``enum lru_list lru`` index of lru list the page is sitting on h](j)}(h``enum lru_list lru``h]jS)}(hjh]henum lru_list lru}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjubj)}(hhh]jM)}(h(index of lru list the page is sitting onh]h(index of lru list the page is sitting on}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhj{ubj)}(h+``int zid`` zone id of the accounted pages h](j)}(h ``int zid``h]jS)}(hjh]hint zid}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjubj)}(hhh]jM)}(hzone id of the accounted pagesh]hzone id of the accounted pages}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj hMhj ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj hMhj{ubj)}(hA``long nr_pages`` positive when adding or negative when removing h](j)}(h``long nr_pages``h]jS)}(hj/h]h long nr_pages}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj-ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj)ubj)}(hhh]jM)}(h.positive when adding or negative when removingh]h.positive when adding or negative when removing}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjDhMhjEubah}(h]h ]h"]h$]h&]uh1jhj)ubeh}(h]h ]h"]h$]h&]uh1jhjDhMhj{ubeh}(h]h ]h"]h$]h&]uh1jhj_ubjM)}(h**Description**h]j)}(hjjh]h Description}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjhubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj_ubjM)}(h}This function must be called under lru_lock, just before a page is added to or just after a page is removed from an lru list.h]h}This function must be called under lru_lock, just before a page is added to or just after a page is removed from an lru list.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj_ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hmem_cgroup_margin (C function)c.mem_cgroup_marginhNtauh1hhjKhhhNhNubh)}(hhh](h)}(h:unsigned long mem_cgroup_margin (struct mem_cgroup *memcg)h]h)}(h9unsigned long mem_cgroup_margin(struct mem_cgroup *memcg)h](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM(ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM(ubj)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM(ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM(ubh)}(hmem_cgroup_marginh]j)}(hmem_cgroup_marginh]hmem_cgroup_margin}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhM(ubj8)}(h(struct mem_cgroup *memcg)h]j>)}(hstruct mem_cgroup *memcgh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(h mem_cgrouph]h mem_cgroup}(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj(modnameN classnameNjj)}j]j)}jjsbc.mem_cgroup_marginasbuh1hhjubj)}(h h]h }(hjFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjThhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hmemcgh]hmemcg}(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhM(ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhM(ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhM(hjhhubj4)}(hhh]jM)}(h-calculate chargeable space of a memory cgrouph]h-calculate chargeable space of a memory cgroup}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM(hjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhM(ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``struct mem_cgroup *memcg`` the memory cgroup **Description** Returns the maximum amount of memory **mem** can be charged with, in pages.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM,hjubj)}(hhh]j)}(h/``struct mem_cgroup *memcg`` the memory cgroup h](j)}(h``struct mem_cgroup *memcg``h]jS)}(hjh]hstruct mem_cgroup *memcg}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM)hjubj)}(hhh]jM)}(hthe memory cgrouph]hthe memory cgroup}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM)hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM)hjubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM+hjubjM)}(hKReturns the maximum amount of memory **mem** can be charged with, in pages.h](h%Returns the maximum amount of memory }(hjhhhNhNubj)}(h**mem**h]hmem}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh can be charged with, in pages.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM*hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h)mem_cgroup_print_oom_context (C function)c.mem_cgroup_print_oom_contexthNtauh1hhjKhhhNhNubh)}(hhh](h)}(hYvoid mem_cgroup_print_oom_context (const struct mem_cgroup *memcg, struct task_struct *p)h]h)}(hXvoid mem_cgroup_print_oom_context(const struct mem_cgroup *memcg, struct task_struct *p)h](j)}(hvoidh]hvoid}(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZhhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM"ubj)}(h h]h }(hjmhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZhhhjlhM"ubh)}(hmem_cgroup_print_oom_contexth]j)}(hmem_cgroup_print_oom_contexth]hmem_cgroup_print_oom_context}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjZhhhjlhM"ubj8)}(h7(const struct mem_cgroup *memcg, struct task_struct *p)h](j>)}(hconst struct mem_cgroup *memcgh](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(h mem_cgrouph]h mem_cgroup}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsbc.mem_cgroup_print_oom_contextasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hmemcgh]hmemcg}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hstruct task_struct *ph](j)}(hjJ,h]hstruct}(hj(hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$ubj)}(h h]h }(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$ubh)}(hhh]j)}(h task_structh]h task_struct}(hjFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjHmodnameN classnameNjj)}j]jc.mem_cgroup_print_oom_contextasbuh1hhj$ubj)}(h h]h }(hjdhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$ubjr)}(hjuh]h*}(hjrhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj$ubj)}(hj~h]hp}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjZhhhjlhM"ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjVhhhjlhM"ubah}(h]jQah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjlhM"hjShhubj4)}(hhh]jM)}(h4Print OOM information relevant to memory controller.h]h4Print OOM information relevant to memory controller.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM"hjhhubah}(h]h ]h"]h$]h&]uh1j3hjShhhjlhM"ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``const struct mem_cgroup *memcg`` The memory cgroup that went over limit ``struct task_struct *p`` Task that is going to be killed **NOTE** **memcg** and **p**'s mem_cgroup can be different when hierarchy is enabledh](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM&hjubj)}(hhh](j)}(hJ``const struct mem_cgroup *memcg`` The memory cgroup that went over limit h](j)}(h"``const struct mem_cgroup *memcg``h]jS)}(hjh]hconst struct mem_cgroup *memcg}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM$hjubj)}(hhh]jM)}(h&The memory cgroup that went over limith]h&The memory cgroup that went over limit}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM$hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM$hjubj)}(h:``struct task_struct *p`` Task that is going to be killed h](j)}(h``struct task_struct *p``h]jS)}(hj" h]hstruct task_struct *p}(hj$ hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM%hj ubj)}(hhh]jM)}(hTask that is going to be killedh]hTask that is going to be killed}(hj; hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj7 hM%hj8 ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj7 hM%hjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**NOTE**h]j)}(hj] h]hNOTE}(hj_ hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj[ ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM'hjubjM)}(hK**memcg** and **p**'s mem_cgroup can be different when hierarchy is enabledh](j)}(h **memcg**h]hmemcg}(hjw hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjs ubh and }(hjs hhhNhNubj)}(h**p**h]hp}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjs ubh:’s mem_cgroup can be different when hierarchy is enabled}(hjs hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM'hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h)mem_cgroup_print_oom_meminfo (C function)c.mem_cgroup_print_oom_meminfohNtauh1hhjKhhhNhNubh)}(hhh](h)}(h)}(hstruct mem_cgroup *memcgh](j)}(hjJ,h]hstruct}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h h]h }(hj !hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubh)}(hhh]j)}(h mem_cgrouph]h mem_cgroup}(hj!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj!modnameN classnameNjj)}j]j)}jj sbc.mem_cgroup_print_oom_meminfoasbuh1hhj ubj)}(h h]h }(hj=!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubjr)}(hjuh]h*}(hjK!hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj ubj)}(hmemcgh]hmemcg}(hjX!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj ubah}(h]h ]h"]h$]h&]jjuh1j7hj hhhj hM<ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj hhhj hM<ubah}(h]j ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj hM<hj hhubj4)}(hhh]jM)}(h;Print OOM memory information relevant to memory controller.h]h;Print OOM memory information relevant to memory controller.}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM<hj!hhubah}(h]h ]h"]h$]h&]uh1j3hj hhhj hM<ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj!jHj!jIjJjKuh1hhhhjKhNhNubj)}(hU**Parameters** ``struct mem_cgroup *memcg`` The memory cgroup that went over limith](jM)}(h**Parameters**h]j)}(hj!h]h Parameters}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj!ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM@hj!ubj)}(hhh]j)}(hC``struct mem_cgroup *memcg`` The memory cgroup that went over limith](j)}(h``struct mem_cgroup *memcg``h]jS)}(hj!h]hstruct mem_cgroup *memcg}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj!ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMBhj!ubj)}(hhh]jM)}(h&The memory cgroup that went over limith]h&The memory cgroup that went over limit}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM>hj!ubah}(h]h ]h"]h$]h&]uh1jhj!ubeh}(h]h ]h"]h$]h&]uh1jhj!hMBhj!ubah}(h]h ]h"]h$]h&]uh1jhj!ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h%mem_cgroup_get_oom_group (C function)c.mem_cgroup_get_oom_grouphNtauh1hhjKhhhNhNubh)}(hhh](h)}(hhstruct mem_cgroup * mem_cgroup_get_oom_group (struct task_struct *victim, struct mem_cgroup *oom_domain)h]h)}(hfstruct mem_cgroup *mem_cgroup_get_oom_group(struct task_struct *victim, struct mem_cgroup *oom_domain)h](j)}(hjJ,h]hstruct}(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"hhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMubj)}(h h]h }(hj+"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"hhhj*"hMubh)}(hhh]j)}(h mem_cgrouph]h mem_cgroup}(hj<"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9"ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj>"modnameN classnameNjj)}j]j)}jmem_cgroup_get_oom_groupsbc.mem_cgroup_get_oom_groupasbuh1hhj"hhhj*"hMubj)}(h h]h }(hj]"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"hhhj*"hMubjr)}(hjuh]h*}(hjk"hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj"hhhj*"hMubh)}(hmem_cgroup_get_oom_grouph]j)}(hjZ"h]hmem_cgroup_get_oom_group}(hj|"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjx"ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj"hhhj*"hMubj8)}(h;(struct task_struct *victim, struct mem_cgroup *oom_domain)h](j>)}(hstruct task_struct *victimh](j)}(hjJ,h]hstruct}(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"ubj)}(h h]h }(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"ubh)}(hhh]j)}(h task_structh]h task_struct}(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj"modnameN classnameNjj)}j]jX"c.mem_cgroup_get_oom_groupasbuh1hhj"ubj)}(h h]h }(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"ubjr)}(hjuh]h*}(hj"hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj"ubj)}(hvictimh]hvictim}(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj"ubj>)}(hstruct mem_cgroup *oom_domainh](j)}(hjJ,h]hstruct}(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#ubj)}(h h]h }(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#ubh)}(hhh]j)}(h mem_cgrouph]h mem_cgroup}(hj%#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"#ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj'#modnameN classnameNjj)}j]jX"c.mem_cgroup_get_oom_groupasbuh1hhj#ubj)}(h h]h }(hjC#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#ubjr)}(hjuh]h*}(hjQ#hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj#ubj)}(h oom_domainh]h oom_domain}(hj^#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj"ubeh}(h]h ]h"]h$]h&]jjuh1j7hj"hhhj*"hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj"hhhj*"hMubah}(h]j"ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj*"hMhj"hhubj4)}(hhh]jM)}(h)get a memory cgroup to clean up after OOMh]h)get a memory cgroup to clean up after OOM}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj#hhubah}(h]h ]h"]h$]h&]uh1j3hj"hhhj*"hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj#jHj#jIjJjKuh1hhhhjKhNhNubj)}(hXz**Parameters** ``struct task_struct *victim`` task to be killed by the OOM killer ``struct mem_cgroup *oom_domain`` memcg in case of memcg OOM, NULL in case of system-wide OOM **Description** Returns a pointer to a memory cgroup, which has to be cleaned up by killing all belonging OOM-killable tasks. Caller has to call mem_cgroup_put() on the returned non-NULL memcg.h](jM)}(h**Parameters**h]j)}(hj#h]h Parameters}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj#ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj#ubj)}(hhh](j)}(hC``struct task_struct *victim`` task to be killed by the OOM killer h](j)}(h``struct task_struct *victim``h]jS)}(hj#h]hstruct task_struct *victim}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj#ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj#ubj)}(hhh]jM)}(h#task to be killed by the OOM killerh]h#task to be killed by the OOM killer}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj#hMhj#ubah}(h]h ]h"]h$]h&]uh1jhj#ubeh}(h]h ]h"]h$]h&]uh1jhj#hMhj#ubj)}(h^``struct mem_cgroup *oom_domain`` memcg in case of memcg OOM, NULL in case of system-wide OOM h](j)}(h!``struct mem_cgroup *oom_domain``h]jS)}(hj$h]hstruct mem_cgroup *oom_domain}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj$ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj#ubj)}(hhh]jM)}(h;memcg in case of memcg OOM, NULL in case of system-wide OOMh]h;memcg in case of memcg OOM, NULL in case of system-wide OOM}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj$hMhj$ubah}(h]h ]h"]h$]h&]uh1jhj#ubeh}(h]h ]h"]h$]h&]uh1jhj$hMhj#ubeh}(h]h ]h"]h$]h&]uh1jhj#ubjM)}(h**Description**h]j)}(hj=$h]h Description}(hj?$hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj;$ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj#ubjM)}(hmReturns a pointer to a memory cgroup, which has to be cleaned up by killing all belonging OOM-killable tasks.h]hmReturns a pointer to a memory cgroup, which has to be cleaned up by killing all belonging OOM-killable tasks.}(hjS$hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj#ubjM)}(hCCaller has to call mem_cgroup_put() on the returned non-NULL memcg.h]hCCaller has to call mem_cgroup_put() on the returned non-NULL memcg.}(hjb$hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj#ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hconsume_stock (C function)c.consume_stockhNtauh1hhjKhhhNhNubh)}(hhh](h)}(hDbool consume_stock (struct mem_cgroup *memcg, unsigned int nr_pages)h]h)}(hCbool consume_stock(struct mem_cgroup *memcg, unsigned int nr_pages)h](j)}(hjh]hbool}(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$hhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM_ubj)}(h h]h }(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$hhhj$hM_ubh)}(h consume_stockh]j)}(h consume_stockh]h consume_stock}(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj$hhhj$hM_ubj8)}(h1(struct mem_cgroup *memcg, unsigned int nr_pages)h](j>)}(hstruct mem_cgroup *memcgh](j)}(hjJ,h]hstruct}(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$ubj)}(h h]h }(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$ubh)}(hhh]j)}(h mem_cgrouph]h mem_cgroup}(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj$modnameN classnameNjj)}j]j)}jj$sbc.consume_stockasbuh1hhj$ubj)}(h h]h }(hj %hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$ubjr)}(hjuh]h*}(hj%hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj$ubj)}(hmemcgh]hmemcg}(hj&%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj$ubj>)}(hunsigned int nr_pagesh](j)}(hunsignedh]hunsigned}(hj?%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;%ubj)}(h h]h }(hjM%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;%ubj)}(hinth]hint}(hj[%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;%ubj)}(h h]h }(hji%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;%ubj)}(hnr_pagesh]hnr_pages}(hjw%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;%ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj$ubeh}(h]h ]h"]h$]h&]jjuh1j7hj$hhhj$hM_ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj$hhhj$hM_ubah}(h]j$ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj$hM_hj$hhubj4)}(hhh]jM)}(h*Try to consume stocked charge on this cpu.h]h*Try to consume stocked charge on this cpu.}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM_hj%hhubah}(h]h ]h"]h$]h&]uh1j3hj$hhhj$hM_ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj%jHj%jIjJjKuh1hhhhjKhNhNubj)}(hX|**Parameters** ``struct mem_cgroup *memcg`` memcg to consume from. ``unsigned int nr_pages`` how many pages to charge. **Description** Consume the cached charge if enough nr_pages are present otherwise return failure. Also return failure for charge request larger than MEMCG_CHARGE_BATCH or if the local lock is already taken. returns true if successful, false otherwise.h](jM)}(h**Parameters**h]j)}(hj%h]h Parameters}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj%ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMchj%ubj)}(hhh](j)}(h4``struct mem_cgroup *memcg`` memcg to consume from. h](j)}(h``struct mem_cgroup *memcg``h]jS)}(hj%h]hstruct mem_cgroup *memcg}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj%ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM`hj%ubj)}(hhh]jM)}(hmemcg to consume from.h]hmemcg to consume from.}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj%hM`hj%ubah}(h]h ]h"]h$]h&]uh1jhj%ubeh}(h]h ]h"]h$]h&]uh1jhj%hM`hj%ubj)}(h4``unsigned int nr_pages`` how many pages to charge. h](j)}(h``unsigned int nr_pages``h]jS)}(hj&h]hunsigned int nr_pages}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj&ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMahj&ubj)}(hhh]jM)}(hhow many pages to charge.h]hhow many pages to charge.}(hj4&hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj0&hMahj1&ubah}(h]h ]h"]h$]h&]uh1jhj&ubeh}(h]h ]h"]h$]h&]uh1jhj0&hMahj%ubeh}(h]h ]h"]h$]h&]uh1jhj%ubjM)}(h**Description**h]j)}(hjV&h]h Description}(hjX&hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjT&ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMchj%ubjM)}(hConsume the cached charge if enough nr_pages are present otherwise return failure. Also return failure for charge request larger than MEMCG_CHARGE_BATCH or if the local lock is already taken.h]hConsume the cached charge if enough nr_pages are present otherwise return failure. Also return failure for charge request larger than MEMCG_CHARGE_BATCH or if the local lock is already taken.}(hjl&hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMbhj%ubjM)}(h,returns true if successful, false otherwise.h]h,returns true if successful, false otherwise.}(hj{&hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMfhj%ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h%__memcg_kmem_charge_page (C function)c.__memcg_kmem_charge_pagehNtauh1hhjKhhhNhNubh)}(hhh](h)}(hFint __memcg_kmem_charge_page (struct page *page, gfp_t gfp, int order)h]h)}(hEint __memcg_kmem_charge_page(struct page *page, gfp_t gfp, int order)h](j)}(hinth]hint}(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&hhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM ubj)}(h h]h }(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&hhhj&hM ubh)}(h__memcg_kmem_charge_pageh]j)}(h__memcg_kmem_charge_pageh]h__memcg_kmem_charge_page}(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj&hhhj&hM ubj8)}(h)(struct page *page, gfp_t gfp, int order)h](j>)}(hstruct page *pageh](j)}(hjJ,h]hstruct}(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubj)}(h h]h }(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubh)}(hhh]j)}(hpageh]hpage}(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj'ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj'modnameN classnameNjj)}j]j)}jj&sbc.__memcg_kmem_charge_pageasbuh1hhj&ubj)}(h h]h }(hj%'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubjr)}(hjuh]h*}(hj3'hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj&ubj)}(hpageh]hpage}(hj@'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj&ubj>)}(h gfp_t gfph](h)}(hhh]j)}(hgfp_th]hgfp_t}(hj\'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjY'ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj^'modnameN classnameNjj)}j]j!'c.__memcg_kmem_charge_pageasbuh1hhjU'ubj)}(h h]h }(hjz'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjU'ubj)}(hgfph]hgfp}(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjU'ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj&ubj>)}(h int orderh](j)}(hinth]hint}(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj'ubj)}(h h]h }(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj'ubj)}(horderh]horder}(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj'ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj&ubeh}(h]h ]h"]h$]h&]jjuh1j7hj&hhhj&hM ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj&hhhj&hM ubah}(h]j&ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj&hM hj&hhubj4)}(hhh]jM)}(h/charge a kmem page to the current memory cgrouph]h/charge a kmem page to the current memory cgroup}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM hj'hhubah}(h]h ]h"]h$]h&]uh1j3hj&hhhj&hM ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj'jHj'jIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``struct page *page`` page to charge ``gfp_t gfp`` reclaim mode ``int order`` allocation order **Description** Returns 0 on success, an error code on failure.h](jM)}(h**Parameters**h]j)}(hj (h]h Parameters}(hj (hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj(ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM hj(ubj)}(hhh](j)}(h%``struct page *page`` page to charge h](j)}(h``struct page *page``h]jS)}(hj((h]hstruct page *page}(hj*(hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj&(ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM hj"(ubj)}(hhh]jM)}(hpage to chargeh]hpage to charge}(hjA(hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj=(hM hj>(ubah}(h]h ]h"]h$]h&]uh1jhj"(ubeh}(h]h ]h"]h$]h&]uh1jhj=(hM hj(ubj)}(h``gfp_t gfp`` reclaim mode h](j)}(h ``gfp_t gfp``h]jS)}(hja(h]h gfp_t gfp}(hjc(hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj_(ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM hj[(ubj)}(hhh]jM)}(h reclaim modeh]h reclaim mode}(hjz(hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjv(hM hjw(ubah}(h]h ]h"]h$]h&]uh1jhj[(ubeh}(h]h ]h"]h$]h&]uh1jhjv(hM hj(ubj)}(h``int order`` allocation order h](j)}(h ``int order``h]jS)}(hj(h]h int order}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj(ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM hj(ubj)}(hhh]jM)}(hallocation orderh]hallocation order}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj(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(ubjM)}(h**Description**h]j)}(hj(h]h Description}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj(ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM hj(ubjM)}(h/Returns 0 on success, an error code on failure.h]h/Returns 0 on success, an error code on failure.}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM hj(ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h'__memcg_kmem_uncharge_page (C function)c.__memcg_kmem_uncharge_pagehNtauh1hhjKhhhNhNubh)}(hhh](h)}(h>void __memcg_kmem_uncharge_page (struct page *page, int order)h]h)}(h=void __memcg_kmem_uncharge_page(struct page *page, int order)h](j)}(hvoidh]hvoid}(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)hhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM ubj)}(h h]h }(hj))hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)hhhj()hM ubh)}(h__memcg_kmem_uncharge_pageh]j)}(h__memcg_kmem_uncharge_pageh]h__memcg_kmem_uncharge_page}(hj;)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7)ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj)hhhj()hM ubj8)}(h(struct page *page, int order)h](j>)}(hstruct page *pageh](j)}(hjJ,h]hstruct}(hjW)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjS)ubj)}(h h]h }(hjd)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjS)ubh)}(hhh]j)}(hpageh]hpage}(hju)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjr)ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjw)modnameN classnameNjj)}j]j)}jj=)sbc.__memcg_kmem_uncharge_pageasbuh1hhjS)ubj)}(h h]h }(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjS)ubjr)}(hjuh]h*}(hj)hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjS)ubj)}(hpageh]hpage}(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjS)ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjO)ubj>)}(h int orderh](j)}(hinth]hint}(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubj)}(h h]h }(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubj)}(horderh]horder}(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjO)ubeh}(h]h ]h"]h$]h&]jjuh1j7hj)hhhj()hM ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj)hhhj()hM ubah}(h]j )ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj()hM hj)hhubj4)}(hhh]jM)}(huncharge a kmem pageh]huncharge a kmem page}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM hj *hhubah}(h]h ]h"]h$]h&]uh1j3hj)hhhj()hM ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj'*jHj'*jIjJjKuh1hhhhjKhNhNubj)}(hZ**Parameters** ``struct page *page`` page to uncharge ``int order`` allocation orderh](jM)}(h**Parameters**h]j)}(hj1*h]h Parameters}(hj3*hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj/*ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM hj+*ubj)}(hhh](j)}(h'``struct page *page`` page to uncharge h](j)}(h``struct page *page``h]jS)}(hjP*h]hstruct page *page}(hjR*hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjN*ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM hjJ*ubj)}(hhh]jM)}(hpage to unchargeh]hpage to uncharge}(hji*hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhje*hM hjf*ubah}(h]h ]h"]h$]h&]uh1jhjJ*ubeh}(h]h ]h"]h$]h&]uh1jhje*hM hjG*ubj)}(h``int order`` allocation orderh](j)}(h ``int order``h]jS)}(hj*h]h int order}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj*ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM hj*ubj)}(hhh]jM)}(hallocation orderh]hallocation order}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM hj*ubah}(h]h ]h"]h$]h&]uh1jhj*ubeh}(h]h ]h"]h$]h&]uh1jhj*hM hjG*ubeh}(h]h ]h"]h$]h&]uh1jhj+*ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h mem_cgroup_wb_stats (C function)c.mem_cgroup_wb_statshNtauh1hhjKhhhNhNubh)}(hhh](h)}(hvoid mem_cgroup_wb_stats (struct bdi_writeback *wb, unsigned long *pfilepages, unsigned long *pheadroom, unsigned long *pdirty, unsigned long *pwriteback)h]h)}(hvoid mem_cgroup_wb_stats(struct bdi_writeback *wb, unsigned long *pfilepages, unsigned long *pheadroom, unsigned long *pdirty, unsigned long *pwriteback)h](j)}(hvoidh]hvoid}(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*hhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMubj)}(h h]h }(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*hhhj*hMubh)}(hmem_cgroup_wb_statsh]j)}(hmem_cgroup_wb_statsh]hmem_cgroup_wb_stats}(hj+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj*hhhj*hMubj8)}(h(struct bdi_writeback *wb, unsigned long *pfilepages, unsigned long *pheadroom, unsigned long *pdirty, unsigned long *pwriteback)h](j>)}(hstruct bdi_writeback *wbh](j)}(hjJ,h]hstruct}(hj +hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubj)}(h h]h }(hj-+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubh)}(hhh]j)}(h bdi_writebackh]h bdi_writeback}(hj>+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;+ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj@+modnameN classnameNjj)}j]j)}jj+sbc.mem_cgroup_wb_statsasbuh1hhj+ubj)}(h h]h }(hj^+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubjr)}(hjuh]h*}(hjl+hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj+ubj)}(hwbh]hwb}(hjy+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj+ubj>)}(hunsigned long *pfilepagesh](j)}(hunsignedh]hunsigned}(hj+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubj)}(h h]h }(hj+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubj)}(hlongh]hlong}(hj+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubj)}(h h]h }(hj+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubjr)}(hjuh]h*}(hj+hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj+ubj)}(h pfilepagesh]h pfilepages}(hj+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj+ubj>)}(hunsigned long *pheadroomh](j)}(hunsignedh]hunsigned}(hj+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubj)}(h h]h }(hj+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubj)}(hlongh]hlong}(hj ,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubj)}(h h]h }(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubjr)}(hjuh]h*}(hj(,hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj+ubj)}(h pheadroomh]h pheadroom}(hj5,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj+ubj>)}(hunsigned long *pdirtyh](j)}(hunsignedh]hunsigned}(hjN,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJ,ubj)}(h h]h }(hj\,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJ,ubj)}(hlongh]hlong}(hjj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJ,ubj)}(h h]h }(hjx,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJ,ubjr)}(hjuh]h*}(hj,hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjJ,ubj)}(hpdirtyh]hpdirty}(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJ,ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj+ubj>)}(hunsigned long *pwritebackh](j)}(hunsignedh]hunsigned}(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,ubj)}(h h]h }(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,ubj)}(hlongh]hlong}(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,ubj)}(h h]h }(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,ubjr)}(hjuh]h*}(hj,hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj,ubj)}(h pwritebackh]h pwriteback}(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj+ubeh}(h]h ]h"]h$]h&]jjuh1j7hj*hhhj*hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj*hhhj*hMubah}(h]j*ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj*hMhj*hhubj4)}(hhh]jM)}(h/retrieve writeback related stats from its memcgh]h/retrieve writeback related stats from its memcg}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj-hhubah}(h]h ]h"]h$]h&]uh1j3hj*hhhj*hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj3-jHj3-jIjJjKuh1hhhhjKhNhNubj)}(hXh**Parameters** ``struct bdi_writeback *wb`` bdi_writeback in question ``unsigned long *pfilepages`` out parameter for number of file pages ``unsigned long *pheadroom`` out parameter for number of allocatable pages according to memcg ``unsigned long *pdirty`` out parameter for number of dirty pages ``unsigned long *pwriteback`` out parameter for number of pages under writeback **Description** Determine the numbers of file, headroom, dirty, and writeback pages in **wb**'s memcg. File, dirty and writeback are self-explanatory. Headroom is a bit more involved. A memcg's headroom is "min(max, high) - used". In the hierarchy, the headroom is calculated as the lowest headroom of itself and the ancestors. Note that this doesn't consider the actual amount of available memory in the system. The caller should further cap ***pheadroom** accordingly.h](jM)}(h**Parameters**h]j)}(hj=-h]h Parameters}(hj?-hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj;-ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj7-ubj)}(hhh](j)}(h7``struct bdi_writeback *wb`` bdi_writeback in question h](j)}(h``struct bdi_writeback *wb``h]jS)}(hj\-h]hstruct bdi_writeback *wb}(hj^-hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjZ-ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjV-ubj)}(hhh]jM)}(hbdi_writeback in questionh]hbdi_writeback in question}(hju-hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjq-hMhjr-ubah}(h]h ]h"]h$]h&]uh1jhjV-ubeh}(h]h ]h"]h$]h&]uh1jhjq-hMhjS-ubj)}(hE``unsigned long *pfilepages`` out parameter for number of file pages h](j)}(h``unsigned long *pfilepages``h]jS)}(hj-h]hunsigned long *pfilepages}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj-ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj-ubj)}(hhh]jM)}(h&out parameter for number of file pagesh]h&out parameter for number of file pages}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj-hMhj-ubah}(h]h ]h"]h$]h&]uh1jhj-ubeh}(h]h ]h"]h$]h&]uh1jhj-hMhjS-ubj)}(h^``unsigned long *pheadroom`` out parameter for number of allocatable pages according to memcg h](j)}(h``unsigned long *pheadroom``h]jS)}(hj-h]hunsigned long *pheadroom}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj-ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj-ubj)}(hhh]jM)}(h@out parameter for number of allocatable pages according to memcgh]h@out parameter for number of allocatable pages according to memcg}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj-hMhj-ubah}(h]h ]h"]h$]h&]uh1jhj-ubeh}(h]h ]h"]h$]h&]uh1jhj-hMhjS-ubj)}(hB``unsigned long *pdirty`` out parameter for number of dirty pages h](j)}(h``unsigned long *pdirty``h]jS)}(hj.h]hunsigned long *pdirty}(hj .hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj.ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj.ubj)}(hhh]jM)}(h'out parameter for number of dirty pagesh]h'out parameter for number of dirty pages}(hj .hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj.hMhj.ubah}(h]h ]h"]h$]h&]uh1jhj.ubeh}(h]h ]h"]h$]h&]uh1jhj.hMhjS-ubj)}(hP``unsigned long *pwriteback`` out parameter for number of pages under writeback h](j)}(h``unsigned long *pwriteback``h]jS)}(hj@.h]hunsigned long *pwriteback}(hjB.hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj>.ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM hj:.ubj)}(hhh]jM)}(h1out parameter for number of pages under writebackh]h1out parameter for number of pages under writeback}(hjY.hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjU.hM hjV.ubah}(h]h ]h"]h$]h&]uh1jhj:.ubeh}(h]h ]h"]h$]h&]uh1jhjU.hM hjS-ubeh}(h]h ]h"]h$]h&]uh1jhj7-ubjM)}(h**Description**h]j)}(hj{.h]h Description}(hj}.hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjy.ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM"hj7-ubjM)}(hDetermine the numbers of file, headroom, dirty, and writeback pages in **wb**'s memcg. File, dirty and writeback are self-explanatory. Headroom is a bit more involved.h](hGDetermine the numbers of file, headroom, dirty, and writeback pages in }(hj.hhhNhNubj)}(h**wb**h]hwb}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj.ubh^’s memcg. File, dirty and writeback are self-explanatory. Headroom is a bit more involved.}(hj.hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM!hj7-ubjM)}(hX!A memcg's headroom is "min(max, high) - used". In the hierarchy, the headroom is calculated as the lowest headroom of itself and the ancestors. Note that this doesn't consider the actual amount of available memory in the system. The caller should further cap ***pheadroom** accordingly.h](hXA memcg’s headroom is “min(max, high) - used”. In the hierarchy, the headroom is calculated as the lowest headroom of itself and the ancestors. Note that this doesn’t consider the actual amount of available memory in the system. The caller should further cap }(hj.hhhNhNubj)}(h***pheadroom**h]h *pheadroom}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj.ubh accordingly.}(hj.hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM%hj7-ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h'mem_cgroup_from_private_id (C function)c.mem_cgroup_from_private_idhNtauh1hhjKhhhNhNubh)}(hhh](h)}(hBstruct mem_cgroup * mem_cgroup_from_private_id (unsigned short id)h]h)}(h@struct mem_cgroup *mem_cgroup_from_private_id(unsigned short id)h](j)}(hjJ,h]hstruct}(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj.hhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM2ubj)}(h h]h }(hj/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj.hhhj/hM2ubh)}(hhh]j)}(h mem_cgrouph]h mem_cgroup}(hj/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj/modnameN classnameNjj)}j]j)}jmem_cgroup_from_private_idsbc.mem_cgroup_from_private_idasbuh1hhj.hhhj/hM2ubj)}(h h]h }(hj3/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj.hhhj/hM2ubjr)}(hjuh]h*}(hjA/hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj.hhhj/hM2ubh)}(hmem_cgroup_from_private_idh]j)}(hj0/h]hmem_cgroup_from_private_id}(hjR/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjN/ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj.hhhj/hM2ubj8)}(h(unsigned short id)h]j>)}(hunsigned short idh](j)}(hunsignedh]hunsigned}(hjm/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhji/ubj)}(h h]h }(hj{/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhji/ubj)}(hshorth]hshort}(hj/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhji/ubj)}(h h]h }(hj/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhji/ubj)}(hidh]hid}(hj/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhji/ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hje/ubah}(h]h ]h"]h$]h&]jjuh1j7hj.hhhj/hM2ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj.hhhj/hM2ubah}(h]j.ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj/hM2hj.hhubj4)}(hhh]jM)}(hlook up a memcg from a memcg idh]hlook up a memcg from a memcg id}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM2hj/hhubah}(h]h ]h"]h$]h&]uh1j3hj.hhhj/hM2ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj/jHj/jIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``unsigned short id`` the memcg id to look up **Description** Caller must hold rcu_read_lock(). **Return** the memcg, or NULL if the memcg referred to is already dead.h](jM)}(h**Parameters**h]j)}(hj/h]h Parameters}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj/ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM6hj/ubj)}(hhh]j)}(h.``unsigned short id`` the memcg id to look up h](j)}(h``unsigned short id``h]jS)}(hj0h]hunsigned short id}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj0ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM3hj 0ubj)}(hhh]jM)}(hthe memcg id to look uph]hthe memcg id to look up}(hj)0hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj%0hM3hj&0ubah}(h]h ]h"]h$]h&]uh1jhj 0ubeh}(h]h ]h"]h$]h&]uh1jhj%0hM3hj0ubah}(h]h ]h"]h$]h&]uh1jhj/ubjM)}(h**Description**h]j)}(hjK0h]h Description}(hjM0hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjI0ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM5hj/ubjM)}(h!Caller must hold rcu_read_lock().h]h!Caller must hold rcu_read_lock().}(hja0hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM4hj/ubjM)}(h **Return**h]j)}(hjr0h]hReturn}(hjt0hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjp0ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM6hj/ubjM)}(h)}(hstruct cgroup_subsys_state *cssh](j)}(hjJ,h]hstruct}(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubj)}(h h]h }(hj1hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubh)}(hhh]j)}(hcgroup_subsys_stateh]hcgroup_subsys_state}(hj1hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj1ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj1modnameN classnameNjj)}j]j)}jj0sbc.mem_cgroup_css_resetasbuh1hhj0ubj)}(h h]h }(hj21hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubjr)}(hjuh]h*}(hj@1hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj0ubj)}(hcssh]hcss}(hjM1hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj0ubah}(h]h ]h"]h$]h&]jjuh1j7hj0hhhj0hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj0hhhj0hMubah}(h]j0ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj0hMhj0hhubj4)}(hhh]jM)}(h reset the states of a mem_cgrouph]h reset the states of a mem_cgroup}(hjw1hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjt1hhubah}(h]h ]h"]h$]h&]uh1j3hj0hhhj0hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj1jHj1jIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct cgroup_subsys_state *css`` the target css **Description** Reset the states of the mem_cgroup associated with **css**. This is invoked when the userland requests disabling on the default hierarchy but the memcg is pinned through dependency. The memcg should stop applying policies and should revert to the vanilla state as it may be made visible again. The current implementation only resets the essential configurations. This needs to be expanded to cover all the visible parts.h](jM)}(h**Parameters**h]j)}(hj1h]h Parameters}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj1ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj1ubj)}(hhh]j)}(h3``struct cgroup_subsys_state *css`` the target css h](j)}(h#``struct cgroup_subsys_state *css``h]jS)}(hj1h]hstruct cgroup_subsys_state *css}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj1ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj1ubj)}(hhh]jM)}(hthe target cssh]hthe target css}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj1hMhj1ubah}(h]h ]h"]h$]h&]uh1jhj1ubeh}(h]h ]h"]h$]h&]uh1jhj1hMhj1ubah}(h]h ]h"]h$]h&]uh1jhj1ubjM)}(h**Description**h]j)}(hj1h]h Description}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj1ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj1ubjM)}(hX'Reset the states of the mem_cgroup associated with **css**. This is invoked when the userland requests disabling on the default hierarchy but the memcg is pinned through dependency. The memcg should stop applying policies and should revert to the vanilla state as it may be made visible again.h](h3Reset the states of the mem_cgroup associated with }(hj 2hhhNhNubj)}(h**css**h]hcss}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj 2ubh. This is invoked when the userland requests disabling on the default hierarchy but the memcg is pinned through dependency. The memcg should stop applying policies and should revert to the vanilla state as it may be made visible again.}(hj 2hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj1ubjM)}(h~The current implementation only resets the essential configurations. This needs to be expanded to cover all the visible parts.h]h~The current implementation only resets the essential configurations. This needs to be expanded to cover all the visible parts.}(hj*2hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj1ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h,mem_cgroup_calculate_protection (C function)!c.mem_cgroup_calculate_protectionhNtauh1hhjKhhhNhNubh)}(hhh](h)}(hXvoid mem_cgroup_calculate_protection (struct mem_cgroup *root, struct mem_cgroup *memcg)h]h)}(hWvoid mem_cgroup_calculate_protection(struct mem_cgroup *root, struct mem_cgroup *memcg)h](j)}(hvoidh]hvoid}(hjY2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjU2hhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMubj)}(h h]h }(hjh2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjU2hhhjg2hMubh)}(hmem_cgroup_calculate_protectionh]j)}(hmem_cgroup_calculate_protectionh]hmem_cgroup_calculate_protection}(hjz2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjv2ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjU2hhhjg2hMubj8)}(h3(struct mem_cgroup *root, struct mem_cgroup *memcg)h](j>)}(hstruct mem_cgroup *rooth](j)}(hjJ,h]hstruct}(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2ubj)}(h h]h }(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2ubh)}(hhh]j)}(h mem_cgrouph]h mem_cgroup}(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj2modnameN classnameNjj)}j]j)}jj|2sb!c.mem_cgroup_calculate_protectionasbuh1hhj2ubj)}(h h]h }(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2ubjr)}(hjuh]h*}(hj2hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj2ubj)}(hrooth]hroot}(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj2ubj>)}(hstruct mem_cgroup *memcgh](j)}(hjJ,h]hstruct}(hj3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3ubj)}(h h]h }(hj3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3ubh)}(hhh]j)}(h mem_cgrouph]h mem_cgroup}(hj&3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#3ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj(3modnameN classnameNjj)}j]j2!c.mem_cgroup_calculate_protectionasbuh1hhj3ubj)}(h h]h }(hjD3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3ubjr)}(hjuh]h*}(hjR3hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj3ubj)}(hmemcgh]hmemcg}(hj_3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj2ubeh}(h]h ]h"]h$]h&]jjuh1j7hjU2hhhjg2hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjQ2hhhjg2hMubah}(h]jL2ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjg2hMhjN2hhubj4)}(hhh]jM)}(h2check if memory consumption is in the normal rangeh]h2check if memory consumption is in the normal range}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj3hhubah}(h]h ]h"]h$]h&]uh1j3hjN2hhhjg2hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj3jHj3jIjJjKuh1hhhhjKhNhNubj)}(hX/**Parameters** ``struct mem_cgroup *root`` the top ancestor of the sub-tree being checked ``struct mem_cgroup *memcg`` the memory cgroup to check **Description** WARNING: This function is not stateless! It can only be used as part of a top-down tree iteration, not for isolated queries.h](jM)}(h**Parameters**h]j)}(hj3h]h Parameters}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj3ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj3ubj)}(hhh](j)}(hK``struct mem_cgroup *root`` the top ancestor of the sub-tree being checked h](j)}(h``struct mem_cgroup *root``h]jS)}(hj3h]hstruct mem_cgroup *root}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj3ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj3ubj)}(hhh]jM)}(h.the top ancestor of the sub-tree being checkedh]h.the top ancestor of the sub-tree being checked}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj3hMhj3ubah}(h]h ]h"]h$]h&]uh1jhj3ubeh}(h]h ]h"]h$]h&]uh1jhj3hMhj3ubj)}(h8``struct mem_cgroup *memcg`` the memory cgroup to check h](j)}(h``struct mem_cgroup *memcg``h]jS)}(hj4h]hstruct mem_cgroup *memcg}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj4ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj3ubj)}(hhh]jM)}(hthe memory cgroup to checkh]hthe memory cgroup to check}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj4hMhj4ubah}(h]h ]h"]h$]h&]uh1jhj3ubeh}(h]h ]h"]h$]h&]uh1jhj4hMhj3ubeh}(h]h ]h"]h$]h&]uh1jhj3ubjM)}(h**Description**h]j)}(hj>4h]h Description}(hj@4hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj<4ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj3ubj)}(hhh]j)}(h|WARNING: This function is not stateless! It can only be used as part of a top-down tree iteration, not for isolated queries.h](j)}(hDWARNING: This function is not stateless! It can only be used as parth]hDWARNING: This function is not stateless! It can only be used as part}(hj[4hhhNhNubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjW4ubj)}(hhh]jM)}(h7of a top-down tree iteration, not for isolated queries.h]h7of a top-down tree iteration, not for isolated queries.}(hjm4hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjj4ubah}(h]h ]h"]h$]h&]uh1jhjW4ubeh}(h]h ]h"]h$]h&]uh1jhji4hMhjT4ubah}(h]h ]h"]h$]h&]uh1jhj3ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h1mem_cgroup_calculate_protection_path (C function)&c.mem_cgroup_calculate_protection_pathhNtauh1hhjKhhhNhNubh)}(hhh](h)}(h]void mem_cgroup_calculate_protection_path (struct mem_cgroup *root, struct mem_cgroup *memcg)h]h)}(h\void mem_cgroup_calculate_protection_path(struct mem_cgroup *root, struct mem_cgroup *memcg)h](j)}(hvoidh]hvoid}(hj4hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4hhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMubj)}(h h]h }(hj4hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4hhhj4hMubh)}(h$mem_cgroup_calculate_protection_pathh]j)}(h$mem_cgroup_calculate_protection_pathh]h$mem_cgroup_calculate_protection_path}(hj4hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj4hhhj4hMubj8)}(h3(struct mem_cgroup *root, struct mem_cgroup *memcg)h](j>)}(hstruct mem_cgroup *rooth](j)}(hjJ,h]hstruct}(hj4hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4ubj)}(h h]h }(hj4hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4ubh)}(hhh]j)}(h mem_cgrouph]h mem_cgroup}(hj 5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj 5modnameN classnameNjj)}j]j)}jj4sb&c.mem_cgroup_calculate_protection_pathasbuh1hhj4ubj)}(h h]h }(hj)5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4ubjr)}(hjuh]h*}(hj75hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj4ubj)}(hrooth]hroot}(hjD5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj4ubj>)}(hstruct mem_cgroup *memcgh](j)}(hjJ,h]hstruct}(hj]5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjY5ubj)}(h h]h }(hjj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjY5ubh)}(hhh]j)}(h mem_cgrouph]h mem_cgroup}(hj{5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjx5ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj}5modnameN classnameNjj)}j]j%5&c.mem_cgroup_calculate_protection_pathasbuh1hhjY5ubj)}(h h]h }(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjY5ubjr)}(hjuh]h*}(hj5hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjY5ubj)}(hmemcgh]hmemcg}(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjY5ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj4ubeh}(h]h ]h"]h$]h&]jjuh1j7hj4hhhj4hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj4hhhj4hMubah}(h]j4ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj4hMhj4hhubj4)}(hhh]jM)}(hcompute protection along a pathh]hcompute protection along a path}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj5hhubah}(h]h ]h"]h$]h&]uh1j3hj4hhhj4hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj5jHj5jIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct mem_cgroup *root`` the top ancestor of the sub-tree being checked (NULL for root_mem_cgroup) ``struct mem_cgroup *memcg`` the target memory cgroup **Description** Walk the ancestor path from **root** down to **memcg** and compute the effective protection at each level. This is safe for isolated queries because it ensures parents are computed before children.h](jM)}(h**Parameters**h]j)}(hj6h]h Parameters}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj5ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj5ubj)}(hhh](j)}(hf``struct mem_cgroup *root`` the top ancestor of the sub-tree being checked (NULL for root_mem_cgroup) h](j)}(h``struct mem_cgroup *root``h]jS)}(hj6h]hstruct mem_cgroup *root}(hj!6hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj6ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj6ubj)}(hhh]jM)}(hIthe top ancestor of the sub-tree being checked (NULL for root_mem_cgroup)h]hIthe top ancestor of the sub-tree being checked (NULL for root_mem_cgroup)}(hj86hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj46hMhj56ubah}(h]h ]h"]h$]h&]uh1jhj6ubeh}(h]h ]h"]h$]h&]uh1jhj46hMhj6ubj)}(h6``struct mem_cgroup *memcg`` the target memory cgroup h](j)}(h``struct mem_cgroup *memcg``h]jS)}(hjX6h]hstruct mem_cgroup *memcg}(hjZ6hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjV6ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjR6ubj)}(hhh]jM)}(hthe target memory cgrouph]hthe target memory cgroup}(hjq6hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjm6hMhjn6ubah}(h]h ]h"]h$]h&]uh1jhjR6ubeh}(h]h ]h"]h$]h&]uh1jhjm6hMhj6ubeh}(h]h ]h"]h$]h&]uh1jhj5ubjM)}(h**Description**h]j)}(hj6h]h Description}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj6ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj5ubjM)}(hWalk the ancestor path from **root** down to **memcg** and compute the effective protection at each level. This is safe for isolated queries because it ensures parents are computed before children.h](hWalk the ancestor path from }(hj6hhhNhNubj)}(h**root**h]hroot}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj6ubh down to }(hj6hhhNhNubj)}(h **memcg**h]hmemcg}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj6ubh and compute the effective protection at each level. This is safe for isolated queries because it ensures parents are computed before children.}(hj6hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj5ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h&mem_cgroup_charge_hugetlb (C function)c.mem_cgroup_charge_hugetlbhNtauh1hhjKhhhNhNubh)}(hhh](h)}(hTint mem_cgroup_charge_hugetlb (struct folio *folio, struct mm_struct *mm, gfp_t gfp)h]h)}(hSint mem_cgroup_charge_hugetlb(struct folio *folio, struct mm_struct *mm, gfp_t gfp)h](j)}(hinth]hint}(hj6hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj6hhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMubj)}(h h]h }(hj 7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj6hhhj 7hMubh)}(hmem_cgroup_charge_hugetlbh]j)}(hmem_cgroup_charge_hugetlbh]hmem_cgroup_charge_hugetlb}(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj6hhhj 7hMubj8)}(h6(struct folio *folio, struct mm_struct *mm, gfp_t gfp)h](j>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hj97hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj57ubj)}(h h]h }(hjF7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj57ubh)}(hhh]j)}(hfolioh]hfolio}(hjW7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjT7ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjY7modnameN classnameNjj)}j]j)}jj7sbc.mem_cgroup_charge_hugetlbasbuh1hhj57ubj)}(h h]h }(hjw7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj57ubjr)}(hjuh]h*}(hj7hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj57ubj)}(hfolioh]hfolio}(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj57ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj17ubj>)}(hstruct mm_struct *mmh](j)}(hjJ,h]hstruct}(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7ubj)}(h h]h }(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7ubh)}(hhh]j)}(h mm_structh]h mm_struct}(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj7modnameN classnameNjj)}j]js7c.mem_cgroup_charge_hugetlbasbuh1hhj7ubj)}(h h]h }(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7ubjr)}(hjuh]h*}(hj7hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj7ubj)}(hmmh]hmm}(hj8hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj17ubj>)}(h gfp_t gfph](h)}(hhh]j)}(hgfp_th]hgfp_t}(hj8hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj8ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj 8modnameN classnameNjj)}j]js7c.mem_cgroup_charge_hugetlbasbuh1hhj8ubj)}(h h]h }(hj<8hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj8ubj)}(hgfph]hgfp}(hjJ8hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj8ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj17ubeh}(h]h ]h"]h$]h&]jjuh1j7hj6hhhj 7hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj6hhhj 7hMubah}(h]j6ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj 7hMhj6hhubj4)}(hhh]jM)}(h$charge the memcg for a hugetlb folioh]h$charge the memcg for a hugetlb folio}(hjt8hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjq8hhubah}(h]h ]h"]h$]h&]uh1j3hj6hhhj 7hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj8jHj8jIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct folio *folio`` folio being charged ``struct mm_struct *mm`` mm context of the allocation target ``gfp_t gfp`` reclaim mode **Description** This function is called when allocating a huge page folio, after the page has already been obtained and charged to the appropriate hugetlb cgroup controller (if it is enabled). Returns ENOMEM if the memcg is already full. Returns 0 if either the charge was successful, or if we skip the charging.h](jM)}(h**Parameters**h]j)}(hj8h]h Parameters}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj8ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj8ubj)}(hhh](j)}(h,``struct folio *folio`` folio being charged h](j)}(h``struct folio *folio``h]jS)}(hj8h]hstruct folio *folio}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj8ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj8ubj)}(hhh]jM)}(hfolio being chargedh]hfolio being charged}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj8hMhj8ubah}(h]h ]h"]h$]h&]uh1jhj8ubeh}(h]h ]h"]h$]h&]uh1jhj8hMhj8ubj)}(h=``struct mm_struct *mm`` mm context of the allocation target h](j)}(h``struct mm_struct *mm``h]jS)}(hj8h]hstruct mm_struct *mm}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj8ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj8ubj)}(hhh]jM)}(h#mm context of the allocation targeth]h#mm context of the allocation target}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj9hMhj9ubah}(h]h ]h"]h$]h&]uh1jhj8ubeh}(h]h ]h"]h$]h&]uh1jhj9hMhj8ubj)}(h``gfp_t gfp`` reclaim mode h](j)}(h ``gfp_t gfp``h]jS)}(hj'9h]h gfp_t gfp}(hj)9hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj%9ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj!9ubj)}(hhh]jM)}(h reclaim modeh]h reclaim mode}(hj@9hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj<9hMhj=9ubah}(h]h ]h"]h$]h&]uh1jhj!9ubeh}(h]h ]h"]h$]h&]uh1jhj<9hMhj8ubeh}(h]h ]h"]h$]h&]uh1jhj8ubjM)}(h**Description**h]j)}(hjb9h]h Description}(hjd9hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj`9ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj8ubjM)}(hThis function is called when allocating a huge page folio, after the page has already been obtained and charged to the appropriate hugetlb cgroup controller (if it is enabled).h]hThis function is called when allocating a huge page folio, after the page has already been obtained and charged to the appropriate hugetlb cgroup controller (if it is enabled).}(hjx9hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj8ubjM)}(hwReturns ENOMEM if the memcg is already full. Returns 0 if either the charge was successful, or if we skip the charging.h]hwReturns ENOMEM if the memcg is already full. Returns 0 if either the charge was successful, or if we skip the charging.}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj8ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h+mem_cgroup_swapin_charge_folio (C function) c.mem_cgroup_swapin_charge_foliohNtauh1hhjKhhhNhNubh)}(hhh](h)}(hlint mem_cgroup_swapin_charge_folio (struct folio *folio, unsigned short id, struct mm_struct *mm, gfp_t gfp)h]h)}(hkint mem_cgroup_swapin_charge_folio(struct folio *folio, unsigned short id, struct mm_struct *mm, gfp_t gfp)h](j)}(hinth]hint}(hj9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9hhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM9ubj)}(h h]h }(hj9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9hhhj9hM9ubh)}(hmem_cgroup_swapin_charge_folioh]j)}(hmem_cgroup_swapin_charge_folioh]hmem_cgroup_swapin_charge_folio}(hj9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj9hhhj9hM9ubj8)}(hI(struct folio *folio, unsigned short id, struct mm_struct *mm, gfp_t gfp)h](j>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hj9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9ubj)}(h h]h }(hj:hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9ubh)}(hhh]j)}(hfolioh]hfolio}(hj:hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj:modnameN classnameNjj)}j]j)}jj9sb c.mem_cgroup_swapin_charge_folioasbuh1hhj9ubj)}(h h]h }(hj1:hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9ubjr)}(hjuh]h*}(hj?:hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj9ubj)}(hfolioh]hfolio}(hjL:hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj9ubj>)}(hunsigned short idh](j)}(hunsignedh]hunsigned}(hje:hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhja:ubj)}(h h]h }(hjs:hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhja:ubj)}(hshorth]hshort}(hj:hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhja:ubj)}(h h]h }(hj:hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhja:ubj)}(hidh]hid}(hj:hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhja:ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj9ubj>)}(hstruct mm_struct *mmh](j)}(hjJ,h]hstruct}(hj:hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:ubj)}(h h]h }(hj:hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:ubh)}(hhh]j)}(h mm_structh]h mm_struct}(hj:hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj:modnameN classnameNjj)}j]j-: c.mem_cgroup_swapin_charge_folioasbuh1hhj:ubj)}(h h]h }(hj:hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:ubjr)}(hjuh]h*}(hj;hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj:ubj)}(hmmh]hmm}(hj ;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj9ubj>)}(h gfp_t gfph](h)}(hhh]j)}(hgfp_th]hgfp_t}(hj);hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&;ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj+;modnameN classnameNjj)}j]j-: c.mem_cgroup_swapin_charge_folioasbuh1hhj";ubj)}(h h]h }(hjG;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj";ubj)}(hgfph]hgfp}(hjU;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj";ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj9ubeh}(h]h ]h"]h$]h&]jjuh1j7hj9hhhj9hM9ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj9hhhj9hM9ubah}(h]j9ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj9hM9hj9hhubj4)}(hhh]jM)}(h*Charge a newly allocated folio for swapin.h]h*Charge a newly allocated folio for swapin.}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM9hj|;hhubah}(h]h ]h"]h$]h&]uh1j3hj9hhhj9hM9ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj;jHj;jIjJjKuh1hhhhjKhNhNubj)}(hXx**Parameters** ``struct folio *folio`` the folio to charge ``unsigned short id`` memory cgroup id ``struct mm_struct *mm`` mm context of the victim ``gfp_t gfp`` reclaim mode **Description** This function charges a folio allocated for swapin. Please call this before adding the folio to the swapcache. Returns 0 on success. Otherwise, an error code is returned.h](jM)}(h**Parameters**h]j)}(hj;h]h Parameters}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj;ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM=hj;ubj)}(hhh](j)}(h,``struct folio *folio`` the folio to charge h](j)}(h``struct folio *folio``h]jS)}(hj;h]hstruct folio *folio}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj;ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM:hj;ubj)}(hhh]jM)}(hthe folio to chargeh]hthe folio to charge}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj;hM:hj;ubah}(h]h ]h"]h$]h&]uh1jhj;ubeh}(h]h ]h"]h$]h&]uh1jhj;hM:hj;ubj)}(h'``unsigned short id`` memory cgroup id h](j)}(h``unsigned short id``h]jS)}(hj;h]hunsigned short id}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj;ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM;hj;ubj)}(hhh]jM)}(hmemory cgroup idh]hmemory cgroup id}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj<hM;hj<ubah}(h]h ]h"]h$]h&]uh1jhj;ubeh}(h]h ]h"]h$]h&]uh1jhj<hM;hj;ubj)}(h2``struct mm_struct *mm`` mm context of the victim h](j)}(h``struct mm_struct *mm``h]jS)}(hj2<h]hstruct mm_struct *mm}(hj4<hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj0<ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM<hj,<ubj)}(hhh]jM)}(hmm context of the victimh]hmm context of the victim}(hjK<hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjG<hM<hjH<ubah}(h]h ]h"]h$]h&]uh1jhj,<ubeh}(h]h ]h"]h$]h&]uh1jhjG<hM<hj;ubj)}(h``gfp_t gfp`` reclaim mode h](j)}(h ``gfp_t gfp``h]jS)}(hjk<h]h gfp_t gfp}(hjm<hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhji<ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM=hje<ubj)}(hhh]jM)}(h reclaim modeh]h reclaim mode}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj<hM=hj<ubah}(h]h ]h"]h$]h&]uh1jhje<ubeh}(h]h ]h"]h$]h&]uh1jhj<hM=hj;ubeh}(h]h ]h"]h$]h&]uh1jhj;ubjM)}(h**Description**h]j)}(hj<h]h Description}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj<ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM?hj;ubjM)}(hnThis function charges a folio allocated for swapin. Please call this before adding the folio to the swapcache.h]hnThis function charges a folio allocated for swapin. Please call this before adding the folio to the swapcache.}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM>hj;ubjM)}(h;Returns 0 on success. Otherwise, an error code is returned.h]h;Returns 0 on success. Otherwise, an error code is returned.}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMAhj;ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h%mem_cgroup_replace_folio (C function)c.mem_cgroup_replace_foliohNtauh1hhjKhhhNhNubh)}(hhh](h)}(hDvoid mem_cgroup_replace_folio (struct folio *old, struct folio *new)h]h)}(hCvoid mem_cgroup_replace_folio(struct folio *old, struct folio *new)h](j)}(hvoidh]hvoid}(hj<hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj<hhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMubj)}(h h]h }(hj =hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj<hhhj=hMubh)}(hmem_cgroup_replace_folioh]j)}(hmem_cgroup_replace_folioh]hmem_cgroup_replace_folio}(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj<hhhj=hMubj8)}(h&(struct folio *old, struct folio *new)h](j>)}(hstruct folio *oldh](j)}(hjJ,h]hstruct}(hj7=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3=ubj)}(h h]h }(hjD=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3=ubh)}(hhh]j)}(hfolioh]hfolio}(hjU=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjR=ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjW=modnameN classnameNjj)}j]j)}jj=sbc.mem_cgroup_replace_folioasbuh1hhj3=ubj)}(h h]h }(hju=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3=ubjr)}(hjuh]h*}(hj=hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj3=ubj)}(holdh]hold}(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3=ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj/=ubj>)}(hstruct folio *newh](j)}(hjJ,h]hstruct}(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=ubj)}(h h]h }(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=ubh)}(hhh]j)}(hfolioh]hfolio}(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj=modnameN classnameNjj)}j]jq=c.mem_cgroup_replace_folioasbuh1hhj=ubj)}(h h]h }(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=ubjr)}(hjuh]h*}(hj=hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj=ubj)}(hnewh]hnew}(hj>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj/=ubeh}(h]h ]h"]h$]h&]jjuh1j7hj<hhhj=hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj<hhhj=hMubah}(h]j<ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj=hMhj<hhubj4)}(hhh]jM)}(hCharge a folio's replacement.h]hCharge a folio’s replacement.}(hj*>hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj'>hhubah}(h]h ]h"]h$]h&]uh1j3hj<hhhj=hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjB>jHjB>jIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct folio *old`` Currently circulating folio. ``struct folio *new`` Replacement folio. **Description** Charge **new** as a replacement folio for **old**. **old** will be uncharged upon free. Both folios must be locked, **new->mapping** must be set up.h](jM)}(h**Parameters**h]j)}(hjL>h]h Parameters}(hjN>hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjJ>ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjF>ubj)}(hhh](j)}(h3``struct folio *old`` Currently circulating folio. h](j)}(h``struct folio *old``h]jS)}(hjk>h]hstruct folio *old}(hjm>hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhji>ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhje>ubj)}(hhh]jM)}(hCurrently circulating folio.h]hCurrently circulating folio.}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj>hMhj>ubah}(h]h ]h"]h$]h&]uh1jhje>ubeh}(h]h ]h"]h$]h&]uh1jhj>hMhjb>ubj)}(h)``struct folio *new`` Replacement folio. h](j)}(h``struct folio *new``h]jS)}(hj>h]hstruct folio *new}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj>ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj>ubj)}(hhh]jM)}(hReplacement folio.h]hReplacement folio.}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj>hMhj>ubah}(h]h ]h"]h$]h&]uh1jhj>ubeh}(h]h ]h"]h$]h&]uh1jhj>hMhjb>ubeh}(h]h ]h"]h$]h&]uh1jhjF>ubjM)}(h**Description**h]j)}(hj>h]h Description}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj>ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjF>ubjM)}(hWCharge **new** as a replacement folio for **old**. **old** will be uncharged upon free.h](hCharge }(hj>hhhNhNubj)}(h**new**h]hnew}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj>ubh as a replacement folio for }(hj>hhhNhNubj)}(h**old**h]hold}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj>ubh. }(hj>hhhNhNubj)}(h**old**h]hold}(hj!?hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj>ubh will be uncharged upon free.}(hj>hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjF>ubjM)}(hmapping** must be set up.h](hBoth folios must be locked, }(hj:?hhhNhNubj)}(h**new->mapping**h]h new->mapping}(hjB?hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj:?ubh must be set up.}(hj:?hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjF>ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hmem_cgroup_migrate (C function)c.mem_cgroup_migratehNtauh1hhjKhhhNhNubh)}(hhh](h)}(h>void mem_cgroup_migrate (struct folio *old, struct folio *new)h]h)}(h=void mem_cgroup_migrate(struct folio *old, struct folio *new)h](j)}(hvoidh]hvoid}(hj{?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjw?hhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM!ubj)}(h h]h }(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjw?hhhj?hM!ubh)}(hmem_cgroup_migrateh]j)}(hmem_cgroup_migrateh]hmem_cgroup_migrate}(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjw?hhhj?hM!ubj8)}(h&(struct folio *old, struct folio *new)h](j>)}(hstruct folio *oldh](j)}(hjJ,h]hstruct}(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?ubj)}(h h]h }(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?ubh)}(hhh]j)}(hfolioh]hfolio}(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj?modnameN classnameNjj)}j]j)}jj?sbc.mem_cgroup_migrateasbuh1hhj?ubj)}(h h]h }(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?ubjr)}(hjuh]h*}(hj@hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj?ubj)}(holdh]hold}(hj@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj?ubj>)}(hstruct folio *newh](j)}(hjJ,h]hstruct}(hj*@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&@ubj)}(h h]h }(hj7@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&@ubh)}(hhh]j)}(hfolioh]hfolio}(hjH@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjE@ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjJ@modnameN classnameNjj)}j]j?c.mem_cgroup_migrateasbuh1hhj&@ubj)}(h h]h }(hjf@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&@ubjr)}(hjuh]h*}(hjt@hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj&@ubj)}(hnewh]hnew}(hj@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&@ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj?ubeh}(h]h ]h"]h$]h&]jjuh1j7hjw?hhhj?hM!ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjs?hhhj?hM!ubah}(h]jn?ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj?hM!hjp?hhubj4)}(hhh]jM)}(h6Transfer the memcg data from the old to the new folio.h]h6Transfer the memcg data from the old to the new folio.}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM!hj@hhubah}(h]h ]h"]h$]h&]uh1j3hjp?hhhj?hM!ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj@jHj@jIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct folio *old`` Currently circulating folio. ``struct folio *new`` Replacement folio. **Description** Transfer the memcg data from the old folio to the new folio for migration. The old folio's data info will be cleared. The memory counters remain unchanged, unless the charge moves out of a fully reparented ancestry and has to be settled (see below). Both folios must be locked, **new->mapping** must be set up.h](jM)}(h**Parameters**h]j)}(hj@h]h Parameters}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj@ubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM%hj@ubj)}(hhh](j)}(h3``struct folio *old`` Currently circulating folio. h](j)}(h``struct folio *old``h]jS)}(hj@h]hstruct folio *old}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj@ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM"hj@ubj)}(hhh]jM)}(hCurrently circulating folio.h]hCurrently circulating folio.}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjAhM"hjAubah}(h]h ]h"]h$]h&]uh1jhj@ubeh}(h]h ]h"]h$]h&]uh1jhjAhM"hj@ubj)}(h)``struct folio *new`` Replacement folio. h](j)}(h``struct folio *new``h]jS)}(hj%Ah]hstruct folio *new}(hj'AhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj#Aubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM#hjAubj)}(hhh]jM)}(hReplacement folio.h]hReplacement folio.}(hj>AhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj:AhM#hj;Aubah}(h]h ]h"]h$]h&]uh1jhjAubeh}(h]h ]h"]h$]h&]uh1jhj:AhM#hj@ubeh}(h]h ]h"]h$]h&]uh1jhj@ubjM)}(h**Description**h]j)}(hj`Ah]h Description}(hjbAhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj^Aubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM%hj@ubjM)}(hTransfer the memcg data from the old folio to the new folio for migration. The old folio's data info will be cleared. The memory counters remain unchanged, unless the charge moves out of a fully reparented ancestry and has to be settled (see below).h]hTransfer the memcg data from the old folio to the new folio for migration. The old folio’s data info will be cleared. The memory counters remain unchanged, unless the charge moves out of a fully reparented ancestry and has to be settled (see below).}(hjvAhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM$hj@ubjM)}(hmapping** must be set up.h](hBoth folios must be locked, }(hjAhhhNhNubj)}(h**new->mapping**h]h new->mapping}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjAubh must be set up.}(hjAhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM)hj@ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h!mem_cgroup_sk_charge (C function)c.mem_cgroup_sk_chargehNtauh1hhjKhhhNhNubh)}(hhh](h)}(hXbool mem_cgroup_sk_charge (const struct sock *sk, unsigned int nr_pages, gfp_t gfp_mask)h]h)}(hWbool mem_cgroup_sk_charge(const struct sock *sk, unsigned int nr_pages, gfp_t gfp_mask)h](j)}(hjh]hbool}(hjAhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjAhhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMubj)}(h h]h }(hjAhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjAhhhjAhMubh)}(hmem_cgroup_sk_chargeh]j)}(hmem_cgroup_sk_chargeh]hmem_cgroup_sk_charge}(hjAhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjAubah}(h]h ](jjeh"]h$]h&]jjuh1hhjAhhhjAhMubj8)}(h>(const struct sock *sk, unsigned int nr_pages, gfp_t gfp_mask)h](j>)}(hconst struct sock *skh](j)}(hjh]hconst}(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjAubj)}(h h]h }(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjAubj)}(hjJ,h]hstruct}(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjAubj)}(h h]h }(hj*BhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjAubh)}(hhh]j)}(hsockh]hsock}(hj;BhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj8Bubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj=BmodnameN classnameNjj)}j]j)}jjAsbc.mem_cgroup_sk_chargeasbuh1hhjAubj)}(h h]h }(hj[BhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjAubjr)}(hjuh]h*}(hjiBhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjAubj)}(hskh]hsk}(hjvBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjAubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjAubj>)}(hunsigned int nr_pagesh](j)}(hunsignedh]hunsigned}(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubj)}(h h]h }(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubj)}(hinth]hint}(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubj)}(h h]h }(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubj)}(hnr_pagesh]hnr_pages}(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjAubj>)}(hgfp_t gfp_maskh](h)}(hhh]j)}(hgfp_th]hgfp_t}(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjBmodnameN classnameNjj)}j]jWBc.mem_cgroup_sk_chargeasbuh1hhjBubj)}(h h]h }(hjChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubj)}(hgfp_maskh]hgfp_mask}(hjChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjAubeh}(h]h ]h"]h$]h&]jjuh1j7hjAhhhjAhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjAhhhjAhMubah}(h]jAah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjAhMhjAhhubj4)}(hhh]jM)}(hcharge socket memoryh]hcharge socket memory}(hj9ChhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj6Chhubah}(h]h ]h"]h$]h&]uh1j3hjAhhhjAhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjQCjHjQCjIjJjKuh1hhhhjKhNhNubj)}(hX5**Parameters** ``const struct sock *sk`` socket in memcg to charge ``unsigned int nr_pages`` number of pages to charge ``gfp_t gfp_mask`` reclaim mode **Description** Charges **nr_pages** to **memcg**. Returns ``true`` if the charge fit within **memcg**'s configured limit, ``false`` if it doesn't.h](jM)}(h**Parameters**h]j)}(hj[Ch]h Parameters}(hj]ChhhNhNubah}(h]h ]h"]h$]h&]uh1jhjYCubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjUCubj)}(hhh](j)}(h4``const struct sock *sk`` socket in memcg to charge h](j)}(h``const struct sock *sk``h]jS)}(hjzCh]hconst struct sock *sk}(hj|ChhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjxCubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjtCubj)}(hhh]jM)}(hsocket in memcg to chargeh]hsocket in memcg to charge}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjChMhjCubah}(h]h ]h"]h$]h&]uh1jhjtCubeh}(h]h ]h"]h$]h&]uh1jhjChMhjqCubj)}(h4``unsigned int nr_pages`` number of pages to charge h](j)}(h``unsigned int nr_pages``h]jS)}(hjCh]hunsigned int nr_pages}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjCubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjCubj)}(hhh]jM)}(hnumber of pages to chargeh]hnumber of pages to charge}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjChMhjCubah}(h]h ]h"]h$]h&]uh1jhjCubeh}(h]h ]h"]h$]h&]uh1jhjChMhjqCubj)}(h ``gfp_t gfp_mask`` reclaim mode h](j)}(h``gfp_t gfp_mask``h]jS)}(hjCh]hgfp_t gfp_mask}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjCubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjCubj)}(hhh]jM)}(h reclaim modeh]h reclaim mode}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjDhMhjDubah}(h]h ]h"]h$]h&]uh1jhjCubeh}(h]h ]h"]h$]h&]uh1jhjDhMhjqCubeh}(h]h ]h"]h$]h&]uh1jhjUCubjM)}(h**Description**h]j)}(hj'Dh]h Description}(hj)DhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj%Dubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjUCubjM)}(hCharges **nr_pages** to **memcg**. Returns ``true`` if the charge fit within **memcg**'s configured limit, ``false`` if it doesn't.h](hCharges }(hj=DhhhNhNubj)}(h **nr_pages**h]hnr_pages}(hjEDhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj=Dubh to }(hj=DhhhNhNubj)}(h **memcg**h]hmemcg}(hjWDhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj=Dubh . Returns }(hj=DhhhNhNubjS)}(h``true``h]htrue}(hjiDhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj=Dubh if the charge fit within }(hj=DhhhNhNubj)}(h **memcg**h]hmemcg}(hj{DhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj=Dubh’s configured limit, }(hj=DhhhNhNubjS)}(h ``false``h]hfalse}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj=Dubh if it doesn’t.}(hj=DhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjUCubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h#mem_cgroup_sk_uncharge (C function)c.mem_cgroup_sk_unchargehNtauh1hhjKhhhNhNubh)}(hhh](h)}(hJvoid mem_cgroup_sk_uncharge (const struct sock *sk, unsigned int nr_pages)h]h)}(hIvoid mem_cgroup_sk_uncharge(const struct sock *sk, unsigned int nr_pages)h](j)}(hvoidh]hvoid}(hjDhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjDhhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMubj)}(h h]h }(hjDhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjDhhhjDhMubh)}(hmem_cgroup_sk_unchargeh]j)}(hmem_cgroup_sk_unchargeh]hmem_cgroup_sk_uncharge}(hjDhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjDubah}(h]h ](jjeh"]h$]h&]jjuh1hhjDhhhjDhMubj8)}(h.(const struct sock *sk, unsigned int nr_pages)h](j>)}(hconst struct sock *skh](j)}(hjh]hconst}(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjDubj)}(h h]h }(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjDubj)}(hjJ,h]hstruct}(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjDubj)}(h h]h }(hj+EhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjDubh)}(hhh]j)}(hsockh]hsock}(hjEmodnameN classnameNjj)}j]j)}jjDsbc.mem_cgroup_sk_unchargeasbuh1hhjDubj)}(h h]h }(hj\EhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjDubjr)}(hjuh]h*}(hjjEhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjDubj)}(hskh]hsk}(hjwEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjDubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjDubj>)}(hunsigned int nr_pagesh](j)}(hunsignedh]hunsigned}(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEubj)}(h h]h }(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEubj)}(hinth]hint}(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEubj)}(h h]h }(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEubj)}(hnr_pagesh]hnr_pages}(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjDubeh}(h]h ]h"]h$]h&]jjuh1j7hjDhhhjDhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjDhhhjDhMubah}(h]jDah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjDhMhjDhhubj4)}(hhh]jM)}(huncharge socket memoryh]huncharge socket memory}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjEhhubah}(h]h ]h"]h$]h&]uh1j3hjDhhhjDhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj FjHj FjIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``const struct sock *sk`` socket in memcg to uncharge ``unsigned int nr_pages`` number of pages to unchargeh](jM)}(h**Parameters**h]j)}(hjFh]h Parameters}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjFubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjFubj)}(hhh](j)}(h6``const struct sock *sk`` socket in memcg to uncharge h](j)}(h``const struct sock *sk``h]jS)}(hj3Fh]hconst struct sock *sk}(hj5FhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj1Fubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj-Fubj)}(hhh]jM)}(hsocket in memcg to unchargeh]hsocket in memcg to uncharge}(hjLFhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjHFhMhjIFubah}(h]h ]h"]h$]h&]uh1jhj-Fubeh}(h]h ]h"]h$]h&]uh1jhjHFhMhj*Fubj)}(h5``unsigned int nr_pages`` number of pages to unchargeh](j)}(h``unsigned int nr_pages``h]jS)}(hjlFh]hunsigned int nr_pages}(hjnFhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjjFubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjfFubj)}(hhh]jM)}(hnumber of pages to unchargeh]hnumber of pages to uncharge}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjFubah}(h]h ]h"]h$]h&]uh1jhjfFubeh}(h]h ]h"]h$]h&]uh1jhjFhMhj*Fubeh}(h]h ]h"]h$]h&]uh1jhjFubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h)__mem_cgroup_try_charge_swap (C function)c.__mem_cgroup_try_charge_swaphNtauh1hhjKhhhNhNubh)}(hhh](h)}(h6int __mem_cgroup_try_charge_swap (struct folio *folio)h]h)}(h5int __mem_cgroup_try_charge_swap(struct folio *folio)h](j)}(hinth]hint}(hjFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFhhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMjubj)}(h h]h }(hjFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFhhhjFhMjubh)}(h__mem_cgroup_try_charge_swaph]j)}(h__mem_cgroup_try_charge_swaph]h__mem_cgroup_try_charge_swap}(hjFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFubah}(h]h ](jjeh"]h$]h&]jjuh1hhjFhhhjFhMjubj8)}(h(struct folio *folio)h]j>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hjGhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFubj)}(h h]h }(hjGhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFubh)}(hhh]j)}(hfolioh]hfolio}(hj!GhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj#GmodnameN classnameNjj)}j]j)}jjFsbc.__mem_cgroup_try_charge_swapasbuh1hhjFubj)}(h h]h }(hjAGhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFubjr)}(hjuh]h*}(hjOGhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjFubj)}(hfolioh]hfolio}(hj\GhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjFubah}(h]h ]h"]h$]h&]jjuh1j7hjFhhhjFhMjubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjFhhhjFhMjubah}(h]jFah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjFhMjhjFhhubj4)}(hhh]jM)}(h#try charging swap space for a folioh]h#try charging swap space for a folio}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMjhjGhhubah}(h]h ]h"]h$]h&]uh1j3hjFhhhjFhMjubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjGjHjGjIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``struct folio *folio`` folio being added to swap **Description** Try to charge **folio**'s memcg for the swap space at folio->swap. Returns 0 on success, -ENOMEM on failure.h](jM)}(h**Parameters**h]j)}(hjGh]h Parameters}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjGubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMnhjGubj)}(hhh]j)}(h2``struct folio *folio`` folio being added to swap h](j)}(h``struct folio *folio``h]jS)}(hjGh]hstruct folio *folio}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjGubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMkhjGubj)}(hhh]jM)}(hfolio being added to swaph]hfolio being added to swap}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjGhMkhjGubah}(h]h ]h"]h$]h&]uh1jhjGubeh}(h]h ]h"]h$]h&]uh1jhjGhMkhjGubah}(h]h ]h"]h$]h&]uh1jhjGubjM)}(h**Description**h]j)}(hjHh]h Description}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjHubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMmhjGubjM)}(hBTry to charge **folio**'s memcg for the swap space at folio->swap.h](hTry to charge }(hjHhhhNhNubj)}(h **folio**h]hfolio}(hj HhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjHubh-’s memcg for the swap space at folio->swap.}(hjHhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMlhjGubjM)}(h)Returns 0 on success, -ENOMEM on failure.h]h)Returns 0 on success, -ENOMEM on failure.}(hj9HhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMnhjGubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h'__mem_cgroup_uncharge_swap (C function)c.__mem_cgroup_uncharge_swaphNtauh1hhjKhhhNhNubh)}(hhh](h)}(hJvoid __mem_cgroup_uncharge_swap (unsigned short id, unsigned int nr_pages)h]h)}(hIvoid __mem_cgroup_uncharge_swap(unsigned short id, unsigned int nr_pages)h](j)}(hvoidh]hvoid}(hjhHhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjdHhhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMubj)}(h h]h }(hjwHhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjdHhhhjvHhMubh)}(h__mem_cgroup_uncharge_swaph]j)}(h__mem_cgroup_uncharge_swaph]h__mem_cgroup_uncharge_swap}(hjHhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHubah}(h]h ](jjeh"]h$]h&]jjuh1hhjdHhhhjvHhMubj8)}(h*(unsigned short id, unsigned int nr_pages)h](j>)}(hunsigned short idh](j)}(hunsignedh]hunsigned}(hjHhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHubj)}(h h]h }(hjHhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHubj)}(hshorth]hshort}(hjHhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHubj)}(h h]h }(hjHhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHubj)}(hidh]hid}(hjHhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjHubj>)}(hunsigned int nr_pagesh](j)}(hunsignedh]hunsigned}(hjHhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHubj)}(h h]h }(hjIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHubj)}(hinth]hint}(hjIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHubj)}(h h]h }(hj IhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHubj)}(hnr_pagesh]hnr_pages}(hj.IhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjHubeh}(h]h ]h"]h$]h&]jjuh1j7hjdHhhhjvHhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj`HhhhjvHhMubah}(h]j[Hah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjvHhMhj]Hhhubj4)}(hhh]jM)}(huncharge swap spaceh]huncharge swap space}(hjXIhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjUIhhubah}(h]h ]h"]h$]h&]uh1j3hj]HhhhjvHhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjpIjHjpIjIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``unsigned short id`` cgroup id to uncharge ``unsigned int nr_pages`` the amount of swap space to unchargeh](jM)}(h**Parameters**h]j)}(hjzIh]h Parameters}(hj|IhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjxIubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjtIubj)}(hhh](j)}(h,``unsigned short id`` cgroup id to uncharge h](j)}(h``unsigned short id``h]jS)}(hjIh]hunsigned short id}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjIubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjIubj)}(hhh]jM)}(hcgroup id to unchargeh]hcgroup id to uncharge}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjIhMhjIubah}(h]h ]h"]h$]h&]uh1jhjIubeh}(h]h ]h"]h$]h&]uh1jhjIhMhjIubj)}(h>``unsigned int nr_pages`` the amount of swap space to unchargeh](j)}(h``unsigned int nr_pages``h]jS)}(hjIh]hunsigned int nr_pages}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjIubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjIubj)}(hhh]jM)}(h$the amount of swap space to unchargeh]h$the amount of swap space to uncharge}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjIubah}(h]h ]h"]h$]h&]uh1jhjIubeh}(h]h ]h"]h$]h&]uh1jhjIhMhjIubeh}(h]h ]h"]h$]h&]uh1jhjtIubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h-mem_cgroup_get_folio_swap_margin (C function)"c.mem_cgroup_get_folio_swap_marginhNtauh1hhjKhhhNhNubh)}(hhh](h)}(hAlong mem_cgroup_get_folio_swap_margin (const struct folio *folio)h]h)}(h@long mem_cgroup_get_folio_swap_margin(const struct folio *folio)h](j)}(hlongh]hlong}(hj,JhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(JhhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMubj)}(h h]h }(hj;JhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(Jhhhj:JhMubh)}(h mem_cgroup_get_folio_swap_marginh]j)}(h mem_cgroup_get_folio_swap_marginh]h mem_cgroup_get_folio_swap_margin}(hjMJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIJubah}(h]h ](jjeh"]h$]h&]jjuh1hhj(Jhhhj:JhMubj8)}(h(const struct folio *folio)h]j>)}(hconst struct folio *folioh](j)}(hjh]hconst}(hjiJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeJubj)}(h h]h }(hjvJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeJubj)}(hjJ,h]hstruct}(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeJubj)}(h h]h }(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeJubh)}(hhh]j)}(hfolioh]hfolio}(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjJmodnameN classnameNjj)}j]j)}jjOJsb"c.mem_cgroup_get_folio_swap_marginasbuh1hhjeJubj)}(h h]h }(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeJubjr)}(hjuh]h*}(hjJhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjeJubj)}(hfolioh]hfolio}(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeJubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjaJubah}(h]h ]h"]h$]h&]jjuh1j7hj(Jhhhj:JhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj$Jhhhj:JhMubah}(h]jJah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj:JhMhj!Jhhubj4)}(hhh]jM)}(hget a folio's memcg swap marginh]h!get a folio’s memcg swap margin}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjKhhubah}(h]h ]h"]h$]h&]uh1j3hj!Jhhhj:JhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjKjHjKjIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``const struct folio *folio`` folio whose memcg margin is queried **Return** Remaining chargeable pages in the folio's memcg hierarchy.h](jM)}(h**Parameters**h]j)}(hj)Kh]h Parameters}(hj+KhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj'Kubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj#Kubj)}(hhh]j)}(hB``const struct folio *folio`` folio whose memcg margin is queried h](j)}(h``const struct folio *folio``h]jS)}(hjHKh]hconst struct folio *folio}(hjJKhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjFKubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjBKubj)}(hhh]jM)}(h#folio whose memcg margin is queriedh]h#folio whose memcg margin is queried}(hjaKhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj]KhMhj^Kubah}(h]h ]h"]h$]h&]uh1jhjBKubeh}(h]h ]h"]h$]h&]uh1jhj]KhMhj?Kubah}(h]h ]h"]h$]h&]uh1jhj#KubjM)}(h **Return**h]j)}(hjKh]hReturn}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjKubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj#KubjM)}(h:Remaining chargeable pages in the folio's memcg hierarchy.h]h)}(hstruct obj_cgroup *objcgh](j)}(hjJ,h]hstruct}(hjLhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjLubj)}(h h]h }(hjLhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjLubh)}(hhh]j)}(h obj_cgrouph]h obj_cgroup}(hj"LhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjLubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj$LmodnameN classnameNjj)}j]j)}jjKsbc.obj_cgroup_may_zswapasbuh1hhjLubj)}(h h]h }(hjBLhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjLubjr)}(hjuh]h*}(hjPLhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjLubj)}(hobjcgh]hobjcg}(hj]LhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjLubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjKubah}(h]h ]h"]h$]h&]jjuh1j7hjKhhhjKhMzubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjKhhhjKhMzubah}(h]jKah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjKhMzhjKhhubj4)}(hhh]jM)}(hcheck if this cgroup can zswaph]hcheck if this cgroup can zswap}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMzhjLhhubah}(h]h ]h"]h$]h&]uh1j3hjKhhhjKhMzubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjLjHjLjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct obj_cgroup *objcg`` the object cgroup **Description** Check if the hierarchical zswap limit has been reached. This doesn't check for specific headroom, and it is not atomic either. But with zswap, the size of the allocation is only known once compression has occurred, and this optimistic pre-check avoids spending cycles on compression when there is already no room left or zswap is disabled altogether somewhere in the hierarchy.h](jM)}(h**Parameters**h]j)}(hjLh]h Parameters}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjLubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM~hjLubj)}(hhh]j)}(h/``struct obj_cgroup *objcg`` the object cgroup h](j)}(h``struct obj_cgroup *objcg``h]jS)}(hjLh]hstruct obj_cgroup *objcg}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjLubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM{hjLubj)}(hhh]jM)}(hthe object cgrouph]hthe object cgroup}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjLhM{hjLubah}(h]h ]h"]h$]h&]uh1jhjLubeh}(h]h ]h"]h$]h&]uh1jhjLhM{hjLubah}(h]h ]h"]h$]h&]uh1jhjLubjM)}(h**Description**h]j)}(hjMh]h Description}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjMubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM}hjLubjM)}(h7Check if the hierarchical zswap limit has been reached.h]h7Check if the hierarchical zswap limit has been reached.}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM|hjLubjM)}(hXAThis doesn't check for specific headroom, and it is not atomic either. But with zswap, the size of the allocation is only known once compression has occurred, and this optimistic pre-check avoids spending cycles on compression when there is already no room left or zswap is disabled altogether somewhere in the hierarchy.h]hXCThis doesn’t check for specific headroom, and it is not atomic either. But with zswap, the size of the allocation is only known once compression has occurred, and this optimistic pre-check avoids spending cycles on compression when there is already no room left or zswap is disabled altogether somewhere in the hierarchy.}(hj(MhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chM~hjLubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h$obj_cgroup_charge_zswap (C function)c.obj_cgroup_charge_zswaphNtauh1hhjKhhhNhNubh)}(hhh](h)}(hDvoid obj_cgroup_charge_zswap (struct obj_cgroup *objcg, size_t size)h]h)}(hCvoid obj_cgroup_charge_zswap(struct obj_cgroup *objcg, size_t size)h](j)}(hvoidh]hvoid}(hjWMhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSMhhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMubj)}(h h]h }(hjfMhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSMhhhjeMhMubh)}(hobj_cgroup_charge_zswaph]j)}(hobj_cgroup_charge_zswaph]hobj_cgroup_charge_zswap}(hjxMhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjtMubah}(h]h ](jjeh"]h$]h&]jjuh1hhjSMhhhjeMhMubj8)}(h'(struct obj_cgroup *objcg, size_t size)h](j>)}(hstruct obj_cgroup *objcgh](j)}(hjJ,h]hstruct}(hjMhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjMubj)}(h h]h }(hjMhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjMubh)}(hhh]j)}(h obj_cgrouph]h obj_cgroup}(hjMhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjMubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjMmodnameN classnameNjj)}j]j)}jjzMsbc.obj_cgroup_charge_zswapasbuh1hhjMubj)}(h h]h }(hjMhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjMubjr)}(hjuh]h*}(hjMhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjMubj)}(hobjcgh]hobjcg}(hjMhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjMubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjMubj>)}(h size_t sizeh](h)}(hhh]j)}(hsize_th]hsize_t}(hj NhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj NmodnameN classnameNjj)}j]jMc.obj_cgroup_charge_zswapasbuh1hhjNubj)}(h h]h }(hj'NhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubj)}(hsizeh]hsize}(hj5NhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjMubeh}(h]h ]h"]h$]h&]jjuh1j7hjSMhhhjeMhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjOMhhhjeMhMubah}(h]jJMah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjeMhMhjLMhhubj4)}(hhh]jM)}(h!charge compression backend memoryh]h!charge compression backend memory}(hj_NhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj\Nhhubah}(h]h ]h"]h$]h&]uh1j3hjLMhhhjeMhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjwNjHjwNjIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``struct obj_cgroup *objcg`` the object cgroup ``size_t size`` size of compressed object **Description** This forces the charge after obj_cgroup_may_zswap() allowed compression and storage in zswap for this cgroup to go ahead.h](jM)}(h**Parameters**h]j)}(hjNh]h Parameters}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj{Nubj)}(hhh](j)}(h/``struct obj_cgroup *objcg`` the object cgroup h](j)}(h``struct obj_cgroup *objcg``h]jS)}(hjNh]hstruct obj_cgroup *objcg}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjNubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjNubj)}(hhh]jM)}(hthe object cgrouph]hthe object cgroup}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjNhMhjNubah}(h]h ]h"]h$]h&]uh1jhjNubeh}(h]h ]h"]h$]h&]uh1jhjNhMhjNubj)}(h*``size_t size`` size of compressed object h](j)}(h``size_t size``h]jS)}(hjNh]h size_t size}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjNubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjNubj)}(hhh]jM)}(hsize of compressed objecth]hsize of compressed object}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjNhMhjNubah}(h]h ]h"]h$]h&]uh1jhjNubeh}(h]h ]h"]h$]h&]uh1jhjNhMhjNubeh}(h]h ]h"]h$]h&]uh1jhj{NubjM)}(h**Description**h]j)}(hjOh]h Description}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjOubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj{NubjM)}(hyThis forces the charge after obj_cgroup_may_zswap() allowed compression and storage in zswap for this cgroup to go ahead.h]hyThis forces the charge after obj_cgroup_may_zswap() allowed compression and storage in zswap for this cgroup to go ahead.}(hj*OhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj{Nubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h&obj_cgroup_uncharge_zswap (C function)c.obj_cgroup_uncharge_zswaphNtauh1hhjKhhhNhNubh)}(hhh](h)}(hFvoid obj_cgroup_uncharge_zswap (struct obj_cgroup *objcg, size_t size)h]h)}(hEvoid obj_cgroup_uncharge_zswap(struct obj_cgroup *objcg, size_t size)h](j)}(hvoidh]hvoid}(hjYOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjUOhhhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMubj)}(h h]h }(hjhOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjUOhhhjgOhMubh)}(hobj_cgroup_uncharge_zswaph]j)}(hobj_cgroup_uncharge_zswaph]hobj_cgroup_uncharge_zswap}(hjzOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvOubah}(h]h ](jjeh"]h$]h&]jjuh1hhjUOhhhjgOhMubj8)}(h'(struct obj_cgroup *objcg, size_t size)h](j>)}(hstruct obj_cgroup *objcgh](j)}(hjJ,h]hstruct}(hjOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjOubj)}(h h]h }(hjOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjOubh)}(hhh]j)}(h obj_cgrouph]h obj_cgroup}(hjOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjOubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjOmodnameN classnameNjj)}j]j)}jj|Osbc.obj_cgroup_uncharge_zswapasbuh1hhjOubj)}(h h]h }(hjOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjOubjr)}(hjuh]h*}(hjOhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjOubj)}(hobjcgh]hobjcg}(hjOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjOubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjOubj>)}(h size_t sizeh](h)}(hhh]j)}(hsize_th]hsize_t}(hj PhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjPubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj PmodnameN classnameNjj)}j]jOc.obj_cgroup_uncharge_zswapasbuh1hhjPubj)}(h h]h }(hj)PhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjPubj)}(hsizeh]hsize}(hj7PhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjPubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjOubeh}(h]h ]h"]h$]h&]jjuh1j7hjUOhhhjgOhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjQOhhhjgOhMubah}(h]jLOah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjgOhMhjNOhhubj4)}(hhh]jM)}(h#uncharge compression backend memoryh]h#uncharge compression backend memory}(hjaPhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj^Phhubah}(h]h ]h"]h$]h&]uh1j3hjNOhhhjgOhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjyPjHjyPjIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``struct obj_cgroup *objcg`` the object cgroup ``size_t size`` size of compressed object **Description** Uncharges zswap memory on page in.h](jM)}(h**Parameters**h]j)}(hjPh]h Parameters}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjPubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj}Pubj)}(hhh](j)}(h/``struct obj_cgroup *objcg`` the object cgroup h](j)}(h``struct obj_cgroup *objcg``h]jS)}(hjPh]hstruct obj_cgroup *objcg}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjPubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjPubj)}(hhh]jM)}(hthe object cgrouph]hthe object cgroup}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjPhMhjPubah}(h]h ]h"]h$]h&]uh1jhjPubeh}(h]h ]h"]h$]h&]uh1jhjPhMhjPubj)}(h*``size_t size`` size of compressed object h](j)}(h``size_t size``h]jS)}(hjPh]h size_t size}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjPubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhjPubj)}(hhh]jM)}(hsize of compressed objecth]hsize of compressed object}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjPhMhjPubah}(h]h ]h"]h$]h&]uh1jhjPubeh}(h]h ]h"]h$]h&]uh1jhjPhMhjPubeh}(h]h ]h"]h$]h&]uh1jhj}PubjM)}(h**Description**h]j)}(hjQh]h Description}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjQubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj}PubjM)}(h"Uncharges zswap memory on page in.h]h"Uncharges zswap memory on page in.}(hj,QhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhP/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:134: ./mm/memcontrol.chMhj}Pubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubjz)}(h0#kernel-doc:: mm/memory-tiers.c (build warnings)h]h0#kernel-doc:: mm/memory-tiers.c (build warnings)}hjBQsbah}(h]h ]h"]h$]h&]jjuh1jyhjKhhhhhKubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hshmem_recalc_inode (C function)c.shmem_recalc_inodehNtauh1hhjKhhhNhNubh)}(hhh](h)}(hIbool shmem_recalc_inode (struct inode *inode, long alloced, long swapped)h]h)}(hHbool shmem_recalc_inode(struct inode *inode, long alloced, long swapped)h](j)}(hjh]hbool}(hjiQhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeQhhhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chMubj)}(h h]h }(hjwQhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeQhhhjvQhMubh)}(hshmem_recalc_inodeh]j)}(hshmem_recalc_inodeh]hshmem_recalc_inode}(hjQhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjQubah}(h]h ](jjeh"]h$]h&]jjuh1hhjeQhhhjvQhMubj8)}(h1(struct inode *inode, long alloced, long swapped)h](j>)}(hstruct inode *inodeh](j)}(hjJ,h]hstruct}(hjQhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjQubj)}(h h]h }(hjQhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjQubh)}(hhh]j)}(hinodeh]hinode}(hjQhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjQubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjQmodnameN classnameNjj)}j]j)}jjQsbc.shmem_recalc_inodeasbuh1hhjQubj)}(h h]h }(hjQhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjQubjr)}(hjuh]h*}(hjQhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjQubj)}(hinodeh]hinode}(hjQhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjQubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjQubj>)}(h long allocedh](j)}(hlongh]hlong}(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRubj)}(h h]h }(hj%RhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRubj)}(hallocedh]halloced}(hj3RhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjQubj>)}(h long swappedh](j)}(hlongh]hlong}(hjLRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHRubj)}(h h]h }(hjZRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHRubj)}(hswappedh]hswapped}(hjhRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHRubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjQubeh}(h]h ]h"]h$]h&]jjuh1j7hjeQhhhjvQhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjaQhhhjvQhMubah}(h]j\Qah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjvQhMhj^Qhhubj4)}(hhh]jM)}(h'recalculate the block usage of an inodeh]h'recalculate the block usage of an inode}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chMhjRhhubah}(h]h ]h"]h$]h&]uh1j3hj^QhhhjvQhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjRjHjRjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct inode *inode`` inode to recalc ``long alloced`` the change in number of pages allocated to inode ``long swapped`` the change in number of pages swapped from inode **Description** We have to calculate the free blocks since the mm can drop undirtied hole pages behind our back. But normally info->alloced == inode->i_mapping->nrpages + info->swapped So mm freed is info->alloced - (inode->i_mapping->nrpages + info->swapped) **Return** true if swapped was incremented from 0, for shmem_writeout().h](jM)}(h**Parameters**h]j)}(hjRh]h Parameters}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjRubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chMhjRubj)}(hhh](j)}(h(``struct inode *inode`` inode to recalc h](j)}(h``struct inode *inode``h]jS)}(hjRh]hstruct inode *inode}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjRubah}(h]h ]h"]h$]h&]uh1jhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chMhjRubj)}(hhh]jM)}(hinode to recalch]hinode to recalc}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjRhMhjRubah}(h]h ]h"]h$]h&]uh1jhjRubeh}(h]h ]h"]h$]h&]uh1jhjRhMhjRubj)}(hB``long alloced`` the change in number of pages allocated to inode h](j)}(h``long alloced``h]jS)}(hj Sh]h long alloced}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj Subah}(h]h ]h"]h$]h&]uh1jhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chMhjSubj)}(hhh]jM)}(h0the change in number of pages allocated to inodeh]h0the change in number of pages allocated to inode}(hj%ShhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj!ShMhj"Subah}(h]h ]h"]h$]h&]uh1jhjSubeh}(h]h ]h"]h$]h&]uh1jhj!ShMhjRubj)}(hB``long swapped`` the change in number of pages swapped from inode h](j)}(h``long swapped``h]jS)}(hjESh]h long swapped}(hjGShhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjCSubah}(h]h ]h"]h$]h&]uh1jhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chMhj?Subj)}(hhh]jM)}(h0the change in number of pages swapped from inodeh]h0the change in number of pages swapped from inode}(hj^ShhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjZShMhj[Subah}(h]h ]h"]h$]h&]uh1jhj?Subeh}(h]h ]h"]h$]h&]uh1jhjZShMhjRubeh}(h]h ]h"]h$]h&]uh1jhjRubjM)}(h**Description**h]j)}(hjSh]h Description}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1jhj~Subah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chMhjRubjM)}(h`We have to calculate the free blocks since the mm can drop undirtied hole pages behind our back.h]h`We have to calculate the free blocks since the mm can drop undirtied hole pages behind our back.}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chMhjRubjM)}(hBut normally info->alloced == inode->i_mapping->nrpages + info->swapped So mm freed is info->alloced - (inode->i_mapping->nrpages + info->swapped)h]hBut normally info->alloced == inode->i_mapping->nrpages + info->swapped So mm freed is info->alloced - (inode->i_mapping->nrpages + info->swapped)}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chMhjRubjM)}(h **Return**h]j)}(hjSh]hReturn}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1jhjSubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chMhjRubjM)}(h=true if swapped was incremented from 0, for shmem_writeout().h]h=true if swapped was incremented from 0, for shmem_writeout().}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chMhjRubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hshmem_writeout (C function)c.shmem_writeouthNtauh1hhjKhhhNhNubh)}(hhh](h)}(h_int shmem_writeout (struct swap_io_ctx *ctx, struct folio *folio, struct list_head *folio_list)h]h)}(h^int shmem_writeout(struct swap_io_ctx *ctx, struct folio *folio, struct list_head *folio_list)h](j)}(hinth]hint}(hjShhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjShhhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chMubj)}(h h]h }(hj ThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjShhhj ThMubh)}(hshmem_writeouth]j)}(hshmem_writeouth]hshmem_writeout}(hjThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjTubah}(h]h ](jjeh"]h$]h&]jjuh1hhjShhhj ThMubj8)}(hL(struct swap_io_ctx *ctx, struct folio *folio, struct list_head *folio_list)h](j>)}(hstruct swap_io_ctx *ctxh](j)}(hjJ,h]hstruct}(hj8ThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4Tubj)}(h h]h }(hjEThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4Tubh)}(hhh]j)}(h swap_io_ctxh]h swap_io_ctx}(hjVThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSTubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjXTmodnameN classnameNjj)}j]j)}jjTsbc.shmem_writeoutasbuh1hhj4Tubj)}(h h]h }(hjvThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4Tubjr)}(hjuh]h*}(hjThhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj4Tubj)}(hctxh]hctx}(hjThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4Tubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj0Tubj>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hjThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjTubj)}(h h]h }(hjThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjTubh)}(hhh]j)}(hfolioh]hfolio}(hjThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjTubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjTmodnameN classnameNjj)}j]jrTc.shmem_writeoutasbuh1hhjTubj)}(h h]h }(hjThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjTubjr)}(hjuh]h*}(hjThhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjTubj)}(hfolioh]hfolio}(hjUhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjTubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj0Tubj>)}(hstruct list_head *folio_listh](j)}(hjJ,h]hstruct}(hjUhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjUubj)}(h h]h }(hj'UhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjUubh)}(hhh]j)}(h list_headh]h list_head}(hj8UhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5Uubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj:UmodnameN classnameNjj)}j]jrTc.shmem_writeoutasbuh1hhjUubj)}(h h]h }(hjVUhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjUubjr)}(hjuh]h*}(hjdUhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjUubj)}(h folio_listh]h folio_list}(hjqUhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjUubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj0Tubeh}(h]h ]h"]h$]h&]jjuh1j7hjShhhj ThMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjShhhj ThMubah}(h]jSah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj ThMhjShhubj4)}(hhh]jM)}(hWrite the folio to swaph]hWrite the folio to swap}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chMhjUhhubah}(h]h ]h"]h$]h&]uh1j3hjShhhj ThMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjUjHjUjIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``struct swap_io_ctx *ctx`` swap I/O context ``struct folio *folio`` The folio to write ``struct list_head *folio_list`` list to put back folios on split **Description** Move the folio from the page cache to the swap cache.h](jM)}(h**Parameters**h]j)}(hjUh]h Parameters}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjUubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chM hjUubj)}(hhh](j)}(h-``struct swap_io_ctx *ctx`` swap I/O context h](j)}(h``struct swap_io_ctx *ctx``h]jS)}(hjUh]hstruct swap_io_ctx *ctx}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjUubah}(h]h ]h"]h$]h&]uh1jhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chM hjUubj)}(hhh]jM)}(hswap I/O contexth]hswap I/O context}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjUhM hjUubah}(h]h ]h"]h$]h&]uh1jhjUubeh}(h]h ]h"]h$]h&]uh1jhjUhM hjUubj)}(h+``struct folio *folio`` The folio to write h](j)}(h``struct folio *folio``h]jS)}(hjVh]hstruct folio *folio}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjVubah}(h]h ]h"]h$]h&]uh1jhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chM hjVubj)}(hhh]jM)}(hThe folio to writeh]hThe folio to write}(hj.VhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj*VhM hj+Vubah}(h]h ]h"]h$]h&]uh1jhjVubeh}(h]h ]h"]h$]h&]uh1jhj*VhM hjUubj)}(hB``struct list_head *folio_list`` list to put back folios on split h](j)}(h ``struct list_head *folio_list``h]jS)}(hjNVh]hstruct list_head *folio_list}(hjPVhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjLVubah}(h]h ]h"]h$]h&]uh1jhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chM hjHVubj)}(hhh]jM)}(h list to put back folios on splith]h list to put back folios on split}(hjgVhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjcVhM hjdVubah}(h]h ]h"]h$]h&]uh1jhjHVubeh}(h]h ]h"]h$]h&]uh1jhjcVhM hjUubeh}(h]h ]h"]h$]h&]uh1jhjUubjM)}(h**Description**h]j)}(hjVh]h Description}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjVubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chM hjUubjM)}(h5Move the folio from the page cache to the swap cache.h]h5Move the folio from the page cache to the swap cache.}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chM hjUubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hshmem_get_folio (C function)c.shmem_get_foliohNtauh1hhjKhhhNhNubh)}(hhh](h)}(htint shmem_get_folio (struct inode *inode, pgoff_t index, loff_t write_end, struct folio **foliop, enum sgp_type sgp)h]h)}(hsint shmem_get_folio(struct inode *inode, pgoff_t index, loff_t write_end, struct folio **foliop, enum sgp_type sgp)h](j)}(hinth]hint}(hjVhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVhhhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chM ubj)}(h h]h }(hjVhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVhhhjVhM ubh)}(hshmem_get_folioh]j)}(hshmem_get_folioh]hshmem_get_folio}(hjVhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVubah}(h]h ](jjeh"]h$]h&]jjuh1hhjVhhhjVhM ubj8)}(h`(struct inode *inode, pgoff_t index, loff_t write_end, struct folio **foliop, enum sgp_type sgp)h](j>)}(hstruct inode *inodeh](j)}(hjJ,h]hstruct}(hj WhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjWubj)}(h h]h }(hjWhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjWubh)}(hhh]j)}(hinodeh]hinode}(hj)WhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&Wubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj+WmodnameN classnameNjj)}j]j)}jjVsbc.shmem_get_folioasbuh1hhjWubj)}(h h]h }(hjIWhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjWubjr)}(hjuh]h*}(hjWWhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjWubj)}(hinodeh]hinode}(hjdWhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjWubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjWubj>)}(h pgoff_t indexh](h)}(hhh]j)}(hpgoff_th]hpgoff_t}(hjWhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj}Wubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjWmodnameN classnameNjj)}j]jEWc.shmem_get_folioasbuh1hhjyWubj)}(h h]h }(hjWhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyWubj)}(hindexh]hindex}(hjWhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyWubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjWubj>)}(hloff_t write_endh](h)}(hhh]j)}(hloff_th]hloff_t}(hjWhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjWubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjWmodnameN classnameNjj)}j]jEWc.shmem_get_folioasbuh1hhjWubj)}(h h]h }(hjWhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjWubj)}(h write_endh]h write_end}(hjWhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjWubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjWubj>)}(hstruct folio **folioph](j)}(hjJ,h]hstruct}(hj XhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj Xubj)}(h h]h }(hjXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj Xubh)}(hhh]j)}(hfolioh]hfolio}(hj+XhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(Xubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj-XmodnameN classnameNjj)}j]jEWc.shmem_get_folioasbuh1hhj Xubj)}(h h]h }(hjIXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj Xubjr)}(hjuh]h*}(hjWXhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj Xubjr)}(hjuh]h*}(hjdXhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj Xubj)}(hfolioph]hfoliop}(hjqXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj Xubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjWubj>)}(henum sgp_type sgph](j)}(hj#!h]henum}(hjXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjXubj)}(h h]h }(hjXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjXubh)}(hhh]j)}(hsgp_typeh]hsgp_type}(hjXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjXubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjXmodnameN classnameNjj)}j]jEWc.shmem_get_folioasbuh1hhjXubj)}(h h]h }(hjXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjXubj)}(hsgph]hsgp}(hjXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjXubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjWubeh}(h]h ]h"]h$]h&]jjuh1j7hjVhhhjVhM ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjVhhhjVhM ubah}(h]jVah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjVhM hjVhhubj4)}(hhh]jM)}(hfind, and lock a shmem folio.h]hfind, and lock a shmem folio.}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chM hjXhhubah}(h]h ]h"]h$]h&]uh1j3hjVhhhjVhM ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjYjHjYjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct inode *inode`` inode to search ``pgoff_t index`` the page index. ``loff_t write_end`` end of a write, could extend inode size ``struct folio **foliop`` pointer to the folio if found ``enum sgp_type sgp`` SGP_* flags to control behavior **Description** Looks up the page cache entry at **inode** & **index**. If a folio is present, it is returned locked with an increased refcount. If the caller modifies data in the folio, it must call folio_mark_dirty() before unlocking the folio to ensure that the folio is not reclaimed. There is no need to reserve space before calling folio_mark_dirty(). When no folio is found, the behavior depends on **sgp**: - for SGP_READ, ***foliop** is ``NULL`` and 0 is returned - for SGP_NOALLOC, ***foliop** is ``NULL`` and -ENOENT is returned - for all other flags a new folio is allocated, inserted into the page cache and returned locked in **foliop**. **Context** May sleep. **Return** 0 if successful, else a negative error code.h](jM)}(h**Parameters**h]j)}(hj Yh]h Parameters}(hj"YhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjYubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chM hjYubj)}(hhh](j)}(h(``struct inode *inode`` inode to search h](j)}(h``struct inode *inode``h]jS)}(hj?Yh]hstruct inode *inode}(hjAYhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj=Yubah}(h]h ]h"]h$]h&]uh1jhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chM hj9Yubj)}(hhh]jM)}(hinode to searchh]hinode to search}(hjXYhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjTYhM hjUYubah}(h]h ]h"]h$]h&]uh1jhj9Yubeh}(h]h ]h"]h$]h&]uh1jhjTYhM hj6Yubj)}(h"``pgoff_t index`` the page index. h](j)}(h``pgoff_t index``h]jS)}(hjxYh]h pgoff_t index}(hjzYhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjvYubah}(h]h ]h"]h$]h&]uh1jhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chM hjrYubj)}(hhh]jM)}(hthe page index.h]hthe page index.W}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjYhM hjYubah}(h]h ]h"]h$]h&]uh1jhjrYubeh}(h]h ]h"]h$]h&]uh1jhjYhM hj6Yubj)}(h=``loff_t write_end`` end of a write, could extend inode size h](j)}(h``loff_t write_end``h]jS)}(hjYh]hloff_t write_end}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjYubah}(h]h ]h"]h$]h&]uh1jhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chM hjYubj)}(hhh]jM)}(h'end of a write, could extend inode sizeh]h'end of a write, could extend inode size}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjYhM hjYubah}(h]h ]h"]h$]h&]uh1jhjYubeh}(h]h ]h"]h$]h&]uh1jhjYhM hj6Yubj)}(h8``struct folio **foliop`` pointer to the folio if found h](j)}(h``struct folio **foliop``h]jS)}(hjYh]hstruct folio **foliop}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjYubah}(h]h ]h"]h$]h&]uh1jhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chM hjYubj)}(hhh]jM)}(hpointer to the folio if foundh]hpointer to the folio if found}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjYhM hjZubah}(h]h ]h"]h$]h&]uh1jhjYubeh}(h]h ]h"]h$]h&]uh1jhjYhM hj6Yubj)}(h6``enum sgp_type sgp`` SGP_* flags to control behavior h](j)}(h``enum sgp_type sgp``h]jS)}(hj#Zh]henum sgp_type sgp}(hj%ZhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj!Zubah}(h]h ]h"]h$]h&]uh1jhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chM hjZubj)}(hhh]jM)}(hSGP_* flags to control behaviorh]hSGP_* flags to control behavior}(hj)}(hconst char *nameh](j)}(hjh]hconst}(hj\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\ubj)}(h h]h }(hj\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\ubj)}(hcharh]hchar}(hj\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\ubj)}(h h]h }(hj\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\ubjr)}(hjuh]h*}(hj\hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj\ubj)}(hnameh]hname}(hj\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj\ubj>)}(h loff_t sizeh](h)}(hhh]j)}(hloff_th]hloff_t}(hj\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj\modnameN classnameNjj)}j]jH\c.shmem_kernel_file_setupasbuh1hhj\ubj)}(h h]h }(hj]hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\ubj)}(hsizeh]hsize}(hj]hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj\ubj>)}(hvma_flags_t flagsh](h)}(hhh]j)}(h vma_flags_th]h vma_flags_t}(hj/]hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,]ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj1]modnameN classnameNjj)}j]jH\c.shmem_kernel_file_setupasbuh1hhj(]ubj)}(h h]h }(hjM]hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(]ubj)}(hflagsh]hflags}(hj[]hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(]ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj\ubeh}(h]h ]h"]h$]h&]jjuh1j7hj \hhhj\hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj\hhhj\hMubah}(h]j\ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj\hMhj\hhubj4)}(hhh]jM)}(hXCget an unlinked file living in tmpfs which must be kernel internal. There will be NO LSM permission checks against the underlying inode. So users of this interface must do LSM checks at a higher layer. The users are the big_key and shm implementations. LSM checks are provided at the key or shm level rather than the inode.h]hXCget an unlinked file living in tmpfs which must be kernel internal. There will be NO LSM permission checks against the underlying inode. So users of this interface must do LSM checks at a higher layer. The users are the big_key and shm implementations. LSM checks are provided at the key or shm level rather than the inode.}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chMhj]hhubah}(h]h ]h"]h$]h&]uh1j3hj\hhhj\hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj]jHj]jIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``const char *name`` name for dentry (to be seen in /proc//maps) ``loff_t size`` size to be set for the file ``vma_flags_t flags`` VMA_NORESERVE_BIT suppresses pre-accounting of the entire object sizeh](jM)}(h**Parameters**h]j)}(hj]h]h Parameters}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj]ubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chMhj]ubj)}(hhh](j)}(hF``const char *name`` name for dentry (to be seen in /proc//maps) h](j)}(h``const char *name``h]jS)}(hj]h]hconst char *name}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj]ubah}(h]h ]h"]h$]h&]uh1jhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chMhj]ubj)}(hhh]jM)}(h0name for dentry (to be seen in /proc//maps)h]h0name for dentry (to be seen in /proc//maps)}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj]hMhj]ubah}(h]h ]h"]h$]h&]uh1jhj]ubeh}(h]h ]h"]h$]h&]uh1jhj]hMhj]ubj)}(h,``loff_t size`` size to be set for the file h](j)}(h``loff_t size``h]jS)}(hj]h]h loff_t size}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj]ubah}(h]h ]h"]h$]h&]uh1jhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chMhj]ubj)}(hhh]jM)}(hsize to be set for the fileh]hsize to be set for the file}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj^hMhj^ubah}(h]h ]h"]h$]h&]uh1jhj]ubeh}(h]h ]h"]h$]h&]uh1jhj^hMhj]ubj)}(h[``vma_flags_t flags`` VMA_NORESERVE_BIT suppresses pre-accounting of the entire object sizeh](j)}(h``vma_flags_t flags``h]jS)}(hj8^h]hvma_flags_t flags}(hj:^hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj6^ubah}(h]h ]h"]h$]h&]uh1jhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chMhj2^ubj)}(hhh]jM)}(hEVMA_NORESERVE_BIT suppresses pre-accounting of the entire object sizeh]hEVMA_NORESERVE_BIT suppresses pre-accounting of the entire object size}(hjQ^hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chMhjN^ubah}(h]h ]h"]h$]h&]uh1jhj2^ubeh}(h]h ]h"]h$]h&]uh1jhjM^hMhj]ubeh}(h]h ]h"]h$]h&]uh1jhj]ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hshmem_file_setup (C function)c.shmem_file_setuphNtauh1hhjKhhhNhNubh)}(hhh](h)}(hQstruct file * shmem_file_setup (const char *name, loff_t size, vma_flags_t flags)h]h)}(hOstruct file *shmem_file_setup(const char *name, loff_t size, vma_flags_t flags)h](j)}(hjJ,h]hstruct}(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^hhhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chMubj)}(h h]h }(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^hhhj^hMubh)}(hhh]j)}(hfileh]hfile}(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj^modnameN classnameNjj)}j]j)}jshmem_file_setupsbc.shmem_file_setupasbuh1hhj^hhhj^hMubj)}(h h]h }(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^hhhj^hMubjr)}(hjuh]h*}(hj^hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj^hhhj^hMubh)}(hshmem_file_setuph]j)}(hj^h]hshmem_file_setup}(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj^hhhj^hMubj8)}(h2(const char *name, loff_t size, vma_flags_t flags)h](j>)}(hconst char *nameh](j)}(hjh]hconst}(hj _hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj_ubj)}(h h]h }(hj_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj_ubj)}(hcharh]hchar}(hj'_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj_ubj)}(h h]h }(hj5_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj_ubjr)}(hjuh]h*}(hjC_hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj_ubj)}(hnameh]hname}(hjP_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj_ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj_ubj>)}(h loff_t sizeh](h)}(hhh]j)}(hloff_th]hloff_t}(hjl_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhji_ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjn_modnameN classnameNjj)}j]j^c.shmem_file_setupasbuh1hhje_ubj)}(h h]h }(hj_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhje_ubj)}(hsizeh]hsize}(hj_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhje_ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj_ubj>)}(hvma_flags_t flagsh](h)}(hhh]j)}(h vma_flags_th]h vma_flags_t}(hj_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj_ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj_modnameN classnameNjj)}j]j^c.shmem_file_setupasbuh1hhj_ubj)}(h h]h }(hj_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj_ubj)}(hflagsh]hflags}(hj_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj_ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj_ubeh}(h]h ]h"]h$]h&]jjuh1j7hj^hhhj^hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj^hhhj^hMubah}(h]j^ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj^hMhj^hhubj4)}(hhh]jM)}(h$get an unlinked file living in tmpfsh]h$get an unlinked file living in tmpfs}(hj `hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chMhj`hhubah}(h]h ]h"]h$]h&]uh1j3hj^hhhj^hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj"`jHj"`jIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``const char *name`` name for dentry (to be seen in /proc//maps) ``loff_t size`` size to be set for the file ``vma_flags_t flags`` VMA_NORESERVE_BIT suppresses pre-accounting of the entire object sizeh](jM)}(h**Parameters**h]j)}(hj,`h]h Parameters}(hj.`hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj*`ubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chMhj&`ubj)}(hhh](j)}(hF``const char *name`` name for dentry (to be seen in /proc//maps) h](j)}(h``const char *name``h]jS)}(hjK`h]hconst char *name}(hjM`hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjI`ubah}(h]h ]h"]h$]h&]uh1jhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chMhjE`ubj)}(hhh]jM)}(h0name for dentry (to be seen in /proc//maps)h]h0name for dentry (to be seen in /proc//maps)}(hjd`hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj``hMhja`ubah}(h]h ]h"]h$]h&]uh1jhjE`ubeh}(h]h ]h"]h$]h&]uh1jhj``hMhjB`ubj)}(h,``loff_t size`` size to be set for the file h](j)}(h``loff_t size``h]jS)}(hj`h]h loff_t size}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj`ubah}(h]h ]h"]h$]h&]uh1jhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chMhj~`ubj)}(hhh]jM)}(hsize to be set for the fileh]hsize to be set for the file}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj`hMhj`ubah}(h]h ]h"]h$]h&]uh1jhj~`ubeh}(h]h ]h"]h$]h&]uh1jhj`hMhjB`ubj)}(h[``vma_flags_t flags`` VMA_NORESERVE_BIT suppresses pre-accounting of the entire object sizeh](j)}(h``vma_flags_t flags``h]jS)}(hj`h]hvma_flags_t flags}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj`ubah}(h]h ]h"]h$]h&]uh1jhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chMhj`ubj)}(hhh]jM)}(hEVMA_NORESERVE_BIT suppresses pre-accounting of the entire object sizeh]hEVMA_NORESERVE_BIT suppresses pre-accounting of the entire object size}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chMhj`ubah}(h]h ]h"]h$]h&]uh1jhj`ubeh}(h]h ]h"]h$]h&]uh1jhj`hMhjB`ubeh}(h]h ]h"]h$]h&]uh1jhj&`ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h&shmem_file_setup_with_mnt (C function)c.shmem_file_setup_with_mnthNtauh1hhjKhhhNhNubh)}(hhh](h)}(hpstruct file * shmem_file_setup_with_mnt (struct vfsmount *mnt, const char *name, loff_t size, vma_flags_t flags)h]h)}(hnstruct file *shmem_file_setup_with_mnt(struct vfsmount *mnt, const char *name, loff_t size, vma_flags_t flags)h](j)}(hjJ,h]hstruct}(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjahhhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chMubj)}(h h]h }(hj%ahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjahhhj$ahMubh)}(hhh]j)}(hfileh]hfile}(hj6ahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3aubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj8amodnameN classnameNjj)}j]j)}jshmem_file_setup_with_mntsbc.shmem_file_setup_with_mntasbuh1hhjahhhj$ahMubj)}(h h]h }(hjWahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjahhhj$ahMubjr)}(hjuh]h*}(hjeahhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjahhhj$ahMubh)}(hshmem_file_setup_with_mnth]j)}(hjTah]hshmem_file_setup_with_mnt}(hjvahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjraubah}(h]h ](jjeh"]h$]h&]jjuh1hhjahhhj$ahMubj8)}(hH(struct vfsmount *mnt, const char *name, loff_t size, vma_flags_t flags)h](j>)}(hstruct vfsmount *mnth](j)}(hjJ,h]hstruct}(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubj)}(h h]h }(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubh)}(hhh]j)}(hvfsmounth]hvfsmount}(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjamodnameN classnameNjj)}j]jRac.shmem_file_setup_with_mntasbuh1hhjaubj)}(h h]h }(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubjr)}(hjuh]h*}(hjahhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjaubj)}(hmnth]hmnt}(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjaubj>)}(hconst char *nameh](j)}(hjh]hconst}(hjbhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubj)}(h h]h }(hjbhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubj)}(hcharh]hchar}(hjbhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubj)}(h h]h }(hj*bhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubjr)}(hjuh]h*}(hj8bhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjaubj)}(hnameh]hname}(hjEbhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjaubj>)}(h loff_t sizeh](h)}(hhh]j)}(hloff_th]hloff_t}(hjabhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^bubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjcbmodnameN classnameNjj)}j]jRac.shmem_file_setup_with_mntasbuh1hhjZbubj)}(h h]h }(hjbhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZbubj)}(hsizeh]hsize}(hjbhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZbubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjaubj>)}(hvma_flags_t flagsh](h)}(hhh]j)}(h vma_flags_th]h vma_flags_t}(hjbhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjbubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjbmodnameN classnameNjj)}j]jRac.shmem_file_setup_with_mntasbuh1hhjbubj)}(h h]h }(hjbhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjbubj)}(hflagsh]hflags}(hjbhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjbubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjaubeh}(h]h ]h"]h$]h&]jjuh1j7hjahhhj$ahMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjahhhj$ahMubah}(h]j aah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj$ahMhj ahhubj4)}(hhh]jM)}(h$get an unlinked file living in tmpfsh]h$get an unlinked file living in tmpfs}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chMhjbhhubah}(h]h ]h"]h$]h&]uh1j3hj ahhhj$ahMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjcjHjcjIjJjKuh1hhhhjKhNhNubj)}(hX0**Parameters** ``struct vfsmount *mnt`` the tmpfs mount where the file will be created ``const char *name`` name for dentry (to be seen in /proc//maps) ``loff_t size`` size to be set for the file ``vma_flags_t flags`` VMA_NORESERVE_BIT suppresses pre-accounting of the entire object sizeh](jM)}(h**Parameters**h]j)}(hj!ch]h Parameters}(hj#chhhNhNubah}(h]h ]h"]h$]h&]uh1jhjcubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chMhjcubj)}(hhh](j)}(hH``struct vfsmount *mnt`` the tmpfs mount where the file will be created h](j)}(h``struct vfsmount *mnt``h]jS)}(hj@ch]hstruct vfsmount *mnt}(hjBchhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj>cubah}(h]h ]h"]h$]h&]uh1jhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chMhj:cubj)}(hhh]jM)}(h.the tmpfs mount where the file will be createdh]h.the tmpfs mount where the file will be created}(hjYchhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjUchMhjVcubah}(h]h ]h"]h$]h&]uh1jhj:cubeh}(h]h ]h"]h$]h&]uh1jhjUchMhj7cubj)}(hF``const char *name`` name for dentry (to be seen in /proc//maps) h](j)}(h``const char *name``h]jS)}(hjych]hconst char *name}(hj{chhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjwcubah}(h]h ]h"]h$]h&]uh1jhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chMhjscubj)}(hhh]jM)}(h0name for dentry (to be seen in /proc//maps)h]h0name for dentry (to be seen in /proc//maps)}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjchMhjcubah}(h]h ]h"]h$]h&]uh1jhjscubeh}(h]h ]h"]h$]h&]uh1jhjchMhj7cubj)}(h,``loff_t size`` size to be set for the file h](j)}(h``loff_t size``h]jS)}(hjch]h loff_t size}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjcubah}(h]h ]h"]h$]h&]uh1jhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chMhjcubj)}(hhh]jM)}(hsize to be set for the fileh]hsize to be set for the file}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjchMhjcubah}(h]h ]h"]h$]h&]uh1jhjcubeh}(h]h ]h"]h$]h&]uh1jhjchMhj7cubj)}(h[``vma_flags_t flags`` VMA_NORESERVE_BIT suppresses pre-accounting of the entire object sizeh](j)}(h``vma_flags_t flags``h]jS)}(hjch]hvma_flags_t flags}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjcubah}(h]h ]h"]h$]h&]uh1jhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chMhjcubj)}(hhh]jM)}(hEVMA_NORESERVE_BIT suppresses pre-accounting of the entire object sizeh]hEVMA_NORESERVE_BIT suppresses pre-accounting of the entire object size}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chMhjdubah}(h]h ]h"]h$]h&]uh1jhjcubeh}(h]h ]h"]h$]h&]uh1jhjdhMhj7cubeh}(h]h ]h"]h$]h&]uh1jhjcubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hshmem_zero_setup (C function)c.shmem_zero_setuphNtauh1hhjKhhhNhNubh)}(hhh](h)}(h1int shmem_zero_setup (struct vm_area_struct *vma)h]h)}(h0int shmem_zero_setup(struct vm_area_struct *vma)h](j)}(hinth]hint}(hjEdhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjAdhhhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chMubj)}(h h]h }(hjTdhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjAdhhhjSdhMubh)}(hshmem_zero_setuph]j)}(hshmem_zero_setuph]hshmem_zero_setup}(hjfdhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjbdubah}(h]h ](jjeh"]h$]h&]jjuh1hhjAdhhhjSdhMubj8)}(h(struct vm_area_struct *vma)h]j>)}(hstruct vm_area_struct *vmah](j)}(hjJ,h]hstruct}(hjdhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~dubj)}(h h]h }(hjdhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~dubh)}(hhh]j)}(hvm_area_structh]hvm_area_struct}(hjdhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjdubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjdmodnameN classnameNjj)}j]j)}jjhdsbc.shmem_zero_setupasbuh1hhj~dubj)}(h h]h }(hjdhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~dubjr)}(hjuh]h*}(hjdhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj~dubj)}(hvmah]hvma}(hjdhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~dubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjzdubah}(h]h ]h"]h$]h&]jjuh1j7hjAdhhhjSdhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj=dhhhjSdhMubah}(h]j8dah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjSdhMhj:dhhubj4)}(hhh]jM)}(h setup a shared anonymous mappingh]h setup a shared anonymous mapping}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chMhjehhubah}(h]h ]h"]h$]h&]uh1j3hj:dhhhjSdhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjejHjejIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``struct vm_area_struct *vma`` the vma to be mmapped is prepared by do_mmap **Return** 0 on success, or errorh](jM)}(h**Parameters**h]j)}(hj'eh]h Parameters}(hj)ehhhNhNubah}(h]h ]h"]h$]h&]uh1jhj%eubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chMhj!eubj)}(hhh]j)}(hL``struct vm_area_struct *vma`` the vma to be mmapped is prepared by do_mmap h](j)}(h``struct vm_area_struct *vma``h]jS)}(hjFeh]hstruct vm_area_struct *vma}(hjHehhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjDeubah}(h]h ]h"]h$]h&]uh1jhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chMhj@eubj)}(hhh]jM)}(h,the vma to be mmapped is prepared by do_mmaph]h,the vma to be mmapped is prepared by do_mmap}(hj_ehhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj[ehMhj\eubah}(h]h ]h"]h$]h&]uh1jhj@eubeh}(h]h ]h"]h$]h&]uh1jhj[ehMhj=eubah}(h]h ]h"]h$]h&]uh1jhj!eubjM)}(h **Return**h]j)}(hjeh]hReturn}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1jhjeubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chMhj!eubjM)}(h0 on success, or errorh]h0 on success, or error}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chMhj!eubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h"shmem_zero_setup_desc (C function)c.shmem_zero_setup_deschNtauh1hhjKhhhNhNubh)}(hhh](h)}(h5int shmem_zero_setup_desc (struct vm_area_desc *desc)h]h)}(h4int shmem_zero_setup_desc(struct vm_area_desc *desc)h](j)}(hinth]hint}(hjehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjehhhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chMubj)}(h h]h }(hjehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjehhhjehMubh)}(hshmem_zero_setup_desch]j)}(hshmem_zero_setup_desch]hshmem_zero_setup_desc}(hjehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubah}(h]h ](jjeh"]h$]h&]jjuh1hhjehhhjehMubj8)}(h(struct vm_area_desc *desc)h]j>)}(hstruct vm_area_desc *desch](j)}(hjJ,h]hstruct}(hjfhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubj)}(h h]h }(hjfhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubh)}(hhh]j)}(h vm_area_desch]h vm_area_desc}(hj!fhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjfubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj#fmodnameN classnameNjj)}j]j)}jjesbc.shmem_zero_setup_descasbuh1hhjeubj)}(h h]h }(hjAfhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubjr)}(hjuh]h*}(hjOfhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjeubj)}(hdesch]hdesc}(hj\fhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjeubah}(h]h ]h"]h$]h&]jjuh1j7hjehhhjehMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjehhhjehMubah}(h]jeah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjehMhjehhubj4)}(hhh]jM)}(hKsame as shmem_zero_setup, but determined by VMA descriptor for convenience.h]hKsame as shmem_zero_setup, but determined by VMA descriptor for convenience.}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chMhjfhhubah}(h]h ]h"]h$]h&]uh1j3hjehhhjehMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjfjHjfjIjJjKuh1hhhhjKhNhNubj)}(ha**Parameters** ``struct vm_area_desc *desc`` Describes VMA **Return** 0 on success, or errorh](jM)}(h**Parameters**h]j)}(hjfh]h Parameters}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjfubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chMhjfubj)}(hhh]j)}(h,``struct vm_area_desc *desc`` Describes VMA h](j)}(h``struct vm_area_desc *desc``h]jS)}(hjfh]hstruct vm_area_desc *desc}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjfubah}(h]h ]h"]h$]h&]uh1jhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chMhjfubj)}(hhh]jM)}(h Describes VMAh]h Describes VMA}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjfhMhjfubah}(h]h ]h"]h$]h&]uh1jhjfubeh}(h]h ]h"]h$]h&]uh1jhjfhMhjfubah}(h]h ]h"]h$]h&]uh1jhjfubjM)}(h **Return**h]j)}(hjgh]hReturn}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1jhjgubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chMhjfubjM)}(h0 on success, or errorh]h0 on success, or error}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chMhjfubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h!shmem_read_folio_gfp (C function)c.shmem_read_folio_gfphNtauh1hhjKhhhNhNubh)}(hhh](h)}(h]struct folio * shmem_read_folio_gfp (struct address_space *mapping, pgoff_t index, gfp_t gfp)h]h)}(h[struct folio *shmem_read_folio_gfp(struct address_space *mapping, pgoff_t index, gfp_t gfp)h](j)}(hjJ,h]hstruct}(hjGghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCghhhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chMubj)}(h h]h }(hjUghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCghhhjTghMubh)}(hhh]j)}(hfolioh]hfolio}(hjfghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjcgubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjhgmodnameN classnameNjj)}j]j)}jshmem_read_folio_gfpsbc.shmem_read_folio_gfpasbuh1hhjCghhhjTghMubj)}(h h]h }(hjghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCghhhjTghMubjr)}(hjuh]h*}(hjghhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjCghhhjTghMubh)}(hshmem_read_folio_gfph]j)}(hjgh]hshmem_read_folio_gfp}(hjghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubah}(h]h ](jjeh"]h$]h&]jjuh1hhjCghhhjTghMubj8)}(h9(struct address_space *mapping, pgoff_t index, gfp_t gfp)h](j>)}(hstruct address_space *mappingh](j)}(hjJ,h]hstruct}(hjghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubj)}(h h]h }(hjghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubh)}(hhh]j)}(h address_spaceh]h address_space}(hjghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjgmodnameN classnameNjj)}j]jgc.shmem_read_folio_gfpasbuh1hhjgubj)}(h h]h }(hjghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubjr)}(hjuh]h*}(hj hhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjgubj)}(hmappingh]hmapping}(hjhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjgubj>)}(h pgoff_t indexh](h)}(hhh]j)}(hpgoff_th]hpgoff_t}(hj4hhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj1hubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj6hmodnameN classnameNjj)}j]jgc.shmem_read_folio_gfpasbuh1hhj-hubj)}(h h]h }(hjRhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-hubj)}(hindexh]hindex}(hj`hhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-hubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjgubj>)}(h gfp_t gfph](h)}(hhh]j)}(hgfp_th]hgfp_t}(hj|hhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyhubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj~hmodnameN classnameNjj)}j]jgc.shmem_read_folio_gfpasbuh1hhjuhubj)}(h h]h }(hjhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjuhubj)}(hgfph]hgfp}(hjhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjuhubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjgubeh}(h]h ]h"]h$]h&]jjuh1j7hjCghhhjTghMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj?ghhhjTghMubah}(h]j:gah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjTghMhjread_folio() method: which does not suit tmpfs, since it may have pages in swapcache, and needs to find those for itself; although drivers/gpu/drm i915 and ttm rely upon this support. i915_gem_object_get_pages_gtt() mixes __GFP_NORETRY | __GFP_NOWARN in with the mapping_gfp_mask(), to avoid OOMing the machine unnecessarily.h](jM)}(h**Parameters**h]j)}(hjhh]h Parameters}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjhubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chMhjhubj)}(hhh](j)}(h<``struct address_space *mapping`` the folio's address_space h](j)}(h!``struct address_space *mapping``h]jS)}(hjih]hstruct address_space *mapping}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjiubah}(h]h ]h"]h$]h&]uh1jhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chMhj iubj)}(hhh]jM)}(hthe folio's address_spaceh]hthe folio’s address_space}(hj,ihhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj(ihMhj)iubah}(h]h ]h"]h$]h&]uh1jhj iubeh}(h]h ]h"]h$]h&]uh1jhj(ihMhj iubj)}(h"``pgoff_t index`` the folio index h](j)}(h``pgoff_t index``h]jS)}(hjLih]h pgoff_t index}(hjNihhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjJiubah}(h]h ]h"]h$]h&]uh1jhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chMhjFiubj)}(hhh]jM)}(hthe folio indexh]hthe folio index}(hjeihhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjaihMhjbiubah}(h]h ]h"]h$]h&]uh1jhjFiubeh}(h]h ]h"]h$]h&]uh1jhjaihMhj iubj)}(h<``gfp_t gfp`` the page allocator flags to use if allocating h](j)}(h ``gfp_t gfp``h]jS)}(hjih]h gfp_t gfp}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjiubah}(h]h ]h"]h$]h&]uh1jhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chMhjiubj)}(hhh]jM)}(h-the page allocator flags to use if allocatingh]h-the page allocator flags to use if allocating}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjihMhjiubah}(h]h ]h"]h$]h&]uh1jhjiubeh}(h]h ]h"]h$]h&]uh1jhjihMhj iubeh}(h]h ]h"]h$]h&]uh1jhjhubjM)}(h**Description**h]j)}(hjih]h Description}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1jhjiubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chMhjhubjM)}(hXiThis behaves as a tmpfs "read_cache_page_gfp(mapping, index, gfp)", with any new page allocations done using the specified allocation flags. But read_cache_page_gfp() uses the ->read_folio() method: which does not suit tmpfs, since it may have pages in swapcache, and needs to find those for itself; although drivers/gpu/drm i915 and ttm rely upon this support.h]hXmThis behaves as a tmpfs “read_cache_page_gfp(mapping, index, gfp)”, with any new page allocations done using the specified allocation flags. But read_cache_page_gfp() uses the ->read_folio() method: which does not suit tmpfs, since it may have pages in swapcache, and needs to find those for itself; although drivers/gpu/drm i915 and ttm rely upon this support.}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chMhjhubjM)}(hi915_gem_object_get_pages_gtt() mixes __GFP_NORETRY | __GFP_NOWARN in with the mapping_gfp_mask(), to avoid OOMing the machine unnecessarily.h]hi915_gem_object_get_pages_gtt() mixes __GFP_NORETRY | __GFP_NOWARN in with the mapping_gfp_mask(), to avoid OOMing the machine unnecessarily.}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1jLhK/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:136: ./mm/shmem.chMhjhubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h$migrate_vma_split_folio (C function)c.migrate_vma_split_foliohNtauh1hhjKhhhNhNubh)}(hhh](h)}(hJint migrate_vma_split_folio (struct folio *folio, struct page *fault_page)h]h)}(hIint migrate_vma_split_folio(struct folio *folio, struct page *fault_page)h](j)}(hinth]hint}(hjjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjjhhhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:137: ./mm/migrate_device.chKLubj)}(h h]h }(hj#jhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjjhhhj"jhKLubh)}(hmigrate_vma_split_folioh]j)}(hmigrate_vma_split_folioh]hmigrate_vma_split_folio}(hj5jhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj1jubah}(h]h ](jjeh"]h$]h&]jjuh1hhjjhhhj"jhKLubj8)}(h.(struct folio *folio, struct page *fault_page)h](j>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hjQjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjMjubj)}(h h]h }(hj^jhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjMjubh)}(hhh]j)}(hfolioh]hfolio}(hjojhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjljubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjqjmodnameN classnameNjj)}j]j)}jj7jsbc.migrate_vma_split_folioasbuh1hhjMjubj)}(h h]h }(hjjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjMjubjr)}(hjuh]h*}(hjjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjMjubj)}(hfolioh]hfolio}(hjjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjMjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjIjubj>)}(hstruct page *fault_pageh](j)}(hjJ,h]hstruct}(hjjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjjubj)}(h h]h }(hjjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjjubh)}(hhh]j)}(hpageh]hpage}(hjjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjjmodnameN classnameNjj)}j]jjc.migrate_vma_split_folioasbuh1hhjjubj)}(h h]h }(hjjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjjubjr)}(hjuh]h*}(hj khhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjjubj)}(h fault_pageh]h fault_page}(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjIjubeh}(h]h ]h"]h$]h&]jjuh1j7hjjhhhj"jhKLubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj jhhhj"jhKLubah}(h]jjah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj"jhKLhj jhhubj4)}(hhh]jM)}(h$Helper function to split a THP folioh]h$Helper function to split a THP folio}(hjDkhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:137: ./mm/migrate_device.chKLhjAkhhubah}(h]h ]h"]h$]h&]uh1j3hj jhhhj"jhKLubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj\kjHj\kjIjJjKuh1hhhhjKhNhNubj)}(hX<**Parameters** ``struct folio *folio`` the folio to split ``struct page *fault_page`` struct page associated with the fault if any **Description** If **folio** is not the folio containing **fault_page**, the caller must hold a reference on **folio**. The helper consumes that reference. Returns 0 on successh](jM)}(h**Parameters**h]j)}(hjfkh]h Parameters}(hjhkhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjdkubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:137: ./mm/migrate_device.chKPhj`kubj)}(hhh](j)}(h+``struct folio *folio`` the folio to split h](j)}(h``struct folio *folio``h]jS)}(hjkh]hstruct folio *folio}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjkubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:137: ./mm/migrate_device.chKMhjkubj)}(hhh]jM)}(hthe folio to splith]hthe folio to split}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjkhKMhjkubah}(h]h ]h"]h$]h&]uh1jhjkubeh}(h]h ]h"]h$]h&]uh1jhjkhKMhj|kubj)}(hI``struct page *fault_page`` struct page associated with the fault if any h](j)}(h``struct page *fault_page``h]jS)}(hjkh]hstruct page *fault_page}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjkubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:137: ./mm/migrate_device.chKNhjkubj)}(hhh]jM)}(h,struct page associated with the fault if anyh]h,struct page associated with the fault if any}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjkhKNhjkubah}(h]h ]h"]h$]h&]uh1jhjkubeh}(h]h ]h"]h$]h&]uh1jhjkhKNhj|kubeh}(h]h ]h"]h$]h&]uh1jhj`kubjM)}(h**Description**h]j)}(hjkh]h Description}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjkubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:137: ./mm/migrate_device.chKPhj`kubjM)}(hIf **folio** is not the folio containing **fault_page**, the caller must hold a reference on **folio**. The helper consumes that reference.h](hIf }(hjlhhhNhNubj)}(h **folio**h]hfolio}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjlubh is not the folio containing }(hjlhhhNhNubj)}(h**fault_page**h]h fault_page}(hj)lhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjlubh&, the caller must hold a reference on }(hjlhhhNhNubj)}(h **folio**h]hfolio}(hj;lhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjlubh%. The helper consumes that reference.}(hjlhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:137: ./mm/migrate_device.chKOhj`kubjM)}(hReturns 0 on successh]hReturns 0 on success}(hjTlhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:137: ./mm/migrate_device.chKRhj`kubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hmigrate_vma_setup (C function)c.migrate_vma_setuphNtauh1hhjKhhhNhNubh)}(hhh](h)}(h0int migrate_vma_setup (struct migrate_vma *args)h]h)}(h/int migrate_vma_setup(struct migrate_vma *args)h](j)}(hinth]hint}(hjlhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjlhhhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:137: ./mm/migrate_device.chMubj)}(h h]h }(hjlhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjlhhhjlhMubh)}(hmigrate_vma_setuph]j)}(hmigrate_vma_setuph]hmigrate_vma_setup}(hjlhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjlubah}(h]h ](jjeh"]h$]h&]jjuh1hhjlhhhjlhMubj8)}(h(struct migrate_vma *args)h]j>)}(hstruct migrate_vma *argsh](j)}(hjJ,h]hstruct}(hjlhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjlubj)}(h h]h }(hjlhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjlubh)}(hhh]j)}(h migrate_vmah]h migrate_vma}(hjlhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjlubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjlmodnameN classnameNjj)}j]j)}jjlsbc.migrate_vma_setupasbuh1hhjlubj)}(h h]h }(hjlhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjlubjr)}(hjuh]h*}(hj mhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjlubj)}(hargsh]hargs}(hjmhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjlubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjlubah}(h]h ]h"]h$]h&]jjuh1j7hjlhhhjlhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj{lhhhjlhMubah}(h]jvlah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjlhMhjxlhhubj4)}(hhh]jM)}(h$prepare to migrate a range of memoryh]h$prepare to migrate a range of memory}(hjCmhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:137: ./mm/migrate_device.chMhj@mhhubah}(h]h ]h"]h$]h&]uh1j3hjxlhhhjlhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj[mjHj[mjIjJjKuh1hhhhjKhNhNubj)}(hX **Parameters** ``struct migrate_vma *args`` contains the vma, start, and pfns arrays for the migration **Return** negative errno on failures, 0 when 0 or more pages were migrated without an error. **Description** Prepare to migrate a range of memory virtual address range by collecting all the pages backing each virtual address in the range, saving them inside the src array. Then lock those pages and unmap them. Once the pages are locked and unmapped, check whether each page is pinned or not. Pages that aren't pinned have the MIGRATE_PFN_MIGRATE flag set (by this function) in the corresponding src array entry. Then restores any pages that are pinned, by remapping and unlocking those pages. The caller should then allocate destination memory and copy source memory to it for all those entries (ie with MIGRATE_PFN_VALID and MIGRATE_PFN_MIGRATE flag set). Once these are allocated and copied, the caller must update each corresponding entry in the dst array with the pfn value of the destination page and with MIGRATE_PFN_VALID. Destination pages must be locked via lock_page(). Note that the caller does not have to migrate all the pages that are marked with MIGRATE_PFN_MIGRATE flag in src array unless this is a migration from device memory to system memory. If the caller cannot migrate a device page back to system memory, then it must return VM_FAULT_SIGBUS, which has severe consequences for the userspace process, so it must be avoided if at all possible. For empty entries inside CPU page table (pte_none() or pmd_none() is true) we do set MIGRATE_PFN_MIGRATE flag inside the corresponding source array thus allowing the caller to allocate device memory for those unbacked virtual addresses. For this the caller simply has to allocate device memory and properly set the destination entry like for regular migration. Note that this can still fail, and thus inside the device driver you must check if the migration was successful for those entries after calling migrate_vma_pages(), just like for regular migration. After that, the callers must call migrate_vma_pages() to go over each entry in the src array that has the MIGRATE_PFN_VALID and MIGRATE_PFN_MIGRATE flag set. If the corresponding entry in dst array has MIGRATE_PFN_VALID flag set, then migrate_vma_pages() to migrate struct page information from the source struct page to the destination struct page. If it fails to migrate the struct page information, then it clears the MIGRATE_PFN_MIGRATE flag in the src array. At this point all successfully migrated pages have an entry in the src array with MIGRATE_PFN_VALID and MIGRATE_PFN_MIGRATE flag set and the dst array entry with MIGRATE_PFN_VALID flag set. Once migrate_vma_pages() returns the caller may inspect which pages were successfully migrated, and which were not. Successfully migrated pages will have the MIGRATE_PFN_MIGRATE flag set for their src array entry. It is safe to update device page table after migrate_vma_pages() because both destination and source page are still locked, and the mmap_lock is held in read mode (hence no one can unmap the range being migrated). Once the caller is done cleaning up things and updating its page table (if it chose to do so, this is not an obligation) it finally calls migrate_vma_finalize() to update the CPU page table to point to new pages for successfully migrated pages or otherwise restore the CPU page table to point to the original source pages.h](jM)}(h**Parameters**h]j)}(hjemh]h Parameters}(hjgmhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjcmubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:137: ./mm/migrate_device.chMhj_mubj)}(hhh]j)}(hX``struct migrate_vma *args`` contains the vma, start, and pfns arrays for the migration h](j)}(h``struct migrate_vma *args``h]jS)}(hjmh]hstruct migrate_vma *args}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjmubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:137: ./mm/migrate_device.chMhj~mubj)}(hhh]jM)}(h:contains the vma, start, and pfns arrays for the migrationh]h:contains the vma, start, and pfns arrays for the migration}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjmhMhjmubah}(h]h ]h"]h$]h&]uh1jhj~mubeh}(h]h ]h"]h$]h&]uh1jhjmhMhj{mubah}(h]h ]h"]h$]h&]uh1jhj_mubjM)}(h **Return**h]j)}(hjmh]hReturn}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjmubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:137: ./mm/migrate_device.chMhj_mubjM)}(hRnegative errno on failures, 0 when 0 or more pages were migrated without an error.h]hRnegative errno on failures, 0 when 0 or more pages were migrated without an error.}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:137: ./mm/migrate_device.chMhj_mubjM)}(h**Description**h]j)}(hjmh]h Description}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjmubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:137: ./mm/migrate_device.chMhj_mubjM)}(hXPrepare to migrate a range of memory virtual address range by collecting all the pages backing each virtual address in the range, saving them inside the src array. Then lock those pages and unmap them. Once the pages are locked and unmapped, check whether each page is pinned or not. Pages that aren't pinned have the MIGRATE_PFN_MIGRATE flag set (by this function) in the corresponding src array entry. Then restores any pages that are pinned, by remapping and unlocking those pages.h]hXPrepare to migrate a range of memory virtual address range by collecting all the pages backing each virtual address in the range, saving them inside the src array. Then lock those pages and unmap them. Once the pages are locked and unmapped, check whether each page is pinned or not. Pages that aren’t pinned have the MIGRATE_PFN_MIGRATE flag set (by this function) in the corresponding src array entry. Then restores any pages that are pinned, by remapping and unlocking those pages.}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:137: ./mm/migrate_device.chMhj_mubjM)}(hXThe caller should then allocate destination memory and copy source memory to it for all those entries (ie with MIGRATE_PFN_VALID and MIGRATE_PFN_MIGRATE flag set). Once these are allocated and copied, the caller must update each corresponding entry in the dst array with the pfn value of the destination page and with MIGRATE_PFN_VALID. Destination pages must be locked via lock_page().h]hXThe caller should then allocate destination memory and copy source memory to it for all those entries (ie with MIGRATE_PFN_VALID and MIGRATE_PFN_MIGRATE flag set). Once these are allocated and copied, the caller must update each corresponding entry in the dst array with the pfn value of the destination page and with MIGRATE_PFN_VALID. Destination pages must be locked via lock_page().'}(hj nhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:137: ./mm/migrate_device.chMhj_mubjM)}(hXNote that the caller does not have to migrate all the pages that are marked with MIGRATE_PFN_MIGRATE flag in src array unless this is a migration from device memory to system memory. If the caller cannot migrate a device page back to system memory, then it must return VM_FAULT_SIGBUS, which has severe consequences for the userspace process, so it must be avoided if at all possible.h]hXNote that the caller does not have to migrate all the pages that are marked with MIGRATE_PFN_MIGRATE flag in src array unless this is a migration from device memory to system memory. If the caller cannot migrate a device page back to system memory, then it must return VM_FAULT_SIGBUS, which has severe consequences for the userspace process, so it must be avoided if at all possible.}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:137: ./mm/migrate_device.chMhj_mubjM)}(hX0For empty entries inside CPU page table (pte_none() or pmd_none() is true) we do set MIGRATE_PFN_MIGRATE flag inside the corresponding source array thus allowing the caller to allocate device memory for those unbacked virtual addresses. For this the caller simply has to allocate device memory and properly set the destination entry like for regular migration. Note that this can still fail, and thus inside the device driver you must check if the migration was successful for those entries after calling migrate_vma_pages(), just like for regular migration.h]hX0For empty entries inside CPU page table (pte_none() or pmd_none() is true) we do set MIGRATE_PFN_MIGRATE flag inside the corresponding source array thus allowing the caller to allocate device memory for those unbacked virtual addresses. For this the caller simply has to allocate device memory and properly set the destination entry like for regular migration. Note that this can still fail, and thus inside the device driver you must check if the migration was successful for those entries after calling migrate_vma_pages(), just like for regular migration.}(hj)nhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:137: ./mm/migrate_device.chMhj_mubjM)}(hXAfter that, the callers must call migrate_vma_pages() to go over each entry in the src array that has the MIGRATE_PFN_VALID and MIGRATE_PFN_MIGRATE flag set. If the corresponding entry in dst array has MIGRATE_PFN_VALID flag set, then migrate_vma_pages() to migrate struct page information from the source struct page to the destination struct page. If it fails to migrate the struct page information, then it clears the MIGRATE_PFN_MIGRATE flag in the src array.h]hXAfter that, the callers must call migrate_vma_pages() to go over each entry in the src array that has the MIGRATE_PFN_VALID and MIGRATE_PFN_MIGRATE flag set. If the corresponding entry in dst array has MIGRATE_PFN_VALID flag set, then migrate_vma_pages() to migrate struct page information from the source struct page to the destination struct page. If it fails to migrate the struct page information, then it clears the MIGRATE_PFN_MIGRATE flag in the src array.}(hj8nhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:137: ./mm/migrate_device.chMhj_mubjM)}(hAt this point all successfully migrated pages have an entry in the src array with MIGRATE_PFN_VALID and MIGRATE_PFN_MIGRATE flag set and the dst array entry with MIGRATE_PFN_VALID flag set.h]hAt this point all successfully migrated pages have an entry in the src array with MIGRATE_PFN_VALID and MIGRATE_PFN_MIGRATE flag set and the dst array entry with MIGRATE_PFN_VALID flag set.}(hjGnhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:137: ./mm/migrate_device.chMhj_mubjM)}(hOnce migrate_vma_pages() returns the caller may inspect which pages were successfully migrated, and which were not. Successfully migrated pages will have the MIGRATE_PFN_MIGRATE flag set for their src array entry.h]hOnce migrate_vma_pages() returns the caller may inspect which pages were successfully migrated, and which were not. Successfully migrated pages will have the MIGRATE_PFN_MIGRATE flag set for their src array entry.}(hjVnhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:137: ./mm/migrate_device.chMhj_mubjM)}(hIt is safe to update device page table after migrate_vma_pages() because both destination and source page are still locked, and the mmap_lock is held in read mode (hence no one can unmap the range being migrated).h]hIt is safe to update device page table after migrate_vma_pages() because both destination and source page are still locked, and the mmap_lock is held in read mode (hence no one can unmap the range being migrated).}(hjenhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:137: ./mm/migrate_device.chMhj_mubjM)}(hXBOnce the caller is done cleaning up things and updating its page table (if it chose to do so, this is not an obligation) it finally calls migrate_vma_finalize() to update the CPU page table to point to new pages for successfully migrated pages or otherwise restore the CPU page table to point to the original source pages.h]hXBOnce the caller is done cleaning up things and updating its page table (if it chose to do so, this is not an obligation) it finally calls migrate_vma_finalize() to update the CPU page table to point to new pages for successfully migrated pages or otherwise restore the CPU page table to point to the original source pages.}(hjtnhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:137: ./mm/migrate_device.chMhj_mubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h-migrate_vma_insert_huge_pmd_page (C function)"c.migrate_vma_insert_huge_pmd_pagehNtauh1hhjKhhhNhNubh)}(hhh](h)}(hint migrate_vma_insert_huge_pmd_page (struct migrate_vma *migrate, unsigned long addr, struct page *page, unsigned long *src, pmd_t *pmdp)h]h)}(hint migrate_vma_insert_huge_pmd_page(struct migrate_vma *migrate, unsigned long addr, struct page *page, unsigned long *src, pmd_t *pmdp)h](j)}(hinth]hint}(hjnhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnhhhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:137: ./mm/migrate_device.chMubj)}(h h]h }(hjnhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnhhhjnhMubh)}(h migrate_vma_insert_huge_pmd_pageh]j)}(h migrate_vma_insert_huge_pmd_pageh]h migrate_vma_insert_huge_pmd_page}(hjnhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnubah}(h]h ](jjeh"]h$]h&]jjuh1hhjnhhhjnhMubj8)}(he(struct migrate_vma *migrate, unsigned long addr, struct page *page, unsigned long *src, pmd_t *pmdp)h](j>)}(hstruct migrate_vma *migrateh](j)}(hjJ,h]hstruct}(hjnhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnubj)}(h h]h }(hjnhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnubh)}(hhh]j)}(h migrate_vmah]h migrate_vma}(hjnhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjomodnameN classnameNjj)}j]j)}jjnsb"c.migrate_vma_insert_huge_pmd_pageasbuh1hhjnubj)}(h h]h }(hjohhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnubjr)}(hjuh]h*}(hj,ohhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjnubj)}(hmigrateh]hmigrate}(hj9ohhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjnubj>)}(hunsigned long addrh](j)}(hunsignedh]hunsigned}(hjRohhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNoubj)}(h h]h }(hj`ohhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNoubj)}(hlongh]hlong}(hjnohhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNoubj)}(h h]h }(hj|ohhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNoubj)}(haddrh]haddr}(hjohhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNoubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjnubj>)}(hstruct page *pageh](j)}(hjJ,h]hstruct}(hjohhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjoubj)}(h h]h }(hjohhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjoubh)}(hhh]j)}(hpageh]hpage}(hjohhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjoubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjomodnameN classnameNjj)}j]jo"c.migrate_vma_insert_huge_pmd_pageasbuh1hhjoubj)}(h h]h }(hjohhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjoubjr)}(hjuh]h*}(hjohhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjoubj)}(hpageh]hpage}(hjohhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjoubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjnubj>)}(hunsigned long *srch](j)}(hunsignedh]hunsigned}(hjphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpubj)}(h h]h }(hj!phhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpubj)}(hlongh]hlong}(hj/phhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpubj)}(h h]h }(hj=phhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpubjr)}(hjuh]h*}(hjKphhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjpubj)}(hsrch]hsrc}(hjXphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjnubj>)}(h pmd_t *pmdph](h)}(hhh]j)}(hpmd_th]hpmd_t}(hjtphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjqpubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjvpmodnameN classnameNjj)}j]jo"c.migrate_vma_insert_huge_pmd_pageasbuh1hhjmpubj)}(h h]h }(hjphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmpubjr)}(hjuh]h*}(hjphhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjmpubj)}(hpmdph]hpmdp}(hjphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmpubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjnubeh}(h]h ]h"]h$]h&]jjuh1j7hjnhhhjnhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjnhhhjnhMubah}(h]jnah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjnhMhjnhhubj4)}(hhh]jM)}(hInsert a huge folio into **migrate->vma->vm_mm** at **addr**. folio is already allocated as a part of the migration process with large page.h](hInsert a huge folio into }(hjphhhNhNubj)}(h**migrate->vma->vm_mm**h]hmigrate->vma->vm_mm}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1jhjpubh at }(hjphhhNhNubj)}(h**addr**h]haddr}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1jhjpubhP. folio is already allocated as a part of the migration process with large page.}(hjphhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:137: ./mm/migrate_device.chMhjphhubah}(h]h ]h"]h$]h&]uh1j3hjnhhhjnhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjqjHjqjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct migrate_vma *migrate`` migrate_vma arguments ``unsigned long addr`` address where the folio will be inserted ``struct page *page`` page to be inserted at **addr** ``unsigned long *src`` src pfn which is being migrated ``pmd_t *pmdp`` pointer to the pmd **Description** **page** needs to be initialized and setup after it's allocated. The code bits here follow closely the code in __do_huge_pmd_anonymous_page(). This API does not support THP zero pages.h](jM)}(h**Parameters**h]j)}(hjqh]h Parameters}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjqubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:137: ./mm/migrate_device.chMhjqubj)}(hhh](j)}(h6``struct migrate_vma *migrate`` migrate_vma arguments h](j)}(h``struct migrate_vma *migrate``h]jS)}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj:qubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:137: ./mm/migrate_device.chMhj6qubj)}(hhh]jM)}(hmigrate_vma argumentsh]hmigrate_vma arguments}(hjUqhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjQqhMhjRqubah}(h]h ]h"]h$]h&]uh1jhj6qubeh}(h]h ]h"]h$]h&]uh1jhjQqhMhj3qubj)}(h@``unsigned long addr`` address where the folio will be inserted h](j)}(h``unsigned long addr``h]jS)}(hjuqh]hunsigned long addr}(hjwqhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjsqubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:137: ./mm/migrate_device.chMhjoqubj)}(hhh]jM)}(h(address where the folio will be insertedh]h(address where the folio will be inserted}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjqhMhjqubah}(h]h ]h"]h$]h&]uh1jhjoqubeh}(h]h ]h"]h$]h&]uh1jhjqhMhj3qubj)}(h6``struct page *page`` page to be inserted at **addr** h](j)}(h``struct page *page``h]jS)}(hjqh]hstruct page *page}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjqubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:137: ./mm/migrate_device.chMhjqubj)}(hhh]jM)}(hpage to be inserted at **addr**h](hpage to be inserted at }(hjqhhhNhNubj)}(h**addr**h]haddr}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjqubeh}(h]h ]h"]h$]h&]uh1jLhjqhMhjqubah}(h]h ]h"]h$]h&]uh1jhjqubeh}(h]h ]h"]h$]h&]uh1jhjqhMhj3qubj)}(h7``unsigned long *src`` src pfn which is being migrated h](j)}(h``unsigned long *src``h]jS)}(hjqh]hunsigned long *src}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjqubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:137: ./mm/migrate_device.chMhjqubj)}(hhh]jM)}(hsrc pfn which is being migratedh]hsrc pfn which is being migrated}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj rhMhj rubah}(h]h ]h"]h$]h&]uh1jhjqubeh}(h]h ]h"]h$]h&]uh1jhj rhMhj3qubj)}(h#``pmd_t *pmdp`` pointer to the pmd h](j)}(h``pmd_t *pmdp``h]jS)}(hj.rh]h pmd_t *pmdp}(hj0rhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj,rubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:137: ./mm/migrate_device.chMhj(rubj)}(hhh]jM)}(hpointer to the pmdh]hpointer to the pmd}(hjGrhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjCrhMhjDrubah}(h]h ]h"]h$]h&]uh1jhj(rubeh}(h]h ]h"]h$]h&]uh1jhjCrhMhj3qubeh}(h]h ]h"]h$]h&]uh1jhjqubjM)}(h**Description**h]j)}(hjirh]h Description}(hjkrhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjgrubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:137: ./mm/migrate_device.chM hjqubjM)}(h**page** needs to be initialized and setup after it's allocated. The code bits here follow closely the code in __do_huge_pmd_anonymous_page(). This API does not support THP zero pages.h](j)}(h**page**h]hpage}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjrubh needs to be initialized and setup after it’s allocated. The code bits here follow closely the code in __do_huge_pmd_anonymous_page(). This API does not support THP zero pages.}(hjrhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:137: ./mm/migrate_device.chMhjqubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h!migrate_device_pages (C function)c.migrate_device_pageshNtauh1hhjKhhhNhNubh)}(hhh](h)}(hbvoid migrate_device_pages (unsigned long *src_pfns, unsigned long *dst_pfns, unsigned long npages)h]h)}(havoid migrate_device_pages(unsigned long *src_pfns, unsigned long *dst_pfns, unsigned long npages)h](j)}(hvoidh]hvoid}(hjrhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjrhhhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:137: ./mm/migrate_device.chMubj)}(h h]h }(hjrhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjrhhhjrhMubh)}(hmigrate_device_pagesh]j)}(hmigrate_device_pagesh]hmigrate_device_pages}(hjrhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjrubah}(h]h ](jjeh"]h$]h&]jjuh1hhjrhhhjrhMubj8)}(hH(unsigned long *src_pfns, unsigned long *dst_pfns, unsigned long npages)h](j>)}(hunsigned long *src_pfnsh](j)}(hunsignedh]hunsigned}(hjrhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjrubj)}(h h]h }(hjshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjrubj)}(hlongh]hlong}(hjshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjrubj)}(h h]h }(hj#shhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjrubjr)}(hjuh]h*}(hj1shhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjrubj)}(hsrc_pfnsh]hsrc_pfns}(hj>shhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjrubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjrubj>)}(hunsigned long *dst_pfnsh](j)}(hunsignedh]hunsigned}(hjWshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSsubj)}(h h]h }(hjeshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSsubj)}(hlongh]hlong}(hjsshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSsubj)}(h h]h }(hjshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSsubjr)}(hjuh]h*}(hjshhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjSsubj)}(hdst_pfnsh]hdst_pfns}(hjshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSsubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjrubj>)}(hunsigned long npagesh](j)}(hunsignedh]hunsigned}(hjshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjsubj)}(h h]h }(hjshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjsubj)}(hlongh]hlong}(hjshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjsubj)}(h h]h }(hjshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjsubj)}(hnpagesh]hnpages}(hjshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjsubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjrubeh}(h]h ]h"]h$]h&]jjuh1j7hjrhhhjrhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjrhhhjrhMubah}(h]jrah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjrhMhjrhhubj4)}(hhh]jM)}(h+migrate meta-data from src page to dst pageh]h+migrate meta-data from src page to dst page}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:137: ./mm/migrate_device.chMhjthhubah}(h]h ]h"]h$]h&]uh1j3hjrhhhjrhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj/tjHj/tjIjJjKuh1hhhhjKhNhNubj)}(hX{**Parameters** ``unsigned long *src_pfns`` src_pfns returned from migrate_device_range() ``unsigned long *dst_pfns`` array of pfns allocated by the driver to migrate memory to ``unsigned long npages`` number of pages in the range **Description** Equivalent to migrate_vma_pages(). This is called to migrate struct page meta-data from source struct page to destination.h](jM)}(h**Parameters**h]j)}(hj9th]h Parameters}(hj;thhhNhNubah}(h]h ]h"]h$]h&]uh1jhj7tubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:137: ./mm/migrate_device.chMhj3tubj)}(hhh](j)}(hJ``unsigned long *src_pfns`` src_pfns returned from migrate_device_range() h](j)}(h``unsigned long *src_pfns``h]jS)}(hjXth]hunsigned long *src_pfns}(hjZthhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjVtubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:137: ./mm/migrate_device.chMhjRtubj)}(hhh]jM)}(h-src_pfns returned from migrate_device_range()h]h-src_pfns returned from migrate_device_range()}(hjqthhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjmthMhjntubah}(h]h ]h"]h$]h&]uh1jhjRtubeh}(h]h ]h"]h$]h&]uh1jhjmthMhjOtubj)}(hW``unsigned long *dst_pfns`` array of pfns allocated by the driver to migrate memory to h](j)}(h``unsigned long *dst_pfns``h]jS)}(hjth]hunsigned long *dst_pfns}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjtubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:137: ./mm/migrate_device.chMhjtubj)}(hhh]jM)}(h:array of pfns allocated by the driver to migrate memory toh]h:array of pfns allocated by the driver to migrate memory to}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjthMhjtubah}(h]h ]h"]h$]h&]uh1jhjtubeh}(h]h ]h"]h$]h&]uh1jhjthMhjOtubj)}(h6``unsigned long npages`` number of pages in the range h](j)}(h``unsigned long npages``h]jS)}(hjth]hunsigned long npages}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjtubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:137: ./mm/migrate_device.chMhjtubj)}(hhh]jM)}(hnumber of pages in the rangeh]hnumber of pages in the range}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjthMhjtubah}(h]h ]h"]h$]h&]uh1jhjtubeh}(h]h ]h"]h$]h&]uh1jhjthMhjOtubeh}(h]h ]h"]h$]h&]uh1jhj3tubjM)}(h**Description**h]j)}(hjuh]h Description}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjuubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:137: ./mm/migrate_device.chMhj3tubjM)}(hzEquivalent to migrate_vma_pages(). This is called to migrate struct page meta-data from source struct page to destination.h]hzEquivalent to migrate_vma_pages(). This is called to migrate struct page meta-data from source struct page to destination.}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:137: ./mm/migrate_device.chMhj3tubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hmigrate_vma_pages (C function)c.migrate_vma_pageshNtauh1hhjKhhhNhNubh)}(hhh](h)}(h4void migrate_vma_pages (struct migrate_vma *migrate)h]h)}(h3void migrate_vma_pages(struct migrate_vma *migrate)h](j)}(hvoidh]hvoid}(hjJuhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFuhhhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:137: ./mm/migrate_device.chMubj)}(h h]h }(hjYuhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFuhhhjXuhMubh)}(hmigrate_vma_pagesh]j)}(hmigrate_vma_pagesh]hmigrate_vma_pages}(hjkuhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjguubah}(h]h ](jjeh"]h$]h&]jjuh1hhjFuhhhjXuhMubj8)}(h(struct migrate_vma *migrate)h]j>)}(hstruct migrate_vma *migrateh](j)}(hjJ,h]hstruct}(hjuhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjuubj)}(h h]h }(hjuhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjuubh)}(hhh]j)}(h migrate_vmah]h migrate_vma}(hjuhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjuubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjumodnameN classnameNjj)}j]j)}jjmusbc.migrate_vma_pagesasbuh1hhjuubj)}(h h]h }(hjuhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjuubjr)}(hjuh]h*}(hjuhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjuubj)}(hmigrateh]hmigrate}(hjuhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjuubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjuubah}(h]h ]h"]h$]h&]jjuh1j7hjFuhhhjXuhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjBuhhhjXuhMubah}(h]j=uah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjXuhMhj?uhhubj4)}(hhh]jM)}(h+migrate meta-data from src page to dst pageh]h+migrate meta-data from src page to dst page}(hj vhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:137: ./mm/migrate_device.chMhjvhhubah}(h]h ]h"]h$]h&]uh1j3hj?uhhhjXuhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj"vjHj"vjIjJjKuh1hhhhjKhNhNubj)}(hX!**Parameters** ``struct migrate_vma *migrate`` migrate struct containing all migration information **Description** This migrates struct page meta-data from source struct page to destination struct page. This effectively finishes the migration from source page to the destination page.h](jM)}(h**Parameters**h]j)}(hj,vh]h Parameters}(hj.vhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj*vubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:137: ./mm/migrate_device.chMhj&vubj)}(hhh]j)}(hT``struct migrate_vma *migrate`` migrate struct containing all migration information h](j)}(h``struct migrate_vma *migrate``h]jS)}(hjKvh]hstruct migrate_vma *migrate}(hjMvhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjIvubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:137: ./mm/migrate_device.chMhjEvubj)}(hhh]jM)}(h3migrate struct containing all migration informationh]h3migrate struct containing all migration information}(hjdvhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj`vhMhjavubah}(h]h ]h"]h$]h&]uh1jhjEvubeh}(h]h ]h"]h$]h&]uh1jhj`vhMhjBvubah}(h]h ]h"]h$]h&]uh1jhj&vubjM)}(h**Description**h]j)}(hjvh]h Description}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjvubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:137: ./mm/migrate_device.chMhj&vubjM)}(hThis migrates struct page meta-data from source struct page to destination struct page. This effectively finishes the migration from source page to the destination page.h]hThis migrates struct page meta-data from source struct page to destination struct page. This effectively finishes the migration from source page to the destination page.}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:137: ./mm/migrate_device.chMhj&vubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h!migrate_vma_finalize (C function)c.migrate_vma_finalizehNtauh1hhjKhhhNhNubh)}(hhh](h)}(h7void migrate_vma_finalize (struct migrate_vma *migrate)h]h)}(h6void migrate_vma_finalize(struct migrate_vma *migrate)h](j)}(hvoidh]hvoid}(hjvhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvhhhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:137: ./mm/migrate_device.chMTubj)}(h h]h }(hjvhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvhhhjvhMTubh)}(hmigrate_vma_finalizeh]j)}(hmigrate_vma_finalizeh]hmigrate_vma_finalize}(hjvhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvubah}(h]h ](jjeh"]h$]h&]jjuh1hhjvhhhjvhMTubj8)}(h(struct migrate_vma *migrate)h]j>)}(hstruct migrate_vma *migrateh](j)}(hjJ,h]hstruct}(hjwhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjwubj)}(h h]h }(hjwhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjwubh)}(hhh]j)}(h migrate_vmah]h migrate_vma}(hj&whhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#wubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj(wmodnameN classnameNjj)}j]j)}jjvsbc.migrate_vma_finalizeasbuh1hhjwubj)}(h h]h }(hjFwhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjwubjr)}(hjuh]h*}(hjTwhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjwubj)}(hmigrateh]hmigrate}(hjawhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjwubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjwubah}(h]h ]h"]h$]h&]jjuh1j7hjvhhhjvhMTubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjvhhhjvhMTubah}(h]jvah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjvhMThjvhhubj4)}(hhh]jM)}(hrestore CPU page table entryh]hrestore CPU page table entry}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:137: ./mm/migrate_device.chMThjwhhubah}(h]h ]h"]h$]h&]uh1j3hjvhhhjvhMTubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjwjHjwjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct migrate_vma *migrate`` migrate struct containing all migration information **Description** This replaces the special migration pte entry with either a mapping to the new page if migration was successful for that page, or to the original page otherwise. This also unlocks the pages and puts them back on the lru, or drops the extra refcount, for device pages.h](jM)}(h**Parameters**h]j)}(hjwh]h Parameters}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjwubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:137: ./mm/migrate_device.chMXhjwubj)}(hhh]j)}(hT``struct migrate_vma *migrate`` migrate struct containing all migration information h](j)}(h``struct migrate_vma *migrate``h]jS)}(hjwh]hstruct migrate_vma *migrate}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjwubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:137: ./mm/migrate_device.chMUhjwubj)}(hhh]jM)}(h3migrate struct containing all migration informationh]h3migrate struct containing all migration information}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjwhMUhjwubah}(h]h ]h"]h$]h&]uh1jhjwubeh}(h]h ]h"]h$]h&]uh1jhjwhMUhjwubah}(h]h ]h"]h$]h&]uh1jhjwubjM)}(h**Description**h]j)}(hjxh]h Description}(hj xhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjxubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:137: ./mm/migrate_device.chMWhjwubjM)}(hThis replaces the special migration pte entry with either a mapping to the new page if migration was successful for that page, or to the original page otherwise.h]hThis replaces the special migration pte entry with either a mapping to the new page if migration was successful for that page, or to the original page otherwise.}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:137: ./mm/migrate_device.chMVhjwubjM)}(hiThis also unlocks the pages and puts them back on the lru, or drops the extra refcount, for device pages.h]hiThis also unlocks the pages and puts them back on the lru, or drops the extra refcount, for device pages.}(hj,xhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:137: ./mm/migrate_device.chMZhjwubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h!migrate_device_range (C function)c.migrate_device_rangehNtauh1hhjKhhhNhNubh)}(hhh](h)}(h]int migrate_device_range (unsigned long *src_pfns, unsigned long start, unsigned long npages)h]h)}(h\int migrate_device_range(unsigned long *src_pfns, unsigned long start, unsigned long npages)h](j)}(hinth]hint}(hj[xhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjWxhhhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:137: ./mm/migrate_device.chMvubj)}(h h]h }(hjjxhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjWxhhhjixhMvubh)}(hmigrate_device_rangeh]j)}(hmigrate_device_rangeh]hmigrate_device_range}(hj|xhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjxxubah}(h]h ](jjeh"]h$]h&]jjuh1hhjWxhhhjixhMvubj8)}(hD(unsigned long *src_pfns, unsigned long start, unsigned long npages)h](j>)}(hunsigned long *src_pfnsh](j)}(hunsignedh]hunsigned}(hjxhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjxubj)}(h h]h }(hjxhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjxubj)}(hlongh]hlong}(hjxhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjxubj)}(h h]h }(hjxhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjxubjr)}(hjuh]h*}(hjxhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjxubj)}(hsrc_pfnsh]hsrc_pfns}(hjxhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjxubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjxubj>)}(hunsigned long starth](j)}(hunsignedh]hunsigned}(hjxhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjxubj)}(h h]h }(hjyhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjxubj)}(hlongh]hlong}(hjyhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjxubj)}(h h]h }(hj yhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjxubj)}(hstarth]hstart}(hj.yhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjxubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjxubj>)}(hunsigned long npagesh](j)}(hunsignedh]hunsigned}(hjGyhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCyubj)}(h h]h }(hjUyhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCyubj)}(hlongh]hlong}(hjcyhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCyubj)}(h h]h }(hjqyhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCyubj)}(hnpagesh]hnpages}(hjyhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCyubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjxubeh}(h]h ]h"]h$]h&]jjuh1j7hjWxhhhjixhMvubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjSxhhhjixhMvubah}(h]jNxah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjixhMvhjPxhhubj4)}(hhh]jM)}(h-migrate device private pfns to normal memory.h]h-migrate device private pfns to normal memory.}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:137: ./mm/migrate_device.chMvhjyhhubah}(h]h ]h"]h$]h&]uh1j3hjPxhhhjixhMvubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjyjHjyjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``unsigned long *src_pfns`` array large enough to hold migrating source device private pfns. ``unsigned long start`` starting pfn in the range to migrate. ``unsigned long npages`` number of pages to migrate. **Description** migrate_device_range() is similar in concept to migrate_vma_setup(), except that instead of looking up pages based on virtual address mappings, a range of device pfns that should be migrated to system memory is used. This is useful when a driver needs to free device memory but doesn't know the virtual mappings of every page that may be in device memory. For example this is often the case when a driver is being unloaded or unbound from a device. Like migrate_vma_setup() this function will take a reference and lock any migrating pages that aren't free before unmapping them. Drivers may then allocate destination pages and start copying data from the device to CPU memory before calling migrate_device_pages().h](jM)}(h**Parameters**h]j)}(hjyh]h Parameters}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjyubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:137: ./mm/migrate_device.chMzhjyubj)}(hhh](j)}(h]``unsigned long *src_pfns`` array large enough to hold migrating source device private pfns. h](j)}(h``unsigned long *src_pfns``h]jS)}(hjyh]hunsigned long *src_pfns}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjyubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:137: ./mm/migrate_device.chMwhjyubj)}(hhh]jM)}(h@array large enough to hold migrating source device private pfns.h]h@array large enough to hold migrating source device private pfns.}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjyhMwhjzubah}(h]h ]h"]h$]h&]uh1jhjyubeh}(h]h ]h"]h$]h&]uh1jhjyhMwhjyubj)}(h>``unsigned long start`` starting pfn in the range to migrate. h](j)}(h``unsigned long start``h]jS)}(hj#zh]hunsigned long start}(hj%zhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj!zubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:137: ./mm/migrate_device.chMxhjzubj)}(hhh]jM)}(h%starting pfn in the range to migrate.h]h%starting pfn in the range to migrate.}(hj)}(hunsigned long *src_pfnsh](j)}(hunsignedh]hunsigned}(hj7{hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3{ubj)}(h h]h }(hjE{hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3{ubj)}(hlongh]hlong}(hjS{hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3{ubj)}(h h]h }(hja{hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3{ubjr)}(hjuh]h*}(hjo{hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj3{ubj)}(hsrc_pfnsh]hsrc_pfns}(hj|{hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3{ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj/{ubj>)}(hunsigned long npagesh](j)}(hunsignedh]hunsigned}(hj{hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{ubj)}(h h]h }(hj{hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{ubj)}(hlongh]hlong}(hj{hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{ubj)}(h h]h }(hj{hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{ubj)}(hnpagesh]hnpages}(hj{hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj/{ubeh}(h]h ]h"]h$]h&]jjuh1j7hjzhhhj{hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjzhhhj{hMubah}(h]jzah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj{hMhjzhhubj4)}(hhh]jM)}(h-migrate device private pfns to normal memory.h]h-migrate device private pfns to normal memory.}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:137: ./mm/migrate_device.chMhj{hhubah}(h]h ]h"]h$]h&]uh1j3hjzhhhj{hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj|jHj|jIjJjKuh1hhhhjKhNhNubj)}(hX#**Parameters** ``unsigned long *src_pfns`` pre-populated array of source device private pfns to migrate. ``unsigned long npages`` number of pages to migrate. **Description** Similar to migrate_device_range() but supports non-contiguous pre-populated array of device pages to migrate.h](jM)}(h**Parameters**h]j)}(hj|h]h Parameters}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj|ubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:137: ./mm/migrate_device.chMhj|ubj)}(hhh](j)}(hZ``unsigned long *src_pfns`` pre-populated array of source device private pfns to migrate. h](j)}(h``unsigned long *src_pfns``h]jS)}(hj8|h]hunsigned long *src_pfns}(hj:|hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj6|ubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:137: ./mm/migrate_device.chMhj2|ubj)}(hhh]jM)}(h=pre-populated array of source device private pfns to migrate.h]h=pre-populated array of source device private pfns to migrate.}(hjQ|hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjM|hMhjN|ubah}(h]h ]h"]h$]h&]uh1jhj2|ubeh}(h]h ]h"]h$]h&]uh1jhjM|hMhj/|ubj)}(h5``unsigned long npages`` number of pages to migrate. h](j)}(h``unsigned long npages``h]jS)}(hjq|h]hunsigned long npages}(hjs|hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjo|ubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:137: ./mm/migrate_device.chMhjk|ubj)}(hhh]jM)}(hnumber of pages to migrate.h]hnumber of pages to migrate.}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj|hMhj|ubah}(h]h ]h"]h$]h&]uh1jhjk|ubeh}(h]h ]h"]h$]h&]uh1jhj|hMhj/|ubeh}(h]h ]h"]h$]h&]uh1jhj|ubjM)}(h**Description**h]j)}(hj|h]h Description}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj|ubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:137: ./mm/migrate_device.chMhj|ubjM)}(hmSimilar to migrate_device_range() but supports non-contiguous pre-populated array of device pages to migrate.h]hmSimilar to migrate_device_range() but supports non-contiguous pre-populated array of device pages to migrate.}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:137: ./mm/migrate_device.chMhj|ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubjz)}(hA#kernel-doc:: mm/nommu.c (duplicates kernel-doc from other files)h]hA#kernel-doc:: mm/nommu.c (duplicates kernel-doc from other files)}hj|sbah}(h]h ]h"]h$]h&]jjuh1jyhjKhhhhhKubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hwp_walk (C struct) c.wp_walkhNtauh1hhjKhhhNhNubh)}(hhh](h)}(hwp_walkh]h)}(hstruct wp_walkh](j)}(hjJ,h]hstruct}(hj|hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|hhh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chKubj)}(h h]h }(hj }hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|hhhj }hKubh)}(hwp_walkh]j)}(hj|h]hwp_walk}(hj}hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj}ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj|hhhj }hKubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj|hhhj }hKubah}(h]j|ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj }hKhj|hhubj4)}(hhh]jM)}(h+Private struct for pagetable walk callbacksh]h+Private struct for pagetable walk callbacks}(hjA}hhhNhNubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chK hj>}hhubah}(h]h ]h"]h$]h&]uh1j3hj|hhhj }hKubeh}(h]h ](jAstructeh"]h$]h&]jFjAjGjY}jHjY}jIjJjKuh1hhhhjKhNhNubj)}(hXw**Definition**:: struct wp_walk { struct mmu_notifier_range range; unsigned long tlbflush_start; unsigned long tlbflush_end; unsigned long total; }; **Members** ``range`` Range for mmu notifiers ``tlbflush_start`` Address of first modified pte ``tlbflush_end`` Address of last modified pte + 1 ``total`` Total number of modified ptesh](jM)}(h**Definition**::h](j)}(h**Definition**h]h Definition}(hje}hhhNhNubah}(h]h ]h"]h$]h&]uh1jhja}ubh:}(hja}hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chKhj]}ubj7 )}(hstruct wp_walk { struct mmu_notifier_range range; unsigned long tlbflush_start; unsigned long tlbflush_end; unsigned long total; };h]hstruct wp_walk { struct mmu_notifier_range range; unsigned long tlbflush_start; unsigned long tlbflush_end; unsigned long total; };}hj~}sbah}(h]h ]h"]h$]h&]jjuh1j6 h[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chKhj]}ubjM)}(h **Members**h]j)}(hj}h]hMembers}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj}ubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chKhj]}ubj)}(hhh](j)}(h"``range`` Range for mmu notifiers h](j)}(h ``range``h]jS)}(hj}h]hrange}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj}ubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chK hj}ubj)}(hhh]jM)}(hRange for mmu notifiersh]hRange for mmu notifiers}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj}hK hj}ubah}(h]h ]h"]h$]h&]uh1jhj}ubeh}(h]h ]h"]h$]h&]uh1jhj}hK hj}ubj)}(h1``tlbflush_start`` Address of first modified pte h](j)}(h``tlbflush_start``h]jS)}(hj}h]htlbflush_start}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj}ubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chKhj}ubj)}(hhh]jM)}(hAddress of first modified pteh]hAddress of first modified pte}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj}hKhj}ubah}(h]h ]h"]h$]h&]uh1jhj}ubeh}(h]h ]h"]h$]h&]uh1jhj}hKhj}ubj)}(h2``tlbflush_end`` Address of last modified pte + 1 h](j)}(h``tlbflush_end``h]jS)}(hj ~h]h tlbflush_end}(hj"~hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj~ubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chKhj~ubj)}(hhh]jM)}(h Address of last modified pte + 1h]h Address of last modified pte + 1}(hj9~hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj5~hKhj6~ubah}(h]h ]h"]h$]h&]uh1jhj~ubeh}(h]h ]h"]h$]h&]uh1jhj5~hKhj}ubj)}(h'``total`` Total number of modified ptesh](j)}(h ``total``h]jS)}(hjY~h]htotal}(hj[~hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjW~ubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chKhjS~ubj)}(hhh]jM)}(hTotal number of modified ptesh]hTotal number of modified ptes}(hjr~hhhNhNubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chKhjo~ubah}(h]h ]h"]h$]h&]uh1jhjS~ubeh}(h]h ]h"]h$]h&]uh1jhjn~hKhj}ubeh}(h]h ]h"]h$]h&]uh1jhj]}ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hwp_pte (C function)c.wp_ptehNtauh1hhjKhhhNhNubh)}(hhh](h)}(hTint wp_pte (pte_t *pte, unsigned long addr, unsigned long end, struct mm_walk *walk)h]h)}(hSint wp_pte(pte_t *pte, unsigned long addr, unsigned long end, struct mm_walk *walk)h](j)}(hinth]hint}(hj~hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~hhh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chKubj)}(h h]h }(hj~hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~hhhj~hKubh)}(hwp_pteh]j)}(hwp_pteh]hwp_pte}(hj~hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj~hhhj~hKubj8)}(hI(pte_t *pte, unsigned long addr, unsigned long end, struct mm_walk *walk)h](j>)}(h pte_t *pteh](h)}(hhh]j)}(hpte_th]hpte_t}(hj~hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj~modnameN classnameNjj)}j]j)}jj~sbc.wp_pteasbuh1hhj~ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~ubjr)}(hjuh]h*}(hj!hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj~ubj)}(hpteh]hpte}(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj~ubj>)}(hunsigned long addrh](j)}(hunsignedh]hunsigned}(hjGhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCubj)}(h h]h }(hjUhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCubj)}(hlongh]hlong}(hjchhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCubj)}(h h]h }(hjqhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCubj)}(haddrh]haddr}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj~ubj>)}(hunsigned long endh](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hendh]hend}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj~ubj>)}(hstruct mm_walk *walkh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hmm_walkh]hmm_walk}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj modnameN classnameNjj)}j]jc.wp_pteasbuh1hhjubj)}(h h]h }(hj%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hj3hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hwalkh]hwalk}(hj@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj~ubeh}(h]h ]h"]h$]h&]jjuh1j7hj~hhhj~hKubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj~hhhj~hKubah}(h]j~ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj~hKhj~hhubj4)}(hhh]jM)}(hWrite-protect a pteh]hWrite-protect a pte}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chKhjghhubah}(h]h ]h"]h$]h&]uh1j3hj~hhhj~hKubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``pte_t *pte`` Pointer to the pte ``unsigned long addr`` The start of protecting virtual address ``unsigned long end`` The end of protecting virtual address ``struct mm_walk *walk`` pagetable walk callback argument **Description** The function write-protects a pte and records the range in virtual address space of touched ptes for efficient range TLB flushes.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chKhjubj)}(hhh](j)}(h"``pte_t *pte`` Pointer to the pte h](j)}(h``pte_t *pte``h]jS)}(hjh]h pte_t *pte}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chKhjubj)}(hhh]jM)}(hPointer to the pteh]hPointer to the pte}(hjĀhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubj)}(h?``unsigned long addr`` The start of protecting virtual address h](j)}(h``unsigned long addr``h]jS)}(hjh]hunsigned long addr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chKhjހubj)}(hhh]jM)}(h'The start of protecting virtual addressh]h'The start of protecting virtual address}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjހubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubj)}(h<``unsigned long end`` The end of protecting virtual address h](j)}(h``unsigned long end``h]jS)}(hjh]hunsigned long end}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chKhjubj)}(hhh]jM)}(h%The end of protecting virtual addressh]h%The end of protecting virtual address}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj2hKhj3ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj2hKhjubj)}(h:``struct mm_walk *walk`` pagetable walk callback argument h](j)}(h``struct mm_walk *walk``h]jS)}(hjVh]hstruct mm_walk *walk}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjTubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chKhjPubj)}(hhh]jM)}(h pagetable walk callback argumenth]h pagetable walk callback argument}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjkhKhjlubah}(h]h ]h"]h$]h&]uh1jhjPubeh}(h]h ]h"]h$]h&]uh1jhjkhKhjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chKhjubjM)}(hThe function write-protects a pte and records the range in virtual address space of touched ptes for efficient range TLB flushes.h]hThe function write-protects a pte and records the range in virtual address space of touched ptes for efficient range TLB flushes.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chKhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hclean_walk (C struct) c.clean_walkhNtauh1hhjKhhhNhNubh)}(hhh](h)}(h clean_walkh]h)}(hstruct clean_walkh](j)}(hjJ,h]hstruct}(hjցhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjҁhhh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chK$ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjҁhhhjhK$ubh)}(h clean_walkh]j)}(hjЁh]h clean_walk}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjҁhhhjhK$ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj΁hhhjhK$ubah}(h]jɁah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhK$hjˁhhubj4)}(hhh]jM)}(h1Private struct for the clean_record_pte function.h]h1Private struct for the clean_record_pte function.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chK7hjhhubah}(h]h ]h"]h$]h&]uh1j3hjˁhhhjhK$ubeh}(h]h ](jAstructeh"]h$]h&]jFjAjGj0jHj0jIjJjKuh1hhhhjKhNhNubj)}(hX>**Definition**:: struct clean_walk { struct wp_walk base; pgoff_t bitmap_pgoff; unsigned long *bitmap; pgoff_t start; pgoff_t end; }; **Members** ``base`` struct wp_walk we derive from ``bitmap_pgoff`` Address_space Page offset of the first bit in **bitmap** ``bitmap`` Bitmap with one bit for each page offset in the address_space range covered. ``start`` Address_space page offset of first modified pte relative to **bitmap_pgoff** ``end`` Address_space page offset of last modified pte relative to **bitmap_pgoff**h](jM)}(h**Definition**::h](j)}(h**Definition**h]h Definition}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj8ubh:}(hj8hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chK;hj4ubj7 )}(hstruct clean_walk { struct wp_walk base; pgoff_t bitmap_pgoff; unsigned long *bitmap; pgoff_t start; pgoff_t end; };h]hstruct clean_walk { struct wp_walk base; pgoff_t bitmap_pgoff; unsigned long *bitmap; pgoff_t start; pgoff_t end; };}hjUsbah}(h]h ]h"]h$]h&]jjuh1j6 h[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chK=hj4ubjM)}(h **Members**h]j)}(hjfh]hMembers}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjdubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chKEhj4ubj)}(hhh](j)}(h'``base`` struct wp_walk we derive from h](j)}(h``base``h]jS)}(hjh]hbase}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chK9hjubj)}(hhh]jM)}(hstruct wp_walk we derive fromh]hstruct wp_walk we derive from}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhK9hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhK9hj|ubj)}(hJ``bitmap_pgoff`` Address_space Page offset of the first bit in **bitmap** h](j)}(h``bitmap_pgoff``h]jS)}(hjh]h bitmap_pgoff}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chK:hjubj)}(hhh]jM)}(h8Address_space Page offset of the first bit in **bitmap**h](h.Address_space Page offset of the first bit in }(hjׂhhhNhNubj)}(h **bitmap**h]hbitmap}(hj߂hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjׂubeh}(h]h ]h"]h$]h&]uh1jLhjӂhK:hjԂubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjӂhK:hj|ubj)}(hX``bitmap`` Bitmap with one bit for each page offset in the address_space range covered. h](j)}(h ``bitmap``h]jS)}(hjh]hbitmap}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chKhj9ubj)}(hhh]jM)}(hLAddress_space page offset of first modified pte relative to **bitmap_pgoff**h](hhj|ubj)}(hS``end`` Address_space page offset of last modified pte relative to **bitmap_pgoff**h](j)}(h``end``h]jS)}(hjh]hend}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chK?hjubj)}(hhh]jM)}(hKAddress_space page offset of last modified pte relative to **bitmap_pgoff**h](h;Address_space page offset of last modified pte relative to }(hjhhhNhNubj)}(h**bitmap_pgoff**h]h bitmap_pgoff}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jLhjhK?hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhK?hj|ubeh}(h]h ]h"]h$]h&]uh1jhj4ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hclean_record_pte (C function)c.clean_record_ptehNtauh1hhjKhhhNhNubh)}(hhh](h)}(h^int clean_record_pte (pte_t *pte, unsigned long addr, unsigned long end, struct mm_walk *walk)h]h)}(h]int clean_record_pte(pte_t *pte, unsigned long addr, unsigned long end, struct mm_walk *walk)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chKLubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhKLubh)}(hclean_record_pteh]j)}(hclean_record_pteh]hclean_record_pte}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhKLubj8)}(hI(pte_t *pte, unsigned long addr, unsigned long end, struct mm_walk *walk)h](j>)}(h pte_t *pteh](h)}(hhh]j)}(hpte_th]hpte_t}(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj0modnameN classnameNjj)}j]j)}jjsbc.clean_record_pteasbuh1hhj'ubj)}(h h]h }(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj'ubjr)}(hjuh]h*}(hj\hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj'ubj)}(hpteh]hpte}(hjihhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj'ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj#ubj>)}(hunsigned long addrh](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~ubj)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~ubj)}(haddrh]haddr}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj#ubj>)}(hunsigned long endh](j)}(hunsignedh]hunsigned}(hjӄhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjτubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjτubj)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjτubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjτubj)}(hendh]hend}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjτubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj#ubj>)}(hstruct mm_walk *walkh](j)}(hjJ,h]hstruct}(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h h]h }(hj1hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubh)}(hhh]j)}(hmm_walkh]hmm_walk}(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjDmodnameN classnameNjj)}j]jJc.clean_record_pteasbuh1hhj ubj)}(h h]h }(hj`hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubjr)}(hjuh]h*}(hjnhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj ubj)}(hwalkh]hwalk}(hj{hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj#ubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhKLubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhKLubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhKLhjhhubj4)}(hhh]jM)}(h;Clean a pte and record its address space offset in a bitmaph]h;Clean a pte and record its address space offset in a bitmap}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chKLhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhKLubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``pte_t *pte`` Pointer to the pte ``unsigned long addr`` The start of virtual address to be clean ``unsigned long end`` The end of virtual address to be clean ``struct mm_walk *walk`` pagetable walk callback argument **Description** The function cleans a pte and records the range in virtual address space of touched ptes for efficient TLB flushes. It also records dirty ptes in a bitmap representing page offsets in the address_space, as well as the first and last of the bits touched.h](jM)}(h**Parameters**h]j)}(hjDžh]h Parameters}(hjɅhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjŅubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chKPhjubj)}(hhh](j)}(h"``pte_t *pte`` Pointer to the pte h](j)}(h``pte_t *pte``h]jS)}(hjh]h pte_t *pte}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chKNhjubj)}(hhh]jM)}(hPointer to the pteh]hPointer to the pte}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhKNhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKNhj݅ubj)}(h@``unsigned long addr`` The start of virtual address to be clean h](j)}(h``unsigned long addr``h]jS)}(hjh]hunsigned long addr}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chKOhjubj)}(hhh]jM)}(h(The start of virtual address to be cleanh]h(The start of virtual address to be clean}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj4hKOhj5ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj4hKOhj݅ubj)}(h=``unsigned long end`` The end of virtual address to be clean h](j)}(h``unsigned long end``h]jS)}(hjXh]hunsigned long end}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjVubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chKPhjRubj)}(hhh]jM)}(h&The end of virtual address to be cleanh]h&The end of virtual address to be clean}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjmhKPhjnubah}(h]h ]h"]h$]h&]uh1jhjRubeh}(h]h ]h"]h$]h&]uh1jhjmhKPhj݅ubj)}(h:``struct mm_walk *walk`` pagetable walk callback argument h](j)}(h``struct mm_walk *walk``h]jS)}(hjh]hstruct mm_walk *walk}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chKQhjubj)}(hhh]jM)}(h pagetable walk callback argumenth]h pagetable walk callback argument}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhKQhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKQhj݅ubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hj̆h]h Description}(hjΆhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjʆubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chKShjubjM)}(hThe function cleans a pte and records the range in virtual address space of touched ptes for efficient TLB flushes. It also records dirty ptes in a bitmap representing page offsets in the address_space, as well as the first and last of the bits touched.h]hThe function cleans a pte and records the range in virtual address space of touched ptes for efficient TLB flushes. It also records dirty ptes in a bitmap representing page offsets in the address_space, as well as the first and last of the bits touched.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chKRhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h$wp_shared_mapping_range (C function)c.wp_shared_mapping_rangehNtauh1hhjKhhhNhNubh)}(hhh](h)}(hfunsigned long wp_shared_mapping_range (struct address_space *mapping, pgoff_t first_index, pgoff_t nr)h]h)}(heunsigned long wp_shared_mapping_range(struct address_space *mapping, pgoff_t first_index, pgoff_t nr)h](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chKubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhjhKubj)}(hlongh]hlong}(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhjhKubj)}(h h]h }(hj<hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhjhKubh)}(hwp_shared_mapping_rangeh]j)}(hwp_shared_mapping_rangeh]hwp_shared_mapping_range}(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJubah}(h]h ](jjeh"]h$]h&]jjuh1hhj hhhjhKubj8)}(h@(struct address_space *mapping, pgoff_t first_index, pgoff_t nr)h](j>)}(hstruct address_space *mappingh](j)}(hjJ,h]hstruct}(hjjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjfubj)}(h h]h }(hjwhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjfubh)}(hhh]j)}(h address_spaceh]h address_space}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjPsbc.wp_shared_mapping_rangeasbuh1hhjfubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjfubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjfubj)}(hmappingh]hmapping}(hjÇhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjfubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjbubj>)}(hpgoff_t first_indexh](h)}(hhh]j)}(hpgoff_th]hpgoff_t}(hj߇hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj܇ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.wp_shared_mapping_rangeasbuh1hhj؇ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj؇ubj)}(h first_indexh]h first_index}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj؇ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjbubj>)}(h pgoff_t nrh](h)}(hhh]j)}(hpgoff_th]hpgoff_t}(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj)modnameN classnameNjj)}j]jc.wp_shared_mapping_rangeasbuh1hhj ubj)}(h h]h }(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(hnrh]hnr}(hjShhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjbubeh}(h]h ]h"]h$]h&]jjuh1j7hj hhhjhKubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj hhhjhKubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhKhjhhubj4)}(hhh]jM)}(h0Write-protect all ptes in an address space rangeh]h0Write-protect all ptes in an address space range}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chKhjzhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhKubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hXE**Parameters** ``struct address_space *mapping`` The address_space we want to write protect ``pgoff_t first_index`` The first page offset in the range ``pgoff_t nr`` Number of incremental page offsets to cover **Note** This function currently skips transhuge page-table entries, since it's intended for dirty-tracking on the PTE level. It will warn on encountering transhuge write-enabled entries, though, and can easily be extended to handle them as well. **Return** The number of ptes actually write-protected. Note that already write-protected ptes are not counted.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chKhjubj)}(hhh](j)}(hM``struct address_space *mapping`` The address_space we want to write protect h](j)}(h!``struct address_space *mapping``h]jS)}(hjh]hstruct address_space *mapping}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chKhjubj)}(hhh]jM)}(h*The address_space we want to write protecth]h*The address_space we want to write protect}(hj׈hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjӈhKhjԈubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjӈhKhjubj)}(h;``pgoff_t first_index`` The first page offset in the range h](j)}(h``pgoff_t first_index``h]jS)}(hjh]hpgoff_t first_index}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chKhjubj)}(hhh]jM)}(h"The first page offset in the rangeh]h"The first page offset in the range}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj hKhj ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj hKhjubj)}(h;``pgoff_t nr`` Number of incremental page offsets to cover h](j)}(h``pgoff_t nr``h]jS)}(hj0h]h pgoff_t nr}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj.ubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chKhj*ubj)}(hhh]jM)}(h+Number of incremental page offsets to coverh]h+Number of incremental page offsets to cover}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjEhKhjFubah}(h]h ]h"]h$]h&]uh1jhj*ubeh}(h]h ]h"]h$]h&]uh1jhjEhKhjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Note**h]j)}(hjkh]hNote}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjiubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chKhjubjM)}(hThis function currently skips transhuge page-table entries, since it's intended for dirty-tracking on the PTE level. It will warn on encountering transhuge write-enabled entries, though, and can easily be extended to handle them as well.h]hThis function currently skips transhuge page-table entries, since it’s intended for dirty-tracking on the PTE level. It will warn on encountering transhuge write-enabled entries, though, and can easily be extended to handle them as well.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chKhjubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chMhjubjM)}(hdThe number of ptes actually write-protected. Note that already write-protected ptes are not counted.h]hdThe number of ptes actually write-protected. Note that already write-protected ptes are not counted.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h.clean_record_shared_mapping_range (C function)#c.clean_record_shared_mapping_rangehNtauh1hhjKhhhNhNubh)}(hhh](h)}(hunsigned long clean_record_shared_mapping_range (struct address_space *mapping, pgoff_t first_index, pgoff_t nr, pgoff_t bitmap_pgoff, unsigned long *bitmap, pgoff_t *start, pgoff_t *end)h]h)}(hunsigned long clean_record_shared_mapping_range(struct address_space *mapping, pgoff_t first_index, pgoff_t nr, pgoff_t bitmap_pgoff, unsigned long *bitmap, pgoff_t *start, pgoff_t *end)h](j)}(hunsignedh]hunsigned}(hj׉hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjӉhhh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjӉhhhjhMubj)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjӉhhhjhMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjӉhhhjhMubh)}(h!clean_record_shared_mapping_rangeh]j)}(h!clean_record_shared_mapping_rangeh]h!clean_record_shared_mapping_range}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjӉhhhjhMubj8)}(h(struct address_space *mapping, pgoff_t first_index, pgoff_t nr, pgoff_t bitmap_pgoff, unsigned long *bitmap, pgoff_t *start, pgoff_t *end)h](j>)}(hstruct address_space *mappingh](j)}(hjJ,h]hstruct}(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,ubj)}(h h]h }(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,ubh)}(hhh]j)}(h address_spaceh]h address_space}(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjKubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjPmodnameN classnameNjj)}j]j)}jjsb#c.clean_record_shared_mapping_rangeasbuh1hhj,ubj)}(h h]h }(hjnhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,ubjr)}(hjuh]h*}(hj|hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj,ubj)}(hmappingh]hmapping}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj(ubj>)}(hpgoff_t first_indexh](h)}(hhh]j)}(hpgoff_th]hpgoff_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jj#c.clean_record_shared_mapping_rangeasbuh1hhjubj)}(h h]h }(hjÊhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h first_indexh]h first_index}(hjъhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj(ubj>)}(h pgoff_t nrh](h)}(hhh]j)}(hpgoff_th]hpgoff_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jj#c.clean_record_shared_mapping_rangeasbuh1hhjubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hnrh]hnr}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj(ubj>)}(hpgoff_t bitmap_pgoffh](h)}(hhh]j)}(hpgoff_th]hpgoff_t}(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj7modnameN classnameNjj)}j]jj#c.clean_record_shared_mapping_rangeasbuh1hhj.ubj)}(h h]h }(hjShhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj.ubj)}(h bitmap_pgoffh]h bitmap_pgoff}(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj.ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj(ubj>)}(hunsigned long *bitmaph](j)}(hunsignedh]hunsigned}(hjzhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvubj)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjvubj)}(hbitmaph]hbitmap}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj(ubj>)}(hpgoff_t *starth](h)}(hhh]j)}(hpgoff_th]hpgoff_t}(hjۋhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj؋ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj݋modnameN classnameNjj)}j]jj#c.clean_record_shared_mapping_rangeasbuh1hhjԋubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjԋubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjԋubj)}(hstarth]hstart}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjԋubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj(ubj>)}(h pgoff_t *endh](h)}(hhh]j)}(hpgoff_th]hpgoff_t}(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj2modnameN classnameNjj)}j]jj#c.clean_record_shared_mapping_rangeasbuh1hhj)ubj)}(h h]h }(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubjr)}(hjuh]h*}(hj\hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj)ubj)}(hendh]hend}(hjihhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj(ubeh}(h]h ]h"]h$]h&]jjuh1j7hjӉhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjωhhhjhMubah}(h]jʉah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhj̉hhubj4)}(hhh]jM)}(h3Clean and record all ptes in an address space rangeh]h3Clean and record all ptes in an address space range}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chMhjhhubah}(h]h ]h"]h$]h&]uh1j3hj̉hhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct address_space *mapping`` The address_space we want to clean ``pgoff_t first_index`` The first page offset in the range ``pgoff_t nr`` Number of incremental page offsets to cover ``pgoff_t bitmap_pgoff`` The page offset of the first bit in **bitmap** ``unsigned long *bitmap`` Pointer to a bitmap of at least **nr** bits. The bitmap needs to cover the whole range **first_index**..**first_index** + **nr**. ``pgoff_t *start`` Pointer to number of the first set bit in **bitmap**. is modified as new bits are set by the function. ``pgoff_t *end`` Pointer to the number of the last set bit in **bitmap**. none set. The value is modified as new bits are set by the function. **Description** When this function returns there is no guarantee that a CPU has not already dirtied new ptes. However it will not clean any ptes not reported in the bitmap. The guarantees are as follows: * All ptes dirty when the function starts executing will end up recorded in the bitmap. * All ptes dirtied after that will either remain dirty, be recorded in the bitmap or both. If a caller needs to make sure all dirty ptes are picked up and none additional are added, it first needs to write-protect the address-space range and make sure new writers are blocked in page_mkwrite() or pfn_mkwrite(). And then after a TLB flush following the write-protection pick up all dirty bits. This function currently skips transhuge page-table entries, since it's intended for dirty-tracking on the PTE level. It will warn on encountering transhuge dirty entries, though, and can easily be extended to handle them as well. **Return** The number of dirty ptes actually cleaned.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chMhjubj)}(hhh](j)}(hE``struct address_space *mapping`` The address_space we want to clean h](j)}(h!``struct address_space *mapping``h]jS)}(hjԌh]hstruct address_space *mapping}(hj֌hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjҌubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chMhjΌubj)}(hhh]jM)}(h"The address_space we want to cleanh]h"The address_space we want to clean}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjΌubeh}(h]h ]h"]h$]h&]uh1jhjhMhjˌubj)}(h;``pgoff_t first_index`` The first page offset in the range h](j)}(h``pgoff_t first_index``h]jS)}(hj h]hpgoff_t first_index}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj ubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chMhjubj)}(hhh]jM)}(h"The first page offset in the rangeh]h"The first page offset in the range}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj"hMhj#ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj"hMhjˌubj)}(h;``pgoff_t nr`` Number of incremental page offsets to cover h](j)}(h``pgoff_t nr``h]jS)}(hjFh]h pgoff_t nr}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjDubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chMhj@ubj)}(hhh]jM)}(h+Number of incremental page offsets to coverh]h+Number of incremental page offsets to cover}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj[hMhj\ubah}(h]h ]h"]h$]h&]uh1jhj@ubeh}(h]h ]h"]h$]h&]uh1jhj[hMhjˌubj)}(hH``pgoff_t bitmap_pgoff`` The page offset of the first bit in **bitmap** h](j)}(h``pgoff_t bitmap_pgoff``h]jS)}(hjh]hpgoff_t bitmap_pgoff}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj}ubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chMhjyubj)}(hhh]jM)}(h.The page offset of the first bit in **bitmap**h](h$The page offset of the first bit in }(hjhhhNhNubj)}(h **bitmap**h]hbitmap}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjyubeh}(h]h ]h"]h$]h&]uh1jhjhMhjˌubj)}(h``unsigned long *bitmap`` Pointer to a bitmap of at least **nr** bits. The bitmap needs to cover the whole range **first_index**..**first_index** + **nr**. h](j)}(h``unsigned long *bitmap``h]jS)}(hjƍh]hunsigned long *bitmap}(hjȍhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjčubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chMhjubj)}(hhh]jM)}(hPointer to a bitmap of at least **nr** bits. The bitmap needs to cover the whole range **first_index**..**first_index** + **nr**.h](h Pointer to a bitmap of at least }(hjߍhhhNhNubj)}(h**nr**h]hnr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjߍubh1 bits. The bitmap needs to cover the whole range }(hjߍhhhNhNubj)}(h**first_index**h]h first_index}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjߍubh..**first_index** + }(hjߍhhhNhNubj)}(h**nr**h]hnr}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjߍubh.}(hjߍhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chMhj܍ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjۍhMhjˌubj)}(hz``pgoff_t *start`` Pointer to number of the first set bit in **bitmap**. is modified as new bits are set by the function. h](j)}(h``pgoff_t *start``h]jS)}(hj6h]hpgoff_t *start}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj4ubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chMhj0ubj)}(hhh]jM)}(hfPointer to number of the first set bit in **bitmap**. is modified as new bits are set by the function.h](h*Pointer to number of the first set bit in }(hjOhhhNhNubj)}(h **bitmap**h]hbitmap}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjOubh2. is modified as new bits are set by the function.}(hjOhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chMhjLubah}(h]h ]h"]h$]h&]uh1jhj0ubeh}(h]h ]h"]h$]h&]uh1jhjKhMhjˌubj)}(h``pgoff_t *end`` Pointer to the number of the last set bit in **bitmap**. none set. The value is modified as new bits are set by the function. h](j)}(h``pgoff_t *end``h]jS)}(hjh]h pgoff_t *end}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chM!hj|ubj)}(hhh]jM)}(h}Pointer to the number of the last set bit in **bitmap**. none set. The value is modified as new bits are set by the function.h](h-Pointer to the number of the last set bit in }(hjhhhNhNubj)}(h **bitmap**h]hbitmap}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhF. none set. The value is modified as new bits are set by the function.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chM hjubah}(h]h ]h"]h$]h&]uh1jhj|ubeh}(h]h ]h"]h$]h&]uh1jhjhM!hjˌubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjЎh]h Description}(hjҎhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjΎubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chM#hjubjM)}(hWhen this function returns there is no guarantee that a CPU has not already dirtied new ptes. However it will not clean any ptes not reported in the bitmap. The guarantees are as follows:h]hWhen this function returns there is no guarantee that a CPU has not already dirtied new ptes. However it will not clean any ptes not reported in the bitmap. The guarantees are as follows:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chM"hjubj^)}(hhh](jc)}(hUAll ptes dirty when the function starts executing will end up recorded in the bitmap.h]jM)}(hUAll ptes dirty when the function starts executing will end up recorded in the bitmap.h]hUAll ptes dirty when the function starts executing will end up recorded in the bitmap.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chM&hjubah}(h]h ]h"]h$]h&]uh1jbhjubjc)}(hYAll ptes dirtied after that will either remain dirty, be recorded in the bitmap or both. h]jM)}(hXAll ptes dirtied after that will either remain dirty, be recorded in the bitmap or both.h]hXAll ptes dirtied after that will either remain dirty, be recorded in the bitmap or both.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chM(hjubah}(h]h ]h"]h$]h&]uh1jbhjubeh}(h]h ]h"]h$]h&]jjuuh1j]hj hM&hjubjM)}(hX.If a caller needs to make sure all dirty ptes are picked up and none additional are added, it first needs to write-protect the address-space range and make sure new writers are blocked in page_mkwrite() or pfn_mkwrite(). And then after a TLB flush following the write-protection pick up all dirty bits.h]hX.If a caller needs to make sure all dirty ptes are picked up and none additional are added, it first needs to write-protect the address-space range and make sure new writers are blocked in page_mkwrite() or pfn_mkwrite(). And then after a TLB flush following the write-protection pick up all dirty bits.}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chM+hjubjM)}(hThis function currently skips transhuge page-table entries, since it's intended for dirty-tracking on the PTE level. It will warn on encountering transhuge dirty entries, though, and can easily be extended to handle them as well.h]hThis function currently skips transhuge page-table entries, since it’s intended for dirty-tracking on the PTE level. It will warn on encountering transhuge dirty entries, though, and can easily be extended to handle them as well.}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chM1hjubjM)}(h **Return**h]j)}(hjPh]hReturn}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjNubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chM6hjubjM)}(h*The number of dirty ptes actually cleaned.h]h*The number of dirty ptes actually cleaned.}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1jLh[/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:139: ./mm/mapping_dirty_helpers.chM7hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubjz)}(h2#kernel-doc:: mm/memory-failure.c (build warnings)h]h2#kernel-doc:: mm/memory-failure.c (build warnings)}hj|sbah}(h]h ]h"]h$]h&]jjuh1jyhjKhhhhhKubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hpcpu_addr_in_chunk (C function)c.pcpu_addr_in_chunkhNtauh1hhjKhhhNhNubh)}(hhh](h)}(h>bool pcpu_addr_in_chunk (struct pcpu_chunk *chunk, void *addr)h]h)}(h=bool pcpu_addr_in_chunk(struct pcpu_chunk *chunk, void *addr)h](j)}(hjh]hbool}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chKubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhKubh)}(hpcpu_addr_in_chunkh]j)}(hpcpu_addr_in_chunkh]hpcpu_addr_in_chunk}(hjÏhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhKubj8)}(h&(struct pcpu_chunk *chunk, void *addr)h](j>)}(hstruct pcpu_chunk *chunkh](j)}(hjJ,h]hstruct}(hjߏhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjۏubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjۏubh)}(hhh]j)}(h pcpu_chunkh]h pcpu_chunk}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjŏsbc.pcpu_addr_in_chunkasbuh1hhjۏubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjۏubjr)}(hjuh]h*}(hj+hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjۏubj)}(hchunkh]hchunk}(hj8hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjۏubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj׏ubj>)}(h void *addrh](j)}(hvoidh]hvoid}(hjQhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjMubj)}(h h]h }(hj_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjMubjr)}(hjuh]h*}(hjmhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjMubj)}(haddrh]haddr}(hjzhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjMubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj׏ubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhKubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhKubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhKhjhhubj4)}(hhh]jM)}(h.check if the address is served from this chunkh]h.check if the address is served from this chunk}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chKhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhKubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``struct pcpu_chunk *chunk`` chunk of interest ``void *addr`` percpu address **Return** True if the address is served from this chunk.h](jM)}(h**Parameters**h]j)}(hjƐh]h Parameters}(hjȐhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjĐubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chKhjubj)}(hhh](j)}(h/``struct pcpu_chunk *chunk`` chunk of interest h](j)}(h``struct pcpu_chunk *chunk``h]jS)}(hjh]hstruct pcpu_chunk *chunk}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chKhjߐubj)}(hhh]jM)}(hchunk of interesth]hchunk of interest}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjߐubeh}(h]h ]h"]h$]h&]uh1jhjhKhjܐubj)}(h``void *addr`` percpu address h](j)}(h``void *addr``h]jS)}(hjh]h void *addr}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chKhjubj)}(hhh]jM)}(hpercpu addressh]hpercpu address}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj3hKhj4ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj3hKhjܐubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h **Return**h]j)}(hjYh]hReturn}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjWubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chKhjubjM)}(h.True if the address is served from this chunk.h]h.True if the address is served from this chunk.}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chKhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h"pcpu_check_block_hint (C function)c.pcpu_check_block_hinthNtauh1hhjKhhhNhNubh)}(hhh](h)}(hPbool pcpu_check_block_hint (struct pcpu_block_md *block, int bits, size_t align)h]h)}(hObool pcpu_check_block_hint(struct pcpu_block_md *block, int bits, size_t align)h](j)}(hjh]hbool}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM4ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM4ubh)}(hpcpu_check_block_hinth]j)}(hpcpu_check_block_hinth]hpcpu_check_block_hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhM4ubj8)}(h5(struct pcpu_block_md *block, int bits, size_t align)h](j>)}(hstruct pcpu_block_md *blockh](j)}(hjJ,h]hstruct}(hjڑhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj֑ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj֑ubh)}(hhh]j)}(h pcpu_block_mdh]h pcpu_block_md}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsbc.pcpu_check_block_hintasbuh1hhj֑ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj֑ubjr)}(hjuh]h*}(hj&hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj֑ubj)}(hblockh]hblock}(hj3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj֑ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjґubj>)}(hint bitsh](j)}(hinth]hint}(hjLhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHubj)}(h h]h }(hjZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHubj)}(hbitsh]hbits}(hjhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjґubj>)}(h size_t alignh](h)}(hhh]j)}(hsize_th]hsize_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.pcpu_check_block_hintasbuh1hhj}ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj}ubj)}(halignh]halign}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj}ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjґubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhM4ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhM4ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhM4hjhhubj4)}(hhh]jM)}(hcheck against the contig hinth]hcheck against the contig hint}(hjڒhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM4hjגhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhM4ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hXV**Parameters** ``struct pcpu_block_md *block`` block of interest ``int bits`` size of allocation ``size_t align`` alignment of area (max PAGE_SIZE) **Description** Check to see if the allocation can fit in the block's contig hint. Note, a chunk uses the same hints as a block so this can also check against the chunk's contig hint.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM8hjubj)}(hhh](j)}(h2``struct pcpu_block_md *block`` block of interest h](j)}(h``struct pcpu_block_md *block``h]jS)}(hjh]hstruct pcpu_block_md *block}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM5hjubj)}(hhh]jM)}(hblock of interesth]hblock of interest}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj0hM5hj1ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj0hM5hjubj)}(h ``int bits`` size of allocation h](j)}(h ``int bits``h]jS)}(hjTh]hint bits}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjRubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM6hjNubj)}(hhh]jM)}(hsize of allocationh]hsize of allocation}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjihM6hjjubah}(h]h ]h"]h$]h&]uh1jhjNubeh}(h]h ]h"]h$]h&]uh1jhjihM6hjubj)}(h3``size_t align`` alignment of area (max PAGE_SIZE) h](j)}(h``size_t align``h]jS)}(hjh]h size_t align}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM7hjubj)}(hhh]jM)}(h!alignment of area (max PAGE_SIZE)h]h!alignment of area (max PAGE_SIZE)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM7hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM7hjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjȓh]h Description}(hjʓhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjƓubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM9hjubjM)}(hCheck to see if the allocation can fit in the block's contig hint. Note, a chunk uses the same hints as a block so this can also check against the chunk's contig hint.h]hCheck to see if the allocation can fit in the block’s contig hint. Note, a chunk uses the same hints as a block so this can also check against the chunk’s contig hint.}(hjޓhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM8hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h%pcpu_next_md_free_region (C function)c.pcpu_next_md_free_regionhNtauh1hhjKhhhNhNubh)}(hhh](h)}(hQvoid pcpu_next_md_free_region (struct pcpu_chunk *chunk, int *bit_off, int *bits)h]h)}(hPvoid pcpu_next_md_free_region(struct pcpu_chunk *chunk, int *bit_off, int *bits)h](j)}(hvoidh]hvoid}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMcubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhjhMcubh)}(hpcpu_next_md_free_regionh]j)}(hpcpu_next_md_free_regionh]hpcpu_next_md_free_region}(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj hhhjhMcubj8)}(h3(struct pcpu_chunk *chunk, int *bit_off, int *bits)h](j>)}(hstruct pcpu_chunk *chunkh](j)}(hjJ,h]hstruct}(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFubj)}(h h]h }(hjWhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFubh)}(hhh]j)}(h pcpu_chunkh]h pcpu_chunk}(hjhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjjmodnameN classnameNjj)}j]j)}jj0sbc.pcpu_next_md_free_regionasbuh1hhjFubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjFubj)}(hchunkh]hchunk}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjBubj>)}(h int *bit_offh](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjʔhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjؔhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hbit_offh]hbit_off}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjBubj>)}(h int *bitsh](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hbitsh]hbits}(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjBubeh}(h]h ]h"]h$]h&]jjuh1j7hj hhhjhMcubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMcubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMchjhhubj4)}(hhh]jM)}(hfinds the next hint free areah]hfinds the next hint free area}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMchjNhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMcubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjijHjijIjJjKuh1hhhhjKhNhNubj)}(hXg**Parameters** ``struct pcpu_chunk *chunk`` chunk of interest ``int *bit_off`` chunk offset ``int *bits`` size of free area **Description** Helper function for pcpu_for_each_md_free_region. It checks block->contig_hint and performs aggregation across blocks to find the next hint. It modifies bit_off and bits in-place to be consumed in the loop.h](jM)}(h**Parameters**h]j)}(hjsh]h Parameters}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjqubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMghjmubj)}(hhh](j)}(h/``struct pcpu_chunk *chunk`` chunk of interest h](j)}(h``struct pcpu_chunk *chunk``h]jS)}(hjh]hstruct pcpu_chunk *chunk}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMdhjubj)}(hhh]jM)}(hchunk of interesth]hchunk of interest}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMdhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMdhjubj)}(h``int *bit_off`` chunk offset h](j)}(h``int *bit_off``h]jS)}(hj˕h]h int *bit_off}(hj͕hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjɕubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMehjŕubj)}(hhh]jM)}(h chunk offseth]h chunk offset}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMehjubah}(h]h ]h"]h$]h&]uh1jhjŕubeh}(h]h ]h"]h$]h&]uh1jhjhMehjubj)}(h ``int *bits`` size of free area h](j)}(h ``int *bits``h]jS)}(hjh]h int *bits}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMfhjubj)}(hhh]jM)}(hsize of free areah]hsize of free area}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMfhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMfhjubeh}(h]h ]h"]h$]h&]uh1jhjmubjM)}(h**Description**h]j)}(hj?h]h Description}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj=ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhhjmubjM)}(hHelper function for pcpu_for_each_md_free_region. It checks block->contig_hint and performs aggregation across blocks to find the next hint. It modifies bit_off and bits in-place to be consumed in the loop.h]hHelper function for pcpu_for_each_md_free_region. It checks block->contig_hint and performs aggregation across blocks to find the next hint. It modifies bit_off and bits in-place to be consumed in the loop.}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMghjmubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h!pcpu_next_fit_region (C function)c.pcpu_next_fit_regionhNtauh1hhjKhhhNhNubh)}(hhh](h)}(hhvoid pcpu_next_fit_region (struct pcpu_chunk *chunk, int alloc_bits, int align, int *bit_off, int *bits)h]h)}(hgvoid pcpu_next_fit_region(struct pcpu_chunk *chunk, int alloc_bits, int align, int *bit_off, int *bits)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh)}(hpcpu_next_fit_regionh]j)}(hpcpu_next_fit_regionh]hpcpu_next_fit_region}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMubj8)}(hN(struct pcpu_chunk *chunk, int alloc_bits, int align, int *bit_off, int *bits)h](j>)}(hstruct pcpu_chunk *chunkh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjΖhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(h pcpu_chunkh]h pcpu_chunk}(hjߖhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjܖubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsbc.pcpu_next_fit_regionasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hj hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hchunkh]hchunk}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hint alloc_bitsh](j)}(hinth]hint}(hj3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/ubj)}(h h]h }(hjAhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/ubj)}(h alloc_bitsh]h alloc_bits}(hjOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(h int alignh](j)}(hinth]hint}(hjhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjdubj)}(h h]h }(hjvhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjdubj)}(halignh]halign}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjdubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(h int *bit_offh](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hbit_offh]hbit_off}(hjƗhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(h int *bitsh](j)}(hinth]hint}(hjߗhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjۗubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjۗubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjۗubj)}(hbitsh]hbits}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjۗubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj|hhhjhMubah}(h]jwah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjyhhubj4)}(hhh]jM)}(h.finds fit areas for a given allocation requesth]h.finds fit areas for a given allocation request}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhj/hhubah}(h]h ]h"]h$]h&]uh1j3hjyhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjJjHjJjIjJjKuh1hhhhjKhNhNubj)}(hX!**Parameters** ``struct pcpu_chunk *chunk`` chunk of interest ``int alloc_bits`` size of allocation ``int align`` alignment of area (max PAGE_SIZE) ``int *bit_off`` chunk offset ``int *bits`` size of free area **Description** Finds the next free region that is viable for use with a given size and alignment. This only returns if there is a valid area to be used for this allocation. block->first_free is returned if the allocation request fits within the block to see if the request can be fulfilled prior to the contig hint.h](jM)}(h**Parameters**h]j)}(hjTh]h Parameters}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjRubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjNubj)}(hhh](j)}(h/``struct pcpu_chunk *chunk`` chunk of interest h](j)}(h``struct pcpu_chunk *chunk``h]jS)}(hjsh]hstruct pcpu_chunk *chunk}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjqubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjmubj)}(hhh]jM)}(hchunk of interesth]hchunk of interest}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjmubeh}(h]h ]h"]h$]h&]uh1jhjhMhjjubj)}(h&``int alloc_bits`` size of allocation h](j)}(h``int alloc_bits``h]jS)}(hjh]hint alloc_bits}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjubj)}(hhh]jM)}(hsize of allocationh]hsize of allocation}(hjŘhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhj˜ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjjubj)}(h0``int align`` alignment of area (max PAGE_SIZE) h](j)}(h ``int align``h]jS)}(hjh]h int align}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjߘubj)}(hhh]jM)}(h!alignment of area (max PAGE_SIZE)h]h!alignment of area (max PAGE_SIZE)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjߘubeh}(h]h ]h"]h$]h&]uh1jhjhMhjjubj)}(h``int *bit_off`` chunk offset h](j)}(h``int *bit_off``h]jS)}(hjh]h int *bit_off}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjubj)}(hhh]jM)}(h chunk offseth]h chunk offset}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj3hMhj4ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj3hMhjjubj)}(h ``int *bits`` size of free area h](j)}(h ``int *bits``h]jS)}(hjWh]h int *bits}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjUubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjQubj)}(hhh]jM)}(hsize of free areah]hsize of free area}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjlhMhjmubah}(h]h ]h"]h$]h&]uh1jhjQubeh}(h]h ]h"]h$]h&]uh1jhjlhMhjjubeh}(h]h ]h"]h$]h&]uh1jhjNubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjNubjM)}(hX.Finds the next free region that is viable for use with a given size and alignment. This only returns if there is a valid area to be used for this allocation. block->first_free is returned if the allocation request fits within the block to see if the request can be fulfilled prior to the contig hint.h]hX.Finds the next free region that is viable for use with a given size and alignment. This only returns if there is a valid area to be used for this allocation. block->first_free is returned if the allocation request fits within the block to see if the request can be fulfilled prior to the contig hint.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjNubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hpcpu_mem_zalloc (C function)c.pcpu_mem_zallochNtauh1hhjKhhhNhNubh)}(hhh](h)}(h/void * pcpu_mem_zalloc (size_t size, gfp_t gfp)h]h)}(h-void *pcpu_mem_zalloc(size_t size, gfp_t gfp)h](j)}(hvoidh]hvoid}(hjיhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjәhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjәhhhjhMubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjәhhhjhMubh)}(hpcpu_mem_zalloch]j)}(hpcpu_mem_zalloch]hpcpu_mem_zalloc}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjәhhhjhMubj8)}(h(size_t size, gfp_t gfp)h](j>)}(h size_t sizeh](h)}(hhh]j)}(hsize_th]hsize_t}(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj&modnameN classnameNjj)}j]j)}jjsbc.pcpu_mem_zallocasbuh1hhjubj)}(h h]h }(hjDhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hsizeh]hsize}(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(h gfp_t gfph](h)}(hhh]j)}(hgfp_th]hgfp_t}(hjnhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjkubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjpmodnameN classnameNjj)}j]j@c.pcpu_mem_zallocasbuh1hhjgubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubj)}(hgfph]hgfp}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjәhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjϙhhhjhMubah}(h]jʙah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhj̙hhubj4)}(hhh]jM)}(hallocate memoryh]hallocate memory}(hjĚhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjhhubah}(h]h ]h"]h$]h&]uh1j3hj̙hhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjܚjHjܚjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``size_t size`` bytes to allocate ``gfp_t gfp`` allocation flags **Description** Allocate **size** bytes. If **size** is smaller than PAGE_SIZE, kzalloc() is used; otherwise, the equivalent of vzalloc() is used. This is to facilitate passing through whitelisted flags. The returned memory is always zeroed. **Return** Pointer to the allocated area on success, NULL on failure.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjubj)}(hhh](j)}(h"``size_t size`` bytes to allocate h](j)}(h``size_t size``h]jS)}(hjh]h size_t size}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjubj)}(hhh]jM)}(hbytes to allocateh]hbytes to allocate}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h``gfp_t gfp`` allocation flags h](j)}(h ``gfp_t gfp``h]jS)}(hj>h]h gfp_t gfp}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj<ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhj8ubj)}(hhh]jM)}(hallocation flagsh]hallocation flags}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjShMhjTubah}(h]h ]h"]h$]h&]uh1jhj8ubeh}(h]h ]h"]h$]h&]uh1jhjShMhjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjyh]h Description}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjwubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjubjM)}(hAllocate **size** bytes. If **size** is smaller than PAGE_SIZE, kzalloc() is used; otherwise, the equivalent of vzalloc() is used. This is to facilitate passing through whitelisted flags. The returned memory is always zeroed.h](h Allocate }(hjhhhNhNubj)}(h**size**h]hsize}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh bytes. If }(hjhhhNhNubj)}(h**size**h]hsize}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh is smaller than PAGE_SIZE, kzalloc() is used; otherwise, the equivalent of vzalloc() is used. This is to facilitate passing through whitelisted flags. The returned memory is always zeroed.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjubjM)}(h **Return**h]j)}(hjěh]hReturn}(hjƛhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj›ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjubjM)}(h:Pointer to the allocated area on success, NULL on failure.h]h:Pointer to the allocated area on success, NULL on failure.}(hjڛhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hpcpu_mem_free (C function)c.pcpu_mem_freehNtauh1hhjKhhhNhNubh)}(hhh](h)}(hvoid pcpu_mem_free (void *ptr)h]h)}(hvoid pcpu_mem_free(void *ptr)h](j)}(hvoidh]hvoid}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh)}(h pcpu_mem_freeh]j)}(h pcpu_mem_freeh]h pcpu_mem_free}(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMubj8)}(h (void *ptr)h]j>)}(h void *ptrh](j)}(hvoidh]hvoid}(hjFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubj)}(h h]h }(hjThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubjr)}(hjuh]h*}(hjbhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjBubj)}(hptrh]hptr}(hjohhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj>ubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]jM)}(h free memoryh]h free memory}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``void *ptr`` memory to free **Description** Free **ptr**. **ptr** should have been allocated using pcpu_mem_zalloc().h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjubj)}(hhh]j)}(h``void *ptr`` memory to free h](j)}(h ``void *ptr``h]jS)}(hjڜh]h void *ptr}(hjܜhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj؜ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjԜubj)}(hhh]jM)}(hmemory to freeh]hmemory to free}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjԜubeh}(h]h ]h"]h$]h&]uh1jhjhMhjќubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjubjM)}(hJFree **ptr**. **ptr** should have been allocated using pcpu_mem_zalloc().h](hFree }(hj+hhhNhNubj)}(h**ptr**h]hptr}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj+ubh. }(hj+hhhNhNubj)}(h**ptr**h]hptr}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj+ubh4 should have been allocated using pcpu_mem_zalloc().}(hj+hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h pcpu_chunk_relocate (C function)c.pcpu_chunk_relocatehNtauh1hhjKhhhNhNubh)}(hhh](h)}(h>void pcpu_chunk_relocate (struct pcpu_chunk *chunk, int oslot)h]h)}(h=void pcpu_chunk_relocate(struct pcpu_chunk *chunk, int oslot)h](j)}(hvoidh]hvoid}(hj~hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjzhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjzhhhjhMubh)}(hpcpu_chunk_relocateh]j)}(hpcpu_chunk_relocateh]hpcpu_chunk_relocate}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjzhhhjhMubj8)}(h%(struct pcpu_chunk *chunk, int oslot)h](j>)}(hstruct pcpu_chunk *chunkh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjȝhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(h pcpu_chunkh]h pcpu_chunk}(hjٝhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj֝ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj۝modnameN classnameNjj)}j]j)}jjsbc.pcpu_chunk_relocateasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hchunkh]hchunk}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(h int osloth](j)}(hinth]hint}(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubj)}(h h]h }(hj;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubj)}(hosloth]hoslot}(hjIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjzhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjvhhhjhMubah}(h]jqah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjshhubj4)}(hhh]jM)}(h'put chunk in the appropriate chunk sloth]h'put chunk in the appropriate chunk slot}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjphhubah}(h]h ]h"]h$]h&]uh1j3hjshhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hXt**Parameters** ``struct pcpu_chunk *chunk`` chunk of interest ``int oslot`` the previous slot it was on **Description** This function is called after an allocation or free changed **chunk**. New slot according to the changed state is determined and **chunk** is moved to the slot. Note that the reserved chunk is never put on chunk slots. **Context** pcpu_lock.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM#hjubj)}(hhh](j)}(h/``struct pcpu_chunk *chunk`` chunk of interest h](j)}(h``struct pcpu_chunk *chunk``h]jS)}(hjh]hstruct pcpu_chunk *chunk}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM hjubj)}(hhh]jM)}(hchunk of interesth]hchunk of interest}(hj͞hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjɞhM hjʞubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjɞhM hjubj)}(h*``int oslot`` the previous slot it was on h](j)}(h ``int oslot``h]jS)}(hjh]h int oslot}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM!hjubj)}(hhh]jM)}(hthe previous slot it was onh]hthe previous slot it was on}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM!hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM!hjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hj(h]h Description}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj&ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM#hjubjM)}(hThis function is called after an allocation or free changed **chunk**. New slot according to the changed state is determined and **chunk** is moved to the slot. Note that the reserved chunk is never put on chunk slots.h](hhhhNhNubj)}(h **chunk**h]hchunk}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj>ubh<. New slot according to the changed state is determined and }(hj>hhhNhNubj)}(h **chunk**h]hchunk}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj>ubhQ is moved to the slot. Note that the reserved chunk is never put on chunk slots.}(hj>hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM"hjubjM)}(h **Context**h]j)}(hjsh]hContext}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjqubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM'hjubjM)}(h pcpu_lock.h]h pcpu_lock.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM(hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hpcpu_block_update (C function)c.pcpu_block_updatehNtauh1hhjKhhhNhNubh)}(hhh](h)}(hHvoid pcpu_block_update (struct pcpu_block_md *block, int start, int end)h]h)}(hGvoid pcpu_block_update(struct pcpu_block_md *block, int start, int end)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMmubj)}(h h]h }(hjǟhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjƟhMmubh)}(hpcpu_block_updateh]j)}(hpcpu_block_updateh]hpcpu_block_update}(hjٟhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj՟ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjƟhMmubj8)}(h1(struct pcpu_block_md *block, int start, int end)h](j>)}(hstruct pcpu_block_md *blockh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(h pcpu_block_mdh]h pcpu_block_md}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jj۟sbc.pcpu_block_updateasbuh1hhjubj)}(h h]h }(hj3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjAhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hblockh]hblock}(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(h int starth](j)}(hinth]hint}(hjghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjcubj)}(h h]h }(hjuhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjcubj)}(hstarth]hstart}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjcubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hint endh](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hendh]hend}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjƟhMmubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjƟhMmubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjƟhMmhjhhubj4)}(hhh]jM)}(h!updates a block given a free areah]h!updates a block given a free area}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMmhjߠhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjƟhMmubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hXb**Parameters** ``struct pcpu_block_md *block`` block of interest ``int start`` start offset in block ``int end`` end offset in block **Description** Updates a block given a known free area. The region [start, end) is expected to be the entirety of the free area within a block. Chooses the best starting offset if the contig hints are equal.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMqhjubj)}(hhh](j)}(h2``struct pcpu_block_md *block`` block of interest h](j)}(h``struct pcpu_block_md *block``h]jS)}(hj#h]hstruct pcpu_block_md *block}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj!ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMnhjubj)}(hhh]jM)}(hblock of interesth]hblock of interest}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj8hMnhj9ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj8hMnhjubj)}(h$``int start`` start offset in block h](j)}(h ``int start``h]jS)}(hj\h]h int start}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjZubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMohjVubj)}(hhh]jM)}(hstart offset in blockh]hstart offset in block}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjqhMohjrubah}(h]h ]h"]h$]h&]uh1jhjVubeh}(h]h ]h"]h$]h&]uh1jhjqhMohjubj)}(h ``int end`` end offset in block h](j)}(h ``int end``h]jS)}(hjh]hint end}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMphjubj)}(hhh]jM)}(hend offset in blockh]hend offset in block}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMphjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMphjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjСh]h Description}(hjҡhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjΡubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMrhjubjM)}(hUpdates a block given a known free area. The region [start, end) is expected to be the entirety of the free area within a block. Chooses the best starting offset if the contig hints are equal.h]hUpdates a block given a known free area. The region [start, end) is expected to be the entirety of the free area within a block. Chooses the best starting offset if the contig hints are equal.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMqhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h$pcpu_chunk_refresh_hint (C function)c.pcpu_chunk_refresh_hinthNtauh1hhjKhhhNhNubh)}(hhh](h)}(hGvoid pcpu_chunk_refresh_hint (struct pcpu_chunk *chunk, bool full_scan)h]h)}(hFvoid pcpu_chunk_refresh_hint(struct pcpu_chunk *chunk, bool full_scan)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMubj)}(h h]h }(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhj#hMubh)}(hpcpu_chunk_refresh_hinth]j)}(hpcpu_chunk_refresh_hinth]hpcpu_chunk_refresh_hint}(hj6hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhj#hMubj8)}(h*(struct pcpu_chunk *chunk, bool full_scan)h](j>)}(hstruct pcpu_chunk *chunkh](j)}(hjJ,h]hstruct}(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubj)}(h h]h }(hj_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubh)}(hhh]j)}(h pcpu_chunkh]h pcpu_chunk}(hjphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjrmodnameN classnameNjj)}j]j)}jj8sbc.pcpu_chunk_refresh_hintasbuh1hhjNubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjNubj)}(hchunkh]hchunk}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjJubj>)}(hbool full_scanh](j)}(hjh]hbool}(hjĢhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjѢhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h full_scanh]h full_scan}(hjߢhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjJubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhj#hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj hhhj#hMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj#hMhj hhubj4)}(hhh]jM)}(hupdates metadata about a chunkh]hupdates metadata about a chunk}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjhhubah}(h]h ]h"]h$]h&]uh1j3hj hhhj#hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj!jHj!jIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct pcpu_chunk *chunk`` chunk of interest ``bool full_scan`` if we should scan from the beginning **Description** Iterates over the metadata blocks to find the largest contig area. A full scan can be avoided on the allocation path as this is triggered if we broke the contig_hint. In doing so, the scan_hint will be before the contig_hint or after if the scan_hint == contig_hint. This cannot be prevented on freeing as we want to find the largest area possibly spanning blocks.h](jM)}(h**Parameters**h]j)}(hj+h]h Parameters}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj)ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhj%ubj)}(hhh](j)}(h/``struct pcpu_chunk *chunk`` chunk of interest h](j)}(h``struct pcpu_chunk *chunk``h]jS)}(hjJh]hstruct pcpu_chunk *chunk}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjHubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjDubj)}(hhh]jM)}(hchunk of interesth]hchunk of interest}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj_hMhj`ubah}(h]h ]h"]h$]h&]uh1jhjDubeh}(h]h ]h"]h$]h&]uh1jhj_hMhjAubj)}(h8``bool full_scan`` if we should scan from the beginning h](j)}(h``bool full_scan``h]jS)}(hjh]hbool full_scan}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhj}ubj)}(hhh]jM)}(h$if we should scan from the beginningh]h$if we should scan from the beginning}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhj}ubeh}(h]h ]h"]h$]h&]uh1jhjhMhjAubeh}(h]h ]h"]h$]h&]uh1jhj%ubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhj%ubjM)}(hXnIterates over the metadata blocks to find the largest contig area. A full scan can be avoided on the allocation path as this is triggered if we broke the contig_hint. In doing so, the scan_hint will be before the contig_hint or after if the scan_hint == contig_hint. This cannot be prevented on freeing as we want to find the largest area possibly spanning blocks.h]hXnIterates over the metadata blocks to find the largest contig area. A full scan can be avoided on the allocation path as this is triggered if we broke the contig_hint. In doing so, the scan_hint will be before the contig_hint or after if the scan_hint == contig_hint. This cannot be prevented on freeing as we want to find the largest area possibly spanning blocks.}(hjԣhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhj%ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h$pcpu_block_refresh_hint (C function)c.pcpu_block_refresh_hinthNtauh1hhjKhhhNhNubh)}(hhh](h)}(hBvoid pcpu_block_refresh_hint (struct pcpu_chunk *chunk, int index)h]h)}(hAvoid pcpu_block_refresh_hint(struct pcpu_chunk *chunk, int index)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh)}(hpcpu_block_refresh_hinth]j)}(hpcpu_block_refresh_hinth]hpcpu_block_refresh_hint}(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMubj8)}(h%(struct pcpu_chunk *chunk, int index)h](j>)}(hstruct pcpu_chunk *chunkh](j)}(hjJ,h]hstruct}(hj@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj<ubj)}(h h]h }(hjMhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj<ubh)}(hhh]j)}(h pcpu_chunkh]h pcpu_chunk}(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj[ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj`modnameN classnameNjj)}j]j)}jj&sbc.pcpu_block_refresh_hintasbuh1hhj<ubj)}(h h]h }(hj~hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj<ubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj<ubj)}(hchunkh]hchunk}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj<ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj8ubj>)}(h int indexh](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hindexh]hindex}(hjΤhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj8ubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]h}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``struct pcpu_chunk *chunk`` chunk of interest ``int index`` index of the metadata block **Description** Scans over the block beginning at first_free and updates the block metadata accordingly.h](jM)}(h**Parameters**h]j)}(hj h]h Parameters}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjubj)}(hhh](j)}(h/``struct pcpu_chunk *chunk`` chunk of interest h](j)}(h``struct pcpu_chunk *chunk``h]jS)}(hj*h]hstruct pcpu_chunk *chunk}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj(ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhj$ubj)}(hhh]jM)}(hchunk of interesth]hchunk of interest}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj?hMhj@ubah}(h]h ]h"]h$]h&]uh1jhj$ubeh}(h]h ]h"]h$]h&]uh1jhj?hMhj!ubj)}(h*``int index`` index of the metadata block h](j)}(h ``int index``h]jS)}(hjch]h int index}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjaubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhj]ubj)}(hhh]jM)}(hindex of the metadata blockh]hindex of the metadata block}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjxhMhjyubah}(h]h ]h"]h$]h&]uh1jhj]ubeh}(h]h ]h"]h$]h&]uh1jhjxhMhj!ubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjubjM)}(hXScans over the block beginning at first_free and updates the block metadata accordingly.h]hXScans over the block beginning at first_free and updates the block metadata accordingly.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h)pcpu_block_update_hint_alloc (C function)c.pcpu_block_update_hint_allochNtauh1hhjKhhhNhNubh)}(hhh](h)}(hSvoid pcpu_block_update_hint_alloc (struct pcpu_chunk *chunk, int bit_off, int bits)h]h)}(hRvoid pcpu_block_update_hint_alloc(struct pcpu_chunk *chunk, int bit_off, int bits)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjߥhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjߥhhhjhMubh)}(hpcpu_block_update_hint_alloch]j)}(hpcpu_block_update_hint_alloch]hpcpu_block_update_hint_alloc}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjߥhhhjhMubj8)}(h1(struct pcpu_chunk *chunk, int bit_off, int bits)h](j>)}(hstruct pcpu_chunk *chunkh](j)}(hjJ,h]hstruct}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(h pcpu_chunkh]h pcpu_chunk}(hj>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj@modnameN classnameNjj)}j]j)}jjsbc.pcpu_block_update_hint_allocasbuh1hhjubj)}(h h]h }(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjlhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hchunkh]hchunk}(hjyhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(h int bit_offh](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hbit_offh]hbit_off}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hint bitsh](j)}(hinth]hint}(hjǦhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjæubj)}(h h]h }(hjզhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjæubj)}(hbitsh]hbits}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjæubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjߥhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjۥhhhjhMubah}(h]j֥ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjإhhubj4)}(hhh]jM)}(hupdate hint on allocation pathh]hupdate hint on allocation path}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhj hhubah}(h]h ]h"]h$]h&]uh1j3hjإhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj%jHj%jIjJjKuh1hhhhjKhNhNubj)}(hX_**Parameters** ``struct pcpu_chunk *chunk`` chunk of interest ``int bit_off`` chunk offset ``int bits`` size of request **Description** Updates metadata for the allocation path. The metadata only has to be refreshed by a full scan iff the chunk's contig hint is broken. Block level scans are required if the block's contig hint is broken.h](jM)}(h**Parameters**h]j)}(hj/h]h Parameters}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj-ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM"hj)ubj)}(hhh](j)}(h/``struct pcpu_chunk *chunk`` chunk of interest h](j)}(h``struct pcpu_chunk *chunk``h]jS)}(hjNh]hstruct pcpu_chunk *chunk}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjLubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjHubj)}(hhh]jM)}(hchunk of interesth]hchunk of interest}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjchMhjdubah}(h]h ]h"]h$]h&]uh1jhjHubeh}(h]h ]h"]h$]h&]uh1jhjchMhjEubj)}(h``int bit_off`` chunk offset h](j)}(h``int bit_off``h]jS)}(hjh]h int bit_off}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM hjubj)}(hhh]jM)}(h chunk offseth]h chunk offset}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hjEubj)}(h``int bits`` size of request h](j)}(h ``int bits``h]jS)}(hjh]hint bits}(hj§hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM!hjubj)}(hhh]jM)}(hsize of requesth]hsize of request}(hj٧hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjէhM!hj֧ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjէhM!hjEubeh}(h]h ]h"]h$]h&]uh1jhj)ubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM#hj)ubjM)}(hUpdates metadata for the allocation path. The metadata only has to be refreshed by a full scan iff the chunk's contig hint is broken. Block level scans are required if the block's contig hint is broken.h]hUpdates metadata for the allocation path. The metadata only has to be refreshed by a full scan iff the chunk’s contig hint is broken. Block level scans are required if the block’s contig hint is broken.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM"hj)ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h(pcpu_block_update_hint_free (C function)c.pcpu_block_update_hint_freehNtauh1hhjKhhhNhNubh)}(hhh](h)}(hRvoid pcpu_block_update_hint_free (struct pcpu_chunk *chunk, int bit_off, int bits)h]h)}(hQvoid pcpu_block_update_hint_free(struct pcpu_chunk *chunk, int bit_off, int bits)h](j)}(hvoidh]hvoid}(hj@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj<hhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMubj)}(h h]h }(hjOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj<hhhjNhMubh)}(hpcpu_block_update_hint_freeh]j)}(hpcpu_block_update_hint_freeh]hpcpu_block_update_hint_free}(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj]ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj<hhhjNhMubj8)}(h1(struct pcpu_chunk *chunk, int bit_off, int bits)h](j>)}(hstruct pcpu_chunk *chunkh](j)}(hjJ,h]hstruct}(hj}hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyubh)}(hhh]j)}(h pcpu_chunkh]h pcpu_chunk}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjcsbc.pcpu_block_update_hint_freeasbuh1hhjyubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyubjr)}(hjuh]h*}(hjɨhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjyubj)}(hchunkh]hchunk}(hj֨hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjuubj>)}(h int bit_offh](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hbit_offh]hbit_off}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjuubj>)}(hint bitsh](j)}(hinth]hint}(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h h]h }(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(hbitsh]hbits}(hj@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjuubeh}(h]h ]h"]h$]h&]jjuh1j7hj<hhhjNhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj8hhhjNhMubah}(h]j3ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjNhMhj5hhubj4)}(hhh]jM)}(h(updates the block hints on the free pathh]h(updates the block hints on the free path}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjghhubah}(h]h ]h"]h$]h&]uh1j3hj5hhhjNhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct pcpu_chunk *chunk`` chunk of interest ``int bit_off`` chunk offset ``int bits`` size of request **Description** Updates metadata for the allocation path. This avoids a blind block refresh by making use of the block contig hints. If this fails, it scans forward and backward to determine the extent of the free area. This is capped at the boundary of blocks. A chunk update is triggered if a page becomes free, a block becomes free, or the free spans across blocks. This tradeoff is to minimize iterating over the block metadata to update chunk_md->contig_hint. chunk_md->contig_hint may be off by up to a page, but it will never be more than the available space. If the contig hint is contained in one block, it will be accurate.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjubj)}(hhh](j)}(h/``struct pcpu_chunk *chunk`` chunk of interest h](j)}(h``struct pcpu_chunk *chunk``h]jS)}(hjh]hstruct pcpu_chunk *chunk}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjubj)}(hhh]jM)}(hchunk of interesth]hchunk of interest}(hjĩhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h``int bit_off`` chunk offset h](j)}(h``int bit_off``h]jS)}(hjh]h int bit_off}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjީubj)}(hhh]jM)}(h chunk offseth]h chunk offset}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjީubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h``int bits`` size of request h](j)}(h ``int bits``h]jS)}(hjh]hint bits}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjubj)}(hhh]jM)}(hsize of requesth]hsize of request}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj2hMhj3ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj2hMhjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjXh]h Description}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjVubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjubjM)}(hUpdates metadata for the allocation path. This avoids a blind block refresh by making use of the block contig hints. If this fails, it scans forward and backward to determine the extent of the free area. This is capped at the boundary of blocks.h]hUpdates metadata for the allocation path. This avoids a blind block refresh by making use of the block contig hints. If this fails, it scans forward and backward to determine the extent of the free area. This is capped at the boundary of blocks.}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjubjM)}(hXuA chunk update is triggered if a page becomes free, a block becomes free, or the free spans across blocks. This tradeoff is to minimize iterating over the block metadata to update chunk_md->contig_hint. chunk_md->contig_hint may be off by up to a page, but it will never be more than the available space. If the contig hint is contained in one block, it will be accurate.h]hXuA chunk update is triggered if a page becomes free, a block becomes free, or the free spans across blocks. This tradeoff is to minimize iterating over the block metadata to update chunk_md->contig_hint. chunk_md->contig_hint may be off by up to a page, but it will never be more than the available space. If the contig hint is contained in one block, it will be accurate.}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hpcpu_is_populated (C function)c.pcpu_is_populatedhNtauh1hhjKhhhNhNubh)}(hhh](h)}(hWbool pcpu_is_populated (struct pcpu_chunk *chunk, int bit_off, int bits, int *next_off)h]h)}(hVbool pcpu_is_populated(struct pcpu_chunk *chunk, int bit_off, int bits, int *next_off)h](j)}(hjh]hbool}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM$ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM$ubh)}(hpcpu_is_populatedh]j)}(hpcpu_is_populatedh]hpcpu_is_populated}(hj̪hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjȪubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhM$ubj8)}(h@(struct pcpu_chunk *chunk, int bit_off, int bits, int *next_off)h](j>)}(hstruct pcpu_chunk *chunkh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(h pcpu_chunkh]h pcpu_chunk}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjΪsbc.pcpu_is_populatedasbuh1hhjubj)}(h h]h }(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hj4hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hchunkh]hchunk}(hjAhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(h int bit_offh](j)}(hinth]hint}(hjZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVubj)}(h h]h }(hjhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVubj)}(hbit_offh]hbit_off}(hjvhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hint bitsh](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hbitsh]hbits}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(h int *next_offh](j)}(hinth]hint}(hjīhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjҫhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hnext_offh]hnext_off}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhM$ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhM$ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhM$hjhhubj4)}(hhh]jM)}(h%determines if the region is populatedh]h%determines if the region is populated}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM$hjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhM$ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj/jHj/jIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct pcpu_chunk *chunk`` chunk of interest ``int bit_off`` chunk offset ``int bits`` size of area ``int *next_off`` return value for the next offset to start searching **Description** For atomic allocations, check if the backing pages are populated. **Return** Bool if the backing pages are populated. next_index is to skip over unpopulated blocks in pcpu_find_block_fit.h](jM)}(h**Parameters**h]j)}(hj9h]h Parameters}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj7ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM(hj3ubj)}(hhh](j)}(h/``struct pcpu_chunk *chunk`` chunk of interest h](j)}(h``struct pcpu_chunk *chunk``h]jS)}(hjXh]hstruct pcpu_chunk *chunk}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjVubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM%hjRubj)}(hhh]jM)}(hchunk of interesth]hchunk of interest}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjmhM%hjnubah}(h]h ]h"]h$]h&]uh1jhjRubeh}(h]h ]h"]h$]h&]uh1jhjmhM%hjOubj)}(h``int bit_off`` chunk offset h](j)}(h``int bit_off``h]jS)}(hjh]h int bit_off}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM&hjubj)}(hhh]jM)}(h chunk offseth]h chunk offset}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM&hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM&hjOubj)}(h``int bits`` size of area h](j)}(h ``int bits``h]jS)}(hjʬh]hint bits}(hj̬hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjȬubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM'hjĬubj)}(hhh]jM)}(h size of areah]h size of area}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj߬hM'hjubah}(h]h ]h"]h$]h&]uh1jhjĬubeh}(h]h ]h"]h$]h&]uh1jhj߬hM'hjOubj)}(hF``int *next_off`` return value for the next offset to start searching h](j)}(h``int *next_off``h]jS)}(hjh]h int *next_off}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM(hjubj)}(hhh]jM)}(h3return value for the next offset to start searchingh]h3return value for the next offset to start searching}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM(hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM(hjOubeh}(h]h ]h"]h$]h&]uh1jhj3ubjM)}(h**Description**h]j)}(hj>h]h Description}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj<ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM*hj3ubjM)}(hAFor atomic allocations, check if the backing pages are populated.h]hAFor atomic allocations, check if the backing pages are populated.}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM)hj3ubjM)}(h **Return**h]j)}(hjeh]hReturn}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1jhjcubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM+hj3ubjM)}(hnBool if the backing pages are populated. next_index is to skip over unpopulated blocks in pcpu_find_block_fit.h]hnBool if the backing pages are populated. next_index is to skip over unpopulated blocks in pcpu_find_block_fit.}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM,hj3ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h pcpu_find_block_fit (C function)c.pcpu_find_block_fithNtauh1hhjKhhhNhNubh)}(hhh](h)}(h_int pcpu_find_block_fit (struct pcpu_chunk *chunk, int alloc_bits, size_t align, bool pop_only)h]h)}(h^int pcpu_find_block_fit(struct pcpu_chunk *chunk, int alloc_bits, size_t align, bool pop_only)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMCubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMCubh)}(hpcpu_find_block_fith]j)}(hpcpu_find_block_fith]hpcpu_find_block_fit}(hj˭hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjǭubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMCubj8)}(hG(struct pcpu_chunk *chunk, int alloc_bits, size_t align, bool pop_only)h](j>)}(hstruct pcpu_chunk *chunkh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(h pcpu_chunkh]h pcpu_chunk}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjͭsbc.pcpu_find_block_fitasbuh1hhjubj)}(h h]h }(hj%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hj3hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hchunkh]hchunk}(hj@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj߭ubj>)}(hint alloc_bitsh](j)}(hinth]hint}(hjYhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjUubj)}(h h]h }(hjghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjUubj)}(h alloc_bitsh]h alloc_bits}(hjuhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjUubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj߭ubj>)}(h size_t alignh](h)}(hhh]j)}(hsize_th]hsize_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j!c.pcpu_find_block_fitasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(halignh]halign}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj߭ubj>)}(h bool pop_onlyh](j)}(hjh]hbool}(hj֮hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjҮubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjҮubj)}(hpop_onlyh]hpop_only}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjҮubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj߭ubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMCubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMCubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMChjhhubj4)}(hhh]jM)}(h(finds the block index to start searchingh]h(finds the block index to start searching}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMChjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMCubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj3jHj3jIjJjKuh1hhhhjKhNhNubj)}(hX0**Parameters** ``struct pcpu_chunk *chunk`` chunk of interest ``int alloc_bits`` size of request in allocation units ``size_t align`` alignment of area (max PAGE_SIZE bytes) ``bool pop_only`` use populated regions only **Description** Given a chunk and an allocation spec, find the offset to begin searching for a free region. This iterates over the bitmap metadata blocks to find an offset that will be guaranteed to fit the requirements. It is not quite first fit as if the allocation does not fit in the contig hint of a block or chunk, it is skipped. This errs on the side of caution to prevent excess iteration. Poor alignment can cause the allocator to skip over blocks and chunks that have valid free areas. **Return** The offset in the bitmap to begin searching. -1 if no offset is found.h](jM)}(h**Parameters**h]j)}(hj=h]h Parameters}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj;ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMGhj7ubj)}(hhh](j)}(h/``struct pcpu_chunk *chunk`` chunk of interest h](j)}(h``struct pcpu_chunk *chunk``h]jS)}(hj\h]hstruct pcpu_chunk *chunk}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjZubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMDhjVubj)}(hhh]jM)}(hchunk of interesth]hchunk of interest}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjqhMDhjrubah}(h]h ]h"]h$]h&]uh1jhjVubeh}(h]h ]h"]h$]h&]uh1jhjqhMDhjSubj)}(h7``int alloc_bits`` size of request in allocation units h](j)}(h``int alloc_bits``h]jS)}(hjh]hint alloc_bits}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMEhjubj)}(hhh]jM)}(h#size of request in allocation unitsh]h#size of request in allocation units}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMEhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMEhjSubj)}(h9``size_t align`` alignment of area (max PAGE_SIZE bytes) h](j)}(h``size_t align``h]jS)}(hjίh]h size_t align}(hjЯhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj̯ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMFhjȯubj)}(hhh]jM)}(h'alignment of area (max PAGE_SIZE bytes)h]h'alignment of area (max PAGE_SIZE bytes)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMFhjubah}(h]h ]h"]h$]h&]uh1jhjȯubeh}(h]h ]h"]h$]h&]uh1jhjhMFhjSubj)}(h-``bool pop_only`` use populated regions only h](j)}(h``bool pop_only``h]jS)}(hjh]h bool pop_only}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMGhjubj)}(hhh]jM)}(huse populated regions onlyh]huse populated regions only}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMGhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMGhjSubeh}(h]h ]h"]h$]h&]uh1jhj7ubjM)}(h**Description**h]j)}(hjBh]h Description}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj@ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMIhj7ubjM)}(hXGiven a chunk and an allocation spec, find the offset to begin searching for a free region. This iterates over the bitmap metadata blocks to find an offset that will be guaranteed to fit the requirements. It is not quite first fit as if the allocation does not fit in the contig hint of a block or chunk, it is skipped. This errs on the side of caution to prevent excess iteration. Poor alignment can cause the allocator to skip over blocks and chunks that have valid free areas.h]hXGiven a chunk and an allocation spec, find the offset to begin searching for a free region. This iterates over the bitmap metadata blocks to find an offset that will be guaranteed to fit the requirements. It is not quite first fit as if the allocation does not fit in the contig hint of a block or chunk, it is skipped. This errs on the side of caution to prevent excess iteration. Poor alignment can cause the allocator to skip over blocks and chunks that have valid free areas.}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMHhj7ubjM)}(h **Return**h]j)}(hjih]hReturn}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjgubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMPhj7ubjM)}(hFThe offset in the bitmap to begin searching. -1 if no offset is found.h]hFThe offset in the bitmap to begin searching. -1 if no offset is found.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMQhj7ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hpcpu_alloc_area (C function)c.pcpu_alloc_areahNtauh1hhjKhhhNhNubh)}(hhh](h)}(hWint pcpu_alloc_area (struct pcpu_chunk *chunk, int alloc_bits, size_t align, int start)h]h)}(hVint pcpu_alloc_area(struct pcpu_chunk *chunk, int alloc_bits, size_t align, int start)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh)}(hpcpu_alloc_areah]j)}(hpcpu_alloc_areah]hpcpu_alloc_area}(hjϰhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj˰ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMubj8)}(hC(struct pcpu_chunk *chunk, int alloc_bits, size_t align, int start)h](j>)}(hstruct pcpu_chunk *chunkh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(h pcpu_chunkh]h pcpu_chunk}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj modnameN classnameNjj)}j]j)}jjѰsbc.pcpu_alloc_areaasbuh1hhjubj)}(h h]h }(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hj7hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hchunkh]hchunk}(hjDhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hint alloc_bitsh](j)}(hinth]hint}(hj]hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjYubj)}(h h]h }(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjYubj)}(h alloc_bitsh]h alloc_bits}(hjyhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjYubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(h size_t alignh](h)}(hhh]j)}(hsize_th]hsize_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j%c.pcpu_alloc_areaasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(halignh]halign}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(h int starth](j)}(hinth]hint}(hjڱhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjֱubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjֱubj)}(hstarth]hstart}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjֱubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]jM)}(h#allocates an area from a pcpu_chunkh]h#allocates an area from a pcpu_chunk}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj8jHj8jIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct pcpu_chunk *chunk`` chunk of interest ``int alloc_bits`` size of request in allocation units ``size_t align`` alignment of area (max PAGE_SIZE) ``int start`` bit_off to start searching **Description** This function takes in a **start** offset to begin searching to fit an allocation of **alloc_bits** with alignment **align**. It needs to scan the allocation map because if it fits within the block's contig hint, **start** will be block->first_free. This is an attempt to fill the allocation prior to breaking the contig hint. The allocation and boundary maps are updated accordingly if it confirms a valid free area. **Return** Allocated addr offset in **chunk** on success. -1 if no matching area is found.h](jM)}(h**Parameters**h]j)}(hjBh]h Parameters}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj@ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhj<ubj)}(hhh](j)}(h/``struct pcpu_chunk *chunk`` chunk of interest h](j)}(h``struct pcpu_chunk *chunk``h]jS)}(hjah]hstruct pcpu_chunk *chunk}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj_ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhj[ubj)}(hhh]jM)}(hchunk of interesth]hchunk of interest}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjvhMhjwubah}(h]h ]h"]h$]h&]uh1jhj[ubeh}(h]h ]h"]h$]h&]uh1jhjvhMhjXubj)}(h7``int alloc_bits`` size of request in allocation units h](j)}(h``int alloc_bits``h]jS)}(hjh]hint alloc_bits}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjubj)}(hhh]jM)}(h#size of request in allocation unitsh]h#size of request in allocation units}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjXubj)}(h3``size_t align`` alignment of area (max PAGE_SIZE) h](j)}(h``size_t align``h]jS)}(hjӲh]h size_t align}(hjղhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjѲubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjͲubj)}(hhh]jM)}(h!alignment of area (max PAGE_SIZE)h]h!alignment of area (max PAGE_SIZE)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjͲubeh}(h]h ]h"]h$]h&]uh1jhjhMhjXubj)}(h)``int start`` bit_off to start searching h](j)}(h ``int start``h]jS)}(hj h]h int start}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjubj)}(hhh]jM)}(hbit_off to start searchingh]hbit_off to start searching}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj!hMhj"ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj!hMhjXubeh}(h]h ]h"]h$]h&]uh1jhj<ubjM)}(h**Description**h]j)}(hjGh]h Description}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjEubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhj<ubjM)}(hXThis function takes in a **start** offset to begin searching to fit an allocation of **alloc_bits** with alignment **align**. It needs to scan the allocation map because if it fits within the block's contig hint, **start** will be block->first_free. This is an attempt to fill the allocation prior to breaking the contig hint. The allocation and boundary maps are updated accordingly if it confirms a valid free area.h](hThis function takes in a }(hj]hhhNhNubj)}(h **start**h]hstart}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1jhj]ubh3 offset to begin searching to fit an allocation of }(hj]hhhNhNubj)}(h**alloc_bits**h]h alloc_bits}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj]ubh with alignment }(hj]hhhNhNubj)}(h **align**h]halign}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj]ubh\. It needs to scan the allocation map because if it fits within the block’s contig hint, }(hj]hhhNhNubj)}(h **start**h]hstart}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj]ubh will be block->first_free. This is an attempt to fill the allocation prior to breaking the contig hint. The allocation and boundary maps are updated accordingly if it confirms a valid free area.}(hj]hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhj<ubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhj<ubjM)}(hOAllocated addr offset in **chunk** on success. -1 if no matching area is found.h](hAllocated addr offset in }(hj̳hhhNhNubj)}(h **chunk**h]hchunk}(hjԳhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj̳ubh- on success. -1 if no matching area is found.}(hj̳hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhj<ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hpcpu_free_area (C function)c.pcpu_free_areahNtauh1hhjKhhhNhNubh)}(hhh](h)}(h6int pcpu_free_area (struct pcpu_chunk *chunk, int off)h]h)}(h5int pcpu_free_area(struct pcpu_chunk *chunk, int off)h](j)}(hinth]hint}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhjhMubh)}(hpcpu_free_areah]j)}(hpcpu_free_areah]hpcpu_free_area}(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj hhhjhMubj8)}(h#(struct pcpu_chunk *chunk, int off)h](j>)}(hstruct pcpu_chunk *chunkh](j)}(hjJ,h]hstruct}(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFubj)}(h h]h }(hjWhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFubh)}(hhh]j)}(h pcpu_chunkh]h pcpu_chunk}(hjhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjjmodnameN classnameNjj)}j]j)}jj0sbc.pcpu_free_areaasbuh1hhjFubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjFubj)}(hchunkh]hchunk}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjBubj>)}(hint offh](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjʴhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hoffh]hoff}(hjشhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjBubeh}(h]h ]h"]h$]h&]jjuh1j7hj hhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]jM)}(hfrees the corresponding offseth]hfrees the corresponding offset}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct pcpu_chunk *chunk`` chunk of interest ``int off`` addr offset into chunk **Description** This function determines the size of an allocation to free using the boundary bitmap and clears the allocation map. **Return** Number of freed bytes.h](jM)}(h**Parameters**h]j)}(hj$h]h Parameters}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj"ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjubj)}(hhh](j)}(h/``struct pcpu_chunk *chunk`` chunk of interest h](j)}(h``struct pcpu_chunk *chunk``h]jS)}(hjCh]hstruct pcpu_chunk *chunk}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjAubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhj=ubj)}(hhh]jM)}(hchunk of interesth]hchunk of interest}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjXhMhjYubah}(h]h ]h"]h$]h&]uh1jhj=ubeh}(h]h ]h"]h$]h&]uh1jhjXhMhj:ubj)}(h#``int off`` addr offset into chunk h](j)}(h ``int off``h]jS)}(hj|h]hint off}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjzubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjvubj)}(hhh]jM)}(haddr offset into chunkh]haddr offset into chunk}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjvubeh}(h]h ]h"]h$]h&]uh1jhjhMhj:ubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjubjM)}(hsThis function determines the size of an allocation to free using the boundary bitmap and clears the allocation map.h]hsThis function determines the size of an allocation to free using the boundary bitmap and clears the allocation map.}(hj͵hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjubjM)}(h **Return**h]j)}(hj޵h]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjܵubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjubjM)}(hNumber of freed bytes.h]hNumber of freed bytes.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h#pcpu_alloc_first_chunk (C function)c.pcpu_alloc_first_chunkhNtauh1hhjKhhhNhNubh)}(hhh](h)}(hQstruct pcpu_chunk * pcpu_alloc_first_chunk (unsigned long tmp_addr, int map_size)h]h)}(hOstruct pcpu_chunk *pcpu_alloc_first_chunk(unsigned long tmp_addr, int map_size)h](j)}(hjJ,h]hstruct}(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM9ubj)}(h h]h }(hj1hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhj0hM9ubh)}(hhh]j)}(h pcpu_chunkh]h pcpu_chunk}(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjDmodnameN classnameNjj)}j]j)}jpcpu_alloc_first_chunksbc.pcpu_alloc_first_chunkasbuh1hhjhhhj0hM9ubj)}(h h]h }(hjchhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhj0hM9ubjr)}(hjuh]h*}(hjqhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjhhhj0hM9ubh)}(hpcpu_alloc_first_chunkh]j)}(hj`h]hpcpu_alloc_first_chunk}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhj0hM9ubj8)}(h&(unsigned long tmp_addr, int map_size)h](j>)}(hunsigned long tmp_addrh](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjǶhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(htmp_addrh]htmp_addr}(hjնhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(h int map_sizeh](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hmap_sizeh]hmap_size}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhj0hM9ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhj0hM9ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj0hM9hjhhubj4)}(hhh]jM)}(h)creates chunks that serve the first chunkh]h)creates chunks that serve the first chunk}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM9hj1hhubah}(h]h ]h"]h$]h&]uh1j3hjhhhj0hM9ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjLjHjLjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``unsigned long tmp_addr`` the start of the region served ``int map_size`` size of the region served **Description** This is responsible for creating the chunks that serve the first chunk. The base_addr is page aligned down of **tmp_addr** while the region end is page aligned up. Offsets are kept track of to determine the region served. All this is done to appease the bitmap allocator in avoiding partial blocks. **Return** Chunk serving the region at **tmp_addr** of **map_size**.h](jM)}(h**Parameters**h]j)}(hjVh]h Parameters}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjTubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM=hjPubj)}(hhh](j)}(h:``unsigned long tmp_addr`` the start of the region served h](j)}(h``unsigned long tmp_addr``h]jS)}(hjuh]hunsigned long tmp_addr}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjsubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM:hjoubj)}(hhh]jM)}(hthe start of the region servedh]hthe start of the region served}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM:hjubah}(h]h ]h"]h$]h&]uh1jhjoubeh}(h]h ]h"]h$]h&]uh1jhjhM:hjlubj)}(h+``int map_size`` size of the region served h](j)}(h``int map_size``h]jS)}(hjh]h int map_size}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM;hjubj)}(hhh]jM)}(hsize of the region servedh]hsize of the region served}(hjǷhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj÷hM;hjķubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj÷hM;hjlubeh}(h]h ]h"]h$]h&]uh1jhjPubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM=hjPubjM)}(hX,This is responsible for creating the chunks that serve the first chunk. The base_addr is page aligned down of **tmp_addr** while the region end is page aligned up. Offsets are kept track of to determine the region served. All this is done to appease the bitmap allocator in avoiding partial blocks.h](hoThis is responsible for creating the chunks that serve the first chunk. The base_addr is page aligned down of }(hjhhhNhNubj)}(h **tmp_addr**h]htmp_addr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh while the region end is page aligned up. Offsets are kept track of to determine the region served. All this is done to appease the bitmap allocator in avoiding partial blocks.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM<hjPubjM)}(h **Return**h]j)}(hj"h]hReturn}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMAhjPubjM)}(h9Chunk serving the region at **tmp_addr** of **map_size**.h](hChunk serving the region at }(hj8hhhNhNubj)}(h **tmp_addr**h]htmp_addr}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj8ubh of }(hj8hhhNhNubj)}(h **map_size**h]hmap_size}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj8ubh.}(hj8hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMBhjPubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h!pcpu_chunk_populated (C function)c.pcpu_chunk_populatedhNtauh1hhjKhhhNhNubh)}(hhh](h)}(hRvoid pcpu_chunk_populated (struct pcpu_chunk *chunk, int page_start, int page_end)h]h)}(hQvoid pcpu_chunk_populated(struct pcpu_chunk *chunk, int page_start, int page_end)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh)}(hpcpu_chunk_populatedh]j)}(hpcpu_chunk_populatedh]hpcpu_chunk_populated}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMubj8)}(h8(struct pcpu_chunk *chunk, int page_start, int page_end)h](j>)}(hstruct pcpu_chunk *chunkh](j)}(hjJ,h]hstruct}(hjȸhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjĸubj)}(h h]h }(hjոhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjĸubh)}(hhh]j)}(h pcpu_chunkh]h pcpu_chunk}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsbc.pcpu_chunk_populatedasbuh1hhjĸubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjĸubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjĸubj)}(hchunkh]hchunk}(hj!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjĸubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hint page_starth](j)}(hinth]hint}(hj:hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj6ubj)}(h h]h }(hjHhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj6ubj)}(h page_starth]h page_start}(hjVhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj6ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(h int page_endh](j)}(hinth]hint}(hjohhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjkubj)}(h h]h }(hj}hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjkubj)}(hpage_endh]hpage_end}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjkubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]j~ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]jM)}(hpost-population bookkeepingh]hpost-population bookkeeping}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj͹jHj͹jIjJjKuh1hhhhjKhNhNubj)}(hXQ**Parameters** ``struct pcpu_chunk *chunk`` pcpu_chunk which got populated ``int page_start`` the start page ``int page_end`` the end page **Description** Pages in [**page_start**,**page_end**) have been populated to **chunk**. Update the bookkeeping information accordingly. Must be called after each successful population.h](jM)}(h**Parameters**h]j)}(hj׹h]h Parameters}(hjٹhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjչubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjѹubj)}(hhh](j)}(h<``struct pcpu_chunk *chunk`` pcpu_chunk which got populated h](j)}(h``struct pcpu_chunk *chunk``h]jS)}(hjh]hstruct pcpu_chunk *chunk}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjubj)}(hhh]jM)}(hpcpu_chunk which got populatedh]hpcpu_chunk which got populated}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj hMhj ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj hMhjubj)}(h"``int page_start`` the start page h](j)}(h``int page_start``h]jS)}(hj/h]hint page_start}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj-ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhj)ubj)}(hhh]jM)}(hthe start pageh]hthe start page}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjDhMhjEubah}(h]h ]h"]h$]h&]uh1jhj)ubeh}(h]h ]h"]h$]h&]uh1jhjDhMhjubj)}(h``int page_end`` the end page h](j)}(h``int page_end``h]jS)}(hjhh]h int page_end}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjfubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjbubj)}(hhh]jM)}(h the end pageh]h the end page}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj}hMhj~ubah}(h]h ]h"]h$]h&]uh1jhjbubeh}(h]h ]h"]h$]h&]uh1jhj}hMhjubeh}(h]h ]h"]h$]h&]uh1jhjѹubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjѹubjM)}(hPages in [**page_start**,**page_end**) have been populated to **chunk**. Update the bookkeeping information accordingly. Must be called after each successful population.h](h Pages in [}(hjhhhNhNubj)}(h**page_start**h]h page_start}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh&,**page_end**) have been populated to }(hjhhhNhNubj)}(h **chunk**h]hchunk}(hjӺhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhd. Update the bookkeeping information accordingly. Must be called after each successful population.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjѹubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h#pcpu_chunk_depopulated (C function)c.pcpu_chunk_depopulatedhNtauh1hhjKhhhNhNubh)}(hhh](h)}(hTvoid pcpu_chunk_depopulated (struct pcpu_chunk *chunk, int page_start, int page_end)h]h)}(hSvoid pcpu_chunk_depopulated(struct pcpu_chunk *chunk, int page_start, int page_end)h](j)}(hvoidh]hvoid}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh)}(hpcpu_chunk_depopulatedh]j)}(hpcpu_chunk_depopulatedh]hpcpu_chunk_depopulated}(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMubj8)}(h8(struct pcpu_chunk *chunk, int page_start, int page_end)h](j>)}(hstruct pcpu_chunk *chunkh](j)}(hjJ,h]hstruct}(hjIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEubj)}(h h]h }(hjVhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEubh)}(hhh]j)}(h pcpu_chunkh]h pcpu_chunk}(hjghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjdubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjimodnameN classnameNjj)}j]j)}jj/sbc.pcpu_chunk_depopulatedasbuh1hhjEubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjEubj)}(hchunkh]hchunk}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjAubj>)}(hint page_starth](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjɻhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h page_starth]h page_start}(hj׻hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjAubj>)}(h int page_endh](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hpage_endh]hpage_end}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjAubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]jM)}(hpost-depopulation bookkeepingh]hpost-depopulation bookkeeping}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhj3hhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjNjHjNjIjJjKuh1hhhhjKhNhNubj)}(hXX**Parameters** ``struct pcpu_chunk *chunk`` pcpu_chunk which got depopulated ``int page_start`` the start page ``int page_end`` the end page **Description** Pages in [**page_start**,**page_end**) have been depopulated from **chunk**. Update the bookkeeping information accordingly. Must be called after each successful depopulation.h](jM)}(h**Parameters**h]j)}(hjXh]h Parameters}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjVubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjRubj)}(hhh](j)}(h>``struct pcpu_chunk *chunk`` pcpu_chunk which got depopulated h](j)}(h``struct pcpu_chunk *chunk``h]jS)}(hjwh]hstruct pcpu_chunk *chunk}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjuubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjqubj)}(hhh]jM)}(h pcpu_chunk which got depopulatedh]h pcpu_chunk which got depopulated}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjqubeh}(h]h ]h"]h$]h&]uh1jhjhMhjnubj)}(h"``int page_start`` the start page h](j)}(h``int page_start``h]jS)}(hjh]hint page_start}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjubj)}(hhh]jM)}(hthe start pageh]hthe start page}(hjɼhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjżhMhjƼubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjżhMhjnubj)}(h``int page_end`` the end page h](j)}(h``int page_end``h]jS)}(hjh]h int page_end}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjubj)}(hhh]jM)}(h the end pageh]h the end page}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjnubeh}(h]h ]h"]h$]h&]uh1jhjRubjM)}(h**Description**h]j)}(hj$h]h Description}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj"ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjRubjM)}(hPages in [**page_start**,**page_end**) have been depopulated from **chunk**. Update the bookkeeping information accordingly. Must be called after each successful depopulation.h](h Pages in [}(hj:hhhNhNubj)}(h**page_start**h]h page_start}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj:ubh*,**page_end**) have been depopulated from }(hj:hhhNhNubj)}(h **chunk**h]hchunk}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jhj:ubhe. Update the bookkeeping information accordingly. Must be called after each successful depopulation.}(hj:hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjRubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h#pcpu_chunk_addr_search (C function)c.pcpu_chunk_addr_searchhNtauh1hhjKhhhNhNubh)}(hhh](h)}(h7struct pcpu_chunk * pcpu_chunk_addr_search (void *addr)h]h)}(h5struct pcpu_chunk *pcpu_chunk_addr_search(void *addr)h](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM/ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM/ubh)}(hhh]j)}(h pcpu_chunkh]h pcpu_chunk}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jpcpu_chunk_addr_searchsbc.pcpu_chunk_addr_searchasbuh1hhjhhhjhM/ubj)}(h h]h }(hjͽhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM/ubjr)}(hjuh]h*}(hj۽hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjhhhjhM/ubh)}(hpcpu_chunk_addr_searchh]j)}(hjʽh]hpcpu_chunk_addr_search}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhM/ubj8)}(h (void *addr)h]j>)}(h void *addrh](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hj#hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(haddrh]haddr}(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhM/ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhM/ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhM/hjhhubj4)}(hhh]jM)}(h,determine chunk containing specified addressh]h,determine chunk containing specified address}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM/hjWhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhM/ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjrjHjrjIjJjKuh1hhhhjKhNhNubj)}(hX!**Parameters** ``void *addr`` address for which the chunk needs to be determined. **Description** This is an internal function that handles all but static allocations. Static percpu address values should never be passed into the allocator. **Return** The address of the found chunk.h](jM)}(h**Parameters**h]j)}(hj|h]h Parameters}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjzubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM3hjvubj)}(hhh]j)}(hC``void *addr`` address for which the chunk needs to be determined. h](j)}(h``void *addr``h]jS)}(hjh]h void *addr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM0hjubj)}(hhh]jM)}(h3address for which the chunk needs to be determined.h]h3address for which the chunk needs to be determined.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM0hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM0hjubah}(h]h ]h"]h$]h&]uh1jhjvubjM)}(h**Description**h]j)}(hj־h]h Description}(hjؾhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjԾubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM2hjvubjM)}(hThis is an internal function that handles all but static allocations. Static percpu address values should never be passed into the allocator.h]hThis is an internal function that handles all but static allocations. Static percpu address values should never be passed into the allocator.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM1hjvubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM4hjvubjM)}(hThe address of the found chunk.h]hThe address of the found chunk.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM5hjvubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hpcpu_alloc (C function) c.pcpu_allochNtauh1hhjKhhhNhNubh)}(hhh](h)}(hPvoid __percpu * pcpu_alloc (size_t size, size_t align, bool reserved, gfp_t gfp)h]h)}(hNvoid __percpu *pcpu_alloc(size_t size, size_t align, bool reserved, gfp_t gfp)h](j)}(hvoidh]hvoid}(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>hhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMubj)}(h h]h }(hjQhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>hhhjPhMubh__percpu}(hj>hhhNhNubj)}(h h]h }(hjchhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>hhhjPhMubjr)}(hjuh]h*}(hjqhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj>hhhjPhMubh)}(h pcpu_alloch]j)}(h pcpu_alloch]h pcpu_alloc}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj>hhhjPhMubj8)}(h5(size_t size, size_t align, bool reserved, gfp_t gfp)h](j>)}(h size_t sizeh](h)}(hhh]j)}(hsize_th]hsize_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsb c.pcpu_allocasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hsizeh]hsize}(hjϿhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(h size_t alignh](h)}(hhh]j)}(hsize_th]hsize_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j c.pcpu_allocasbuh1hhjubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(halignh]halign}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(h bool reservedh](j)}(hjh]hbool}(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,ubj)}(h h]h }(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,ubj)}(hreservedh]hreserved}(hjKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(h gfp_t gfph](h)}(hhh]j)}(hgfp_th]hgfp_t}(hjghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjdubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjimodnameN classnameNjj)}j]j c.pcpu_allocasbuh1hhj`ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj`ubj)}(hgfph]hgfp}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj`ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hj>hhhjPhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj:hhhjPhMubah}(h]j5ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjPhMhj7hhubj4)}(hhh]jM)}(hthe percpu allocatorh]hthe percpu allocator}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjhhubah}(h]h ]h"]h$]h&]uh1j3hj7hhhjPhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hX"**Parameters** ``size_t size`` size of area to allocate in bytes ``size_t align`` alignment of area (max PAGE_SIZE) ``bool reserved`` allocate from the reserved chunk if available ``gfp_t gfp`` allocation flags **Description** Allocate percpu area of **size** bytes aligned at **align**. If **gfp** doesn't allow blocking, the allocation is atomic. If **gfp** has __GFP_NOWARN then no warning will be triggered on invalid or failed allocation requests. **Return** Percpu pointer to the allocated area on success, NULL on failure.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjubj)}(hhh](j)}(h2``size_t size`` size of area to allocate in bytes h](j)}(h``size_t size``h]jS)}(hjh]h size_t size}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjubj)}(hhh]jM)}(h!size of area to allocate in bytesh]h!size of area to allocate in bytes}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h3``size_t align`` alignment of area (max PAGE_SIZE) h](j)}(h``size_t align``h]jS)}(hj7h]h size_t align}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj5ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhj1ubj)}(hhh]jM)}(h!alignment of area (max PAGE_SIZE)h]h!alignment of area (max PAGE_SIZE)}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjLhMhjMubah}(h]h ]h"]h$]h&]uh1jhj1ubeh}(h]h ]h"]h$]h&]uh1jhjLhMhjubj)}(h@``bool reserved`` allocate from the reserved chunk if available h](j)}(h``bool reserved``h]jS)}(hjph]h bool reserved}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjnubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjjubj)}(hhh]jM)}(h-allocate from the reserved chunk if availableh]h-allocate from the reserved chunk if available}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h``gfp_t gfp`` allocation flags h](j)}(h ``gfp_t gfp``h]jS)}(hjh]h gfp_t gfp}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjubj)}(hhh]jM)}(hallocation flagsh]hallocation flags}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjubjM)}(hAllocate percpu area of **size** bytes aligned at **align**. If **gfp** doesn't allow blocking, the allocation is atomic. If **gfp** has __GFP_NOWARN then no warning will be triggered on invalid or failed allocation requests.h](hAllocate percpu area of }(hjhhhNhNubj)}(h**size**h]hsize}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh bytes aligned at }(hjhhhNhNubj)}(h **align**h]halign}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh. If }(hjhhhNhNubj)}(h**gfp**h]hgfp}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh8 doesn’t allow blocking, the allocation is atomic. If }(hjhhhNhNubj)}(h**gfp**h]hgfp}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh] has __GFP_NOWARN then no warning will be triggered on invalid or failed allocation requests.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjubjM)}(h **Return**h]j)}(hjSh]hReturn}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjQubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjubjM)}(hAPercpu pointer to the allocated area on success, NULL on failure.h]hAPercpu pointer to the allocated area on success, NULL on failure.}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hpcpu_balance_free (C function)c.pcpu_balance_freehNtauh1hhjKhhhNhNubh)}(hhh](h)}(h(void pcpu_balance_free (bool empty_only)h]h)}(h'void pcpu_balance_free(bool empty_only)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh)}(hpcpu_balance_freeh]j)}(hpcpu_balance_freeh]hpcpu_balance_free}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMubj8)}(h(bool empty_only)h]j>)}(hbool empty_onlyh](j)}(hjh]hbool}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h empty_onlyh]h empty_only}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]jM)}(h manage the amount of free chunksh]h manage the amount of free chunks}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj2jHj2jIjJjKuh1hhhhjKhNhNubj)}(hXB**Parameters** ``bool empty_only`` free chunks only if there are no populated pages **Description** If empty_only is ``false``, reclaim all fully free chunks regardless of the number of populated pages. Otherwise, only reclaim chunks that have no populated pages. **Context** pcpu_lock (can be dropped temporarily)h](jM)}(h**Parameters**h]j)}(hj<h]h Parameters}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj:ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhj6ubj)}(hhh]j)}(hE``bool empty_only`` free chunks only if there are no populated pages h](j)}(h``bool empty_only``h]jS)}(hj[h]hbool empty_only}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjYubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjUubj)}(hhh]jM)}(h0free chunks only if there are no populated pagesh]h0free chunks only if there are no populated pages}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjphMhjqubah}(h]h ]h"]h$]h&]uh1jhjUubeh}(h]h ]h"]h$]h&]uh1jhjphMhjRubah}(h]h ]h"]h$]h&]uh1jhj6ubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhj6ubjM)}(hIf empty_only is ``false``, reclaim all fully free chunks regardless of the number of populated pages. Otherwise, only reclaim chunks that have no populated pages.h](hIf empty_only is }(hjhhhNhNubjS)}(h ``false``h]hfalse}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubh, reclaim all fully free chunks regardless of the number of populated pages. Otherwise, only reclaim chunks that have no populated pages.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhj6ubjM)}(h **Context**h]j)}(hjh]hContext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhj6ubjM)}(h&pcpu_lock (can be dropped temporarily)h]h&pcpu_lock (can be dropped temporarily)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhj6ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h#pcpu_balance_populated (C function)c.pcpu_balance_populatedhNtauh1hhjKhhhNhNubh)}(hhh](h)}(h"void pcpu_balance_populated (void)h]h)}(h!void pcpu_balance_populated(void)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMubj)}(h h]h }(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhj"hMubh)}(hpcpu_balance_populatedh]j)}(hpcpu_balance_populatedh]hpcpu_balance_populated}(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj1ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhj"hMubj8)}(h(void)h]j>)}(hvoidh]j)}(hvoidh]hvoid}(hjQhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjMubah}(h]h ]h"]h$]h&]noemphjjuh1j=hjIubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhj"hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj hhhj"hMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj"hMhj hhubj4)}(hhh]jM)}(h$manage the amount of populated pagesh]h$manage the amount of populated pages}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjxhhubah}(h]h ]h"]h$]h&]uh1j3hj hhhj"hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``void`` no arguments **Description** Maintain a certain amount of populated pages to satisfy atomic allocations. It is possible that this is called when physical memory is scarce causing OOM killer to be triggered. We should avoid doing so until an actual allocation causes the failure as it is possible that requests can be serviced from already backed regions. **Context** pcpu_lock (can be dropped temporarily)h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjubj)}(hhh]j)}(h``void`` no arguments h](j)}(h``void``h]jS)}(hjh]hvoid}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chKhjubj)}(hhh]jM)}(h no argumentsh]h no arguments}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chKhjubjM)}(hXFMaintain a certain amount of populated pages to satisfy atomic allocations. It is possible that this is called when physical memory is scarce causing OOM killer to be triggered. We should avoid doing so until an actual allocation causes the failure as it is possible that requests can be serviced from already backed regions.h]hXFMaintain a certain amount of populated pages to satisfy atomic allocations. It is possible that this is called when physical memory is scarce causing OOM killer to be triggered. We should avoid doing so until an actual allocation causes the failure as it is possible that requests can be serviced from already backed regions.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjubjM)}(h **Context**h]j)}(hjh]hContext}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjubjM)}(h&pcpu_lock (can be dropped temporarily)h]h&pcpu_lock (can be dropped temporarily)}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h#pcpu_reclaim_populated (C function)c.pcpu_reclaim_populatedhNtauh1hhjKhhhNhNubh)}(hhh](h)}(h"void pcpu_reclaim_populated (void)h]h)}(h!void pcpu_reclaim_populated(void)h](j)}(hvoidh]hvoid}(hjchhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj_hhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM+ubj)}(h h]h }(hjrhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj_hhhjqhM+ubh)}(hpcpu_reclaim_populatedh]j)}(hpcpu_reclaim_populatedh]hpcpu_reclaim_populated}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhj_hhhjqhM+ubj8)}(h(void)h]j>)}(hvoidh]j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hj_hhhjqhM+ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj[hhhjqhM+ubah}(h]jVah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjqhM+hjXhhubj4)}(hhh]jM)}(h3scan over to_depopulate chunks and free empty pagesh]h3scan over to_depopulate chunks and free empty pages}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM+hjhhubah}(h]h ]h"]h$]h&]uh1j3hjXhhhjqhM+ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hXJ**Parameters** ``void`` no arguments **Description** Scan over chunks in the depopulate list and try to release unused populated pages back to the system. Depopulated chunks are sidelined to prevent repopulating these pages unless required. Fully free chunks are reintegrated and freed accordingly (1 is kept around). If we drop below the empty populated pages threshold, reintegrate the chunk if it has empty free pages. Each chunk is scanned in the reverse order to keep populated pages close to the beginning of the chunk. **Context** pcpu_lock (can be dropped temporarily)h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM/hjubj)}(hhh]j)}(h``void`` no arguments h](j)}(h``void``h]jS)}(hj h]hvoid}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chKhjubj)}(hhh]jM)}(h no argumentsh]h no arguments}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj hKhj!ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj hKhjubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjFh]h Description}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjDubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chKhjubjM)}(hXScan over chunks in the depopulate list and try to release unused populated pages back to the system. Depopulated chunks are sidelined to prevent repopulating these pages unless required. Fully free chunks are reintegrated and freed accordingly (1 is kept around). If we drop below the empty populated pages threshold, reintegrate the chunk if it has empty free pages. Each chunk is scanned in the reverse order to keep populated pages close to the beginning of the chunk.h]hXScan over chunks in the depopulate list and try to release unused populated pages back to the system. Depopulated chunks are sidelined to prevent repopulating these pages unless required. Fully free chunks are reintegrated and freed accordingly (1 is kept around). If we drop below the empty populated pages threshold, reintegrate the chunk if it has empty free pages. Each chunk is scanned in the reverse order to keep populated pages close to the beginning of the chunk.}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM,hjubjM)}(h **Context**h]j)}(hjmh]hContext}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1jhjkubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM4hjubjM)}(h&pcpu_lock (can be dropped temporarily)h]h&pcpu_lock (can be dropped temporarily)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM5hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h pcpu_balance_workfn (C function)c.pcpu_balance_workfnhNtauh1hhjKhhhNhNubh)}(hhh](h)}(h3void pcpu_balance_workfn (struct work_struct *work)h]h)}(h2void pcpu_balance_workfn(struct work_struct *work)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh)}(hpcpu_balance_workfnh]j)}(hpcpu_balance_workfnh]hpcpu_balance_workfn}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMubj8)}(h(struct work_struct *work)h]j>)}(hstruct work_struct *workh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(h work_structh]h work_struct}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsbc.pcpu_balance_workfnasbuh1hhjubj)}(h h]h }(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hj;hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hworkh]hwork}(hjHhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]jM)}(h4manage the amount of free chunks and populated pagesh]h4manage the amount of free chunks and populated pages}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjohhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hX **Parameters** ``struct work_struct *work`` unused **Description** For each chunk type, manage the number of fully free chunks and the number of populated pages. An important thing to consider is when pages are freed and how they contribute to the global counts.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjubj)}(hhh]j)}(h$``struct work_struct *work`` unused h](j)}(h``struct work_struct *work``h]jS)}(hjh]hstruct work_struct *work}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjubj)}(hhh]jM)}(hunusedh]hunused}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjubjM)}(hFor each chunk type, manage the number of fully free chunks and the number of populated pages. An important thing to consider is when pages are freed and how they contribute to the global counts.h]hFor each chunk type, manage the number of fully free chunks and the number of populated pages. An important thing to consider is when pages are freed and how they contribute to the global counts.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfree_percpu (C function) c.free_percpuhNtauh1hhjKhhhNhNubh)}(hhh](h)}(h%void free_percpu (void __percpu *ptr)h]h)}(h$void free_percpu(void __percpu *ptr)h](j)}(hvoidh]hvoid}(hj3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/hhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMubj)}(h h]h }(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/hhhjAhMubh)}(h free_percpuh]j)}(h free_percpuh]h free_percpu}(hjThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjPubah}(h]h ](jjeh"]h$]h&]jjuh1hhj/hhhjAhMubj8)}(h(void __percpu *ptr)h]j>)}(hvoid __percpu *ptrh](j)}(hvoidh]hvoid}(hjphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjlubj)}(h h]h }(hj~hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjlubh__percpu}(hjlhhhNhNubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjlubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjlubj)}(hptrh]hptr}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjlubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjhubah}(h]h ]h"]h$]h&]jjuh1j7hj/hhhjAhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj+hhhjAhMubah}(h]j&ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjAhMhj(hhubj4)}(hhh]jM)}(hfree percpu areah]hfree percpu area}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjhhubah}(h]h ]h"]h$]h&]uh1j3hj(hhhjAhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``void __percpu *ptr`` pointer to area to free **Description** Free percpu area **ptr**. **Context** Can be called from atomic context.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjubj)}(hhh]j)}(h/``void __percpu *ptr`` pointer to area to free h](j)}(h``void __percpu *ptr``h]jS)}(hjh]hvoid __percpu *ptr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjubj)}(hhh]jM)}(hpointer to area to freeh]hpointer to area to free}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj+hMhj,ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj+hMhj ubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjQh]h Description}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1jhjOubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjubjM)}(hFree percpu area **ptr**.h](hFree percpu area }(hjghhhNhNubj)}(h**ptr**h]hptr}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1jhjgubh.}(hjghhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjubjM)}(h **Context**h]j)}(hjh]hContext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjubjM)}(h"Can be called from atomic context.h]h"Can be called from atomic context.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h%is_kernel_percpu_address (C function)c.is_kernel_percpu_addresshNtauh1hhjKhhhNhNubh)}(hhh](h)}(h2bool is_kernel_percpu_address (unsigned long addr)h]h)}(h1bool is_kernel_percpu_address(unsigned long addr)h](j)}(hjh]hbool}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM ubh)}(his_kernel_percpu_addressh]j)}(his_kernel_percpu_addressh]his_kernel_percpu_address}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhM ubj8)}(h(unsigned long addr)h]j>)}(hunsigned long addrh](j)}(hunsignedh]hunsigned}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hlongh]hlong}(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(haddrh]haddr}(hjChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhM ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhM ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhM hjhhubj4)}(hhh]jM)}(h/test whether address is from static percpu areah]h/test whether address is from static percpu area}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM hjjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhM ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hXB**Parameters** ``unsigned long addr`` address to test **Description** Test whether **addr** belongs to in-kernel static percpu area. Module static percpu areas are not considered. For those, use is_module_percpu_address(). **Return** ``true`` if **addr** is from in-kernel static percpu area, ``false`` otherwise.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM hjubj)}(hhh]j)}(h'``unsigned long addr`` address to test h](j)}(h``unsigned long addr``h]jS)}(hjh]hunsigned long addr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM hjubj)}(hhh]jM)}(haddress to testh]haddress to test}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM hjubjM)}(hTest whether **addr** belongs to in-kernel static percpu area. Module static percpu areas are not considered. For those, use is_module_percpu_address().h](h Test whether }(hjhhhNhNubj)}(h**addr**h]haddr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh belongs to in-kernel static percpu area. Module static percpu areas are not considered. For those, use is_module_percpu_address().}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM hjubjM)}(h **Return**h]j)}(hj"h]hReturn}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM hjubjM)}(hO``true`` if **addr** is from in-kernel static percpu area, ``false`` otherwise.h](jS)}(h``true``h]htrue}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj8ubh if }(hj8hhhNhNubj)}(h**addr**h]haddr}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj8ubh' is from in-kernel static percpu area, }(hj8hhhNhNubjS)}(h ``false``h]hfalse}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj8ubh otherwise.}(hj8hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h per_cpu_ptr_to_phys (C function)c.per_cpu_ptr_to_physhNtauh1hhjKhhhNhNubh)}(hhh](h)}(h,phys_addr_t per_cpu_ptr_to_phys (void *addr)h]h)}(h+phys_addr_t per_cpu_ptr_to_phys(void *addr)h](h)}(hhh]j)}(h phys_addr_th]h phys_addr_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jper_cpu_ptr_to_physsbc.per_cpu_ptr_to_physasbuh1hhjhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM# ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM# ubh)}(hper_cpu_ptr_to_physh]j)}(hjh]hper_cpu_ptr_to_phys}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhM# ubj8)}(h (void *addr)h]j>)}(h void *addrh](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(haddrh]haddr}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhM# ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhM# ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhM# hjhhubj4)}(hhh]jM)}(h5convert translated percpu address to physical addressh]h5convert translated percpu address to physical address}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM# hj;hhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhM# ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjVjHjVjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``void *addr`` the address to be converted to physical address **Description** Given **addr** which is dereferenceable address obtained via one of percpu access macros, this function translates it into its physical address. The caller is responsible for ensuring **addr** stays valid until this function finishes. percpu allocator has special setup for the first chunk, which currently supports either embedding in linear address space or vmalloc mapping, and, from the second one, the backing allocator (currently either vm or km) provides translation. The addr can be translated simply without checking if it falls into the first chunk. But the current code reflects better how percpu allocator actually works, and the verification can discover both bugs in percpu allocator itself and per_cpu_ptr_to_phys() callers. So we keep current code. **Return** The physical address for **addr**.h](jM)}(h**Parameters**h]j)}(hj`h]h Parameters}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj^ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM' hjZubj)}(hhh]j)}(h?``void *addr`` the address to be converted to physical address h](j)}(h``void *addr``h]jS)}(hjh]h void *addr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj}ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM$ hjyubj)}(hhh]jM)}(h/the address to be converted to physical addressh]h/the address to be converted to physical address}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM$ hjubah}(h]h ]h"]h$]h&]uh1jhjyubeh}(h]h ]h"]h$]h&]uh1jhjhM$ hjvubah}(h]h ]h"]h$]h&]uh1jhjZubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM& hjZubjM)}(hGiven **addr** which is dereferenceable address obtained via one of percpu access macros, this function translates it into its physical address. The caller is responsible for ensuring **addr** stays valid until this function finishes.h](hGiven }(hjhhhNhNubj)}(h**addr**h]haddr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh which is dereferenceable address obtained via one of percpu access macros, this function translates it into its physical address. The caller is responsible for ensuring }(hjhhhNhNubj)}(h**addr**h]haddr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh* stays valid until this function finishes.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM% hjZubjM)}(hpercpu allocator has special setup for the first chunk, which currently supports either embedding in linear address space or vmalloc mapping, and, from the second one, the backing allocator (currently either vm or km) provides translation.h]hpercpu allocator has special setup for the first chunk, which currently supports either embedding in linear address space or vmalloc mapping, and, from the second one, the backing allocator (currently either vm or km) provides translation.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM* hjZubjM)}(hX!The addr can be translated simply without checking if it falls into the first chunk. But the current code reflects better how percpu allocator actually works, and the verification can discover both bugs in percpu allocator itself and per_cpu_ptr_to_phys() callers. So we keep current code.h]hX!The addr can be translated simply without checking if it falls into the first chunk. But the current code reflects better how percpu allocator actually works, and the verification can discover both bugs in percpu allocator itself and per_cpu_ptr_to_phys() callers. So we keep current code.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM/ hjZubjM)}(h **Return**h]j)}(hj#h]hReturn}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj!ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM5 hjZubjM)}(h"The physical address for **addr**.h](hThe physical address for }(hj9hhhNhNubj)}(h**addr**h]haddr}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj9ubh.}(hj9hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM6 hjZubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h"pcpu_alloc_alloc_info (C function)c.pcpu_alloc_alloc_infohNtauh1hhjKhhhNhNubh)}(hhh](h)}(hLstruct pcpu_alloc_info * pcpu_alloc_alloc_info (int nr_groups, int nr_units)h]h)}(hJstruct pcpu_alloc_info *pcpu_alloc_alloc_info(int nr_groups, int nr_units)h](j)}(hjJ,h]hstruct}(hjzhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMf ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvhhhjhMf ubh)}(hhh]j)}(hpcpu_alloc_infoh]hpcpu_alloc_info}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jpcpu_alloc_alloc_infosbc.pcpu_alloc_alloc_infoasbuh1hhjvhhhjhMf ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvhhhjhMf ubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjvhhhjhMf ubh)}(hpcpu_alloc_alloc_infoh]j)}(hjh]hpcpu_alloc_alloc_info}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjvhhhjhMf ubj8)}(h(int nr_groups, int nr_units)h](j>)}(h int nr_groupsh](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h nr_groupsh]h nr_groups}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(h int nr_unitsh](j)}(hinth]hint}(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%ubj)}(h h]h }(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%ubj)}(hnr_unitsh]hnr_units}(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjvhhhjhMf ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjrhhhjhMf ubah}(h]jmah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMf hjohhubj4)}(hhh]jM)}(hallocate percpu allocation infoh]hallocate percpu allocation info}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMf hjlhhubah}(h]h ]h"]h$]h&]uh1j3hjohhhjhMf ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``int nr_groups`` the number of groups ``int nr_units`` the number of units **Description** Allocate ai which is large enough for **nr_groups** groups containing **nr_units** units. The returned ai's groups[0].cpu_map points to the cpu_map array which is long enough for **nr_units** and filled with NR_CPUS. It's the caller's responsibility to initialize cpu_map pointer of other groups. **Return** Pointer to the allocated pcpu_alloc_info on success, NULL on failure.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMj hjubj)}(hhh](j)}(h'``int nr_groups`` the number of groups h](j)}(h``int nr_groups``h]jS)}(hjh]h int nr_groups}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMg hjubj)}(hhh]jM)}(hthe number of groupsh]hthe number of groups}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMg hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMg hjubj)}(h%``int nr_units`` the number of units h](j)}(h``int nr_units``h]jS)}(hjh]h int nr_units}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMh hjubj)}(hhh]jM)}(hthe number of unitsh]hthe number of units}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMh hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMh hjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hj$h]h Description}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj"ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMj hjubjM)}(hX*Allocate ai which is large enough for **nr_groups** groups containing **nr_units** units. The returned ai's groups[0].cpu_map points to the cpu_map array which is long enough for **nr_units** and filled with NR_CPUS. It's the caller's responsibility to initialize cpu_map pointer of other groups.h](h&Allocate ai which is large enough for }(hj:hhhNhNubj)}(h **nr_groups**h]h nr_groups}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj:ubh groups containing }(hj:hhhNhNubj)}(h **nr_units**h]hnr_units}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jhj:ubhd units. The returned ai’s groups[0].cpu_map points to the cpu_map array which is long enough for }(hj:hhhNhNubj)}(h **nr_units**h]hnr_units}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj:ubhn and filled with NR_CPUS. It’s the caller’s responsibility to initialize cpu_map pointer of other groups.}(hj:hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMi hjubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMo hjubjM)}(hEPointer to the allocated pcpu_alloc_info on success, NULL on failure.h]hEPointer to the allocated pcpu_alloc_info on success, NULL on failure.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMp hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h!pcpu_free_alloc_info (C function)c.pcpu_free_alloc_infohNtauh1hhjKhhhNhNubh)}(hhh](h)}(h6void pcpu_free_alloc_info (struct pcpu_alloc_info *ai)h]h)}(h5void pcpu_free_alloc_info(struct pcpu_alloc_info *ai)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM ubh)}(hpcpu_free_alloc_infoh]j)}(hpcpu_free_alloc_infoh]hpcpu_free_alloc_info}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhM ubj8)}(h(struct pcpu_alloc_info *ai)h]j>)}(hstruct pcpu_alloc_info *aih](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hpcpu_alloc_infoh]hpcpu_alloc_info}(hj!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj#modnameN classnameNjj)}j]j)}jjsbc.pcpu_free_alloc_infoasbuh1hhjubj)}(h h]h }(hjAhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjOhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(haih]hai}(hj\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhM ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhM ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhM hjhhubj4)}(hhh]jM)}(hfree percpu allocation infoh]hfree percpu allocation info}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM hjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhM ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``struct pcpu_alloc_info *ai`` pcpu_alloc_info to free **Description** Free **ai** which was allocated by pcpu_alloc_alloc_info().h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM hjubj)}(hhh]j)}(h7``struct pcpu_alloc_info *ai`` pcpu_alloc_info to free h](j)}(h``struct pcpu_alloc_info *ai``h]jS)}(hjh]hstruct pcpu_alloc_info *ai}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM hjubj)}(hhh]jM)}(hpcpu_alloc_info to freeh]hpcpu_alloc_info to free}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM hjubjM)}(h;Free **ai** which was allocated by pcpu_alloc_alloc_info().h](hFree }(hjhhhNhNubj)}(h**ai**h]hai}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh0 which was allocated by pcpu_alloc_alloc_info().}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h!pcpu_dump_alloc_info (C function)c.pcpu_dump_alloc_infohNtauh1hhjKhhhNhNubh)}(hhh](h)}(hMvoid pcpu_dump_alloc_info (const char *lvl, const struct pcpu_alloc_info *ai)h]h)}(hLvoid pcpu_dump_alloc_info(const char *lvl, const struct pcpu_alloc_info *ai)h](j)}(hvoidh]hvoid}(hjYhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjUhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM ubj)}(h h]h }(hjhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjUhhhjghM ubh)}(hpcpu_dump_alloc_infoh]j)}(hpcpu_dump_alloc_infoh]hpcpu_dump_alloc_info}(hjzhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvubah}(h]h ](jjeh"]h$]h&]jjuh1hhjUhhhjghM ubj8)}(h3(const char *lvl, const struct pcpu_alloc_info *ai)h](j>)}(hconst char *lvlh](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hcharh]hchar}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hlvlh]hlvl}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(h const struct pcpu_alloc_info *aih](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hpcpu_alloc_infoh]hpcpu_alloc_info}(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj.modnameN classnameNjj)}j]j)}jj|sbc.pcpu_dump_alloc_infoasbuh1hhjubj)}(h h]h }(hjLhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjZhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(haih]hai}(hjghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjUhhhjghM ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjQhhhjghM ubah}(h]jLah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjghM hjNhhubj4)}(hhh]jM)}(h+print out information about pcpu_alloc_infoh]h+print out information about pcpu_alloc_info}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM hjhhubah}(h]h ]h"]h$]h&]uh1j3hjNhhhjghM ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``const char *lvl`` loglevel ``const struct pcpu_alloc_info *ai`` allocation info to dump **Description** Print out information about **ai** using loglevel **lvl**.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM hjubj)}(hhh](j)}(h``const char *lvl`` loglevel h](j)}(h``const char *lvl``h]jS)}(hjh]hconst char *lvl}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM hjubj)}(hhh]jM)}(hloglevelh]hloglevel}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hjubj)}(h=``const struct pcpu_alloc_info *ai`` allocation info to dump h](j)}(h$``const struct pcpu_alloc_info *ai``h]jS)}(hj h]h const struct pcpu_alloc_info *ai}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM hjubj)}(hhh]jM)}(hallocation info to dumph]hallocation info to dump}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj hM hj!ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj hM hjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjFh]h Description}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjDubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM hjubjM)}(h:Print out information about **ai** using loglevel **lvl**.h](hPrint out information about }(hj\hhhNhNubj)}(h**ai**h]hai}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj\ubh using loglevel }(hj\hhhNhNubj)}(h**lvl**h]hlvl}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj\ubh.}(hj\hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h#pcpu_setup_first_chunk (C function)c.pcpu_setup_first_chunkhNtauh1hhjKhhhNhNubh)}(hhh](h)}(hOvoid pcpu_setup_first_chunk (const struct pcpu_alloc_info *ai, void *base_addr)h]h)}(hNvoid pcpu_setup_first_chunk(const struct pcpu_alloc_info *ai, void *base_addr)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM ubh)}(hpcpu_setup_first_chunkh]j)}(hpcpu_setup_first_chunkh]hpcpu_setup_first_chunk}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhM ubj8)}(h3(const struct pcpu_alloc_info *ai, void *base_addr)h](j>)}(h const struct pcpu_alloc_info *aih](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hpcpu_alloc_infoh]hpcpu_alloc_info}(hj%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj'modnameN classnameNjj)}j]j)}jjsbc.pcpu_setup_first_chunkasbuh1hhjubj)}(h h]h }(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjShhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(haih]hai}(hj`hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hvoid *base_addrh](j)}(hvoidh]hvoid}(hjyhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjuubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjuubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjuubj)}(h base_addrh]h base_addr}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjuubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhM ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhM ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhM hjhhubj4)}(hhh]jM)}(h!initialize the first percpu chunkh]h!initialize the first percpu chunk}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM hjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhM ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hXz **Parameters** ``const struct pcpu_alloc_info *ai`` pcpu_alloc_info describing how to percpu area is shaped ``void *base_addr`` mapped address **Description** Initialize the first percpu chunk which contains the kernel static percpu area. This function is to be called from arch percpu area setup path. **ai** contains all information necessary to initialize the first chunk and prime the dynamic percpu allocator. **ai->static_size** is the size of static percpu area. **ai->reserved_size**, if non-zero, specifies the amount of bytes to reserve after the static area in the first chunk. This reserves the first chunk such that it's available only through reserved percpu allocation. This is primarily used to serve module percpu static areas on architectures where the addressing model has limited offset range for symbol relocations to guarantee module percpu symbols fall inside the relocatable range. **ai->dyn_size** determines the number of bytes available for dynamic allocation in the first chunk. The area between **ai->static_size** + **ai->reserved_size** + **ai->dyn_size** and **ai->unit_size** is unused. **ai->unit_size** specifies unit size and must be aligned to PAGE_SIZE and equal to or larger than **ai->static_size** + **ai->reserved_size** + **ai->dyn_size**. **ai->atom_size** is the allocation atom size and used as alignment for vm areas. **ai->alloc_size** is the allocation size and always multiple of **ai->atom_size**. This is larger than **ai->atom_size** if **ai->unit_size** is larger than **ai->atom_size**. **ai->nr_groups** and **ai->groups** describe virtual memory layout of percpu areas. Units which should be colocated are put into the same group. Dynamic VM areas will be allocated according to these groupings. If **ai->nr_groups** is zero, a single group containing all units is assumed. The caller should have mapped the first chunk at **base_addr** and copied static data to each unit. The first chunk will always contain a static and a dynamic region. However, the static region is not managed by any chunk. If the first chunk also contains a reserved region, it is served by two chunks - one for the reserved region and one for the dynamic region. They share the same vm, but use offset regions in the area allocation map. The chunk serving the dynamic region is circulated in the chunk slots and available for dynamic allocation like any other chunk.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM hjubj)}(hhh](j)}(h]``const struct pcpu_alloc_info *ai`` pcpu_alloc_info describing how to percpu area is shaped h](j)}(h$``const struct pcpu_alloc_info *ai``h]jS)}(hj h]h const struct pcpu_alloc_info *ai}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM hjubj)}(hhh]jM)}(h7pcpu_alloc_info describing how to percpu area is shapedh]h7pcpu_alloc_info describing how to percpu area is shaped}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj"hM hj#ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj"hM hjubj)}(h#``void *base_addr`` mapped address h](j)}(h``void *base_addr``h]jS)}(hjFh]hvoid *base_addr}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjDubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM hj@ubj)}(hhh]jM)}(hmapped addressh]hmapped address}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj[hM hj\ubah}(h]h ]h"]h$]h&]uh1jhj@ubeh}(h]h ]h"]h$]h&]uh1jhj[hM hjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM hjubjM)}(hInitialize the first percpu chunk which contains the kernel static percpu area. This function is to be called from arch percpu area setup path.h]hInitialize the first percpu chunk which contains the kernel static percpu area. This function is to be called from arch percpu area setup path.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM hjubjM)}(ho**ai** contains all information necessary to initialize the first chunk and prime the dynamic percpu allocator.h](j)}(h**ai**h]hai}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhi contains all information necessary to initialize the first chunk and prime the dynamic percpu allocator.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM hjubjM)}(h6**ai->static_size** is the size of static percpu area.h](j)}(h**ai->static_size**h]hai->static_size}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh# is the size of static percpu area.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM hjubjM)}(hX**ai->reserved_size**, if non-zero, specifies the amount of bytes to reserve after the static area in the first chunk. This reserves the first chunk such that it's available only through reserved percpu allocation. This is primarily used to serve module percpu static areas on architectures where the addressing model has limited offset range for symbol relocations to guarantee module percpu symbols fall inside the relocatable range.h](j)}(h**ai->reserved_size**h]hai->reserved_size}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhX, if non-zero, specifies the amount of bytes to reserve after the static area in the first chunk. This reserves the first chunk such that it’s available only through reserved percpu allocation. This is primarily used to serve module percpu static areas on architectures where the addressing model has limited offset range for symbol relocations to guarantee module percpu symbols fall inside the relocatable range.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM hjubjM)}(h**ai->dyn_size** determines the number of bytes available for dynamic allocation in the first chunk. The area between **ai->static_size** + **ai->reserved_size** + **ai->dyn_size** and **ai->unit_size** is unused.h](j)}(h**ai->dyn_size**h]h ai->dyn_size}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhg determines the number of bytes available for dynamic allocation in the first chunk. The area between }(hjhhhNhNubj)}(h**ai->static_size**h]hai->static_size}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh + }(hjhhhNhNubj)}(h**ai->reserved_size**h]hai->reserved_size}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh + }(hjhhhNhNubj)}(h**ai->dyn_size**h]h ai->dyn_size}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh and }(hjhhhNhNubj)}(h**ai->unit_size**h]h ai->unit_size}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh is unused.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM hjubjM)}(h**ai->unit_size** specifies unit size and must be aligned to PAGE_SIZE and equal to or larger than **ai->static_size** + **ai->reserved_size** + **ai->dyn_size**.h](j)}(h**ai->unit_size**h]h ai->unit_size}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjbubhR specifies unit size and must be aligned to PAGE_SIZE and equal to or larger than }(hjbhhhNhNubj)}(h**ai->static_size**h]hai->static_size}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjbubh + }(hjbhhhNhNubj)}(h**ai->reserved_size**h]hai->reserved_size}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjbubh + }(hjbhhhNhNubj)}(h**ai->dyn_size**h]h ai->dyn_size}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjbubh.}(hjbhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM hjubjM)}(hQ**ai->atom_size** is the allocation atom size and used as alignment for vm areas.h](j)}(h**ai->atom_size**h]h ai->atom_size}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh@ is the allocation atom size and used as alignment for vm areas.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM hjubjM)}(h**ai->alloc_size** is the allocation size and always multiple of **ai->atom_size**. This is larger than **ai->atom_size** if **ai->unit_size** is larger than **ai->atom_size**.h](j)}(h**ai->alloc_size**h]hai->alloc_size}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh/ is the allocation size and always multiple of }(hjhhhNhNubj)}(h**ai->atom_size**h]h ai->atom_size}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh. This is larger than }(hjhhhNhNubj)}(h**ai->atom_size**h]h ai->atom_size}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh if }(hjhhhNhNubj)}(h**ai->unit_size**h]h ai->unit_size}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh is larger than }(hjhhhNhNubj)}(h**ai->atom_size**h]h ai->atom_size}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM hjubjM)}(hX#**ai->nr_groups** and **ai->groups** describe virtual memory layout of percpu areas. Units which should be colocated are put into the same group. Dynamic VM areas will be allocated according to these groupings. If **ai->nr_groups** is zero, a single group containing all units is assumed.h](j)}(h**ai->nr_groups**h]h ai->nr_groups}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj7ubh and }(hj7hhhNhNubj)}(h**ai->groups**h]h ai->groups}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj7ubh describe virtual memory layout of percpu areas. Units which should be colocated are put into the same group. Dynamic VM areas will be allocated according to these groupings. If }(hj7hhhNhNubj)}(h**ai->nr_groups**h]h ai->nr_groups}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj7ubh9 is zero, a single group containing all units is assumed.}(hj7hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM hjubjM)}(hcThe caller should have mapped the first chunk at **base_addr** and copied static data to each unit.h](h1The caller should have mapped the first chunk at }(hjxhhhNhNubj)}(h **base_addr**h]h base_addr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjxubh% and copied static data to each unit.}(hjxhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM hjubjM)}(hXThe first chunk will always contain a static and a dynamic region. However, the static region is not managed by any chunk. If the first chunk also contains a reserved region, it is served by two chunks - one for the reserved region and one for the dynamic region. They share the same vm, but use offset regions in the area allocation map. The chunk serving the dynamic region is circulated in the chunk slots and available for dynamic allocation like any other chunk.h]hXThe first chunk will always contain a static and a dynamic region. However, the static region is not managed by any chunk. If the first chunk also contains a reserved region, it is served by two chunks - one for the reserved region and one for the dynamic region. They share the same vm, but use offset regions in the area allocation map. The chunk serving the dynamic region is circulated in the chunk slots and available for dynamic allocation like any other chunk.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h"pcpu_build_alloc_info (C function)c.pcpu_build_alloc_infohNtauh1hhjKhhhNhNubh)}(hhh](h)}(hstruct pcpu_alloc_info * pcpu_build_alloc_info (size_t reserved_size, size_t dyn_size, size_t atom_size, pcpu_fc_cpu_distance_fn_t cpu_distance_fn)h]h)}(hstruct pcpu_alloc_info *pcpu_build_alloc_info(size_t reserved_size, size_t dyn_size, size_t atom_size, pcpu_fc_cpu_distance_fn_t cpu_distance_fn)h](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM ubh)}(hhh]j)}(hpcpu_alloc_infoh]hpcpu_alloc_info}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jpcpu_build_alloc_infosbc.pcpu_build_alloc_infoasbuh1hhjhhhjhM ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM ubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjhhhjhM ubh)}(hpcpu_build_alloc_infoh]j)}(hjh]hpcpu_build_alloc_info}(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhM ubj8)}(hd(size_t reserved_size, size_t dyn_size, size_t atom_size, pcpu_fc_cpu_distance_fn_t cpu_distance_fn)h](j>)}(hsize_t reserved_sizeh](h)}(hhh]j)}(hsize_th]hsize_t}(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjGmodnameN classnameNjj)}j]jc.pcpu_build_alloc_infoasbuh1hhj>ubj)}(h h]h }(hjchhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>ubj)}(h reserved_sizeh]h reserved_size}(hjqhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj:ubj>)}(hsize_t dyn_sizeh](h)}(hhh]j)}(hsize_th]hsize_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.pcpu_build_alloc_infoasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hdyn_sizeh]hdyn_size}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj:ubj>)}(hsize_t atom_sizeh](h)}(hhh]j)}(hsize_th]hsize_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.pcpu_build_alloc_infoasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h atom_sizeh]h atom_size}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj:ubj>)}(h)pcpu_fc_cpu_distance_fn_t cpu_distance_fnh](h)}(hhh]j)}(hpcpu_fc_cpu_distance_fn_th]hpcpu_fc_cpu_distance_fn_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.pcpu_build_alloc_infoasbuh1hhjubj)}(h h]h }(hj;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hcpu_distance_fnh]hcpu_distance_fn}(hjIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj:ubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhM ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhM ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhM hjhhubj4)}(hhh]jM)}(h3build alloc_info considering distances between CPUsh]h3build alloc_info considering distances between CPUs}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM hjphhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhM ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``size_t reserved_size`` the size of reserved percpu area in bytes ``size_t dyn_size`` minimum free size for dynamic allocation in bytes ``size_t atom_size`` allocation atom size ``pcpu_fc_cpu_distance_fn_t cpu_distance_fn`` callback to determine distance between cpus, optional **Description** This function determines grouping of units, their mappings to cpus and other parameters considering needed percpu size, allocation atom size and distances between CPUs. Groups are always multiples of atom size and CPUs which are of LOCAL_DISTANCE both ways are grouped together and share space for units in the same group. The returned configuration is guaranteed to have CPUs on different nodes on different groups and >=75% usage of allocated virtual address space. **Return** On success, pointer to the new allocation_info is returned. On failure, ERR_PTR value is returned.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM hjubj)}(hhh](j)}(hC``size_t reserved_size`` the size of reserved percpu area in bytes h](j)}(h``size_t reserved_size``h]jS)}(hjh]hsize_t reserved_size}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM hjubj)}(hhh]jM)}(h)the size of reserved percpu area in bytesh]h)the size of reserved percpu area in bytes}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hjubj)}(hF``size_t dyn_size`` minimum free size for dynamic allocation in bytes h](j)}(h``size_t dyn_size``h]jS)}(hjh]hsize_t dyn_size}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM hjubj)}(hhh]jM)}(h1minimum free size for dynamic allocation in bytesh]h1minimum free size for dynamic allocation in bytes}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hjubj)}(h*``size_t atom_size`` allocation atom size h](j)}(h``size_t atom_size``h]jS)}(hj&h]hsize_t atom_size}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj$ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM hj ubj)}(hhh]jM)}(hallocation atom sizeh]hallocation atom size}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj;hM hj<ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj;hM hjubj)}(hd``pcpu_fc_cpu_distance_fn_t cpu_distance_fn`` callback to determine distance between cpus, optional h](j)}(h-``pcpu_fc_cpu_distance_fn_t cpu_distance_fn``h]jS)}(hj_h]h)pcpu_fc_cpu_distance_fn_t cpu_distance_fn}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj]ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM hjYubj)}(hhh]jM)}(h5callback to determine distance between cpus, optionalh]h5callback to determine distance between cpus, optional}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjthM hjuubah}(h]h ]h"]h$]h&]uh1jhjYubeh}(h]h ]h"]h$]h&]uh1jhjthM hjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM hjubjM)}(hThis function determines grouping of units, their mappings to cpus and other parameters considering needed percpu size, allocation atom size and distances between CPUs.h]hThis function determines grouping of units, their mappings to cpus and other parameters considering needed percpu size, allocation atom size and distances between CPUs.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM hjubjM)}(hX+Groups are always multiples of atom size and CPUs which are of LOCAL_DISTANCE both ways are grouped together and share space for units in the same group. The returned configuration is guaranteed to have CPUs on different nodes on different groups and >=75% usage of allocated virtual address space.h]hX+Groups are always multiples of atom size and CPUs which are of LOCAL_DISTANCE both ways are grouped together and share space for units in the same group. The returned configuration is guaranteed to have CPUs on different nodes on different groups and >=75% usage of allocated virtual address space.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM hjubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM hjubjM)}(hcOn success, pointer to the new allocation_info is returned. On failure, ERR_PTR value is returned.h]hcOn success, pointer to the new allocation_info is returned. On failure, ERR_PTR value is returned.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h#pcpu_embed_first_chunk (C function)c.pcpu_embed_first_chunkhNtauh1hhjKhhhNhNubh)}(hhh](h)}(hint pcpu_embed_first_chunk (size_t reserved_size, size_t dyn_size, size_t atom_size, pcpu_fc_cpu_distance_fn_t cpu_distance_fn, pcpu_fc_cpu_to_node_fn_t cpu_to_nd_fn)h]h)}(hint pcpu_embed_first_chunk(size_t reserved_size, size_t dyn_size, size_t atom_size, pcpu_fc_cpu_distance_fn_t cpu_distance_fn, pcpu_fc_cpu_to_node_fn_t cpu_to_nd_fn)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM ubj)}(h h]h }(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhj#hM ubh)}(hpcpu_embed_first_chunkh]j)}(hpcpu_embed_first_chunkh]hpcpu_embed_first_chunk}(hj6hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhj#hM ubj8)}(h(size_t reserved_size, size_t dyn_size, size_t atom_size, pcpu_fc_cpu_distance_fn_t cpu_distance_fn, pcpu_fc_cpu_to_node_fn_t cpu_to_nd_fn)h](j>)}(hsize_t reserved_sizeh](h)}(hhh]j)}(hsize_th]hsize_t}(hjUhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjWmodnameN classnameNjj)}j]j)}jj8sbc.pcpu_embed_first_chunkasbuh1hhjNubj)}(h h]h }(hjuhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubj)}(h reserved_sizeh]h reserved_size}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjJubj>)}(hsize_t dyn_sizeh](h)}(hhh]j)}(hsize_th]hsize_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jqc.pcpu_embed_first_chunkasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hdyn_sizeh]hdyn_size}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjJubj>)}(hsize_t atom_sizeh](h)}(hhh]j)}(hsize_th]hsize_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jqc.pcpu_embed_first_chunkasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h atom_sizeh]h atom_size}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjJubj>)}(h)pcpu_fc_cpu_distance_fn_t cpu_distance_fnh](h)}(hhh]j)}(hpcpu_fc_cpu_distance_fn_th]hpcpu_fc_cpu_distance_fn_t}(hj/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj1modnameN classnameNjj)}j]jqc.pcpu_embed_first_chunkasbuh1hhj(ubj)}(h h]h }(hjMhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(ubj)}(hcpu_distance_fnh]hcpu_distance_fn}(hj[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjJubj>)}(h%pcpu_fc_cpu_to_node_fn_t cpu_to_nd_fnh](h)}(hhh]j)}(hpcpu_fc_cpu_to_node_fn_th]hpcpu_fc_cpu_to_node_fn_t}(hjwhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjtubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjymodnameN classnameNjj)}j]jqc.pcpu_embed_first_chunkasbuh1hhjpubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpubj)}(h cpu_to_nd_fnh]h cpu_to_nd_fn}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjJubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhj#hM ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj hhhj#hM ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj#hM hj hhubj4)}(hhh]jM)}(h)embed the first percpu chunk into bootmemh]h)embed the first percpu chunk into bootmem}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM hjhhubah}(h]h ]h"]h$]h&]uh1j3hj hhhj#hM ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hXa**Parameters** ``size_t reserved_size`` the size of reserved percpu area in bytes ``size_t dyn_size`` minimum free size for dynamic allocation in bytes ``size_t atom_size`` allocation atom size ``pcpu_fc_cpu_distance_fn_t cpu_distance_fn`` callback to determine distance between cpus, optional ``pcpu_fc_cpu_to_node_fn_t cpu_to_nd_fn`` callback to convert cpu to it's node, optional **Description** This is a helper to ease setting up embedded first percpu chunk and can be called where pcpu_setup_first_chunk() is expected. If this function is used to setup the first chunk, it is allocated by calling pcpu_fc_alloc and used as-is without being mapped into vmalloc area. Allocations are always whole multiples of **atom_size** aligned to **atom_size**. This enables the first chunk to piggy back on the linear physical mapping which often uses larger page size. Please note that this can result in very sparse cpu->unit mapping on NUMA machines thus requiring large vmalloc address space. Don't use this allocator if vmalloc space is not orders of magnitude larger than distances between node memory addresses (ie. 32bit NUMA machines). **dyn_size** specifies the minimum dynamic area size. If the needed size is smaller than the minimum or specified unit size, the leftover is returned using pcpu_fc_free. **Return** 0 on success, -errno on failure.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM hjubj)}(hhh](j)}(hC``size_t reserved_size`` the size of reserved percpu area in bytes h](j)}(h``size_t reserved_size``h]jS)}(hjh]hsize_t reserved_size}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM hjubj)}(hhh]jM)}(h)the size of reserved percpu area in bytesh]h)the size of reserved percpu area in bytes}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj#hM hj$ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj#hM hjubj)}(hF``size_t dyn_size`` minimum free size for dynamic allocation in bytes h](j)}(h``size_t dyn_size``h]jS)}(hjGh]hsize_t dyn_size}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjEubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM hjAubj)}(hhh]jM)}(h1minimum free size for dynamic allocation in bytesh]h1minimum free size for dynamic allocation in bytes}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj\hM hj]ubah}(h]h ]h"]h$]h&]uh1jhjAubeh}(h]h ]h"]h$]h&]uh1jhj\hM hjubj)}(h*``size_t atom_size`` allocation atom size h](j)}(h``size_t atom_size``h]jS)}(hjh]hsize_t atom_size}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj~ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM hjzubj)}(hhh]jM)}(hallocation atom sizeh]hallocation atom size}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjzubeh}(h]h ]h"]h$]h&]uh1jhjhM hjubj)}(hd``pcpu_fc_cpu_distance_fn_t cpu_distance_fn`` callback to determine distance between cpus, optional h](j)}(h-``pcpu_fc_cpu_distance_fn_t cpu_distance_fn``h]jS)}(hjh]h)pcpu_fc_cpu_distance_fn_t cpu_distance_fn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM hjubj)}(hhh]jM)}(h5callback to determine distance between cpus, optionalh]h5callback to determine distance between cpus, optional}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hjubj)}(hY``pcpu_fc_cpu_to_node_fn_t cpu_to_nd_fn`` callback to convert cpu to it's node, optional h](j)}(h)``pcpu_fc_cpu_to_node_fn_t cpu_to_nd_fn``h]jS)}(hjh]h%pcpu_fc_cpu_to_node_fn_t cpu_to_nd_fn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM hjubj)}(hhh]jM)}(h.callback to convert cpu to it's node, optionalh]h0callback to convert cpu to it’s node, optional}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hj-h]h Description}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj+ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM hjubjM)}(h}This is a helper to ease setting up embedded first percpu chunk and can be called where pcpu_setup_first_chunk() is expected.h]h}This is a helper to ease setting up embedded first percpu chunk and can be called where pcpu_setup_first_chunk() is expected.}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM hjubjM)}(hIf this function is used to setup the first chunk, it is allocated by calling pcpu_fc_alloc and used as-is without being mapped into vmalloc area. Allocations are always whole multiples of **atom_size** aligned to **atom_size**.h](hIf this function is used to setup the first chunk, it is allocated by calling pcpu_fc_alloc and used as-is without being mapped into vmalloc area. Allocations are always whole multiples of }(hjRhhhNhNubj)}(h **atom_size**h]h atom_size}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjRubh aligned to }(hjRhhhNhNubj)}(h **atom_size**h]h atom_size}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjRubh.}(hjRhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM hjubjM)}(hXThis enables the first chunk to piggy back on the linear physical mapping which often uses larger page size. Please note that this can result in very sparse cpu->unit mapping on NUMA machines thus requiring large vmalloc address space. Don't use this allocator if vmalloc space is not orders of magnitude larger than distances between node memory addresses (ie. 32bit NUMA machines).h]hXThis enables the first chunk to piggy back on the linear physical mapping which often uses larger page size. Please note that this can result in very sparse cpu->unit mapping on NUMA machines thus requiring large vmalloc address space. Don’t use this allocator if vmalloc space is not orders of magnitude larger than distances between node memory addresses (ie. 32bit NUMA machines).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM hjubjM)}(h5**dyn_size** specifies the minimum dynamic area size.h](j)}(h **dyn_size**h]hdyn_size}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh) specifies the minimum dynamic area size.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM hjubjM)}(hsIf the needed size is smaller than the minimum or specified unit size, the leftover is returned using pcpu_fc_free.h]hsIf the needed size is smaller than the minimum or specified unit size, the leftover is returned using pcpu_fc_free.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM hjubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM hjubjM)}(h 0 on success, -errno on failure.h]h 0 on success, -errno on failure.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h"pcpu_page_first_chunk (C function)c.pcpu_page_first_chunkhNtauh1hhjKhhhNhNubh)}(hhh](h)}(hWint pcpu_page_first_chunk (size_t reserved_size, pcpu_fc_cpu_to_node_fn_t cpu_to_nd_fn)h]h)}(hVint pcpu_page_first_chunk(size_t reserved_size, pcpu_fc_cpu_to_node_fn_t cpu_to_nd_fn)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMq ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMq ubh)}(hpcpu_page_first_chunkh]j)}(hpcpu_page_first_chunkh]hpcpu_page_first_chunk}(hj(hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMq ubj8)}(h=(size_t reserved_size, pcpu_fc_cpu_to_node_fn_t cpu_to_nd_fn)h](j>)}(hsize_t reserved_sizeh](h)}(hhh]j)}(hsize_th]hsize_t}(hjGhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjDubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjImodnameN classnameNjj)}j]j)}jj*sbc.pcpu_page_first_chunkasbuh1hhj@ubj)}(h h]h }(hjghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@ubj)}(h reserved_sizeh]h reserved_size}(hjuhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj<ubj>)}(h%pcpu_fc_cpu_to_node_fn_t cpu_to_nd_fnh](h)}(hhh]j)}(hpcpu_fc_cpu_to_node_fn_th]hpcpu_fc_cpu_to_node_fn_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jcc.pcpu_page_first_chunkasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h cpu_to_nd_fnh]h cpu_to_nd_fn}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj<ubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMq ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMq ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMq hjhhubj4)}(hhh]jM)}(h)map the first chunk using PAGE_SIZE pagesh]h)map the first chunk using PAGE_SIZE pages}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMq hjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMq ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``size_t reserved_size`` the size of reserved percpu area in bytes ``pcpu_fc_cpu_to_node_fn_t cpu_to_nd_fn`` callback to convert cpu to it's node, optional **Description** This is a helper to ease setting up page-remapped first percpu chunk and can be called where pcpu_setup_first_chunk() is expected. This is the basic allocator. Static percpu area is allocated page-by-page into vmalloc area. **Return** 0 on success, -errno on failure.h](jM)}(h**Parameters**h]j)}(hj h]h Parameters}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMu hjubj)}(hhh](j)}(hC``size_t reserved_size`` the size of reserved percpu area in bytes h](j)}(h``size_t reserved_size``h]jS)}(hj(h]hsize_t reserved_size}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj&ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMr hj"ubj)}(hhh]jM)}(h)the size of reserved percpu area in bytesh]h)the size of reserved percpu area in bytes}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj=hMr hj>ubah}(h]h ]h"]h$]h&]uh1jhj"ubeh}(h]h ]h"]h$]h&]uh1jhj=hMr hjubj)}(hY``pcpu_fc_cpu_to_node_fn_t cpu_to_nd_fn`` callback to convert cpu to it's node, optional h](j)}(h)``pcpu_fc_cpu_to_node_fn_t cpu_to_nd_fn``h]jS)}(hjah]h%pcpu_fc_cpu_to_node_fn_t cpu_to_nd_fn}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj_ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMs hj[ubj)}(hhh]jM)}(h.callback to convert cpu to it's node, optionalh]h0callback to convert cpu to it’s node, optional}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjvhMs hjwubah}(h]h ]h"]h$]h&]uh1jhj[ubeh}(h]h ]h"]h$]h&]uh1jhjvhMs hjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMu hjubjM)}(hThis is a helper to ease setting up page-remapped first percpu chunk and can be called where pcpu_setup_first_chunk() is expected.h]hThis is a helper to ease setting up page-remapped first percpu chunk and can be called where pcpu_setup_first_chunk() is expected.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMt hjubjM)}(h]This is the basic allocator. Static percpu area is allocated page-by-page into vmalloc area.h]h]This is the basic allocator. Static percpu area is allocated page-by-page into vmalloc area.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMw hjubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chMz hjubjM)}(h 0 on success, -errno on failure.h]h 0 on success, -errno on failure.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:141: ./mm/percpu.chM{ hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h#copy_from_user_nofault (C function)c.copy_from_user_nofaulthNtauh1hhjKhhhNhNubh)}(hhh](h)}(hLlong copy_from_user_nofault (void *dst, const void __user *src, size_t size)h]h)}(hKlong copy_from_user_nofault(void *dst, const void __user *src, size_t size)h](j)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:142: ./mm/maccess.chKpubj)}(h h]h }(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhj%hKpubh)}(hcopy_from_user_nofaulth]j)}(hcopy_from_user_nofaulth]hcopy_from_user_nofault}(hj8hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhj%hKpubj8)}(h0(void *dst, const void __user *src, size_t size)h](j>)}(h void *dsth](j)}(hvoidh]hvoid}(hjThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjPubj)}(h h]h }(hjbhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjPubjr)}(hjuh]h*}(hjphhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjPubj)}(hdsth]hdst}(hj}hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjPubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjLubj>)}(hconst void __user *srch](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh__user}(hjhhhNhNubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hsrch]hsrc}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjLubj>)}(h size_t sizeh](h)}(hhh]j)}(hsize_th]hsize_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj modnameN classnameNjj)}j]j)}jj:sbc.copy_from_user_nofaultasbuh1hhjubj)}(h h]h }(hj(hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hsizeh]hsize}(hj6hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjLubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhj%hKpubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhj%hKpubah}(h]j ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj%hKphj hhubj4)}(hhh]jM)}(h1safely attempt to read from a user-space locationh]h1safely attempt to read from a user-space location}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:142: ./mm/maccess.chKphj]hhubah}(h]h ]h"]h$]h&]uh1j3hj hhhj%hKpubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjxjHjxjIjJjKuh1hhhhjKhNhNubj)}(hXV**Parameters** ``void *dst`` pointer to the buffer that shall take the data ``const void __user *src`` address to read from. This must be a user address. ``size_t size`` size of the data chunk **Description** Safely read from user address **src** to the buffer at **dst**. If a kernel fault happens, handle that and return -EFAULT.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:142: ./mm/maccess.chKthj|ubj)}(hhh](j)}(h=``void *dst`` pointer to the buffer that shall take the data h](j)}(h ``void *dst``h]jS)}(hjh]h void *dst}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:142: ./mm/maccess.chKqhjubj)}(hhh]jM)}(h.pointer to the buffer that shall take the datah]h.pointer to the buffer that shall take the data}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhKqhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKqhjubj)}(hN``const void __user *src`` address to read from. This must be a user address. h](j)}(h``const void __user *src``h]jS)}(hjh]hconst void __user *src}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:142: ./mm/maccess.chKrhjubj)}(hhh]jM)}(h2address to read from. This must be a user address.h]h2address to read from. This must be a user address.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhKrhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKrhjubj)}(h'``size_t size`` size of the data chunk h](j)}(h``size_t size``h]jS)}(hjh]h size_t size}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:142: ./mm/maccess.chKshj ubj)}(hhh]jM)}(hsize of the data chunkh]hsize of the data chunk}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj(hKshj)ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj(hKshjubeh}(h]h ]h"]h$]h&]uh1jhj|ubjM)}(h**Description**h]j)}(hjNh]h Description}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjLubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:142: ./mm/maccess.chKuhj|ubjM)}(hzSafely read from user address **src** to the buffer at **dst**. If a kernel fault happens, handle that and return -EFAULT.h](hSafely read from user address }(hjdhhhNhNubj)}(h**src**h]hsrc}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjdubh to the buffer at }(hjdhhhNhNubj)}(h**dst**h]hdst}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjdubh<. If a kernel fault happens, handle that and return -EFAULT.}(hjdhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:142: ./mm/maccess.chKthj|ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h!copy_to_user_nofault (C function)c.copy_to_user_nofaulthNtauh1hhjKhhhNhNubh)}(hhh](h)}(hJlong copy_to_user_nofault (void __user *dst, const void *src, size_t size)h]h)}(hIlong copy_to_user_nofault(void __user *dst, const void *src, size_t size)h](j)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:142: ./mm/maccess.chKubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhKubh)}(hcopy_to_user_nofaulth]j)}(hcopy_to_user_nofaulth]hcopy_to_user_nofault}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhKubj8)}(h0(void __user *dst, const void *src, size_t size)h](j>)}(hvoid __user *dsth](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh__user}(hjhhhNhNubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hj"hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hdsth]hdst}(hj/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hconst void *srch](j)}(hjh]hconst}(hjHhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjDubj)}(h h]h }(hjUhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjDubj)}(hvoidh]hvoid}(hjchhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjDubj)}(h h]h }(hjqhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjDubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjDubj)}(hsrch]hsrc}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjDubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(h size_t sizeh](h)}(hhh]j)}(hsize_th]hsize_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsbc.copy_to_user_nofaultasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hsizeh]hsize}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhKubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhKubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhKhjhhubj4)}(hhh]jM)}(h0safely attempt to write to a user-space locationh]h0safely attempt to write to a user-space location}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:142: ./mm/maccess.chKhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhKubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hX/**Parameters** ``void __user *dst`` address to write to ``const void *src`` pointer to the data that shall be written ``size_t size`` size of the data chunk **Description** Safely write to address **dst** from the buffer at **src**. If a kernel fault happens, handle that and return -EFAULT.h](jM)}(h**Parameters**h]j)}(hj"h]h Parameters}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:142: ./mm/maccess.chKhjubj)}(hhh](j)}(h)``void __user *dst`` address to write to h](j)}(h``void __user *dst``h]jS)}(hjAh]hvoid __user *dst}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj?ubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:142: ./mm/maccess.chKhj;ubj)}(hhh]jM)}(haddress to write toh]haddress to write to}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjVhKhjWubah}(h]h ]h"]h$]h&]uh1jhj;ubeh}(h]h ]h"]h$]h&]uh1jhjVhKhj8ubj)}(h>``const void *src`` pointer to the data that shall be written h](j)}(h``const void *src``h]jS)}(hjzh]hconst void *src}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjxubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:142: ./mm/maccess.chKhjtubj)}(hhh]jM)}(h)pointer to the data that shall be writtenh]h)pointer to the data that shall be written}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjtubeh}(h]h ]h"]h$]h&]uh1jhjhKhj8ubj)}(h'``size_t size`` size of the data chunk h](j)}(h``size_t size``h]jS)}(hjh]h size_t size}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:142: ./mm/maccess.chKhjubj)}(hhh]jM)}(hsize of the data chunkh]hsize of the data chunk}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhj8ubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:142: ./mm/maccess.chKhjubjM)}(hwSafely write to address **dst** from the buffer at **src**. If a kernel fault happens, handle that and return -EFAULT.h](hSafely write to address }(hjhhhNhNubj)}(h**dst**h]hdst}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh from the buffer at }(hjhhhNhNubj)}(h**src**h]hsrc}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh=. If a kernel fault happens, handle that and return -EFAULT.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:142: ./mm/maccess.chKhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h&strncpy_from_user_nofault (C function)c.strncpy_from_user_nofaulthNtauh1hhjKhhhNhNubh)}(hhh](h)}(hVlong strncpy_from_user_nofault (char *dst, const void __user *unsafe_addr, long count)h]h)}(hUlong strncpy_from_user_nofault(char *dst, const void __user *unsafe_addr, long count)h](j)}(hlongh]hlong}(hjWhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjShhhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:142: ./mm/maccess.chKubj)}(h h]h }(hjfhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjShhhjehKubh)}(hstrncpy_from_user_nofaulth]j)}(hstrncpy_from_user_nofaulth]hstrncpy_from_user_nofault}(hjxhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjtubah}(h]h ](jjeh"]h$]h&]jjuh1hhjShhhjehKubj8)}(h7(char *dst, const void __user *unsafe_addr, long count)h](j>)}(h char *dsth](j)}(hcharh]hchar}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hdsth]hdst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hconst void __user *unsafe_addrh](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh__user}(hjhhhNhNubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(h unsafe_addrh]h unsafe_addr}(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(h long counth](j)}(hlongh]hlong}(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjAubj)}(h h]h }(hjShhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjAubj)}(hcounth]hcount}(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjAubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjShhhjehKubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjOhhhjehKubah}(h]jJah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjehKhjLhhubj4)}(hhh]j^)}(hhh]jc)}(h6Copy a NUL terminated string from unsafe user address.h]jM)}(hjh]h6Copy a NUL terminated string from unsafe user address.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:142: ./mm/maccess.chKhjubah}(h]h ]h"]h$]h&]uh1jbhjhhhjhNubah}(h]h ]h"]h$]h&]jjuh1j]hjhKhjhhubah}(h]h ]h"]h$]h&]uh1j3hjLhhhjehKubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``char *dst`` Destination address, in kernel space. This buffer must be at least **count** bytes long. ``const void __user *unsafe_addr`` Unsafe user address. ``long count`` Maximum number of bytes to copy, including the trailing NUL. **Description** Copies a NUL-terminated string from unsafe user address to kernel buffer. On success, returns the length of the string INCLUDING the trailing NUL. If access fails, returns -EFAULT (some data may have been copied and the trailing NUL added). If **count** is smaller than the length of the string, copies **count**-1 bytes, sets the last byte of **dst** buffer to NUL and returns **count**.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:142: ./mm/maccess.chKhjubj)}(hhh](j)}(hh``char *dst`` Destination address, in kernel space. This buffer must be at least **count** bytes long. h](j)}(h ``char *dst``h]jS)}(hjh]h char *dst}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:142: ./mm/maccess.chKhjubj)}(hhh]jM)}(hYDestination address, in kernel space. This buffer must be at least **count** bytes long.h](hDDestination address, in kernel space. This buffer must be at least }(hjhhhNhNubj)}(h **count**h]hcount}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh bytes long.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:142: ./mm/maccess.chKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubj)}(h8``const void __user *unsafe_addr`` Unsafe user address. h](j)}(h"``const void __user *unsafe_addr``h]jS)}(hj*h]hconst void __user *unsafe_addr}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj(ubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:142: ./mm/maccess.chKhj$ubj)}(hhh]jM)}(hUnsafe user address.h]hUnsafe user address.}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj?hKhj@ubah}(h]h ]h"]h$]h&]uh1jhj$ubeh}(h]h ]h"]h$]h&]uh1jhj?hKhjubj)}(hL``long count`` Maximum number of bytes to copy, including the trailing NUL. h](j)}(h``long count``h]jS)}(hjch]h long count}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjaubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:142: ./mm/maccess.chKhj]ubj)}(hhh]jM)}(h)}(hconst void __user *unsafe_addrh](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh__user}(hjhhhNhNubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(h unsafe_addrh]h unsafe_addr}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(h long counth](j)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hcounth]hcount}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjThhhjfhKubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjPhhhjfhKubah}(h]jKah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjfhKhjMhhubj4)}(hhh]j^)}(hhh]jc)}(h2Get the size of a user string INCLUDING final NUL.h]jM)}(hjOh]h2Get the size of a user string INCLUDING final NUL.}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:142: ./mm/maccess.chKhjMubah}(h]h ]h"]h$]h&]uh1jbhjJhhhj^hNubah}(h]h ]h"]h$]h&]jjuh1j]hj^hKhjGhhubah}(h]h ]h"]h$]h&]uh1j3hjMhhhjfhKubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjtjHjtjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``const void __user *unsafe_addr`` The string to measure. ``long count`` Maximum count (including NUL) **Description** Get the size of a NUL-terminated string in user space without pagefault. Returns the size of the string INCLUDING the terminating NUL. If the string is too long, returns a number larger than **count**. User has to check the return value against "> count". On exception (or invalid count), returns 0. Unlike strnlen_user, this can be used from IRQ handler etc. because it disables pagefaults.h](jM)}(h**Parameters**h]j)}(hj~h]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj|ubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:142: ./mm/maccess.chKhjxubj)}(hhh](j)}(h:``const void __user *unsafe_addr`` The string to measure. h](j)}(h"``const void __user *unsafe_addr``h]jS)}(hjh]hconst void __user *unsafe_addr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:142: ./mm/maccess.chKhjubj)}(hhh]jM)}(hThe string to measure.h]hThe string to measure.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubj)}(h-``long count`` Maximum count (including NUL) h](j)}(h``long count``h]jS)}(hjh]h long count}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:142: ./mm/maccess.chKhjubj)}(hhh]jM)}(hMaximum count (including NUL)h]hMaximum count (including NUL)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubeh}(h]h ]h"]h$]h&]uh1jhjxubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:142: ./mm/maccess.chKhjxubjM)}(hHGet the size of a NUL-terminated string in user space without pagefault.h]hHGet the size of a NUL-terminated string in user space without pagefault.}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:142: ./mm/maccess.chKhjxubjM)}(h=Returns the size of the string INCLUDING the terminating NUL.h]h=Returns the size of the string INCLUDING the terminating NUL.}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:142: ./mm/maccess.chKhjxubjM)}(hIf the string is too long, returns a number larger than **count**. User has to check the return value against "> count". On exception (or invalid count), returns 0.h](h8If the string is too long, returns a number larger than }(hjEhhhNhNubj)}(h **count**h]hcount}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjEubhg. User has to check the return value against “> count”. On exception (or invalid count), returns 0.}(hjEhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:142: ./mm/maccess.chKhjxubjM)}(h[Unlike strnlen_user, this can be used from IRQ handler etc. because it disables pagefaults.h]h[Unlike strnlen_user, this can be used from IRQ handler etc. because it disables pagefaults.}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:142: ./mm/maccess.chKhjxubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h&writeback_throttling_sane (C function)c.writeback_throttling_sanehNtauh1hhjKhhhNhNubh)}(hhh](h)}(h8bool writeback_throttling_sane (struct scan_control *sc)h]h)}(h7bool writeback_throttling_sane(struct scan_control *sc)h](j)}(hjh]hbool}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:143: ./mm/vmscan.chKubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhKubh)}(hwriteback_throttling_saneh]j)}(hwriteback_throttling_saneh]hwriteback_throttling_sane}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhKubj8)}(h(struct scan_control *sc)h]j>)}(hstruct scan_control *sch](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(h scan_controlh]h scan_control}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsbc.writeback_throttling_saneasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hsch]hsc}(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhKubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhKubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhKhjhhubj4)}(hhh]jM)}(h2is the usual dirty throttling mechanism available?h]h2is the usual dirty throttling mechanism available?}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:143: ./mm/vmscan.chKhjQhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhKubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjljHjljIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct scan_control *sc`` scan_control in question **Description** The normal page dirty throttling mechanism in balance_dirty_pages() is completely broken with the legacy memcg and direct stalling in shrink_folio_list() is used for throttling instead, which lacks all the niceties such as fairness, adaptive pausing, bandwidth proportional allocation and configurability. This function tests whether the vmscan currently in progress can assume that the normal dirty throttling mechanism is operational.h](jM)}(h**Parameters**h]j)}(hjvh]h Parameters}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjtubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:143: ./mm/vmscan.chKhjpubj)}(hhh]j)}(h5``struct scan_control *sc`` scan_control in question h](j)}(h``struct scan_control *sc``h]jS)}(hjh]hstruct scan_control *sc}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:143: ./mm/vmscan.chKhjubj)}(hhh]jM)}(hscan_control in questionh]hscan_control in question}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjpubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:143: ./mm/vmscan.chKhjpubjM)}(hX1The normal page dirty throttling mechanism in balance_dirty_pages() is completely broken with the legacy memcg and direct stalling in shrink_folio_list() is used for throttling instead, which lacks all the niceties such as fairness, adaptive pausing, bandwidth proportional allocation and configurability.h]hX1The normal page dirty throttling mechanism in balance_dirty_pages() is completely broken with the legacy memcg and direct stalling in shrink_folio_list() is used for throttling instead, which lacks all the niceties such as fairness, adaptive pausing, bandwidth proportional allocation and configurability.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:143: ./mm/vmscan.chKhjpubjM)}(hThis function tests whether the vmscan currently in progress can assume that the normal dirty throttling mechanism is operational.h]hThis function tests whether the vmscan currently in progress can assume that the normal dirty throttling mechanism is operational.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:143: ./mm/vmscan.chMhjpubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hlruvec_lru_size (C function)c.lruvec_lru_sizehNtauh1hhjKhhhNhNubh)}(hhh](h)}(hVunsigned long lruvec_lru_size (struct lruvec *lruvec, enum lru_list lru, int zone_idx)h]h)}(hUunsigned long lruvec_lru_size(struct lruvec *lruvec, enum lru_list lru, int zone_idx)h](j)}(hunsignedh]hunsigned}(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:143: ./mm/vmscan.chMubj)}(h h]h }(hj3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhj2hMubj)}(hlongh]hlong}(hjAhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhj2hMubj)}(h h]h }(hjOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhj2hMubh)}(hlruvec_lru_sizeh]j)}(hlruvec_lru_sizeh]hlruvec_lru_size}(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj]ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj hhhj2hMubj8)}(h8(struct lruvec *lruvec, enum lru_list lru, int zone_idx)h](j>)}(hstruct lruvec *lruvech](j)}(hjJ,h]hstruct}(hj}hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyubh)}(hhh]j)}(hlruvech]hlruvec}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjcsbc.lruvec_lru_sizeasbuh1hhjyubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjyubj)}(hlruvech]hlruvec}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjuubj>)}(henum lru_list lruh](j)}(hj#!h]henum}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hlru_listh]hlru_list}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.lruvec_lru_sizeasbuh1hhjubj)}(h h]h }(hj+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hlruh]hlru}(hj9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjuubj>)}(h int zone_idxh](j)}(hinth]hint}(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubj)}(h h]h }(hj`hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubj)}(hzone_idxh]hzone_idx}(hjnhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjuubeh}(h]h ]h"]h$]h&]jjuh1j7hj hhhj2hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhj2hMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj2hMhjhhubj4)}(hhh]jM)}(h2Returns the number of pages on the given LRU list.h]h2Returns the number of pages on the given LRU list.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:143: ./mm/vmscan.chMhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhj2hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``struct lruvec *lruvec`` lru vector ``enum lru_list lru`` lru to use ``int zone_idx`` zones to consider (use MAX_NR_ZONES - 1 for the whole LRU list)h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:143: ./mm/vmscan.chMhjubj)}(hhh](j)}(h%``struct lruvec *lruvec`` lru vector h](j)}(h``struct lruvec *lruvec``h]jS)}(hjh]hstruct lruvec *lruvec}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:143: ./mm/vmscan.chMhjubj)}(hhh]jM)}(h lru vectorh]h lru vector}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h!``enum lru_list lru`` lru to use h](j)}(h``enum lru_list lru``h]jS)}(hjh]henum lru_list lru}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:143: ./mm/vmscan.chMhj ubj)}(hhh]jM)}(h lru to useh]h lru to use}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj'hMhj(ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj'hMhjubj)}(hP``int zone_idx`` zones to consider (use MAX_NR_ZONES - 1 for the whole LRU list)h](j)}(h``int zone_idx``h]jS)}(hjKh]h int zone_idx}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjIubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:143: ./mm/vmscan.chMhjEubj)}(hhh]jM)}(h?zones to consider (use MAX_NR_ZONES - 1 for the whole LRU list)h]h?zones to consider (use MAX_NR_ZONES - 1 for the whole LRU list)}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:143: ./mm/vmscan.chMhjaubah}(h]h ]h"]h$]h&]uh1jhjEubeh}(h]h ]h"]h$]h&]uh1jhj`hMhjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hremove_mapping (C function)c.remove_mappinghNtauh1hhjKhhhNhNubh)}(hhh](h)}(hHlong remove_mapping (struct address_space *mapping, struct folio *folio)h]h)}(hGlong remove_mapping(struct address_space *mapping, struct folio *folio)h](j)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:143: ./mm/vmscan.chMjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMjubh)}(hremove_mappingh]j)}(hremove_mappingh]hremove_mapping}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMjubj8)}(h4(struct address_space *mapping, struct folio *folio)h](j>)}(hstruct address_space *mappingh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(h address_spaceh]h address_space}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsbc.remove_mappingasbuh1hhjubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hj.hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hmappingh]hmapping}(hj;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hjThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjPubj)}(h h]h }(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjPubh)}(hhh]j)}(hfolioh]hfolio}(hjrhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjoubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjtmodnameN classnameNjj)}j]jc.remove_mappingasbuh1hhjPubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjPubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjPubj)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjPubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMjubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMjubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMjhjhhubj4)}(hhh]jM)}(h+Attempt to remove a folio from its mapping.h]h+Attempt to remove a folio from its mapping.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:143: ./mm/vmscan.chMjhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMjubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct address_space *mapping`` The address space. ``struct folio *folio`` The folio to remove. **Description** If the folio is dirty, under writeback or if someone else has a ref on it, removal will fail. **Return** The number of pages removed from the mapping. 0 if the folio could not be removed. **Context** The caller should have a single refcount on the folio and hold its lock.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:143: ./mm/vmscan.chMnhjubj)}(hhh](j)}(h5``struct address_space *mapping`` The address space. h](j)}(h!``struct address_space *mapping``h]jS)}(hjh]hstruct address_space *mapping}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:143: ./mm/vmscan.chMkhjubj)}(hhh]jM)}(hThe address space.h]hThe address space.}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj+hMkhj,ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj+hMkhj ubj)}(h-``struct folio *folio`` The folio to remove. h](j)}(h``struct folio *folio``h]jS)}(hjOh]hstruct folio *folio}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjMubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:143: ./mm/vmscan.chMlhjIubj)}(hhh]jM)}(hThe folio to remove.h]hThe folio to remove.}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjdhMlhjeubah}(h]h ]h"]h$]h&]uh1jhjIubeh}(h]h ]h"]h$]h&]uh1jhjdhMlhj ubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:143: ./mm/vmscan.chMnhjubjM)}(h]If the folio is dirty, under writeback or if someone else has a ref on it, removal will fail.h]h]If the folio is dirty, under writeback or if someone else has a ref on it, removal will fail.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:143: ./mm/vmscan.chMmhjubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:143: ./mm/vmscan.chMphjubjM)}(hSThe number of pages removed from the mapping. 0 if the folio could not be removed.h]hSThe number of pages removed from the mapping. 0 if the folio could not be removed.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:143: ./mm/vmscan.chMphjubjM)}(h **Context**h]j)}(hjh]hContext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:143: ./mm/vmscan.chMshjubjM)}(hHThe caller should have a single refcount on the folio and hold its lock.h]hHThe caller should have a single refcount on the folio and hold its lock.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:143: ./mm/vmscan.chMrhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNube(h)}(hhh]h}(h]h ]h"]h$]h&]entries](h&remove_mapping_set_shadow (C function)c.remove_mapping_set_shadowhNtauh1hhjKhhhNhNubh)}(hhh](h)}(htlong remove_mapping_set_shadow (struct address_space *mapping, struct folio *folio, struct mem_cgroup *target_memcg)h]h)}(hslong remove_mapping_set_shadow(struct address_space *mapping, struct folio *folio, struct mem_cgroup *target_memcg)h](j)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:143: ./mm/vmscan.chM{ubj)}(h h]h }(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhj+hM{ubh)}(hremove_mapping_set_shadowh]j)}(hremove_mapping_set_shadowh]hremove_mapping_set_shadow}(hj>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhj+hM{ubj8)}(hU(struct address_space *mapping, struct folio *folio, struct mem_cgroup *target_memcg)h](j>)}(hstruct address_space *mappingh](j)}(hjJ,h]hstruct}(hjZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVubj)}(h h]h }(hjghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVubh)}(hhh]j)}(h address_spaceh]h address_space}(hjxhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjuubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjzmodnameN classnameNjj)}j]j)}jj@sbc.remove_mapping_set_shadowasbuh1hhjVubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjVubj)}(hmappingh]hmapping}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjRubj>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.remove_mapping_set_shadowasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hfolioh]hfolio}(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjRubj>)}(hstruct mem_cgroup *target_memcgh](j)}(hjJ,h]hstruct}(hj<hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj8ubj)}(h h]h }(hjIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj8ubh)}(hhh]j)}(h mem_cgrouph]h mem_cgroup}(hjZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjWubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj\modnameN classnameNjj)}j]jc.remove_mapping_set_shadowasbuh1hhj8ubj)}(h h]h }(hjxhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj8ubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj8ubj)}(h target_memcgh]h target_memcg}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj8ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjRubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhj+hM{ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhj+hM{ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj+hM{hjhhubj4)}(hhh]jM)}(h-Remove a folio and record an eviction shadow.h]h-Remove a folio and record an eviction shadow.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:143: ./mm/vmscan.chM{hjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhj+hM{ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hXb**Parameters** ``struct address_space *mapping`` The address space. ``struct folio *folio`` The folio to remove. ``struct mem_cgroup *target_memcg`` The memcg to charge the eviction shadow to; the caller must keep it alive across the call. **Description** Like remove_mapping(), but stores a workingset eviction shadow the way page reclaim does, so that a later refault can be detected and the folio re-activated. **Return** The number of pages removed from the mapping. 0 if the folio could not be removed. **Context** The caller should have a single refcount on the folio and hold its lock.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:143: ./mm/vmscan.chMhjubj)}(hhh](j)}(h5``struct address_space *mapping`` The address space. h](j)}(h!``struct address_space *mapping``h]jS)}(hjh]hstruct address_space *mapping}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:143: ./mm/vmscan.chM|hjubj)}(hhh]jM)}(hThe address space.h]hThe address space.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM|hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM|hjubj)}(h-``struct folio *folio`` The folio to remove. h](j)}(h``struct folio *folio``h]jS)}(hj7h]hstruct folio *folio}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj5ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:143: ./mm/vmscan.chM}hj1ubj)}(hhh]jM)}(hThe folio to remove.h]hThe folio to remove.}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjLhM}hjMubah}(h]h ]h"]h$]h&]uh1jhj1ubeh}(h]h ]h"]h$]h&]uh1jhjLhM}hjubj)}(h``struct mem_cgroup *target_memcg`` The memcg to charge the eviction shadow to; the caller must keep it alive across the call. h](j)}(h#``struct mem_cgroup *target_memcg``h]jS)}(hjph]hstruct mem_cgroup *target_memcg}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjnubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:143: ./mm/vmscan.chMhjjubj)}(hhh]jM)}(hZThe memcg to charge the eviction shadow to; the caller must keep it alive across the call.h]hZThe memcg to charge the eviction shadow to; the caller must keep it alive across the call.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:143: ./mm/vmscan.chM~hjubah}(h]h ]h"]h$]h&]uh1jhjjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:143: ./mm/vmscan.chMhjubjM)}(hLike remove_mapping(), but stores a workingset eviction shadow the way page reclaim does, so that a later refault can be detected and the folio re-activated.h]hLike remove_mapping(), but stores a workingset eviction shadow the way page reclaim does, so that a later refault can be detected and the folio re-activated.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:143: ./mm/vmscan.chMhjubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:143: ./mm/vmscan.chMhjubjM)}(hSThe number of pages removed from the mapping. 0 if the folio could not be removed.h]hSThe number of pages removed from the mapping. 0 if the folio could not be removed.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:143: ./mm/vmscan.chMhjubjM)}(h **Context**h]j)}(hjh]hContext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:143: ./mm/vmscan.chMhjubjM)}(hHThe caller should have a single refcount on the folio and hold its lock.h]hHThe caller should have a single refcount on the folio and hold its lock.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:143: ./mm/vmscan.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfolio_putback_lru (C function)c.folio_putback_lruhNtauh1hhjKhhhNhNubh)}(hhh](h)}(h,void folio_putback_lru (struct folio *folio)h]h)}(h+void folio_putback_lru(struct folio *folio)h](j)}(hvoidh]hvoid}(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;hhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:143: ./mm/vmscan.chMubj)}(h h]h }(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;hhhjMhMubh)}(hfolio_putback_lruh]j)}(hfolio_putback_lruh]hfolio_putback_lru}(hj`hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj;hhhjMhMubj8)}(h(struct folio *folio)h]j>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hj|hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjxubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjxubh)}(hhh]j)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjbsbc.folio_putback_lruasbuh1hhjxubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjxubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjxubj)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjxubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjtubah}(h]h ]h"]h$]h&]jjuh1j7hj;hhhjMhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj7hhhjMhMubah}(h]j2ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjMhMhj4hhubj4)}(hhh]jM)}(h8Put previously isolated folio onto appropriate LRU list.h]h8Put previously isolated folio onto appropriate LRU list.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:143: ./mm/vmscan.chMhjhhubah}(h]h ]h"]h$]h&]uh1j3hj4hhhjMhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct folio *folio`` Folio to be returned to an LRU list. **Description** Add previously isolated **folio** to appropriate LRU list. The folio may still be unevictable for other reasons. **Context** lru_lock must not be held, interrupts must be enabled.h](jM)}(h**Parameters**h]j)}(hj!h]h Parameters}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:143: ./mm/vmscan.chMhjubj)}(hhh]j)}(h=``struct folio *folio`` Folio to be returned to an LRU list. h](j)}(h``struct folio *folio``h]jS)}(hj@h]hstruct folio *folio}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj>ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:143: ./mm/vmscan.chMhj:ubj)}(hhh]jM)}(h$Folio to be returned to an LRU list.h]h$Folio to be returned to an LRU list.}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjUhMhjVubah}(h]h ]h"]h$]h&]uh1jhj:ubeh}(h]h ]h"]h$]h&]uh1jhjUhMhj7ubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hj{h]h Description}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjyubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:143: ./mm/vmscan.chMhjubjM)}(hpAdd previously isolated **folio** to appropriate LRU list. The folio may still be unevictable for other reasons.h](hAdd previously isolated }(hjhhhNhNubj)}(h **folio**h]hfolio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhO to appropriate LRU list. The folio may still be unevictable for other reasons.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:143: ./mm/vmscan.chMhjubjM)}(h **Context**h]j)}(hjh]hContext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:143: ./mm/vmscan.chMhjubjM)}(h6lru_lock must not be held, interrupts must be enabled.h]h6lru_lock must not be held, interrupts must be enabled.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:143: ./mm/vmscan.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfolio_isolate_lru (C function)c.folio_isolate_lruhNtauh1hhjKhhhNhNubh)}(hhh](h)}(h,bool folio_isolate_lru (struct folio *folio)h]h)}(h+bool folio_isolate_lru(struct folio *folio)h](j)}(hjh]hbool}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:143: ./mm/vmscan.chMZubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMZubh)}(hfolio_isolate_lruh]j)}(hfolio_isolate_lruh]hfolio_isolate_lru}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMZubj8)}(h(struct folio *folio)h]j>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj1ubj)}(h h]h }(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj1ubh)}(hhh]j)}(hfolioh]hfolio}(hjShhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjPubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjUmodnameN classnameNjj)}j]j)}jjsbc.folio_isolate_lruasbuh1hhj1ubj)}(h h]h }(hjshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj1ubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj1ubj)}(hfolioh]hfolio}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj1ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj-ubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMZubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMZubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMZhjhhubj4)}(hhh]jM)}(h)Try to isolate a folio from its LRU list.h]h)Try to isolate a folio from its LRU list.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:143: ./mm/vmscan.chMZhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMZubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hXR**Parameters** ``struct folio *folio`` Folio to isolate from its LRU list. **Description** Isolate a **folio** from an LRU list and adjust the vmstat statistic corresponding to whatever LRU list the folio was on. The folio will have its LRU flag cleared. If it was found on the active list, it will have the Active flag set. If it was found on the unevictable list, it will have the Unevictable flag set. These flags may need to be cleared by the caller before letting the page go. (1) Must be called with an elevated refcount on the folio. This is a fundamental difference from isolate_lru_folios() (which is called without a stable reference). (2) The lru_lock must not be held. (3) Interrupts must be enabled. **Context** **Return** true if the folio was removed from an LRU list. false if the folio was not on an LRU list.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:143: ./mm/vmscan.chM^hjubj)}(hhh]j)}(h<``struct folio *folio`` Folio to isolate from its LRU list. h](j)}(h``struct folio *folio``h]jS)}(hjh]hstruct folio *folio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:143: ./mm/vmscan.chM[hjubj)}(hhh]jM)}(h#Folio to isolate from its LRU list.h]h#Folio to isolate from its LRU list.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM[hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM[hjubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hj4h]h Description}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj2ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:143: ./mm/vmscan.chM]hjubjM)}(hyIsolate a **folio** from an LRU list and adjust the vmstat statistic corresponding to whatever LRU list the folio was on.h](h Isolate a }(hjJhhhNhNubj)}(h **folio**h]hfolio}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjJubhf from an LRU list and adjust the vmstat statistic corresponding to whatever LRU list the folio was on.}(hjJhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:143: ./mm/vmscan.chM\hjubjM)}(hXThe folio will have its LRU flag cleared. If it was found on the active list, it will have the Active flag set. If it was found on the unevictable list, it will have the Unevictable flag set. These flags may need to be cleared by the caller before letting the page go.h]hXThe folio will have its LRU flag cleared. If it was found on the active list, it will have the Active flag set. If it was found on the unevictable list, it will have the Unevictable flag set. These flags may need to be cleared by the caller before letting the page go.}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:143: ./mm/vmscan.chM_hjubjM)}(hhh](jc)}(hMust be called with an elevated refcount on the folio. This is a fundamental difference from isolate_lru_folios() (which is called without a stable reference).h]jM)}(hMust be called with an elevated refcount on the folio. This is a fundamental difference from isolate_lru_folios() (which is called without a stable reference).h]hMust be called with an elevated refcount on the folio. This is a fundamental difference from isolate_lru_folios() (which is called without a stable reference).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:143: ./mm/vmscan.chMehj}ubah}(h]h ]h"]h$]h&]uh1jbhjzubjc)}(hThe lru_lock must not be held.h]jM)}(hjh]hThe lru_lock must not be held.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:143: ./mm/vmscan.chMhhjubah}(h]h ]h"]h$]h&]uh1jbhjzubjc)}(hInterrupts must be enabled. h]jM)}(hInterrupts must be enabled.h]hInterrupts must be enabled.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:143: ./mm/vmscan.chMihjubah}(h]h ]h"]h$]h&]uh1jbhjzubeh}(h]h ]h"]h$]h&]j?Nj@NjANj?jBNj?uh1jMhjubjM)}(h **Context**h]j)}(hjh]hContext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:143: ./mm/vmscan.chMkhjubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:143: ./mm/vmscan.chMghjubjM)}(hZtrue if the folio was removed from an LRU list. false if the folio was not on an LRU list.h]hZtrue if the folio was removed from an LRU list. false if the folio was not on an LRU list.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:143: ./mm/vmscan.chMmhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h*check_move_unevictable_folios (C function)c.check_move_unevictable_folioshNtauh1hhjKhhhNhNubh)}(hhh](h)}(h?void check_move_unevictable_folios (struct folio_batch *fbatch)h]h)}(h>void check_move_unevictable_folios(struct folio_batch *fbatch)h](j)}(hvoidh]hvoid}(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(hhhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:143: ./mm/vmscan.chM ubj)}(h h]h }(hj;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(hhhj:hM ubh)}(hcheck_move_unevictable_foliosh]j)}(hcheck_move_unevictable_foliosh]hcheck_move_unevictable_folios}(hjMhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIubah}(h]h ](jjeh"]h$]h&]jjuh1hhj(hhhj:hM ubj8)}(h(struct folio_batch *fbatch)h]j>)}(hstruct folio_batch *fbatchh](j)}(hjJ,h]hstruct}(hjihhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubj)}(h h]h }(hjvhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubh)}(hhh]j)}(h folio_batchh]h folio_batch}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjOsbc.check_move_unevictable_foliosasbuh1hhjeubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjeubj)}(hfbatchh]hfbatch}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjaubah}(h]h ]h"]h$]h&]jjuh1j7hj(hhhj:hM ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj$hhhj:hM ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj:hM hj!hhubj4)}(hhh]jM)}(h2Move evictable folios to appropriate zone lru listh]h2Move evictable folios to appropriate zone lru list}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:143: ./mm/vmscan.chM hjhhubah}(h]h ]h"]h$]h&]uh1j3hj!hhhj:hM ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct folio_batch *fbatch`` Batch of lru folios to check. **Description** Checks folios for evictability, if an evictable folio is in the unevictable lru list, moves it to the appropriate evictable lru list. This function should be only used for lru folios.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:143: ./mm/vmscan.chM hjubj)}(hhh]j)}(h=``struct folio_batch *fbatch`` Batch of lru folios to check. h](j)}(h``struct folio_batch *fbatch``h]jS)}(hj-h]hstruct folio_batch *fbatch}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj+ubah}(h]h ]h"]h$]h&]uh1jhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:143: ./mm/vmscan.chM hj'ubj)}(hhh]jM)}(hBatch of lru folios to check.h]hBatch of lru folios to check.}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjBhM hjCubah}(h]h ]h"]h$]h&]uh1jhj'ubeh}(h]h ]h"]h$]h&]uh1jhjBhM hj$ubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjhh]h Description}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjfubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:143: ./mm/vmscan.chM hjubjM)}(hChecks folios for evictability, if an evictable folio is in the unevictable lru list, moves it to the appropriate evictable lru list. This function should be only used for lru folios.h]hChecks folios for evictability, if an evictable folio is in the unevictable lru list, moves it to the appropriate evictable lru list. This function should be only used for lru folios.}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhL/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:143: ./mm/vmscan.chM hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h__remove_pages (C function)c.__remove_pageshNtauh1hhjKhhhNhNubh)}(hhh](h)}(hvvoid __remove_pages (unsigned long pfn, unsigned long nr_pages, struct vmem_altmap *altmap, struct dev_pagemap *pgmap)h]h)}(huvoid __remove_pages(unsigned long pfn, unsigned long nr_pages, struct vmem_altmap *altmap, struct dev_pagemap *pgmap)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:144: ./mm/memory_hotplug.chM3ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM3ubh)}(h__remove_pagesh]j)}(h__remove_pagesh]h__remove_pages}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhM3ubj8)}(hb(unsigned long pfn, unsigned long nr_pages, struct vmem_altmap *altmap, struct dev_pagemap *pgmap)h](j>)}(hunsigned long pfnh](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hpfnh]hpfn}(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hunsigned long nr_pagesh](j)}(hunsignedh]hunsigned}(hj;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7ubj)}(h h]h }(hjIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7ubj)}(hlongh]hlong}(hjWhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7ubj)}(h h]h }(hjehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7ubj)}(hnr_pagesh]hnr_pages}(hjshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hstruct vmem_altmap *altmaph](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(h vmem_altmaph]h vmem_altmap}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsbc.__remove_pagesasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(haltmaph]haltmap}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hstruct dev_pagemap *pgmaph](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(h dev_pagemaph]h dev_pagemap}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.__remove_pagesasbuh1hhjubj)}(h h]h }(hj:hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjHhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hpgmaph]hpgmap}(hjUhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhM3ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhM3ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhM3hjhhubj4)}(hhh]jM)}(hremove sections of pagesh]hremove sections of pages}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:144: ./mm/memory_hotplug.chM3hj|hhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhM3ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hXj**Parameters** ``unsigned long pfn`` starting pageframe (must be aligned to start of a section) ``unsigned long nr_pages`` number of pages to remove (must be multiple of section size) ``struct vmem_altmap *altmap`` alternative device page map or ``NULL`` if default memmap is used ``struct dev_pagemap *pgmap`` device page map or ``NULL`` if not ZONE_DEVICE **Description** Generic helper function to remove section mappings and sysfs entries for the section of the memory we are removing. Caller needs to make sure that pages are marked reserved and zones are adjust properly by calling offline_pages().h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:144: ./mm/memory_hotplug.chM7hjubj)}(hhh](j)}(hQ``unsigned long pfn`` starting pageframe (must be aligned to start of a section) h](j)}(h``unsigned long pfn``h]jS)}(hjh]hunsigned long pfn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:144: ./mm/memory_hotplug.chM4hjubj)}(hhh]jM)}(h:starting pageframe (must be aligned to start of a section)h]h:starting pageframe (must be aligned to start of a section)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM4hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM4hjubj)}(hX``unsigned long nr_pages`` number of pages to remove (must be multiple of section size) h](j)}(h``unsigned long nr_pages``h]jS)}(hjh]hunsigned long nr_pages}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:144: ./mm/memory_hotplug.chM5hjubj)}(hhh]jM)}(h)}(hint nidh](j)}(hinth]hint}(hjLhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHubj)}(h h]h }(hjZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHubj)}(hnidh]hnid}(hjhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjDubj>)}(h u64 starth](h)}(hhh]j)}(hu64h]hu64}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jj2sbc.__add_memory_driver_managedasbuh1hhj}ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj}ubj)}(hstarth]hstart}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj}ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjDubj>)}(hu64 sizeh](h)}(hhh]j)}(hu64h]hu64}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.__add_memory_driver_managedasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hsizeh]hsize}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjDubj>)}(hconst char *resource_nameh](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hcharh]hchar}(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj<hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjJhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(h resource_nameh]h resource_name}(hjWhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjDubj>)}(hmhp_t mhp_flagsh](h)}(hhh]j)}(hmhp_th]hmhp_t}(hjshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjumodnameN classnameNjj)}j]jc.__add_memory_driver_managedasbuh1hhjlubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjlubj)}(h mhp_flagsh]h mhp_flags}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjlubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjDubj>)}(henum mmop online_typeh](j)}(hj#!h]henum}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hmmoph]hmmop}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.__add_memory_driver_managedasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h online_typeh]h online_type}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjDubeh}(h]h ]h"]h$]h&]jjuh1j7hj hhhjhMZubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMZubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMZhjhhubj4)}(hhh]jM)}(h3add driver-managed memory with explicit online_typeh]h3add driver-managed memory with explicit online_type}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:144: ./mm/memory_hotplug.chMZhj)hhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMZubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjDjHjDjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``int nid`` NUMA node ID where the memory will be added ``u64 start`` Start physical address of the memory range ``u64 size`` Size of the memory range in bytes ``const char *resource_name`` Resource name in format "System RAM ($DRIVER)" ``mhp_t mhp_flags`` Memory hotplug flags ``enum mmop online_type`` Auto-Online behavior (offline, online, kernel, movable) **Description** Add special, driver-managed memory to the system as system RAM. Such memory is not exposed via the raw firmware-provided memmap as system RAM, instead, it is detected and added by a driver - during cold boot, after a reboot, and after kexec. Reasons why this memory should not be used for the initial memmap of a kexec kernel or for placing kexec images: - The booting kernel is in charge of determining how this memory will be used (e.g., use persistent memory as system RAM) - Coordination with a hypervisor is required before this memory can be used (e.g., inaccessible parts). For this memory, no entries in /sys/firmware/memmap ("raw firmware-provided memory map") are created. Also, the created memory resource is flagged with IORESOURCE_SYSRAM_DRIVER_MANAGED, so in-kernel users can special-case this memory as well (esp., not place kexec images onto it). The resource_name (visible via /proc/iomem) has to have the format "System RAM ($DRIVER)". **Return** 0 on success, negative error code on failure.h](jM)}(h**Parameters**h]j)}(hjNh]h Parameters}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjLubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:144: ./mm/memory_hotplug.chM^hjHubj)}(hhh](j)}(h8``int nid`` NUMA node ID where the memory will be added h](j)}(h ``int nid``h]jS)}(hjmh]hint nid}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjkubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:144: ./mm/memory_hotplug.chM[hjgubj)}(hhh]jM)}(h+NUMA node ID where the memory will be addedh]h+NUMA node ID where the memory will be added}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM[hjubah}(h]h ]h"]h$]h&]uh1jhjgubeh}(h]h ]h"]h$]h&]uh1jhjhM[hjdubj)}(h9``u64 start`` Start physical address of the memory range h](j)}(h ``u64 start``h]jS)}(hjh]h u64 start}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:144: ./mm/memory_hotplug.chM\hjubj)}(hhh]jM)}(h*Start physical address of the memory rangeh]h*Start physical address of the memory range}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM\hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM\hjdubj)}(h/``u64 size`` Size of the memory range in bytes h](j)}(h ``u64 size``h]jS)}(hjh]hu64 size}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:144: ./mm/memory_hotplug.chM]hjubj)}(hhh]jM)}(h!Size of the memory range in bytesh]h!Size of the memory range in bytes}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM]hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM]hjdubj)}(hM``const char *resource_name`` Resource name in format "System RAM ($DRIVER)" h](j)}(h``const char *resource_name``h]jS)}(hjh]hconst char *resource_name}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:144: ./mm/memory_hotplug.chM^hjubj)}(hhh]jM)}(h.Resource name in format "System RAM ($DRIVER)"h]h2Resource name in format “System RAM ($DRIVER)”}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj-hM^hj.ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj-hM^hjdubj)}(h)``mhp_t mhp_flags`` Memory hotplug flags h](j)}(h``mhp_t mhp_flags``h]jS)}(hjQh]hmhp_t mhp_flags}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjOubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:144: ./mm/memory_hotplug.chM_hjKubj)}(hhh]jM)}(hMemory hotplug flagsh]hMemory hotplug flags}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjfhM_hjgubah}(h]h ]h"]h$]h&]uh1jhjKubeh}(h]h ]h"]h$]h&]uh1jhjfhM_hjdubj)}(hR``enum mmop online_type`` Auto-Online behavior (offline, online, kernel, movable) h](j)}(h``enum mmop online_type``h]jS)}(hjh]henum mmop online_type}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:144: ./mm/memory_hotplug.chM`hjubj)}(hhh]jM)}(h7Auto-Online behavior (offline, online, kernel, movable)h]h7Auto-Online behavior (offline, online, kernel, movable)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM`hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM`hjdubeh}(h]h ]h"]h$]h&]uh1jhjHubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:144: ./mm/memory_hotplug.chMbhjHubjM)}(hAdd special, driver-managed memory to the system as system RAM. Such memory is not exposed via the raw firmware-provided memmap as system RAM, instead, it is detected and added by a driver - during cold boot, after a reboot, and after kexec.h]hAdd special, driver-managed memory to the system as system RAM. Such memory is not exposed via the raw firmware-provided memmap as system RAM, instead, it is detected and added by a driver - during cold boot, after a reboot, and after kexec.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:144: ./mm/memory_hotplug.chMahjHubjM)}(hpReasons why this memory should not be used for the initial memmap of a kexec kernel or for placing kexec images:h]hpReasons why this memory should not be used for the initial memmap of a kexec kernel or for placing kexec images:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:144: ./mm/memory_hotplug.chMfhjHubj^)}(hhh](jc)}(hwThe booting kernel is in charge of determining how this memory will be used (e.g., use persistent memory as system RAM)h]jM)}(hwThe booting kernel is in charge of determining how this memory will be used (e.g., use persistent memory as system RAM)h]hwThe booting kernel is in charge of determining how this memory will be used (e.g., use persistent memory as system RAM)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:144: ./mm/memory_hotplug.chMihjubah}(h]h ]h"]h$]h&]uh1jbhjubjc)}(hfCoordination with a hypervisor is required before this memory can be used (e.g., inaccessible parts). h]jM)}(heCoordination with a hypervisor is required before this memory can be used (e.g., inaccessible parts).h]heCoordination with a hypervisor is required before this memory can be used (e.g., inaccessible parts).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:144: ./mm/memory_hotplug.chMkhjubah}(h]h ]h"]h$]h&]uh1jbhjubeh}(h]h ]h"]h$]h&]jjuh1j]hjhMihjHubjM)}(hXFor this memory, no entries in /sys/firmware/memmap ("raw firmware-provided memory map") are created. Also, the created memory resource is flagged with IORESOURCE_SYSRAM_DRIVER_MANAGED, so in-kernel users can special-case this memory as well (esp., not place kexec images onto it).h]hXFor this memory, no entries in /sys/firmware/memmap (“raw firmware-provided memory map”) are created. Also, the created memory resource is flagged with IORESOURCE_SYSRAM_DRIVER_MANAGED, so in-kernel users can special-case this memory as well (esp., not place kexec images onto it).}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:144: ./mm/memory_hotplug.chMnhjHubjM)}(hZThe resource_name (visible via /proc/iomem) has to have the format "System RAM ($DRIVER)".h]h^The resource_name (visible via /proc/iomem) has to have the format “System RAM ($DRIVER)”.}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:144: ./mm/memory_hotplug.chMshjHubjM)}(h **Return**h]j)}(hjTh]hReturn}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjRubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:144: ./mm/memory_hotplug.chMvhjHubjM)}(h-0 on success, negative error code on failure.h]h-0 on success, negative error code on failure.}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:144: ./mm/memory_hotplug.chMwhjHubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h&add_memory_driver_managed (C function)c.add_memory_driver_managedhNtauh1hhjKhhhNhNubh)}(hhh](h)}(hhint add_memory_driver_managed (int nid, u64 start, u64 size, const char *resource_name, mhp_t mhp_flags)h]h)}(hgint add_memory_driver_managed(int nid, u64 start, u64 size, const char *resource_name, mhp_t mhp_flags)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:144: ./mm/memory_hotplug.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh)}(hadd_memory_driver_managedh]j)}(hadd_memory_driver_managedh]hadd_memory_driver_managed}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMubj8)}(hJ(int nid, u64 start, u64 size, const char *resource_name, mhp_t mhp_flags)h](j>)}(hint nidh](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hnidh]hnid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(h u64 starth](h)}(hhh]j)}(hu64h]hu64}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsbc.add_memory_driver_managedasbuh1hhjubj)}(h h]h }(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hstarth]hstart}(hj<hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hu64 sizeh](h)}(hhh]j)}(hu64h]hu64}(hjXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjUubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjZmodnameN classnameNjj)}j]j*c.add_memory_driver_managedasbuh1hhjQubj)}(h h]h }(hjvhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjQubj)}(hsizeh]hsize}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjQubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hconst char *resource_nameh](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hcharh]hchar}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(h resource_nameh]h resource_name}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hmhp_t mhp_flagsh](h)}(hhh]j)}(hmhp_th]hmhp_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j*c.add_memory_driver_managedasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h mhp_flagsh]h mhp_flags}(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]jM)}(hadd driver-managed memoryh]hadd driver-managed memory}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:144: ./mm/memory_hotplug.chMhjPhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjkjHjkjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``int nid`` NUMA node ID where the memory will be added ``u64 start`` Start physical address of the memory range ``u64 size`` Size of the memory range in bytes ``const char *resource_name`` Resource name in format "System RAM ($DRIVER)" ``mhp_t mhp_flags`` Memory hotplug flags **Description** Add driver-managed memory with the system default online type set by build config or kernel boot parameter. See __add_memory_driver_managed for more details. **Return** 0 on success, negative error code on failure.h](jM)}(h**Parameters**h]j)}(hjuh]h Parameters}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjsubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:144: ./mm/memory_hotplug.chMhjoubj)}(hhh](j)}(h8``int nid`` NUMA node ID where the memory will be added h](j)}(h ``int nid``h]jS)}(hjh]hint nid}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:144: ./mm/memory_hotplug.chMhjubj)}(hhh]jM)}(h+NUMA node ID where the memory will be addedh]h+NUMA node ID where the memory will be added}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h9``u64 start`` Start physical address of the memory range h](j)}(h ``u64 start``h]jS)}(hjh]h u64 start}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:144: ./mm/memory_hotplug.chMhjubj)}(hhh]jM)}(h*Start physical address of the memory rangeh]h*Start physical address of the memory range}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h/``u64 size`` Size of the memory range in bytes h](j)}(h ``u64 size``h]jS)}(hjh]hu64 size}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:144: ./mm/memory_hotplug.chMhjubj)}(hhh]jM)}(h!Size of the memory range in bytesh]h!Size of the memory range in bytes}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(hM``const char *resource_name`` Resource name in format "System RAM ($DRIVER)" h](j)}(h``const char *resource_name``h]jS)}(hj?h]hconst char *resource_name}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj=ubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:144: ./mm/memory_hotplug.chMhj9ubj)}(hhh]jM)}(h.Resource name in format "System RAM ($DRIVER)"h]h2Resource name in format “System RAM ($DRIVER)”}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjThMhjUubah}(h]h ]h"]h$]h&]uh1jhj9ubeh}(h]h ]h"]h$]h&]uh1jhjThMhjubj)}(h)``mhp_t mhp_flags`` Memory hotplug flags h](j)}(h``mhp_t mhp_flags``h]jS)}(hjxh]hmhp_t mhp_flags}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjvubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:144: ./mm/memory_hotplug.chMhjrubj)}(hhh]jM)}(hMemory hotplug flagsh]hMemory hotplug flags}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjrubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubeh}(h]h ]h"]h$]h&]uh1jhjoubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:144: ./mm/memory_hotplug.chMhjoubjM)}(hkAdd driver-managed memory with the system default online type set by build config or kernel boot parameter.h]hkAdd driver-managed memory with the system default online type set by build config or kernel boot parameter.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:144: ./mm/memory_hotplug.chMhjoubjM)}(h1See __add_memory_driver_managed for more details.h]h1See __add_memory_driver_managed for more details.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:144: ./mm/memory_hotplug.chMhjoubjM)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:144: ./mm/memory_hotplug.chMhjoubjM)}(h-0 on success, negative error code on failure.h]h-0 on success, negative error code on failure.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:144: ./mm/memory_hotplug.chMhjoubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](htry_offline_node (C function)c.try_offline_nodehNtauh1hhjKhhhNhNubh)}(hhh](h)}(hvoid try_offline_node (int nid)h]h)}(hvoid try_offline_node(int nid)h](j)}(hvoidh]hvoid}(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*hhhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:144: ./mm/memory_hotplug.chMubj)}(h h]h }(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*hhhj<hMubh)}(htry_offline_nodeh]j)}(htry_offline_nodeh]htry_offline_node}(hjOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjKubah}(h]h ](jjeh"]h$]h&]jjuh1hhj*hhhj<hMubj8)}(h (int nid)h]j>)}(hint nidh](j)}(hinth]hint}(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubj)}(h h]h }(hjyhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubj)}(hnidh]hnid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjcubah}(h]h ]h"]h$]h&]jjuh1j7hj*hhhj<hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj&hhhj<hMubah}(h]j!ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj<hMhj#hhubj4)}(hhh]h}(h]h ]h"]h$]h&]uh1j3hj#hhhj<hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``int nid`` the node ID **Description** Offline a node if all memory sections and cpus of the node are removed. **NOTE** The caller must call lock_device_hotplug() to serialize hotplug and online/offline operations before this call.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:144: ./mm/memory_hotplug.chMhjubj)}(hhh]j)}(h``int nid`` the node ID h](j)}(h ``int nid``h]jS)}(hjh]hint nid}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:144: ./mm/memory_hotplug.chMhjubj)}(hhh]jM)}(h the node IDh]h the node ID}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:144: ./mm/memory_hotplug.chMhjubjM)}(hGOffline a node if all memory sections and cpus of the node are removed.h]hGOffline a node if all memory sections and cpus of the node are removed.}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:144: ./mm/memory_hotplug.chMhjubjM)}(h**NOTE**h]j)}(hjEh]hNOTE}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjCubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:144: ./mm/memory_hotplug.chMhjubjM)}(hoThe caller must call lock_device_hotplug() to serialize hotplug and online/offline operations before this call.h]hoThe caller must call lock_device_hotplug() to serialize hotplug and online/offline operations before this call.}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:144: ./mm/memory_hotplug.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h__remove_memory (C function)c.__remove_memoryhNtauh1hhjKhhhNhNubh)}(hhh](h)}(h*void __remove_memory (u64 start, u64 size)h]h)}(h)void __remove_memory(u64 start, u64 size)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:144: ./mm/memory_hotplug.chM ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM ubh)}(h__remove_memoryh]j)}(h__remove_memoryh]h__remove_memory}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhM ubj8)}(h(u64 start, u64 size)h](j>)}(h u64 starth](h)}(hhh]j)}(hu64h]hu64}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsbc.__remove_memoryasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hstarth]hstart}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hu64 sizeh](h)}(hhh]j)}(hu64h]hu64}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.__remove_memoryasbuh1hhj ubj)}(h h]h }(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(hsizeh]hsize}(hj@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhM ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhM ubah}(h]j}ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhM hjhhubj4)}(hhh]jM)}(h.Remove memory if every memory block is offlineh]h.Remove memory if every memory block is offline}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:144: ./mm/memory_hotplug.chM hjghhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhM ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``u64 start`` physical address of the region to remove ``u64 size`` size of the region to remove **NOTE** The caller must call lock_device_hotplug() to serialize hotplug and online/offline operations before this call, as required by try_offline_node().h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:144: ./mm/memory_hotplug.chM hjubj)}(hhh](j)}(h7``u64 start`` physical address of the region to remove h](j)}(h ``u64 start``h]jS)}(hjh]h u64 start}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:144: ./mm/memory_hotplug.chM hjubj)}(hhh]jM)}(h(physical address of the region to removeh]h(physical address of the region to remove}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hjubj)}(h*``u64 size`` size of the region to remove h](j)}(h ``u64 size``h]jS)}(hjh]hu64 size}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:144: ./mm/memory_hotplug.chM hjubj)}(hhh]jM)}(hsize of the region to removeh]hsize of the region to remove}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**NOTE**h]j)}(hj h]hNOTE}(hj! hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:144: ./mm/memory_hotplug.chM hjubjM)}(hThe caller must call lock_device_hotplug() to serialize hotplug and online/offline operations before this call, as required by try_offline_node().h]hThe caller must call lock_device_hotplug() to serialize hotplug and online/offline operations before this call, as required by try_offline_node().}(hj5 hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:144: ./mm/memory_hotplug.chM hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h-offline_and_remove_memory_ranges (C function)"c.offline_and_remove_memory_rangeshNtauh1hhjKhhhNhNubh)}(hhh](h)}(hYint offline_and_remove_memory_ranges (const struct range *ranges, unsigned int nr_ranges)h]h)}(hXint offline_and_remove_memory_ranges(const struct range *ranges, unsigned int nr_ranges)h](j)}(hinth]hint}(hjd hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj` hhhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:144: ./mm/memory_hotplug.chM~ ubj)}(h h]h }(hjs hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj` hhhjr hM~ ubh)}(h offline_and_remove_memory_rangesh]j)}(h offline_and_remove_memory_rangesh]h offline_and_remove_memory_ranges}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj` hhhjr hM~ ubj8)}(h4(const struct range *ranges, unsigned int nr_ranges)h](j>)}(hconst struct range *rangesh](j)}(hjh]hconst}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(hjJ,h]hstruct}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubh)}(hhh]j)}(hrangeh]hrange}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj modnameN classnameNjj)}j]j)}jj sb"c.offline_and_remove_memory_rangesasbuh1hhj ubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubjr)}(hjuh]h*}(hj hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj ubj)}(hrangesh]hranges}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj ubj>)}(hunsigned int nr_rangesh](j)}(hunsignedh]hunsigned}(hj. hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj* ubj)}(h h]h }(hj< hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj* ubj)}(hinth]hint}(hjJ hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj* ubj)}(h h]h }(hjX hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj* ubj)}(h nr_rangesh]h nr_ranges}(hjf hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj* ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj ubeh}(h]h ]h"]h$]h&]jjuh1j7hj` hhhjr hM~ ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj\ hhhjr hM~ ubah}(h]jW ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjr hM~ hjY hhubj4)}(hhh]jM)}(h)offline and remove multiple memory rangesh]h)offline and remove multiple memory ranges}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:144: ./mm/memory_hotplug.chM~ hj hhubah}(h]h ]h"]h$]h&]uh1j3hjY hhhjr hM~ ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj jHj jIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``const struct range *ranges`` array of physical address ranges to offline and remove ``unsigned int nr_ranges`` number of entries in **ranges** **Description** Offline and remove several memory ranges as one operation, serialized against other hotplug operations by a single lock_device_hotplug(). This offlines all ranges before removing any of them. If offlining any range fails, the entire process is reverted and nothing is removed. This provides a fully atomic semantic for unplugging an entire device. Each range must be memory-block aligned in start and size. **Return** 0 on success, negative errno on failure (never positive). On failure no range has been removed.h](jM)}(h**Parameters**h]j)}(hj h]h Parameters}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:144: ./mm/memory_hotplug.chM hj ubj)}(hhh](j)}(hV``const struct range *ranges`` array of physical address ranges to offline and remove h](j)}(h``const struct range *ranges``h]jS)}(hj h]hconst struct range *ranges}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj ubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:144: ./mm/memory_hotplug.chM hj ubj)}(hhh]jM)}(h6array of physical address ranges to offline and removeh]h6array of physical address ranges to offline and remove}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj hM hj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hM hj ubj)}(h;``unsigned int nr_ranges`` number of entries in **ranges** h](j)}(h``unsigned int nr_ranges``h]jS)}(hj h]hunsigned int nr_ranges}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj ubah}(h]h ]h"]h$]h&]uh1jhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:144: ./mm/memory_hotplug.chM hj ubj)}(hhh]jM)}(hnumber of entries in **ranges**h](hnumber of entries in }(hj# hhhNhNubj)}(h **ranges**h]hranges}(hj+ hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj# ubeh}(h]h ]h"]h$]h&]uh1jLhj 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 ubjM)}(h**Description**h]j)}(hjS h]h Description}(hjU hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjQ ubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:144: ./mm/memory_hotplug.chM hj ubjM)}(hOffline and remove several memory ranges as one operation, serialized against other hotplug operations by a single lock_device_hotplug().h]hOffline and remove several memory ranges as one operation, serialized against other hotplug operations by a single lock_device_hotplug().}(hji hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:144: ./mm/memory_hotplug.chM hj ubjM)}(hThis offlines all ranges before removing any of them. If offlining any range fails, the entire process is reverted and nothing is removed. This provides a fully atomic semantic for unplugging an entire device.h]hThis offlines all ranges before removing any of them. If offlining any range fails, the entire process is reverted and nothing is removed. This provides a fully atomic semantic for unplugging an entire device.}(hjx hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:144: ./mm/memory_hotplug.chM hj ubjM)}(h:Each range must be memory-block aligned in start and size.h]h:Each range must be memory-block aligned in start and size.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:144: ./mm/memory_hotplug.chM hj ubjM)}(h **Return**h]j)}(hj h]hReturn}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:144: ./mm/memory_hotplug.chM hj ubjM)}(h`0 on success, negative errno on failure (never positive). On failure no range has been removed.h]h`0 on success, negative errno on failure (never positive). On failure no range has been removed.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhT/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:144: ./mm/memory_hotplug.chM hj ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h$mmu_interval_read_begin (C function)c.mmu_interval_read_beginhNtauh1hhjKhhhNhNubh)}(hhh](h)}(hRunsigned long mmu_interval_read_begin (struct mmu_interval_notifier *interval_sub)h]h)}(hQunsigned long mmu_interval_read_begin(struct mmu_interval_notifier *interval_sub)h](j)}(hunsignedh]hunsigned}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhR/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:145: ./mm/mmu_notifier.chKubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhj hKubj)}(hlongh]hlong}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhj hKubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhj hKubh)}(hmmu_interval_read_beginh]j)}(hmmu_interval_read_beginh]hmmu_interval_read_begin}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj hhhj hKubj8)}(h,(struct mmu_interval_notifier *interval_sub)h]j>)}(h*struct mmu_interval_notifier *interval_subh](j)}(hjJ,h]hstruct}(hj6 hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2 ubj)}(h h]h }(hjC hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2 ubh)}(hhh]j)}(hmmu_interval_notifierh]hmmu_interval_notifier}(hjT hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjQ ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjV modnameN classnameNjj)}j]j)}jj sbc.mmu_interval_read_beginasbuh1hhj2 ubj)}(h h]h }(hjt hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2 ubjr)}(hjuh]h*}(hj hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj2 ubj)}(h interval_subh]h interval_sub}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2 ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj. ubah}(h]h ]h"]h$]h&]jjuh1j7hj hhhj hKubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj hhhj hKubah}(h]j ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj hKhj hhubj4)}(hhh]jM)}(h5Begin a read side critical section against a VA rangeh]h5Begin a read side critical section against a VA range}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhR/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:145: ./mm/mmu_notifier.chKhj hhubah}(h]h ]h"]h$]h&]uh1j3hj hhhj hKubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj jHj jIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct mmu_interval_notifier *interval_sub`` The interval subscription **Description** mmu_iterval_read_begin()/mmu_iterval_read_retry() implement a collision-retry scheme similar to seqcount for the VA range under subscription. If the mm invokes invalidation during the critical section then mmu_interval_read_retry() will return true. This is useful to obtain shadow PTEs where teardown or setup of the SPTEs require a blocking context. The critical region formed by this can sleep, and the required 'user_lock' can also be a sleeping lock. The caller is required to provide a 'user_lock' to serialize both teardown and setup. The return value should be passed to mmu_interval_read_retry().h](jM)}(h**Parameters**h]j)}(hj h]h Parameters}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jLhR/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:145: ./mm/mmu_notifier.chKhj ubj)}(hhh]j)}(hI``struct mmu_interval_notifier *interval_sub`` The interval subscription h](j)}(h.``struct mmu_interval_notifier *interval_sub``h]jS)}(hj h]h*struct mmu_interval_notifier *interval_sub}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj ubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:145: ./mm/mmu_notifier.chKhj ubj)}(hhh]jM)}(hThe interval subscriptionh]hThe interval subscription}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj hKhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hKhj ubah}(h]h ]h"]h$]h&]uh1jhj ubjM)}(h**Description**h]j)}(hj5 h]h Description}(hj7 hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj3 ubah}(h]h ]h"]h$]h&]uh1jLhR/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:145: ./mm/mmu_notifier.chKhj ubjM)}(hmmu_iterval_read_begin()/mmu_iterval_read_retry() implement a collision-retry scheme similar to seqcount for the VA range under subscription. If the mm invokes invalidation during the critical section then mmu_interval_read_retry() will return true.h]hmmu_iterval_read_begin()/mmu_iterval_read_retry() implement a collision-retry scheme similar to seqcount for the VA range under subscription. If the mm invokes invalidation during the critical section then mmu_interval_read_retry() will return true.}(hjK hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhR/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:145: ./mm/mmu_notifier.chKhj ubjM)}(hThis is useful to obtain shadow PTEs where teardown or setup of the SPTEs require a blocking context. The critical region formed by this can sleep, and the required 'user_lock' can also be a sleeping lock.h]hThis is useful to obtain shadow PTEs where teardown or setup of the SPTEs require a blocking context. The critical region formed by this can sleep, and the required ‘user_lock’ can also be a sleeping lock.}(hjZ hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhR/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:145: ./mm/mmu_notifier.chKhj ubjM)}(hUThe caller is required to provide a 'user_lock' to serialize both teardown and setup.h]hYThe caller is required to provide a ‘user_lock’ to serialize both teardown and setup.}(hji hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhR/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:145: ./mm/mmu_notifier.chKhj ubjM)}(h?The return value should be passed to mmu_interval_read_retry().h]h?The return value should be passed to mmu_interval_read_retry().}(hjx hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhR/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:145: ./mm/mmu_notifier.chKhj ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h"mmu_notifier_register (C function)c.mmu_notifier_registerhNtauh1hhjKhhhNhNubh)}(hhh](h)}(hSint mmu_notifier_register (struct mmu_notifier *subscription, struct mm_struct *mm)h]h)}(hRint mmu_notifier_register(struct mmu_notifier *subscription, struct mm_struct *mm)h](j)}(hinth]hint}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhR/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:145: ./mm/mmu_notifier.chMubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhj hMubh)}(hmmu_notifier_registerh]j)}(hmmu_notifier_registerh]hmmu_notifier_register}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj hhhj hMubj8)}(h9(struct mmu_notifier *subscription, struct mm_struct *mm)h](j>)}(h!struct mmu_notifier *subscriptionh](j)}(hjJ,h]hstruct}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubh)}(hhh]j)}(h mmu_notifierh]h mmu_notifier}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jj sbc.mmu_notifier_registerasbuh1hhj ubj)}(h h]h }(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubjr)}(hjuh]h*}(hj0hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj ubj)}(h subscriptionh]h subscription}(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj ubj>)}(hstruct mm_struct *mmh](j)}(hjJ,h]hstruct}(hjVhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRubj)}(h h]h }(hjchhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRubh)}(hhh]j)}(h mm_structh]h mm_struct}(hjthhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjqubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjvmodnameN classnameNjj)}j]jc.mmu_notifier_registerasbuh1hhjRubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjRubj)}(hmmh]hmm}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj ubeh}(h]h ]h"]h$]h&]jjuh1j7hj hhhj hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj hhhj hMubah}(h]j ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj hMhj hhubj4)}(hhh]jM)}(hRegister a notifier on a mmh]hRegister a notifier on a mm}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhR/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:145: ./mm/mmu_notifier.chMhjhhubah}(h]h ]h"]h$]h&]uh1j3hj hhhj hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hX7**Parameters** ``struct mmu_notifier *subscription`` The notifier to attach ``struct mm_struct *mm`` The mm to attach the notifier to **Description** Must not hold mmap_lock nor any other VM related lock when calling this registration function. Must also ensure mm_users can't go down to zero while this runs to avoid races with mmu_notifier_release, so mm has to be current->mm or the mm should be pinned safely such as with get_task_mm(). If the mm is not current->mm, the mm_users pin should be released by calling mmput after mmu_notifier_register returns. mmu_notifier_unregister() or mmu_notifier_put() must be always called to unregister the notifier. While the caller has a mmu_notifier get the subscription->mm pointer will remain valid, and can be converted to an active mm pointer via mmget_not_zero().h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhR/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:145: ./mm/mmu_notifier.chMhjubj)}(hhh](j)}(h=``struct mmu_notifier *subscription`` The notifier to attach h](j)}(h%``struct mmu_notifier *subscription``h]jS)}(hjh]h!struct mmu_notifier *subscription}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:145: ./mm/mmu_notifier.chMhjubj)}(hhh]jM)}(hThe notifier to attachh]hThe notifier to attach}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj-hMhj.ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj-hMhjubj)}(h:``struct mm_struct *mm`` The mm to attach the notifier to h](j)}(h``struct mm_struct *mm``h]jS)}(hjQh]hstruct mm_struct *mm}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjOubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:145: ./mm/mmu_notifier.chMhjKubj)}(hhh]jM)}(h The mm to attach the notifier toh]h The mm to attach the notifier to}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjfhMhjgubah}(h]h ]h"]h$]h&]uh1jhjKubeh}(h]h ]h"]h$]h&]uh1jhjfhMhjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhR/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:145: ./mm/mmu_notifier.chMhjubjM)}(hXMust not hold mmap_lock nor any other VM related lock when calling this registration function. Must also ensure mm_users can't go down to zero while this runs to avoid races with mmu_notifier_release, so mm has to be current->mm or the mm should be pinned safely such as with get_task_mm(). If the mm is not current->mm, the mm_users pin should be released by calling mmput after mmu_notifier_register returns.h]hXMust not hold mmap_lock nor any other VM related lock when calling this registration function. Must also ensure mm_users can’t go down to zero while this runs to avoid races with mmu_notifier_release, so mm has to be current->mm or the mm should be pinned safely such as with get_task_mm(). If the mm is not current->mm, the mm_users pin should be released by calling mmput after mmu_notifier_register returns.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhR/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:145: ./mm/mmu_notifier.chMhjubjM)}(hammu_notifier_unregister() or mmu_notifier_put() must be always called to unregister the notifier.h]hammu_notifier_unregister() or mmu_notifier_put() must be always called to unregister the notifier.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhR/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:145: ./mm/mmu_notifier.chMhjubjM)}(hWhile the caller has a mmu_notifier get the subscription->mm pointer will remain valid, and can be converted to an active mm pointer via mmget_not_zero().h]hWhile the caller has a mmu_notifier get the subscription->mm pointer will remain valid, and can be converted to an active mm pointer via mmget_not_zero().}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhR/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:145: ./mm/mmu_notifier.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h$mmu_notifier_get_locked (C function)c.mmu_notifier_get_lockedhNtauh1hhjKhhhNhNubh)}(hhh](h)}(hhstruct mmu_notifier * mmu_notifier_get_locked (const struct mmu_notifier_ops *ops, struct mm_struct *mm)h]h)}(hfstruct mmu_notifier *mmu_notifier_get_locked(const struct mmu_notifier_ops *ops, struct mm_struct *mm)h](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhR/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:145: ./mm/mmu_notifier.chM ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM ubh)}(hhh]j)}(h mmu_notifierh]h mmu_notifier}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jmmu_notifier_get_lockedsbc.mmu_notifier_get_lockedasbuh1hhjhhhjhM ubj)}(h h]h }(hj/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM ubjr)}(hjuh]h*}(hj=hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjhhhjhM ubh)}(hmmu_notifier_get_lockedh]j)}(hj,h]hmmu_notifier_get_locked}(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhM ubj8)}(h:(const struct mmu_notifier_ops *ops, struct mm_struct *mm)h](j>)}(h"const struct mmu_notifier_ops *opsh](j)}(hjh]hconst}(hjihhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubj)}(h h]h }(hjvhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubj)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubh)}(hhh]j)}(hmmu_notifier_opsh]hmmu_notifier_ops}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j*c.mmu_notifier_get_lockedasbuh1hhjeubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjeubj)}(hopsh]hops}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjaubj>)}(hstruct mm_struct *mmh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(h mm_structh]h mm_struct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j*c.mmu_notifier_get_lockedasbuh1hhjubj)}(h h]h }(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hj>hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hmmh]hmm}(hjKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjaubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhM ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhM ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhM hjhhubj4)}(hhh]jM)}(h6Return the single struct mmu_notifier for the mm & opsh]h6Return the single struct mmu_notifier for the mm & ops}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhR/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:145: ./mm/mmu_notifier.chM hjrhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhM ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``const struct mmu_notifier_ops *ops`` The operations struct being subscribe with ``struct mm_struct *mm`` The mm to attach notifiers too **Description** This function either allocates a new mmu_notifier via ops->alloc_notifier(), or returns an already existing notifier on the list. The value of the ops pointer is used to determine when two notifiers are the same. Each call to mmu_notifier_get() must be paired with a call to mmu_notifier_put(). The caller must hold the write side of mm->mmap_lock. While the caller has a mmu_notifier get the mm pointer will remain valid, and can be converted to an active mm pointer via mmget_not_zero().h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhR/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:145: ./mm/mmu_notifier.chMhjubj)}(hhh](j)}(hR``const struct mmu_notifier_ops *ops`` The operations struct being subscribe with h](j)}(h&``const struct mmu_notifier_ops *ops``h]jS)}(hjh]h"const struct mmu_notifier_ops *ops}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:145: ./mm/mmu_notifier.chMhjubj)}(hhh]jM)}(h*The operations struct being subscribe withh]h*The operations struct being subscribe with}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubjT)}(h8``struct mm_struct *mm`` The mm to attach notifiers too h](j)}(h``struct mm_struct *mm``h]jS)}(hjh]hstruct mm_struct *mm}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:145: ./mm/mmu_notifier.chMhjubj)}(hhh]jM)}(hThe mm to attach notifiers tooh]hThe mm to attach notifiers too}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubeh}(h]h ]h"]h$]h&]uh1jhjubjM)}(h**Description**h]j)}(hj*h]h Description}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj(ubah}(h]h ]h"]h$]h&]uh1jLhR/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:145: ./mm/mmu_notifier.chMhjubjM)}(hThis function either allocates a new mmu_notifier via ops->alloc_notifier(), or returns an already existing notifier on the list. The value of the ops pointer is used to determine when two notifiers are the same.h]hThis function either allocates a new mmu_notifier via ops->alloc_notifier(), or returns an already existing notifier on the list. The value of the ops pointer is used to determine when two notifiers are the same.}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhR/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:145: ./mm/mmu_notifier.chMhjubjM)}(hEach call to mmu_notifier_get() must be paired with a call to mmu_notifier_put(). The caller must hold the write side of mm->mmap_lock.h]hEach call to mmu_notifier_get() must be paired with a call to mmu_notifier_put(). The caller must hold the write side of mm->mmap_lock.}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhR/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:145: ./mm/mmu_notifier.chMhjubjM)}(hWhile the caller has a mmu_notifier get the mm pointer will remain valid, and can be converted to an active mm pointer via mmget_not_zero().h]hWhile the caller has a mmu_notifier get the mm pointer will remain valid, and can be converted to an active mm pointer via mmget_not_zero().}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhR/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:145: ./mm/mmu_notifier.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hmmu_notifier_put (C function)c.mmu_notifier_puthNtauh1hhjKhhhNhNubh)}(hhh](h)}(h9void mmu_notifier_put (struct mmu_notifier *subscription)h]h)}(h8void mmu_notifier_put(struct mmu_notifier *subscription)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhR/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:145: ./mm/mmu_notifier.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh)}(hmmu_notifier_puth]j)}(hmmu_notifier_puth]hmmu_notifier_put}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMubj8)}(h#(struct mmu_notifier *subscription)h]j>)}(h!struct mmu_notifier *subscriptionh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(h mmu_notifierh]h mmu_notifier}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsbc.mmu_notifier_putasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(h subscriptionh]h subscription}(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMhjhhubj4)}(hhh]jM)}(h%Release the reference on the notifierh]h%Release the reference on the notifier}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhR/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:145: ./mm/mmu_notifier.chMhjJhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjejHjejIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct mmu_notifier *subscription`` The notifier to act on **Description** This function must be paired with each mmu_notifier_get(), it releases the reference obtained by the get. If this is the last reference then process to free the notifier will be run asynchronously. Unlike mmu_notifier_unregister() the get/put flow only calls ops->release when the mm_struct is destroyed. Instead free_notifier is always called to release any resources held by the user. As ops->release is not guaranteed to be called, the user must ensure that all sptes are dropped, and no new sptes can be established before mmu_notifier_put() is called. This function can be called from the ops->release callback, however the caller must still ensure it is called pairwise with mmu_notifier_get(). Modules calling this function must call mmu_notifier_synchronize() in their __exit functions to ensure the async work is completed.h](jM)}(h**Parameters**h]j)}(hjoh]h Parameters}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjmubah}(h]h ]h"]h$]h&]uh1jLhR/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:145: ./mm/mmu_notifier.chMhjiubj)}(hhh]j)}(h=``struct mmu_notifier *subscription`` The notifier to act on h](j)}(h%``struct mmu_notifier *subscription``h]jS)}(hjh]h!struct mmu_notifier *subscription}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:145: ./mm/mmu_notifier.chMhjubj)}(hhh]jM)}(hThe notifier to act onh]hThe notifier to act on}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjiubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhR/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:145: ./mm/mmu_notifier.chMhjiubjM)}(hThis function must be paired with each mmu_notifier_get(), it releases the reference obtained by the get. If this is the last reference then process to free the notifier will be run asynchronously.h]hThis function must be paired with each mmu_notifier_get(), it releases the reference obtained by the get. If this is the last reference then process to free the notifier will be run asynchronously.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhR/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:145: ./mm/mmu_notifier.chMhjiubjM)}(hUnlike mmu_notifier_unregister() the get/put flow only calls ops->release when the mm_struct is destroyed. Instead free_notifier is always called to release any resources held by the user.h]hUnlike mmu_notifier_unregister() the get/put flow only calls ops->release when the mm_struct is destroyed. Instead free_notifier is always called to release any resources held by the user.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhR/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:145: ./mm/mmu_notifier.chMhjiubjM)}(hAs ops->release is not guaranteed to be called, the user must ensure that all sptes are dropped, and no new sptes can be established before mmu_notifier_put() is called.h]hAs ops->release is not guaranteed to be called, the user must ensure that all sptes are dropped, and no new sptes can be established before mmu_notifier_put() is called.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhR/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:145: ./mm/mmu_notifier.chMhjiubjM)}(hThis function can be called from the ops->release callback, however the caller must still ensure it is called pairwise with mmu_notifier_get().h]hThis function can be called from the ops->release callback, however the caller must still ensure it is called pairwise with mmu_notifier_get().}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhR/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:145: ./mm/mmu_notifier.chMhjiubjM)}(hModules calling this function must call mmu_notifier_synchronize() in their __exit functions to ensure the async work is completed.h]hModules calling this function must call mmu_notifier_synchronize() in their __exit functions to ensure the async work is completed.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhR/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:145: ./mm/mmu_notifier.chMhjiubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h)mmu_interval_notifier_insert (C function)c.mmu_interval_notifier_inserthNtauh1hhjKhhhNhNubh)}(hhh](h)}(hint mmu_interval_notifier_insert (struct mmu_interval_notifier *interval_sub, struct mm_struct *mm, unsigned long start, unsigned long length, const struct mmu_interval_notifier_ops *ops)h]h)}(hint mmu_interval_notifier_insert(struct mmu_interval_notifier *interval_sub, struct mm_struct *mm, unsigned long start, unsigned long length, const struct mmu_interval_notifier_ops *ops)h](j)}(hinth]hint}(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFhhhR/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:145: ./mm/mmu_notifier.chMubj)}(h h]h }(hjYhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFhhhjXhMubh)}(hmmu_interval_notifier_inserth]j)}(hmmu_interval_notifier_inserth]hmmu_interval_notifier_insert}(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubah}(h]h ](jjeh"]h$]h&]jjuh1hhjFhhhjXhMubj8)}(h(struct mmu_interval_notifier *interval_sub, struct mm_struct *mm, unsigned long start, unsigned long length, const struct mmu_interval_notifier_ops *ops)h](j>)}(h*struct mmu_interval_notifier *interval_subh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hmmu_interval_notifierh]hmmu_interval_notifier}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjmsbc.mmu_interval_notifier_insertasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(h interval_subh]h interval_sub}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hstruct mm_struct *mmh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(h mm_structh]h mm_struct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.mmu_interval_notifier_insertasbuh1hhjubj)}(h h]h }(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjChhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hmmh]hmm}(hjPhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hunsigned long starth](j)}(hunsignedh]hunsigned}(hjihhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubj)}(h h]h }(hjwhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubj)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubj)}(hstarth]hstart}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(hunsigned long lengthh](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hlengthh]hlength}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubj>)}(h+const struct mmu_interval_notifier_ops *opsh](j)}(hjh]hconst}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjJ,h]hstruct}(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hmmu_interval_notifier_opsh]hmmu_interval_notifier_ops}(hjDhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjAubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjFmodnameN classnameNjj)}j]jc.mmu_interval_notifier_insertasbuh1hhjubj)}(h h]h }(hjbhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjphhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hopsh]hops}(hj}hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubeh}(h]h ]h"]h$]h&]jjuh1j7hjFhhhjXhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjBhhhjXhMubah}(h]j=ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjXhMhj?hhubj4)}(hhh]jM)}(hInsert an interval notifierh]hInsert an interval notifier}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhR/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:145: ./mm/mmu_notifier.chMhjhhubah}(h]h ]h"]h$]h&]uh1j3hj?hhhjXhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjHjjIjJjKuh1hhhhjKhNhNubj)}(hX,**Parameters** ``struct mmu_interval_notifier *interval_sub`` Interval subscription to register ``struct mm_struct *mm`` mm_struct to attach to ``unsigned long start`` Starting virtual address to monitor ``unsigned long length`` Length of the range to monitor ``const struct mmu_interval_notifier_ops *ops`` Interval notifier operations to be called on matching events **Description** This function subscribes the interval notifier for notifications from the mm. Upon return the ops related to mmu_interval_notifier will be called whenever an event that intersects with the given range occurs. Upon return the range_notifier may not be present in the interval tree yet. The caller must use the normal interval notifier read flow via mmu_interval_read_begin() to establish SPTEs for this range.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhR/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:145: ./mm/mmu_notifier.chMhjubj)}(hhh](j)}(hQ``struct mmu_interval_notifier *interval_sub`` Interval subscription to register h](j)}(h.``struct mmu_interval_notifier *interval_sub``h]jS)}(hjh]h*struct mmu_interval_notifier *interval_sub}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:145: ./mm/mmu_notifier.chMhjubj)}(hhh]jM)}(h!Interval subscription to registerh]h!Interval subscription to register}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h0``struct mm_struct *mm`` mm_struct to attach to h](j)}(h``struct mm_struct *mm``h]jS)}(hj!h]hstruct mm_struct *mm}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:145: ./mm/mmu_notifier.chMhjubj)}(hhh]jM)}(hmm_struct to attach toh]hmm_struct to attach to}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj6hMhj7ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj6hMhjubj)}(h<``unsigned long start`` Starting virtual address to monitor h](j)}(h``unsigned long start``h]jS)}(hjZh]hunsigned long start}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjXubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:145: ./mm/mmu_notifier.chMhjTubj)}(hhh]jM)}(h#Starting virtual address to monitorh]h#Starting virtual address to monitor}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjohMhjpubah}(h]h ]h"]h$]h&]uh1jhjTubeh}(h]h ]h"]h$]h&]uh1jhjohMhjubj)}(h8``unsigned long length`` Length of the range to monitor h](j)}(h``unsigned long length``h]jS)}(hjh]hunsigned long length}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:145: ./mm/mmu_notifier.chMhjubj)}(hhh]jM)}(hLength of the range to monitorh]hLength of the range to monitor}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(hm``const struct mmu_interval_notifier_ops *ops`` Interval notifier operations to be called on matching events h](j)}(h/``const struct mmu_interval_notifier_ops *ops``h]jS)}(hjh]h+const struct mmu_interval_notifier_ops *ops}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:145: ./mm/mmu_notifier.chMhjubj)}(hhh]jM)}(h)}(h*struct mmu_interval_notifier *interval_subh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hmmu_interval_notifierh]hmmu_interval_notifier}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jj~sbc.mmu_interval_notifier_removeasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(h interval_subh]h interval_sub}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjWhhhjihM4ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjShhhjihM4ubah}(h]jNah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjihM4hjPhhubj4)}(hhh]jM)}(hRemove a interval notifierh]hRemove a interval notifier}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhR/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:145: ./mm/mmu_notifier.chM4hjhhubah}(h]h ]h"]h$]h&]uh1j3hjPhhhjihM4ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj3jHj3jIjJjKuh1hhhhjKhNhNubj)}(hXJ**Parameters** ``struct mmu_interval_notifier *interval_sub`` Interval subscription to unregister **Description** This function must be paired with mmu_interval_notifier_insert(). It cannot be called from any ops callback. Once this returns ops callbacks are no longer running on other CPUs and will not be called in future.h](jM)}(h**Parameters**h]j)}(hj=h]h Parameters}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj;ubah}(h]h ]h"]h$]h&]uh1jLhR/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:145: ./mm/mmu_notifier.chM8hj7ubj)}(hhh]j)}(hS``struct mmu_interval_notifier *interval_sub`` Interval subscription to unregister h](j)}(h.``struct mmu_interval_notifier *interval_sub``h]jS)}(hj\h]h*struct mmu_interval_notifier *interval_sub}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjZubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:145: ./mm/mmu_notifier.chM5hjVubj)}(hhh]jM)}(h#Interval subscription to unregisterh]h#Interval subscription to unregister}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjqhM5hjrubah}(h]h ]h"]h$]h&]uh1jhjVubeh}(h]h ]h"]h$]h&]uh1jhjqhM5hjSubah}(h]h ]h"]h$]h&]uh1jhj7ubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhR/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:145: ./mm/mmu_notifier.chM7hj7ubjM)}(hlThis function must be paired with mmu_interval_notifier_insert(). It cannot be called from any ops callback.h]hlThis function must be paired with mmu_interval_notifier_insert(). It cannot be called from any ops callback.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhR/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:145: ./mm/mmu_notifier.chM6hj7ubjM)}(heOnce this returns ops callbacks are no longer running on other CPUs and will not be called in future.h]heOnce this returns ops callbacks are no longer running on other CPUs and will not be called in future.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhR/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:145: ./mm/mmu_notifier.chM9hj7ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h%mmu_notifier_synchronize (C function)c.mmu_notifier_synchronizehNtauh1hhjKhhhNhNubh)}(hhh](h)}(h$void mmu_notifier_synchronize (void)h]h)}(h#void mmu_notifier_synchronize(void)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhR/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:145: ./mm/mmu_notifier.chMjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMjubh)}(hmmu_notifier_synchronizeh]j)}(hmmu_notifier_synchronizeh]hmmu_notifier_synchronize}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhMjubj8)}(h(void)h]j>)}(hvoidh]j)}(hvoidh]hvoid}(hj(hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$ubah}(h]h ]h"]h$]h&]noemphjjuh1j=hj ubah}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhMjubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhMjubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhMjhjhhubj4)}(hhh]jM)}(h"Ensure all mmu_notifiers are freedh]h"Ensure all mmu_notifiers are freed}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhR/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:145: ./mm/mmu_notifier.chMjhjOhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMjubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjjjHjjjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``void`` no arguments **Description** This function ensures that all outstanding async SRU work from mmu_notifier_put() is completed. After it returns any mmu_notifier_ops associated with an unused mmu_notifier will no longer be called. Before using the caller must ensure that all of its mmu_notifiers have been fully released via mmu_notifier_put(). Modules using the mmu_notifier_put() API should call this in their __exit function to avoid module unloading races.h](jM)}(h**Parameters**h]j)}(hjth]h Parameters}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjrubah}(h]h ]h"]h$]h&]uh1jLhR/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:145: ./mm/mmu_notifier.chMnhjnubj)}(hhh]j)}(h``void`` no arguments h](j)}(h``void``h]jS)}(hjh]hvoid}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhR/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:145: ./mm/mmu_notifier.chKhjubj)}(hhh]jM)}(h no argumentsh]h no arguments}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjnubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhR/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:145: ./mm/mmu_notifier.chKhjnubjM)}(hThis function ensures that all outstanding async SRU work from mmu_notifier_put() is completed. After it returns any mmu_notifier_ops associated with an unused mmu_notifier will no longer be called.h]hThis function ensures that all outstanding async SRU work from mmu_notifier_put() is completed. After it returns any mmu_notifier_ops associated with an unused mmu_notifier will no longer be called.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhR/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:145: ./mm/mmu_notifier.chMkhjnubjM)}(hrBefore using the caller must ensure that all of its mmu_notifiers have been fully released via mmu_notifier_put().h]hrBefore using the caller must ensure that all of its mmu_notifiers have been fully released via mmu_notifier_put().}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhR/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:145: ./mm/mmu_notifier.chMohjnubjM)}(hsModules using the mmu_notifier_put() API should call this in their __exit function to avoid module unloading races.h]hsModules using the mmu_notifier_put() API should call this in their __exit function to avoid module unloading races.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhR/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:145: ./mm/mmu_notifier.chMrhjnubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h balloon_page_insert (C function)c.balloon_page_inserthNtauh1hhjKhhhNhNubh)}(hhh](h)}(hNvoid balloon_page_insert (struct balloon_dev_info *balloon, struct page *page)h]h)}(hMvoid balloon_page_insert(struct balloon_dev_info *balloon, struct page *page)h](j)}(hvoidh]hvoid}(hj1hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-hhhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:146: ./mm/balloon.chKubj)}(h h]h }(hj@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-hhhj?hKubh)}(hballoon_page_inserth]j)}(hballoon_page_inserth]hballoon_page_insert}(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubah}(h]h ](jjeh"]h$]h&]jjuh1hhj-hhhj?hKubj8)}(h5(struct balloon_dev_info *balloon, struct page *page)h](j>)}(h struct balloon_dev_info *balloonh](j)}(hjJ,h]hstruct}(hjnhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjjubj)}(h h]h }(hj{hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjjubh)}(hhh]j)}(hballoon_dev_infoh]hballoon_dev_info}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jjTsbc.balloon_page_insertasbuh1hhjjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjjubj)}(hballoonh]hballoon}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjfubj>)}(hstruct page *pageh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hpageh]hpage}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.balloon_page_insertasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hj*hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hpageh]hpage}(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjfubeh}(h]h ]h"]h$]h&]jjuh1j7hj-hhhj?hKubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj)hhhj?hKubah}(h]j$ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj?hKhj&hhubj4)}(hhh]jM)}(h]insert a page into the balloon's page list and make the page->private assignment accordingly.h]h_insert a page into the balloon’s page list and make the page->private assignment accordingly.}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:146: ./mm/balloon.chKhj^hhubah}(h]h ]h"]h$]h&]uh1j3hj&hhhj?hKubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjyjHjyjIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``struct balloon_dev_info *balloon`` pointer to balloon device ``struct page *page`` page to be assigned as a 'balloon page' **Description** Caller must ensure the balloon_pages_lock is held.h](jM)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:146: ./mm/balloon.chKhj}ubj)}(hhh](j)}(h?``struct balloon_dev_info *balloon`` pointer to balloon device h](j)}(h$``struct balloon_dev_info *balloon``h]jS)}(hjh]h struct balloon_dev_info *balloon}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:146: ./mm/balloon.chKhjubj)}(hhh]jM)}(hpointer to balloon deviceh]hpointer to balloon device}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubj)}(h>``struct page *page`` page to be assigned as a 'balloon page' h](j)}(h``struct page *page``h]jS)}(hjh]hstruct page *page}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:146: ./mm/balloon.chKhjubj)}(hhh]jM)}(h'page to be assigned as a 'balloon page'h]h+page to be assigned as a ‘balloon page’}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubeh}(h]h ]h"]h$]h&]uh1jhj}ubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:146: ./mm/balloon.chKhj}ubjM)}(h2Caller must ensure the balloon_pages_lock is held.h]h2Caller must ensure the balloon_pages_lock is held.}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:146: ./mm/balloon.chKhj}ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h"balloon_page_finalize (C function)c.balloon_page_finalizehNtauh1hhjKhhhNhNubh)}(hhh](h)}(h.void balloon_page_finalize (struct page *page)h]h)}(h-void balloon_page_finalize(struct page *page)h](j)}(hvoidh]hvoid}(hj[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjWhhhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:146: ./mm/balloon.chK(ubj)}(h h]h }(hjjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjWhhhjihK(ubh)}(hballoon_page_finalizeh]j)}(hballoon_page_finalizeh]hballoon_page_finalize}(hj|hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjxubah}(h]h ](jjeh"]h$]h&]jjuh1hhjWhhhjihK(ubj8)}(h(struct page *page)h]j>)}(hstruct page *pageh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hpageh]hpage}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jj~sbc.balloon_page_finalizeasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hpageh]hpage}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjubah}(h]h ]h"]h$]h&]jjuh1j7hjWhhhjihK(ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjShhhjihK(ubah}(h]jNah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjihK(hjPhhubj4)}(hhh]jM)}(h_prepare a balloon page that was removed from the balloon list for release to the page allocatorh]h_prepare a balloon page that was removed from the balloon list for release to the page allocator}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:146: ./mm/balloon.chK(hjhhubah}(h]h ]h"]h$]h&]uh1j3hjPhhhjihK(ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj3jHj3jIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``struct page *page`` page to be released to the page allocator **Description** Caller must ensure the balloon_pages_lock is held.h](jM)}(h**Parameters**h]j)}(hj=h]h Parameters}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj;ubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:146: ./mm/balloon.chK,hj7ubj)}(hhh]j)}(h@``struct page *page`` page to be released to the page allocator h](j)}(h``struct page *page``h]jS)}(hj\h]hstruct page *page}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjZubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:146: ./mm/balloon.chK*hjVubj)}(hhh]jM)}(h)page to be released to the page allocatorh]h)page to be released to the page allocator}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjqhK*hjrubah}(h]h ]h"]h$]h&]uh1jhjVubeh}(h]h ]h"]h$]h&]uh1jhjqhK*hjSubah}(h]h ]h"]h$]h&]uh1jhj7ubjM)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:146: ./mm/balloon.chK,hj7ubjM)}(h2Caller must ensure the balloon_pages_lock is held.h]h2Caller must ensure the balloon_pages_lock is held.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:146: ./mm/balloon.chK+hj7ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h&balloon_page_list_enqueue (C function)c.balloon_page_list_enqueuehNtauh1hhjKhhhNhNubh)}(hhh](h)}(h_size_t balloon_page_list_enqueue (struct balloon_dev_info *b_dev_info, struct list_head *pages)h]h)}(h^size_t balloon_page_list_enqueue(struct balloon_dev_info *b_dev_info, struct list_head *pages)h](h)}(hhh]j)}(hsize_th]hsize_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]j)}jballoon_page_list_enqueuesbc.balloon_page_list_enqueueasbuh1hhjhhhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:146: ./mm/balloon.chKAubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhKAubh)}(hballoon_page_list_enqueueh]j)}(hjh]hballoon_page_list_enqueue}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1hhjhhhjhKAubj8)}(h>(struct balloon_dev_info *b_dev_info, struct list_head *pages)h](j>)}(h#struct balloon_dev_info *b_dev_infoh](j)}(hjJ,h]hstruct}(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*ubj)}(h h]h }(hj;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*ubh)}(hhh]j)}(hballoon_dev_infoh]hballoon_dev_info}(hjLhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjNmodnameN classnameNjj)}j]jc.balloon_page_list_enqueueasbuh1hhj*ubj)}(h h]h }(hjjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*ubjr)}(hjuh]h*}(hjxhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj*ubj)}(h b_dev_infoh]h b_dev_info}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj&ubj>)}(hstruct list_head *pagesh](j)}(hjJ,h]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(h list_headh]h list_head}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjmodnameN classnameNjj)}j]jc.balloon_page_list_enqueueasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjr)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjubj)}(hpagesh]hpages}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj&ubeh}(h]h ]h"]h$]h&]jjuh1j7hjhhhjhKAubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjhhhjhKAubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjhKAhjhhubj4)}(hhh]jM)}(h3inserts a list of pages into the balloon page list.h]h3inserts a list of pages into the balloon page list.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:146: ./mm/balloon.chKAhj hhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhKAubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj7 jHj7 jIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct balloon_dev_info *b_dev_info`` balloon device descriptor where we will insert a new page to ``struct list_head *pages`` pages to enqueue - allocated using balloon_page_alloc. **Description** Driver must call this function to properly enqueue balloon pages before definitively removing them from the guest system. **Return** number of pages that were enqueued.h](jM)}(h**Parameters**h]j)}(hjA h]h Parameters}(hjC hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj? ubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:146: ./mm/balloon.chKEhj; ubj)}(hhh](j)}(he``struct balloon_dev_info *b_dev_info`` balloon device descriptor where we will insert a new page to h](j)}(h'``struct balloon_dev_info *b_dev_info``h]jS)}(hj` h]h#struct balloon_dev_info *b_dev_info}(hjb hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj^ ubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:146: ./mm/balloon.chKChjZ ubj)}(hhh]jM)}(h)}(h#struct balloon_dev_info *b_dev_infoh](j)}(hjJ,h]hstruct}(hj!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubj)}(h h]h }(hj!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubh)}(hhh]j)}(hballoon_dev_infoh]hballoon_dev_info}(hj!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj!modnameN classnameNjj)}j]j_!c.balloon_page_list_dequeueasbuh1hhj!ubj)}(h h]h }(hj!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubjr)}(hjuh]h*}(hj!hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj!ubj)}(h b_dev_infoh]h b_dev_info}(hj!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj!ubj>)}(hstruct list_head *pagesh](j)}(hjJ,h]hstruct}(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubj)}(h h]h }(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubh)}(hhh]j)}(h list_headh]h list_head}(hj "hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj""modnameN classnameNjj)}j]j_!c.balloon_page_list_dequeueasbuh1hhj!ubj)}(h h]h }(hj>"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubjr)}(hjuh]h*}(hjL"hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj!ubj)}(hpagesh]hpages}(hjY"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj!ubj>)}(hsize_t n_req_pagesh](h)}(hhh]j)}(hsize_th]hsize_t}(hju"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjr"ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjw"modnameN classnameNjj)}j]j_!c.balloon_page_list_dequeueasbuh1hhjn"ubj)}(h h]h }(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjn"ubj)}(h n_req_pagesh]h n_req_pages}(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjn"ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj!ubeh}(h]h ]h"]h$]h&]jjuh1j7hj)}(hvoidh]j)}(hvoidh]hvoid}(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$ubah}(h]h ]h"]h$]h&]noemphjjuh1j=hj$ubah}(h]h ]h"]h$]h&]jjuh1j7hjf$hhhjw$hKubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjb$hhhjw$hKubah}(h]j]$ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjw$hKhj_$hhubj4)}(hhh]jM)}(h>allocates a new page for insertion into the balloon page list.h]h>allocates a new page for insertion into the balloon page list.}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:146: ./mm/balloon.chKhj %hhubah}(h]h ]h"]h$]h&]uh1j3hj_$hhhjw$hKubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj&%jHj&%jIjJjKuh1hhhhjKhNhNubj)}(hX3**Parameters** ``void`` no arguments **Description** Driver must call this function to properly allocate a new balloon page. Driver must call balloon_page_enqueue before definitively removing the page from the guest system. **Return** struct page for the allocated page or NULL on allocation failure.h](jM)}(h**Parameters**h]j)}(hj0%h]h Parameters}(hj2%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj.%ubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:146: ./mm/balloon.chKhj*%ubj)}(hhh]j)}(h``void`` no arguments h](j)}(h``void``h]jS)}(hjO%h]hvoid}(hjQ%hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjM%ubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:146: ./mm/balloon.chKhjI%ubj)}(hhh]jM)}(h no argumentsh]h no arguments}(hjh%hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjd%hKhje%ubah}(h]h ]h"]h$]h&]uh1jhjI%ubeh}(h]h ]h"]h$]h&]uh1jhjd%hKhjF%ubah}(h]h ]h"]h$]h&]uh1jhj*%ubjM)}(h**Description**h]j)}(hj%h]h Description}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj%ubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:146: ./mm/balloon.chKhj*%ubjM)}(hDriver must call this function to properly allocate a new balloon page. Driver must call balloon_page_enqueue before definitively removing the page from the guest system.h]hDriver must call this function to properly allocate a new balloon page. Driver must call balloon_page_enqueue before definitively removing the page from the guest system.}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:146: ./mm/balloon.chKhj*%ubjM)}(h **Return**h]j)}(hj%h]hReturn}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj%ubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:146: ./mm/balloon.chKhj*%ubjM)}(hAstruct page for the allocated page or NULL on allocation failure.h]hAstruct page for the allocated page or NULL on allocation failure.}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:146: ./mm/balloon.chKhj*%ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h!balloon_page_enqueue (C function)c.balloon_page_enqueuehNtauh1hhjKhhhNhNubh)}(hhh](h)}(hRvoid balloon_page_enqueue (struct balloon_dev_info *b_dev_info, struct page *page)h]h)}(hQvoid balloon_page_enqueue(struct balloon_dev_info *b_dev_info, struct page *page)h](j)}(hvoidh]hvoid}(hj%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%hhhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:146: ./mm/balloon.chKubj)}(h h]h }(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%hhhj&hKubh)}(hballoon_page_enqueueh]j)}(hballoon_page_enqueueh]hballoon_page_enqueue}(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj%hhhj&hKubj8)}(h8(struct balloon_dev_info *b_dev_info, struct page *page)h](j>)}(h#struct balloon_dev_info *b_dev_infoh](j)}(hjJ,h]hstruct}(hj3&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/&ubj)}(h h]h }(hj@&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/&ubh)}(hhh]j)}(hballoon_dev_infoh]hballoon_dev_info}(hjQ&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjN&ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjS&modnameN classnameNjj)}j]j)}jj&sbc.balloon_page_enqueueasbuh1hhj/&ubj)}(h h]h }(hjq&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/&ubjr)}(hjuh]h*}(hj&hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj/&ubj)}(h b_dev_infoh]h b_dev_info}(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/&ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj+&ubj>)}(hstruct page *pageh](j)}(hjJ,h]hstruct}(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubj)}(h h]h }(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubh)}(hhh]j)}(hpageh]hpage}(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj&modnameN classnameNjj)}j]jm&c.balloon_page_enqueueasbuh1hhj&ubj)}(h h]h }(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubjr)}(hjuh]h*}(hj&hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj&ubj)}(hpageh]hpage}(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj+&ubeh}(h]h ]h"]h$]h&]jjuh1j7hj%hhhj&hKubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj%hhhj&hKubah}(h]j%ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj&hKhj%hhubj4)}(hhh]jM)}(h.inserts a new page into the balloon page list.h]h.inserts a new page into the balloon page list.}(hj&'hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:146: ./mm/balloon.chKhj#'hhubah}(h]h ]h"]h$]h&]uh1j3hj%hhhj&hKubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj>'jHj>'jIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct balloon_dev_info *b_dev_info`` balloon device descriptor where we will insert a new page ``struct page *page`` new page to enqueue - allocated using balloon_page_alloc. **Description** Drivers must call this function to properly enqueue a new allocated balloon page before definitively removing the page from the guest system. Drivers must not enqueue pages while page->lru is still in use, and must not use page->lru until a page was unqueued again.h](jM)}(h**Parameters**h]j)}(hjH'h]h Parameters}(hjJ'hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjF'ubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:146: ./mm/balloon.chKhjB'ubj)}(hhh](j)}(hb``struct balloon_dev_info *b_dev_info`` balloon device descriptor where we will insert a new page h](j)}(h'``struct balloon_dev_info *b_dev_info``h]jS)}(hjg'h]h#struct balloon_dev_info *b_dev_info}(hji'hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhje'ubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:146: ./mm/balloon.chKhja'ubj)}(hhh]jM)}(h9balloon device descriptor where we will insert a new pageh]h9balloon device descriptor where we will insert a new page}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj|'hKhj}'ubah}(h]h ]h"]h$]h&]uh1jhja'ubeh}(h]h ]h"]h$]h&]uh1jhj|'hKhj^'ubj)}(hP``struct page *page`` new page to enqueue - allocated using balloon_page_alloc. h](j)}(h``struct page *page``h]jS)}(hj'h]hstruct page *page}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj'ubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:146: ./mm/balloon.chKhj'ubj)}(hhh]jM)}(h9new page to enqueue - allocated using balloon_page_alloc.h]h9new page to enqueue - allocated using balloon_page_alloc.}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj'hKhj'ubah}(h]h ]h"]h$]h&]uh1jhj'ubeh}(h]h ]h"]h$]h&]uh1jhj'hKhj^'ubeh}(h]h ]h"]h$]h&]uh1jhjB'ubjM)}(h**Description**h]j)}(hj'h]h Description}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj'ubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:146: ./mm/balloon.chKhjB'ubjM)}(hDrivers must call this function to properly enqueue a new allocated balloon page before definitively removing the page from the guest system.h]hDrivers must call this function to properly enqueue a new allocated balloon page before definitively removing the page from the guest system.}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:146: ./mm/balloon.chKhjB'ubjM)}(h{Drivers must not enqueue pages while page->lru is still in use, and must not use page->lru until a page was unqueued again.h]h{Drivers must not enqueue pages while page->lru is still in use, and must not use page->lru until a page was unqueued again.}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:146: ./mm/balloon.chKhjB'ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h!balloon_page_dequeue (C function)c.balloon_page_dequeuehNtauh1hhjKhhhNhNubh)}(hhh](h)}(hHstruct page * balloon_page_dequeue (struct balloon_dev_info *b_dev_info)h]h)}(hFstruct page *balloon_page_dequeue(struct balloon_dev_info *b_dev_info)h](j)}(hjJ,h]hstruct}(hj/(hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+(hhhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:146: ./mm/balloon.chKubj)}(h h]h }(hj=(hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+(hhhj<(hKubh)}(hhh]j)}(hpageh]hpage}(hjN(hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjK(ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjP(modnameN classnameNjj)}j]j)}jballoon_page_dequeuesbc.balloon_page_dequeueasbuh1hhj+(hhhj<(hKubj)}(h h]h }(hjo(hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+(hhhj<(hKubjr)}(hjuh]h*}(hj}(hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj+(hhhj<(hKubh)}(hballoon_page_dequeueh]j)}(hjl(h]hballoon_page_dequeue}(hj(hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj+(hhhj<(hKubj8)}(h%(struct balloon_dev_info *b_dev_info)h]j>)}(h#struct balloon_dev_info *b_dev_infoh](j)}(hjJ,h]hstruct}(hj(hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(ubj)}(h h]h }(hj(hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(ubh)}(hhh]j)}(hballoon_dev_infoh]hballoon_dev_info}(hj(hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj(modnameN classnameNjj)}j]jj(c.balloon_page_dequeueasbuh1hhj(ubj)}(h h]h }(hj(hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(ubjr)}(hjuh]h*}(hj(hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj(ubj)}(h b_dev_infoh]h b_dev_info}(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj(ubah}(h]h ]h"]h$]h&]jjuh1j7hj+(hhhj<(hKubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj'(hhhj<(hKubah}(h]j"(ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj<(hKhj$(hhubj4)}(hhh]jM)}(hhremoves a page from balloon's page list and returns its address to allow the driver to release the page.h]hjremoves a page from balloon’s page list and returns its address to allow the driver to release the page.}(hj*)hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:146: ./mm/balloon.chKhj')hhubah}(h]h ]h"]h$]h&]uh1j3hj$(hhhj<(hKubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjB)jHjB)jIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct balloon_dev_info *b_dev_info`` balloon device descriptor where we will grab a page from. **Description** Driver must call this function to properly dequeue a previously enqueued page before definitively releasing it back to the guest system. Caller must perform its own accounting to ensure that this function is called only if some pages are actually enqueued. Note that this function may fail to dequeue some pages even if there are some enqueued pages - since the page list can be temporarily empty due to the compaction of isolated pages. TODO: remove the caller accounting requirements, and allow caller to wait until all pages can be dequeued. **Return** struct page for the dequeued page, or NULL if no page was dequeued.h](jM)}(h**Parameters**h]j)}(hjL)h]h Parameters}(hjN)hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjJ)ubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:146: ./mm/balloon.chKhjF)ubj)}(hhh]j)}(hb``struct balloon_dev_info *b_dev_info`` balloon device descriptor where we will grab a page from. h](j)}(h'``struct balloon_dev_info *b_dev_info``h]jS)}(hjk)h]h#struct balloon_dev_info *b_dev_info}(hjm)hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhji)ubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:146: ./mm/balloon.chKhje)ubj)}(hhh]jM)}(h9balloon device descriptor where we will grab a page from.h]h9balloon device descriptor where we will grab a page from.}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj)hKhj)ubah}(h]h ]h"]h$]h&]uh1jhje)ubeh}(h]h ]h"]h$]h&]uh1jhj)hKhjb)ubah}(h]h ]h"]h$]h&]uh1jhjF)ubjM)}(h**Description**h]j)}(hj)h]h Description}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj)ubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:146: ./mm/balloon.chKhjF)ubjM)}(hDriver must call this function to properly dequeue a previously enqueued page before definitively releasing it back to the guest system.h]hDriver must call this function to properly dequeue a previously enqueued page before definitively releasing it back to the guest system.}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:146: ./mm/balloon.chKhjF)ubjM)}(hwCaller must perform its own accounting to ensure that this function is called only if some pages are actually enqueued.h]hwCaller must perform its own accounting to ensure that this function is called only if some pages are actually enqueued.}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:146: ./mm/balloon.chKhjF)ubjM)}(hNote that this function may fail to dequeue some pages even if there are some enqueued pages - since the page list can be temporarily empty due to the compaction of isolated pages.h]hNote that this function may fail to dequeue some pages even if there are some enqueued pages - since the page list can be temporarily empty due to the compaction of isolated pages.}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:146: ./mm/balloon.chKhjF)ubjM)}(hjTODO: remove the caller accounting requirements, and allow caller to wait until all pages can be dequeued.h]hjTODO: remove the caller accounting requirements, and allow caller to wait until all pages can be dequeued.}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:146: ./mm/balloon.chKhjF)ubjM)}(h **Return**h]j)}(hj)h]hReturn}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj)ubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:146: ./mm/balloon.chKhjF)ubjM)}(hCstruct page for the dequeued page, or NULL if no page was dequeued.h]hCstruct page for the dequeued page, or NULL if no page was dequeued.}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhM/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:146: ./mm/balloon.chKhjF)ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hvmf_insert_pfn_pmd (C function)c.vmf_insert_pfn_pmdhNtauh1hhjKhhhNhNubh)}(hhh](h)}(hSvm_fault_t vmf_insert_pfn_pmd (struct vm_fault *vmf, unsigned long pfn, bool write)h]h)}(hRvm_fault_t vmf_insert_pfn_pmd(struct vm_fault *vmf, unsigned long pfn, bool write)h](h)}(hhh]j)}(h vm_fault_th]h vm_fault_t}(hjB*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?*ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjD*modnameN classnameNjj)}j]j)}jvmf_insert_pfn_pmdsbc.vmf_insert_pfn_pmdasbuh1hhj;*hhhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMubj)}(h h]h }(hjd*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;*hhhjc*hMubh)}(hvmf_insert_pfn_pmdh]j)}(hj`*h]hvmf_insert_pfn_pmd}(hjv*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjr*ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj;*hhhjc*hMubj8)}(h5(struct vm_fault *vmf, unsigned long pfn, bool write)h](j>)}(hstruct vm_fault *vmfh](j)}(hjJ,h]hstruct}(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*ubj)}(h h]h }(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*ubh)}(hhh]j)}(hvm_faulth]hvm_fault}(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj*modnameN classnameNjj)}j]j^*c.vmf_insert_pfn_pmdasbuh1hhj*ubj)}(h h]h }(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*ubjr)}(hjuh]h*}(hj*hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj*ubj)}(hvmfh]hvmf}(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj*ubj>)}(hunsigned long pfnh](j)}(hunsignedh]hunsigned}(hj+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*ubj)}(h h]h }(hj+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*ubj)}(hlongh]hlong}(hj+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*ubj)}(h h]h }(hj++hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*ubj)}(hpfnh]hpfn}(hj9+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj*ubj>)}(h bool writeh](j)}(hjh]hbool}(hjR+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjN+ubj)}(h h]h }(hj_+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjN+ubj)}(hwriteh]hwrite}(hjm+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjN+ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj*ubeh}(h]h ]h"]h$]h&]jjuh1j7hj;*hhhjc*hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj7*hhhjc*hMubah}(h]j2*ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjc*hMhj4*hhubj4)}(hhh]jM)}(hinsert a pmd size pfnh]hinsert a pmd size pfn}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMhj+hhubah}(h]h ]h"]h$]h&]uh1j3hj4*hhhjc*hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj+jHj+jIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct vm_fault *vmf`` Structure describing the fault ``unsigned long pfn`` pfn to insert ``bool write`` whether it's a write fault **Description** Insert a pmd size pfn. See vmf_insert_pfn() for additional info. **Return** vm_fault_t value.h](jM)}(h**Parameters**h]j)}(hj+h]h Parameters}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj+ubah}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMhj+ubj)}(hhh](j)}(h8``struct vm_fault *vmf`` Structure describing the fault h](j)}(h``struct vm_fault *vmf``h]jS)}(hj+h]hstruct vm_fault *vmf}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj+ubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMhj+ubj)}(hhh]jM)}(hStructure describing the faulth]hStructure describing the fault}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj+hMhj+ubah}(h]h ]h"]h$]h&]uh1jhj+ubeh}(h]h ]h"]h$]h&]uh1jhj+hMhj+ubj)}(h$``unsigned long pfn`` pfn to insert h](j)}(h``unsigned long pfn``h]jS)}(hj,h]hunsigned long pfn}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj,ubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMhj ,ubj)}(hhh]jM)}(h pfn to inserth]h pfn to insert}(hj*,hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj&,hMhj',ubah}(h]h ]h"]h$]h&]uh1jhj ,ubeh}(h]h ]h"]h$]h&]uh1jhj&,hMhj+ubj)}(h*``bool write`` whether it's a write fault h](j)}(h``bool write``h]jS)}(hjJ,h]h bool write}(hjL,hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjH,ubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMhjD,ubj)}(hhh]jM)}(hwhether it's a write faulth]hwhether it’s a write fault}(hjc,hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj_,hMhj`,ubah}(h]h ]h"]h$]h&]uh1jhjD,ubeh}(h]h ]h"]h$]h&]uh1jhj_,hMhj+ubeh}(h]h ]h"]h$]h&]uh1jhj+ubjM)}(h**Description**h]j)}(hj,h]h Description}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj,ubah}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMhj+ubjM)}(h@Insert a pmd size pfn. See vmf_insert_pfn() for additional info.h]h@Insert a pmd size pfn. See vmf_insert_pfn() for additional info.}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMhj+ubjM)}(h **Return**h]j)}(hj,h]hReturn}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj,ubah}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMhj+ubjM)}(hvm_fault_t value.h]hvm_fault_t value.}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMhj+ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hvmf_insert_pfn_pud (C function)c.vmf_insert_pfn_pudhNtauh1hhjKhhhNhNubh)}(hhh](h)}(hSvm_fault_t vmf_insert_pfn_pud (struct vm_fault *vmf, unsigned long pfn, bool write)h]h)}(hRvm_fault_t vmf_insert_pfn_pud(struct vm_fault *vmf, unsigned long pfn, bool write)h](h)}(hhh]j)}(h vm_fault_th]h vm_fault_t}(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj,modnameN classnameNjj)}j]j)}jvmf_insert_pfn_pudsbc.vmf_insert_pfn_pudasbuh1hhj,hhhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMubj)}(h h]h }(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,hhhj-hMubh)}(hvmf_insert_pfn_pudh]j)}(hj-h]hvmf_insert_pfn_pud}(hj(-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$-ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj,hhhj-hMubj8)}(h5(struct vm_fault *vmf, unsigned long pfn, bool write)h](j>)}(hstruct vm_fault *vmfh](j)}(hjJ,h]hstruct}(hjC-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?-ubj)}(h h]h }(hjP-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?-ubh)}(hhh]j)}(hvm_faulth]hvm_fault}(hja-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^-ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjc-modnameN classnameNjj)}j]j-c.vmf_insert_pfn_pudasbuh1hhj?-ubj)}(h h]h }(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?-ubjr)}(hjuh]h*}(hj-hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj?-ubj)}(hvmfh]hvmf}(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?-ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj;-ubj>)}(hunsigned long pfnh](j)}(hunsignedh]hunsigned}(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-ubj)}(h h]h }(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-ubj)}(hlongh]hlong}(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-ubj)}(h h]h }(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-ubj)}(hpfnh]hpfn}(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj;-ubj>)}(h bool writeh](j)}(hjh]hbool}(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj.ubj)}(h h]h }(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj.ubj)}(hwriteh]hwrite}(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj.ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj;-ubeh}(h]h ]h"]h$]h&]jjuh1j7hj,hhhj-hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj,hhhj-hMubah}(h]j,ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj-hMhj,hhubj4)}(hhh]jM)}(hinsert a pud size pfnh]hinsert a pud size pfn}(hjI.hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMhjF.hhubah}(h]h ]h"]h$]h&]uh1j3hj,hhhj-hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGja.jHja.jIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct vm_fault *vmf`` Structure describing the fault ``unsigned long pfn`` pfn to insert ``bool write`` whether it's a write fault **Description** Insert a pud size pfn. See vmf_insert_pfn() for additional info. **Return** vm_fault_t value.h](jM)}(h**Parameters**h]j)}(hjk.h]h Parameters}(hjm.hhhNhNubah}(h]h ]h"]h$]h&]uh1jhji.ubah}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMhje.ubj)}(hhh](j)}(h8``struct vm_fault *vmf`` Structure describing the fault h](j)}(h``struct vm_fault *vmf``h]jS)}(hj.h]hstruct vm_fault *vmf}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj.ubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMhj.ubj)}(hhh]jM)}(hStructure describing the faulth]hStructure describing the fault}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj.hMhj.ubah}(h]h ]h"]h$]h&]uh1jhj.ubeh}(h]h ]h"]h$]h&]uh1jhj.hMhj.ubj)}(h$``unsigned long pfn`` pfn to insert h](j)}(h``unsigned long pfn``h]jS)}(hj.h]hunsigned long pfn}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj.ubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMhj.ubj)}(hhh]jM)}(h pfn to inserth]h pfn to insert}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj.hMhj.ubah}(h]h ]h"]h$]h&]uh1jhj.ubeh}(h]h ]h"]h$]h&]uh1jhj.hMhj.ubj)}(h*``bool write`` whether it's a write fault h](j)}(h``bool write``h]jS)}(hj.h]h bool write}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj.ubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMhj.ubj)}(hhh]jM)}(hwhether it's a write faulth]hwhether it’s a write fault}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj/hMhj/ubah}(h]h ]h"]h$]h&]uh1jhj.ubeh}(h]h ]h"]h$]h&]uh1jhj/hMhj.ubeh}(h]h ]h"]h$]h&]uh1jhje.ubjM)}(h**Description**h]j)}(hj7/h]h Description}(hj9/hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj5/ubah}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMhje.ubjM)}(h@Insert a pud size pfn. See vmf_insert_pfn() for additional info.h]h@Insert a pud size pfn. See vmf_insert_pfn() for additional info.}(hjM/hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMhje.ubjM)}(h **Return**h]j)}(hj^/h]hReturn}(hj`/hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj\/ubah}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMhje.ubjM)}(hvm_fault_t value.h]hvm_fault_t value.}(hjt/hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMhje.ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h!vmf_insert_folio_pud (C function)c.vmf_insert_folio_pudhNtauh1hhjKhhhNhNubh)}(hhh](h)}(hWvm_fault_t vmf_insert_folio_pud (struct vm_fault *vmf, struct folio *folio, bool write)h]h)}(hVvm_fault_t vmf_insert_folio_pud(struct vm_fault *vmf, struct folio *folio, bool write)h](h)}(hhh]j)}(h vm_fault_th]h vm_fault_t}(hj/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj/modnameN classnameNjj)}j]j)}jvmf_insert_folio_pudsbc.vmf_insert_folio_pudasbuh1hhj/hhhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chM2ubj)}(h h]h }(hj/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/hhhj/hM2ubh)}(hvmf_insert_folio_pudh]j)}(hj/h]hvmf_insert_folio_pud}(hj/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj/hhhj/hM2ubj8)}(h7(struct vm_fault *vmf, struct folio *folio, bool write)h](j>)}(hstruct vm_fault *vmfh](j)}(hjJ,h]hstruct}(hj/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/ubj)}(h h]h }(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/ubh)}(hhh]j)}(hvm_faulth]hvm_fault}(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj0modnameN classnameNjj)}j]j/c.vmf_insert_folio_pudasbuh1hhj/ubj)}(h h]h }(hj10hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/ubjr)}(hjuh]h*}(hj?0hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj/ubj)}(hvmfh]hvmf}(hjL0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj/ubj>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hje0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhja0ubj)}(h h]h }(hjr0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhja0ubh)}(hhh]j)}(hfolioh]hfolio}(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj0modnameN classnameNjj)}j]j/c.vmf_insert_folio_pudasbuh1hhja0ubj)}(h h]h }(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhja0ubjr)}(hjuh]h*}(hj0hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhja0ubj)}(hfolioh]hfolio}(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhja0ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj/ubj>)}(h bool writeh](j)}(hjh]hbool}(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubj)}(h h]h }(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubj)}(hwriteh]hwrite}(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj/ubeh}(h]h ]h"]h$]h&]jjuh1j7hj/hhhj/hM2ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj/hhhj/hM2ubah}(h]j/ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj/hM2hj/hhubj4)}(hhh]jM)}(h-insert a pud size folio mapped by a pud entryh]h-insert a pud size folio mapped by a pud entry}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chM2hj1hhubah}(h]h ]h"]h$]h&]uh1j3hj/hhhj/hM2ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj21jHj21jIjJjKuh1hhhhjKhNhNubj)}(h**Parameters** ``struct vm_fault *vmf`` Structure describing the fault ``struct folio *folio`` folio to insert ``bool write`` whether it's a write fault **Return** vm_fault_t value.h](jM)}(h**Parameters**h]j)}(hj<1h]h Parameters}(hj>1hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj:1ubah}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chM6hj61ubj)}(hhh](j)}(h8``struct vm_fault *vmf`` Structure describing the fault h](j)}(h``struct vm_fault *vmf``h]jS)}(hj[1h]hstruct vm_fault *vmf}(hj]1hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjY1ubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chM3hjU1ubj)}(hhh]jM)}(hStructure describing the faulth]hStructure describing the fault}(hjt1hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjp1hM3hjq1ubah}(h]h ]h"]h$]h&]uh1jhjU1ubeh}(h]h ]h"]h$]h&]uh1jhjp1hM3hjR1ubj)}(h(``struct folio *folio`` folio to insert h](j)}(h``struct folio *folio``h]jS)}(hj1h]hstruct folio *folio}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj1ubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chM4hj1ubj)}(hhh]jM)}(hfolio to inserth]hfolio to insert}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj1hM4hj1ubah}(h]h ]h"]h$]h&]uh1jhj1ubeh}(h]h ]h"]h$]h&]uh1jhj1hM4hjR1ubj)}(h*``bool write`` whether it's a write fault h](j)}(h``bool write``h]jS)}(hj1h]h bool write}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj1ubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chM5hj1ubj)}(hhh]jM)}(hwhether it's a write faulth]hwhether it’s a write fault}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj1hM5hj1ubah}(h]h ]h"]h$]h&]uh1jhj1ubeh}(h]h ]h"]h$]h&]uh1jhj1hM5hjR1ubeh}(h]h ]h"]h$]h&]uh1jhj61ubjM)}(h **Return**h]j)}(hj2h]hReturn}(hj 2hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj2ubah}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chM7hj61ubjM)}(hvm_fault_t value.h]hvm_fault_t value.}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chM7hj61ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](htouch_pmd (C function) c.touch_pmdhNtauh1hhjKhhhNhNubh)}(hhh](h)}(hWbool touch_pmd (struct vm_area_struct *vma, unsigned long addr, pmd_t *pmd, bool write)h]h)}(hVbool touch_pmd(struct vm_area_struct *vma, unsigned long addr, pmd_t *pmd, bool write)h](j)}(hjh]hbool}(hjM2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjI2hhhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMLubj)}(h h]h }(hj[2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjI2hhhjZ2hMLubh)}(h touch_pmdh]j)}(h touch_pmdh]h touch_pmd}(hjm2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhji2ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjI2hhhjZ2hMLubj8)}(hH(struct vm_area_struct *vma, unsigned long addr, pmd_t *pmd, bool write)h](j>)}(hstruct vm_area_struct *vmah](j)}(hjJ,h]hstruct}(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2ubj)}(h h]h }(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2ubh)}(hhh]j)}(hvm_area_structh]hvm_area_struct}(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj2modnameN classnameNjj)}j]j)}jjo2sb c.touch_pmdasbuh1hhj2ubj)}(h h]h }(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2ubjr)}(hjuh]h*}(hj2hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj2ubj)}(hvmah]hvma}(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj2ubj>)}(hunsigned long addrh](j)}(hunsignedh]hunsigned}(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2ubj)}(h h]h }(hj 3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2ubj)}(hlongh]hlong}(hj3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2ubj)}(h h]h }(hj%3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2ubj)}(haddrh]haddr}(hj33hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj2ubj>)}(h pmd_t *pmdh](h)}(hhh]j)}(hpmd_th]hpmd_t}(hjO3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjL3ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjQ3modnameN classnameNjj)}j]j2 c.touch_pmdasbuh1hhjH3ubj)}(h h]h }(hjm3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjH3ubjr)}(hjuh]h*}(hj{3hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjH3ubj)}(hpmdh]hpmd}(hj3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjH3ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj2ubj>)}(h bool writeh](j)}(hjh]hbool}(hj3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3ubj)}(h h]h }(hj3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3ubj)}(hwriteh]hwrite}(hj3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj2ubeh}(h]h ]h"]h$]h&]jjuh1j7hjI2hhhjZ2hMLubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjE2hhhjZ2hMLubah}(h]j@2ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjZ2hMLhjB2hhubj4)}(hhh]jM)}(h;Mark page table pmd entry as accessed and dirty (for write)h]h;Mark page table pmd entry as accessed and dirty (for write)}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMLhj3hhubah}(h]h ]h"]h$]h&]uh1j3hjB2hhhjZ2hMLubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj3jHj3jIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct vm_area_struct *vma`` The VMA covering **addr** ``unsigned long addr`` The virtual address ``pmd_t *pmd`` pmd pointer into the page table mapping **addr** ``bool write`` Whether it's a write access **Return** whether the pmd entry is changedh](jM)}(h**Parameters**h]j)}(hj4h]h Parameters}(hj 4hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj4ubah}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMPhj4ubj)}(hhh](j)}(h9``struct vm_area_struct *vma`` The VMA covering **addr** h](j)}(h``struct vm_area_struct *vma``h]jS)}(hj'4h]hstruct vm_area_struct *vma}(hj)4hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj%4ubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMMhj!4ubj)}(hhh]jM)}(hThe VMA covering **addr**h](hThe VMA covering }(hj@4hhhNhNubj)}(h**addr**h]haddr}(hjH4hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj@4ubeh}(h]h ]h"]h$]h&]uh1jLhj<4hMMhj=4ubah}(h]h ]h"]h$]h&]uh1jhj!4ubeh}(h]h ]h"]h$]h&]uh1jhj<4hMMhj4ubj)}(h+``unsigned long addr`` The virtual address h](j)}(h``unsigned long addr``h]jS)}(hjn4h]hunsigned long addr}(hjp4hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjl4ubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMNhjh4ubj)}(hhh]jM)}(hThe virtual addressh]hThe virtual address}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj4hMNhj4ubah}(h]h ]h"]h$]h&]uh1jhjh4ubeh}(h]h ]h"]h$]h&]uh1jhj4hMNhj4ubj)}(h@``pmd_t *pmd`` pmd pointer into the page table mapping **addr** h](j)}(h``pmd_t *pmd``h]jS)}(hj4h]h pmd_t *pmd}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj4ubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMOhj4ubj)}(hhh]jM)}(h0pmd pointer into the page table mapping **addr**h](h(pmd pointer into the page table mapping }(hj4hhhNhNubj)}(h**addr**h]haddr}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj4ubeh}(h]h ]h"]h$]h&]uh1jLhj4hMOhj4ubah}(h]h ]h"]h$]h&]uh1jhj4ubeh}(h]h ]h"]h$]h&]uh1jhj4hMOhj4ubj)}(h+``bool write`` Whether it's a write access h](j)}(h``bool write``h]jS)}(hj4h]h bool write}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj4ubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMPhj4ubj)}(hhh]jM)}(hWhether it's a write accessh]hWhether it’s a write access}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj5hMPhj5ubah}(h]h ]h"]h$]h&]uh1jhj4ubeh}(h]h ]h"]h$]h&]uh1jhj5hMPhj4ubeh}(h]h ]h"]h$]h&]uh1jhj4ubjM)}(h **Return**h]j)}(hj)5h]hReturn}(hj+5hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj'5ubah}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMRhj4ubjM)}(h whether the pmd entry is changedh]h whether the pmd entry is changed}(hj?5hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMRhj4ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hzap_huge_pmd (C function)c.zap_huge_pmdhNtauh1hhjKhhhNhNubh)}(hhh](h)}(hfbool zap_huge_pmd (struct mmu_gather *tlb, struct vm_area_struct *vma, pmd_t *pmd, unsigned long addr)h]h)}(hebool zap_huge_pmd(struct mmu_gather *tlb, struct vm_area_struct *vma, pmd_t *pmd, unsigned long addr)h](j)}(hjh]hbool}(hjn5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjj5hhhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chM ubj)}(h h]h }(hj|5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjj5hhhj{5hM ubh)}(h zap_huge_pmdh]j)}(h zap_huge_pmdh]h zap_huge_pmd}(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5ubah}(h]h ](jjeh"]h$]h&]jjuh1hhjj5hhhj{5hM ubj8)}(hT(struct mmu_gather *tlb, struct vm_area_struct *vma, pmd_t *pmd, unsigned long addr)h](j>)}(hstruct mmu_gather *tlbh](j)}(hjJ,h]hstruct}(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5ubj)}(h h]h }(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5ubh)}(hhh]j)}(h mmu_gatherh]h mmu_gather}(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj5modnameN classnameNjj)}j]j)}jj5sbc.zap_huge_pmdasbuh1hhj5ubj)}(h h]h }(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5ubjr)}(hjuh]h*}(hj5hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj5ubj)}(htlbh]htlb}(hj6hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj5ubj>)}(hstruct vm_area_struct *vmah](j)}(hjJ,h]hstruct}(hj6hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj6ubj)}(h h]h }(hj)6hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj6ubh)}(hhh]j)}(hvm_area_structh]hvm_area_struct}(hj:6hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj76ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj<6modnameN classnameNjj)}j]j5c.zap_huge_pmdasbuh1hhj6ubj)}(h h]h }(hjX6hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj6ubjr)}(hjuh]h*}(hjf6hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj6ubj)}(hvmah]hvma}(hjs6hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj6ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj5ubj>)}(h pmd_t *pmdh](h)}(hhh]j)}(hpmd_th]hpmd_t}(hj6hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj6ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj6modnameN classnameNjj)}j]j5c.zap_huge_pmdasbuh1hhj6ubj)}(h h]h }(hj6hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj6ubjr)}(hjuh]h*}(hj6hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj6ubj)}(hpmdh]hpmd}(hj6hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj6ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj5ubj>)}(hunsigned long addrh](j)}(hunsignedh]hunsigned}(hj6hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj6ubj)}(h h]h }(hj6hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj6ubj)}(hlongh]hlong}(hj6hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj6ubj)}(h h]h }(hj 7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj6ubj)}(haddrh]haddr}(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj6ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj5ubeh}(h]h ]h"]h$]h&]jjuh1j7hjj5hhhj{5hM ubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjf5hhhj{5hM ubah}(h]ja5ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj{5hM hjc5hhubj4)}(hhh]jM)}(h$Zap a huge THP which is of PMD size.h]h$Zap a huge THP which is of PMD size.}(hjC7hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chM hj@7hhubah}(h]h ]h"]h$]h&]uh1j3hjc5hhhj{5hM ubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj[7jHj[7jIjJjKuh1hhhhjKhNhNubj)}(hXY**Parameters** ``struct mmu_gather *tlb`` The MMU gather TLB state associated with the operation. ``struct vm_area_struct *vma`` The VMA containing the range to zap. ``pmd_t *pmd`` A pointer to the leaf PMD entry. ``unsigned long addr`` The virtual address for the range to zap. **Return** ``true`` on success, ``false`` otherwise.h](jM)}(h**Parameters**h]j)}(hje7h]h Parameters}(hjg7hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjc7ubah}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chM hj_7ubj)}(hhh](j)}(hS``struct mmu_gather *tlb`` The MMU gather TLB state associated with the operation. h](j)}(h``struct mmu_gather *tlb``h]jS)}(hj7h]hstruct mmu_gather *tlb}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj7ubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chM hj~7ubj)}(hhh]jM)}(h7The MMU gather TLB state associated with the operation.h]h7The MMU gather TLB state associated with the operation.}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj7hM hj7ubah}(h]h ]h"]h$]h&]uh1jhj~7ubeh}(h]h ]h"]h$]h&]uh1jhj7hM hj{7ubj)}(hD``struct vm_area_struct *vma`` The VMA containing the range to zap. h](j)}(h``struct vm_area_struct *vma``h]jS)}(hj7h]hstruct vm_area_struct *vma}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj7ubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chM hj7ubj)}(hhh]jM)}(h$The VMA containing the range to zap.h]h$The VMA containing the range to zap.}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj7hM hj7ubah}(h]h ]h"]h$]h&]uh1jhj7ubeh}(h]h ]h"]h$]h&]uh1jhj7hM hj{7ubj)}(h0``pmd_t *pmd`` A pointer to the leaf PMD entry. h](j)}(h``pmd_t *pmd``h]jS)}(hj7h]h pmd_t *pmd}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj7ubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chM hj7ubj)}(hhh]jM)}(h A pointer to the leaf PMD entry.h]h A pointer to the leaf PMD entry.}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj 8hM hj 8ubah}(h]h ]h"]h$]h&]uh1jhj7ubeh}(h]h ]h"]h$]h&]uh1jhj 8hM hj{7ubj)}(hA``unsigned long addr`` The virtual address for the range to zap. h](j)}(h``unsigned long addr``h]jS)}(hj/8h]hunsigned long addr}(hj18hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj-8ubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chM hj)8ubj)}(hhh]jM)}(h)The virtual address for the range to zap.h]h)The virtual address for the range to zap.}(hjH8hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjD8hM hjE8ubah}(h]h ]h"]h$]h&]uh1jhj)8ubeh}(h]h ]h"]h$]h&]uh1jhjD8hM hj{7ubeh}(h]h ]h"]h$]h&]uh1jhj_7ubjM)}(h **Return**h]j)}(hjj8h]hReturn}(hjl8hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjh8ubah}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chM hj_7ubjM)}(h)``true`` on success, ``false`` otherwise.h](jS)}(h``true``h]htrue}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj8ubh on success, }(hj8hhhNhNubjS)}(h ``false``h]hfalse}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj8ubh otherwise.}(hj8hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chM hj_7ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h!__split_frozen_folio (C function)c.__split_frozen_foliohNtauh1hhjKhhhNhNubh)}(hhh](h)}(hint __split_frozen_folio (struct folio *folio, int new_order, struct page *split_at, struct xa_state *xas, enum split_type split_type)h]h)}(hint __split_frozen_folio(struct folio *folio, int new_order, struct page *split_at, struct xa_state *xas, enum split_type split_type)h](j)}(hinth]hint}(hj8hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj8hhhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMubj)}(h h]h }(hj8hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj8hhhj8hMubh)}(h__split_frozen_folioh]j)}(h__split_frozen_folioh]h__split_frozen_folio}(hj8hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj8ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj8hhhj8hMubj8)}(hm(struct folio *folio, int new_order, struct page *split_at, struct xa_state *xas, enum split_type split_type)h](j>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hj 9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9ubj)}(h h]h }(hj9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9ubh)}(hhh]j)}(hfolioh]hfolio}(hj*9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj'9ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj,9modnameN classnameNjj)}j]j)}jj8sbc.__split_frozen_folioasbuh1hhj9ubj)}(h h]h }(hjJ9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9ubjr)}(hjuh]h*}(hjX9hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj9ubj)}(hfolioh]hfolio}(hje9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj9ubj>)}(h int new_orderh](j)}(hinth]hint}(hj~9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjz9ubj)}(h h]h }(hj9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjz9ubj)}(h new_orderh]h new_order}(hj9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjz9ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj9ubj>)}(hstruct page *split_ath](j)}(hjJ,h]hstruct}(hj9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9ubj)}(h h]h }(hj9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9ubh)}(hhh]j)}(hpageh]hpage}(hj9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj9modnameN classnameNjj)}j]jF9c.__split_frozen_folioasbuh1hhj9ubj)}(h h]h }(hj9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9ubjr)}(hjuh]h*}(hj9hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj9ubj)}(hsplit_ath]hsplit_at}(hj :hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj9ubj>)}(hstruct xa_state *xash](j)}(hjJ,h]hstruct}(hj#:hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:ubj)}(h h]h }(hj0:hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:ubh)}(hhh]j)}(hxa_stateh]hxa_state}(hjA:hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>:ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjC:modnameN classnameNjj)}j]jF9c.__split_frozen_folioasbuh1hhj:ubj)}(h h]h }(hj_:hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:ubjr)}(hjuh]h*}(hjm:hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj:ubj)}(hxash]hxas}(hjz:hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj9ubj>)}(henum split_type split_typeh](j)}(hj#!h]henum}(hj:hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:ubj)}(h h]h }(hj:hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:ubh)}(hhh]j)}(h split_typeh]h split_type}(hj:hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj:modnameN classnameNjj)}j]jF9c.__split_frozen_folioasbuh1hhj:ubj)}(h h]h }(hj:hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:ubj)}(h split_typeh]h split_type}(hj:hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj9ubeh}(h]h ]h"]h$]h&]jjuh1j7hj8hhhj8hMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj8hhhj8hMubah}(h]j8ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj8hMhj8hhubj4)}(hhh]jM)}(h`splits a frozen **folio** to lower order folios in two ways: uniform split or non-uniform split.h](hsplits a frozen }(hj;hhhNhNubj)}(h **folio**h]hfolio}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj;ubhG to lower order folios in two ways: uniform split or non-uniform split.}(hj;hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMhj;hhubah}(h]h ]h"]h$]h&]uh1j3hj8hhhj8hMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj1;jHj1;jIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct folio *folio`` the to-be-split folio ``int new_order`` the smallest order of the after split folios (since buddy allocator like split generates folios with orders from **folio**'s order - 1 to new_order). ``struct page *split_at`` in buddy allocator like split, the folio containing **split_at** will be split until its order becomes **new_order**. ``struct xa_state *xas`` xa_state pointing to folio->mapping->i_pages and locked by caller ``enum split_type split_type`` if the split is uniform or not (buddy allocator like split) **Description** 1. uniform split: the given **folio** into multiple **new_order** small folios, where all small folios have the same order. This is done when split_type is SPLIT_TYPE_UNIFORM. 2. buddy allocator like (non-uniform) split: the given **folio** is split into half and one of the half (containing the given page) is split into half until the given **folio**'s order becomes **new_order**. This is done when split_type is SPLIT_TYPE_NON_UNIFORM. The high level flow for these two methods are: 1. uniform split: **xas** is split with no expectation of failure and a single __split_folio_to_order() is called to split the **folio** into **new_order** along with stats update. 2. non-uniform split: folio_order - **new_order** calls to __split_folio_to_order() are expected to be made in a for loop to split the **folio** to one lower order at a time. The folio containing **split_at** is split in each iteration. **xas** is split into half in each iteration and can fail. A failed **xas** split leaves split folios as is without merging them back. After splitting, the caller's folio reference will be transferred to the folio containing **split_at**. The caller needs to unlock and/or free after-split folios if necessary. **Return** 0 - successful, <0 - failed (if -ENOMEM is returned, **folio** might be split but not to **new_order**, the caller needs to check)h](jM)}(h**Parameters**h]j)}(hj;;h]h Parameters}(hj=;hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj9;ubah}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMhj5;ubj)}(hhh](j)}(h.``struct folio *folio`` the to-be-split folio h](j)}(h``struct folio *folio``h]jS)}(hjZ;h]hstruct folio *folio}(hj\;hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjX;ubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMhjT;ubj)}(hhh]jM)}(hthe to-be-split folioh]hthe to-be-split folio}(hjs;hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjo;hMhjp;ubah}(h]h ]h"]h$]h&]uh1jhjT;ubeh}(h]h ]h"]h$]h&]uh1jhjo;hMhjQ;ubj)}(h``int new_order`` the smallest order of the after split folios (since buddy allocator like split generates folios with orders from **folio**'s order - 1 to new_order). h](j)}(h``int new_order``h]jS)}(hj;h]h int new_order}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj;ubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMhj;ubj)}(hhh]jM)}(hthe smallest order of the after split folios (since buddy allocator like split generates folios with orders from **folio**'s order - 1 to new_order).h](hqthe smallest order of the after split folios (since buddy allocator like split generates folios with orders from }(hj;hhhNhNubj)}(h **folio**h]hfolio}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj;ubh’s order - 1 to new_order).}(hj;hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMhj;ubah}(h]h ]h"]h$]h&]uh1jhj;ubeh}(h]h ]h"]h$]h&]uh1jhj;hMhjQ;ubj)}(h``struct page *split_at`` in buddy allocator like split, the folio containing **split_at** will be split until its order becomes **new_order**. h](j)}(h``struct page *split_at``h]jS)}(hj;h]hstruct page *split_at}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj;ubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMhj;ubj)}(hhh]jM)}(huin buddy allocator like split, the folio containing **split_at** will be split until its order becomes **new_order**.h](h4in buddy allocator like split, the folio containing }(hj;hhhNhNubj)}(h **split_at**h]hsplit_at}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj;ubh' will be split until its order becomes }(hj;hhhNhNubj)}(h **new_order**h]h new_order}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj;ubh.}(hj;hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMhj;ubah}(h]h ]h"]h$]h&]uh1jhj;ubeh}(h]h ]h"]h$]h&]uh1jhj;hMhjQ;ubj)}(h[``struct xa_state *xas`` xa_state pointing to folio->mapping->i_pages and locked by caller h](j)}(h``struct xa_state *xas``h]jS)}(hj=<h]hstruct xa_state *xas}(hj?<hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj;<ubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMhj7<ubj)}(hhh]jM)}(hAxa_state pointing to folio->mapping->i_pages and locked by callerh]hAxa_state pointing to folio->mapping->i_pages and locked by caller}(hjV<hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjR<hMhjS<ubah}(h]h ]h"]h$]h&]uh1jhj7<ubeh}(h]h ]h"]h$]h&]uh1jhjR<hMhjQ;ubj)}(h[``enum split_type split_type`` if the split is uniform or not (buddy allocator like split) h](j)}(h``enum split_type split_type``h]jS)}(hjv<h]henum split_type split_type}(hjx<hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjt<ubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMhjp<ubj)}(hhh]jM)}(h;if the split is uniform or not (buddy allocator like split)h]h;if the split is uniform or not (buddy allocator like split)}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj<hMhj<ubah}(h]h ]h"]h$]h&]uh1jhjp<ubeh}(h]h ]h"]h$]h&]uh1jhj<hMhjQ;ubeh}(h]h ]h"]h$]h&]uh1jhj5;ubjM)}(h**Description**h]j)}(hj<h]h Description}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj<ubah}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMhj5;ubjM)}(hhh](jc)}(huniform split: the given **folio** into multiple **new_order** small folios, where all small folios have the same order. This is done when split_type is SPLIT_TYPE_UNIFORM.h]jM)}(huniform split: the given **folio** into multiple **new_order** small folios, where all small folios have the same order. This is done when split_type is SPLIT_TYPE_UNIFORM.h](huniform split: the given }(hj<hhhNhNubj)}(h **folio**h]hfolio}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj<ubh into multiple }(hj<hhhNhNubj)}(h **new_order**h]h new_order}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj<ubhn small folios, where all small folios have the same order. This is done when split_type is SPLIT_TYPE_UNIFORM.}(hj<hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMhj<ubah}(h]h ]h"]h$]h&]uh1jbhj<ubjc)}(hXbuddy allocator like (non-uniform) split: the given **folio** is split into half and one of the half (containing the given page) is split into half until the given **folio**'s order becomes **new_order**. This is done when split_type is SPLIT_TYPE_NON_UNIFORM. h]jM)}(hXbuddy allocator like (non-uniform) split: the given **folio** is split into half and one of the half (containing the given page) is split into half until the given **folio**'s order becomes **new_order**. This is done when split_type is SPLIT_TYPE_NON_UNIFORM.h](h4buddy allocator like (non-uniform) split: the given }(hj =hhhNhNubj)}(h **folio**h]hfolio}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj =ubhg is split into half and one of the half (containing the given page) is split into half until the given }(hj =hhhNhNubj)}(h **folio**h]hfolio}(hj%=hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj =ubh’s order becomes }(hj =hhhNhNubj)}(h **new_order**h]h new_order}(hj7=hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj =ubh9. This is done when split_type is SPLIT_TYPE_NON_UNIFORM.}(hj =hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMhj=ubah}(h]h ]h"]h$]h&]uh1jbhj<ubeh}(h]h ]h"]h$]h&]j?Nj@NjANhjBNjCNuh1jMhj5;ubjM)}(h.The high level flow for these two methods are:h]h.The high level flow for these two methods are:}(hj\=hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMhj5;ubjM)}(hhh](jc)}(huniform split: **xas** is split with no expectation of failure and a single __split_folio_to_order() is called to split the **folio** into **new_order** along with stats update.h]jM)}(huniform split: **xas** is split with no expectation of failure and a single __split_folio_to_order() is called to split the **folio** into **new_order** along with stats update.h](huniform split: }(hjr=hhhNhNubj)}(h**xas**h]hxas}(hjz=hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjr=ubhf is split with no expectation of failure and a single __split_folio_to_order() is called to split the }(hjr=hhhNhNubj)}(h **folio**h]hfolio}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjr=ubh into }(hjr=hhhNhNubj)}(h **new_order**h]h new_order}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjr=ubh along with stats update.}(hjr=hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMhjn=ubah}(h]h ]h"]h$]h&]uh1jbhjk=ubjc)}(hXqnon-uniform split: folio_order - **new_order** calls to __split_folio_to_order() are expected to be made in a for loop to split the **folio** to one lower order at a time. The folio containing **split_at** is split in each iteration. **xas** is split into half in each iteration and can fail. A failed **xas** split leaves split folios as is without merging them back. h]jM)}(hXpnon-uniform split: folio_order - **new_order** calls to __split_folio_to_order() are expected to be made in a for loop to split the **folio** to one lower order at a time. The folio containing **split_at** is split in each iteration. **xas** is split into half in each iteration and can fail. A failed **xas** split leaves split folios as is without merging them back.h](h!non-uniform split: folio_order - }(hj=hhhNhNubj)}(h **new_order**h]h new_order}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj=ubhV calls to __split_folio_to_order() are expected to be made in a for loop to split the }(hj=hhhNhNubj)}(h **folio**h]hfolio}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj=ubh4 to one lower order at a time. The folio containing }(hj=hhhNhNubj)}(h **split_at**h]hsplit_at}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj=ubh is split in each iteration. }(hj=hhhNhNubj)}(h**xas**h]hxas}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj=ubh= is split into half in each iteration and can fail. A failed }(hj=hhhNhNubj)}(h**xas**h]hxas}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj=ubh; split leaves split folios as is without merging them back.}(hj=hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMhj=ubah}(h]h ]h"]h$]h&]uh1jbhjk=ubeh}(h]h ]h"]h$]h&]j?Nj@NjANhjBNjCNuh1jMhj5;ubjM)}(hAfter splitting, the caller's folio reference will be transferred to the folio containing **split_at**. The caller needs to unlock and/or free after-split folios if necessary.h](h\After splitting, the caller’s folio reference will be transferred to the folio containing }(hj6>hhhNhNubj)}(h **split_at**h]hsplit_at}(hj>>hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj6>ubhI. The caller needs to unlock and/or free after-split folios if necessary.}(hj6>hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMhj5;ubjM)}(h **Return**h]j)}(hjY>h]hReturn}(hj[>hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjW>ubah}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMhj5;ubjM)}(h0 - successful, <0 - failed (if -ENOMEM is returned, **folio** might be split but not to **new_order**, the caller needs to check)h](h50 - successful, <0 - failed (if -ENOMEM is returned, }(hjo>hhhNhNubj)}(h **folio**h]hfolio}(hjw>hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjo>ubh might be split but not to }(hjo>hhhNhNubj)}(h **new_order**h]h new_order}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjo>ubh, the caller needs to check)}(hjo>hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMhj5;ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h#folio_check_splittable (C function)c.folio_check_splittablehNtauh1hhjKhhhNhNubh)}(hhh](h)}(hdint folio_check_splittable (struct folio *folio, unsigned int new_order, enum split_type split_type)h]h)}(hcint folio_check_splittable(struct folio *folio, unsigned int new_order, enum split_type split_type)h](j)}(hinth]hint}(hj>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>hhhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMOubj)}(h h]h }(hj>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>hhhj>hMOubh)}(hfolio_check_splittableh]j)}(hfolio_check_splittableh]hfolio_check_splittable}(hj>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>ubah}(h]h ](jjeh"]h$]h&]jjuh1hhj>hhhj>hMOubj8)}(hI(struct folio *folio, unsigned int new_order, enum split_type split_type)h](j>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hj>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>ubj)}(h h]h }(hj ?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>ubh)}(hhh]j)}(hfolioh]hfolio}(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj?modnameN classnameNjj)}j]j)}jj>sbc.folio_check_splittableasbuh1hhj>ubj)}(h h]h }(hj=?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>ubjr)}(hjuh]h*}(hjK?hhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj>ubj)}(hfolioh]hfolio}(hjX?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj>ubj>)}(hunsigned int new_orderh](j)}(hunsignedh]hunsigned}(hjq?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjm?ubj)}(h h]h }(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjm?ubj)}(hinth]hint}(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjm?ubj)}(h h]h }(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjm?ubj)}(h new_orderh]h new_order}(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjm?ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj>ubj>)}(henum split_type split_typeh](j)}(hj#!h]henum}(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?ubj)}(h h]h }(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?ubh)}(hhh]j)}(h split_typeh]h split_type}(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?ubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj?modnameN classnameNjj)}j]j9?c.folio_check_splittableasbuh1hhj?ubj)}(h h]h }(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?ubj)}(h split_typeh]h split_type}(hj @hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?ubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hj>ubeh}(h]h ]h"]h$]h&]jjuh1j7hj>hhhj>hMOubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj>hhhj>hMOubah}(h]j>ah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj>hMOhj>hhubj4)}(hhh]jM)}(h.check if a folio can be split to a given orderh]h.check if a folio can be split to a given order}(hj6@hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMOhj3@hhubah}(h]h ]h"]h$]h&]uh1j3hj>hhhj>hMOubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjN@jHjN@jIjJjKuh1hhhhjKhNhNubj)}(hX\**Parameters** ``struct folio *folio`` folio to be split ``unsigned int new_order`` the smallest order of the after split folios (since buddy allocator like split generates folios with orders from **folio**'s order - 1 to new_order). ``enum split_type split_type`` uniform or non-uniform split **Description** folio_check_splittable() checks if **folio** can be split to **new_order** using **split_type** method. The truncated folio check must come first. **Context** folio must be locked. **Return** 0 - **folio** can be split to **new_order**, otherwise an error number is returned.h](jM)}(h**Parameters**h]j)}(hjX@h]h Parameters}(hjZ@hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjV@ubah}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMShjR@ubj)}(hhh](j)}(h*``struct folio *folio`` folio to be split h](j)}(h``struct folio *folio``h]jS)}(hjw@h]hstruct folio *folio}(hjy@hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhju@ubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMPhjq@ubj)}(hhh]jM)}(hfolio to be splith]hfolio to be split}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj@hMPhj@ubah}(h]h ]h"]h$]h&]uh1jhjq@ubeh}(h]h ]h"]h$]h&]uh1jhj@hMPhjn@ubj)}(h``unsigned int new_order`` the smallest order of the after split folios (since buddy allocator like split generates folios with orders from **folio**'s order - 1 to new_order). h](j)}(h``unsigned int new_order``h]jS)}(hj@h]hunsigned int new_order}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj@ubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMShj@ubj)}(hhh]jM)}(hthe smallest order of the after split folios (since buddy allocator like split generates folios with orders from **folio**'s order - 1 to new_order).h](hqthe smallest order of the after split folios (since buddy allocator like split generates folios with orders from }(hj@hhhNhNubj)}(h **folio**h]hfolio}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj@ubh’s order - 1 to new_order).}(hj@hhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMQhj@ubah}(h]h ]h"]h$]h&]uh1jhj@ubeh}(h]h ]h"]h$]h&]uh1jhj@hMShjn@ubj)}(h<``enum split_type split_type`` uniform or non-uniform split h](j)}(h``enum split_type split_type``h]jS)}(hj@h]henum split_type split_type}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj@ubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMThj@ubj)}(hhh]jM)}(huniform or non-uniform splith]huniform or non-uniform split}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjAhMThjAubah}(h]h ]h"]h$]h&]uh1jhj@ubeh}(h]h ]h"]h$]h&]uh1jhjAhMThjn@ubeh}(h]h ]h"]h$]h&]uh1jhjR@ubjM)}(h**Description**h]j)}(hj7Ah]h Description}(hj9AhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj5Aubah}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMVhjR@ubjM)}(hfolio_check_splittable() checks if **folio** can be split to **new_order** using **split_type** method. The truncated folio check must come first.h](h#folio_check_splittable() checks if }(hjMAhhhNhNubj)}(h **folio**h]hfolio}(hjUAhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjMAubh can be split to }(hjMAhhhNhNubj)}(h **new_order**h]h new_order}(hjgAhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjMAubh using }(hjMAhhhNhNubj)}(h**split_type**h]h split_type}(hjyAhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjMAubh3 method. The truncated folio check must come first.}(hjMAhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMUhjR@ubjM)}(h **Context**h]j)}(hjAh]hContext}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjAubah}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMXhjR@ubjM)}(hfolio must be locked.h]hfolio must be locked.}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMYhjR@ubjM)}(h **Return**h]j)}(hjAh]hReturn}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjAubah}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chM[hjR@ubjM)}(hS0 - **folio** can be split to **new_order**, otherwise an error number is returned.h](h0 - }(hjAhhhNhNubj)}(h **folio**h]hfolio}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjAubh can be split to }(hjAhhhNhNubj)}(h **new_order**h]h new_order}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjAubh(, otherwise an error number is returned.}(hjAhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chM[hjR@ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h__folio_split (C function)c.__folio_splithNtauh1hhjKhhhNhNubh)}(hhh](h)}(hint __folio_split (struct folio *folio, unsigned int new_order, struct page *split_at, struct page *lock_at, struct list_head *list, enum split_type split_type)h]h)}(hint __folio_split(struct folio *folio, unsigned int new_order, struct page *split_at, struct page *lock_at, struct list_head *list, enum split_type split_type)h](j)}(hinth]hint}(hj$BhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj BhhhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMubj)}(h h]h }(hj3BhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj Bhhhj2BhMubh)}(h __folio_splith]j)}(h __folio_splith]h __folio_split}(hjEBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjABubah}(h]h ](jjeh"]h$]h&]jjuh1hhj Bhhhj2BhMubj8)}(h(struct folio *folio, unsigned int new_order, struct page *split_at, struct page *lock_at, struct list_head *list, enum split_type split_type)h](j>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hjaBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj]Bubj)}(h h]h }(hjnBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj]Bubh)}(hhh]j)}(hfolioh]hfolio}(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|Bubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjBmodnameN classnameNjj)}j]j)}jjGBsbc.__folio_splitasbuh1hhj]Bubj)}(h h]h }(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj]Bubjr)}(hjuh]h*}(hjBhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj]Bubj)}(hfolioh]hfolio}(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj]Bubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjYBubj>)}(hunsigned int new_orderh](j)}(hunsignedh]hunsigned}(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubj)}(h h]h }(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubj)}(hinth]hint}(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubj)}(h h]h }(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubj)}(h new_orderh]h new_order}(hj ChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjYBubj>)}(hstruct page *split_ath](j)}(hjJ,h]hstruct}(hj$ChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj Cubj)}(h h]h }(hj1ChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj Cubh)}(hhh]j)}(hpageh]hpage}(hjBChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?Cubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjDCmodnameN classnameNjj)}j]jBc.__folio_splitasbuh1hhj Cubj)}(h h]h }(hj`ChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj Cubjr)}(hjuh]h*}(hjnChhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj Cubj)}(hsplit_ath]hsplit_at}(hj{ChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj Cubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjYBubj>)}(hstruct page *lock_ath](j)}(hjJ,h]hstruct}(hjChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCubj)}(h h]h }(hjChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCubh)}(hhh]j)}(hpageh]hpage}(hjChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjCmodnameN classnameNjj)}j]jBc.__folio_splitasbuh1hhjCubj)}(h h]h }(hjChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCubjr)}(hjuh]h*}(hjChhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjCubj)}(hlock_ath]hlock_at}(hjChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjYBubj>)}(hstruct list_head *listh](j)}(hjJ,h]hstruct}(hjDhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjDubj)}(h h]h }(hjDhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjDubh)}(hhh]j)}(h list_headh]h list_head}(hj"DhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjDubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetj$DmodnameN classnameNjj)}j]jBc.__folio_splitasbuh1hhjDubj)}(h h]h }(hj@DhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjDubjr)}(hjuh]h*}(hjNDhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjDubj)}(hlisth]hlist}(hj[DhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjDubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjYBubj>)}(henum split_type split_typeh](j)}(hj#!h]henum}(hjtDhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpDubj)}(h h]h }(hjDhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpDubh)}(hhh]j)}(h split_typeh]h split_type}(hjDhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjDubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjDmodnameN classnameNjj)}j]jBc.__folio_splitasbuh1hhjpDubj)}(h h]h }(hjDhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpDubj)}(h split_typeh]h split_type}(hjDhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpDubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjYBubeh}(h]h ]h"]h$]h&]jjuh1j7hj Bhhhj2BhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjBhhhj2BhMubah}(h]jBah ](j+j,eh"]h$]h&]j0j1)j2huh1hhj2BhMhjBhhubj4)}(hhh]jM)}(h6split a folio at **split_at** to a **new_order** folioh](hsplit a folio at }(hjDhhhNhNubj)}(h **split_at**h]hsplit_at}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjDubh to a }(hjDhhhNhNubj)}(h **new_order**h]h new_order}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjDubh folio}(hjDhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMhjDhhubah}(h]h ]h"]h$]h&]uh1j3hjBhhhj2BhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj$EjHj$EjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct folio *folio`` folio to split ``unsigned int new_order`` the order of the new folio ``struct page *split_at`` a page within the new folio ``struct page *lock_at`` a page within **folio** to be left locked to caller ``struct list_head *list`` after-split folios will be put on it if non NULL ``enum split_type split_type`` perform uniform split or not (non-uniform split) **Description** It calls __split_frozen_folio() to perform uniform and non-uniform split. It is in charge of checking whether the split is supported or not and preparing **folio** for __split_frozen_folio(). After splitting, the after-split folio containing **lock_at** remains locked and others are unlocked: 1. for uniform split, **lock_at** points to one of **folio**'s subpages; 2. for buddy allocator like (non-uniform) split, **lock_at** points to **folio**. **Return** 0 - successful, <0 - failed (if -ENOMEM is returned, **folio** might be split but not to **new_order**, the caller needs to check)h](jM)}(h**Parameters**h]j)}(hj.Eh]h Parameters}(hj0EhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj,Eubah}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMhj(Eubj)}(hhh](j)}(h'``struct folio *folio`` folio to split h](j)}(h``struct folio *folio``h]jS)}(hjMEh]hstruct folio *folio}(hjOEhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjKEubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMhjGEubj)}(hhh]jM)}(hfolio to splith]hfolio to split}(hjfEhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjbEhMhjcEubah}(h]h ]h"]h$]h&]uh1jhjGEubeh}(h]h ]h"]h$]h&]uh1jhjbEhMhjDEubj)}(h6``unsigned int new_order`` the order of the new folio h](j)}(h``unsigned int new_order``h]jS)}(hjEh]hunsigned int new_order}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjEubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMhjEubj)}(hhh]jM)}(hthe order of the new folioh]hthe order of the new folio}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjEhMhjEubah}(h]h ]h"]h$]h&]uh1jhjEubeh}(h]h ]h"]h$]h&]uh1jhjEhMhjDEubj)}(h6``struct page *split_at`` a page within the new folio h](j)}(h``struct page *split_at``h]jS)}(hjEh]hstruct page *split_at}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjEubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMhjEubj)}(hhh]jM)}(ha page within the new folioh]ha page within the new folio}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjEhMhjEubah}(h]h ]h"]h$]h&]uh1jhjEubeh}(h]h ]h"]h$]h&]uh1jhjEhMhjDEubj)}(hM``struct page *lock_at`` a page within **folio** to be left locked to caller h](j)}(h``struct page *lock_at``h]jS)}(hjEh]hstruct page *lock_at}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjEubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMhjEubj)}(hhh]jM)}(h3a page within **folio** to be left locked to callerh](ha page within }(hjFhhhNhNubj)}(h **folio**h]hfolio}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjFubh to be left locked to caller}(hjFhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhj FhMhjFubah}(h]h ]h"]h$]h&]uh1jhjEubeh}(h]h ]h"]h$]h&]uh1jhj FhMhjDEubj)}(hL``struct list_head *list`` after-split folios will be put on it if non NULL h](j)}(h``struct list_head *list``h]jS)}(hjCFh]hstruct list_head *list}(hjEFhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjAFubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMhj=Fubj)}(hhh]jM)}(h0after-split folios will be put on it if non NULLh]h0after-split folios will be put on it if non NULL}(hj\FhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjXFhMhjYFubah}(h]h ]h"]h$]h&]uh1jhj=Fubeh}(h]h ]h"]h$]h&]uh1jhjXFhMhjDEubj)}(hP``enum split_type split_type`` perform uniform split or not (non-uniform split) h](j)}(h``enum split_type split_type``h]jS)}(hj|Fh]henum split_type split_type}(hj~FhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjzFubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMhjvFubj)}(hhh]jM)}(h0perform uniform split or not (non-uniform split)h]h0perform uniform split or not (non-uniform split)}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjFhMhjFubah}(h]h ]h"]h$]h&]uh1jhjvFubeh}(h]h ]h"]h$]h&]uh1jhjFhMhjDEubeh}(h]h ]h"]h$]h&]uh1jhj(EubjM)}(h**Description**h]j)}(hjFh]h Description}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjFubah}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMhj(EubjM)}(hIt calls __split_frozen_folio() to perform uniform and non-uniform split. It is in charge of checking whether the split is supported or not and preparing **folio** for __split_frozen_folio().h](hIt calls __split_frozen_folio() to perform uniform and non-uniform split. It is in charge of checking whether the split is supported or not and preparing }(hjFhhhNhNubj)}(h **folio**h]hfolio}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjFubh for __split_frozen_folio().}(hjFhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMhj(EubjM)}(hXAfter splitting, the after-split folio containing **lock_at** remains locked and others are unlocked: 1. for uniform split, **lock_at** points to one of **folio**'s subpages; 2. for buddy allocator like (non-uniform) split, **lock_at** points to **folio**.h](h2After splitting, the after-split folio containing }(hjFhhhNhNubj)}(h **lock_at**h]hlock_at}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjFubh? remains locked and others are unlocked: 1. for uniform split, }(hjFhhhNhNubj)}(h **lock_at**h]hlock_at}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjFubh points to one of }(hjFhhhNhNubj)}(h **folio**h]hfolio}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjFubh@’s subpages; 2. for buddy allocator like (non-uniform) split, }(hjFhhhNhNubj)}(h **lock_at**h]hlock_at}(hj,GhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjFubh points to }(hjFhhhNhNubj)}(h **folio**h]hfolio}(hj>GhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjFubh.}(hjFhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMhj(EubjM)}(h **Return**h]j)}(hjYGh]hReturn}(hj[GhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjWGubah}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMhj(EubjM)}(h0 - successful, <0 - failed (if -ENOMEM is returned, **folio** might be split but not to **new_order**, the caller needs to check)h](h50 - successful, <0 - failed (if -ENOMEM is returned, }(hjoGhhhNhNubj)}(h **folio**h]hfolio}(hjwGhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjoGubh might be split but not to }(hjoGhhhNhNubj)}(h **new_order**h]h new_order}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjoGubh, the caller needs to check)}(hjoGhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMhj(Eubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h!folio_split_unmapped (C function)c.folio_split_unmappedhNtauh1hhjKhhhNhNubh)}(hhh](h)}(hFint folio_split_unmapped (struct folio *folio, unsigned int new_order)h]h)}(hEint folio_split_unmapped(struct folio *folio, unsigned int new_order)h](j)}(hinth]hint}(hjGhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGhhhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMubj)}(h h]h }(hjGhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGhhhjGhMubh)}(hfolio_split_unmappedh]j)}(hfolio_split_unmappedh]hfolio_split_unmapped}(hjGhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGubah}(h]h ](jjeh"]h$]h&]jjuh1hhjGhhhjGhMubj8)}(h-(struct folio *folio, unsigned int new_order)h](j>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hjGhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGubj)}(h h]h }(hj HhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGubh)}(hhh]j)}(hfolioh]hfolio}(hjHhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjHmodnameN classnameNjj)}j]j)}jjGsbc.folio_split_unmappedasbuh1hhjGubj)}(h h]h }(hj=HhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGubjr)}(hjuh]h*}(hjKHhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjGubj)}(hfolioh]hfolio}(hjXHhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjGubj>)}(hunsigned int new_orderh](j)}(hunsignedh]hunsigned}(hjqHhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmHubj)}(h h]h }(hjHhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmHubj)}(hinth]hint}(hjHhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmHubj)}(h h]h }(hjHhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmHubj)}(h new_orderh]h new_order}(hjHhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmHubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjGubeh}(h]h ]h"]h$]h&]jjuh1j7hjGhhhjGhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjGhhhjGhMubah}(h]jGah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjGhMhjGhhubj4)}(hhh]jM)}(h1split a large anon folio that is already unmappedh]h1split a large anon folio that is already unmapped}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMhjHhhubah}(h]h ]h"]h$]h&]uh1j3hjGhhhjGhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjHjHjHjIjJjKuh1hhhhjKhNhNubj)}(hX**Parameters** ``struct folio *folio`` folio to split ``unsigned int new_order`` the order of folios after split **Description** This function is a helper for splitting folios that have already been unmapped. The use case is that the device or the CPU can refuse to migrate THP pages in the middle of migration, due to allocation issues on either side. The anon rmap lock is not required to be held, mmap_read_lock() or mmap_write_lock() should be held. **folio** is expected to be locked by the caller. device-private and non device-private folios are supported along with folios that are in the swapcache. **folio** should also be unmapped and isolated from LRU (if applicable) Upon return, the folio is not remapped, split folios are not added to LRU, folio_free_swap() is not called, and new folios remain locked. **Return** 0 on success, -EAGAIN if the folio cannot be split (e.g., due to insufficient reference count or extra pins).h](jM)}(h**Parameters**h]j)}(hjHh]h Parameters}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjHubah}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMhjHubj)}(hhh](j)}(h'``struct folio *folio`` folio to split h](j)}(h``struct folio *folio``h]jS)}(hjIh]hstruct folio *folio}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjIubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMhjIubj)}(hhh]jM)}(hfolio to splith]hfolio to split}(hj-IhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj)IhMhj*Iubah}(h]h ]h"]h$]h&]uh1jhjIubeh}(h]h ]h"]h$]h&]uh1jhj)IhMhj Iubj)}(h;``unsigned int new_order`` the order of folios after split h](j)}(h``unsigned int new_order``h]jS)}(hjMIh]hunsigned int new_order}(hjOIhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjKIubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMhjGIubj)}(hhh]jM)}(hthe order of folios after splith]hthe order of folios after split}(hjfIhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjbIhMhjcIubah}(h]h ]h"]h$]h&]uh1jhjGIubeh}(h]h ]h"]h$]h&]uh1jhjbIhMhj Iubeh}(h]h ]h"]h$]h&]uh1jhjHubjM)}(h**Description**h]j)}(hjIh]h Description}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjIubah}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMhjHubjM)}(hThis function is a helper for splitting folios that have already been unmapped. The use case is that the device or the CPU can refuse to migrate THP pages in the middle of migration, due to allocation issues on either side.h]hThis function is a helper for splitting folios that have already been unmapped. The use case is that the device or the CPU can refuse to migrate THP pages in the middle of migration, due to allocation issues on either side.}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMhjHubjM)}(hXFThe anon rmap lock is not required to be held, mmap_read_lock() or mmap_write_lock() should be held. **folio** is expected to be locked by the caller. device-private and non device-private folios are supported along with folios that are in the swapcache. **folio** should also be unmapped and isolated from LRU (if applicable)h](heThe anon rmap lock is not required to be held, mmap_read_lock() or mmap_write_lock() should be held. }(hjIhhhNhNubj)}(h **folio**h]hfolio}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjIubh is expected to be locked by the caller. device-private and non device-private folios are supported along with folios that are in the swapcache. }(hjIhhhNhNubj)}(h **folio**h]hfolio}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjIubh> should also be unmapped and isolated from LRU (if applicable)}(hjIhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMhjHubjM)}(hUpon return, the folio is not remapped, split folios are not added to LRU, folio_free_swap() is not called, and new folios remain locked.h]hUpon return, the folio is not remapped, split folios are not added to LRU, folio_free_swap() is not called, and new folios remain locked.}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMhjHubjM)}(h **Return**h]j)}(hjIh]hReturn}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjIubah}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMhjHubjM)}(hm0 on success, -EAGAIN if the folio cannot be split (e.g., due to insufficient reference count or extra pins).h]hm0 on success, -EAGAIN if the folio cannot be split (e.g., due to insufficient reference count or extra pins).}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chM hjHubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](hfolio_split (C function) c.folio_splithNtauh1hhjKhhhNhNubh)}(hhh](h)}(hlint folio_split (struct folio *folio, unsigned int new_order, struct page *split_at, struct list_head *list)h]h)}(hkint folio_split(struct folio *folio, unsigned int new_order, struct page *split_at, struct list_head *list)h](j)}(hinth]hint}(hj6JhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2JhhhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMgubj)}(h h]h }(hjEJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2JhhhjDJhMgubh)}(h folio_splith]j)}(h folio_splith]h folio_split}(hjWJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSJubah}(h]h ](jjeh"]h$]h&]jjuh1hhj2JhhhjDJhMgubj8)}(h\(struct folio *folio, unsigned int new_order, struct page *split_at, struct list_head *list)h](j>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hjsJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjoJubj)}(h h]h }(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjoJubh)}(hhh]j)}(hfolioh]hfolio}(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjJmodnameN classnameNjj)}j]j)}jjYJsb c.folio_splitasbuh1hhjoJubj)}(h h]h }(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjoJubjr)}(hjuh]h*}(hjJhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjoJubj)}(hfolioh]hfolio}(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjoJubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjkJubj>)}(hunsigned int new_orderh](j)}(hunsignedh]hunsigned}(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJubj)}(h h]h }(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJubj)}(hinth]hint}(hjKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJubj)}(h h]h }(hjKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJubj)}(h new_orderh]h new_order}(hjKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjkJubj>)}(hstruct page *split_ath](j)}(hjJ,h]hstruct}(hj6KhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2Kubj)}(h h]h }(hjCKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2Kubh)}(hhh]j)}(hpageh]hpage}(hjTKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjQKubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjVKmodnameN classnameNjj)}j]jJ c.folio_splitasbuh1hhj2Kubj)}(h h]h }(hjrKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2Kubjr)}(hjuh]h*}(hjKhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhj2Kubj)}(hsplit_ath]hsplit_at}(hjKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2Kubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjkJubj>)}(hstruct list_head *listh](j)}(hjJ,h]hstruct}(hjKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjKubj)}(h h]h }(hjKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjKubh)}(hhh]j)}(h list_headh]h list_head}(hjKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjKubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjKmodnameN classnameNjj)}j]jJ c.folio_splitasbuh1hhjKubj)}(h h]h }(hjKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjKubjr)}(hjuh]h*}(hjKhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjKubj)}(hlisth]hlist}(hjKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjKubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjkJubeh}(h]h ]h"]h$]h&]jjuh1j7hj2JhhhjDJhMgubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hj.JhhhjDJhMgubah}(h]j)Jah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjDJhMghj+Jhhubj4)}(hhh]jM)}(h6split a folio at **split_at** to a **new_order** folioh](hsplit a folio at }(hj'LhhhNhNubj)}(h **split_at**h]hsplit_at}(hj/LhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj'Lubh to a }(hj'LhhhNhNubj)}(h **new_order**h]h new_order}(hjALhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj'Lubh folio}(hj'LhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMghj$Lhhubah}(h]h ]h"]h$]h&]uh1j3hj+JhhhjDJhMgubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGjcLjHjcLjIjJjKuh1hhhhjKhNhNubj)}(hX&**Parameters** ``struct folio *folio`` folio to split ``unsigned int new_order`` the order of the new folio ``struct page *split_at`` a page within the new folio ``struct list_head *list`` after-split folios are added to **list** if not null, otherwise to LRU list **Description** It has the same prerequisites and returns as split_huge_page_to_list_to_order(). Split a folio at **split_at** to a new_order folio, leave the remaining subpages of the original folio as large as possible. For example, in the case of splitting an order-9 folio at its third order-3 subpages to an order-3 folio, there are 2^(9-3)=64 order-3 subpages in the order-9 folio. After the split, there will be a group of folios with different orders and the new folio containing **split_at** is marked in bracket: [order-4, {order-3}, order-3, order-5, order-6, order-7, order-8]. After split, folio is left locked for caller. **Return** 0 - successful, <0 - failed (if -ENOMEM is returned, **folio** might be split but not to **new_order**, the caller needs to check)h](jM)}(h**Parameters**h]j)}(hjmLh]h Parameters}(hjoLhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjkLubah}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMkhjgLubj)}(hhh](j)}(h'``struct folio *folio`` folio to split h](j)}(h``struct folio *folio``h]jS)}(hjLh]hstruct folio *folio}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjLubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMhhjLubj)}(hhh]jM)}(hfolio to splith]hfolio to split}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjLhMhhjLubah}(h]h ]h"]h$]h&]uh1jhjLubeh}(h]h ]h"]h$]h&]uh1jhjLhMhhjLubj)}(h6``unsigned int new_order`` the order of the new folio h](j)}(h``unsigned int new_order``h]jS)}(hjLh]hunsigned int new_order}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjLubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMihjLubj)}(hhh]jM)}(hthe order of the new folioh]hthe order of the new folio}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjLhMihjLubah}(h]h ]h"]h$]h&]uh1jhjLubeh}(h]h ]h"]h$]h&]uh1jhjLhMihjLubj)}(h6``struct page *split_at`` a page within the new folio h](j)}(h``struct page *split_at``h]jS)}(hjLh]hstruct page *split_at}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjLubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMjhjLubj)}(hhh]jM)}(ha page within the new folioh]ha page within the new folio}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjMhMjhjMubah}(h]h ]h"]h$]h&]uh1jhjLubeh}(h]h ]h"]h$]h&]uh1jhjMhMjhjLubj)}(hg``struct list_head *list`` after-split folios are added to **list** if not null, otherwise to LRU list h](j)}(h``struct list_head *list``h]jS)}(hj7Mh]hstruct list_head *list}(hj9MhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhj5Mubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMlhj1Mubj)}(hhh]jM)}(hKafter-split folios are added to **list** if not null, otherwise to LRU listh](h after-split folios are added to }(hjPMhhhNhNubj)}(h**list**h]hlist}(hjXMhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjPMubh# if not null, otherwise to LRU list}(hjPMhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMkhjMMubah}(h]h ]h"]h$]h&]uh1jhj1Mubeh}(h]h ]h"]h$]h&]uh1jhjLMhMlhjLubeh}(h]h ]h"]h$]h&]uh1jhjgLubjM)}(h**Description**h]j)}(hjMh]h Description}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjMubah}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMnhjgLubjM)}(hPIt has the same prerequisites and returns as split_huge_page_to_list_to_order().h]hPIt has the same prerequisites and returns as split_huge_page_to_list_to_order().}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMmhjgLubjM)}(hXSplit a folio at **split_at** to a new_order folio, leave the remaining subpages of the original folio as large as possible. For example, in the case of splitting an order-9 folio at its third order-3 subpages to an order-3 folio, there are 2^(9-3)=64 order-3 subpages in the order-9 folio. After the split, there will be a group of folios with different orders and the new folio containing **split_at** is marked in bracket: [order-4, {order-3}, order-3, order-5, order-6, order-7, order-8].h](hSplit a folio at }(hjMhhhNhNubj)}(h **split_at**h]hsplit_at}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjMubhXj to a new_order folio, leave the remaining subpages of the original folio as large as possible. For example, in the case of splitting an order-9 folio at its third order-3 subpages to an order-3 folio, there are 2^(9-3)=64 order-3 subpages in the order-9 folio. After the split, there will be a group of folios with different orders and the new folio containing }(hjMhhhNhNubj)}(h **split_at**h]hsplit_at}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjMubhY is marked in bracket: [order-4, {order-3}, order-3, order-5, order-6, order-7, order-8].}(hjMhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMphjgLubjM)}(h-After split, folio is left locked for caller.h]h-After split, folio is left locked for caller.}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMxhjgLubjM)}(h **Return**h]j)}(hjMh]hReturn}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjMubah}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMzhjgLubjM)}(h0 - successful, <0 - failed (if -ENOMEM is returned, **folio** might be split but not to **new_order**, the caller needs to check)h](h50 - successful, <0 - failed (if -ENOMEM is returned, }(hjNhhhNhNubj)}(h **folio**h]hfolio}(hj NhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjNubh might be split but not to }(hjNhhhNhNubj)}(h **new_order**h]h new_order}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjNubh, the caller needs to check)}(hjNhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chM{hjgLubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h min_order_for_split (C function)c.min_order_for_splithNtauh1hhjKhhhNhNubh)}(hhh](h)}(h6unsigned int min_order_for_split (struct folio *folio)h]h)}(h5unsigned int min_order_for_split(struct folio *folio)h](j)}(hunsignedh]hunsigned}(hjWNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSNhhhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMubj)}(h h]h }(hjfNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSNhhhjeNhMubj)}(hinth]hint}(hjtNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSNhhhjeNhMubj)}(h h]h }(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSNhhhjeNhMubh)}(hmin_order_for_splith]j)}(hmin_order_for_splith]hmin_order_for_split}(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubah}(h]h ](jjeh"]h$]h&]jjuh1hhjSNhhhjeNhMubj8)}(h(struct folio *folio)h]j>)}(hstruct folio *folioh](j)}(hjJ,h]hstruct}(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubj)}(h h]h }(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubh)}(hhh]j)}(hfolioh]hfolio}(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubah}(h]h ]h"]h$]h&] refdomainjAreftypej reftargetjNmodnameN classnameNjj)}j]j)}jjNsbc.min_order_for_splitasbuh1hhjNubj)}(h h]h }(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubjr)}(hjuh]h*}(hjNhhhNhNubah}(h]h ]j~ah"]h$]h&]uh1jqhjNubj)}(hfolioh]hfolio}(hj OhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubeh}(h]h ]h"]h$]h&]noemphjjuh1j=hjNubah}(h]h ]h"]h$]h&]jjuh1j7hjSNhhhjeNhMubeh}(h]h ]h"]h$]h&]jjj%uh1hj&j'hjONhhhjeNhMubah}(h]jJNah ](j+j,eh"]h$]h&]j0j1)j2huh1hhjeNhMhjLNhhubj4)}(hhh]jM)}(h/get the minimum order **folio** can be split toh](hget the minimum order }(hj3OhhhNhNubj)}(h **folio**h]hfolio}(hj;OhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj3Oubh can be split to}(hj3OhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMhj0Ohhubah}(h]h ]h"]h$]h&]uh1j3hjLNhhhjeNhMubeh}(h]h ](jAfunctioneh"]h$]h&]jFjAjGj]OjHj]OjIjJjKuh1hhhhjKhNhNubj)}(hXF**Parameters** ``struct folio *folio`` folio to split **Description** min_order_for_split() tells the minimum order **folio** can be split to. If a file-backed folio is truncated, 0 will be returned. Any subsequent split attempt should get -EBUSY from split checking code. **Return** **folio**'s minimum order for splith](jM)}(h**Parameters**h]j)}(hjgOh]h Parameters}(hjiOhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjeOubah}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMhjaOubj)}(hhh]j)}(h'``struct folio *folio`` folio to split h](j)}(h``struct folio *folio``h]jS)}(hjOh]hstruct folio *folio}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjOubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMhjOubj)}(hhh]jM)}(hfolio to splith]hfolio to split}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjOhMhjOubah}(h]h ]h"]h$]h&]uh1jhjOubeh}(h]h ]h"]h$]h&]uh1jhjOhMhj}Oubah}(h]h ]h"]h$]h&]uh1jhjaOubjM)}(h**Description**h]j)}(hjOh]h Description}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjOubah}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMhjaOubjM)}(hmin_order_for_split() tells the minimum order **folio** can be split to. If a file-backed folio is truncated, 0 will be returned. Any subsequent split attempt should get -EBUSY from split checking code.h](h.min_order_for_split() tells the minimum order }(hjOhhhNhNubj)}(h **folio**h]hfolio}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjOubh can be split to. If a file-backed folio is truncated, 0 will be returned. Any subsequent split attempt should get -EBUSY from split checking code.}(hjOhhhNhNubeh}(h]h ]$h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMhjaOubjM)}(h **Return**h]j)}(hjOh]hReturn}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjOubah}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMhjaOubjM)}(h#**folio**'s minimum order for splith](j)}(h **folio**h]hfolio}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjPubh’s minimum order for split}(hjPhhhNhNubeh}(h]h ]h"]h$]h&]uh1jLhQ/var/lib/git/docbuild/linux/Documentation/core-api/mm-api:147: ./mm/huge_memory.chMhjaOubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjKhhhNhNubeh}(h] more-memory-management-functionsah ]h"] more memory management functionsah$]h&]uh1hhhhhhhhKlubeh}(h]memory-management-apisah ]h"]memory management apisah$]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_handlerjgPerror_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}jI.]j>.asnameids}(jAPj>PjO.jL.jN3jI.jM3jJ3j6/j3/j/j/j11j.1jE3jB3jjjjjjjrjoj,j,j2j2jQjQjjjgjHjEj9Pj6Pu nametypes}(jAPjO.jN3jM3j6/j/j11jE3jjjjrj,j2jQjjjHj9Puh}(j>PhjL.hhhjjjjjjj j j.j3jujzjjjmjrjjjjjjjjj j j"j"j#j#j_%jd%j&j&j(j(j'+j,+jI.jR.jJ3jR.j3/jc.j/j9/j.1j/jB3j41jjU3jr3jw3jY4j^4j5j5jR6jW6j7j7j=j=jBjBjKEjPEjIjIjKjKj~NjNjaSjfSjUjUjWjWj2Zj7Zj[j[j]j]j_j_jAajFajAdjFdjejejXgj]gjjj jjGnjLnjojojrjrjtjtj`vjevjwjwjqyjvyjzjzj|j|jjj<jAjejjjj j֌jیjjjjj4j9jkjpj;j@jj jߗjjljqjj"jȟj͟jģjɣjjjFjKj jjjjjjjjjjNjSjjjjj#j(jjj jjjjjjjjQjVjjjojj,jj.j3jjjjjcjhj,j1jjjwj|j0j5jjjjjjj}jjjj^jcjsjxjjjjjVj[jjjjjjjjjjjdjij jj~jj j jjjjjojyj~jjjgjljjjojm!jr!j+$j0$j&j&j2)j7)j2j,j-j-jB0jG0jQj2j3j3j4j4j77j<7j8j8j;j;jc=jh=j>j>jAjAjdFjiFjHjHjKj$KjLjLjNjNjXPj]PjgjQjRjRjTjTjmWjrWjYjYjJ[jO[j^j$^j`j`jqbjvbjdjdjfjfj7ijjCjjjϝjԝj~jj-j2jjjԥj٥jjjj#jjjjjjjjjjj?jDjjj׼jܼjjjgjljmjrjbjgj~jjj jjjjjjj4j9jjjEjujjjGjLjjjjjjjj$jBjGjjjjjjj6PjKjhjmj!j&jjjjjjjjj jj> jC j j jjjjjjjjjjj.j3jjj"j"j[%j`%jT(jY(j*j*j-j-j/j/jj2jo2j4j4j67j;7j 9j%9j^;jc;j=j=j?j?j`AjeAjBjBjEjEjGjGjHjHjKjKjINjNNjQjQjTjTjSXjXXjOZjTZjK\jP\j_j_j*aj/ajycj~cj6fj;fjijjj~mjmjojpjrjrj7ujjjjjjXj]jjj$j)jjĬjjj+j0jjjjjj jjj=jBjj¹j|jjAjFjjjjj~jjCjHjjjjjDjIjjjjjwj|jgjljjjyj~jjjjj?jDjUjZjjjujzj7j<jjjjjjjkjpjjjjjRjWjjjjjjjjjjjjjjjjjjj>jCjjjZj_jjj j%jx j} j j jjjjjjjj!jjjjjjjjj j j\#ja#j&j&jZ)j_)jw,j|,j/j/jG3jL3ja5jf5j7j7j9j9jc;jh;j<j=j=j=j>j>jBjBjLEjQEj:Gj?GjHjHjJjJjLjLj.Nj3NjRj$RjSjSj.Wj3Wj{ZjZjW^j\^jajbj'dj,dj"gj'gjjjjjnjojrjrj?vjDvjyjyjq|jv|jSjXjjjjjgjljjjȌj͌jj jjjϗjԗj_jdjpjujjjjjPjUjjƮjjjjjTjYj{jjjjjĿj=jBj?jDjjjMjRjjjIjNjjj1j6jjj2j7jyj~j@jEjjjjj,j1jjjrjwjjjjjdjijjj!j&jjjjjjjjjjj]jbjgjlj[j`jjj2j7jjj>jCjjj9j>j j j j jjjjjjjjjjjjjQjVj j j"j"j$j$j&j&j )j)j*j*j.j.j0j0jL2jQ2j4j4j6j6j9j9j<j<jn?js?jAjAjDjDjFjFj[Hj`HjJj$JjKjKjJMjOMjLOjQOj\QjaQjSjSjVjVj\j\j^j^j ajaj8dj=djejej:gj?gjjj jjvlj{ljnjnjrjrj=ujBujvjvjNxjSxjzjzj|j|j~j~jɁj΁jjjj jʉjωjjjjjjjwj|jʙjϙjjjqjvjjjj jjj֥jۥj3j8jjjjjjjjjjj~jjjjjj5j:jjjj jVj[jjj&j+jjjjjmjrjjjLjQjjjjjj jjj jjjjJjOjKjPjjjjjjjjj2j7jjjj$jjjjjjj!j&j}jjW j\ j j j j jjjjj=jBjNjSjjj$j)jNjSjjj3!j8!j]$jb$j%j%j"(j'(j2*j7*j,j,j/j/j@2jE2ja5jf5j8j8j>j>jBjBjGjGj)Jj.JjJNjONu 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]hsystem_message)}(hhh]jM)}(hhh]h6Hyperlink target "mm-api-gfp-flags" is not referenced.}hjPsbah}(h]h ]h"]h$]h&]uh1jLhjPubah}(h]h ]h"]h$]h&]levelKtypeINFOsourcehʌlineKuh1jPuba transformerN include_log] decorationNhhub.