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/kho/conceptsmodnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Traditional)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget)/translations/zh_TW/core-api/kho/conceptsmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget)/translations/it_IT/core-api/kho/conceptsmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget)/translations/ja_JP/core-api/kho/conceptsmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget)/translations/ko_KR/core-api/kho/conceptsmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget)/translations/sp_SP/core-api/kho/conceptsmodnameN classnameN refexplicituh1hhh ubeh}(h]h ]h"]h$]h&]current_languageEnglishuh1h hh _documenthsourceNlineNubhcomment)}(h)SPDX-License-Identifier: GPL-2.0-or-laterh]h)SPDX-License-Identifier: GPL-2.0-or-later}hhsbah}(h]h ]h"]h$]h&] xml:spacepreserveuh1hhhhhhC/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts.rsthKubhtarget)}(h.. _kho-concepts:h]h}(h]h ]h"]h$]h&]refid kho-conceptsuh1hhKhhhhhhubhsection)}(hhh](htitle)}(hKexec Handover Conceptsh]hKexec Handover Concepts}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhhhKubh paragraph)}(hKexec HandOver (KHO) is a mechanism that allows Linux to preserve memory regions, which could contain serialized system states, across kexec.h]hKexec HandOver (KHO) is a mechanism that allows Linux to preserve memory regions, which could contain serialized system states, across kexec.}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh)}(h It introduces multiple concepts:h]h It introduces multiple concepts:}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK hhhhubh)}(hhh](h)}(hKHO FDTh]hKHO FDT}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhhhKubh)}(hX:Every KHO kexec carries a KHO specific flattened device tree (FDT) blob that describes preserved memory regions. These regions contain either serialized subsystem states, or in-memory data that shall not be touched across kexec. After KHO, subsystems can retrieve and restore preserved memory regions from KHO FDT.h]hX:Every KHO kexec carries a KHO specific flattened device tree (FDT) blob that describes preserved memory regions. These regions contain either serialized subsystem states, or in-memory data that shall not be touched across kexec. After KHO, subsystems can retrieve and restore preserved memory regions from KHO FDT.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh)}(hX*KHO only uses the FDT container format and libfdt library, but does not adhere to the same property semantics that normal device trees do: Properties are passed in native endianness and standardized properties like ``regs`` and ``ranges`` do not exist, hence there are no ``#...-cells`` properties.h](hKHO only uses the FDT container format and libfdt library, but does not adhere to the same property semantics that normal device trees do: Properties are passed in native endianness and standardized properties like }(hjhhhNhNubhliteral)}(h``regs``h]hregs}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh and }(hjhhhNhNubj)}(h ``ranges``h]hranges}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh" do not exist, hence there are no }(hjhhhNhNubj)}(h``#...-cells``h]h #...-cells}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh properties.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh)}(hZKHO is still under development. The FDT schema is unstable and would change in the future.h]hZKHO is still under development. The FDT schema is unstable and would change in the future.}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhhhubeh}(h]kho-fdtah ]h"]kho fdtah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(hScratch Regionsh]hScratch Regions}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1hhjphhhhhKubh)}(hX4To boot into kexec, we need to have a physically contiguous memory range that contains no handed over memory. Kexec then places the target kernel and initrd into that region. The new kernel exclusively uses this region for memory allocations before during boot up to the initialization of the page allocator.h]hX4To boot into kexec, we need to have a physically contiguous memory range that contains no handed over memory. Kexec then places the target kernel and initrd into that region. The new kernel exclusively uses this region for memory allocations before during boot up to the initialization of the page allocator.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK!hjphhubh)}(hXWe guarantee that we always have such regions through the scratch regions: On first boot KHO allocates several physically contiguous memory regions. Since after kexec these regions will be used by early memory allocations, there is a scratch region per NUMA node plus a scratch region to satisfy allocations requests that do not require particular NUMA node assignment. By default, size of the scratch region is calculated based on amount of memory allocated during boot. The ``kho_scratch`` kernel command line option may be used to explicitly define size of the scratch regions. The scratch regions are declared as CMA when page allocator is initialized so that their memory can be used during system lifetime. CMA gives us the guarantee that no handover pages land in that region, because handover pages must be at a static physical memory location and CMA enforces that only movable pages can be located inside.h](hXWe guarantee that we always have such regions through the scratch regions: On first boot KHO allocates several physically contiguous memory regions. Since after kexec these regions will be used by early memory allocations, there is a scratch region per NUMA node plus a scratch region to satisfy allocations requests that do not require particular NUMA node assignment. By default, size of the scratch region is calculated based on amount of memory allocated during boot. The }(hjhhhNhNubj)}(h``kho_scratch``h]h kho_scratch}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhX kernel command line option may be used to explicitly define size of the scratch regions. The scratch regions are declared as CMA when page allocator is initialized so that their memory can be used during system lifetime. CMA gives us the guarantee that no handover pages land in that region, because handover pages must be at a static physical memory location and CMA enforces that only movable pages can be located inside.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhK&hjphhubh)}(hXAfter KHO kexec, we ignore the ``kho_scratch`` kernel command line option and instead reuse the exact same region that was originally allocated. This allows us to recursively execute any amount of KHO kexecs. Because we used this region for boot memory allocations and as target memory for kexec blobs, some parts of that memory region may be reserved. These reservations are irrelevant for the next KHO, because kexec can overwrite even the original kernel.h](hAfter KHO kexec, we ignore the }(hjhhhNhNubj)}(h``kho_scratch``h]h kho_scratch}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhX kernel command line option and instead reuse the exact same region that was originally allocated. This allows us to recursively execute any amount of KHO kexecs. Because we used this region for boot memory allocations and as target memory for kexec blobs, some parts of that memory region may be reserved. These reservations are irrelevant for the next KHO, because kexec can overwrite even the original kernel.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhK4hjphhubh)}(h.. _kho-finalization-phase:h]h}(h]h ]h"]h$]h&]hkho-finalization-phaseuh1hhK;hjphhhhubeh}(h]scratch-regionsah ]h"]scratch regionsah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(hKHO finalization phaseh]hKHO finalization phase}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhK>ubh)}(hXTo enable user space based kexec file loader, the kernel needs to be able to provide the FDT that describes the current kernel's state before performing the actual kexec. The process of generating that FDT is called serialization. When the FDT is generated, some properties of the system may become immutable because they are already written down in the FDT. That state is called the KHO finalization phase.h]hXTo enable user space based kexec file loader, the kernel needs to be able to provide the FDT that describes the current kernel’s state before performing the actual kexec. The process of generating that FDT is called serialization. When the FDT is generated, some properties of the system may become immutable because they are already written down in the FDT. That state is called the KHO finalization phase.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK@hjhhubeh}(h](jid1eh ]h"](kho finalization phasekho-finalization-phaseeh$]h&]uh1hhhhhhhhK>expect_referenced_by_name}jjsexpect_referenced_by_id}jjsubh)}(hhh](h)}(h Public APIh]h Public API}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKHubhindex)}(hhh]h}(h]h ]h"]h$]h&]entries](singlekho_restore_folio (C function)c.kho_restore_foliohNtauh1jhjhhhNhNubhdesc)}(hhh](hdesc_signature)}(h3struct folio * kho_restore_folio (phys_addr_t phys)h]hdesc_signature_line)}(h1struct folio *kho_restore_folio(phys_addr_t phys)h](hdesc_sig_keyword)}(hstructh]hstruct}(hjChhhNhNubah}(h]h ]kah"]h$]h&]uh1jAhj=hhh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chM ubhdesc_sig_space)}(h h]h }(hjUhhhNhNubah}(h]h ]wah"]h$]h&]uh1jShj=hhhjRhM ubh)}(hhh]h desc_sig_name)}(hfolioh]hfolio}(hjihhhNhNubah}(h]h ]nah"]h$]h&]uh1jghjdubah}(h]h ]h"]h$]h&] refdomaincreftype identifier reftargetjkmodnameN classnameN c:parent_keysphinx.domains.c LookupKey)}data]j ASTIdentifier)}jkho_restore_foliosbc.kho_restore_folioasbuh1hhj=hhhjRhM ubjT)}(h h]h }(hjhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jShj=hhhjRhM ubhdesc_sig_punctuation)}(h*h]h*}(hjhhhNhNubah}(h]h ]pah"]h$]h&]uh1jhj=hhhjRhM ubh desc_name)}(hkho_restore_folioh]jh)}(hjh]hkho_restore_folio}(hjhhhNhNubah}(h]h ]jtah"]h$]h&]uh1jghjubah}(h]h ](sig-namedescnameeh"]h$]h&]hhuh1jhj=hhhjRhM ubhdesc_parameterlist)}(h(phys_addr_t phys)h]hdesc_parameter)}(hphys_addr_t physh](h)}(hhh]jh)}(h phys_addr_th]h phys_addr_t}(hjhhhNhNubah}(h]h ]jtah"]h$]h&]uh1jghjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj)}j]jc.kho_restore_folioasbuh1hhjubjT)}(h h]h }(hjhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jShjubjh)}(hphysh]hphys}(hj hhhNhNubah}(h]h ]jtah"]h$]h&]uh1jghjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubah}(h]h ]h"]h$]h&]hhuh1jhj=hhhjRhM ubeh}(h]h ]h"]h$]h&]hh add_permalinkuh1j;sphinx_line_type declaratorhj7hhhjRhM ubah}(h]j.ah ](sig sig-objecteh"]h$]h&] is_multiline _toc_parts) _toc_namehuh1j5hjRhM hj2hhubh desc_content)}(hhh]h)}(h.recreates the folio from the preserved memory.h]h.recreates the folio from the preserved memory.}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chM hj:hhubah}(h]h ]h"]h$]h&]uh1j8hj2hhhjRhM ubeh}(h]h ](jfunctioneh"]h$]h&]domainjobjtypejUdesctypejUnoindex noindexentrynocontentsentryuh1j0hhhjhNhNubh container)}(h**Parameters** ``phys_addr_t phys`` physical address of the folio. **Return** pointer to the struct folio on success, NULL on failure.h](h)}(h**Parameters**h]hstrong)}(hjgh]h Parameters}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1jihjeubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chM hjaubhdefinition_list)}(hhh]hdefinition_list_item)}(h4``phys_addr_t phys`` physical address of the folio. h](hterm)}(h``phys_addr_t phys``h]j)}(hjh]hphys_addr_t phys}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chM hjubh definition)}(hhh]h)}(hphysical address of the folio.h]hphysical address of the folio.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjaubh)}(h **Return**h]jj)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jihjubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chM hjaubh)}(h8pointer to the struct folio on success, NULL on failure.h]h8pointer to the struct folio on success, NULL on failure.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chM hjaubeh}(h]h ] kernelindentah"]h$]h&]uh1j_hjhhhNhNubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j,kho_restore_pages (C function)c.kho_restore_pageshNtauh1jhjhhhNhNubj1)}(hhh](j6)}(hIstruct page * kho_restore_pages (phys_addr_t phys, unsigned int nr_pages)h]j<)}(hGstruct page *kho_restore_pages(phys_addr_t phys, unsigned int nr_pages)h](jB)}(hjEh]hstruct}(hjhhhNhNubah}(h]h ]jNah"]h$]h&]uh1jAhj hhh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chMubjT)}(h h]h }(hjhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jShj hhhjhMubh)}(hhh]jh)}(hpageh]hpage}(hj/hhhNhNubah}(h]h ]jtah"]h$]h&]uh1jghj,ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj1modnameN classnameNjj)}j]j)}jkho_restore_pagessbc.kho_restore_pagesasbuh1hhj hhhjhMubjT)}(h h]h }(hjPhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jShj hhhjhMubj)}(hjh]h*}(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhjhMubj)}(hkho_restore_pagesh]jh)}(hjMh]hkho_restore_pages}(hjohhhNhNubah}(h]h ]jtah"]h$]h&]uh1jghjkubah}(h]h ](jjeh"]h$]h&]hhuh1jhj hhhjhMubj)}(h)(phys_addr_t phys, unsigned int nr_pages)h](j)}(hphys_addr_t physh](h)}(hhh]jh)}(h phys_addr_th]h phys_addr_t}(hjhhhNhNubah}(h]h ]jtah"]h$]h&]uh1jghjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj)}j]jKc.kho_restore_pagesasbuh1hhjubjT)}(h h]h }(hjhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jShjubjh)}(hphysh]hphys}(hjhhhNhNubah}(h]h ]jtah"]h$]h&]uh1jghjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubj)}(hunsigned int nr_pagesh](hdesc_sig_keyword_type)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]ktah"]h$]h&]uh1jhjubjT)}(h h]h }(hjhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jShjubj)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjT)}(h h]h }(hjhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jShjubjh)}(hnr_pagesh]hnr_pages}(hj hhhNhNubah}(h]h ]jtah"]h$]h&]uh1jghjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubeh}(h]h ]h"]h$]h&]hhuh1jhj hhhjhMubeh}(h]h ]h"]h$]h&]hhj*uh1j;j+j,hjhhhjhMubah}(h]jah ](j0j1eh"]h$]h&]j5j6)j7huh1j5hjhMhjhhubj9)}(hhh]h)}(h)restore list of contiguous order 0 pages.h]h)restore list of contiguous order 0 pages.}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chMhj4hhubah}(h]h ]h"]h$]h&]uh1j8hjhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jYjjZjOj[jOj\j]j^uh1j0hhhjhNhNubj`)}(hX**Parameters** ``phys_addr_t phys`` physical address of the first page. ``unsigned int nr_pages`` number of pages. **Description** Restore a contiguous list of order 0 pages that was preserved with kho_preserve_pages(). **Return** 0 on success, error code on failureh](h)}(h**Parameters**h]jj)}(hjYh]h Parameters}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1jihjWubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chMhjSubj)}(hhh](j)}(h9``phys_addr_t phys`` physical address of the first page. h](j)}(h``phys_addr_t phys``h]j)}(hjxh]hphys_addr_t phys}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjvubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chMhjrubj)}(hhh]h)}(h#physical address of the first page.h]h#physical address of the first page.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjrubeh}(h]h ]h"]h$]h&]uh1jhjhMhjoubj)}(h+``unsigned int nr_pages`` number of pages. h](j)}(h``unsigned int nr_pages``h]j)}(hjh]hunsigned int nr_pages}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chMhjubj)}(hhh]h)}(hnumber of pages.h]hnumber of pages.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjoubeh}(h]h ]h"]h$]h&]uh1jhjSubh)}(h**Description**h]jj)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jihjubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chMhjSubh)}(hXRestore a contiguous list of order 0 pages that was preserved with kho_preserve_pages().h]hXRestore a contiguous list of order 0 pages that was preserved with kho_preserve_pages().}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chMhjSubh)}(h **Return**h]jj)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jihjubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chMhjSubh)}(h#0 on success, error code on failureh]h#0 on success, error code on failure}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chMhjSubeh}(h]h ] kernelindentah"]h$]h&]uh1j_hjhhhNhNubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j,kho_add_subtree (C function)c.kho_add_subtreehNtauh1jhjhhhNhNubj1)}(hhh](j6)}(hPint kho_add_subtree (struct kho_serialization *ser, const char *name, void *fdt)h]j<)}(hOint kho_add_subtree(struct kho_serialization *ser, const char *name, void *fdt)h](j)}(hinth]hint}(hjXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjThhh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chMubjT)}(h h]h }(hjghhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jShjThhhjfhMubj)}(hkho_add_subtreeh]jh)}(hkho_add_subtreeh]hkho_add_subtree}(hjyhhhNhNubah}(h]h ]jtah"]h$]h&]uh1jghjuubah}(h]h ](jjeh"]h$]h&]hhuh1jhjThhhjfhMubj)}(h<(struct kho_serialization *ser, const char *name, void *fdt)h](j)}(hstruct kho_serialization *serh](jB)}(hjEh]hstruct}(hjhhhNhNubah}(h]h ]jNah"]h$]h&]uh1jAhjubjT)}(h h]h }(hjhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jShjubh)}(hhh]jh)}(hkho_serializationh]hkho_serialization}(hjhhhNhNubah}(h]h ]jtah"]h$]h&]uh1jghjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj)}j]j)}jj{sbc.kho_add_subtreeasbuh1hhjubjT)}(h h]h }(hjhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jShjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjh)}(hserh]hser}(hjhhhNhNubah}(h]h ]jtah"]h$]h&]uh1jghjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubj)}(hconst char *nameh](jB)}(hconsth]hconst}(hjhhhNhNubah}(h]h ]jNah"]h$]h&]uh1jAhjubjT)}(h h]h }(hjhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jShjubj)}(hcharh]hchar}(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjT)}(h h]h }(hj1hhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jShjubj)}(hjh]h*}(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjh)}(hnameh]hname}(hjLhhhNhNubah}(h]h ]jtah"]h$]h&]uh1jghjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubj)}(h void *fdth](j)}(hvoidh]hvoid}(hjehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubjT)}(h h]h }(hjshhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jShjaubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubjh)}(hfdth]hfdt}(hjhhhNhNubah}(h]h ]jtah"]h$]h&]uh1jghjaubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubeh}(h]h ]h"]h$]h&]hhuh1jhjThhhjfhMubeh}(h]h ]h"]h$]h&]hhj*uh1j;j+j,hjPhhhjfhMubah}(h]jKah ](j0j1eh"]h$]h&]j5j6)j7huh1j5hjfhMhjMhhubj9)}(hhh]h)}(h:record the physical address of a sub FDT in KHO root tree.h]h:record the physical address of a sub FDT in KHO root tree.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chMhjhhubah}(h]h ]h"]h$]h&]uh1j8hjMhhhjfhMubeh}(h]h ](jfunctioneh"]h$]h&]jYjjZjj[jj\j]j^uh1j0hhhjhNhNubj`)}(hX**Parameters** ``struct kho_serialization *ser`` serialization control object passed by KHO notifiers. ``const char *name`` name of the sub tree. ``void *fdt`` the sub tree blob. **Description** Creates a new child node named **name** in KHO root FDT and records the physical address of **fdt**. The pages of **fdt** must also be preserved by KHO for the new kernel to retrieve it after kexec. A debugfs blob entry is also created at ``/sys/kernel/debug/kho/out/sub_fdts/**name**``. **Return** 0 on success, error code on failureh](h)}(h**Parameters**h]jj)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jihjubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chMhjubj)}(hhh](j)}(hX``struct kho_serialization *ser`` serialization control object passed by KHO notifiers. h](j)}(h!``struct kho_serialization *ser``h]j)}(hjh]hstruct kho_serialization *ser}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chMhjubj)}(hhh]h)}(h5serialization control object passed by KHO notifiers.h]h5serialization control object passed by KHO notifiers.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h+``const char *name`` name of the sub tree. h](j)}(h``const char *name``h]j)}(hj2h]hconst char *name}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj0ubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chMhj,ubj)}(hhh]h)}(hname of the sub tree.h]hname of the sub tree.}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjGhMhjHubah}(h]h ]h"]h$]h&]uh1jhj,ubeh}(h]h ]h"]h$]h&]uh1jhjGhMhjubj)}(h!``void *fdt`` the sub tree blob. h](j)}(h ``void *fdt``h]j)}(hjkh]h void *fdt}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjiubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chMhjeubj)}(hhh]h)}(hthe sub tree blob.h]hthe sub tree blob.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjeubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]jj)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jihjubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chMhjubh)}(hCreates a new child node named **name** in KHO root FDT and records the physical address of **fdt**. The pages of **fdt** must also be preserved by KHO for the new kernel to retrieve it after kexec.h](hCreates a new child node named }(hjhhhNhNubjj)}(h**name**h]hname}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jihjubh5 in KHO root FDT and records the physical address of }(hjhhhNhNubjj)}(h**fdt**h]hfdt}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jihjubh. The pages of }(hjhhhNhNubjj)}(h**fdt**h]hfdt}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jihjubhM must also be preserved by KHO for the new kernel to retrieve it after kexec.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chMhjubh)}(hXA debugfs blob entry is also created at ``/sys/kernel/debug/kho/out/sub_fdts/**name**``.h](h(A debugfs blob entry is also created at }(hj hhhNhNubj)}(h/``/sys/kernel/debug/kho/out/sub_fdts/**name**``h]h+/sys/kernel/debug/kho/out/sub_fdts/**name**}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubh.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chMhjubh)}(h **Return**h]jj)}(hj$ h]hReturn}(hj& hhhNhNubah}(h]h ]h"]h$]h&]uh1jihj" ubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chMhjubh)}(h#0 on success, error code on failureh]h#0 on success, error code on failure}(hj: hhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j_hjhhhNhNubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j,kho_preserve_folio (C function)c.kho_preserve_foliohNtauh1jhjhhhNhNubj1)}(hhh](j6)}(h,int kho_preserve_folio (struct folio *folio)h]j<)}(h+int kho_preserve_folio(struct folio *folio)h](j)}(hinth]hint}(hji hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhje hhh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chMubjT)}(h h]h }(hjx hhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jShje hhhjw hMubj)}(hkho_preserve_folioh]jh)}(hkho_preserve_folioh]hkho_preserve_folio}(hj hhhNhNubah}(h]h ]jtah"]h$]h&]uh1jghj ubah}(h]h ](jjeh"]h$]h&]hhuh1jhje hhhjw hMubj)}(h(struct folio *folio)h]j)}(hstruct folio *folioh](jB)}(hjEh]hstruct}(hj hhhNhNubah}(h]h ]jNah"]h$]h&]uh1jAhj ubjT)}(h h]h }(hj hhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jShj ubh)}(hhh]jh)}(hfolioh]hfolio}(hj hhhNhNubah}(h]h ]jtah"]h$]h&]uh1jghj ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj modnameN classnameNjj)}j]j)}jj sbc.kho_preserve_folioasbuh1hhj ubjT)}(h h]h }(hj hhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jShj ubj)}(hjh]h*}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubjh)}(hfolioh]hfolio}(hj hhhNhNubah}(h]h ]jtah"]h$]h&]uh1jghj ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj ubah}(h]h ]h"]h$]h&]hhuh1jhje hhhjw hMubeh}(h]h ]h"]h$]h&]hhj*uh1j;j+j,hja hhhjw hMubah}(h]j\ ah ](j0j1eh"]h$]h&]j5j6)j7huh1j5hjw hMhj^ hhubj9)}(hhh]h)}(hpreserve a folio across kexec.h]hpreserve a folio across kexec.}(hj) hhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chMhj& hhubah}(h]h ]h"]h$]h&]uh1j8hj^ hhhjw hMubeh}(h]h ](jfunctioneh"]h$]h&]jYjjZjA j[jA j\j]j^uh1j0hhhjhNhNubj`)}(h**Parameters** ``struct folio *folio`` folio to preserve. **Description** Instructs KHO to preserve the whole folio across kexec. The order will be preserved as well. **Return** 0 on success, error code on failureh](h)}(h**Parameters**h]jj)}(hjK h]h Parameters}(hjM hhhNhNubah}(h]h ]h"]h$]h&]uh1jihjI ubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chMhjE ubj)}(hhh]j)}(h+``struct folio *folio`` folio to preserve. h](j)}(h``struct folio *folio``h]j)}(hjj h]hstruct folio *folio}(hjl hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjh ubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chMhjd ubj)}(hhh]h)}(hfolio to preserve.h]hfolio to preserve.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMhj ubah}(h]h ]h"]h$]h&]uh1jhjd ubeh}(h]h ]h"]h$]h&]uh1jhj hMhja ubah}(h]h ]h"]h$]h&]uh1jhjE ubh)}(h**Description**h]jj)}(hj h]h Description}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jihj ubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chMhjE ubh)}(h\Instructs KHO to preserve the whole folio across kexec. The order will be preserved as well.h]h\Instructs KHO to preserve the whole folio across kexec. The order will be preserved as well.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chMhjE ubh)}(h **Return**h]jj)}(hj h]hReturn}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jihj ubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chMhjE ubh)}(h#0 on success, error code on failureh]h#0 on success, error code on failure}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chMhjE ubeh}(h]h ] kernelindentah"]h$]h&]uh1j_hjhhhNhNubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j,kho_preserve_pages (C function)c.kho_preserve_pageshNtauh1jhjhhhNhNubj1)}(hhh](j6)}(hAint kho_preserve_pages (struct page *page, unsigned int nr_pages)h]j<)}(h@int kho_preserve_pages(struct page *page, unsigned int nr_pages)h](j)}(hinth]hint}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chMubjT)}(h h]h }(hj hhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jShj hhhj hMubj)}(hkho_preserve_pagesh]jh)}(hkho_preserve_pagesh]hkho_preserve_pages}(hj2 hhhNhNubah}(h]h ]jtah"]h$]h&]uh1jghj. ubah}(h]h ](jjeh"]h$]h&]hhuh1jhj hhhj hMubj)}(h*(struct page *page, unsigned int nr_pages)h](j)}(hstruct page *pageh](jB)}(hjEh]hstruct}(hjN hhhNhNubah}(h]h ]jNah"]h$]h&]uh1jAhjJ ubjT)}(h h]h }(hj[ hhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jShjJ ubh)}(hhh]jh)}(hpageh]hpage}(hjl hhhNhNubah}(h]h ]jtah"]h$]h&]uh1jghji ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjn modnameN classnameNjj)}j]j)}jj4 sbc.kho_preserve_pagesasbuh1hhjJ ubjT)}(h h]h }(hj hhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jShjJ ubj)}(hjh]h*}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJ ubjh)}(hpageh]hpage}(hj hhhNhNubah}(h]h ]jtah"]h$]h&]uh1jghjJ ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjF ubj)}(hunsigned int nr_pagesh](j)}(hunsignedh]hunsigned}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubjT)}(h h]h }(hj hhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jShj ubj)}(hinth]hint}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubjT)}(h h]h }(hj hhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jShj ubjh)}(hnr_pagesh]hnr_pages}(hj hhhNhNubah}(h]h ]jtah"]h$]h&]uh1jghj ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjF ubeh}(h]h ]h"]h$]h&]hhuh1jhj hhhj hMubeh}(h]h ]h"]h$]h&]hhj*uh1j;j+j,hj hhhj hMubah}(h]j ah ](j0j1eh"]h$]h&]j5j6)j7huh1j5hj hMhj hhubj9)}(hhh]h)}(h&preserve contiguous pages across kexech]h&preserve contiguous pages across kexec}(hj" hhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chMhj hhubah}(h]h ]h"]h$]h&]uh1j8hj hhhj hMubeh}(h]h ](jfunctioneh"]h$]h&]jYjjZj: j[j: j\j]j^uh1j0hhhjhNhNubj`)}(hX>**Parameters** ``struct page *page`` first page in the list. ``unsigned int nr_pages`` number of pages. **Description** Preserve a contiguous list of order 0 pages. Must be restored using kho_restore_pages() to ensure the pages are restored properly as order 0. **Return** 0 on success, error code on failureh](h)}(h**Parameters**h]jj)}(hjD h]h Parameters}(hjF hhhNhNubah}(h]h ]h"]h$]h&]uh1jihjB ubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chMhj> ubj)}(hhh](j)}(h.``struct page *page`` first page in the list. h](j)}(h``struct page *page``h]j)}(hjc h]hstruct page *page}(hje hhhNhNubah}(h]h ]h"]h$]h&]uh1jhja ubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chMhj] ubj)}(hhh]h)}(hfirst page in the list.h]hfirst page in the list.}(hj| hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjx hMhjy ubah}(h]h ]h"]h$]h&]uh1jhj] ubeh}(h]h ]h"]h$]h&]uh1jhjx hMhjZ ubj)}(h+``unsigned int nr_pages`` number of pages. h](j)}(h``unsigned int nr_pages``h]j)}(hj h]hunsigned int nr_pages}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chMhj ubj)}(hhh]h)}(hnumber of pages.h]hnumber of pages.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hMhjZ ubeh}(h]h ]h"]h$]h&]uh1jhj> ubh)}(h**Description**h]jj)}(hj h]h Description}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jihj ubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chMhj> ubh)}(hPreserve a contiguous list of order 0 pages. Must be restored using kho_restore_pages() to ensure the pages are restored properly as order 0.h]hPreserve a contiguous list of order 0 pages. Must be restored using kho_restore_pages() to ensure the pages are restored properly as order 0.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chMhj> ubh)}(h **Return**h]jj)}(hj h]hReturn}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jihj ubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chMhj> ubh)}(h#0 on success, error code on failureh]h#0 on success, error code on failure}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chMhj> ubeh}(h]h ] kernelindentah"]h$]h&]uh1j_hjhhhNhNubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j,!kho_preserve_vmalloc (C function)c.kho_preserve_vmallochNtauh1jhjhhhNhNubj1)}(hhh](j6)}(hFint kho_preserve_vmalloc (void *ptr, struct kho_vmalloc *preservation)h]j<)}(hEint kho_preserve_vmalloc(void *ptr, struct kho_vmalloc *preservation)h](j)}(hinth]hint}(hjC hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj? hhh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chM}ubjT)}(h h]h }(hjR hhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jShj? hhhjQ hM}ubj)}(hkho_preserve_vmalloch]jh)}(hkho_preserve_vmalloch]hkho_preserve_vmalloc}(hjd hhhNhNubah}(h]h ]jtah"]h$]h&]uh1jghj` ubah}(h]h ](jjeh"]h$]h&]hhuh1jhj? hhhjQ hM}ubj)}(h-(void *ptr, struct kho_vmalloc *preservation)h](j)}(h void *ptrh](j)}(hvoidh]hvoid}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj| ubjT)}(h h]h }(hj hhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jShj| ubj)}(hjh]h*}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj| ubjh)}(hptrh]hptr}(hj hhhNhNubah}(h]h ]jtah"]h$]h&]uh1jghj| ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjx ubj)}(h struct kho_vmalloc *preservationh](jB)}(hjEh]hstruct}(hj hhhNhNubah}(h]h ]jNah"]h$]h&]uh1jAhj ubjT)}(h h]h }(hj hhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jShj ubh)}(hhh]jh)}(h kho_vmalloch]h kho_vmalloc}(hj hhhNhNubah}(h]h ]jtah"]h$]h&]uh1jghj ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj modnameN classnameNjj)}j]j)}jjf sbc.kho_preserve_vmallocasbuh1hhj ubjT)}(h h]h }(hjhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jShj ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubjh)}(h preservationh]h preservation}(hjhhhNhNubah}(h]h ]jtah"]h$]h&]uh1jghj ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjx ubeh}(h]h ]h"]h$]h&]hhuh1jhj? hhhjQ hM}ubeh}(h]h ]h"]h$]h&]hhj*uh1j;j+j,hj; hhhjQ hM}ubah}(h]j6 ah ](j0j1eh"]h$]h&]j5j6)j7huh1j5hjQ hM}hj8 hhubj9)}(hhh]h)}(h5preserve memory allocated with vmalloc() across kexech]h5preserve memory allocated with vmalloc() across kexec}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chM}hjBhhubah}(h]h ]h"]h$]h&]uh1j8hj8 hhhjQ hM}ubeh}(h]h ](jfunctioneh"]h$]h&]jYjjZj]j[j]j\j]j^uh1j0hhhjhNhNubj`)}(hX?**Parameters** ``void *ptr`` pointer to the area in vmalloc address space ``struct kho_vmalloc *preservation`` placeholder for preservation metadata **Description** Instructs KHO to preserve the area in vmalloc address space at **ptr**. The physical pages mapped at **ptr** will be preserved and on successful return **preservation** will hold the physical address of a structure that describes the preservation. **NOTE** The memory allocated with vmalloc_node() variants cannot be reliably restored on the same node **Return** 0 on success, error code on failureh](h)}(h**Parameters**h]jj)}(hjgh]h Parameters}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1jihjeubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chMhjaubj)}(hhh](j)}(h;``void *ptr`` pointer to the area in vmalloc address space h](j)}(h ``void *ptr``h]j)}(hjh]h void *ptr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chM~hjubj)}(hhh]h)}(h,pointer to the area in vmalloc address spaceh]h,pointer to the area in vmalloc address space}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM~hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM~hj}ubj)}(hK``struct kho_vmalloc *preservation`` placeholder for preservation metadata h](j)}(h$``struct kho_vmalloc *preservation``h]j)}(hjh]h struct kho_vmalloc *preservation}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chMhjubj)}(hhh]h)}(h%placeholder for preservation metadatah]h%placeholder for preservation metadata}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhj}ubeh}(h]h ]h"]h$]h&]uh1jhjaubh)}(h**Description**h]jj)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jihjubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chMhjaubh)}(hInstructs KHO to preserve the area in vmalloc address space at **ptr**. The physical pages mapped at **ptr** will be preserved and on successful return **preservation** will hold the physical address of a structure that describes the preservation.h](h?Instructs KHO to preserve the area in vmalloc address space at }(hjhhhNhNubjj)}(h**ptr**h]hptr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jihjubh. The physical pages mapped at }(hjhhhNhNubjj)}(h**ptr**h]hptr}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1jihjubh, will be preserved and on successful return }(hjhhhNhNubjj)}(h**preservation**h]h preservation}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jihjubhO will hold the physical address of a structure that describes the preservation.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chMhjaubh)}(h**NOTE**h]jj)}(hjWh]hNOTE}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jihjUubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chMhjaubh)}(h^The memory allocated with vmalloc_node() variants cannot be reliably restored on the same nodeh]h^The memory allocated with vmalloc_node() variants cannot be reliably restored on the same node}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chMhjaubh)}(h **Return**h]jj)}(hj~h]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jihj|ubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chMhjaubh)}(h#0 on success, error code on failureh]h#0 on success, error code on failure}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chMhjaubeh}(h]h ] kernelindentah"]h$]h&]uh1j_hjhhhNhNubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j, kho_restore_vmalloc (C function)c.kho_restore_vmallochNtauh1jhjhhhNhNubj1)}(hhh](j6)}(hCvoid * kho_restore_vmalloc (const struct kho_vmalloc *preservation)h]j<)}(hAvoid *kho_restore_vmalloc(const struct kho_vmalloc *preservation)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chMubjT)}(h h]h }(hjhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jShjhhhjhMubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubj)}(hkho_restore_vmalloch]jh)}(hkho_restore_vmalloch]hkho_restore_vmalloc}(hjhhhNhNubah}(h]h ]jtah"]h$]h&]uh1jghjubah}(h]h ](jjeh"]h$]h&]hhuh1jhjhhhjhMubj)}(h((const struct kho_vmalloc *preservation)h]j)}(h&const struct kho_vmalloc *preservationh](jB)}(hj h]hconst}(hj hhhNhNubah}(h]h ]jNah"]h$]h&]uh1jAhj ubjT)}(h h]h }(hjhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jShj ubjB)}(hjEh]hstruct}(hj(hhhNhNubah}(h]h ]jNah"]h$]h&]uh1jAhj ubjT)}(h h]h }(hj5hhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jShj ubh)}(hhh]jh)}(h kho_vmalloch]h kho_vmalloc}(hjFhhhNhNubah}(h]h ]jtah"]h$]h&]uh1jghjCubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjHmodnameN classnameNjj)}j]j)}jjsbc.kho_restore_vmallocasbuh1hhj ubjT)}(h h]h }(hjfhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jShj ubj)}(hjh]h*}(hjthhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubjh)}(h preservationh]h preservation}(hjhhhNhNubah}(h]h ]jtah"]h$]h&]uh1jghj ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubah}(h]h ]h"]h$]h&]hhuh1jhjhhhjhMubeh}(h]h ]h"]h$]h&]hhj*uh1j;j+j,hjhhhjhMubah}(h]jah ](j0j1eh"]h$]h&]j5j6)j7huh1j5hjhMhjhhubj9)}(hhh]h)}(hSrecreates and populates an area in vmalloc address space from the preserved memory.h]hSrecreates and populates an area in vmalloc address space from the preserved memory.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chMhjhhubah}(h]h ]h"]h$]h&]uh1j8hjhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jYjjZjj[jj\j]j^uh1j0hhhjhNhNubj`)}(hX.**Parameters** ``const struct kho_vmalloc *preservation`` preservation metadata. **Description** Recreates an area in vmalloc address space and populates it with memory that was preserved using kho_preserve_vmalloc(). **Return** pointer to the area in the vmalloc address space, NULL on failure.h](h)}(h**Parameters**h]jj)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jihjubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chMhjubj)}(hhh]j)}(hB``const struct kho_vmalloc *preservation`` preservation metadata. h](j)}(h*``const struct kho_vmalloc *preservation``h]j)}(hjh]h&const struct kho_vmalloc *preservation}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chMhjubj)}(hhh]h)}(hpreservation metadata.h]hpreservation metadata.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]jj)}(hj'h]h Description}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1jihj%ubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chMhjubh)}(hxRecreates an area in vmalloc address space and populates it with memory that was preserved using kho_preserve_vmalloc().h]hxRecreates an area in vmalloc address space and populates it with memory that was preserved using kho_preserve_vmalloc().}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chMhjubh)}(h **Return**h]jj)}(hjNh]hReturn}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jihjLubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chMhjubh)}(hBpointer to the area in the vmalloc address space, NULL on failure.h]hBpointer to the area in the vmalloc address space, NULL on failure.}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j_hjhhhNhNubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j,is_kho_boot (C function) c.is_kho_boothNtauh1jhjhhhNhNubj1)}(hhh](j6)}(hbool is_kho_boot (void)h]j<)}(hbool is_kho_boot(void)h](j)}(hboolh]hbool}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chMubjT)}(h h]h }(hjhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jShjhhhjhMubj)}(h is_kho_booth]jh)}(h is_kho_booth]h is_kho_boot}(hjhhhNhNubah}(h]h ]jtah"]h$]h&]uh1jghjubah}(h]h ](jjeh"]h$]h&]hhuh1jhjhhhjhMubj)}(h(void)h]j)}(hvoidh]j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]noemphhhuh1jhjubah}(h]h ]h"]h$]h&]hhuh1jhjhhhjhMubeh}(h]h ]h"]h$]h&]hhj*uh1j;j+j,hjhhhjhMubah}(h]jah ](j0j1eh"]h$]h&]j5j6)j7huh1j5hjhMhjhhubj9)}(hhh]h)}(h8check if current kernel was booted via KHO-enabled kexech]h8check if current kernel was booted via KHO-enabled kexec}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chMhjhhubah}(h]h ]h"]h$]h&]uh1j8hjhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jYjjZjj[jj\j]j^uh1j0hhhjhNhNubj`)}(hX**Parameters** ``void`` no arguments **Description** This function checks if the current kernel was loaded through a kexec operation with KHO enabled, by verifying that a valid KHO FDT was passed. **Note** This function returns reliable results only after kho_populate() has been called during early boot. Before that, it may return false even if KHO data is present. **Return** true if booted via KHO-enabled kexec, false otherwiseh](h)}(h**Parameters**h]jj)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jihjubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chMhjubj)}(hhh]j)}(h``void`` no arguments h](j)}(h``void``h]j)}(hj;h]hvoid}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj9ubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chKhj5ubj)}(hhh]h)}(h no argumentsh]h no arguments}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1hhjPhKhjQubah}(h]h ]h"]h$]h&]uh1jhj5ubeh}(h]h ]h"]h$]h&]uh1jhjPhKhj2ubah}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]jj)}(hjvh]h Description}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1jihjtubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chKhjubh)}(hThis function checks if the current kernel was loaded through a kexec operation with KHO enabled, by verifying that a valid KHO FDT was passed.h]hThis function checks if the current kernel was loaded through a kexec operation with KHO enabled, by verifying that a valid KHO FDT was passed.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chMhjubh)}(h**Note**h]jj)}(hjh]hNote}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jihjubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chMhjubh)}(hThis function returns reliable results only after kho_populate() has been called during early boot. Before that, it may return false even if KHO data is present.h]hThis function returns reliable results only after kho_populate() has been called during early boot. Before that, it may return false even if KHO data is present.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chMhjubh)}(h **Return**h]jj)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jihjubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chMhjubh)}(h5true if booted via KHO-enabled kexec, false otherwiseh]h5true if booted via KHO-enabled kexec, false otherwise}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j_hjhhhNhNubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j,!kho_retrieve_subtree (C function)c.kho_retrieve_subtreehNtauh1jhjhhhNhNubj1)}(hhh](j6)}(h>int kho_retrieve_subtree (const char *name, phys_addr_t *phys)h]j<)}(h=int kho_retrieve_subtree(const char *name, phys_addr_t *phys)h](j)}(hinth]hint}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chMubjT)}(h h]h }(hjhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jShjhhhjhMubj)}(hkho_retrieve_subtreeh]jh)}(hkho_retrieve_subtreeh]hkho_retrieve_subtree}(hj*hhhNhNubah}(h]h ]jtah"]h$]h&]uh1jghj&ubah}(h]h ](jjeh"]h$]h&]hhuh1jhjhhhjhMubj)}(h%(const char *name, phys_addr_t *phys)h](j)}(hconst char *nameh](jB)}(hj h]hconst}(hjFhhhNhNubah}(h]h ]jNah"]h$]h&]uh1jAhjBubjT)}(h h]h }(hjShhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jShjBubj)}(hcharh]hchar}(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubjT)}(h h]h }(hjohhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jShjBubj)}(hjh]h*}(hj}hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubjh)}(hnameh]hname}(hjhhhNhNubah}(h]h ]jtah"]h$]h&]uh1jghjBubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj>ubj)}(hphys_addr_t *physh](h)}(hhh]jh)}(h phys_addr_th]h phys_addr_t}(hjhhhNhNubah}(h]h ]jtah"]h$]h&]uh1jghjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj)}j]j)}jj,sbc.kho_retrieve_subtreeasbuh1hhjubjT)}(h h]h }(hjhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jShjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjh)}(hphysh]hphys}(hjhhhNhNubah}(h]h ]jtah"]h$]h&]uh1jghjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj>ubeh}(h]h ]h"]h$]h&]hhuh1jhjhhhjhMubeh}(h]h ]h"]h$]h&]hhj*uh1j;j+j,hjhhhjhMubah}(h]jah ](j0j1eh"]h$]h&]j5j6)j7huh1j5hjhMhjhhubj9)}(hhh]h)}(h)retrieve a preserved sub FDT by its name.h]h)retrieve a preserved sub FDT by its name.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chMhjhhubah}(h]h ]h"]h$]h&]uh1j8hjhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jYjjZj#j[j#j\j]j^uh1j0hhhjhNhNubj`)}(hXT**Parameters** ``const char *name`` the name of the sub FDT passed to kho_add_subtree(). ``phys_addr_t *phys`` if found, the physical address of the sub FDT is stored in **phys**. **Description** Retrieve a preserved sub FDT named **name** and store its physical address in **phys**. **Return** 0 on success, error code on failureh](h)}(h**Parameters**h]jj)}(hj-h]h Parameters}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1jihj+ubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chM hj'ubj)}(hhh](j)}(hJ``const char *name`` the name of the sub FDT passed to kho_add_subtree(). h](j)}(h``const char *name``h]j)}(hjLh]hconst char *name}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjJubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chMhjFubj)}(hhh]h)}(h4the name of the sub FDT passed to kho_add_subtree().h]h4the name of the sub FDT passed to kho_add_subtree().}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1hhjahMhjbubah}(h]h ]h"]h$]h&]uh1jhjFubeh}(h]h ]h"]h$]h&]uh1jhjahMhjCubj)}(h[``phys_addr_t *phys`` if found, the physical address of the sub FDT is stored in **phys**. h](j)}(h``phys_addr_t *phys``h]j)}(hjh]hphys_addr_t *phys}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chMhjubj)}(hhh]h)}(hDif found, the physical address of the sub FDT is stored in **phys**.h](h;if found, the physical address of the sub FDT is stored in }(hjhhhNhNubjj)}(h**phys**h]hphys}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jihjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjCubeh}(h]h ]h"]h$]h&]uh1jhj'ubh)}(h**Description**h]jj)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jihjubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chM hj'ubh)}(hWRetrieve a preserved sub FDT named **name** and store its physical address in **phys**.h](h#Retrieve a preserved sub FDT named }(hjhhhNhNubjj)}(h**name**h]hname}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jihjubh# and store its physical address in }(hjhhhNhNubjj)}(h**phys**h]hphys}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jihjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chM hj'ubh)}(h **Return**h]jj)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jihjubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chM hj'ubh)}(h#0 on success, error code on failureh]h#0 on success, error code on failure}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/kho/concepts:73: ./kernel/kexec_handover.chM hj'ubeh}(h]h ] kernelindentah"]h$]h&]uh1j_hjhhhNhNubeh}(h] public-apiah ]h"] public apiah$]h&]uh1hhhhhhhhKHubeh}(h](kexec-handover-conceptsheh ]h"](kexec handover concepts kho-conceptseh$]h&]uh1hhhhhhhhKj }jWhsj }hhsubeh}(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_handlerjerror_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}(h]haj]jaunameids}(jWhjVjSjmjjjjjjjjjNjKu nametypes}(jWjVjmjjjjNuh}(hhjShjjhjjpjjjjjKjj.j7jjjKjPj\ ja j j j6 j; jjjjjju footnote_refs} citation_refs} autofootnotes]autofootnote_refs]symbol_footnotes]symbol_footnote_refs] footnotes] citations]autofootnote_startKsymbol_footnote_startK id_counter collectionsCounter}jKsRparse_messages]transform_messages](hsystem_message)}(hhh]h)}(hhh]h2Hyperlink target "kho-concepts" is not referenced.}hjsbah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]levelKtypeINFOsourcehlineKuh1jubj)}(hhh]h)}(hhh]h