iPXE
features.h
Go to the documentation of this file.
1 /* SPDX-License-Identifier: MIT */
2 /******************************************************************************
3  * features.h
4  *
5  * Feature flags, reported by XENVER_get_features.
6  *
7  * Copyright (c) 2006, Keir Fraser <keir@xensource.com>
8  */
9 
10 #ifndef __XEN_PUBLIC_FEATURES_H__
11 #define __XEN_PUBLIC_FEATURES_H__
12 
13 FILE_LICENCE ( MIT );
14 
15 /*
16  * `incontents 200 elfnotes_features XEN_ELFNOTE_FEATURES
17  *
18  * The list of all the features the guest supports. They are set by
19  * parsing the XEN_ELFNOTE_FEATURES and XEN_ELFNOTE_SUPPORTED_FEATURES
20  * string. The format is the feature names (as given here without the
21  * "XENFEAT_" prefix) separated by '|' characters.
22  * If a feature is required for the kernel to function then the feature name
23  * must be preceded by a '!' character.
24  *
25  * Note that if XEN_ELFNOTE_SUPPORTED_FEATURES is used, then in the
26  * XENFEAT_dom0 MUST be set if the guest is to be booted as dom0,
27  */
28 
29 /*
30  * If set, the guest does not need to write-protect its pagetables, and can
31  * update them via direct writes.
32  */
33 #define XENFEAT_writable_page_tables 0
34 
35 /*
36  * If set, the guest does not need to write-protect its segment descriptor
37  * tables, and can update them via direct writes.
38  */
39 #define XENFEAT_writable_descriptor_tables 1
40 
41 /*
42  * If set, translation between the guest's 'pseudo-physical' address space
43  * and the host's machine address space are handled by the hypervisor. In this
44  * mode the guest does not need to perform phys-to/from-machine translations
45  * when performing page table operations.
46  */
47 #define XENFEAT_auto_translated_physmap 2
48 
49 /* If set, the guest is running in supervisor mode (e.g., x86 ring 0). */
50 #define XENFEAT_supervisor_mode_kernel 3
51 
52 /*
53  * If set, the guest does not need to allocate x86 PAE page directories
54  * below 4GB. This flag is usually implied by auto_translated_physmap.
55  */
56 #define XENFEAT_pae_pgdir_above_4gb 4
57 
58 /* x86: Does this Xen host support the MMU_PT_UPDATE_PRESERVE_AD hypercall? */
59 #define XENFEAT_mmu_pt_update_preserve_ad 5
60 
61 /* x86: Does this Xen host support the MMU_{CLEAR,COPY}_PAGE hypercall? */
62 #define XENFEAT_highmem_assist 6
63 
64 /*
65  * If set, GNTTABOP_map_grant_ref honors flags to be placed into guest kernel
66  * available pte bits.
67  */
68 #define XENFEAT_gnttab_map_avail_bits 7
69 
70 /* x86: Does this Xen host support the HVM callback vector type? */
71 #define XENFEAT_hvm_callback_vector 8
72 
73 /* x86: pvclock algorithm is safe to use on HVM */
74 #define XENFEAT_hvm_safe_pvclock 9
75 
76 /* x86: pirq can be used by HVM guests */
77 #define XENFEAT_hvm_pirqs 10
78 
79 /* operation as Dom0 is supported */
80 #define XENFEAT_dom0 11
81 
82 /* Xen also maps grant references at pfn = mfn.
83  * This feature flag is deprecated and should not be used.
84 #define XENFEAT_grant_map_identity 12
85  */
86 
87 /* Guest can use XENMEMF_vnode to specify virtual node for memory op. */
88 #define XENFEAT_memory_op_vnode_supported 13
89 
90 /* arm: Hypervisor supports ARM SMC calling convention. */
91 #define XENFEAT_ARM_SMCCC_supported 14
92 
93 /*
94  * x86/PVH: If set, ACPI RSDP can be placed at any address. Otherwise RSDP
95  * must be located in lower 1MB, as required by ACPI Specification for IA-PC
96  * systems.
97  * This feature flag is only consulted if XEN_ELFNOTE_GUEST_OS contains
98  * the "linux" string.
99  */
100 #define XENFEAT_linux_rsdp_unrestricted 15
101 
102 /*
103  * A direct-mapped (or 1:1 mapped) domain is a domain for which its
104  * local pages have gfn == mfn. If a domain is direct-mapped,
105  * XENFEAT_direct_mapped is set; otherwise XENFEAT_not_direct_mapped
106  * is set.
107  *
108  * If neither flag is set (e.g. older Xen releases) the assumptions are:
109  * - not auto_translated domains (x86 only) are always direct-mapped
110  * - on x86, auto_translated domains are not direct-mapped
111  * - on ARM, Dom0 is direct-mapped, DomUs are not
112  */
113 #define XENFEAT_not_direct_mapped 16
114 #define XENFEAT_direct_mapped 17
115 
116 #define XENFEAT_NR_SUBMAPS 1
117 
118 #endif /* __XEN_PUBLIC_FEATURES_H__ */
119 
120 /*
121  * Local variables:
122  * mode: C
123  * c-file-style: "BSD"
124  * c-basic-offset: 4
125  * tab-width: 4
126  * indent-tabs-mode: nil
127  * End:
128  */
FILE_LICENCE(GPL2_OR_LATER_OR_UBDL)