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