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/driver-api/generic_ptmodnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Traditional)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget)/translations/zh_TW/driver-api/generic_ptmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget)/translations/it_IT/driver-api/generic_ptmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget)/translations/ja_JP/driver-api/generic_ptmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget)/translations/ko_KR/driver-api/generic_ptmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hPortuguese (Brazilian)}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget)/translations/pt_BR/driver-api/generic_ptmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget)/translations/sp_SP/driver-api/generic_ptmodnameN classnameN refexplicituh1hhh ubeh}(h]h ]h"]h$]h&]current_languageEnglishuh1h hh _documenthsourceNlineNubhcomment)}(h SPDX-License-Identifier: GPL-2.0h]h SPDX-License-Identifier: GPL-2.0}hhsbah}(h]h ]h"]h$]h&] xml:spacepreserveuh1hhhhhhC/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt.rsthKubhsection)}(hhh](htitle)}(hGeneric Radix Page Tableh]hGeneric Radix Page Table}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhhhKubh block_quote)}(hXGeneric Radix Page Table is a set of functions and helpers to efficiently parse radix style page tables typically seen in HW implementations. The interface is built to deliver similar code generation as the mm's pte/pmd/etc system by fully inlining the exact code required to handle each table level. Like the mm subsystem each format contributes its parsing implementation under common names and the common code implements the required algorithms. The system is divided into three logical levels: - The page table format and its manipulation functions - Generic helpers to give a consistent API regardless of underlying format - An algorithm implementation (e.g. IOMMU/DRM/KVM/MM) Multiple implementations are supported. The intention is to have the generic format code be re-usable for whatever specialized implementation is required. The generic code is solely about the format of the radix tree; it does not include memory allocation or higher level decisions that are left for the implementation. The generic framework supports a superset of functions across many HW implementations: - Entries comprised of contiguous blocks of IO PTEs for larger page sizes - Multi-level tables, up to 6 levels. Runtime selected top level - Runtime variable table level size (ARM's concatenated tables) - Expandable top level allowing dynamic sizing of table levels - Optional leaf entries at any level - 32-bit/64-bit virtual and output addresses, using every address bit - Dirty tracking - Sign extended addressing h](h paragraph)}(hX,Generic Radix Page Table is a set of functions and helpers to efficiently parse radix style page tables typically seen in HW implementations. The interface is built to deliver similar code generation as the mm's pte/pmd/etc system by fully inlining the exact code required to handle each table level.h]hX.Generic Radix Page Table is a set of functions and helpers to efficiently parse radix style page tables typically seen in HW implementations. The interface is built to deliver similar code generation as the mm’s pte/pmd/etc system by fully inlining the exact code required to handle each table level.}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhf/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:7: ./include/linux/generic_pt/common.hhK hhubh)}(hLike the mm subsystem each format contributes its parsing implementation under common names and the common code implements the required algorithms.h]hLike the mm subsystem each format contributes its parsing implementation under common names and the common code implements the required algorithms.}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhf/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:7: ./include/linux/generic_pt/common.hhKhhubh)}(h0The system is divided into three logical levels:h]h0The system is divided into three logical levels:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhf/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:7: ./include/linux/generic_pt/common.hhKhhubh)}(h- The page table format and its manipulation functions - Generic helpers to give a consistent API regardless of underlying format - An algorithm implementation (e.g. IOMMU/DRM/KVM/MM) h]h bullet_list)}(hhh](h list_item)}(h4The page table format and its manipulation functionsh]h)}(hjh]h4The page table format and its manipulation functions}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhf/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:7: ./include/linux/generic_pt/common.hhKhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hHGeneric helpers to give a consistent API regardless of underlying formath]h)}(hj7h]hHGeneric helpers to give a consistent API regardless of underlying format}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1hhf/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:7: ./include/linux/generic_pt/common.hhKhj5ubah}(h]h ]h"]h$]h&]uh1jhjubj)}(h4An algorithm implementation (e.g. IOMMU/DRM/KVM/MM) h]h)}(h3An algorithm implementation (e.g. IOMMU/DRM/KVM/MM)h]h3An algorithm implementation (e.g. IOMMU/DRM/KVM/MM)}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1hhf/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:7: ./include/linux/generic_pt/common.hhKhjMubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]bullet-uh1jhj.hKhjubah}(h]h ]h"]h$]h&]uh1hhj.hKhhubh)}(hX?Multiple implementations are supported. The intention is to have the generic format code be re-usable for whatever specialized implementation is required. The generic code is solely about the format of the radix tree; it does not include memory allocation or higher level decisions that are left for the implementation.h]hX?Multiple implementations are supported. The intention is to have the generic format code be re-usable for whatever specialized implementation is required. The generic code is solely about the format of the radix tree; it does not include memory allocation or higher level decisions that are left for the implementation.}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1hhf/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:7: ./include/linux/generic_pt/common.hhKhhubh)}(hVThe generic framework supports a superset of functions across many HW implementations:h]hVThe generic framework supports a superset of functions across many HW implementations:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhf/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:7: ./include/linux/generic_pt/common.hhK!hhubh)}(hX- Entries comprised of contiguous blocks of IO PTEs for larger page sizes - Multi-level tables, up to 6 levels. Runtime selected top level - Runtime variable table level size (ARM's concatenated tables) - Expandable top level allowing dynamic sizing of table levels - Optional leaf entries at any level - 32-bit/64-bit virtual and output addresses, using every address bit - Dirty tracking - Sign extended addressing h]j)}(hhh](j)}(hGEntries comprised of contiguous blocks of IO PTEs for larger page sizesh]h)}(hjh]hGEntries comprised of contiguous blocks of IO PTEs for larger page sizes}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhf/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:7: ./include/linux/generic_pt/common.hhK$hjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(h>Multi-level tables, up to 6 levels. Runtime selected top levelh]h)}(hjh]h>Multi-level tables, up to 6 levels. Runtime selected top level}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhf/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:7: ./include/linux/generic_pt/common.hhK%hjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(h=Runtime variable table level size (ARM's concatenated tables)h]h)}(hjh]h?Runtime variable table level size (ARM’s concatenated tables)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhf/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:7: ./include/linux/generic_pt/common.hhK&hjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(h #include "defs_amdv1.h" #include "../pt_defs.h" #include "amdv1.h" #include "../pt_common.h" #include "../pt_iter.h" #include "../iommu_pt.h" /* The IOMMU implementation */h]h#include #include "defs_amdv1.h" #include "../pt_defs.h" #include "amdv1.h" #include "../pt_common.h" #include "../pt_iter.h" #include "../iommu_pt.h" /* The IOMMU implementation */}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhK!hjhhubh)}(hiommu_pt.h includes definitions that will generate the operations functions for map/unmap/etc. using the definitions provided by AMDv1. The resulting module will have exported symbols named like pt_iommu_amdv1_init().h]hiommu_pt.h includes definitions that will generate the operations functions for map/unmap/etc. using the definitions provided by AMDv1. The resulting module will have exported symbols named like pt_iommu_amdv1_init().}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK)hjhhubh)}(hRefer to drivers/iommu/generic_pt/fmt/iommu_template.h for an example of how the IOMMU implementation uses multi-compilation to generate per-format ops structs pointers.h]hRefer to drivers/iommu/generic_pt/fmt/iommu_template.h for an example of how the IOMMU implementation uses multi-compilation to generate per-format ops structs pointers.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK-hjhhubh)}(hThe format code is written so that the common names arise from #defines to distinct format specific names. This is intended to aid debuggability by avoiding symbol clashes across all the different formats.h]hThe format code is written so that the common names arise from #defines to distinct format specific names. This is intended to aid debuggability by avoiding symbol clashes across all the different formats.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK1hjhhubh)}(hhExported symbols and other global names are mangled using a per-format string via the NS() helper macro.h]hhExported symbols and other global names are mangled using a per-format string via the NS() helper macro.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK5hjhhubh)}(hThe format uses struct pt_common as the top-level struct for the table, and each format will have its own struct pt_xxx which embeds it to store format-specific information.h]hThe format uses struct pt_common as the top-level struct for the table, and each format will have its own struct pt_xxx which embeds it to store format-specific information.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK8hjhhubh)}(hqThe implementation will further wrap struct pt_common in its own top-level struct, such as struct pt_iommu_amdv1.h]hqThe implementation will further wrap struct pt_common in its own top-level struct, such as struct pt_iommu_amdv1.}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubjq)}(hhh](jv)}(h``top_of_table`` Encodes the table top pointer and the top level in a single value. Must use READ_ONCE/WRITE_ONCE to access it. The lower bits of the aligned table pointer are used for the level. h](j|)}(h``top_of_table``h]hliteral)}(hjKh]h top_of_table}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1jMhjIubah}(h]h ]h"]h$]h&]uh1j{hg/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:66: ./include/linux/generic_pt/common.hhK8hjEubj)}(hhh]h)}(hEncodes the table top pointer and the top level in a single value. Must use READ_ONCE/WRITE_ONCE to access it. The lower bits of the aligned table pointer are used for the level.h]hEncodes the table top pointer and the top level in a single value. Must use READ_ONCE/WRITE_ONCE to access it. The lower bits of the aligned table pointer are used for the level.}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1hhg/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:66: ./include/linux/generic_pt/common.hhK6hjcubah}(h]h ]h"]h$]h&]uh1jhjEubeh}(h]h ]h"]h$]h&]uh1juhjbhK8hjBubjv)}(h``max_oasz_lg2`` Maximum number of bits the OA can contain. Upper bits must be zero. This may be less than what the page table format supports, but must not be more. h](j|)}(h``max_oasz_lg2``h]jN)}(hjh]h max_oasz_lg2}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jMhjubah}(h]h ]h"]h$]h&]uh1j{hg/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:66: ./include/linux/generic_pt/common.hhK>hjubj)}(hhh]h)}(hMaximum number of bits the OA can contain. Upper bits must be zero. This may be less than what the page table format supports, but must not be more.h]hMaximum number of bits the OA can contain. Upper bits must be zero. This may be less than what the page table format supports, but must not be more.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhg/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:66: ./include/linux/generic_pt/common.hhKhjBubjv)}(hX``max_vasz_lg2`` Maximum number of bits the VA can contain. Upper bits are 0 or 1 depending on pt_full_va_prefix(). This may be less than what the page table format supports, but must not be more. When PT_FEAT_DYNAMIC_TOP is set this reflects the maximum VA capability. h](j|)}(h``max_vasz_lg2``h]jN)}(hjh]h max_vasz_lg2}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jMhjubah}(h]h ]h"]h$]h&]uh1j{hg/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:66: ./include/linux/generic_pt/common.hhKEhjubj)}(hhh]h)}(hMaximum number of bits the VA can contain. Upper bits are 0 or 1 depending on pt_full_va_prefix(). This may be less than what the page table format supports, but must not be more. When PT_FEAT_DYNAMIC_TOP is set this reflects the maximum VA capability.h]hMaximum number of bits the VA can contain. Upper bits are 0 or 1 depending on pt_full_va_prefix(). This may be less than what the page table format supports, but must not be more. When PT_FEAT_DYNAMIC_TOP is set this reflects the maximum VA capability.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhg/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:66: ./include/linux/generic_pt/common.hhKBhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1juhjhKEhjBubjv)}(h)``features`` Bitmap of `enum pt_features`h](j|)}(h ``features``h]jN)}(hjh]hfeatures}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jMhjubah}(h]h ]h"]h$]h&]uh1j{hg/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:66: ./include/linux/generic_pt/common.hhKHhjubj)}(hhh]h)}(hBitmap of `enum pt_features`h](h Bitmap of }(hjhhhNhNubhtitle_reference)}(h`enum pt_features`h]henum pt_features}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1hhg/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:66: ./include/linux/generic_pt/common.hhKIhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1juhjhKHhjBubeh}(h]h ]h"]h$]h&]uh1jphjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj<hhhNhNubjN)}(hhh]h}(h]h ]h"]h$]h&]entries](jZpt_features (C enum) c.pt_featureshNtauh1jMhj<hhhNhNubj_)}(hhh](jd)}(h pt_featuresh]jj)}(henum pt_featuresh](jp)}(henumh]henum}(hjehhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johjahhhg/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:66: ./include/linux/generic_pt/common.hhKOubj)}(h h]h }(hjthhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjahhhjshKOubj)}(h pt_featuresh]j)}(hj_h]h pt_features}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]hhuh1jhjahhhjshKOubeh}(h]h ]h"]h$]h&]hhjuh1jijjhj]hhhjshKOubah}(h]jXah ](jjeh"]h$]h&]jj)jhuh1jchjshKOhjZhhubj)}(hhh]h)}(h?Features turned on in the table. Each symbol is a bit position.h]h?Features turned on in the table. Each symbol is a bit position.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhg/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:66: ./include/linux/generic_pt/common.hhKThjhhubah}(h]h ]h"]h$]h&]uh1jhjZhhhjshKOubeh}(h]h ](jenumeh"]h$]h&]jjjjjjjjjuh1j^hhhj<hNhNubj)}(hX**Constants** ``PT_FEAT_DMA_INCOHERENT`` Cache flush page table memory before assuming the HW can read it. Otherwise a SMP release is sufficient for HW to read it. ``PT_FEAT_FULL_VA`` The table can span the full VA range from 0 to PT_VADDR_MAX. ``PT_FEAT_DYNAMIC_TOP`` The table's top level can be increased dynamically during map. This requires HW support for atomically setting both the table top pointer and the starting table level. ``PT_FEAT_SIGN_EXTEND`` The top most bit of the valid VA range sign extends up to the full pt_vaddr_t. This divides the page table into three VA ranges:: 0 -> 2^N - 1 Lower 2^N -> (MAX - 2^N - 1) Non-Canonical MAX - 2^N -> MAX Upper In this mode pt_common::max_vasz_lg2 includes the sign bit and the upper bits that don't fall within the translation are just validated. If not set there is no sign extension and valid VA goes from 0 to 2^N - 1. ``PT_FEAT_FLUSH_RANGE`` IOTLB maintenance is done by flushing IOVA ranges which will clean out any walk cache or any IOPTE fully contained by the range. The optimization objective is to minimize the number of flushes even if ranges include IOVA gaps that do not need to be flushed. ``PT_FEAT_FLUSH_RANGE_NO_GAPS`` Like PT_FEAT_FLUSH_RANGE except that the optimization objective is to only flush IOVA that has been changed. This mode is suitable for cases like hypervisor shadowing where flushing unchanged ranges may cause the hypervisor to reparse significant amount of page table. ``PT_FEAT_DETAILED_GATHER`` Fill in the struct iommu_iotlb_gather pt sub structure with information about which levels were changed.h](h)}(h **Constants**h]j)}(hjh]h Constants}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhg/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:66: ./include/linux/generic_pt/common.hhKXhjubjq)}(hhh](jv)}(h``PT_FEAT_DMA_INCOHERENT`` Cache flush page table memory before assuming the HW can read it. Otherwise a SMP release is sufficient for HW to read it. h](j|)}(h``PT_FEAT_DMA_INCOHERENT``h]jN)}(hjh]hPT_FEAT_DMA_INCOHERENT}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jMhjubah}(h]h ]h"]h$]h&]uh1j{hg/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:66: ./include/linux/generic_pt/common.hhK]hjubj)}(hhh]h)}(hzCache flush page table memory before assuming the HW can read it. Otherwise a SMP release is sufficient for HW to read it.h]hzCache flush page table memory before assuming the HW can read it. Otherwise a SMP release is sufficient for HW to read it.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhg/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:66: ./include/linux/generic_pt/common.hhK[hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1juhjhK]hjubjv)}(hQ``PT_FEAT_FULL_VA`` The table can span the full VA range from 0 to PT_VADDR_MAX. h](j|)}(h``PT_FEAT_FULL_VA``h]jN)}(hj# h]hPT_FEAT_FULL_VA}(hj% hhhNhNubah}(h]h ]h"]h$]h&]uh1jMhj! ubah}(h]h ]h"]h$]h&]uh1j{hg/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:66: ./include/linux/generic_pt/common.hhKahj ubj)}(hhh]h)}(h 2^N - 1 Lower 2^N -> (MAX - 2^N - 1) Non-Canonical MAX - 2^N -> MAX Upper In this mode pt_common::max_vasz_lg2 includes the sign bit and the upper bits that don't fall within the translation are just validated. If not set there is no sign extension and valid VA goes from 0 to 2^N - 1. h](j|)}(h``PT_FEAT_SIGN_EXTEND``h]jN)}(hj h]hPT_FEAT_SIGN_EXTEND}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jMhj ubah}(h]h ]h"]h$]h&]uh1j{hg/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:66: ./include/linux/generic_pt/common.hhKuhj ubj)}(hhh](h)}(hThe top most bit of the valid VA range sign extends up to the full pt_vaddr_t. This divides the page table into three VA ranges::h]hThe top most bit of the valid VA range sign extends up to the full pt_vaddr_t. This divides the page table into three VA ranges:}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhg/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:66: ./include/linux/generic_pt/common.hhKihj ubj)}(h|0 -> 2^N - 1 Lower 2^N -> (MAX - 2^N - 1) Non-Canonical MAX - 2^N -> MAX Upperh]h|0 -> 2^N - 1 Lower 2^N -> (MAX - 2^N - 1) Non-Canonical MAX - 2^N -> MAX Upper}hj sbah}(h]h ]h"]h$]h&]hhuh1jhg/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:66: ./include/linux/generic_pt/common.hhKmhj ubh)}(hIn this mode pt_common::max_vasz_lg2 includes the sign bit and the upper bits that don't fall within the translation are just validated.h]hIn this mode pt_common::max_vasz_lg2 includes the sign bit and the upper bits that don’t fall within the translation are just validated.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhg/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:66: ./include/linux/generic_pt/common.hhKqhj ubh)}(hJIf not set there is no sign extension and valid VA goes from 0 to 2^N - 1.h]hJIf not set there is no sign extension and valid VA goes from 0 to 2^N - 1.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhg/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:66: ./include/linux/generic_pt/common.hhKthj ubeh}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1juhj hKuhjubjv)}(hX``PT_FEAT_FLUSH_RANGE`` IOTLB maintenance is done by flushing IOVA ranges which will clean out any walk cache or any IOPTE fully contained by the range. The optimization objective is to minimize the number of flushes even if ranges include IOVA gaps that do not need to be flushed. h](j|)}(h``PT_FEAT_FLUSH_RANGE``h]jN)}(hj h]hPT_FEAT_FLUSH_RANGE}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jMhj ubah}(h]h ]h"]h$]h&]uh1j{hg/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:66: ./include/linux/generic_pt/common.hhK|hj ubj)}(hhh]h)}(hXIOTLB maintenance is done by flushing IOVA ranges which will clean out any walk cache or any IOPTE fully contained by the range. The optimization objective is to minimize the number of flushes even if ranges include IOVA gaps that do not need to be flushed.h]hXIOTLB maintenance is done by flushing IOVA ranges which will clean out any walk cache or any IOPTE fully contained by the range. The optimization objective is to minimize the number of flushes even if ranges include IOVA gaps that do not need to be flushed.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhg/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:66: ./include/linux/generic_pt/common.hhKxhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1juhj hK|hjubjv)}(hX-``PT_FEAT_FLUSH_RANGE_NO_GAPS`` Like PT_FEAT_FLUSH_RANGE except that the optimization objective is to only flush IOVA that has been changed. This mode is suitable for cases like hypervisor shadowing where flushing unchanged ranges may cause the hypervisor to reparse significant amount of page table. h](j|)}(h``PT_FEAT_FLUSH_RANGE_NO_GAPS``h]jN)}(hj8 h]hPT_FEAT_FLUSH_RANGE_NO_GAPS}(hj: hhhNhNubah}(h]h ]h"]h$]h&]uh1jMhj6 ubah}(h]h ]h"]h$]h&]uh1j{hg/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:66: ./include/linux/generic_pt/common.hhKhj2 ubj)}(hhh]h)}(hX Like PT_FEAT_FLUSH_RANGE except that the optimization objective is to only flush IOVA that has been changed. This mode is suitable for cases like hypervisor shadowing where flushing unchanged ranges may cause the hypervisor to reparse significant amount of page table.h]hX Like PT_FEAT_FLUSH_RANGE except that the optimization objective is to only flush IOVA that has been changed. This mode is suitable for cases like hypervisor shadowing where flushing unchanged ranges may cause the hypervisor to reparse significant amount of page table.}(hjQ hhhNhNubah}(h]h ]h"]h$]h&]uh1hhg/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:66: ./include/linux/generic_pt/common.hhKhjN ubah}(h]h ]h"]h$]h&]uh1jhj2 ubeh}(h]h ]h"]h$]h&]uh1juhjM hKhjubjv)}(h``PT_FEAT_DETAILED_GATHER`` Fill in the struct iommu_iotlb_gather pt sub structure with information about which levels were changed.h](j|)}(h``PT_FEAT_DETAILED_GATHER``h]jN)}(hjr h]hPT_FEAT_DETAILED_GATHER}(hjt hhhNhNubah}(h]h ]h"]h$]h&]uh1jMhjp ubah}(h]h ]h"]h$]h&]uh1j{hg/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:66: ./include/linux/generic_pt/common.hhKhjl ubj)}(hhh]h)}(hhFill in the struct iommu_iotlb_gather pt sub structure with information about which levels were changed.h]hhFill in the struct iommu_iotlb_gather pt sub structure with information about which levels were changed.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hKhj ubah}(h]h ]h"]h$]h&]uh1jhjl ubeh}(h]h ]h"]h$]h&]uh1juhj hKhjubeh}(h]h ]h"]h$]h&]uh1jphjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj<hhhNhNubjN)}(hhh]h}(h]h ]h"]h$]h&]entries](jZpt_attr_from_entry (C function)c.pt_attr_from_entryhNtauh1jMhj<hhhNhNubj_)}(hhh](jd)}(hRvoid pt_attr_from_entry (const struct pt_state *pts, struct pt_write_attrs *attrs)h]jj)}(hQvoid pt_attr_from_entry(const struct pt_state *pts, struct pt_write_attrs *attrs)h](hdesc_sig_keyword_type)}(hvoidh]hvoid}(hj hhhNhNubah}(h]h ]ktah"]h$]h&]uh1j hj hhhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhK ubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhj hK ubj)}(hpt_attr_from_entryh]j)}(hpt_attr_from_entryh]hpt_attr_from_entry}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ](jjeh"]h$]h&]hhuh1jhj hhhj hK ubhdesc_parameterlist)}(h:(const struct pt_state *pts, struct pt_write_attrs *attrs)h](hdesc_parameter)}(hconst struct pt_state *ptsh](jp)}(hconsth]hconst}(hj hhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johj ubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubjp)}(hjsh]hstruct}(hj+ hhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johj ubj)}(h h]h }(hj8 hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubh)}(hhh]j)}(hpt_stateh]hpt_state}(hjI hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjF ubah}(h]h ]h"]h$]h&] refdomainjreftype identifier reftargetjK modnameN classnameN c:parent_keysphinx.domains.c LookupKey)}data]jd ASTIdentifier)}j_ j sbc.pt_attr_from_entryasbuh1hhj ubj)}(h h]h }(hjq hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubhdesc_sig_punctuation)}(h*h]h*}(hj hhhNhNubah}(h]h ]pah"]h$]h&]uh1j hj ubj)}(hptsh]hpts}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]noemphhhuh1j hj ubj )}(hstruct pt_write_attrs *attrsh](jp)}(hjsh]hstruct}(hj hhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johj ubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubh)}(hhh]j)}(hpt_write_attrsh]hpt_write_attrs}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetj modnameN classnameNjc jf )}ji ]jm c.pt_attr_from_entryasbuh1hhj ubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj )}(hj h]h*}(hj hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj ubj)}(hattrsh]hattrs}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]noemphhhuh1j hj ubeh}(h]h ]h"]h$]h&]hhuh1j hj hhhj hK ubeh}(h]h ]h"]h$]h&]hhjuh1jijjhj hhhj hK ubah}(h]j ah ](jjeh"]h$]h&]jj)jhuh1jchj hK hj hhubj)}(hhh]h)}(h)Convert the permission bits back to attrsh]h)Convert the permission bits back to attrs}(hj* hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhK hj' hhubah}(h]h ]h"]h$]h&]uh1jhj hhhj hK ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjB jjB jjjuh1j^hhhj<hNhNubj)}(hX1**Parameters** ``const struct pt_state *pts`` Entry to convert from ``struct pt_write_attrs *attrs`` Resulting attrs **Description** Fill in the attrs with the permission bits encoded in the current leaf entry. The attrs should be usable with pt_install_leaf_entry() to reconstruct the same entry.h](h)}(h**Parameters**h]j)}(hjL h]h Parameters}(hjN hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjJ ubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhK$hjF ubjq)}(hhh](jv)}(h5``const struct pt_state *pts`` Entry to convert from h](j|)}(h``const struct pt_state *pts``h]jN)}(hjk h]hconst struct pt_state *pts}(hjm hhhNhNubah}(h]h ]h"]h$]h&]uh1jMhji ubah}(h]h ]h"]h$]h&]uh1j{hj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhK!hje ubj)}(hhh]h)}(hEntry to convert fromh]hEntry to convert from}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hK!hj ubah}(h]h ]h"]h$]h&]uh1jhje ubeh}(h]h ]h"]h$]h&]uh1juhj hK!hjb ubjv)}(h1``struct pt_write_attrs *attrs`` Resulting attrs h](j|)}(h ``struct pt_write_attrs *attrs``h]jN)}(hj h]hstruct pt_write_attrs *attrs}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jMhj ubah}(h]h ]h"]h$]h&]uh1j{hj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhK"hj ubj)}(hhh]h)}(hResulting attrsh]hResulting attrs}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hK"hj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1juhj hK"hjb ubeh}(h]h ]h"]h$]h&]uh1jphjF ubh)}(h**Description**h]j)}(hj h]h Description}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhK$hjF ubh)}(hFill in the attrs with the permission bits encoded in the current leaf entry. The attrs should be usable with pt_install_leaf_entry() to reconstruct the same entry.h]hFill in the attrs with the permission bits encoded in the current leaf entry. The attrs should be usable with pt_install_leaf_entry() to reconstruct the same entry.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhK#hjF ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj<hhhNhNubjN)}(hhh]h}(h]h ]h"]h$]h&]entries](jZpt_can_have_leaf (C function)c.pt_can_have_leafhNtauh1jMhj<hhhNhNubj_)}(hhh](jd)}(h2bool pt_can_have_leaf (const struct pt_state *pts)h]jj)}(h1bool pt_can_have_leaf(const struct pt_state *pts)h](j )}(hboolh]hbool}(hj$ hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj hhhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhK,ubj)}(h h]h }(hj3 hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhj2 hK,ubj)}(hpt_can_have_leafh]j)}(hpt_can_have_leafh]hpt_can_have_leaf}(hjE hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjA ubah}(h]h ](jjeh"]h$]h&]hhuh1jhj hhhj2 hK,ubj )}(h(const struct pt_state *pts)h]j )}(hconst struct pt_state *ptsh](jp)}(hj h]hconst}(hja hhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johj] ubj)}(h h]h }(hjn hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj] ubjp)}(hjsh]hstruct}(hj| hhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johj] ubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj] ubh)}(hhh]j)}(hpt_stateh]hpt_state}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetj modnameN classnameNjc jf )}ji ]jl )}j_ jG sbc.pt_can_have_leafasbuh1hhj] ubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj] ubj )}(hj h]h*}(hj hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj] ubj)}(hptsh]hpts}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj] ubeh}(h]h ]h"]h$]h&]noemphhhuh1j hjY ubah}(h]h ]h"]h$]h&]hhuh1j hj hhhj2 hK,ubeh}(h]h ]h"]h$]h&]hhjuh1jijjhj hhhj2 hK,ubah}(h]j ah ](jjeh"]h$]h&]jj)jhuh1jchj2 hK,hj hhubj)}(hhh]h)}(h.True if the current level can have an OA entryh]h.True if the current level can have an OA entry}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhK,hj hhubah}(h]h ]h"]h$]h&]uh1jhj hhhj2 hK,ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1j^hhhj<hNhNubj)}(h**Parameters** ``const struct pt_state *pts`` The current level **Description** True if the current level can support pt_install_leaf_entry(). A leaf entry produce an OA.h](h)}(h**Parameters**h]j)}(hj!h]h Parameters}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhK0hjubjq)}(hhh]jv)}(h1``const struct pt_state *pts`` The current level h](j|)}(h``const struct pt_state *pts``h]jN)}(hj@h]hconst struct pt_state *pts}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1jMhj>ubah}(h]h ]h"]h$]h&]uh1j{hj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhK-hj:ubj)}(hhh]h)}(hThe current levelh]hThe current level}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjUhK-hjVubah}(h]h ]h"]h$]h&]uh1jhj:ubeh}(h]h ]h"]h$]h&]uh1juhjUhK-hj7ubah}(h]h ]h"]h$]h&]uh1jphjubh)}(h**Description**h]j)}(hj{h]h Description}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjyubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhK/hjubh)}(hZTrue if the current level can support pt_install_leaf_entry(). A leaf entry produce an OA.h]hZTrue if the current level can support pt_install_leaf_entry(). A leaf entry produce an OA.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhK.hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj<hhhNhNubjN)}(hhh]h}(h]h ]h"]h$]h&]entries](jZpt_can_have_table (C function)c.pt_can_have_tablehNtauh1jMhj<hhhNhNubj_)}(hhh](jd)}(h3bool pt_can_have_table (const struct pt_state *pts)h]jj)}(h2bool pt_can_have_table(const struct pt_state *pts)h](j )}(hj& h]hbool}(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjhhhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhK5ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhK5ubj)}(hpt_can_have_tableh]j)}(hpt_can_have_tableh]hpt_can_have_table}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]hhuh1jhjhhhjhK5ubj )}(h(const struct pt_state *pts)h]j )}(hconst struct pt_state *ptsh](jp)}(hj h]hconst}(hjhhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johjubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjp)}(hjsh]hstruct}(hjhhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johjubj)}(h h]h }(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hpt_stateh]hpt_state}(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2ubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetj7modnameN classnameNjc jf )}ji ]jl )}j_ jsbc.pt_can_have_tableasbuh1hhjubj)}(h h]h }(hjUhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj )}(hj h]h*}(hjchhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjubj)}(hptsh]hpts}(hjphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1j hjubah}(h]h ]h"]h$]h&]hhuh1j hjhhhjhK5ubeh}(h]h ]h"]h$]h&]hhjuh1jijjhjhhhjhK5ubah}(h]jah ](jjeh"]h$]h&]jj)jhuh1jchjhK5hjhhubj)}(hhh]h)}(h0True if the current level can have a lower tableh]h0True if the current level can have a lower table}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhK5hjhhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhK5ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1j^hhhj<hNhNubj)}(h**Parameters** ``const struct pt_state *pts`` The current level **Description** Every level except 0 is allowed to have a lower table.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhK9hjubjq)}(hhh]jv)}(h1``const struct pt_state *pts`` The current level h](j|)}(h``const struct pt_state *pts``h]jN)}(hjh]hconst struct pt_state *pts}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jMhjubah}(h]h ]h"]h$]h&]uh1j{hj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhK6hjubj)}(hhh]h)}(hThe current levelh]hThe current level}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhK6hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1juhjhK6hjubah}(h]h ]h"]h$]h&]uh1jphjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhK8hjubh)}(h6Every level except 0 is allowed to have a lower table.h]h6Every level except 0 is allowed to have a lower table.}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhK7hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj<hhhNhNubjN)}(hhh]h}(h]h ]h"]h$]h&]entries](jZpt_clear_entries (C function)c.pt_clear_entrieshNtauh1jMhj<hhhNhNubj_)}(hhh](jd)}(hIvoid pt_clear_entries (struct pt_state *pts, unsigned int num_contig_lg2)h]jj)}(hHvoid pt_clear_entries(struct pt_state *pts, unsigned int num_contig_lg2)h](j )}(hvoidh]hvoid}(hj[hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjWhhhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKAubj)}(h h]h }(hjjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjWhhhjihKAubj)}(hpt_clear_entriesh]j)}(hpt_clear_entriesh]hpt_clear_entries}(hj|hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjxubah}(h]h ](jjeh"]h$]h&]hhuh1jhjWhhhjihKAubj )}(h3(struct pt_state *pts, unsigned int num_contig_lg2)h](j )}(hstruct pt_state *ptsh](jp)}(hjsh]hstruct}(hjhhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hpt_stateh]hpt_state}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetjmodnameN classnameNjc jf )}ji ]jl )}j_ j~sbc.pt_clear_entriesasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj )}(hj h]h*}(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjubj)}(hptsh]hpts}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1j hjubj )}(hunsigned int num_contig_lg2h](j )}(hunsignedh]hunsigned}(hj hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj )}(hinth]hint}(hj&hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjubj)}(h h]h }(hj4hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hnum_contig_lg2h]hnum_contig_lg2}(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1j hjubeh}(h]h ]h"]h$]h&]hhuh1j hjWhhhjihKAubeh}(h]h ]h"]h$]h&]hhjuh1jijjhjShhhjihKAubah}(h]jNah ](jjeh"]h$]h&]jj)jhuh1jchjihKAhjPhhubj)}(hhh]h)}(h Make entries empty (non-present)h]h Make entries empty (non-present)}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKAhjihhubah}(h]h ]h"]h$]h&]uh1jhjPhhhjihKAubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1j^hhhj<hNhNubj)}(hXF**Parameters** ``struct pt_state *pts`` Starting table index ``unsigned int num_contig_lg2`` Number of contiguous items to clear **Description** Clear a run of entries. A cleared entry will load back as PT_ENTRY_EMPTY and does not have any effect on table walking. The starting index must be aligned to num_contig_lg2.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKEhjubjq)}(hhh](jv)}(h.``struct pt_state *pts`` Starting table index h](j|)}(h``struct pt_state *pts``h]jN)}(hjh]hstruct pt_state *pts}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jMhjubah}(h]h ]h"]h$]h&]uh1j{hj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKBhjubj)}(hhh]h)}(hStarting table indexh]hStarting table index}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKBhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1juhjhKBhjubjv)}(hD``unsigned int num_contig_lg2`` Number of contiguous items to clear h](j|)}(h``unsigned int num_contig_lg2``h]jN)}(hjh]hunsigned int num_contig_lg2}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jMhjubah}(h]h ]h"]h$]h&]uh1j{hj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKChjubj)}(hhh]h)}(h#Number of contiguous items to clearh]h#Number of contiguous items to clear}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKChjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1juhjhKChjubeh}(h]h ]h"]h$]h&]uh1jphjubh)}(h**Description**h]j)}(hj!h]h Description}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKEhjubh)}(hClear a run of entries. A cleared entry will load back as PT_ENTRY_EMPTY and does not have any effect on table walking. The starting index must be aligned to num_contig_lg2.h]hClear a run of entries. A cleared entry will load back as PT_ENTRY_EMPTY and does not have any effect on table walking. The starting index must be aligned to num_contig_lg2.}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKDhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj<hhhNhNubjN)}(hhh]h}(h]h ]h"]h$]h&]entries](jZ&pt_entry_make_write_dirty (C function)c.pt_entry_make_write_dirtyhNtauh1jMhj<hhhNhNubj_)}(hhh](jd)}(h5bool pt_entry_make_write_dirty (struct pt_state *pts)h]jj)}(h4bool pt_entry_make_write_dirty(struct pt_state *pts)h](j )}(hj& h]hbool}(hjfhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjbhhhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKMubj)}(h h]h }(hjthhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjbhhhjshKMubj)}(hpt_entry_make_write_dirtyh]j)}(hpt_entry_make_write_dirtyh]hpt_entry_make_write_dirty}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]hhuh1jhjbhhhjshKMubj )}(h(struct pt_state *pts)h]j )}(hstruct pt_state *ptsh](jp)}(hjsh]hstruct}(hjhhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hpt_stateh]hpt_state}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetjmodnameN classnameNjc jf )}ji ]jl )}j_ jsbc.pt_entry_make_write_dirtyasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj )}(hj h]h*}(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjubj)}(hptsh]hpts}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1j hjubah}(h]h ]h"]h$]h&]hhuh1j hjbhhhjshKMubeh}(h]h ]h"]h$]h&]hhjuh1jijjhj^hhhjshKMubah}(h]jYah ](jjeh"]h$]h&]jj)jhuh1jchjshKMhj[hhubj)}(hhh]h)}(hMake an entry dirtyh]hMake an entry dirty}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKMhj"hhubah}(h]h ]h"]h$]h&]uh1jhj[hhhjshKMubeh}(h]h ](jfunctioneh"]h$]h&]jjjj=jj=jjjuh1j^hhhj<hNhNubj)}(hX**Parameters** ``struct pt_state *pts`` Table entry to change **Description** Make pt_entry_is_write_dirty() return true for this entry. This can be called asynchronously with any other table manipulation under a RCU lock and must not corrupt the table.h](h)}(h**Parameters**h]j)}(hjGh]h Parameters}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjEubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKQhjAubjq)}(hhh]jv)}(h/``struct pt_state *pts`` Table entry to change h](j|)}(h``struct pt_state *pts``h]jN)}(hjfh]hstruct pt_state *pts}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1jMhjdubah}(h]h ]h"]h$]h&]uh1j{hj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKNhj`ubj)}(hhh]h)}(hTable entry to changeh]hTable entry to change}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj{hKNhj|ubah}(h]h ]h"]h$]h&]uh1jhj`ubeh}(h]h ]h"]h$]h&]uh1juhj{hKNhj]ubah}(h]h ]h"]h$]h&]uh1jphjAubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKPhjAubh)}(hMake pt_entry_is_write_dirty() return true for this entry. This can be called asynchronously with any other table manipulation under a RCU lock and must not corrupt the table.h]hMake pt_entry_is_write_dirty() return true for this entry. This can be called asynchronously with any other table manipulation under a RCU lock and must not corrupt the table.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKOhjAubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj<hhhNhNubjN)}(hhh]h}(h]h ]h"]h$]h&]entries](jZ&pt_entry_make_write_clean (C function)c.pt_entry_make_write_cleanhNtauh1jMhj<hhhNhNubj_)}(hhh](jd)}(h5void pt_entry_make_write_clean (struct pt_state *pts)h]jj)}(h4void pt_entry_make_write_clean(struct pt_state *pts)h](j )}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjhhhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKWubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhKWubj)}(hpt_entry_make_write_cleanh]j)}(hpt_entry_make_write_cleanh]hpt_entry_make_write_clean}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]hhuh1jhjhhhjhKWubj )}(h(struct pt_state *pts)h]j )}(hstruct pt_state *ptsh](jp)}(hjsh]hstruct}(hj#hhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johjubj)}(h h]h }(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hpt_stateh]hpt_state}(hjAhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>ubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetjCmodnameN classnameNjc jf )}ji ]jl )}j_ j sbc.pt_entry_make_write_cleanasbuh1hhjubj)}(h h]h }(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj )}(hj h]h*}(hjohhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjubj)}(hptsh]hpts}(hj|hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1j hjubah}(h]h ]h"]h$]h&]hhuh1j hjhhhjhKWubeh}(h]h ]h"]h$]h&]hhjuh1jijjhjhhhjhKWubah}(h]jah ](jjeh"]h$]h&]jj)jhuh1jchjhKWhjhhubj)}(hhh]h)}(hMake the entry write cleanh]hMake the entry write clean}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKWhjhhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhKWubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1j^hhhj<hNhNubj)}(hX**Parameters** ``struct pt_state *pts`` Table entry to change **Description** Modify the entry so that pt_entry_is_write_dirty() == false. The HW will eventually be notified of this change via a TLB flush, which is the point that the HW must become synchronized. Any "write dirty" prior to the TLB flush can be lost, but once the TLB flush completes all writes must make their entries write dirty. The format should alter the entry in a way that is compatible with any concurrent update from HW. The entire contiguous entry is changed.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhK[hjubjq)}(hhh]jv)}(h/``struct pt_state *pts`` Table entry to change h](j|)}(h``struct pt_state *pts``h]jN)}(hjh]hstruct pt_state *pts}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jMhjubah}(h]h ]h"]h$]h&]uh1j{hj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKXhjubj)}(hhh]h)}(hTable entry to changeh]hTable entry to change}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKXhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1juhjhKXhjubah}(h]h ]h"]h$]h&]uh1jphjubh)}(h**Description**h]j)}(hj"h]h Description}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKZhjubh)}(hX?Modify the entry so that pt_entry_is_write_dirty() == false. The HW will eventually be notified of this change via a TLB flush, which is the point that the HW must become synchronized. Any "write dirty" prior to the TLB flush can be lost, but once the TLB flush completes all writes must make their entries write dirty.h]hXCModify the entry so that pt_entry_is_write_dirty() == false. The HW will eventually be notified of this change via a TLB flush, which is the point that the HW must become synchronized. Any “write dirty” prior to the TLB flush can be lost, but once the TLB flush completes all writes must make their entries write dirty.}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKYhjubh)}(hThe format should alter the entry in a way that is compatible with any concurrent update from HW. The entire contiguous entry is changed.h]hThe format should alter the entry in a way that is compatible with any concurrent update from HW. The entire contiguous entry is changed.}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhK_hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj<hhhNhNubjN)}(hhh]h}(h]h ]h"]h$]h&]entries](jZ$pt_entry_is_write_dirty (C function)c.pt_entry_is_write_dirtyhNtauh1jMhj<hhhNhNubj_)}(hhh](jd)}(h9bool pt_entry_is_write_dirty (const struct pt_state *pts)h]jj)}(h8bool pt_entry_is_write_dirty(const struct pt_state *pts)h](j )}(hj& h]hbool}(hjvhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjrhhhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKfubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjrhhhjhKfubj)}(hpt_entry_is_write_dirtyh]j)}(hpt_entry_is_write_dirtyh]hpt_entry_is_write_dirty}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]hhuh1jhjrhhhjhKfubj )}(h(const struct pt_state *pts)h]j )}(hconst struct pt_state *ptsh](jp)}(hj h]hconst}(hjhhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjp)}(hjsh]hstruct}(hjhhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hpt_stateh]hpt_state}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetjmodnameN classnameNjc jf )}ji ]jl )}j_ jsbc.pt_entry_is_write_dirtyasbuh1hhjubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj )}(hj h]h*}(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjubj)}(hptsh]hpts}(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1j hjubah}(h]h ]h"]h$]h&]hhuh1j hjrhhhjhKfubeh}(h]h ]h"]h$]h&]hhjuh1jijjhjnhhhjhKfubah}(h]jiah ](jjeh"]h$]h&]jj)jhuh1jchjhKfhjkhhubj)}(hhh]h)}(h%True if the entry has been written toh]h%True if the entry has been written to}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKfhjMhhubah}(h]h ]h"]h$]h&]uh1jhjkhhhjhKfubeh}(h]h ](jfunctioneh"]h$]h&]jjjjhjjhjjjuh1j^hhhj<hNhNubj)}(hX**Parameters** ``const struct pt_state *pts`` Entry to query **Description** "write dirty" means that the HW has written to the OA translated by this entry. If the entry is contiguous then the consolidated "write dirty" for all the items must be returned.h](h)}(h**Parameters**h]j)}(hjrh]h Parameters}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jhjpubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKjhjlubjq)}(hhh]jv)}(h.``const struct pt_state *pts`` Entry to query h](j|)}(h``const struct pt_state *pts``h]jN)}(hjh]hconst struct pt_state *pts}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jMhjubah}(h]h ]h"]h$]h&]uh1j{hj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKghjubj)}(hhh]h)}(hEntry to queryh]hEntry to query}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKghjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1juhjhKghjubah}(h]h ]h"]h$]h&]uh1jphjlubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKihjlubh)}(h"write dirty" means that the HW has written to the OA translated by this entry. If the entry is contiguous then the consolidated "write dirty" for all the items must be returned.h]h“write dirty” means that the HW has written to the OA translated by this entry. If the entry is contiguous then the consolidated “write dirty” for all the items must be returned.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKhhjlubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj<hhhNhNubjN)}(hhh]h}(h]h ]h"]h$]h&]entries](jZpt_dirty_supported (C function)c.pt_dirty_supportedhNtauh1jMhj<hhhNhNubj_)}(hhh](jd)}(h2bool pt_dirty_supported (struct pt_common *common)h]jj)}(h1bool pt_dirty_supported(struct pt_common *common)h](j )}(hj& h]hbool}(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj hhhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKpubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhjhKpubj)}(hpt_dirty_supportedh]j)}(hpt_dirty_supportedh]hpt_dirty_supported}(hj1hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-ubah}(h]h ](jjeh"]h$]h&]hhuh1jhj hhhjhKpubj )}(h(struct pt_common *common)h]j )}(hstruct pt_common *commonh](jp)}(hjsh]hstruct}(hjMhhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johjIubj)}(h h]h }(hjZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIubh)}(hhh]j)}(h pt_commonh]h pt_common}(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetjmmodnameN classnameNjc jf )}ji ]jl )}j_ j3sbc.pt_dirty_supportedasbuh1hhjIubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIubj )}(hj h]h*}(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjIubj)}(hcommonh]hcommon}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIubeh}(h]h ]h"]h$]h&]noemphhhuh1j hjEubah}(h]h ]h"]h$]h&]hhuh1j hj hhhjhKpubeh}(h]h ]h"]h$]h&]hhjuh1jijjhj hhhjhKpubah}(h]jah ](jjeh"]h$]h&]jj)jhuh1jchjhKphjhhubj)}(hhh]h)}(h.True if the page table supports dirty trackingh]h.True if the page table supports dirty tracking}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKphjhhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhKpubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1j^hhhj<hNhNubj)}(hB**Parameters** ``struct pt_common *common`` Page table to queryh](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKthjubjq)}(hhh]jv)}(h0``struct pt_common *common`` Page table to queryh](j|)}(h``struct pt_common *common``h]jN)}(hjh]hstruct pt_common *common}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jMhjubah}(h]h ]h"]h$]h&]uh1j{hj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKvhj ubj)}(hhh]h)}(hPage table to queryh]hPage table to query}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKqhj'ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1juhj&hKvhjubah}(h]h ]h"]h$]h&]uh1jphjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj<hhhNhNubjN)}(hhh]h}(h]h ]h"]h$]h&]entries](jZ$pt_entry_num_contig_lg2 (C function)c.pt_entry_num_contig_lg2hNtauh1jMhj<hhhNhNubj_)}(hhh](jd)}(hAunsigned int pt_entry_num_contig_lg2 (const struct pt_state *pts)h]jj)}(h@unsigned int pt_entry_num_contig_lg2(const struct pt_state *pts)h](j )}(hunsignedh]hunsigned}(hjkhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjghhhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKvubj)}(h h]h }(hjzhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjghhhjyhKvubj )}(hinth]hint}(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjghhhjyhKvubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjghhhjyhKvubj)}(hpt_entry_num_contig_lg2h]j)}(hpt_entry_num_contig_lg2h]hpt_entry_num_contig_lg2}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]hhuh1jhjghhhjyhKvubj )}(h(const struct pt_state *pts)h]j )}(hconst struct pt_state *ptsh](jp)}(hj h]hconst}(hjhhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjp)}(hjsh]hstruct}(hjhhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hpt_stateh]hpt_state}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetjmodnameN classnameNjc jf )}ji ]jl )}j_ jsbc.pt_entry_num_contig_lg2asbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj )}(hj h]h*}(hj+hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjubj)}(hptsh]hpts}(hj8hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1j hjubah}(h]h ]h"]h$]h&]hhuh1j hjghhhjyhKvubeh}(h]h ]h"]h$]h&]hhjuh1jijjhjchhhjyhKvubah}(h]j^ah ](jjeh"]h$]h&]jj)jhuh1jchjyhKvhj`hhubj)}(hhh]h)}(h.Number of contiguous items for this leaf entryh]h.Number of contiguous items for this leaf entry}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKvhj_hhubah}(h]h ]h"]h$]h&]uh1jhj`hhhjyhKvubeh}(h]h ](jfunctioneh"]h$]h&]jjjjzjjzjjjuh1j^hhhj<hNhNubj)}(h**Parameters** ``const struct pt_state *pts`` Entry to query **Description** Return the number of contiguous items this leaf entry spans. If the entry is single item it returns ilog2(1).h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKzhj~ubjq)}(hhh]jv)}(h.``const struct pt_state *pts`` Entry to query h](j|)}(h``const struct pt_state *pts``h]jN)}(hjh]hconst struct pt_state *pts}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jMhjubah}(h]h ]h"]h$]h&]uh1j{hj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKwhjubj)}(hhh]h)}(hEntry to queryh]hEntry to query}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKwhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1juhjhKwhjubah}(h]h ]h"]h$]h&]uh1jphj~ubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKyhj~ubh)}(hmReturn the number of contiguous items this leaf entry spans. If the entry is single item it returns ilog2(1).h]hmReturn the number of contiguous items this leaf entry spans. If the entry is single item it returns ilog2(1).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKxhj~ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj<hhhNhNubjN)}(hhh]h}(h]h ]h"]h$]h&]entries](jZpt_entry_oa (C function) c.pt_entry_oahNtauh1jMhj<hhhNhNubj_)}(hhh](jd)}(h3pt_oaddr_t pt_entry_oa (const struct pt_state *pts)h]jj)}(h2pt_oaddr_t pt_entry_oa(const struct pt_state *pts)h](h)}(hhh]j)}(h pt_oaddr_th]h pt_oaddr_t}(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#ubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetj(modnameN classnameNjc jf )}ji ]jl )}j_ pt_entry_oasb c.pt_entry_oaasbuh1hhjhhhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKubj)}(h h]h }(hjHhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjGhKubj)}(h pt_entry_oah]j)}(hjDh]h pt_entry_oa}(hjZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVubah}(h]h ](jjeh"]h$]h&]hhuh1jhjhhhjGhKubj )}(h(const struct pt_state *pts)h]j )}(hconst struct pt_state *ptsh](jp)}(hj h]hconst}(hjuhhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johjqubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjqubjp)}(hjsh]hstruct}(hjhhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johjqubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjqubh)}(hhh]j)}(hpt_stateh]hpt_state}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetjmodnameN classnameNjc jf )}ji ]jB c.pt_entry_oaasbuh1hhjqubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjqubj )}(hj h]h*}(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjqubj)}(hptsh]hpts}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjqubeh}(h]h ]h"]h$]h&]noemphhhuh1j hjmubah}(h]h ]h"]h$]h&]hhuh1j hjhhhjGhKubeh}(h]h ]h"]h$]h&]hhjuh1jijjhjhhhjGhKubah}(h]jah ](jjeh"]h$]h&]jj)jhuh1jchjGhKhjhhubj)}(hhh]h)}(h"Output Address for this leaf entryh]h"Output Address for this leaf entry}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKhjhhubah}(h]h ]h"]h$]h&]uh1jhjhhhjGhKubeh}(h]h ](jfunctioneh"]h$]h&]jjjj)jj)jjjuh1j^hhhj<hNhNubj)}(hX**Parameters** ``const struct pt_state *pts`` Entry to query **Description** Return the output address for the start of the entry. If the entry is contiguous this returns the same value for each sub-item. I.e.:: log2_mod(pt_entry_oa(), pt_entry_oa_lg2sz()) == 0 See pt_item_oa(). The format should implement one of these two functions depending on how it stores the OAs in the table.h](h)}(h**Parameters**h]j)}(hj3h]h Parameters}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj1ubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKhj-ubjq)}(hhh]jv)}(h.``const struct pt_state *pts`` Entry to query h](j|)}(h``const struct pt_state *pts``h]jN)}(hjRh]hconst struct pt_state *pts}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jMhjPubah}(h]h ]h"]h$]h&]uh1j{hj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKhjLubj)}(hhh]h)}(hEntry to queryh]hEntry to query}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjghKhjhubah}(h]h ]h"]h$]h&]uh1jhjLubeh}(h]h ]h"]h$]h&]uh1juhjghKhjIubah}(h]h ]h"]h$]h&]uh1jphj-ubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKhj-ubh)}(hReturn the output address for the start of the entry. If the entry is contiguous this returns the same value for each sub-item. I.e.::h]hReturn the output address for the start of the entry. If the entry is contiguous this returns the same value for each sub-item. I.e.:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKhj-ubj)}(h1log2_mod(pt_entry_oa(), pt_entry_oa_lg2sz()) == 0h]h1log2_mod(pt_entry_oa(), pt_entry_oa_lg2sz()) == 0}hjsbah}(h]h ]h"]h$]h&]hhuh1jhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKhj-ubh)}(hySee pt_item_oa(). The format should implement one of these two functions depending on how it stores the OAs in the table.h]hySee pt_item_oa(). The format should implement one of these two functions depending on how it stores the OAs in the table.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKhj-ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj<hhhNhNubjN)}(hhh]h}(h]h ]h"]h$]h&]entries](jZpt_entry_oa_lg2sz (C function)c.pt_entry_oa_lg2szhNtauh1jMhj<hhhNhNubj_)}(hhh](jd)}(h;unsigned int pt_entry_oa_lg2sz (const struct pt_state *pts)h]jj)}(h:unsigned int pt_entry_oa_lg2sz(const struct pt_state *pts)h](j )}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjhhhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhKubj )}(hinth]hint}(hj hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjhhhjhKubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhKubj)}(hpt_entry_oa_lg2szh]j)}(hpt_entry_oa_lg2szh]hpt_entry_oa_lg2sz}(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubah}(h]h ](jjeh"]h$]h&]hhuh1jhjhhhjhKubj )}(h(const struct pt_state *pts)h]j )}(hconst struct pt_state *ptsh](jp)}(hj h]hconst}(hjIhhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johjEubj)}(h h]h }(hjVhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEubjp)}(hjsh]hstruct}(hjdhhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johjEubj)}(h h]h }(hjqhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEubh)}(hhh]j)}(hpt_stateh]hpt_state}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetjmodnameN classnameNjc jf )}ji ]jl )}j_ j/sbc.pt_entry_oa_lg2szasbuh1hhjEubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEubj )}(hj h]h*}(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjEubj)}(hptsh]hpts}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEubeh}(h]h ]h"]h$]h&]noemphhhuh1j hjAubah}(h]h ]h"]h$]h&]hhuh1j hjhhhjhKubeh}(h]h ]h"]h$]h&]hhjuh1jijjhjhhhjhKubah}(h]jah ](jjeh"]h$]h&]jj)jhuh1jchjhKhjhhubj)}(hhh]h)}(hReturn the size of an OA entryh]hReturn the size of an OA entry}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKhjhhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhKubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1j^hhhj<hNhNubj)}(h**Parameters** ``const struct pt_state *pts`` Entry to query **Description** If the entry is not contiguous this returns pt_table_item_lg2sz(), otherwise it returns the total VA/OA size of the entire contiguous entry.h](h)}(h**Parameters**h]j)}(hj h]h Parameters}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKhjubjq)}(hhh]jv)}(h.``const struct pt_state *pts`` Entry to query h](j|)}(h``const struct pt_state *pts``h]jN)}(hj(h]hconst struct pt_state *pts}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1jMhj&ubah}(h]h ]h"]h$]h&]uh1j{hj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKhj"ubj)}(hhh]h)}(hEntry to queryh]hEntry to query}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj=hKhj>ubah}(h]h ]h"]h$]h&]uh1jhj"ubeh}(h]h ]h"]h$]h&]uh1juhj=hKhjubah}(h]h ]h"]h$]h&]uh1jphjubh)}(h**Description**h]j)}(hjch]h Description}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1jhjaubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKhjubh)}(hIf the entry is not contiguous this returns pt_table_item_lg2sz(), otherwise it returns the total VA/OA size of the entire contiguous entry.h]hIf the entry is not contiguous this returns pt_table_item_lg2sz(), otherwise it returns the total VA/OA size of the entire contiguous entry.}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj<hhhNhNubjN)}(hhh]h}(h]h ]h"]h$]h&]entries](jZpt_entry_oa_exact (C function)c.pt_entry_oa_exacthNtauh1jMhj<hhhNhNubj_)}(hhh](jd)}(h9pt_oaddr_t pt_entry_oa_exact (const struct pt_state *pts)h]jj)}(h8pt_oaddr_t pt_entry_oa_exact(const struct pt_state *pts)h](h)}(hhh]j)}(h pt_oaddr_th]h pt_oaddr_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetjmodnameN classnameNjc jf )}ji ]jl )}j_ pt_entry_oa_exactsbc.pt_entry_oa_exactasbuh1hhjhhhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhKubj)}(hpt_entry_oa_exacth]j)}(hjh]hpt_entry_oa_exact}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]hhuh1jhjhhhjhKubj )}(h(const struct pt_state *pts)h]j )}(hconst struct pt_state *ptsh](jp)}(hj h]hconst}(hjhhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjp)}(hjsh]hstruct}(hjhhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johjubj)}(h h]h }(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hpt_stateh]hpt_state}(hj3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetj5modnameN classnameNjc jf )}ji ]jc.pt_entry_oa_exactasbuh1hhjubj)}(h h]h }(hjQhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj )}(hj h]h*}(hj_hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjubj)}(hptsh]hpts}(hjlhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1j hjubah}(h]h ]h"]h$]h&]hhuh1j hjhhhjhKubeh}(h]h ]h"]h$]h&]hhjuh1jijjhjhhhjhKubah}(h]jah ](jjeh"]h$]h&]jj)jhuh1jchjhKhjhhubj)}(hhh]h)}(h#Return the complete OA for an entryh]h#Return the complete OA for an entry}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKhjhhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhKubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1j^hhhj<hNhNubj)}(h**Parameters** ``const struct pt_state *pts`` Entry to query **Description** During iteration the first entry could have a VA with an offset from the natural start of the entry. Return the exact OA including the pts's VA offset.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKhjubjq)}(hhh]jv)}(h.``const struct pt_state *pts`` Entry to query h](j|)}(h``const struct pt_state *pts``h]jN)}(hjh]hconst struct pt_state *pts}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jMhjubah}(h]h ]h"]h$]h&]uh1j{hj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKhjubj)}(hhh]h)}(hEntry to queryh]hEntry to query}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1juhjhKhjubah}(h]h ]h"]h$]h&]uh1jphjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKhjubh)}(hDuring iteration the first entry could have a VA with an offset from the natural start of the entry. Return the exact OA including the pts's VA offset.h]hDuring iteration the first entry could have a VA with an offset from the natural start of the entry. Return the exact OA including the pts’s VA offset.}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj<hhhNhNubjN)}(hhh]h}(h]h ]h"]h$]h&]entries](jZpt_full_va_prefix (C function)c.pt_full_va_prefixhNtauh1jMhj<hhhNhNubj_)}(hhh](jd)}(h=pt_vaddr_t pt_full_va_prefix (const struct pt_common *common)h]jj)}(h!ubj)}(h h]h }(hjO!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>!ubjp)}(hjsh]hstruct}(hj]!hhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johj>!ubj)}(h h]h }(hjj!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>!ubh)}(hhh]j)}(h pt_commonh]h pt_common}(hj{!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjx!ubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetj}!modnameN classnameNjc jf )}ji ]jl )}j_ j(!sbc.pt_has_system_page_sizeasbuh1hhj>!ubj)}(h h]h }(hj!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>!ubj )}(hj h]h*}(hj!hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj>!ubj)}(hcommonh]hcommon}(hj!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>!ubeh}(h]h ]h"]h$]h&]noemphhhuh1j hj:!ubah}(h]h ]h"]h$]h&]hhuh1j hj!hhhj!hKubeh}(h]h ]h"]h$]h&]hhjuh1jijjhj hhhj!hKubah}(h]j ah ](jjeh"]h$]h&]jj)jhuh1jchj!hKhj hhubj)}(hhh]h)}(h.True if level 0 can install a PAGE_SHIFT entryh]h.True if level 0 can install a PAGE_SHIFT entry}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKhj!hhubah}(h]h ]h"]h$]h&]uh1jhj hhhj!hKubeh}(h]h ](jfunctioneh"]h$]h&]jjjj!jj!jjjuh1j^hhhj<hNhNubj)}(h**Parameters** ``const struct pt_common *common`` Page table to query **Description** If true the caller can use, at level 0, pt_install_leaf_entry(PAGE_SHIFT). This is useful to create optimized paths for common cases of PAGE_SIZE mappings.h](h)}(h**Parameters**h]j)}(hj"h]h Parameters}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj"ubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKhj!ubjq)}(hhh]jv)}(h7``const struct pt_common *common`` Page table to query h](j|)}(h"``const struct pt_common *common``h]jN)}(hj!"h]hconst struct pt_common *common}(hj#"hhhNhNubah}(h]h ]h"]h$]h&]uh1jMhj"ubah}(h]h ]h"]h$]h&]uh1j{hj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKhj"ubj)}(hhh]h)}(hPage table to queryh]hPage table to query}(hj:"hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj6"hKhj7"ubah}(h]h ]h"]h$]h&]uh1jhj"ubeh}(h]h ]h"]h$]h&]uh1juhj6"hKhj"ubah}(h]h ]h"]h$]h&]uh1jphj!ubh)}(h**Description**h]j)}(hj\"h]h Description}(hj^"hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjZ"ubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKhj!ubh)}(hIf true the caller can use, at level 0, pt_install_leaf_entry(PAGE_SHIFT). This is useful to create optimized paths for common cases of PAGE_SIZE mappings.h]hIf true the caller can use, at level 0, pt_install_leaf_entry(PAGE_SHIFT). This is useful to create optimized paths for common cases of PAGE_SIZE mappings.}(hjr"hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKhj!ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj<hhhNhNubjN)}(hhh]h}(h]h ]h"]h$]h&]entries](jZ"pt_install_leaf_entry (C function)c.pt_install_leaf_entryhNtauh1jMhj<hhhNhNubj_)}(hhh](jd)}(h{void pt_install_leaf_entry (struct pt_state *pts, pt_oaddr_t oa, unsigned int oasz_lg2, const struct pt_write_attrs *attrs)h]jj)}(hzvoid pt_install_leaf_entry(struct pt_state *pts, pt_oaddr_t oa, unsigned int oasz_lg2, const struct pt_write_attrs *attrs).h](j )}(hvoidh]hvoid}(hj"hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj"hhhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKubj)}(h h]h }(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"hhhj"hKubj)}(hpt_install_leaf_entryh]j)}(hpt_install_leaf_entryh]hpt_install_leaf_entry}(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"ubah}(h]h ](jjeh"]h$]h&]hhuh1jhj"hhhj"hKubj )}(h`(struct pt_state *pts, pt_oaddr_t oa, unsigned int oasz_lg2, const struct pt_write_attrs *attrs)h](j )}(hstruct pt_state *ptsh](jp)}(hjsh]hstruct}(hj"hhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johj"ubj)}(h h]h }(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"ubh)}(hhh]j)}(hpt_stateh]hpt_state}(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"ubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetj"modnameN classnameNjc jf )}ji ]jl )}j_ j"sbc.pt_install_leaf_entryasbuh1hhj"ubj)}(h h]h }(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"ubj )}(hj h]h*}(hj*#hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj"ubj)}(hptsh]hpts}(hj7#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"ubeh}(h]h ]h"]h$]h&]noemphhhuh1j hj"ubj )}(h pt_oaddr_t oah](h)}(hhh]j)}(h pt_oaddr_th]h pt_oaddr_t}(hjS#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjP#ubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetjU#modnameN classnameNjc jf )}ji ]j#c.pt_install_leaf_entryasbuh1hhjL#ubj)}(h h]h }(hjq#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjL#ubj)}(hoah]hoa}(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjL#ubeh}(h]h ]h"]h$]h&]noemphhhuh1j hj"ubj )}(hunsigned int oasz_lg2h](j )}(hunsignedh]hunsigned}(hj#hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj#ubj)}(h h]h }(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#ubj )}(hinth]hint}(hj#hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj#ubj)}(h h]h }(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#ubj)}(hoasz_lg2h]hoasz_lg2}(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#ubeh}(h]h ]h"]h$]h&]noemphhhuh1j hj"ubj )}(h"const struct pt_write_attrs *attrsh](jp)}(hj h]hconst}(hj#hhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johj#ubj)}(h h]h }(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#ubjp)}(hjsh]hstruct}(hj$hhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johj#ubj)}(h h]h }(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#ubh)}(hhh]j)}(hpt_write_attrsh]hpt_write_attrs}(hj"$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$ubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetj$$modnameN classnameNjc jf )}ji ]j#c.pt_install_leaf_entryasbuh1hhj#ubj)}(h h]h }(hj@$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#ubj )}(hj h]h*}(hjN$hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj#ubj)}(hattrsh]hattrs}(hj[$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#ubeh}(h]h ]h"]h$]h&]noemphhhuh1j hj"ubeh}(h]h ]h"]h$]h&]hhuh1j hj"hhhj"hKubeh}(h]h ]h"]h$]h&]hhjuh1jijjhj"hhhj"hKubah}(h]j"ah ](jjeh"]h$]h&]jj)jhuh1jchj"hKhj"hhubj)}(hhh]h)}(hWrite a leaf entry to the tableh]hWrite a leaf entry to the table}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKhj$hhubah}(h]h ]h"]h$]h&]uh1jhj"hhhj"hKubeh}(h]h ](jfunctioneh"]h$]h&]jjjj$jj$jjjuh1j^hhhj<hNhNubj)}(hX**Parameters** ``struct pt_state *pts`` Table index to change ``pt_oaddr_t oa`` Output Address for this leaf ``unsigned int oasz_lg2`` Size in VA/OA for this leaf ``const struct pt_write_attrs *attrs`` Attributes to modify the entry **Description** A leaf OA entry will return PT_ENTRY_OA from pt_load_entry(). It translates the VA indicated by pts to the given OA. For a single item non-contiguous entry oasz_lg2 is pt_table_item_lg2sz(). For contiguous it is pt_table_item_lg2sz() + num_contig_lg2. This must not be called if pt_can_have_leaf() == false. Contiguous sizes not indicated by pt_possible_sizes() must not be specified.h](h)}(h**Parameters**h]j)}(hj$h]h Parameters}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj$ubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKhj$ubjq)}(hhh](jv)}(h/``struct pt_state *pts`` Table index to change h](j|)}(h``struct pt_state *pts``h]jN)}(hj$h]hstruct pt_state *pts}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jMhj$ubah}(h]h ]h"]h$]h&]uh1j{hj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKhj$ubj)}(hhh]h)}(hTable index to changeh]hTable index to change}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj$hKhj$ubah}(h]h ]h"]h$]h&]uh1jhj$ubeh}(h]h ]h"]h$]h&]uh1juhj$hKhj$ubjv)}(h/``pt_oaddr_t oa`` Output Address for this leaf h](j|)}(h``pt_oaddr_t oa``h]jN)}(hj$h]h pt_oaddr_t oa}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jMhj$ubah}(h]h ]h"]h$]h&]uh1j{hj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKhj$ubj)}(hhh]h)}(hOutput Address for this leafh]hOutput Address for this leaf}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj%hKhj%ubah}(h]h ]h"]h$]h&]uh1jhj$ubeh}(h]h ]h"]h$]h&]uh1juhj%hKhj$ubjv)}(h6``unsigned int oasz_lg2`` Size in VA/OA for this leaf h](j|)}(h``unsigned int oasz_lg2``h]jN)}(hj8%h]hunsigned int oasz_lg2}(hj:%hhhNhNubah}(h]h ]h"]h$]h&]uh1jMhj6%ubah}(h]h ]h"]h$]h&]uh1j{hj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKhj2%ubj)}(hhh]h)}(hSize in VA/OA for this leafh]hSize in VA/OA for this leaf}(hjQ%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjM%hKhjN%ubah}(h]h ]h"]h$]h&]uh1jhj2%ubeh}(h]h ]h"]h$]h&]uh1juhjM%hKhj$ubjv)}(hF``const struct pt_write_attrs *attrs`` Attributes to modify the entry h](j|)}(h&``const struct pt_write_attrs *attrs``h]jN)}(hjq%h]h"const struct pt_write_attrs *attrs}(hjs%hhhNhNubah}(h]h ]h"]h$]h&]uh1jMhjo%ubah}(h]h ]h"]h$]h&]uh1j{hj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKhjk%ubj)}(hhh]h)}(hAttributes to modify the entryh]hAttributes to modify the entry}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj%hKhj%ubah}(h]h ]h"]h$]h&]uh1jhjk%ubeh}(h]h ]h"]h$]h&]uh1juhj%hKhj$ubeh}(h]h ]h"]h$]h&]uh1jphj$ubh)}(h**Description**h]j)}(hj%h]h Description}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj%ubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKhj$ubh)}(htA leaf OA entry will return PT_ENTRY_OA from pt_load_entry(). It translates the VA indicated by pts to the given OA.h]htA leaf OA entry will return PT_ENTRY_OA from pt_load_entry(). It translates the VA indicated by pts to the given OA.}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKhj$ubh)}(hFor a single item non-contiguous entry oasz_lg2 is pt_table_item_lg2sz(). For contiguous it is pt_table_item_lg2sz() + num_contig_lg2.h]hFor a single item non-contiguous entry oasz_lg2 is pt_table_item_lg2sz(). For contiguous it is pt_table_item_lg2sz() + num_contig_lg2.}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKhj$ubh)}(hThis must not be called if pt_can_have_leaf() == false. Contiguous sizes not indicated by pt_possible_sizes() must not be specified.h]hThis must not be called if pt_can_have_leaf() == false. Contiguous sizes not indicated by pt_possible_sizes() must not be specified.}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKhj$ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj<hhhNhNubjN)}(hhh]h}(h]h ]h"]h$]h&]entries](jZpt_install_table (C function)c.pt_install_tablehNtauh1jMhj<hhhNhNubj_)}(hhh](jd)}(hebool pt_install_table (struct pt_state *pts, pt_oaddr_t table_pa, const struct pt_write_attrs *attrs)h]jj)}(hdbool pt_install_table(struct pt_state *pts, pt_oaddr_t table_pa, const struct pt_write_attrs *attrs)h](j )}(hj& h]hbool}(hj&hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj &hhhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKubj)}(h h]h }(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj &hhhj&hKubj)}(hpt_install_tableh]j)}(hpt_install_tableh]hpt_install_table}(hj/&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+&ubah}(h]h ](jjeh"]h$]h&]hhuh1jhj &hhhj&hKubj )}(hO(struct pt_state *pts, pt_oaddr_t table_pa, const struct pt_write_attrs *attrs)h](j )}(hstruct pt_state *ptsh](jp)}(hjsh]hstruct}(hjK&hhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johjG&ubj)}(h h]h }(hjX&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjG&ubh)}(hhh]j)}(hpt_stateh]hpt_state}(hji&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjf&ubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetjk&modnameN classnameNjc jf )}ji ]jl )}j_ j1&sbc.pt_install_tableasbuh1hhjG&ubj)}(h h]h }(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjG&ubj )}(hj h]h*}(hj&hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjG&ubj)}(hptsh]hpts}(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjG&ubeh}(h]h ]h"]h$]h&]noemphhhuh1j hjC&ubj )}(hpt_oaddr_t table_pah](h)}(hhh]j)}(h pt_oaddr_th]h pt_oaddr_t}(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetj&modnameN classnameNjc jf )}ji ]j&c.pt_install_tableasbuh1hhj&ubj)}(h h]h }(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubj)}(htable_pah]htable_pa}(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubeh}(h]h ]h"]h$]h&]noemphhhuh1j hjC&ubj )}(h"const struct pt_write_attrs *attrsh](jp)}(hj h]hconst}(hj'hhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johj'ubj)}(h h]h }(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj'ubjp)}(hjsh]hstruct}(hj 'hhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johj'ubj)}(h h]h }(hj-'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj'ubh)}(hhh]j)}(hpt_write_attrsh]hpt_write_attrs}(hj>'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;'ubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetj@'modnameN classnameNjc jf )}ji ]j&c.pt_install_tableasbuh1hhj'ubj)}(h h]h }(hj\'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj'ubj )}(hj h]h*}(hjj'hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj'ubj)}(hattrsh]hattrs}(hjw'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj'ubeh}(h]h ]h"]h$]h&]noemphhhuh1j hjC&ubeh}(h]h ]h"]h$]h&]hhuh1j hj &hhhj&hKubeh}(h]h ]h"]h$]h&]hhjuh1jijjhj&hhhj&hKubah}(h]j&ah ](jjeh"]h$]h&]jj)jhuh1jchj&hKhj&hhubj)}(hhh]h)}(h Write a table entry to the tableh]h Write a table entry to the table}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKhj'hhubah}(h]h ]h"]h$]h&]uh1jhj&hhhj&hKubeh}(h]h ](jfunctioneh"]h$]h&]jjjj'jj'jjjuh1j^hhhj<hNhNubj)}(hX>**Parameters** ``struct pt_state *pts`` Table index to change ``pt_oaddr_t table_pa`` CPU physical address of the lower table's memory ``const struct pt_write_attrs *attrs`` Attributes to modify the table index **Description** A table entry will return PT_ENTRY_TABLE from pt_load_entry(). The table_pa is the table at pts->level - 1. This is done by cmpxchg so pts must have the current entry loaded. The pts is updated with the installed entry. This must not be called if pt_can_have_table() == false. **Return** true if the table was installed successfully.h](h)}(h**Parameters**h]j)}(hj'h]h Parameters}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj'ubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKhj'ubjq)}(hhh](jv)}(h/``struct pt_state *pts`` Table index to change h](j|)}(h``struct pt_state *pts``h]jN)}(hj'h]hstruct pt_state *pts}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jMhj'ubah}(h]h ]h"]h$]h&]uh1j{hj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKhj'ubj)}(hhh]h)}(hTable index to changeh]hTable index to change}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj'hKhj'ubah}(h]h ]h"]h$]h&]uh1jhj'ubeh}(h]h ]h"]h$]h&]uh1juhj'hKhj'ubjv)}(hI``pt_oaddr_t table_pa`` CPU physical address of the lower table's memory h](j|)}(h``pt_oaddr_t table_pa``h]jN)}(hj(h]hpt_oaddr_t table_pa}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jMhj(ubah}(h]h ]h"]h$]h&]uh1j{hj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKhj(ubj)}(hhh]h)}(h0CPU physical address of the lower table's memoryh]h2CPU physical address of the lower table’s memory}(hj4(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj0(hKhj1(ubah}(h]h ]h"]h$]h&]uh1jhj(ubeh}(h]h ]h"]h$]h&]uh1juhj0(hKhj'ubjv)}(hL``const struct pt_write_attrs *attrs`` Attributes to modify the table index h](j|)}(h&``const struct pt_write_attrs *attrs``h]jN)}(hjT(h]h"const struct pt_write_attrs *attrs}(hjV(hhhNhNubah}(h]h ]h"]h$]h&]uh1jMhjR(ubah}(h]h ]h"]h$]h&]uh1j{hj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKhjN(ubj)}(hhh]h)}(h$Attributes to modify the table indexh]h$Attributes to modify the table index}(hjm(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhji(hKhjj(ubah}(h]h ]h"]h$]h&]uh1jhjN(ubeh}(h]h ]h"]h$]h&]uh1juhji(hKhj'ubeh}(h]h ]h"]h$]h&]uh1jphj'ubh)}(h**Description**h]j)}(hj(h]h Description}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj(ubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKhj'ubh)}(hA table entry will return PT_ENTRY_TABLE from pt_load_entry(). The table_pa is the table at pts->level - 1. This is done by cmpxchg so pts must have the current entry loaded. The pts is updated with the installed entry.h]hA table entry will return PT_ENTRY_TABLE from pt_load_entry(). The table_pa is the table at pts->level - 1. This is done by cmpxchg so pts must have the current entry loaded. The pts is updated with the installed entry.}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKhj'ubh)}(h8This must not be called if pt_can_have_table() == false.h]h8This must not be called if pt_can_have_table() == false.}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKhj'ubh)}(h **Return**h]j)}(hj(h]hReturn}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj(ubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKhj'ubh)}(h-true if the table was installed successfully.h]h-true if the table was installed successfully.}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKhj'ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj<hhhNhNubjN)}(hhh]h}(h]h ]h"]h$]h&]entries](jZpt_item_oa (C function) c.pt_item_oahNtauh1jMhj<hhhNhNubj_)}(hhh](jd)}(h2pt_oaddr_t pt_item_oa (const struct pt_state *pts)h]jj)}(h1pt_oaddr_t pt_item_oa(const struct pt_state *pts)h](h)}(hhh]j)}(h pt_oaddr_th]h pt_oaddr_t}(hj )hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj )ubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetj)modnameN classnameNjc jf )}ji ]jl )}j_ pt_item_oasb c.pt_item_oaasbuh1hhj)hhhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKubj)}(h h]h }(hj/)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)hhhj.)hKubj)}(h pt_item_oah]j)}(hj+)h]h pt_item_oa}(hjA)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=)ubah}(h]h ](jjeh"]h$]h&]hhuh1jhj)hhhj.)hKubj )}(h(const struct pt_state *pts)h]j )}(hconst struct pt_state *ptsh](jp)}(hj h]hconst}(hj\)hhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johjX)ubj)}(h h]h }(hji)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjX)ubjp)}(hjsh]hstruct}(hjw)hhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johjX)ubj)}(h h]h }(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjX)ubh)}(hhh]j)}(hpt_stateh]hpt_state}(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetj)modnameN classnameNjc jf )}ji ]j)) c.pt_item_oaasbuh1hhjX)ubj)}(h h]h }(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjX)ubj )}(hj h]h*}(hj)hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjX)ubj)}(hptsh]hpts}(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjX)ubeh}(h]h ]h"]h$]h&]noemphhhuh1j hjT)ubah}(h]h ]h"]h$]h&]hhuh1j hj)hhhj.)hKubeh}(h]h ]h"]h$]h&]hhjuh1jijjhj)hhhj.)hKubah}(h]j(ah ](jjeh"]h$]h&]jj)jhuh1jchj.)hKhj(hhubj)}(hhh]h)}(h!Output Address for this leaf itemh]h!Output Address for this leaf item}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKhj)hhubah}(h]h ]h"]h$]h&]uh1jhj(hhhj.)hKubeh}(h]h ](jfunctioneh"]h$]h&]jjjj*jj*jjjuh1j^hhhj<hNhNubj)}(hX]**Parameters** ``const struct pt_state *pts`` Item to query **Description** Return the output address for this item. If the item is part of a contiguous entry it returns the value of the OA for this individual sub item. See pt_entry_oa(). The format should implement one of these two functions depending on how it stores the OA's in the table.h](h)}(h**Parameters**h]j)}(hj*h]h Parameters}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj*ubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKhj*ubjq)}(hhh]jv)}(h-``const struct pt_state *pts`` Item to query h](j|)}(h``const struct pt_state *pts``h]jN)}(hj9*h]hconst struct pt_state *pts}(hj;*hhhNhNubah}(h]h ]h"]h$]h&]uh1jMhj7*ubah}(h]h ]h"]h$]h&]uh1j{hj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKhj3*ubj)}(hhh]h)}(h Item to queryh]h Item to query}(hjR*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjN*hKhjO*ubah}(h]h ]h"]h$]h&]uh1jhj3*ubeh}(h]h ]h"]h$]h&]uh1juhjN*hKhj0*ubah}(h]h ]h"]h$]h&]uh1jphj*ubh)}(h**Description**h]j)}(hjt*h]h Description}(hjv*hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjr*ubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKhj*ubh)}(hReturn the output address for this item. If the item is part of a contiguous entry it returns the value of the OA for this individual sub item.h]hReturn the output address for this item. If the item is part of a contiguous entry it returns the value of the OA for this individual sub item.}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKhj*ubh)}(h{See pt_entry_oa(). The format should implement one of these two functions depending on how it stores the OA's in the table.h]h}See pt_entry_oa(). The format should implement one of these two functions depending on how it stores the OA’s in the table.}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKhj*ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj<hhhNhNubjN)}(hhh]h}(h]h ]h"]h$]h&]entries](jZpt_load_entry_raw (C function)c.pt_load_entry_rawhNtauh1jMhj<hhhNhNubj_)}(hhh](jd)}(h;enum pt_entry_type pt_load_entry_raw (struct pt_state *pts)h]jj)}(h:enum pt_entry_type pt_load_entry_raw(struct pt_state *pts)h](jp)}(hjgh]henum}(hj*hhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johj*hhhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKubj)}(h h]h }(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*hhhj*hKubh)}(hhh]j)}(h pt_entry_typeh]h pt_entry_type}(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*ubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetj*modnameN classnameNjc jf )}ji ]jl )}j_ pt_load_entry_rawsbc.pt_load_entry_rawasbuh1hhj*hhhj*hKubj)}(h h]h }(hj+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*hhhj*hKubj)}(hpt_load_entry_rawh]j)}(hj+h]hpt_load_entry_raw}(hj+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubah}(h]h ](jjeh"]h$]h&]hhuh1jhj*hhhj*hKubj )}(h(struct pt_state *pts)h]j )}(hstruct pt_state *ptsh](jp)}(hjsh]hstruct}(hj5+hhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johj1+ubj)}(h h]h }(hjB+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj1+ubh)}(hhh]j)}(hpt_stateh]hpt_state}(hjS+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjP+ubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetjU+modnameN classnameNjc jf )}ji ]j+c.pt_load_entry_rawasbuh1hhj1+ubj)}(h h]h }(hjq+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj1+ubj )}(hj h]h*}(hj+hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj1+ubj)}(hptsh]hpts}(hj+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj1+ubeh}(h]h ]h"]h$]h&]noemphhhuh1j hj-+ubah}(h]h ]h"]h$]h&]hhuh1j hj*hhhj*hKubeh}(h]h ]h"]h$]h&]hhjuh1jijjhj*hhhj*hKubah}(h]j*ah ](jjeh"]h$]h&]jj)jhuh1jchj*hKhj*hhubj)}(hhh]h)}(h1Read from the location pts points at into the ptsh]h1Read from the location pts points at into the pts}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKhj+hhubah}(h]h ]h"]h$]h&]uh1jhj*hhhj*hKubeh}(h]h ](jfunctioneh"]h$]h&]jjjj+jj+jjjuh1j^hhhj<hNhNubj)}(h**Parameters** ``struct pt_state *pts`` Table index to load **Description** Return the type of entry that was loaded. pts->entry will be filled in with the entry's content. See pt_load_entry()h](h)}(h**Parameters**h]j)}(hj+h]h Parameters}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj+ubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKhj+ubjq)}(hhh]jv)}(h-``struct pt_state *pts`` Table index to load h](j|)}(h``struct pt_state *pts``h]jN)}(hj+h]hstruct pt_state *pts}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1jMhj+ubah}(h]h ]h"]h$]h&]uh1j{hj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKhj+ubj)}(hhh]h)}(hTable index to loadh]hTable index to load}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj ,hKhj ,ubah}(h]h ]h"]h$]h&]uh1jhj+ubeh}(h]h ]h"]h$]h&]uh1juhj ,hKhj+ubah}(h]h ]h"]h$]h&]uh1jphj+ubh)}(h**Description**h]j)}(hj2,h]h Description}(hj4,hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj0,ubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKhj+ubh)}(htReturn the type of entry that was loaded. pts->entry will be filled in with the entry's content. See pt_load_entry()h]hvReturn the type of entry that was loaded. pts->entry will be filled in with the entry’s content. See pt_load_entry()}(hjH,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKhj+ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj<hhhNhNubjN)}(hhh]h}(h]h ]h"]h$]h&]entries](jZpt_max_oa_lg2 (C function)c.pt_max_oa_lg2hNtauh1jMhj<hhhNhNubj_)}(hhh](jd)}(h;unsigned int pt_max_oa_lg2 (const struct pt_common *common)h]jj)}(h:unsigned int pt_max_oa_lg2(const struct pt_common *common)h](j )}(hunsignedh]hunsigned}(hjw,hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjs,hhhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKubj)}(h h]h }(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjs,hhhj,hKubj )}(hinth]hint}(hj,hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjs,hhhj,hKubj)}(h h]h }(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjs,hhhj,hKubj)}(h pt_max_oa_lg2h]j)}(h pt_max_oa_lg2h]h pt_max_oa_lg2}(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,ubah}(h]h ](jjeh"]h$]h&]hhuh1jhjs,hhhj,hKubj )}(h (const struct pt_common *common)h]j )}(hconst struct pt_common *commonh](jp)}(hj h]hconst}(hj,hhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johj,ubj)}(h h]h }(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,ubjp)}(hjsh]hstruct}(hj,hhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johj,ubj)}(h h]h }(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,ubh)}(hhh]j)}(h pt_commonh]h pt_common}(hj -hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-ubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetj -modnameN classnameNjc jf )}ji ]jl )}j_ j,sbc.pt_max_oa_lg2asbuh1hhj,ubj)}(h h]h }(hj)-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,ubj )}(hj h]h*}(hj7-hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj,ubj)}(hcommonh]hcommon}(hjD-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,ubeh}(h]h ]h"]h$]h&]noemphhhuh1j hj,ubah}(h]h ]h"]h$]h&]hhuh1j hjs,hhhj,hKubeh}(h]h ]h"]h$]h&]hhjuh1jijjhjo,hhhj,hKubah}(h]jj,ah ](jjeh"]h$]h&]jj)jhuh1jchj,hKhjl,hhubj)}(hhh]h)}(h/Return the maximum OA the table format can holdh]h/Return the maximum OA the table format can hold}(hjn-hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKhjk-hhubah}(h]h ]h"]h$]h&]uh1jhjl,hhhj,hKubeh}(h]h ](jfunctioneh"]h$]h&]jjjj-jj-jjjuh1j^hhhj<hNhNubj)}(hX***Parameters** ``const struct pt_common *common`` Page table to query **Description** The value oalog2_to_max_int(pt_max_oa_lg2()) is the MAX for the OA. This is the absolute maximum address the table can hold. struct pt_common max_oasz_lg2 sets a lower dynamic maximum based on HW capability.h](h)}(h**Parameters**h]j)}(hj-h]h Parameters}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj-ubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKhj-ubjq)}(hhh]jv)}(h7``const struct pt_common *common`` Page table to query h](j|)}(h"``const struct pt_common *common``h]jN)}(hj-h]hconst struct pt_common *common}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1jMhj-ubah}(h]h ]h"]h$]h&]uh1j{hj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKhj-ubj)}(hhh]h)}(hPage table to queryh]hPage table to query}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj-hKhj-ubah}(h]h ]h"]h$]h&]uh1jhj-ubeh}(h]h ]h"]h$]h&]uh1juhj-hKhj-ubah}(h]h ]h"]h$]h&]uh1jphj-ubh)}(h**Description**h]j)}(hj-h]h Description}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj-ubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKhj-ubh)}(hThe value oalog2_to_max_int(pt_max_oa_lg2()) is the MAX for the OA. This is the absolute maximum address the table can hold. struct pt_common max_oasz_lg2 sets a lower dynamic maximum based on HW capability.h]hThe value oalog2_to_max_int(pt_max_oa_lg2()) is the MAX for the OA. This is the absolute maximum address the table can hold. struct pt_common max_oasz_lg2 sets a lower dynamic maximum based on HW capability.}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhKhj-ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj<hhhNhNubjN)}(hhh]h}(h]h ]h"]h$]h&]entries](jZpt_num_items_lg2 (C function)c.pt_num_items_lg2hNtauh1jMhj<hhhNhNubj_)}(hhh](jd)}(h:unsigned int pt_num_items_lg2 (const struct pt_state *pts)h]jj)}(h9unsigned int pt_num_items_lg2(const struct pt_state *pts)h](j )}(hunsignedh]hunsigned}(hj/.hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj+.hhhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhMubj)}(h h]h }(hj>.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+.hhhj=.hMubj )}(hinth]hint}(hjL.hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj+.hhhj=.hMubj)}(h h]h }(hjZ.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+.hhhj=.hMubj)}(hpt_num_items_lg2h]j)}(hpt_num_items_lg2h]hpt_num_items_lg2}(hjl.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjh.ubah}(h]h ](jjeh"]h$]h&]hhuh1jhj+.hhhj=.hMubj )}(h(const struct pt_state *pts)h]j )}(hconst struct pt_state *ptsh](jp)}(hj h]hconst}(hj.hhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johj.ubj)}(h h]h }(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj.ubjp)}(hjsh]hstruct}(hj.hhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johj.ubj)}(h h]h }(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj.ubh)}(hhh]j)}(hpt_stateh]hpt_state}(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj.ubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetj.modnameN classnameNjc jf )}ji ]jl )}j_ jn.sbc.pt_num_items_lg2asbuh1hhj.ubj)}(h h]h }(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj.ubj )}(hj h]h*}(hj.hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj.ubj)}(hptsh]hpts}(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj.ubeh}(h]h ]h"]h$]h&]noemphhhuh1j hj.ubah}(h]h ]h"]h$]h&]hhuh1j hj+.hhhj=.hMubeh}(h]h ]h"]h$]h&]hhjuh1jijjhj'.hhhj=.hMubah}(h]j".ah ](jjeh"]h$]h&]jj)jhuh1jchj=.hMhj$.hhubj)}(hhh]h)}(h.Return the number of items in this table levelh]h.Return the number of items in this table level}(hj&/hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhMhj#/hhubah}(h]h ]h"]h$]h&]uh1jhj$.hhhj=.hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjj>/jj>/jjjuh1j^hhhj<hNhNubj)}(hX**Parameters** ``const struct pt_state *pts`` The current level **Description** The number of items in a table level defines the number of bits this level decodes from the VA. This function is not called for the top level, so it does not need to compute a special value for the top case. The result for the top is based on pt_common max_vasz_lg2. The value is used as part of determining the table indexes via the equation:: log2_mod(log2_div(VA, pt_table_item_lg2sz()), pt_num_items_lg2())h](h)}(h**Parameters**h]j)}(hjH/h]h Parameters}(hjJ/hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjF/ubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhMhjB/ubjq)}(hhh]jv)}(h1``const struct pt_state *pts`` The current level h](j|)}(h``const struct pt_state *pts``h]jN)}(hjg/h]hconst struct pt_state *pts}(hji/hhhNhNubah}(h]h ]h"]h$]h&]uh1jMhje/ubah}(h]h ]h"]h$]h&]uh1j{hj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhMhja/ubj)}(hhh]h)}(hThe current levelh]hThe current level}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj|/hMhj}/ubah}(h]h ]h"]h$]h&]uh1jhja/ubeh}(h]h ]h"]h$]h&]uh1juhj|/hMhj^/ubah}(h]h ]h"]h$]h&]uh1jphjB/ubh)}(h**Description**h]j)}(hj/h]h Description}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj/ubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhMhjB/ubh)}(hX The number of items in a table level defines the number of bits this level decodes from the VA. This function is not called for the top level, so it does not need to compute a special value for the top case. The result for the top is based on pt_common max_vasz_lg2.h]hX The number of items in a table level defines the number of bits this level decodes from the VA. This function is not called for the top level, so it does not need to compute a special value for the top case. The result for the top is based on pt_common max_vasz_lg2.}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhMhjB/ubh)}(hMThe value is used as part of determining the table indexes via the equation::h]hLThe value is used as part of determining the table indexes via the equation:}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhMhjB/ubj)}(hAlog2_mod(log2_div(VA, pt_table_item_lg2sz()), pt_num_items_lg2())h]hAlog2_mod(log2_div(VA, pt_table_item_lg2sz()), pt_num_items_lg2())}hj/sbah}(h]h ]h"]h$]h&]hhuh1jhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhM hjB/ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj<hhhNhNubjN)}(hhh]h}(h]h ]h"]h$]h&]entries](jZ!pt_pgsz_lg2_to_level (C function)c.pt_pgsz_lg2_to_levelhNtauh1jMhj<hhhNhNubj_)}(hhh](jd)}(hUunsigned int pt_pgsz_lg2_to_level (struct pt_common *common, unsigned int pgsize_lg2)h]jj)}(hTunsigned int pt_pgsz_lg2_to_level(struct pt_common *common, unsigned int pgsize_lg2)h](j )}(hunsignedh]hunsigned}(hj0hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj0hhhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhMubj)}(h h]h }(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0hhhj0hMubj )}(hinth]hint}(hj"0hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj0hhhj0hMubj)}(h h]h }(hj00hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0hhhj0hMubj)}(hpt_pgsz_lg2_to_levelh]j)}(hpt_pgsz_lg2_to_levelh]hpt_pgsz_lg2_to_level}(hjB0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>0ubah}(h]h ](jjeh"]h$]h&]hhuh1jhj0hhhj0hMubj )}(h3(struct pt_common *common, unsigned int pgsize_lg2)h](j )}(hstruct pt_common *commonh](jp)}(hjsh]hstruct}(hj^0hhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johjZ0ubj)}(h h]h }(hjk0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZ0ubh)}(hhh]j)}(h pt_commonh]h pt_common}(hj|0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjy0ubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetj~0modnameN classnameNjc jf )}ji ]jl )}j_ jD0sbc.pt_pgsz_lg2_to_levelasbuh1hhjZ0ubj)}(h h]h }(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZ0ubj )}(hj h]h*}(hj0hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjZ0ubj)}(hcommonh]hcommon}(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZ0ubeh}(h]h ]h"]h$]h&]noemphhhuh1j hjV0ubj )}(hunsigned int pgsize_lg2h](j )}(hunsignedh]hunsigned}(hj0hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj0ubj)}(h h]h }(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubj )}(hinth]hint}(hj0hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj0ubj)}(h h]h }(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubj)}(h pgsize_lg2h]h pgsize_lg2}(hj1hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubeh}(h]h ]h"]h$]h&]noemphhhuh1j hjV0ubeh}(h]h ]h"]h$]h&]hhuh1j hj0hhhj0hMubeh}(h]h ]h"]h$]h&]hhjuh1jijjhj/hhhj0hMubah}(h]j/ah ](jjeh"]h$]h&]jj)jhuh1jchj0hMhj/hhubj)}(hhh]h)}(h(Return the level that maps the page sizeh]h(Return the level that maps the page size}(hj21hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhMhj/1hhubah}(h]h ]h"]h$]h&]uh1jhj/hhhj0hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjJ1jjJ1jjjuh1j^hhhj<hNhNubj)}(hX**Parameters** ``struct pt_common *common`` Page table to query ``unsigned int pgsize_lg2`` Log2 page size **Description** Returns the table level that will map the given page size. The page size must be part of the pt_possible_sizes() for some level.h](h)}(h**Parameters**h]j)}(hjT1h]h Parameters}(hjV1hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjR1ubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhMhjN1ubjq)}(hhh](jv)}(h1``struct pt_common *common`` Page table to query h](j|)}(h``struct pt_common *common``h]jN)}(hjs1h]hstruct pt_common *common}(hju1hhhNhNubah}(h]h ]h"]h$]h&]uh1jMhjq1ubah}(h]h ]h"]h$]h&]uh1j{hj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhMhjm1ubj)}(hhh]h)}(hPage table to queryh]hPage table to query}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj1hMhj1ubah}(h]h ]h"]h$]h&]uh1jhjm1ubeh}(h]h ]h"]h$]h&]uh1juhj1hMhjj1ubjv)}(h+``unsigned int pgsize_lg2`` Log2 page size h](j|)}(h``unsigned int pgsize_lg2``h]jN)}(hj1h]hunsigned int pgsize_lg2}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jMhj1ubah}(h]h ]h"]h$]h&]uh1j{hj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhMhj1ubj)}(hhh]h)}(hLog2 page sizeh]hLog2 page size}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj1hMhj1ubah}(h]h ]h"]h$]h&]uh1jhj1ubeh}(h]h ]h"]h$]h&]uh1juhj1hMhjj1ubeh}(h]h ]h"]h$]h&]uh1jphjN1ubh)}(h**Description**h]j)}(hj1h]h Description}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj1ubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhMhjN1ubh)}(hReturns the table level that will map the given page size. The page size must be part of the pt_possible_sizes() for some level.h]hReturns the table level that will map the given page size. The page size must be part of the pt_possible_sizes() for some level.}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhMhjN1ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj<hhhNhNubjN)}(hhh]h}(h]h ]h"]h$]h&]entries](jZpt_possible_sizes (C function)c.pt_possible_sizeshNtauh1jMhj<hhhNhNubj_)}(hhh](jd)}(h9pt_vaddr_t pt_possible_sizes (const struct pt_state *pts)h]jj)}(h8pt_vaddr_t pt_possible_sizes(const struct pt_state *pts)h](h)}(hhh]j)}(h pt_vaddr_th]h pt_vaddr_t}(hj/2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,2ubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetj12modnameN classnameNjc jf )}ji ]jl )}j_ pt_possible_sizessbc.pt_possible_sizesasbuh1hhj(2hhhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhMubj)}(h h]h }(hjQ2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(2hhhjP2hMubj)}(hpt_possible_sizesh]j)}(hjM2h]hpt_possible_sizes}(hjc2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj_2ubah}(h]h ](jjeh"]h$]h&]hhuh1jhj(2hhhjP2hMubj )}(h(const struct pt_state *pts)h]j )}(hconst struct pt_state *ptsh](jp)}(hj h]hconst}(hj~2hhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johjz2ubj)}(h h]h }(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjz2ubjp)}(hjsh]hstruct}(hj2hhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johjz2ubj)}(h h]h }(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjz2ubh)}(hhh]j)}(hpt_stateh]hpt_state}(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2ubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetj2modnameN classnameNjc jf )}ji ]jK2c.pt_possible_sizesasbuh1hhjz2ubj)}(h h]h }(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjz2ubj )}(hj h]h*}(hj2hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjz2ubj)}(hptsh]hpts}(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjz2ubeh}(h]h ]h"]h$]h&]noemphhhuh1j hjv2ubah}(h]h ]h"]h$]h&]hhuh1j hj(2hhhjP2hMubeh}(h]h ]h"]h$]h&]hhjuh1jijjhj$2hhhjP2hMubah}(h]j2ah ](jjeh"]h$]h&]jj)jhuh1jchjP2hMhj!2hhubj)}(hhh]h)}(h6Return a bitmap of possible output sizes at this levelh]h6Return a bitmap of possible output sizes at this level}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhMhj3hhubah}(h]h ]h"]h$]h&]uh1jhj!2hhhjP2hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjj23jj23jjjuh1j^hhhj<hNhNubj)}(hX**Parameters** ``const struct pt_state *pts`` The current level **Description** Each level has a list of possible output sizes that can be installed as leaf entries. If pt_can_have_leaf() is false returns zero. Otherwise the bit in position pt_table_item_lg2sz() should be set indicating that a non-contiguous single item leaf entry is supported. The following pt_num_items_lg2() number of bits can be set indicating contiguous entries are supported. Bit pt_table_item_lg2sz() + pt_num_items_lg2() must not be set, contiguous entries cannot span the entire table. The OR of pt_possible_sizes() of all levels is the typical bitmask of all supported sizes in the entire table.h](h)}(h**Parameters**h]j)}(hj<3h]h Parameters}(hj>3hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj:3ubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhMhj63ubjq)}(hhh]jv)}(h1``const struct pt_state *pts`` The current level h](j|)}(h``const struct pt_state *pts``h]jN)}(hj[3h]hconst struct pt_state *pts}(hj]3hhhNhNubah}(h]h ]h"]h$]h&]uh1jMhjY3ubah}(h]h ]h"]h$]h&]uh1j{hj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhMhjU3ubj)}(hhh]h)}(hThe current levelh]hThe current level}(hjt3hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjp3hMhjq3ubah}(h]h ]h"]h$]h&]uh1jhjU3ubeh}(h]h ]h"]h$]h&]uh1juhjp3hMhjR3ubah}(h]h ]h"]h$]h&]uh1jphj63ubh)}(h**Description**h]j)}(hj3h]h Description}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj3ubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhMhj63ubh)}(hEach level has a list of possible output sizes that can be installed as leaf entries. If pt_can_have_leaf() is false returns zero.h]hEach level has a list of possible output sizes that can be installed as leaf entries. If pt_can_have_leaf() is false returns zero.}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhMhj63ubh)}(hX`Otherwise the bit in position pt_table_item_lg2sz() should be set indicating that a non-contiguous single item leaf entry is supported. The following pt_num_items_lg2() number of bits can be set indicating contiguous entries are supported. Bit pt_table_item_lg2sz() + pt_num_items_lg2() must not be set, contiguous entries cannot span the entire table.h]hX`Otherwise the bit in position pt_table_item_lg2sz() should be set indicating that a non-contiguous single item leaf entry is supported. The following pt_num_items_lg2() number of bits can be set indicating contiguous entries are supported. Bit pt_table_item_lg2sz() + pt_num_items_lg2() must not be set, contiguous entries cannot span the entire table.}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhM hj63ubh)}(hnThe OR of pt_possible_sizes() of all levels is the typical bitmask of all supported sizes in the entire table.h]hnThe OR of pt_possible_sizes() of all levels is the typical bitmask of all supported sizes in the entire table.}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhM&hj63ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj<hhhNhNubjN)}(hhh]h}(h]h ]h"]h$]h&]entries](jZ pt_table_item_lg2sz (C function)c.pt_table_item_lg2szhNtauh1jMhj<hhhNhNubj_)}(hhh](jd)}(h=unsigned int pt_table_item_lg2sz (const struct pt_state *pts)h]jj)}(hReturn the maximum software bit usable for any level and entryh]h>Return the maximum software bit usable for any level and entry}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhMZhj;hhubah}(h]h ]h"]h$]h&]uh1jhj:hhhj ;hMZubeh}(h]h ](jfunctioneh"]h$]h&]jjjj;jj;jjjuh1j^hhhj<hNhNubj)}(h**Parameters** ``struct pt_common *common`` Page table **Description** The swbit can be passed as bitnr to the other sw_bit functions.h](h)}(h**Parameters**h]j)}(hj;h]h Parameters}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj;ubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhM^hj;ubjq)}(hhh]jv)}(h(``struct pt_common *common`` Page table h](j|)}(h``struct pt_common *common``h]jN)}(hj<h]hstruct pt_common *common}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jMhj<ubah}(h]h ]h"]h$]h&]uh1j{hj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhM\hj<ubj)}(hhh]h)}(h Page tableh]h Page table}(hj4<hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj0<hM\hj1<ubah}(h]h ]h"]h$]h&]uh1jhj<ubeh}(h]h ]h"]h$]h&]uh1juhj0<hM\hj<ubah}(h]h ]h"]h$]h&]uh1jphj;ubh)}(h**Description**h]j)}(hjV<h]h Description}(hjX<hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjT<ubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhM^hj;ubh)}(h?The swbit can be passed as bitnr to the other sw_bit functions.h]h?The swbit can be passed as bitnr to the other sw_bit functions.}(hjl<hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhM]hj;ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj<hhhNhNubjN)}(hhh]h}(h]h ]h"]h$]h&]entries](jZ#pt_test_sw_bit_acquire (C function)c.pt_test_sw_bit_acquirehNtauh1jMhj<hhhNhNubj_)}(hhh](jd)}(hFbool pt_test_sw_bit_acquire (struct pt_state *pts, unsigned int bitnr)h]jj)}(hEbool pt_test_sw_bit_acquire(struct pt_state *pts, unsigned int bitnr)h](j )}(hj& h]hbool}(hj<hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj<hhhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhMcubj)}(h h]h }(hj<hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj<hhhj<hMcubj)}(hpt_test_sw_bit_acquireh]j)}(hpt_test_sw_bit_acquireh]hpt_test_sw_bit_acquire}(hj<hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj<ubah}(h]h ](jjeh"]h$]h&]hhuh1jhj<hhhj<hMcubj )}(h*(struct pt_state *pts, unsigned int bitnr)h](j )}(hstruct pt_state *ptsh](jp)}(hjsh]hstruct}(hj<hhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johj<ubj)}(h h]h }(hj<hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj<ubh)}(hhh]j)}(hpt_stateh]hpt_state}(hj<hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj<ubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetj<modnameN classnameNjc jf )}ji ]jl )}j_ j<sbc.pt_test_sw_bit_acquireasbuh1hhj<ubj)}(h h]h }(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj<ubj )}(hj h]h*}(hj#=hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj<ubj)}(hptsh]hpts}(hj0=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj<ubeh}(h]h ]h"]h$]h&]noemphhhuh1j hj<ubj )}(hunsigned int bitnrh](j )}(hunsignedh]hunsigned}(hjI=hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjE=ubj)}(h h]h }(hjW=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjE=ubj )}(hinth]hint}(hje=hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjE=ubj)}(h h]h }(hjs=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjE=ubj)}(hbitnrh]hbitnr}(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjE=ubeh}(h]h ]h"]h$]h&]noemphhhuh1j hj<ubeh}(h]h ]h"]h$]h&]hhuh1j hj<hhhj<hMcubeh}(h]h ]h"]h$]h&]hhjuh1jijjhj<hhhj<hMcubah}(h]j<ah ](jjeh"]h$]h&]jj)jhuh1jchj<hMchj<hhubj)}(hhh]h)}(hRead a software bit in an itemh]hRead a software bit in an item}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhMchj=hhubah}(h]h ]h"]h$]h&]uh1jhj<hhhj<hMcubeh}(h]h ](jfunctioneh"]h$]h&]jjjj=jj=jjjuh1j^hhhj<hNhNubj)}(h**Parameters** ``struct pt_state *pts`` Entry to read ``unsigned int bitnr`` Bit to read **Description** Software bits are ignored by HW and can be used for any purpose by the software. This does a test bit and acquire operation.h](h)}(h**Parameters**h]j)}(hj=h]h Parameters}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj=ubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhMghj=ubjq)}(hhh](jv)}(h'``struct pt_state *pts`` Entry to read h](j|)}(h``struct pt_state *pts``h]jN)}(hj=h]hstruct pt_state *pts}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1jMhj=ubah}(h]h ]h"]h$]h&]uh1j{hj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhMdhj=ubj)}(hhh]h)}(h Entry to readh]h Entry to read}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj>hMdhj>ubah}(h]h ]h"]h$]h&]uh1jhj=ubeh}(h]h ]h"]h$]h&]uh1juhj>hMdhj=ubjv)}(h#``unsigned int bitnr`` Bit to read h](j|)}(h``unsigned int bitnr``h]jN)}(hj%>h]hunsigned int bitnr}(hj'>hhhNhNubah}(h]h ]h"]h$]h&]uh1jMhj#>ubah}(h]h ]h"]h$]h&]uh1j{hj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhMehj>ubj)}(hhh]h)}(h Bit to readh]h Bit to read}(hj>>hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj:>hMehj;>ubah}(h]h ]h"]h$]h&]uh1jhj>ubeh}(h]h ]h"]h$]h&]uh1juhj:>hMehj=ubeh}(h]h ]h"]h$]h&]uh1jphj=ubh)}(h**Description**h]j)}(hj`>h]h Description}(hjb>hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj^>ubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhMghj=ubh)}(h|Software bits are ignored by HW and can be used for any purpose by the software. This does a test bit and acquire operation.h]h|Software bits are ignored by HW and can be used for any purpose by the software. This does a test bit and acquire operation.}(hjv>hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhMfhj=ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj<hhhNhNubjN)}(hhh]h}(h]h ]h"]h$]h&]entries](jZ"pt_set_sw_bit_release (C function)c.pt_set_sw_bit_releasehNtauh1jMhj<hhhNhNubj_)}(hhh](jd)}(hEvoid pt_set_sw_bit_release (struct pt_state *pts, unsigned int bitnr)h]jj)}(hDvoid pt_set_sw_bit_release(struct pt_state *pts, unsigned int bitnr)h](j )}(hvoidh]hvoid}(hj>hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj>hhhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhMnubj)}(h h]h }(hj>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>hhhj>hMnubj)}(hpt_set_sw_bit_releaseh]j)}(hpt_set_sw_bit_releaseh]hpt_set_sw_bit_release}(hj>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>ubah}(h]h ](jjeh"]h$]h&]hhuh1jhj>hhhj>hMnubj )}(h*(struct pt_state *pts, unsigned int bitnr)h](j )}(hstruct pt_state *ptsh](jp)}(hjsh]hstruct}(hj>hhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johj>ubj)}(h h]h }(hj>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>ubh)}(hhh]j)}(hpt_stateh]hpt_state}(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>ubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetj?modnameN classnameNjc jf )}ji ]jl )}j_ j>sbc.pt_set_sw_bit_releaseasbuh1hhj>ubj)}(h h]h }(hj ?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>ubj )}(hj h]h*}(hj.?hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj>ubj)}(hptsh]hpts}(hj;?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>ubeh}(h]h ]h"]h$]h&]noemphhhuh1j hj>ubj )}(hunsigned int bitnrh](j )}(hunsignedh]hunsigned}(hjT?hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjP?ubj)}(h h]h }(hjb?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjP?ubj )}(hinth]hint}(hjp?hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjP?ubj)}(h h]h }(hj~?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjP?ubj)}(hbitnrh]hbitnr}(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjP?ubeh}(h]h ]h"]h$]h&]noemphhhuh1j hj>ubeh}(h]h ]h"]h$]h&]hhuh1j hj>hhhj>hMnubeh}(h]h ]h"]h$]h&]hhjuh1jijjhj>hhhj>hMnubah}(h]j>ah ](jjeh"]h$]h&]jj)jhuh1jchj>hMnhj>hhubj)}(hhh]h)}(hSet a software bit in an itemh]hSet a software bit in an item}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhMnhj?hhubah}(h]h ]h"]h$]h&]uh1jhj>hhhj>hMnubeh}(h]h ](jfunctioneh"]h$]h&]jjjj?jj?jjjuh1j^hhhj<hNhNubj)}(h**Parameters** ``struct pt_state *pts`` Entry to set ``unsigned int bitnr`` Bit to set **Description** Software bits are ignored by HW and can be used for any purpose by the software. This does a set bit and release operation.h](h)}(h**Parameters**h]j)}(hj?h]h Parameters}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj?ubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhMrhj?ubjq)}(hhh](jv)}(h&``struct pt_state *pts`` Entry to set h](j|)}(h``struct pt_state *pts``h]jN)}(hj?h]hstruct pt_state *pts}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1jMhj?ubah}(h]h ]h"]h$]h&]uh1j{hj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhMohj?ubj)}(hhh]h)}(h Entry to seth]h Entry to set}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj @hMohj @ubah}(h]h ]h"]h$]h&]uh1jhj?ubeh}(h]h ]h"]h$]h&]uh1juhj @hMohj?ubjv)}(h"``unsigned int bitnr`` Bit to set h](j|)}(h``unsigned int bitnr``h]jN)}(hj0@h]hunsigned int bitnr}(hj2@hhhNhNubah}(h]h ]h"]h$]h&]uh1jMhj.@ubah}(h]h ]h"]h$]h&]uh1j{hj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhMphj*@ubj)}(hhh]h)}(h Bit to seth]h Bit to set}(hjI@hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjE@hMphjF@ubah}(h]h ]h"]h$]h&]uh1jhj*@ubeh}(h]h ]h"]h$]h&]uh1juhjE@hMphj?ubeh}(h]h ]h"]h$]h&]uh1jphj?ubh)}(h**Description**h]j)}(hjk@h]h Description}(hjm@hhhNhNubah}(h]h ]h"]h$]h&]uh1jhji@ubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhMrhj?ubh)}(h{Software bits are ignored by HW and can be used for any purpose by the software. This does a set bit and release operation.h]h{Software bits are ignored by HW and can be used for any purpose by the software. This does a set bit and release operation.}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhMqhj?ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj<hhhNhNubjN)}(hhh]h}(h]h ]h"]h$]h&]entries](jZpt_load_entry (C function)c.pt_load_entryhNtauh1jMhj<hhhNhNubj_)}(hhh](jd)}(h)void pt_load_entry (struct pt_state *pts)h]jj)}(h(void pt_load_entry(struct pt_state *pts)h](j )}(hvoidh]hvoid}(hj@hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj@hhhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhMyubj)}(h h]h }(hj@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@hhhj@hMyubj)}(h pt_load_entryh]j)}(h pt_load_entryh]h pt_load_entry}(hj@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@ubah}(h]h ](jjeh"]h$]h&]hhuh1jhj@hhhj@hMyubj )}(h(struct pt_state *pts)h]j )}(hstruct pt_state *ptsh](jp)}(hjsh]hstruct}(hj@hhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johj@ubj)}(h h]h }(hj@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@ubh)}(hhh]j)}(hpt_stateh]hpt_state}(hj AhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjAubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetj AmodnameN classnameNjc jf )}ji ]jl )}j_ j@sbc.pt_load_entryasbuh1hhj@ubj)}(h h]h }(hj+AhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@ubj )}(hj h]h*}(hj9AhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj@ubj)}(hptsh]hpts}(hjFAhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@ubeh}(h]h ]h"]h$]h&]noemphhhuh1j hj@ubah}(h]h ]h"]h$]h&]hhuh1j hj@hhhj@hMyubeh}(h]h ]h"]h$]h&]hhjuh1jijjhj@hhhj@hMyubah}(h]j@ah ](jjeh"]h$]h&]jj)jhuh1jchj@hMyhj@hhubj)}(hhh]h)}(h1Read from the location pts points at into the ptsh]h1Read from the location pts points at into the pts}(hjpAhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhMyhjmAhhubah}(h]h ]h"]h$]h&]uh1jhj@hhhj@hMyubeh}(h]h ](jfunctioneh"]h$]h&]jjjjAjjAjjjuh1j^hhhj<hNhNubj)}(h**Parameters** ``struct pt_state *pts`` Table index to load **Description** Set the type of entry that was loaded. pts->entry and pts->table_lower will be filled in with the entry's content.h](h)}(h**Parameters**h]j)}(hjAh]h Parameters}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjAubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhM}hjAubjq)}(hhh]jv)}(h-``struct pt_state *pts`` Table index to load h](j|)}(h``struct pt_state *pts``h]jN)}(hjAh]hstruct pt_state *pts}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jMhjAubah}(h]h ]h"]h$]h&]uh1j{hj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhMzhjAubj)}(hhh]h)}(hTable index to loadh]hTable index to load}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjAhMzhjAubah}(h]h ]h"]h$]h&]uh1jhjAubeh}(h]h ]h"]h$]h&]uh1juhjAhMzhjAubah}(h]h ]h"]h$]h&]uh1jphjAubh)}(h**Description**h]j)}(hjAh]h Description}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjAubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhM|hjAubh)}(hrSet the type of entry that was loaded. pts->entry and pts->table_lower will be filled in with the entry's content.h]htSet the type of entry that was loaded. pts->entry and pts->table_lower will be filled in with the entry’s content.}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:68: ./drivers/iommu/generic_pt/pt_common.hhM{hjAubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj<hhhNhNubeh}(h].format-functions-at-the-struct-pt-common-levelah ]h"].format functions at the struct pt_common levelah$]h&]uh1hhjhhhhhK@ubh)}(hhh](h)}(hIteration Helpersh]hIteration Helpers}(hj#BhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj BhhhhhKGubjN)}(hhh]h}(h]h ]h"]h$]h&]entries](jZpt_check_range (C function)c.pt_check_rangehNtauh1jMhj BhhhNhNubj_)}(hhh](jd)}(h+int pt_check_range (struct pt_range *range)h]jj)}(h*int pt_check_range(struct pt_range *range)h](j )}(hinth]hint}(hjJBhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjFBhhhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhKubj)}(h h]h }(hjYBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFBhhhjXBhKubj)}(hpt_check_rangeh]j)}(hpt_check_rangeh]hpt_check_range}(hjkBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgBubah}(h]h ](jjeh"]h$]h&]hhuh1jhjFBhhhjXBhKubj )}(h(struct pt_range *range)h]j )}(hstruct pt_range *rangeh](jp)}(hjsh]hstruct}(hjBhhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johjBubj)}(h h]h }(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubh)}(hhh]j)}(hpt_rangeh]hpt_range}(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetjBmodnameN classnameNjc jf )}ji ]jl )}j_ jmBsbc.pt_check_rangeasbuh1hhjBubj)}(h h]h }(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubj )}(hj h]h*}(hjBhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjBubj)}(hrangeh]hrange}(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubeh}(h]h ]h"]h$]h&]noemphhhuh1j hjBubah}(h]h ]h"]h$]h&]hhuh1j hjFBhhhjXBhKubeh}(h]h ]h"]h$]h&]hhjuh1jijjhjBBhhhjXBhKubah}(h]j=Bah ](jjeh"]h$]h&]jj)jhuh1jchjXBhKhj?Bhhubj)}(hhh]h)}(h"Validate the range can be iteratedh]h"Validate the range can be iterated}(hj ChhhNhNubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhKhjChhubah}(h]h ]h"]h$]h&]uh1jhj?BhhhjXBhKubeh}(h]h ](jfunctioneh"]h$]h&]jjjj"Cjj"Cjjjuh1j^hhhj BhNhNubj)}(h**Parameters** ``struct pt_range *range`` Range to validate **Description** Check that VA and last_va fall within the permitted range of VAs. If the format is using PT_FEAT_SIGN_EXTEND then this also checks the sign extension is correct.h](h)}(h**Parameters**h]j)}(hj,Ch]h Parameters}(hj.ChhhNhNubah}(h]h ]h"]h$]h&]uh1jhj*Cubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhKhj&Cubjq)}(hhh]jv)}(h-``struct pt_range *range`` Range to validate h](j|)}(h``struct pt_range *range``h]jN)}(hjKCh]hstruct pt_range *range}(hjMChhhNhNubah}(h]h ]h"]h$]h&]uh1jMhjICubah}(h]h ]h"]h$]h&]uh1j{hh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhKhjECubj)}(hhh]h)}(hRange to validateh]hRange to validate}(hjdChhhNhNubah}(h]h ]h"]h$]h&]uh1hhj`ChKhjaCubah}(h]h ]h"]h$]h&]uh1jhjECubeh}(h]h ]h"]h$]h&]uh1juhj`ChKhjBCubah}(h]h ]h"]h$]h&]uh1jphj&Cubh)}(h**Description**h]j)}(hjCh]h Description}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1jhjCubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhKhj&Cubh)}(hCheck that VA and last_va fall within the permitted range of VAs. If the format is using PT_FEAT_SIGN_EXTEND then this also checks the sign extension is correct.h]hCheck that VA and last_va fall within the permitted range of VAs. If the format is using PT_FEAT_SIGN_EXTEND then this also checks the sign extension is correct.}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhKhj&Cubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj BhhhNhNubjN)}(hhh]h}(h]h ]h"]h$]h&]entries](jZpt_index_to_va (C function)c.pt_index_to_vahNtauh1jMhj BhhhNhNubj_)}(hhh](jd)}(h*void pt_index_to_va (struct pt_state *pts)h]jj)}(h)void pt_index_to_va(struct pt_state *pts)h](j )}(hvoidh]hvoid}(hjChhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjChhhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhK2ubj)}(h h]h }(hjChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjChhhjChK2ubj)}(hpt_index_to_vah]j)}(hpt_index_to_vah]hpt_index_to_va}(hjChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCubah}(h]h ](jjeh"]h$]h&]hhuh1jhjChhhjChK2ubj )}(h(struct pt_state *pts)h]j )}(hstruct pt_state *ptsh](jp)}(hjsh]hstruct}(hjDhhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johjDubj)}(h h]h }(hjDhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjDubh)}(hhh]j)}(hpt_stateh]hpt_state}(hj&DhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#Dubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetj(DmodnameN classnameNjc jf )}ji ]jl )}j_ jCsbc.pt_index_to_vaasbuh1hhjDubj)}(h h]h }(hjFDhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjDubj )}(hj h]h*}(hjTDhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjDubj)}(hptsh]hpts}(hjaDhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjDubeh}(h]h ]h"]h$]h&]noemphhhuh1j hjDubah}(h]h ]h"]h$]h&]hhuh1j hjChhhjChK2ubeh}(h]h ]h"]h$]h&]hhjuh1jijjhjChhhjChK2ubah}(h]jCah ](jjeh"]h$]h&]jj)jhuh1jchjChK2hjChhubj)}(hhh]h)}(h*Update range->va to the current pts->indexh]h*Update range->va to the current pts->index}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhK2hjDhhubah}(h]h ]h"]h$]h&]uh1jhjChhhjChK2ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjDjjDjjjuh1j^hhhj BhNhNubj)}(h**Parameters** ``struct pt_state *pts`` Iteration State **Description** Adjust range->va to match the current index. This is done in a lazy manner since computing the VA takes several instructions and is rarely required.h](h)}(h**Parameters**h]j)}(hjDh]h Parameters}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjDubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhK6hjDubjq)}(hhh]jv)}(h)``struct pt_state *pts`` Iteration State h](j|)}(h``struct pt_state *pts``h]jN)}(hjDh]hstruct pt_state *pts}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1jMhjDubah}(h]h ]h"]h$]h&]uh1j{hh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhK3hjDubj)}(hhh]h)}(hIteration Stateh]hIteration State}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjDhK3hjDubah}(h]h ]h"]h$]h&]uh1jhjDubeh}(h]h ]h"]h$]h&]uh1juhjDhK3hjDubah}(h]h ]h"]h$]h&]uh1jphjDubh)}(h**Description**h]j)}(hjEh]h Description}(hj EhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjEubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhK5hjDubh)}(hAdjust range->va to match the current index. This is done in a lazy manner since computing the VA takes several instructions and is rarely required.h]hAdjust range->va to match the current index. This is done in a lazy manner since computing the VA takes several instructions and is rarely required.}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhK4hjDubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj BhhhNhNubjN)}(hhh]h}(h]h ]h"]h$]h&]entries](jZ#pt_entry_fully_covered (C function)c.pt_entry_fully_coveredhNtauh1jMhj BhhhNhNubj_)}(hhh](jd)}(hObool pt_entry_fully_covered (const struct pt_state *pts, unsigned int oasz_lg2)h]jj)}(hNbool pt_entry_fully_covered(const struct pt_state *pts, unsigned int oasz_lg2)h](j )}(hj& h]hbool}(hjLEhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjHEhhhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhKMubj)}(h h]h }(hjZEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHEhhhjYEhKMubj)}(hpt_entry_fully_coveredh]j)}(hpt_entry_fully_coveredh]hpt_entry_fully_covered}(hjlEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhEubah}(h]h ](jjeh"]h$]h&]hhuh1jhjHEhhhjYEhKMubj )}(h3(const struct pt_state *pts, unsigned int oasz_lg2)h](j )}(hconst struct pt_state *ptsh](jp)}(hj h]hconst}(hjEhhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johjEubj)}(h h]h }(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEubjp)}(hjsh]hstruct}(hjEhhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johjEubj)}(h h]h }(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEubh)}(hhh]j)}(hpt_stateh]hpt_state}(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetjEmodnameN classnameNjc jf )}ji ]jl )}j_ jnEsbc.pt_entry_fully_coveredasbuh1hhjEubj)}(h h]h }(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEubj )}(hj h]h*}(hjEhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjEubj)}(hptsh]hpts}(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEubeh}(h]h ]h"]h$]h&]noemphhhuh1j hjEubj )}(hunsigned int oasz_lg2h](j )}(hunsignedh]hunsigned}(hjFhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjFubj)}(h h]h }(hj#FhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFubj )}(hinth]hint}(hj1FhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjFubj)}(h h]h }(hj?FhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFubj)}(hoasz_lg2h]hoasz_lg2}(hjMFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFubeh}(h]h ]h"]h$]h&]noemphhhuh1j hjEubeh}(h]h ]h"]h$]h&]hhuh1j hjHEhhhjYEhKMubeh}(h]h ]h"]h$]h&]hhjuh1jijjhjDEhhhjYEhKMubah}(h]j?Eah ](jjeh"]h$]h&]jj)jhuh1jchjYEhKMhjAEhhubj)}(hhh]h)}(hBCheck if the item or entry is entirely contained within pts->rangeh]hBCheck if the item or entry is entirely contained within pts->range}(hjwFhhhNhNubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhKMhjtFhhubah}(h]h ]h"]h$]h&]uh1jhjAEhhhjYEhKMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjFjjFjjjuh1j^hhhj BhNhNubj)}(h**Parameters** ``const struct pt_state *pts`` Iteration State ``unsigned int oasz_lg2`` The size of the item to check, pt_table_item_lg2sz() or pt_entry_oa_lg2sz() **Return** true if the item is fully enclosed by the pts->range.h](h)}(h**Parameters**h]j)}(hjFh]h Parameters}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjFubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhKQhjFubjq)}(hhh](jv)}(h/``const struct pt_state *pts`` Iteration State h](j|)}(h``const struct pt_state *pts``h]jN)}(hjFh]hconst struct pt_state *pts}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1jMhjFubah}(h]h ]h"]h$]h&]uh1j{hh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhKOhjFubj)}(hhh]h)}(hIteration Stateh]hIteration State}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjFhKOhjFubah}(h]h ]h"]h$]h&]uh1jhjFubeh}(h]h ]h"]h$]h&]uh1juhjFhKOhjFubjv)}(hf``unsigned int oasz_lg2`` The size of the item to check, pt_table_item_lg2sz() or pt_entry_oa_lg2sz() h](j|)}(h``unsigned int oasz_lg2``h]jN)}(hjFh]hunsigned int oasz_lg2}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1jMhjFubah}(h]h ]h"]h$]h&]uh1j{hh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhKQhjFubj)}(hhh]h)}(hKThe size of the item to check, pt_table_item_lg2sz() or pt_entry_oa_lg2sz()h]hKThe size of the item to check, pt_table_item_lg2sz() or pt_entry_oa_lg2sz()}(hj GhhhNhNubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhKPhjGubah}(h]h ]h"]h$]h&]uh1jhjFubeh}(h]h ]h"]h$]h&]uh1juhjGhKQhjFubeh}(h]h ]h"]h$]h&]uh1jphjFubh)}(h **Return**h]j)}(hj-Gh]hReturn}(hj/GhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj+Gubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhKShjFubh)}(h5true if the item is fully enclosed by the pts->range.h]h5true if the item is fully enclosed by the pts->range.}(hjCGhhhNhNubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhKShjFubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj BhhhNhNubjN)}(hhh]h}(h]h ]h"]h$]h&]entries](jZpt_range_to_index (C function)c.pt_range_to_indexhNtauh1jMhj BhhhNhNubj_)}(hhh](jd)}(h;unsigned int pt_range_to_index (const struct pt_state *pts)h]jj)}(h:unsigned int pt_range_to_index(const struct pt_state *pts)h](j )}(hunsignedh]hunsigned}(hjrGhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjnGhhhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhKgubj)}(h h]h }(hjGhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnGhhhjGhKgubj )}(hinth]hint}(hjGhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjnGhhhjGhKgubj)}(h h]h }(hjGhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnGhhhjGhKgubj)}(hpt_range_to_indexh]j)}(hpt_range_to_indexh]hpt_range_to_index}(hjGhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGubah}(h]h ](jjeh"]h$]h&]hhuh1jhjnGhhhjGhKgubj )}(h(const struct pt_state *pts)h]j )}(hconst struct pt_state *ptsh](jp)}(hj h]hconst}(hjGhhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johjGubj)}(h h]h }(hjGhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGubjp)}(hjsh]hstruct}(hjGhhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johjGubj)}(h h]h }(hjGhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGubh)}(hhh]j)}(hpt_stateh]hpt_state}(hjHhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetjHmodnameN classnameNjc jf )}ji ]jl )}j_ jGsbc.pt_range_to_indexasbuh1hhjGubj)}(h h]h }(hj$HhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGubj )}(hj h]h*}(hj2HhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjGubj)}(hptsh]hpts}(hj?HhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGubeh}(h]h ]h"]h$]h&]noemphhhuh1j hjGubah}(h]h ]h"]h$]h&]hhuh1j hjnGhhhjGhKgubeh}(h]h ]h"]h$]h&]hhjuh1jijjhjjGhhhjGhKgubah}(h]jeGah ](jjeh"]h$]h&]jj)jhuh1jchjGhKghjgGhhubj)}(hhh]h)}(hStarting index for an iterationh]hStarting index for an iteration}(hjiHhhhNhNubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhKghjfHhhubah}(h]h ]h"]h$]h&]uh1jhjgGhhhjGhKgubeh}(h]h ](jfunctioneh"]h$]h&]jjjjHjjHjjjuh1j^hhhj BhNhNubj)}(hz**Parameters** ``const struct pt_state *pts`` Iteration State **Return** the starting index for the iteration in pts.h](h)}(h**Parameters**h]j)}(hjHh]h Parameters}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjHubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhKkhjHubjq)}(hhh]jv)}(h/``const struct pt_state *pts`` Iteration State h](j|)}(h``const struct pt_state *pts``h]jN)}(hjHh]hconst struct pt_state *pts}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1jMhjHubah}(h]h ]h"]h$]h&]uh1j{hh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhKhhjHubj)}(hhh]h)}(hIteration Stateh]hIteration State}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjHhKhhjHubah}(h]h ]h"]h$]h&]uh1jhjHubeh}(h]h ]h"]h$]h&]uh1juhjHhKhhjHubah}(h]h ]h"]h$]h&]uh1jphjHubh)}(h **Return**h]j)}(hjHh]hReturn}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjHubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhKjhjHubh)}(h,the starting index for the iteration in pts.h]h,the starting index for the iteration in pts.}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhKjhjHubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj BhhhNhNubjN)}(hhh]h}(h]h ]h"]h$]h&]entries](jZ"pt_range_to_end_index (C function)c.pt_range_to_end_indexhNtauh1jMhj BhhhNhNubj_)}(hhh](jd)}(h?unsigned int pt_range_to_end_index (const struct pt_state *pts)h]jj)}(h>unsigned int pt_range_to_end_index(const struct pt_state *pts)h](j )}(hunsignedh]hunsigned}(hj*IhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj&Ihhhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhKzubj)}(h h]h }(hj9IhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&Ihhhj8IhKzubj )}(hinth]hint}(hjGIhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj&Ihhhj8IhKzubj)}(h h]h }(hjUIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&Ihhhj8IhKzubj)}(hpt_range_to_end_indexh]j)}(hpt_range_to_end_indexh]hpt_range_to_end_index}(hjgIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjcIubah}(h]h ](jjeh"]h$]h&]hhuh1jhj&Ihhhj8IhKzubj )}(h(const struct pt_state *pts)h]j )}(hconst struct pt_state *ptsh](jp)}(hj h]hconst}(hjIhhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johjIubj)}(h h]h }(hjIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIubjp)}(hjsh]hstruct}(hjIhhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johjIubj)}(h h]h }(hjIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIubh)}(hhh]j)}(hpt_stateh]hpt_state}(hjIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetjImodnameN classnameNjc jf )}ji ]jl )}j_ jiIsbc.pt_range_to_end_indexasbuh1hhjIubj)}(h h]h }(hjIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIubj )}(hj h]h*}(hjIhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjIubj)}(hptsh]hpts}(hjIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIubeh}(h]h ]h"]h$]h&]noemphhhuh1j hj{Iubah}(h]h ]h"]h$]h&]hhuh1j hj&Ihhhj8IhKzubeh}(h]h ]h"]h$]h&]hhjuh1jijjhj"Ihhhj8IhKzubah}(h]jIah ](jjeh"]h$]h&]jj)jhuh1jchj8IhKzhjIhhubj)}(hhh]h)}(hEnding index iterationh]hEnding index iteration}(hj!JhhhNhNubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhKzhjJhhubah}(h]h ]h"]h$]h&]uh1jhjIhhhj8IhKzubeh}(h]h ](jfunctioneh"]h$]h&]jjjj9Jjj9Jjjjuh1j^hhhj BhNhNubj)}(hv**Parameters** ``const struct pt_state *pts`` Iteration State **Return** the last index for the iteration in pts.h](h)}(h**Parameters**h]j)}(hjCJh]h Parameters}(hjEJhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjAJubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhK~hj=Jubjq)}(hhh]jv)}(h/``const struct pt_state *pts`` Iteration State h](j|)}(h``const struct pt_state *pts``h]jN)}(hjbJh]hconst struct pt_state *pts}(hjdJhhhNhNubah}(h]h ]h"]h$]h&]uh1jMhj`Jubah}(h]h ]h"]h$]h&]uh1j{hh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhK{hj\Jubj)}(hhh]h)}(hIteration Stateh]hIteration State}(hj{JhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjwJhK{hjxJubah}(h]h ]h"]h$]h&]uh1jhj\Jubeh}(h]h ]h"]h$]h&]uh1juhjwJhK{hjYJubah}(h]h ]h"]h$]h&]uh1jphj=Jubh)}(h **Return**h]j)}(hjJh]hReturn}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjJubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhK}hj=Jubh)}(h(the last index for the iteration in pts.h]h(the last index for the iteration in pts.}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhK}hj=Jubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj BhhhNhNubjN)}(hhh]h}(h]h ]h"]h$]h&]entries](jZpt_next_entry (C function)c.pt_next_entryhNtauh1jMhj BhhhNhNubj_)}(hhh](jd)}(h)void pt_next_entry (struct pt_state *pts)h]jj)}(h(void pt_next_entry(struct pt_state *pts)h](j )}(hvoidh]hvoid}(hjJhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjJhhhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhKubj)}(h h]h }(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJhhhjJhKubj)}(h pt_next_entryh]j)}(h pt_next_entryh]h pt_next_entry}(hjKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJubah}(h]h ](jjeh"]h$]h&]hhuh1jhjJhhhjJhKubj )}(h(struct pt_state *pts)h]j )}(hstruct pt_state *ptsh](jp)}(hjsh]hstruct}(hjKhhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johjKubj)}(h h]h }(hj,KhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjKubh)}(hhh]j)}(hpt_stateh]hpt_state}(hj=KhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:Kubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetj?KmodnameN classnameNjc jf )}ji ]jl )}j_ jKsbc.pt_next_entryasbuh1hhjKubj)}(h h]h }(hj]KhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjKubj )}(hj h]h*}(hjkKhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjKubj)}(hptsh]hpts}(hjxKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjKubeh}(h]h ]h"]h$]h&]noemphhhuh1j hjKubah}(h]h ]h"]h$]h&]hhuh1j hjJhhhjJhKubeh}(h]h ]h"]h$]h&]hhjuh1jijjhjJhhhjJhKubah}(h]jJah ](jjeh"]h$]h&]jj)jhuh1jchjJhKhjJhhubj)}(hhh]h)}(hAdvance pts to the next entryh]hAdvance pts to the next entry}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhKhjKhhubah}(h]h ]h"]h$]h&]uh1jhjJhhhjJhKubeh}(h]h ](jfunctioneh"]h$]h&]jjjjKjjKjjjuh1j^hhhj BhNhNubj)}(h**Parameters** ``struct pt_state *pts`` Iteration State **Description** Update pts to go to the next index at this level. If pts is pointing at a contiguous entry then the index may advance my more than one.h](h)}(h**Parameters**h]j)}(hjKh]h Parameters}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjKubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhKhjKubjq)}(hhh]jv)}(h)``struct pt_state *pts`` Iteration State h](j|)}(h``struct pt_state *pts``h]jN)}(hjKh]hstruct pt_state *pts}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1jMhjKubah}(h]h ]h"]h$]h&]uh1j{hh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhKhjKubj)}(hhh]h)}(hIteration Stateh]hIteration State}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjKhKhjKubah}(h]h ]h"]h$]h&]uh1jhjKubeh}(h]h ]h"]h$]h&]uh1juhjKhKhjKubah}(h]h ]h"]h$]h&]uh1jphjKubh)}(h**Description**h]j)}(hjLh]h Description}(hj LhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjLubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhKhjKubh)}(hUpdate pts to go to the next index at this level. If pts is pointing at a contiguous entry then the index may advance my more than one.h]hUpdate pts to go to the next index at this level. If pts is pointing at a contiguous entry then the index may advance my more than one.}(hj4LhhhNhNubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhKhjKubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj BhhhNhNubjN)}(hhh]h}(h]h ]h"]h$]h&]entries](jZ!for_each_pt_level_entry (C macro)c.for_each_pt_level_entryhNtauh1jMhj BhhhNhNubj_)}(hhh](jd)}(hfor_each_pt_level_entryh]jj)}(hfor_each_pt_level_entryh]j)}(hfor_each_pt_level_entryh]j)}(hj]Lh]hfor_each_pt_level_entry}(hjgLhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjcLubah}(h]h ](jjeh"]h$]h&]hhuh1jhj_Lhhhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhKubah}(h]h ]h"]h$]h&]hhjuh1jijjhj[LhhhjzLhKubah}(h]jVLah ](jjeh"]h$]h&]jj)jhuh1jchjzLhKhjXLhhubj)}(hhh]h}(h]h ]h"]h$]h&]uh1jhjXLhhhjzLhKubeh}(h]h ](jmacroeh"]h$]h&]jjjjLjjLjjjuh1j^hhhj BhNhNubh)}(h!``for_each_pt_level_entry (pts)``h]jN)}(hjLh]hfor_each_pt_level_entry (pts)}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1jMhjLubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhKhj Bhhubh)}(h+For loop wrapper over entries in the range h]h)}(h*For loop wrapper over entries in the rangeh]h*For loop wrapper over entries in the range}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhKhjLubah}(h]h ]h"]h$]h&]uh1hhjLhKhj Bhhubj)}(h**Parameters** ``pts`` Iteration State **Description** This is the basic iteration primitive. It iterates over all the entries in pts->range that fall within the pts's current table level. Each step does pt_load_entry(pts).h](h)}(h**Parameters**h]j)}(hjLh]h Parameters}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjLubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhKhjLubjq)}(hhh]jv)}(h``pts`` Iteration State h](j|)}(h``pts``h]jN)}(hjLh]hpts}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1jMhjLubah}(h]h ]h"]h$]h&]uh1j{hh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhKhjLubj)}(hhh]h)}(hIteration Stateh]hIteration State}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjMhKhjMubah}(h]h ]h"]h$]h&]uh1jhjLubeh}(h]h ]h"]h$]h&]uh1juhjMhKhjLubah}(h]h ]h"]h$]h&]uh1jphjLubh)}(h**Description**h]j)}(hj(Mh]h Description}(hj*MhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj&Mubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhKhjLubh)}(hThis is the basic iteration primitive. It iterates over all the entries in pts->range that fall within the pts's current table level. Each step does pt_load_entry(pts).h]hThis is the basic iteration primitive. It iterates over all the entries in pts->range that fall within the pts’s current table level. Each step does pt_load_entry(pts).}(hj>MhhhNhNubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhKhjLubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj BhhhNhNubjN)}(hhh]h}(h]h ]h"]h$]h&]entries](jZ!pt_load_single_entry (C function)c.pt_load_single_entryhNtauh1jMhj BhhhNhNubj_)}(hhh](jd)}(h>enum pt_entry_type pt_load_single_entry (struct pt_state *pts)h]jj)}(h=enum pt_entry_type pt_load_single_entry(struct pt_state *pts)h](jp)}(hjgh]henum}(hjmMhhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johjiMhhhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhKubj)}(h h]h }(hj{MhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjiMhhhjzMhKubh)}(hhh]j)}(h pt_entry_typeh]h pt_entry_type}(hjMhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjMubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetjMmodnameN classnameNjc jf )}ji ]jl )}j_ pt_load_single_entrysbc.pt_load_single_entryasbuh1hhjiMhhhjzMhKubj)}(h h]h }(hjMhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjiMhhhjzMhKubj)}(hpt_load_single_entryh]j)}(hjMh]hpt_load_single_entry}(hjMhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjMubah}(h]h ](jjeh"]h$]h&]hhuh1jhjiMhhhjzMhKubj )}(h(struct pt_state *pts)h]j )}(hstruct pt_state *ptsh](jp)}(hjsh]hstruct}(hjMhhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johjMubj)}(h h]h }(hjMhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjMubh)}(hhh]j)}(hpt_stateh]hpt_state}(hjMhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjMubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetjMmodnameN classnameNjc jf )}ji ]jMc.pt_load_single_entryasbuh1hhjMubj)}(h h]h }(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjMubj )}(hj h]h*}(hj$NhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjMubj)}(hptsh]hpts}(hj1NhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjMubeh}(h]h ]h"]h$]h&]noemphhhuh1j hjMubah}(h]h ]h"]h$]h&]hhuh1j hjiMhhhjzMhKubeh}(h]h ]h"]h$]h&]hhjuh1jijjhjeMhhhjzMhKubah}(h]j`Mah ](jjeh"]h$]h&]jj)jhuh1jchjzMhKhjbMhhubj)}(hhh]h)}(h1Version of pt_load_entry() usable within a walkerh]h1Version of pt_load_entry() usable within a walker}(hj[NhhhNhNubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhKhjXNhhubah}(h]h ]h"]h$]h&]uh1jhjbMhhhjzMhKubeh}(h]h ](jfunctioneh"]h$]h&]jjjjsNjjsNjjjuh1j^hhhj BhNhNubj)}(h**Parameters** ``struct pt_state *pts`` Iteration State **Description** Alternative to for_each_pt_level_entry() if the walker function uses only a single entry.h](h)}(h**Parameters**h]j)}(hj}Nh]h Parameters}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj{Nubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhKhjwNubjq)}(hhh]jv)}(h)``struct pt_state *pts`` Iteration State h](j|)}(h``struct pt_state *pts``h]jN)}(hjNh]hstruct pt_state *pts}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1jMhjNubah}(h]h ]h"]h$]h&]uh1j{hh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhKhjNubj)}(hhh]h)}(hIteration Stateh]hIteration State}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjNhKhjNubah}(h]h ]h"]h$]h&]uh1jhjNubeh}(h]h ]h"]h$]h&]uh1juhjNhKhjNubah}(h]h ]h"]h$]h&]uh1jphjwNubh)}(h**Description**h]j)}(hjNh]h Description}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjNubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhKhjwNubh)}(hYAlternative to for_each_pt_level_entry() if the walker function uses only a single entry.h]hYAlternative to for_each_pt_level_entry() if the walker function uses only a single entry.}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhKhjwNubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj BhhhNhNubjN)}(hhh]h}(h]h ]h"]h$]h&]entries](jZpt_top_range (C function)c.pt_top_rangehNtauh1jMhj BhhhNhNubj_)}(hhh](jd)}(h7struct pt_range pt_top_range (struct pt_common *common)h]jj)}(h6struct pt_range pt_top_range(struct pt_common *common)h](jp)}(hjsh]hstruct}(hjOhhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johjOhhhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhKubj)}(h h]h }(hj*OhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjOhhhj)OhKubh)}(hhh]j)}(hpt_rangeh]hpt_range}(hj;OhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj8Oubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetj=OmodnameN classnameNjc jf )}ji ]jl )}j_ pt_top_rangesbc.pt_top_rangeasbuh1hhjOhhhj)OhKubj)}(h h]h }(hj\OhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjOhhhj)OhKubj)}(h pt_top_rangeh]j)}(hjYOh]h pt_top_range}(hjnOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjjOubah}(h]h ](jjeh"]h$]h&]hhuh1jhjOhhhj)OhKubj )}(h(struct pt_common *common)h]j )}(hstruct pt_common *commonh](jp)}(hjsh]hstruct}(hjOhhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johjOubj)}(h h]h }(hjOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjOubh)}(hhh]j)}(h pt_commonh]h pt_common}(hjOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjOubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetjOmodnameN classnameNjc jf )}ji ]jWOc.pt_top_rangeasbuh1hhjOubj)}(h h]h }(hjOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjOubj )}(hj h]h*}(hjOhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjOubj)}(hcommonh]hcommon}(hjOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjOubeh}(h]h ]h"]h$]h&]noemphhhuh1j hjOubah}(h]h ]h"]h$]h&]hhuh1j hjOhhhj)OhKubeh}(h]h ]h"]h$]h&]hhjuh1jijjhjOhhhj)OhKubah}(h]jOah ](jjeh"]h$]h&]jj)jhuh1jchj)OhKhjOhhubj)}(hhh]h)}(h/Return a range that spans part of the top levelh]h/Return a range that spans part of the top level}(hj PhhhNhNubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhKhjPhhubah}(h]h ]h"]h$]h&]uh1jhjOhhhj)OhKubeh}(h]h ](jfunctioneh"]h$]h&]jjjj"Pjj"Pjjjuh1j^hhhj BhNhNubj)}(h**Parameters** ``struct pt_common *common`` Table **Description** For PT_FEAT_SIGN_EXTEND this will return the lower range, and cover half the total page table. Otherwise it returns the entire page table.h](h)}(h**Parameters**h]j)}(hj,Ph]h Parameters}(hj.PhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj*Pubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhKhj&Pubjq)}(hhh]jv)}(h#``struct pt_common *common`` Table h](j|)}(h``struct pt_common *common``h]jN)}(hjKPh]hstruct pt_common *common}(hjMPhhhNhNubah}(h]h ]h"]h$]h&]uh1jMhjIPubah}(h]h ]h"]h$]h&]uh1j{hh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhKhjEPubj)}(hhh]h)}(hTableh]hTable}(hjdPhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj`PhKhjaPubah}(h]h ]h"]h$]h&]uh1jhjEPubeh}(h]h ]h"]h$]h&]uh1juhj`PhKhjBPubah}(h]h ]h"]h$]h&]uh1jphj&Pubh)}(h**Description**h]j)}(hjPh]h Description}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjPubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhKhj&Pubh)}(hFor PT_FEAT_SIGN_EXTEND this will return the lower range, and cover half the total page table. Otherwise it returns the entire page table.h]hFor PT_FEAT_SIGN_EXTEND this will return the lower range, and cover half the total page table. Otherwise it returns the entire page table.}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhKhj&Pubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj BhhhNhNubjN)}(hhh]h}(h]h ]h"]h$]h&]entries](jZpt_all_range (C function)c.pt_all_rangehNtauh1jMhj BhhhNhNubj_)}(hhh](jd)}(h7struct pt_range pt_all_range (struct pt_common *common)h]jj)}(h6struct pt_range pt_all_range(struct pt_common *common)h](jp)}(hjsh]hstruct}(hjPhhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johjPhhhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMubj)}(h h]h }(hjPhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjPhhhjPhMubh)}(hhh]j)}(hpt_rangeh]hpt_range}(hjPhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjPubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetjPmodnameN classnameNjc jf )}ji ]jl )}j_ pt_all_rangesbc.pt_all_rangeasbuh1hhjPhhhjPhMubj)}(h h]h }(hj QhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjPhhhjPhMubj)}(h pt_all_rangeh]j)}(hjQh]h pt_all_range}(hjQhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjQubah}(h]h ](jjeh"]h$]h&]hhuh1jhjPhhhjPhMubj )}(h(struct pt_common *common)h]j )}(hstruct pt_common *commonh](jp)}(hjsh]hstruct}(hj8QhhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johj4Qubj)}(h h]h }(hjEQhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4Qubh)}(hhh]j)}(h pt_commonh]h pt_common}(hjVQhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSQubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetjXQmodnameN classnameNjc jf )}ji ]jQc.pt_all_rangeasbuh1hhj4Qubj)}(h h]h }(hjtQhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4Qubj )}(hj h]h*}(hjQhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj4Qubj)}(hcommonh]hcommon}(hjQhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4Qubeh}(h]h ]h"]h$]h&]noemphhhuh1j hj0Qubah}(h]h ]h"]h$]h&]hhuh1j hjPhhhjPhMubeh}(h]h ]h"]h$]h&]hhjuh1jijjhjPhhhjPhMubah}(h]jPah ](jjeh"]h$]h&]jj)jhuh1jchjPhMhjPhhubj)}(hhh]h)}(h/Return a range that spans the entire page tableh]h/Return a range that spans the entire page table}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMhjQhhubah}(h]h ]h"]h$]h&]uh1jhjPhhhjPhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjQjjQjjjuh1j^hhhj BhNhNubj)}(h**Parameters** ``struct pt_common *common`` Table **Description** The returned range spans the whole page table. Due to how PT_FEAT_SIGN_EXTEND is supported range->va and range->last_va will be incorrect during the iteration and must not be accessed.h](h)}(h**Parameters**h]j)}(hjQh]h Parameters}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjQubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhM hjQubjq)}(hhh]jv)}(h#``struct pt_common *common`` Table h](j|)}(h``struct pt_common *common``h]jN)}(hjQh]hstruct pt_common *common}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jMhjQubah}(h]h ]h"]h$]h&]uh1j{hh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMhjQubj)}(hhh]h)}(hTableh]hTable}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjRhMhjRubah}(h]h ]h"]h$]h&]uh1jhjQubeh}(h]h ]h"]h$]h&]uh1juhjRhMhjQubah}(h]h ]h"]h$]h&]uh1jphjQubh)}(h**Description**h]j)}(hj5Rh]h Description}(hj7RhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj3Rubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMhjQubh)}(hThe returned range spans the whole page table. Due to how PT_FEAT_SIGN_EXTEND is supported range->va and range->last_va will be incorrect during the iteration and must not be accessed.h]hThe returned range spans the whole page table. Due to how PT_FEAT_SIGN_EXTEND is supported range->va and range->last_va will be incorrect during the iteration and must not be accessed.}(hjKRhhhNhNubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMhjQubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj BhhhNhNubjN)}(hhh]h}(h]h ]h"]h$]h&]entries](jZpt_upper_range (C function)c.pt_upper_rangehNtauh1jMhj BhhhNhNubj_)}(hhh](jd)}(h9struct pt_range pt_upper_range (struct pt_common *common)h]jj)}(h8struct pt_range pt_upper_range(struct pt_common *common)h](jp)}(hjsh]hstruct}(hjzRhhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johjvRhhhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMubj)}(h h]h }(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvRhhhjRhMubh)}(hhh]j)}(hpt_rangeh]hpt_range}(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetjRmodnameN classnameNjc jf )}ji ]jl )}j_ pt_upper_rangesbc.pt_upper_rangeasbuh1hhjvRhhhjRhMubj)}(h h]h }(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvRhhhjRhMubj)}(hpt_upper_rangeh]j)}(hjRh]hpt_upper_range}(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRubah}(h]h ](jjeh"]h$]h&]hhuh1jhjvRhhhjRhMubj )}(h(struct pt_common *common)h]j )}(hstruct pt_common *commonh](jp)}(hjsh]hstruct}(hjRhhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johjRubj)}(h h]h }(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRubh)}(hhh]j)}(h pt_commonh]h pt_common}(hjShhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetjSmodnameN classnameNjc jf )}ji ]jRc.pt_upper_rangeasbuh1hhjRubj)}(h h]h }(hj#ShhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRubj )}(hj h]h*}(hj1ShhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjRubj)}(hcommonh]hcommon}(hj>ShhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRubeh}(h]h ]h"]h$]h&]noemphhhuh1j hjRubah}(h]h ]h"]h$]h&]hhuh1j hjvRhhhjRhMubeh}(h]h ]h"]h$]h&]hhjuh1jijjhjrRhhhjRhMubah}(h]jmRah ](jjeh"]h$]h&]jj)jhuh1jchjRhMhjoRhhubj)}(hhh]h)}(h/Return a range that spans part of the top levelh]h/Return a range that spans part of the top level}(hjhShhhNhNubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMhjeShhubah}(h]h ]h"]h$]h&]uh1jhjoRhhhjRhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjSjjSjjjuh1j^hhhj BhNhNubj)}(h**Parameters** ``struct pt_common *common`` Table **Description** For PT_FEAT_SIGN_EXTEND this will return the upper range, and cover half the total page table. Otherwise it returns the entire page table.h](h)}(h**Parameters**h]j)}(hjSh]h Parameters}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1jhjSubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhM hjSubjq)}(hhh]jv)}(h#``struct pt_common *common`` Table h](j|)}(h``struct pt_common *common``h]jN)}(hjSh]hstruct pt_common *common}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1jMhjSubah}(h]h ]h"]h$]h&]uh1j{hh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMhjSubj)}(hhh]h)}(hTableh]hTable}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1hhjShMhjSubah}(h]h ]h"]h$]h&]uh1jhjSubeh}(h]h ]h"]h$]h&]uh1juhjShMhjSubah}(h]h ]h"]h$]h&]uh1jphjSubh)}(h**Description**h]j)}(hjSh]h Description}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1jhjSubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMhjSubh)}(hFor PT_FEAT_SIGN_EXTEND this will return the upper range, and cover half the total page table. Otherwise it returns the entire page table.h]hFor PT_FEAT_SIGN_EXTEND this will return the upper range, and cover half the total page table. Otherwise it returns the entire page table.}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMhjSubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj BhhhNhNubjN)}(hhh]h}(h]h ]h"]h$]h&]entries](jZpt_make_range (C function)c.pt_make_rangehNtauh1jMhj BhhhNhNubj_)}(hhh](jd)}(h[struct pt_range pt_make_range (struct pt_common *common, pt_vaddr_t va, pt_vaddr_t last_va)h]jj)}(hZstruct pt_range pt_make_range(struct pt_common *common, pt_vaddr_t va, pt_vaddr_t last_va)h](jp)}(hjsh]hstruct}(hj)ThhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johj%Thhhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhM/ubj)}(h h]h }(hj7ThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%Thhhj6ThM/ubh)}(hhh]j)}(hpt_rangeh]hpt_range}(hjHThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjETubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetjJTmodnameN classnameNjc jf )}ji ]jl )}j_ pt_make_rangesbc.pt_make_rangeasbuh1hhj%Thhhj6ThM/ubj)}(h h]h }(hjiThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%Thhhj6ThM/ubj)}(h pt_make_rangeh]j)}(hjfTh]h pt_make_range}(hj{ThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjwTubah}(h]h ](jjeh"]h$]h&]hhuh1jhj%Thhhj6ThM/ubj )}(h=(struct pt_common *common, pt_vaddr_t va, pt_vaddr_t last_va)h](j )}(hstruct pt_common *commonh](jp)}(hjsh]hstruct}(hjThhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johjTubj)}(h h]h }(hjThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjTubh)}(hhh]j)}(h pt_commonh]h pt_common}(hjThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjTubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetjTmodnameN classnameNjc jf )}ji ]jdTc.pt_make_rangeasbuh1hhjTubj)}(h h]h }(hjThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjTubj )}(hj h]h*}(hjThhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjTubj)}(hcommonh]hcommon}(hjThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjTubeh}(h]h ]h"]h$]h&]noemphhhuh1j hjTubj )}(h pt_vaddr_t vah](h)}(hhh]j)}(h pt_vaddr_th]h pt_vaddr_t}(hj UhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjUubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetj UmodnameN classnameNjc jf )}ji ]jdTc.pt_make_rangeasbuh1hhjUubj)}(h h]h }(hj'UhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjUubj)}(hvah]hva}(hj5UhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjUubeh}(h]h ]h"]h$]h&]noemphhhuh1j hjTubj )}(hpt_vaddr_t last_vah](h)}(hhh]j)}(h pt_vaddr_th]h pt_vaddr_t}(hjQUhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNUubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetjSUmodnameN classnameNjc jf )}ji ]jdTc.pt_make_rangeasbuh1hhjJUubj)}(h h]h }(hjoUhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJUubj)}(hlast_vah]hlast_va}(hj}UhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJUubeh}(h]h ]h"]h$]h&]noemphhhuh1j hjTubeh}(h]h ]h"]h$]h&]hhuh1j hj%Thhhj6ThM/ubeh}(h]h ]h"]h$]h&]hhjuh1jijjhj!Thhhj6ThM/ubah}(h]jTah ](jjeh"]h$]h&]jj)jhuh1jchj6ThM/hjThhubj)}(hhh]h)}(h+Return a range that spans part of the tableh]h+Return a range that spans part of the table}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhM/hjUhhubah}(h]h ]h"]h$]h&]uh1jhjThhhj6ThM/ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjUjjUjjjuh1j^hhhj BhNhNubj)}(h**Parameters** ``struct pt_common *common`` Table ``pt_vaddr_t va`` Start address ``pt_vaddr_t last_va`` Last address **Description** The caller must validate the range with pt_check_range() before using it.h](h)}(h**Parameters**h]j)}(hjUh]h Parameters}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjUubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhM3hjUubjq)}(hhh](jv)}(h#``struct pt_common *common`` Table h](j|)}(h``struct pt_common *common``h]jN)}(hjUh]hstruct pt_common *common}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1jMhjUubah}(h]h ]h"]h$]h&]uh1j{hh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhM0hjUubj)}(hhh]h)}(hTableh]hTable}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjUhM0hjUubah}(h]h ]h"]h$]h&]uh1jhjUubeh}(h]h ]h"]h$]h&]uh1juhjUhM0hjUubjv)}(h ``pt_vaddr_t va`` Start address h](j|)}(h``pt_vaddr_t va``h]jN)}(hj!Vh]h pt_vaddr_t va}(hj#VhhhNhNubah}(h]h ]h"]h$]h&]uh1jMhjVubah}(h]h ]h"]h$]h&]uh1j{hh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhM1hjVubj)}(hhh]h)}(h Start addressh]h Start address}(hj:VhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj6VhM1hj7Vubah}(h]h ]h"]h$]h&]uh1jhjVubeh}(h]h ]h"]h$]h&]uh1juhj6VhM1hjUubjv)}(h$``pt_vaddr_t last_va`` Last address h](j|)}(h``pt_vaddr_t last_va``h]jN)}(hjZVh]hpt_vaddr_t last_va}(hj\VhhhNhNubah}(h]h ]h"]h$]h&]uh1jMhjXVubah}(h]h ]h"]h$]h&]uh1j{hh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhM2hjTVubj)}(hhh]h)}(h Last addressh]h Last address}(hjsVhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjoVhM2hjpVubah}(h]h ]h"]h$]h&]uh1jhjTVubeh}(h]h ]h"]h$]h&]uh1juhjoVhM2hjUubeh}(h]h ]h"]h$]h&]uh1jphjUubh)}(h**Description**h]j)}(hjVh]h Description}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjVubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhM4hjUubh)}(hIThe caller must validate the range with pt_check_range() before using it.h]hIThe caller must validate the range with pt_check_range() before using it.}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhM3hjUubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj BhhhNhNubjN)}(hhh]h}(h]h ]h"]h$]h&]entries](jZpt_init (C function) c.pt_inithNtauh1jMhj BhhhNhNubj_)}(hhh](jd)}(h^struct pt_state pt_init (struct pt_range *range, unsigned int level, struct pt_table_p *table)h]jj)}(h]struct pt_state pt_init(struct pt_range *range, unsigned int level, struct pt_table_p *table)h](jp)}(hjsh]hstruct}(hjVhhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johjVhhhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMVubj)}(h h]h }(hjVhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVhhhjVhMVubh)}(hhh]j)}(hpt_stateh]hpt_state}(hjVhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetjVmodnameN classnameNjc jf )}ji ]jl )}j_ pt_initsb c.pt_initasbuh1hhjVhhhjVhMVubj)}(h h]h }(hjWhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVhhhjVhMVubj)}(hpt_inith]j)}(hjWh]hpt_init}(hj,WhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(Wubah}(h]h ](jjeh"]h$]h&]hhuh1jhjVhhhjVhMVubj )}(hF(struct pt_range *range, unsigned int level, struct pt_table_p *table)h](j )}(hstruct pt_range *rangeh](jp)}(hjsh]hstruct}(hjGWhhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johjCWubj)}(h h]h }(hjTWhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCWubh)}(hhh]j)}(hpt_rangeh]hpt_range}(hjeWhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjbWubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetjgWmodnameN classnameNjc jf )}ji ]jW c.pt_initasbuh1hhjCWubj)}(h h]h }(hjWhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCWubj )}(hj h]h*}(hjWhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjCWubj)}(hrangeh]hrange}(hjWhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCWubeh}(h]h ]h"]h$]h&]noemphhhuh1j hj?Wubj )}(hunsigned int levelh](j )}(hunsignedh]hunsigned}(hjWhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjWubj)}(h h]h }(hjWhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjWubj )}(hinth]hint}(hjWhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjWubj)}(h h]h }(hjWhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjWubj)}(hlevelh]hlevel}(hjWhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjWubeh}(h]h ]h"]h$]h&]noemphhhuh1j hj?Wubj )}(hstruct pt_table_p *tableh](jp)}(hjsh]hstruct}(hjXhhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johjXubj)}(h h]h }(hjXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjXubh)}(hhh]j)}(h pt_table_ph]h pt_table_p}(hj&XhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#Xubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetj(XmodnameN classnameNjc jf )}ji ]jW c.pt_initasbuh1hhjXubj)}(h h]h }(hjDXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjXubj )}(hj h]h*}(hjRXhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjXubj)}(htableh]htable}(hj_XhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjXubeh}(h]h ]h"]h$]h&]noemphhhuh1j hj?Wubeh}(h]h ]h"]h$]h&]hhuh1j hjVhhhjVhMVubeh}(h]h ]h"]h$]h&]hhjuh1jijjhjVhhhjVhMVubah}(h]jVah ](jjeh"]h$]h&]jj)jhuh1jchjVhMVhjVhhubj)}(hhh]h)}(h"Initialize a pt_state on the stackh]h"Initialize a pt_state on the stack}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMVhjXhhubah}(h]h ]h"]h$]h&]uh1jhjVhhhjVhMVubeh}(h]h ](jfunctioneh"]h$]h&]jjjjXjjXjjjuh1j^hhhj BhNhNubj)}(hX**Parameters** ``struct pt_range *range`` Range pointer to embed in the state ``unsigned int level`` Table level for the state ``struct pt_table_p *table`` Pointer to the table memory at level **Description** Helper to initialize the on-stack pt_state from walker arguments.h](h)}(h**Parameters**h]j)}(hjXh]h Parameters}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjXubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMZhjXubjq)}(hhh](jv)}(h?``struct pt_range *range`` Range pointer to embed in the state h](j|)}(h``struct pt_range *range``h]jN)}(hjXh]hstruct pt_range *range}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1jMhjXubah}(h]h ]h"]h$]h&]uh1j{hh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMWhjXubj)}(hhh]h)}(h#Range pointer to embed in the stateh]h#Range pointer to embed in the state}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjXhMWhjXubah}(h]h ]h"]h$]h&]uh1jhjXubeh}(h]h ]h"]h$]h&]uh1juhjXhMWhjXubjv)}(h1``unsigned int level`` Table level for the state h](j|)}(h``unsigned int level``h]jN)}(hjYh]hunsigned int level}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jMhjYubah}(h]h ]h"]h$]h&]uh1j{hh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMXhjXubj)}(hhh]h)}(hTable level for the stateh]hTable level for the state}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjYhMXhjYubah}(h]h ]h"]h$]h&]uh1jhjXubeh}(h]h ]h"]h$]h&]uh1juhjYhMXhjXubjv)}(hB``struct pt_table_p *table`` Pointer to the table memory at level h](j|)}(h``struct pt_table_p *table``h]jN)}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jMhj:Yubah}(h]h ]h"]h$]h&]uh1j{hh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMYhj6Yubj)}(hhh]h)}(h$Pointer to the table memory at levelh]h$Pointer to the table memory at level}(hjUYhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjQYhMYhjRYubah}(h]h ]h"]h$]h&]uh1jhj6Yubeh}(h]h ]h"]h$]h&]uh1juhjQYhMYhjXubeh}(h]h ]h"]h$]h&]uh1jphjXubh)}(h**Description**h]j)}(hjwYh]h Description}(hjyYhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjuYubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhM[hjXubh)}(hAHelper to initialize the on-stack pt_state from walker arguments.h]hAHelper to initialize the on-stack pt_state from walker arguments.}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMZhjXubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj BhhhNhNubjN)}(hhh]h}(h]h ]h"]h$]h&]entries](jZpt_init_top (C function) c.pt_init_tophNtauh1jMhj BhhhNhNubj_)}(hhh](jd)}(h4struct pt_state pt_init_top (struct pt_range *range)h]jj)}(h3struct pt_state pt_init_top(struct pt_range *range)h](jp)}(hjsh]hstruct}(hjYhhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johjYhhhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMiubj)}(h h]h }(hjYhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjYhhhjYhMiubh)}(hhh]j)}(hpt_stateh]hpt_state}(hjYhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjYubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetjYmodnameN classnameNjc jf )}ji ]jl )}j_ pt_init_topsb c.pt_init_topasbuh1hhjYhhhjYhMiubj)}(h h]h }(hjYhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjYhhhjYhMiubj)}(h pt_init_toph]j)}(hjYh]h pt_init_top}(hjZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj Zubah}(h]h ](jjeh"]h$]h&]hhuh1jhjYhhhjYhMiubj )}(h(struct pt_range *range)h]j )}(hstruct pt_range *rangeh](jp)}(hjsh]hstruct}(hj)ZhhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johj%Zubj)}(h h]h }(hj6ZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%Zubh)}(hhh]j)}(hpt_rangeh]hpt_range}(hjGZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjDZubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetjIZmodnameN classnameNjc jf )}ji ]jY c.pt_init_topasbuh1hhj%Zubj)}(h h]h }(hjeZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%Zubj )}(hj h]h*}(hjsZhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj%Zubj)}(hrangeh]hrange}(hjZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%Zubeh}(h]h ]h"]h$]h&]noemphhhuh1j hj!Zubah}(h]h ]h"]h$]h&]hhuh1j hjYhhhjYhMiubeh}(h]h ]h"]h$]h&]hhjuh1jijjhjYhhhjYhMiubah}(h]jYah ](jjeh"]h$]h&]jj)jhuh1jchjYhMihjYhhubj)}(hhh]h)}(h"Initialize a pt_state on the stackh]h"Initialize a pt_state on the stack}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMihjZhhubah}(h]h ]h"]h$]h&]uh1jhjYhhhjYhMiubeh}(h]h ](jfunctioneh"]h$]h&]jjjjZjjZjjjuh1j^hhhj BhNhNubj)}(h**Parameters** ``struct pt_range *range`` Range pointer to embed in the state **Description** The pt_state points to the top most level.h](h)}(h**Parameters**h]j)}(hjZh]h Parameters}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjZubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMmhjZubjq)}(hhh]jv)}(h?``struct pt_range *range`` Range pointer to embed in the state h](j|)}(h``struct pt_range *range``h]jN)}(hjZh]hstruct pt_range *range}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1jMhjZubah}(h]h ]h"]h$]h&]uh1j{hh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMjhjZubj)}(hhh]h)}(h#Range pointer to embed in the stateh]h#Range pointer to embed in the state}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj[hMjhj[ubah}(h]h ]h"]h$]h&]uh1jhjZubeh}(h]h ]h"]h$]h&]uh1juhj[hMjhjZubah}(h]h ]h"]h$]h&]uh1jphjZubh)}(h**Description**h]j)}(hj&[h]h Description}(hj([hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj$[ubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMlhjZubh)}(h*The pt_state points to the top most level.h]h*The pt_state points to the top most level.}(hj<[hhhNhNubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMkhjZubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj BhhhNhNubjN)}(hhh]h}(h]h ]h"]h$]h&]entries](jZpt_descend (C function) c.pt_descendhNtauh1jMhj BhhhNhNubj_)}(hhh](jd)}(hBint pt_descend (struct pt_state *pts, void *arg, pt_level_fn_t fn)h]jj)}(hAint pt_descend(struct pt_state *pts, void *arg, pt_level_fn_t fn)h](j )}(hinth]hint}(hjk[hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjg[hhhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMwubj)}(h h]h }(hjz[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjg[hhhjy[hMwubj)}(h pt_descendh]j)}(h pt_descendh]h pt_descend}(hj[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj[ubah}(h]h ](jjeh"]h$]h&]hhuh1jhjg[hhhjy[hMwubj )}(h3(struct pt_state *pts, void *arg, pt_level_fn_t fn)h](j )}(hstruct pt_state *ptsh](jp)}(hjsh]hstruct}(hj[hhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johj[ubj)}(h h]h }(hj[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj[ubh)}(hhh]j)}(hpt_stateh]hpt_state}(hj[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj[ubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetj[modnameN classnameNjc jf )}ji ]jl )}j_ j[sb c.pt_descendasbuh1hhj[ubj)}(h h]h }(hj[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj[ubj )}(hj h]h*}(hj[hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj[ubj)}(hptsh]hpts}(hj\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj[ubeh}(h]h ]h"]h$]h&]noemphhhuh1j hj[ubj )}(h void *argh](j )}(hvoidh]hvoid}(hj\hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj\ubj)}(h h]h }(hj(\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\ubj )}(hj h]h*}(hj6\hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj\ubj)}(hargh]harg}(hjC\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\ubeh}(h]h ]h"]h$]h&]noemphhhuh1j hj[ubj )}(hpt_level_fn_t fnh](h)}(hhh]j)}(h pt_level_fn_th]h pt_level_fn_t}(hj_\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\\ubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetja\modnameN classnameNjc jf )}ji ]j[ c.pt_descendasbuh1hhjX\ubj)}(h h]h }(hj}\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjX\ubj)}(hfnh]hfn}(hj\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjX\ubeh}(h]h ]h"]h$]h&]noemphhhuh1j hj[ubeh}(h]h ]h"]h$]h&]hhuh1j hjg[hhhjy[hMwubeh}(h]h ]h"]h$]h&]hhjuh1jijjhjc[hhhjy[hMwubah}(h]j^[ah ](jjeh"]h$]h&]jj)jhuh1jchjy[hMwhj`[hhubj)}(hhh]h)}(h1Recursively invoke the walker for the lower levelh]h1Recursively invoke the walker for the lower level}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMwhj\hhubah}(h]h ]h"]h$]h&]uh1jhj`[hhhjy[hMwubeh}(h]h ](jfunctioneh"]h$]h&]jjjj\jj\jjjuh1j^hhhj BhNhNubj)}(h**Parameters** ``struct pt_state *pts`` Iteration State ``void *arg`` Value to pass to the function ``pt_level_fn_t fn`` Walker function to call **Description** pts must point to a table item. Invoke fn as a walker on the table pts points to.h](h)}(h**Parameters**h]j)}(hj\h]h Parameters}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj\ubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhM{hj\ubjq)}(hhh](jv)}(h)``struct pt_state *pts`` Iteration State h](j|)}(h``struct pt_state *pts``h]jN)}(hj\h]hstruct pt_state *pts}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1jMhj\ubah}(h]h ]h"]h$]h&]uh1j{hh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMxhj\ubj)}(hhh]h)}(hIteration Stateh]hIteration State}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj ]hMxhj ]ubah}(h]h ]h"]h$]h&]uh1jhj\ubeh}(h]h ]h"]h$]h&]uh1juhj ]hMxhj\ubjv)}(h,``void *arg`` Value to pass to the function h](j|)}(h ``void *arg``h]jN)}(hj/]h]h void *arg}(hj1]hhhNhNubah}(h]h ]h"]h$]h&]uh1jMhj-]ubah}(h]h ]h"]h$]h&]uh1j{hh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMyhj)]ubj)}(hhh]h)}(hValue to pass to the functionh]hValue to pass to the function}(hjH]hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjD]hMyhjE]ubah}(h]h ]h"]h$]h&]uh1jhj)]ubeh}(h]h ]h"]h$]h&]uh1juhjD]hMyhj\ubjv)}(h-``pt_level_fn_t fn`` Walker function to call h](j|)}(h``pt_level_fn_t fn``h]jN)}(hjh]h]hpt_level_fn_t fn}(hjj]hhhNhNubah}(h]h ]h"]h$]h&]uh1jMhjf]ubah}(h]h ]h"]h$]h&]uh1j{hh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMzhjb]ubj)}(hhh]h)}(hWalker function to callh]hWalker function to call}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj}]hMzhj~]ubah}(h]h ]h"]h$]h&]uh1jhjb]ubeh}(h]h ]h"]h$]h&]uh1juhj}]hMzhj\ubeh}(h]h ]h"]h$]h&]uh1jphj\ubh)}(h**Description**h]j)}(hj]h]h Description}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj]ubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhM|hj\ubh)}(hQpts must point to a table item. Invoke fn as a walker on the table pts points to.h]hQpts must point to a table item. Invoke fn as a walker on the table pts points to.}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhM{hj\ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj BhhhNhNubjN)}(hhh]h}(h]h ]h"]h$]h&]entries](jZpt_walk_range (C function)c.pt_walk_rangehNtauh1jMhj BhhhNhNubj_)}(hhh](jd)}(hGint pt_walk_range (struct pt_range *range, pt_level_fn_t fn, void *arg)h]jj)}(hFint pt_walk_range(struct pt_range *range, pt_level_fn_t fn, void *arg)h](j )}(hinth]hint}(hj]hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj]hhhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMubj)}(h h]h }(hj]hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj]hhhj]hMubj)}(h pt_walk_rangeh]j)}(h pt_walk_rangeh]h pt_walk_range}(hj ^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^ubah}(h]h ](jjeh"]h$]h&]hhuh1jhj]hhhj]hMubj )}(h5(struct pt_range *range, pt_level_fn_t fn, void *arg)h](j )}(hstruct pt_range *rangeh](jp)}(hjsh]hstruct}(hj%^hhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johj!^ubj)}(h h]h }(hj2^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!^ubh)}(hhh]j)}(hpt_rangeh]hpt_range}(hjC^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@^ubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetjE^modnameN classnameNjc jf )}ji ]jl )}j_ j ^sbc.pt_walk_rangeasbuh1hhj!^ubj)}(h h]h }(hjc^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!^ubj )}(hj h]h*}(hjq^hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj!^ubj)}(hrangeh]hrange}(hj~^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!^ubeh}(h]h ]h"]h$]h&]noemphhhuh1j hj^ubj )}(hpt_level_fn_t fnh](h)}(hhh]j)}(h pt_level_fn_th]h pt_level_fn_t}(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^ubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetj^modnameN classnameNjc jf )}ji ]j_^c.pt_walk_rangeasbuh1hhj^ubj)}(h h]h }(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^ubj)}(hfnh]hfn}(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^ubeh}(h]h ]h"]h$]h&]noemphhhuh1j hj^ubj )}(h void *argh](j )}(hvoidh]hvoid}(hj^hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj^ubj)}(h h]h }(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^ubj )}(hj h]h*}(hj^hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj^ubj)}(hargh]harg}(hj_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^ubeh}(h]h ]h"]h$]h&]noemphhhuh1j hj^ubeh}(h]h ]h"]h$]h&]hhuh1j hj]hhhj]hMubeh}(h]h ]h"]h$]h&]hhjuh1jijjhj]hhhj]hMubah}(h]j]ah ](jjeh"]h$]h&]jj)jhuh1jchj]hMhj]hhubj)}(hhh]h)}(hWalk over a VA rangeh]hWalk over a VA range}(hj2_hhhNhNubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMhj/_hhubah}(h]h ]h"]h$]h&]uh1jhj]hhhj]hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjJ_jjJ_jjjuh1j^hhhj BhNhNubj)}(hXR**Parameters** ``struct pt_range *range`` Range pointer ``pt_level_fn_t fn`` Walker function to call ``void *arg`` Value to pass to the function **Description** Walk over a VA range. The caller should have done a validity check, at least calling pt_check_range(), when building range. The walk will start at the top most table.h](h)}(h**Parameters**h]j)}(hjT_h]h Parameters}(hjV_hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjR_ubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMhjN_ubjq)}(hhh](jv)}(h)``struct pt_range *range`` Range pointer h](j|)}(h``struct pt_range *range``h]jN)}(hjs_h]hstruct pt_range *range}(hju_hhhNhNubah}(h]h ]h"]h$]h&]uh1jMhjq_ubah}(h]h ]h"]h$]h&]uh1j{hh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMhjm_ubj)}(hhh]h)}(h Range pointerh]h Range pointer}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj_hMhj_ubah}(h]h ]h"]h$]h&]uh1jhjm_ubeh}(h]h ]h"]h$]h&]uh1juhj_hMhjj_ubjv)}(h-``pt_level_fn_t fn`` Walker function to call h](j|)}(h``pt_level_fn_t fn``h]jN)}(hj_h]hpt_level_fn_t fn}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1jMhj_ubah}(h]h ]h"]h$]h&]uh1j{hh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMhj_ubj)}(hhh]h)}(hWalker function to callh]hWalker function to call}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj_hMhj_ubah}(h]h ]h"]h$]h&]uh1jhj_ubeh}(h]h ]h"]h$]h&]uh1juhj_hMhjj_ubjv)}(h,``void *arg`` Value to pass to the function h](j|)}(h ``void *arg``h]jN)}(hj_h]h void *arg}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1jMhj_ubah}(h]h ]h"]h$]h&]uh1j{hh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMhj_ubj)}(hhh]h)}(hValue to pass to the functionh]hValue to pass to the function}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj_hMhj_ubah}(h]h ]h"]h$]h&]uh1jhj_ubeh}(h]h ]h"]h$]h&]uh1juhj_hMhjj_ubeh}(h]h ]h"]h$]h&]uh1jphjN_ubh)}(h**Description**h]j)}(hj `h]h Description}(hj"`hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj`ubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMhjN_ubh)}(hWalk over a VA range. The caller should have done a validity check, at least calling pt_check_range(), when building range. The walk will start at the top most table.h]hWalk over a VA range. The caller should have done a validity check, at least calling pt_check_range(), when building range. The walk will start at the top most table.}(hj6`hhhNhNubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMhjN_ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj BhhhNhNubjN)}(hhh]h}(h]h ]h"]h$]h&]entries](jZpt_range_slice (C function)c.pt_range_slicehNtauh1jMhj BhhhNhNubj_)}(hhh](jd)}(hmstruct pt_range pt_range_slice (const struct pt_state *pts, unsigned int start_index, unsigned int end_index)h]jj)}(hlstruct pt_range pt_range_slice(const struct pt_state *pts, unsigned int start_index, unsigned int end_index)h](jp)}(hjsh]hstruct}(hje`hhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johja`hhhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMubj)}(h h]h }(hjs`hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhja`hhhjr`hMubh)}(hhh]j)}(hpt_rangeh]hpt_range}(hj`hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj`ubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetj`modnameN classnameNjc jf )}ji ]jl )}j_ pt_range_slicesbc.pt_range_sliceasbuh1hhja`hhhjr`hMubj)}(h h]h }(hj`hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhja`hhhjr`hMubj)}(hpt_range_sliceh]j)}(hj`h]hpt_range_slice}(hj`hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj`ubah}(h]h ](jjeh"]h$]h&]hhuh1jhja`hhhjr`hMubj )}(hN(const struct pt_state *pts, unsigned int start_index, unsigned int end_index)h](j )}(hconst struct pt_state *ptsh](jp)}(hj h]hconst}(hj`hhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johj`ubj)}(h h]h }(hj`hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj`ubjp)}(hjsh]hstruct}(hj`hhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johj`ubj)}(h h]h }(hj`hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj`ubh)}(hhh]j)}(hpt_stateh]hpt_state}(hj ahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetj amodnameN classnameNjc jf )}ji ]j`c.pt_range_sliceasbuh1hhj`ubj)}(h h]h }(hj)ahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj`ubj )}(hj h]h*}(hj7ahhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj`ubj)}(hptsh]hpts}(hjDahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj`ubeh}(h]h ]h"]h$]h&]noemphhhuh1j hj`ubj )}(hunsigned int start_indexh](j )}(hunsignedh]hunsigned}(hj]ahhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjYaubj)}(h h]h }(hjkahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjYaubj )}(hinth]hint}(hjyahhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjYaubj)}(h h]h }(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjYaubj)}(h start_indexh]h start_index}(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjYaubeh}(h]h ]h"]h$]h&]noemphhhuh1j hj`ubj )}(hunsigned int end_indexh](j )}(hunsignedh]hunsigned}(hjahhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjaubj)}(h h]h }(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubj )}(hinth]hint}(hjahhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjaubj)}(h h]h }(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubj)}(h end_indexh]h end_index}(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubeh}(h]h ]h"]h$]h&]noemphhhuh1j hj`ubeh}(h]h ]h"]h$]h&]hhuh1j hja`hhhjr`hMubeh}(h]h ]h"]h$]h&]hhjuh1jijjhj]`hhhjr`hMubah}(h]jX`ah ](jjeh"]h$]h&]jj)jhuh1jchjr`hMhjZ`hhubj)}(hhh]h)}(h!Return a range that spans indexesh]h!Return a range that spans indexes}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMhj bhhubah}(h]h ]h"]h$]h&]uh1jhjZ`hhhjr`hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjj(bjj(bjjjuh1j^hhhj BhNhNubj)}(hX**Parameters** ``const struct pt_state *pts`` Iteration State ``unsigned int start_index`` Starting index within pts ``unsigned int end_index`` Ending index within pts **Description** Create a range than spans an index range of the current table level pt_state points at.h](h)}(h**Parameters**h]j)}(hj2bh]h Parameters}(hj4bhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj0bubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMhj,bubjq)}(hhh](jv)}(h/``const struct pt_state *pts`` Iteration State h](j|)}(h``const struct pt_state *pts``h]jN)}(hjQbh]hconst struct pt_state *pts}(hjSbhhhNhNubah}(h]h ]h"]h$]h&]uh1jMhjObubah}(h]h ]h"]h$]h&]uh1j{hh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMhjKbubj)}(hhh]h)}(hIteration Stateh]hIteration State}(hjjbhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjfbhMhjgbubah}(h]h ]h"]h$]h&]uh1jhjKbubeh}(h]h ]h"]h$]h&]uh1juhjfbhMhjHbubjv)}(h7``unsigned int start_index`` Starting index within pts h](j|)}(h``unsigned int start_index``h]jN)}(hjbh]hunsigned int start_index}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1jMhjbubah}(h]h ]h"]h$]h&]uh1j{hh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMhjbubj)}(hhh]h)}(hStarting index within ptsh]hStarting index within pts}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjbhMhjbubah}(h]h ]h"]h$]h&]uh1jhjbubeh}(h]h ]h"]h$]h&]uh1juhjbhMhjHbubjv)}(h3``unsigned int end_index`` Ending index within pts h](j|)}(h``unsigned int end_index``h]jN)}(hjbh]hunsigned int end_index}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1jMhjbubah}(h]h ]h"]h$]h&]uh1j{hh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMhjbubj)}(hhh]h)}(hEnding index within ptsh]hEnding index within pts}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjbhMhjbubah}(h]h ]h"]h$]h&]uh1jhjbubeh}(h]h ]h"]h$]h&]uh1juhjbhMhjHbubeh}(h]h ]h"]h$]h&]uh1jphj,bubh)}(h**Description**h]j)}(hjbh]h Description}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jhjbubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMhj,bubh)}(hWCreate a range than spans an index range of the current table level pt_state points at.h]hWCreate a range than spans an index range of the current table level pt_state points at.}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMhj,bubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj BhhhNhNubjN)}(hhh]h}(h]h ]h"]h$]h&]entries](jZpt_top_memsize_lg2 (C function)c.pt_top_memsize_lg2hNtauh1jMhj BhhhNhNubj_)}(hhh](jd)}(hRunsigned int pt_top_memsize_lg2 (struct pt_common *common, uintptr_t top_of_table)h]jj)}(hQunsigned int pt_top_memsize_lg2(struct pt_common *common, uintptr_t top_of_table)h](j )}(hunsignedh]hunsigned}(hjCchhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj?chhhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMubj)}(h h]h }(hjRchhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?chhhjQchMubj )}(hinth]hint}(hj`chhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj?chhhjQchMubj)}(h h]h }(hjnchhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?chhhjQchMubj)}(hpt_top_memsize_lg2h]j)}(hpt_top_memsize_lg2h]hpt_top_memsize_lg2}(hjchhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|cubah}(h]h ](jjeh"]h$]h&]hhuh1jhj?chhhjQchMubj )}(h2(struct pt_common *common, uintptr_t top_of_table)h](j )}(hstruct pt_common *commonh](jp)}(hjsh]hstruct}(hjchhhNhNubah}(h]h ]j|ah"]h$]h&]uh1johjcubj)}(h h]h }(hjchhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjcubh)}(hhh]j)}(h pt_commonh]h pt_common}(hjchhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjcubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetjcmodnameN classnameNjc jf )}ji ]jl )}j_ jcsbc.pt_top_memsize_lg2asbuh1hhjcubj)}(h h]h }(hjchhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjcubj )}(hj h]h*}(hjchhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjcubj)}(hcommonh]hcommon}(hjchhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjcubeh}(h]h ]h"]h$]h&]noemphhhuh1j hjcubj )}(huintptr_t top_of_tableh](h)}(hhh]j)}(h uintptr_th]ht uintptr_t}(hjdhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjdubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetjdmodnameN classnameNjc jf )}ji ]jcc.pt_top_memsize_lg2asbuh1hhj dubj)}(h h]h }(hj/dhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj dubj)}(h top_of_tableh]h top_of_table}(hj=dhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj dubeh}(h]h ]h"]h$]h&]noemphhhuh1j hjcubeh}(h]h ]h"]h$]h&]hhuh1j hj?chhhjQchMubeh}(h]h ]h"]h$]h&]hhjuh1jijjhj;chhhjQchMubah}(h]j6cah ](jjeh"]h$]h&]jj)jhuh1jchjQchMhj8chhubj)}(hhh]h}(h]h ]h"]h$]h&]uh1jhj8chhhjQchMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjpdjjpdjjjuh1j^hhhj BhNhNubj)}(hX **Parameters** ``struct pt_common *common`` Table ``uintptr_t top_of_table`` Top of table value from _pt_top_set() **Description** Compute the allocation size of the top table. For PT_FEAT_DYNAMIC_TOP this will compute the top size assuming the table will grow.h](h)}(h**Parameters**h]j)}(hjzdh]h Parameters}(hj|dhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjxdubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMhjtdubjq)}(hhh](jv)}(h#``struct pt_common *common`` Table h](j|)}(h``struct pt_common *common``h]jN)}(hjdh]hstruct pt_common *common}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1jMhjdubah}(h]h ]h"]h$]h&]uh1j{hh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMhjdubj)}(hhh]h)}(hTableh]hTable}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjdhMhjdubah}(h]h ]h"]h$]h&]uh1jhjdubeh}(h]h ]h"]h$]h&]uh1juhjdhMhjdubjv)}(hA``uintptr_t top_of_table`` Top of table value from _pt_top_set() h](j|)}(h``uintptr_t top_of_table``h]jN)}(hjdh]huintptr_t top_of_table}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1jMhjdubah}(h]h ]h"]h$]h&]uh1j{hh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMhjdubj)}(hhh]h)}(h%Top of table value from _pt_top_set()h]h%Top of table value from _pt_top_set()}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjdhMhjdubah}(h]h ]h"]h$]h&]uh1jhjdubeh}(h]h ]h"]h$]h&]uh1juhjdhMhjdubeh}(h]h ]h"]h$]h&]uh1jphjtdubh)}(h**Description**h]j)}(hj eh]h Description}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1jhj eubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMhjtdubh)}(hCompute the allocation size of the top table. For PT_FEAT_DYNAMIC_TOP this will compute the top size assuming the table will grow.h]hCompute the allocation size of the top table. For PT_FEAT_DYNAMIC_TOP this will compute the top size assuming the table will grow.}(hj#ehhhNhNubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMhjtdubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj BhhhNhNubjN)}(hhh]h}(h]h ]h"]h$]h&]entries](jZ#pt_compute_best_pgsize (C function)c.pt_compute_best_pgsizehNtauh1jMhj BhhhNhNubj_)}(hhh](jd)}(hnunsigned int pt_compute_best_pgsize (pt_vaddr_t pgsz_bitmap, pt_vaddr_t va, pt_vaddr_t last_va, pt_oaddr_t oa)h]jj)}(hmunsigned int pt_compute_best_pgsize(pt_vaddr_t pgsz_bitmap, pt_vaddr_t va, pt_vaddr_t last_va, pt_oaddr_t oa)h](j )}(hunsignedh]hunsigned}(hjRehhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjNehhhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMubj)}(h h]h }(hjaehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNehhhj`ehMubj )}(hinth]hint}(hjoehhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjNehhhj`ehMubj)}(h h]h }(hj}ehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNehhhj`ehMubj)}(hpt_compute_best_pgsizeh]j)}(hpt_compute_best_pgsizeh]hpt_compute_best_pgsize}(hjehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubah}(h]h ](jjeh"]h$]h&]hhuh1jhjNehhhj`ehMubj )}(hJ(pt_vaddr_t pgsz_bitmap, pt_vaddr_t va, pt_vaddr_t last_va, pt_oaddr_t oa)h](j )}(hpt_vaddr_t pgsz_bitmaph](h)}(hhh]j)}(h pt_vaddr_th]h pt_vaddr_t}(hjehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetjemodnameN classnameNjc jf )}ji ]jl )}j_ jesbc.pt_compute_best_pgsizeasbuh1hhjeubj)}(h h]h }(hjehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubj)}(h pgsz_bitmaph]h pgsz_bitmap}(hjehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubeh}(h]h ]h"]h$]h&]noemphhhuh1j hjeubj )}(h pt_vaddr_t vah](h)}(hhh]j)}(h pt_vaddr_th]h pt_vaddr_t}(hjehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetjemodnameN classnameNjc jf )}ji ]jec.pt_compute_best_pgsizeasbuh1hhjeubj)}(h h]h }(hjfhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubj)}(hvah]hva}(hj$fhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubeh}(h]h ]h"]h$]h&]noemphhhuh1j hjeubj )}(hpt_vaddr_t last_vah](h)}(hhh]j)}(h pt_vaddr_th]h pt_vaddr_t}(hj@fhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=fubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetjBfmodnameN classnameNjc jf )}ji ]jec.pt_compute_best_pgsizeasbuh1hhj9fubj)}(h h]h }(hj^fhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9fubj)}(hlast_vah]hlast_va}(hjlfhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9fubeh}(h]h ]h"]h$]h&]noemphhhuh1j hjeubj )}(h pt_oaddr_t oah](h)}(hhh]j)}(h pt_oaddr_th]h pt_oaddr_t}(hjfhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjfubah}(h]h ]h"]h$]h&] refdomainjreftypej_ reftargetjfmodnameN classnameNjc jf )}ji ]jec.pt_compute_best_pgsizeasbuh1hhjfubj)}(h h]h }(hjfhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjfubj)}(hoah]hoa}(hjfhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjfubeh}(h]h ]h"]h$]h&]noemphhhuh1j hjeubeh}(h]h ]h"]h$]h&]hhuh1j hjNehhhj`ehMubeh}(h]h ]h"]h$]h&]hhjuh1jijjhjJehhhj`ehMubah}(h]jEeah ](jjeh"]h$]h&]jj)jhuh1jchj`ehMhjGehhubj)}(hhh]h)}(h-Determine the best page size for leaf entriesh]h-Determine the best page size for leaf entries}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMhjfhhubah}(h]h ]h"]h$]h&]uh1jhjGehhhj`ehMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjfjjfjjjuh1j^hhhj BhNhNubj)}(hXK**Parameters** ``pt_vaddr_t pgsz_bitmap`` Permitted page sizes ``pt_vaddr_t va`` Starting virtual address for the leaf entry ``pt_vaddr_t last_va`` Last virtual address for the leaf entry, sets the max page size ``pt_oaddr_t oa`` Starting output address for the leaf entry **Description** Compute the largest page size for va, last_va, and oa together and return it in lg2. The largest page size depends on the format's supported page sizes at this level, and the relative alignment of the VA and OA addresses. 0 means the OA cannot be stored with the provided pgsz_bitmap.h](h)}(h**Parameters**h]j)}(hjgh]h Parameters}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1jhjfubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMhjfubjq)}(hhh](jv)}(h0``pt_vaddr_t pgsz_bitmap`` Permitted page sizes h](j|)}(h``pt_vaddr_t pgsz_bitmap``h]jN)}(hjgh]hpt_vaddr_t pgsz_bitmap}(hj!ghhhNhNubah}(h]h ]h"]h$]h&]uh1jMhjgubah}(h]h ]h"]h$]h&]uh1j{hh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMhjgubj)}(hhh]h)}(hPermitted page sizesh]hPermitted page sizes}(hj8ghhhNhNubah}(h]h ]h"]h$]h&]uh1hhj4ghMhj5gubah}(h]h ]h"]h$]h&]uh1jhjgubeh}(h]h ]h"]h$]h&]uh1juhj4ghMhjgubjv)}(h>``pt_vaddr_t va`` Starting virtual address for the leaf entry h](j|)}(h``pt_vaddr_t va``h]jN)}(hjXgh]h pt_vaddr_t va}(hjZghhhNhNubah}(h]h ]h"]h$]h&]uh1jMhjVgubah}(h]h ]h"]h$]h&]uh1j{hh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMhjRgubj)}(hhh]h)}(h+Starting virtual address for the leaf entryh]h+Starting virtual address for the leaf entry}(hjqghhhNhNubah}(h]h ]h"]h$]h&]uh1hhjmghMhjngubah}(h]h ]h"]h$]h&]uh1jhjRgubeh}(h]h ]h"]h$]h&]uh1juhjmghMhjgubjv)}(hW``pt_vaddr_t last_va`` Last virtual address for the leaf entry, sets the max page size h](j|)}(h``pt_vaddr_t last_va``h]jN)}(hjgh]hpt_vaddr_t last_va}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1jMhjgubah}(h]h ]h"]h$]h&]uh1j{hh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMhjgubj)}(hhh]h)}(h?Last virtual address for the leaf entry, sets the max page sizeh]h?Last virtual address for the leaf entry, sets the max page size}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1hhjghMhjgubah}(h]h ]h"]h$]h&]uh1jhjgubeh}(h]h ]h"]h$]h&]uh1juhjghMhjgubjv)}(h=``pt_oaddr_t oa`` Starting output address for the leaf entry h](j|)}(h``pt_oaddr_t oa``h]jN)}(hjgh]h pt_oaddr_t oa}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1jMhjgubah}(h]h ]h"]h$]h&]uh1j{hh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMhjgubj)}(hhh]h)}(h*Starting output address for the leaf entryh]h*Starting output address for the leaf entry}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1hhjghMhjgubah}(h]h ]h"]h$]h&]uh1jhjgubeh}(h]h ]h"]h$]h&]uh1juhjghMhjgubeh}(h]h ]h"]h$]h&]uh1jphjfubh)}(h**Description**h]j)}(hjhh]h Description}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjhubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMhjfubh)}(hXCompute the largest page size for va, last_va, and oa together and return it in lg2. The largest page size depends on the format's supported page sizes at this level, and the relative alignment of the VA and OA addresses. 0 means the OA cannot be stored with the provided pgsz_bitmap.h]hXCompute the largest page size for va, last_va, and oa together and return it in lg2. The largest page size depends on the format’s supported page sizes at this level, and the relative alignment of the VA and OA addresses. 0 means the OA cannot be stored with the provided pgsz_bitmap.}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMhjfubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj BhhhNhNubjN)}(hhh]h}(h]h ]h"]h$]h&]entries](jZPT_MAKE_LEVELS (C macro)c.PT_MAKE_LEVELShNtauh1jMhj BhhhNhNubj_)}(hhh](jd)}(hPT_MAKE_LEVELSh]jj)}(hPT_MAKE_LEVELSh]j)}(hPT_MAKE_LEVELSh]j)}(hjDhh]hPT_MAKE_LEVELS}(hjNhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJhubah}(h]h ](jjeh"]h$]h&]hhuh1jhjFhhhhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMvubah}(h]h ]h"]h$]h&]hhjuh1jijjhjBhhhhjahhMvubah}(h]j=hah ](jjeh"]h$]h&]jj)jhuh1jchjahhMvhj?hhhubj)}(hhh]h}(h]h ]h"]h$]h&]uh1jhj?hhhhjahhMvubeh}(h]h ](jmacroeh"]h$]h&]jjjjzhjjzhjjjuh1j^hhhj BhNhNubh)}(h``PT_MAKE_LEVELS (fn, do_fn)``h]jN)}(hjhh]hPT_MAKE_LEVELS (fn, do_fn)}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1jMhj~hubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMxhj Bhhubh)}(hBuild an unwound walker h]h)}(hBuild an unwound walkerh]hBuild an unwound walker}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMvhjhubah}(h]h ]h"]h$]h&]uh1hhjhhMvhj Bhhubj)}(hX**Parameters** ``fn`` Name of the walker function ``do_fn`` Function to call at each level **Description** This builds a function call tree that can be fully inlined. The caller must provide a function body in an __always_inline function:: static __always_inline int do_fn(struct pt_range *range, void *arg, unsigned int level, struct pt_table_p *table, pt_level_fn_t descend_fn) An inline function will be created for each table level that calls do_fn with a compile time constant for level and a pointer to the next lower function. This generates an optimally inlined walk where each of the functions sees a constant level and can codegen the exact constants/etc for that level. Note this can produce a lot of code!h](h)}(h**Parameters**h]j)}(hjhh]h Parameters}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjhubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMzhjhubjq)}(hhh](jv)}(h#``fn`` Name of the walker function h](j|)}(h``fn``h]jN)}(hjhh]hfn}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1jMhjhubah}(h]h ]h"]h$]h&]uh1j{hh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMwhjhubj)}(hhh]h)}(hName of the walker functionh]hName of the walker function}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhMwhjhubah}(h]h ]h"]h$]h&]uh1jhjhubeh}(h]h ]h"]h$]h&]uh1juhjhhMwhjhubjv)}(h)``do_fn`` Function to call at each level h](j|)}(h ``do_fn``h]jN)}(hj ih]hdo_fn}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1jMhj iubah}(h]h ]h"]h$]h&]uh1j{hh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMxhjiubj)}(hhh]h)}(hFunction to call at each levelh]hFunction to call at each level}(hj&ihhhNhNubah}(h]h ]h"]h$]h&]uh1hhj"ihMxhj#iubah}(h]h ]h"]h$]h&]uh1jhjiubeh}(h]h ]h"]h$]h&]uh1juhj"ihMxhjhubeh}(h]h ]h"]h$]h&]uh1jphjhubh)}(h**Description**h]j)}(hjHih]h Description}(hjJihhhNhNubah}(h]h ]h"]h$]h&]uh1jhjFiubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMzhjhubh)}(hThis builds a function call tree that can be fully inlined. The caller must provide a function body in an __always_inline function::h]hThis builds a function call tree that can be fully inlined. The caller must provide a function body in an __always_inline function:}(hj^ihhhNhNubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMyhjhubj)}(hstatic __always_inline int do_fn(struct pt_range *range, void *arg, unsigned int level, struct pt_table_p *table, pt_level_fn_t descend_fn)h]hstatic __always_inline int do_fn(struct pt_range *range, void *arg, unsigned int level, struct pt_table_p *table, pt_level_fn_t descend_fn)}hjmisbah}(h]h ]h"]h$]h&]hhuh1jhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhM|hjhubh)}(hX,An inline function will be created for each table level that calls do_fn with a compile time constant for level and a pointer to the next lower function. This generates an optimally inlined walk where each of the functions sees a constant level and can codegen the exact constants/etc for that level.h]hX,An inline function will be created for each table level that calls do_fn with a compile time constant for level and a pointer to the next lower function. This generates an optimally inlined walk where each of the functions sees a constant level and can codegen the exact constants/etc for that level.}(hj|ihhhNhNubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMhjhubh)}(h$Note this can produce a lot of code!h]h$Note this can produce a lot of code!}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1hhh/var/lib/git/docbuild/linux/Documentation/driver-api/generic_pt:73: ./drivers/iommu/generic_pt/pt_iter.hhMhjhubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj BhhhNhNubeh}(h]iteration-helpersah ]h"]iteration helpersah$]h&]uh1hhjhhhhhKGubh)}(hhh](h)}(hWriting a Formath]hWriting a Format}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1hhjihhhhhKLubh)}(hIt is best to start from a simple format that is similar to the target. x86_64 is usually a good reference for something simple, and AMDv1 is something fairly complete.h]hIt is best to start from a simple format that is similar to the target. x86_64 is usually a good reference for something simple, and AMDv1 is something fairly complete.}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKNhjihhubh)}(h|The required inline functions need to be implemented in the format header. These should all follow the standard pattern of::h]h{The required inline functions need to be implemented in the format header. These should all follow the standard pattern of:}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKRhjihhubj)}(hzstatic inline pt_oaddr_t amdv1pt_entry_oa(const struct pt_state *pts) { [..] } #define pt_entry_oa amdv1pt_entry_oah]hzstatic inline pt_oaddr_t amdv1pt_entry_oa(const struct pt_state *pts) { [..] } #define pt_entry_oa amdv1pt_entry_oa}hjisbah}(h]h ]h"]h$]h&]hhuh1jhhhKUhjihhubh)}(hXAwhere a uniquely named per-format inline function provides the implementation and a define maps it to the generic name. This is intended to make debug symbols work better. inline functions should always be used as the prototypes in pt_common.h will cause the compiler to validate the function signature to prevent errors.h]hXAwhere a uniquely named per-format inline function provides the implementation and a define maps it to the generic name. This is intended to make debug symbols work better. inline functions should always be used as the prototypes in pt_common.h will cause the compiler to validate the function signature to prevent errors.}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK[hjihhubh)}(hDReview pt_fmt_defaults.h to understand some of the optional inlines.h]hDReview pt_fmt_defaults.h to understand some of the optional inlines.}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKahjihhubh)}(hOnce the format compiles then it should be run through the generic page table kunit test in kunit_generic_pt.h using kunit. For example::h]hOnce the format compiles then it should be run through the generic page table kunit test in kunit_generic_pt.h using kunit. For example:}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKchjihhubj)}(hX+$ tools/testing/kunit/kunit.py run --build_dir build_kunit_x86_64 --arch x86_64 --kunitconfig ./drivers/iommu/generic_pt/.kunitconfig amdv1_fmt_test.* [...] [11:15:08] Testing complete. Ran 9 tests: passed: 9 [11:15:09] Elapsed time: 3.137s total, 0.001s configuring, 2.368s building, 0.311s runningh]hX+$ tools/testing/kunit/kunit.py run --build_dir build_kunit_x86_64 --arch x86_64 --kunitconfig ./drivers/iommu/generic_pt/.kunitconfig amdv1_fmt_test.* [...] [11:15:08] Testing complete. Ran 9 tests: passed: 9 [11:15:09] Elapsed time: 3.137s total, 0.001s configuring, 2.368s building, 0.311s running}hjjsbah}(h]h ]h"]h$]h&]hhuh1jhhhKfhjihhubh)}(hThe generic tests are intended to prove out the format functions and give clearer failures to speed up finding the problems. Once those pass then the entire kunit suite should be run.h]hThe generic tests are intended to prove out the format functions and give clearer failures to speed up finding the problems. Once those pass then the entire kunit suite should be run.}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKkhjihhubeh}(h]writing-a-formatah ]h"]writing a formatah$]h&]uh1hhjhhhhhKLubh)}(hhh](h)}(hIOMMU Invalidation Featuresh]hIOMMU Invalidation Features}(hj5jhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj2jhhhhhKpubh)}(hInvalidation is how the page table algorithms synchronize with a HW cache of the page table memory, typically called the TLB (or IOTLB for IOMMU cases).h]hInvalidation is how the page table algorithms synchronize with a HW cache of the page table memory, typically called the TLB (or IOTLB for IOMMU cases).}(hjCjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKrhj2jhhubh)}(hThe TLB can store present PTEs, non-present PTEs and table pointers, depending on its design. Every HW has its own approach on how to describe what has changed to have changed items removed from the TLB.h]hThe TLB can store present PTEs, non-present PTEs and table pointers, depending on its design. Every HW has its own approach on how to describe what has changed to have changed items removed from the TLB.}(hjQjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKuhj2jhhubh)}(hhh](h)}(hPT_FEAT_FLUSH_RANGEh]hPT_FEAT_FLUSH_RANGE}(hjbjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj_jhhhhhKzubh)}(hXPT_FEAT_FLUSH_RANGE is the easiest scheme to understand. It tries to generate a single range invalidation for each operation, over-invalidating if there are gaps of VA that don't need invalidation. This trades off impacted VA for number of invalidation operations. It does not keep track of what is being invalidated; however, if pages have to be freed then page table pointers have to be cleaned from the walk cache. The range can start/end at any page boundary.h]hXPT_FEAT_FLUSH_RANGE is the easiest scheme to understand. It tries to generate a single range invalidation for each operation, over-invalidating if there are gaps of VA that don’t need invalidation. This trades off impacted VA for number of invalidation operations. It does not keep track of what is being invalidated; however, if pages have to be freed then page table pointers have to be cleaned from the walk cache. The range can start/end at any page boundary.}(hjpjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK|hj_jhhubeh}(h]pt-feat-flush-rangeah ]h"]pt_feat_flush_rangeah$]h&]uh1hhj2jhhhhhKzubh)}(hhh](h)}(hPT_FEAT_FLUSH_RANGE_NO_GAPSh]hPT_FEAT_FLUSH_RANGE_NO_GAPS}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjjhhhhhKubh)}(hX.PT_FEAT_FLUSH_RANGE_NO_GAPS is similar to PT_FEAT_FLUSH_RANGE; however, it tries to minimize the amount of impacted VA by issuing extra flush operations. This is useful if the cost of processing VA is very high, for instance because a hypervisor is processing the page table with a shadowing algorithm.h]hX.PT_FEAT_FLUSH_RANGE_NO_GAPS is similar to PT_FEAT_FLUSH_RANGE; however, it tries to minimize the amount of impacted VA by issuing extra flush operations. This is useful if the cost of processing VA is very high, for instance because a hypervisor is processing the page table with a shadowing algorithm.}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjjhhubeh}(h]pt-feat-flush-range-no-gapsah ]h"]pt_feat_flush_range_no_gapsah$]h&]uh1hhj2jhhhhhKubeh}(h]iommu-invalidation-featuresah ]h"]iommu invalidation featuresah$]h&]uh1hhjhhhhhKpubeh}(h]usageah ]h"]usageah$]h&]uh1hhhhhhhhKubeh}(h]generic-radix-page-tableah ]h"]generic radix page tableah$]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_handlerjjerror_encodingutf-8error_encoding_error_handlerbackslashreplace language_codeenrecord_dependenciesNconfigN id_prefixhauto_id_prefixid dump_settingsNdump_internalsNdump_transformsNdump_pseudo_xmlNexpose_internalsNstrict_visitorN_disable_configN_sourcehnj _destinationN _config_files]7/var/lib/git/docbuild/linux/Documentation/docutils.confafile_insertion_enabled raw_enabledKline_length_limitM'pep_referencesN pep_base_urlhttps://peps.python.org/pep_file_url_templatepep-%04drfc_referencesN rfc_base_url&https://datatracker.ietf.org/doc/html/ tab_widthKtrim_footnote_reference_spacesyntax_highlightlong smart_quotessmartquotes_locales]character_level_inline_markupdoctitle_xform docinfo_xformKsectsubtitle_xform image_loadinglinkembed_stylesheetcloak_email_addressessection_self_linkenvNubreporterNindirect_targets]substitution_defs}substitution_names}refnames}refids}nameids}(jjjjjjjjjBjBjijij/jj,jjjjjjjjjjjjju nametypes}(jjjjjBjij/jjjjjjjuh}(jjhjjjjBj<j\jejXj]j j j j jjjNjSjYj^jjjijnjj j^jcjjjjjjjJjOj j j"j"j&j&j(j)j*j*jj,jo,j".j'.j/j/j2j$2j3j3j5j5jk7jp7j9j9j:j:j<j<j>j>j@j@jij Bj=BjBBjCjCj?EjDEjeGjjGjIj"IjJjJjVLj[Lj`MjeMjOjOjPjPjmRjrRjTj!TjVjVjYjYj^[jc[j]j]jX`j]`j6cj;cjEejJej=hjBhj,jjijjj2jjjj_jjjjju footnote_refs} citation_refs} autofootnotes]autofootnote_refs]symbol_footnotes]symbol_footnote_refs] footnotes] citations]autofootnote_startKsymbol_footnote_startK id_counter collectionsCounter}Rparse_messages]transform_messages] transformerN include_log] decorationNhhub.