<html><head><title>include/public/domctl.h - arch-x86_64 - Xen public headers</title></head><body><pre> /****************************************************************************** * domctl.h * * Domain management operations. For use by node control stack. * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to * deal in the Software without restriction, including without limitation the * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or * sell copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER * DEALINGS IN THE SOFTWARE. * * Copyright (c) 2002-2003, B Dragovic * Copyright (c) 2002-2006, K Fraser */ #ifndef __XEN_PUBLIC_DOMCTL_H__ #define __XEN_PUBLIC_DOMCTL_H__ #if !defined(__XEN__) && !defined(__XEN_TOOLS__) #error "domctl operations are intended for use by node control tools only" #endif #include "xen.h" #include "grant_table.h" #include "hvm/save.h" #include "memory.h" #define XEN_DOMCTL_INTERFACE_VERSION 0x0000000a /* * NB. xen_domctl.domain is an IN/OUT parameter for this operation. * If it is specified as zero, an id is auto-allocated and returned. */ /* XEN_DOMCTL_createdomain */ <a name="Struct_xen_domctl_createdomain"><strong>struct xen_domctl_createdomain</strong></a> { /* IN parameters */ uint32_t ssidref; xen_domain_handle_t handle; /* Is this an HVM guest (as opposed to a PVH or PV guest)? */ #define _XEN_DOMCTL_CDF_hvm_guest 0 #define XEN_DOMCTL_CDF_hvm_guest (1U<<_XEN_DOMCTL_CDF_hvm_guest) /* Use hardware-assisted paging if available? */ #define _XEN_DOMCTL_CDF_hap 1 #define XEN_DOMCTL_CDF_hap (1U<<_XEN_DOMCTL_CDF_hap) /* Should domain memory integrity be verifed by tboot during Sx? */ #define _XEN_DOMCTL_CDF_s3_integrity 2 #define XEN_DOMCTL_CDF_s3_integrity (1U<<_XEN_DOMCTL_CDF_s3_integrity) /* Disable out-of-sync shadow page tables? */ #define _XEN_DOMCTL_CDF_oos_off 3 #define XEN_DOMCTL_CDF_oos_off (1U<<_XEN_DOMCTL_CDF_oos_off) /* Is this a PVH guest (as opposed to an HVM or PV guest)? */ #define _XEN_DOMCTL_CDF_pvh_guest 4 #define XEN_DOMCTL_CDF_pvh_guest (1U<<_XEN_DOMCTL_CDF_pvh_guest) uint32_t flags; }; typedef <a href="include,public,domctl.h.html#Struct_xen_domctl_createdomain">struct xen_domctl_createdomain</a> <a name="Typedef_xen_domctl_createdomain_t"><strong>xen_domctl_createdomain_t</strong></a>; DEFINE_XEN_GUEST_HANDLE(<a href="include,public,domctl.h.html#Struct_xen_domctl_createdomain">xen_domctl_createdomain_t</a>); #if defined(__arm__) || defined(__aarch64__) #define XEN_DOMCTL_CONFIG_GIC_DEFAULT 0 #define XEN_DOMCTL_CONFIG_GIC_V2 1 #define XEN_DOMCTL_CONFIG_GIC_V3 2 /* XEN_DOMCTL_configure_domain */ <a name="Struct_xen_domctl_arm_configuredomain"><strong>struct xen_domctl_arm_configuredomain</strong></a> { /* IN/OUT parameters */ uint8_t gic_version; }; typedef <a href="include,public,domctl.h.html#Struct_xen_domctl_arm_configuredomain">struct xen_domctl_arm_configuredomain</a> <a name="Typedef_xen_domctl_arm_configuredomain_t"><strong>xen_domctl_arm_configuredomain_t</strong></a>; DEFINE_XEN_GUEST_HANDLE(<a href="include,public,domctl.h.html#Struct_xen_domctl_arm_configuredomain">xen_domctl_arm_configuredomain_t</a>); #endif /* XEN_DOMCTL_getdomaininfo */ <a name="Struct_xen_domctl_getdomaininfo"><strong>struct xen_domctl_getdomaininfo</strong></a> { /* OUT variables. */ <a href="include,public,xen.h.html#Typedef_domid_t">domid_t</a> domain; /* Also echoed in domctl.domain */ /* Domain is scheduled to die. */ #define _XEN_DOMINF_dying 0 #define XEN_DOMINF_dying (1U<<_XEN_DOMINF_dying) /* Domain is an HVM guest (as opposed to a PV guest). */ #define _XEN_DOMINF_hvm_guest 1 #define XEN_DOMINF_hvm_guest (1U<<_XEN_DOMINF_hvm_guest) /* The guest OS has shut down. */ #define _XEN_DOMINF_shutdown 2 #define XEN_DOMINF_shutdown (1U<<_XEN_DOMINF_shutdown) /* Currently paused by control software. */ #define _XEN_DOMINF_paused 3 #define XEN_DOMINF_paused (1U<<_XEN_DOMINF_paused) /* Currently blocked pending an event. */ #define _XEN_DOMINF_blocked 4 #define XEN_DOMINF_blocked (1U<<_XEN_DOMINF_blocked) /* Domain is currently running. */ #define _XEN_DOMINF_running 5 #define XEN_DOMINF_running (1U<<_XEN_DOMINF_running) /* Being debugged. */ #define _XEN_DOMINF_debugged 6 #define XEN_DOMINF_debugged (1U<<_XEN_DOMINF_debugged) /* domain is PVH */ #define _XEN_DOMINF_pvh_guest 7 #define XEN_DOMINF_pvh_guest (1U<<_XEN_DOMINF_pvh_guest) /* XEN_DOMINF_shutdown guest-supplied code. */ #define XEN_DOMINF_shutdownmask 255 #define XEN_DOMINF_shutdownshift 16 uint32_t flags; /* XEN_DOMINF_* */ uint64_aligned_t tot_pages; uint64_aligned_t max_pages; uint64_aligned_t outstanding_pages; uint64_aligned_t shr_pages; uint64_aligned_t paged_pages; uint64_aligned_t shared_info_frame; /* GMFN of shared_info struct */ uint64_aligned_t cpu_time; uint32_t nr_online_vcpus; /* Number of VCPUs currently online. */ #define XEN_INVALID_MAX_VCPU_ID (~0U) /* Domain has no vcpus? */ uint32_t max_vcpu_id; /* Maximum VCPUID in use by this domain. */ uint32_t ssidref; xen_domain_handle_t handle; uint32_t cpupool; }; typedef <a href="include,public,domctl.h.html#Struct_xen_domctl_getdomaininfo">struct xen_domctl_getdomaininfo</a> <a name="Typedef_xen_domctl_getdomaininfo_t"><strong>xen_domctl_getdomaininfo_t</strong></a>; DEFINE_XEN_GUEST_HANDLE(<a href="include,public,domctl.h.html#Struct_xen_domctl_getdomaininfo">xen_domctl_getdomaininfo_t</a>); /* XEN_DOMCTL_getmemlist */ <a name="Struct_xen_domctl_getmemlist"><strong>struct xen_domctl_getmemlist</strong></a> { /* IN variables. */ /* Max entries to write to output buffer. */ uint64_aligned_t max_pfns; /* Start index in guest's page list. */ uint64_aligned_t start_pfn; XEN_GUEST_HANDLE_64(uint64) buffer; /* OUT variables. */ uint64_aligned_t num_pfns; }; typedef <a href="include,public,domctl.h.html#Struct_xen_domctl_getmemlist">struct xen_domctl_getmemlist</a> <a name="Typedef_xen_domctl_getmemlist_t"><strong>xen_domctl_getmemlist_t</strong></a>; DEFINE_XEN_GUEST_HANDLE(<a href="include,public,domctl.h.html#Struct_xen_domctl_getmemlist">xen_domctl_getmemlist_t</a>); /* XEN_DOMCTL_getpageframeinfo */ #define XEN_DOMCTL_PFINFO_LTAB_SHIFT 28 #define XEN_DOMCTL_PFINFO_NOTAB (0x0U<<28) #define XEN_DOMCTL_PFINFO_L1TAB (0x1U<<28) #define XEN_DOMCTL_PFINFO_L2TAB (0x2U<<28) #define XEN_DOMCTL_PFINFO_L3TAB (0x3U<<28) #define XEN_DOMCTL_PFINFO_L4TAB (0x4U<<28) #define XEN_DOMCTL_PFINFO_LTABTYPE_MASK (0x7U<<28) #define XEN_DOMCTL_PFINFO_LPINTAB (0x1U<<31) #define XEN_DOMCTL_PFINFO_XTAB (0xfU<<28) /* invalid page */ #define XEN_DOMCTL_PFINFO_XALLOC (0xeU<<28) /* allocate-only page */ #define XEN_DOMCTL_PFINFO_BROKEN (0xdU<<28) /* broken page */ #define XEN_DOMCTL_PFINFO_LTAB_MASK (0xfU<<28) <a name="Struct_xen_domctl_getpageframeinfo"><strong>struct xen_domctl_getpageframeinfo</strong></a> { /* IN variables. */ uint64_aligned_t gmfn; /* GMFN to query */ /* OUT variables. */ /* Is the page PINNED to a type? */ uint32_t type; /* see above type defs */ }; typedef <a href="include,public,domctl.h.html#Struct_xen_domctl_getpageframeinfo">struct xen_domctl_getpageframeinfo</a> <a name="Typedef_xen_domctl_getpageframeinfo_t"><strong>xen_domctl_getpageframeinfo_t</strong></a>; DEFINE_XEN_GUEST_HANDLE(<a href="include,public,domctl.h.html#Struct_xen_domctl_getpageframeinfo">xen_domctl_getpageframeinfo_t</a>); /* XEN_DOMCTL_getpageframeinfo2 */ <a name="Struct_xen_domctl_getpageframeinfo2"><strong>struct xen_domctl_getpageframeinfo2</strong></a> { /* IN variables. */ uint64_aligned_t num; /* IN/OUT variables. */ XEN_GUEST_HANDLE_64(uint32) array; }; typedef <a href="include,public,domctl.h.html#Struct_xen_domctl_getpageframeinfo2">struct xen_domctl_getpageframeinfo2</a> <a name="Typedef_xen_domctl_getpageframeinfo2_t"><strong>xen_domctl_getpageframeinfo2_t</strong></a>; DEFINE_XEN_GUEST_HANDLE(<a href="include,public,domctl.h.html#Struct_xen_domctl_getpageframeinfo2">xen_domctl_getpageframeinfo2_t</a>); /* XEN_DOMCTL_getpageframeinfo3 */ <a name="Struct_xen_domctl_getpageframeinfo3"><strong>struct xen_domctl_getpageframeinfo3</strong></a> { /* IN variables. */ uint64_aligned_t num; /* IN/OUT variables. */ XEN_GUEST_HANDLE_64(xen_pfn_t) array; }; /* * Control shadow pagetables operation */ /* XEN_DOMCTL_shadow_op */ /* Disable shadow mode. */ #define XEN_DOMCTL_SHADOW_OP_OFF 0 /* Enable shadow mode (mode contains ORed XEN_DOMCTL_SHADOW_ENABLE_* flags). */ #define XEN_DOMCTL_SHADOW_OP_ENABLE 32 /* Log-dirty bitmap operations. */ /* Return the bitmap and clean internal copy for next round. */ #define XEN_DOMCTL_SHADOW_OP_CLEAN 11 /* Return the bitmap but do not modify internal copy. */ #define XEN_DOMCTL_SHADOW_OP_PEEK 12 /* Memory allocation accessors. */ #define XEN_DOMCTL_SHADOW_OP_GET_ALLOCATION 30 #define XEN_DOMCTL_SHADOW_OP_SET_ALLOCATION 31 /* Legacy enable operations. */ /* Equiv. to ENABLE with no mode flags. */ #define XEN_DOMCTL_SHADOW_OP_ENABLE_TEST 1 /* Equiv. to ENABLE with mode flag ENABLE_LOG_DIRTY. */ #define XEN_DOMCTL_SHADOW_OP_ENABLE_LOGDIRTY 2 /* Equiv. to ENABLE with mode flags ENABLE_REFCOUNT and ENABLE_TRANSLATE. */ #define XEN_DOMCTL_SHADOW_OP_ENABLE_TRANSLATE 3 /* Mode flags for XEN_DOMCTL_SHADOW_OP_ENABLE. */ /* * Shadow pagetables are refcounted: guest does not use explicit mmu * operations nor write-protect its pagetables. */ #define XEN_DOMCTL_SHADOW_ENABLE_REFCOUNT (1 << 1) /* * Log pages in a bitmap as they are dirtied. * Used for live relocation to determine which pages must be re-sent. */ #define XEN_DOMCTL_SHADOW_ENABLE_LOG_DIRTY (1 << 2) /* * Automatically translate GPFNs into MFNs. */ #define XEN_DOMCTL_SHADOW_ENABLE_TRANSLATE (1 << 3) /* * Xen does not steal virtual address space from the guest. * Requires HVM support. */ #define XEN_DOMCTL_SHADOW_ENABLE_EXTERNAL (1 << 4) <a name="Struct_xen_domctl_shadow_op_stats"><strong>struct xen_domctl_shadow_op_stats</strong></a> { uint32_t fault_count; uint32_t dirty_count; }; typedef <a href="include,public,domctl.h.html#Struct_xen_domctl_shadow_op_stats">struct xen_domctl_shadow_op_stats</a> <a name="Typedef_xen_domctl_shadow_op_stats_t"><strong>xen_domctl_shadow_op_stats_t</strong></a>; DEFINE_XEN_GUEST_HANDLE(<a href="include,public,domctl.h.html#Struct_xen_domctl_shadow_op_stats">xen_domctl_shadow_op_stats_t</a>); <a name="Struct_xen_domctl_shadow_op"><strong>struct xen_domctl_shadow_op</strong></a> { /* IN variables. */ uint32_t op; /* XEN_DOMCTL_SHADOW_OP_* */ /* OP_ENABLE */ uint32_t mode; /* XEN_DOMCTL_SHADOW_ENABLE_* */ /* OP_GET_ALLOCATION / OP_SET_ALLOCATION */ uint32_t mb; /* Shadow memory allocation in MB */ /* OP_PEEK / OP_CLEAN */ XEN_GUEST_HANDLE_64(uint8) dirty_bitmap; uint64_aligned_t pages; /* Size of buffer. Updated with actual size. */ <a href="include,public,domctl.h.html#Struct_xen_domctl_shadow_op_stats">struct xen_domctl_shadow_op_stats</a> stats; }; typedef <a href="include,public,domctl.h.html#Struct_xen_domctl_shadow_op">struct xen_domctl_shadow_op</a> <a name="Typedef_xen_domctl_shadow_op_t"><strong>xen_domctl_shadow_op_t</strong></a>; DEFINE_XEN_GUEST_HANDLE(<a href="include,public,domctl.h.html#Struct_xen_domctl_shadow_op">xen_domctl_shadow_op_t</a>); /* XEN_DOMCTL_max_mem */ <a name="Struct_xen_domctl_max_mem"><strong>struct xen_domctl_max_mem</strong></a> { /* IN variables. */ uint64_aligned_t max_memkb; }; typedef <a href="include,public,domctl.h.html#Struct_xen_domctl_max_mem">struct xen_domctl_max_mem</a> <a name="Typedef_xen_domctl_max_mem_t"><strong>xen_domctl_max_mem_t</strong></a>; DEFINE_XEN_GUEST_HANDLE(<a href="include,public,domctl.h.html#Struct_xen_domctl_max_mem">xen_domctl_max_mem_t</a>); /* XEN_DOMCTL_setvcpucontext */ /* XEN_DOMCTL_getvcpucontext */ <a name="Struct_xen_domctl_vcpucontext"><strong>struct xen_domctl_vcpucontext</strong></a> { uint32_t vcpu; /* IN */ XEN_GUEST_HANDLE_64(<a href="include,public,arch-x86,xen.h.html#Struct_vcpu_guest_context">vcpu_guest_context_t</a>) ctxt; /* IN/OUT */ }; typedef <a href="include,public,domctl.h.html#Struct_xen_domctl_vcpucontext">struct xen_domctl_vcpucontext</a> <a name="Typedef_xen_domctl_vcpucontext_t"><strong>xen_domctl_vcpucontext_t</strong></a>; DEFINE_XEN_GUEST_HANDLE(<a href="include,public,domctl.h.html#Struct_xen_domctl_vcpucontext">xen_domctl_vcpucontext_t</a>); /* XEN_DOMCTL_getvcpuinfo */ <a name="Struct_xen_domctl_getvcpuinfo"><strong>struct xen_domctl_getvcpuinfo</strong></a> { /* IN variables. */ uint32_t vcpu; /* OUT variables. */ uint8_t online; /* currently online (not hotplugged)? */ uint8_t blocked; /* blocked waiting for an event? */ uint8_t running; /* currently scheduled on its CPU? */ uint64_aligned_t cpu_time; /* total cpu time consumed (ns) */ uint32_t cpu; /* current mapping */ }; typedef <a href="include,public,domctl.h.html#Struct_xen_domctl_getvcpuinfo">struct xen_domctl_getvcpuinfo</a> <a name="Typedef_xen_domctl_getvcpuinfo_t"><strong>xen_domctl_getvcpuinfo_t</strong></a>; DEFINE_XEN_GUEST_HANDLE(<a href="include,public,domctl.h.html#Struct_xen_domctl_getvcpuinfo">xen_domctl_getvcpuinfo_t</a>); /* Get/set the NUMA node(s) with which the guest has affinity with. */ /* XEN_DOMCTL_setnodeaffinity */ /* XEN_DOMCTL_getnodeaffinity */ <a name="Struct_xen_domctl_nodeaffinity"><strong>struct xen_domctl_nodeaffinity</strong></a> { <a href="include,public,xen.h.html#Struct_xenctl_bitmap">struct xenctl_bitmap</a> nodemap;/* IN */ }; typedef <a href="include,public,domctl.h.html#Struct_xen_domctl_nodeaffinity">struct xen_domctl_nodeaffinity</a> <a name="Typedef_xen_domctl_nodeaffinity_t"><strong>xen_domctl_nodeaffinity_t</strong></a>; DEFINE_XEN_GUEST_HANDLE(<a href="include,public,domctl.h.html#Struct_xen_domctl_nodeaffinity">xen_domctl_nodeaffinity_t</a>); /* Get/set which physical cpus a vcpu can execute on. */ /* XEN_DOMCTL_setvcpuaffinity */ /* XEN_DOMCTL_getvcpuaffinity */ <a name="Struct_xen_domctl_vcpuaffinity"><strong>struct xen_domctl_vcpuaffinity</strong></a> { /* IN variables. */ uint32_t vcpu; /* Set/get the hard affinity for vcpu */ #define _XEN_VCPUAFFINITY_HARD 0 #define XEN_VCPUAFFINITY_HARD (1U<<_XEN_VCPUAFFINITY_HARD) /* Set/get the soft affinity for vcpu */ #define _XEN_VCPUAFFINITY_SOFT 1 #define XEN_VCPUAFFINITY_SOFT (1U<<_XEN_VCPUAFFINITY_SOFT) uint32_t flags; /* * IN/OUT variables. * * Both are IN/OUT for XEN_DOMCTL_setvcpuaffinity, in which case they * contain effective hard or/and soft affinity. That is, upon successful * return, cpumap_soft, contains the intersection of the soft affinity, * hard affinity and the cpupool's online CPUs for the domain (if * XEN_VCPUAFFINITY_SOFT was set in flags). cpumap_hard contains the * intersection between hard affinity and the cpupool's online CPUs (if * XEN_VCPUAFFINITY_HARD was set in flags). * * Both are OUT-only for XEN_DOMCTL_getvcpuaffinity, in which case they * contain the plain hard and/or soft affinity masks that were set during * previous successful calls to XEN_DOMCTL_setvcpuaffinity (or the * default values), without intersecting or altering them in any way. */ <a href="include,public,xen.h.html#Struct_xenctl_bitmap">struct xenctl_bitmap</a> cpumap_hard; <a href="include,public,xen.h.html#Struct_xenctl_bitmap">struct xenctl_bitmap</a> cpumap_soft; }; typedef <a href="include,public,domctl.h.html#Struct_xen_domctl_vcpuaffinity">struct xen_domctl_vcpuaffinity</a> <a name="Typedef_xen_domctl_vcpuaffinity_t"><strong>xen_domctl_vcpuaffinity_t</strong></a>; DEFINE_XEN_GUEST_HANDLE(<a href="include,public,domctl.h.html#Struct_xen_domctl_vcpuaffinity">xen_domctl_vcpuaffinity_t</a>); /* XEN_DOMCTL_max_vcpus */ <a name="Struct_xen_domctl_max_vcpus"><strong>struct xen_domctl_max_vcpus</strong></a> { uint32_t max; /* maximum number of vcpus */ }; typedef <a href="include,public,domctl.h.html#Struct_xen_domctl_max_vcpus">struct xen_domctl_max_vcpus</a> <a name="Typedef_xen_domctl_max_vcpus_t"><strong>xen_domctl_max_vcpus_t</strong></a>; DEFINE_XEN_GUEST_HANDLE(<a href="include,public,domctl.h.html#Struct_xen_domctl_max_vcpus">xen_domctl_max_vcpus_t</a>); /* XEN_DOMCTL_scheduler_op */ /* Scheduler types. */ #define XEN_SCHEDULER_SEDF 4 #define XEN_SCHEDULER_CREDIT 5 #define XEN_SCHEDULER_CREDIT2 6 #define XEN_SCHEDULER_ARINC653 7 #define XEN_SCHEDULER_RTDS 8 /* Set or get info? */ #define XEN_DOMCTL_SCHEDOP_putinfo 0 #define XEN_DOMCTL_SCHEDOP_getinfo 1 <a name="Struct_xen_domctl_scheduler_op"><strong>struct xen_domctl_scheduler_op</strong></a> { uint32_t sched_id; /* XEN_SCHEDULER_* */ uint32_t cmd; /* XEN_DOMCTL_SCHEDOP_* */ union { struct xen_domctl_sched_sedf { uint64_aligned_t period; uint64_aligned_t slice; uint64_aligned_t latency; uint32_t extratime; uint32_t weight; } sedf; struct xen_domctl_sched_credit { uint16_t weight; uint16_t cap; } credit; struct xen_domctl_sched_credit2 { uint16_t weight; } credit2; struct xen_domctl_sched_rtds { uint32_t period; uint32_t budget; } rtds; } u; }; typedef <a href="include,public,domctl.h.html#Struct_xen_domctl_scheduler_op">struct xen_domctl_scheduler_op</a> <a name="Typedef_xen_domctl_scheduler_op_t"><strong>xen_domctl_scheduler_op_t</strong></a>; DEFINE_XEN_GUEST_HANDLE(<a href="include,public,domctl.h.html#Struct_xen_domctl_scheduler_op">xen_domctl_scheduler_op_t</a>); /* XEN_DOMCTL_setdomainhandle */ <a name="Struct_xen_domctl_setdomainhandle"><strong>struct xen_domctl_setdomainhandle</strong></a> { xen_domain_handle_t handle; }; typedef <a href="include,public,domctl.h.html#Struct_xen_domctl_setdomainhandle">struct xen_domctl_setdomainhandle</a> <a name="Typedef_xen_domctl_setdomainhandle_t"><strong>xen_domctl_setdomainhandle_t</strong></a>; DEFINE_XEN_GUEST_HANDLE(<a href="include,public,domctl.h.html#Struct_xen_domctl_setdomainhandle">xen_domctl_setdomainhandle_t</a>); /* XEN_DOMCTL_setdebugging */ <a name="Struct_xen_domctl_setdebugging"><strong>struct xen_domctl_setdebugging</strong></a> { uint8_t enable; }; typedef <a href="include,public,domctl.h.html#Struct_xen_domctl_setdebugging">struct xen_domctl_setdebugging</a> <a name="Typedef_xen_domctl_setdebugging_t"><strong>xen_domctl_setdebugging_t</strong></a>; DEFINE_XEN_GUEST_HANDLE(<a href="include,public,domctl.h.html#Struct_xen_domctl_setdebugging">xen_domctl_setdebugging_t</a>); /* XEN_DOMCTL_irq_permission */ <a name="Struct_xen_domctl_irq_permission"><strong>struct xen_domctl_irq_permission</strong></a> { uint8_t pirq; uint8_t allow_access; /* flag to specify enable/disable of IRQ access */ }; typedef <a href="include,public,domctl.h.html#Struct_xen_domctl_irq_permission">struct xen_domctl_irq_permission</a> <a name="Typedef_xen_domctl_irq_permission_t"><strong>xen_domctl_irq_permission_t</strong></a>; DEFINE_XEN_GUEST_HANDLE(<a href="include,public,domctl.h.html#Struct_xen_domctl_irq_permission">xen_domctl_irq_permission_t</a>); /* XEN_DOMCTL_iomem_permission */ <a name="Struct_xen_domctl_iomem_permission"><strong>struct xen_domctl_iomem_permission</strong></a> { uint64_aligned_t first_mfn;/* first page (physical page number) in range */ uint64_aligned_t nr_mfns; /* number of pages in range (>0) */ uint8_t allow_access; /* allow (!0) or deny (0) access to range? */ }; typedef <a href="include,public,domctl.h.html#Struct_xen_domctl_iomem_permission">struct xen_domctl_iomem_permission</a> <a name="Typedef_xen_domctl_iomem_permission_t"><strong>xen_domctl_iomem_permission_t</strong></a>; DEFINE_XEN_GUEST_HANDLE(<a href="include,public,domctl.h.html#Struct_xen_domctl_iomem_permission">xen_domctl_iomem_permission_t</a>); /* XEN_DOMCTL_ioport_permission */ <a name="Struct_xen_domctl_ioport_permission"><strong>struct xen_domctl_ioport_permission</strong></a> { uint32_t first_port; /* first port int range */ uint32_t nr_ports; /* size of port range */ uint8_t allow_access; /* allow or deny access to range? */ }; typedef <a href="include,public,domctl.h.html#Struct_xen_domctl_ioport_permission">struct xen_domctl_ioport_permission</a> <a name="Typedef_xen_domctl_ioport_permission_t"><strong>xen_domctl_ioport_permission_t</strong></a>; DEFINE_XEN_GUEST_HANDLE(<a href="include,public,domctl.h.html#Struct_xen_domctl_ioport_permission">xen_domctl_ioport_permission_t</a>); /* XEN_DOMCTL_hypercall_init */ <a name="Struct_xen_domctl_hypercall_init"><strong>struct xen_domctl_hypercall_init</strong></a> { uint64_aligned_t gmfn; /* GMFN to be initialised */ }; typedef <a href="include,public,domctl.h.html#Struct_xen_domctl_hypercall_init">struct xen_domctl_hypercall_init</a> <a name="Typedef_xen_domctl_hypercall_init_t"><strong>xen_domctl_hypercall_init_t</strong></a>; DEFINE_XEN_GUEST_HANDLE(<a href="include,public,domctl.h.html#Struct_xen_domctl_hypercall_init">xen_domctl_hypercall_init_t</a>); /* XEN_DOMCTL_settimeoffset */ <a name="Struct_xen_domctl_settimeoffset"><strong>struct xen_domctl_settimeoffset</strong></a> { int32_t time_offset_seconds; /* applied to domain wallclock time */ }; typedef <a href="include,public,domctl.h.html#Struct_xen_domctl_settimeoffset">struct xen_domctl_settimeoffset</a> <a name="Typedef_xen_domctl_settimeoffset_t"><strong>xen_domctl_settimeoffset_t</strong></a>; DEFINE_XEN_GUEST_HANDLE(<a href="include,public,domctl.h.html#Struct_xen_domctl_settimeoffset">xen_domctl_settimeoffset_t</a>); /* XEN_DOMCTL_gethvmcontext */ /* XEN_DOMCTL_sethvmcontext */ typedef struct xen_domctl_hvmcontext { uint32_t size; /* IN/OUT: size of buffer / bytes filled */ XEN_GUEST_HANDLE_64(uint8) buffer; /* IN/OUT: data, or call * gethvmcontext with NULL * buffer to get size req'd */ } xen_domctl_hvmcontext_t; DEFINE_XEN_GUEST_HANDLE(xen_domctl_hvmcontext_t); /* XEN_DOMCTL_set_address_size */ /* XEN_DOMCTL_get_address_size */ typedef struct xen_domctl_address_size { uint32_t size; } xen_domctl_address_size_t; DEFINE_XEN_GUEST_HANDLE(xen_domctl_address_size_t); /* XEN_DOMCTL_sendtrigger */ #define XEN_DOMCTL_SENDTRIGGER_NMI 0 #define XEN_DOMCTL_SENDTRIGGER_RESET 1 #define XEN_DOMCTL_SENDTRIGGER_INIT 2 #define XEN_DOMCTL_SENDTRIGGER_POWER 3 #define XEN_DOMCTL_SENDTRIGGER_SLEEP 4 <a name="Struct_xen_domctl_sendtrigger"><strong>struct xen_domctl_sendtrigger</strong></a> { uint32_t trigger; /* IN */ uint32_t vcpu; /* IN */ }; typedef <a href="include,public,domctl.h.html#Struct_xen_domctl_sendtrigger">struct xen_domctl_sendtrigger</a> <a name="Typedef_xen_domctl_sendtrigger_t"><strong>xen_domctl_sendtrigger_t</strong></a>; DEFINE_XEN_GUEST_HANDLE(<a href="include,public,domctl.h.html#Struct_xen_domctl_sendtrigger">xen_domctl_sendtrigger_t</a>); /* Assign PCI device to HVM guest. Sets up IOMMU structures. */ /* XEN_DOMCTL_assign_device */ /* XEN_DOMCTL_test_assign_device */ /* XEN_DOMCTL_deassign_device */ <a name="Struct_xen_domctl_assign_device"><strong>struct xen_domctl_assign_device</strong></a> { uint32_t machine_sbdf; /* machine PCI ID of assigned device */ }; typedef <a href="include,public,domctl.h.html#Struct_xen_domctl_assign_device">struct xen_domctl_assign_device</a> <a name="Typedef_xen_domctl_assign_device_t"><strong>xen_domctl_assign_device_t</strong></a>; DEFINE_XEN_GUEST_HANDLE(<a href="include,public,domctl.h.html#Struct_xen_domctl_assign_device">xen_domctl_assign_device_t</a>); /* Retrieve sibling devices infomation of machine_sbdf */ /* XEN_DOMCTL_get_device_group */ <a name="Struct_xen_domctl_get_device_group"><strong>struct xen_domctl_get_device_group</strong></a> { uint32_t machine_sbdf; /* IN */ uint32_t max_sdevs; /* IN */ uint32_t num_sdevs; /* OUT */ XEN_GUEST_HANDLE_64(uint32) sdev_array; /* OUT */ }; typedef <a href="include,public,domctl.h.html#Struct_xen_domctl_get_device_group">struct xen_domctl_get_device_group</a> <a name="Typedef_xen_domctl_get_device_group_t"><strong>xen_domctl_get_device_group_t</strong></a>; DEFINE_XEN_GUEST_HANDLE(<a href="include,public,domctl.h.html#Struct_xen_domctl_get_device_group">xen_domctl_get_device_group_t</a>); /* Pass-through interrupts: bind real irq -> hvm devfn. */ /* XEN_DOMCTL_bind_pt_irq */ /* XEN_DOMCTL_unbind_pt_irq */ typedef enum pt_irq_type_e { PT_IRQ_TYPE_PCI, PT_IRQ_TYPE_ISA, PT_IRQ_TYPE_MSI, PT_IRQ_TYPE_MSI_TRANSLATE, } pt_irq_type_t; <a name="Struct_xen_domctl_bind_pt_irq"><strong>struct xen_domctl_bind_pt_irq</strong></a> { uint32_t machine_irq; pt_irq_type_t irq_type; uint32_t hvm_domid; union { struct { uint8_t isa_irq; } isa; struct { uint8_t bus; uint8_t device; uint8_t intx; } pci; struct { uint8_t gvec; uint32_t gflags; uint64_aligned_t gtable; } msi; } u; }; typedef <a href="include,public,domctl.h.html#Struct_xen_domctl_bind_pt_irq">struct xen_domctl_bind_pt_irq</a> <a name="Typedef_xen_domctl_bind_pt_irq_t"><strong>xen_domctl_bind_pt_irq_t</strong></a>; DEFINE_XEN_GUEST_HANDLE(<a href="include,public,domctl.h.html#Struct_xen_domctl_bind_pt_irq">xen_domctl_bind_pt_irq_t</a>); /* Bind machine I/O address range -> HVM address range. */ /* XEN_DOMCTL_memory_mapping */ #define DPCI_ADD_MAPPING 1 #define DPCI_REMOVE_MAPPING 0 <a name="Struct_xen_domctl_memory_mapping"><strong>struct xen_domctl_memory_mapping</strong></a> { uint64_aligned_t first_gfn; /* first page (hvm guest phys page) in range */ uint64_aligned_t first_mfn; /* first page (machine page) in range */ uint64_aligned_t nr_mfns; /* number of pages in range (>0) */ uint32_t add_mapping; /* add or remove mapping */ uint32_t padding; /* padding for 64-bit aligned structure */ }; typedef <a href="include,public,domctl.h.html#Struct_xen_domctl_memory_mapping">struct xen_domctl_memory_mapping</a> <a name="Typedef_xen_domctl_memory_mapping_t"><strong>xen_domctl_memory_mapping_t</strong></a>; DEFINE_XEN_GUEST_HANDLE(<a href="include,public,domctl.h.html#Struct_xen_domctl_memory_mapping">xen_domctl_memory_mapping_t</a>); /* Bind machine I/O port range -> HVM I/O port range. */ /* XEN_DOMCTL_ioport_mapping */ <a name="Struct_xen_domctl_ioport_mapping"><strong>struct xen_domctl_ioport_mapping</strong></a> { uint32_t first_gport; /* first guest IO port*/ uint32_t first_mport; /* first machine IO port */ uint32_t nr_ports; /* size of port range */ uint32_t add_mapping; /* add or remove mapping */ }; typedef <a href="include,public,domctl.h.html#Struct_xen_domctl_ioport_mapping">struct xen_domctl_ioport_mapping</a> <a name="Typedef_xen_domctl_ioport_mapping_t"><strong>xen_domctl_ioport_mapping_t</strong></a>; DEFINE_XEN_GUEST_HANDLE(<a href="include,public,domctl.h.html#Struct_xen_domctl_ioport_mapping">xen_domctl_ioport_mapping_t</a>); /* * Pin caching type of RAM space for x86 HVM domU. */ /* XEN_DOMCTL_pin_mem_cacheattr */ /* Caching types: these happen to be the same as x86 MTRR/PAT type codes. */ #define XEN_DOMCTL_MEM_CACHEATTR_UC 0 #define XEN_DOMCTL_MEM_CACHEATTR_WC 1 #define XEN_DOMCTL_MEM_CACHEATTR_WT 4 #define XEN_DOMCTL_MEM_CACHEATTR_WP 5 #define XEN_DOMCTL_MEM_CACHEATTR_WB 6 #define XEN_DOMCTL_MEM_CACHEATTR_UCM 7 #define XEN_DOMCTL_DELETE_MEM_CACHEATTR (~(uint32_t)0) <a name="Struct_xen_domctl_pin_mem_cacheattr"><strong>struct xen_domctl_pin_mem_cacheattr</strong></a> { uint64_aligned_t start, end; uint32_t type; /* XEN_DOMCTL_MEM_CACHEATTR_* */ }; typedef <a href="include,public,domctl.h.html#Struct_xen_domctl_pin_mem_cacheattr">struct xen_domctl_pin_mem_cacheattr</a> <a name="Typedef_xen_domctl_pin_mem_cacheattr_t"><strong>xen_domctl_pin_mem_cacheattr_t</strong></a>; DEFINE_XEN_GUEST_HANDLE(<a href="include,public,domctl.h.html#Struct_xen_domctl_pin_mem_cacheattr">xen_domctl_pin_mem_cacheattr_t</a>); /* XEN_DOMCTL_set_ext_vcpucontext */ /* XEN_DOMCTL_get_ext_vcpucontext */ <a name="Struct_xen_domctl_ext_vcpucontext"><strong>struct xen_domctl_ext_vcpucontext</strong></a> { /* IN: VCPU that this call applies to. */ uint32_t vcpu; /* * SET: Size of struct (IN) * GET: Size of struct (OUT, up to 128 bytes) */ uint32_t size; #if defined(__i386__) || defined(__x86_64__) /* SYSCALL from 32-bit mode and SYSENTER callback information. */ /* NB. SYSCALL from 64-bit mode is contained in <a href="include,public,arch-x86,xen.h.html#Struct_vcpu_guest_context">vcpu_guest_context_t</a> */ uint64_aligned_t syscall32_callback_eip; uint64_aligned_t sysenter_callback_eip; uint16_t syscall32_callback_cs; uint16_t sysenter_callback_cs; uint8_t syscall32_disables_events; uint8_t sysenter_disables_events; #if defined(__GNUC__) union { uint64_aligned_t mcg_cap; <a href="include,public,arch-x86,hvm,save.h.html#Struct_hvm_vmce_vcpu">struct hvm_vmce_vcpu</a> vmce; }; #else <a href="include,public,arch-x86,hvm,save.h.html#Struct_hvm_vmce_vcpu">struct hvm_vmce_vcpu</a> vmce; #endif #endif }; typedef <a href="include,public,domctl.h.html#Struct_xen_domctl_ext_vcpucontext">struct xen_domctl_ext_vcpucontext</a> <a name="Typedef_xen_domctl_ext_vcpucontext_t"><strong>xen_domctl_ext_vcpucontext_t</strong></a>; DEFINE_XEN_GUEST_HANDLE(<a href="include,public,domctl.h.html#Struct_xen_domctl_ext_vcpucontext">xen_domctl_ext_vcpucontext_t</a>); /* * Set the target domain for a domain */ /* XEN_DOMCTL_set_target */ <a name="Struct_xen_domctl_set_target"><strong>struct xen_domctl_set_target</strong></a> { <a href="include,public,xen.h.html#Typedef_domid_t">domid_t</a> target; }; typedef <a href="include,public,domctl.h.html#Struct_xen_domctl_set_target">struct xen_domctl_set_target</a> <a name="Typedef_xen_domctl_set_target_t"><strong>xen_domctl_set_target_t</strong></a>; DEFINE_XEN_GUEST_HANDLE(<a href="include,public,domctl.h.html#Struct_xen_domctl_set_target">xen_domctl_set_target_t</a>); #if defined(__i386__) || defined(__x86_64__) # define XEN_CPUID_INPUT_UNUSED 0xFFFFFFFF /* XEN_DOMCTL_set_cpuid */ <a name="Struct_xen_domctl_cpuid"><strong>struct xen_domctl_cpuid</strong></a> { uint32_t input[2]; uint32_t eax; uint32_t ebx; uint32_t ecx; uint32_t edx; }; typedef <a href="include,public,domctl.h.html#Struct_xen_domctl_cpuid">struct xen_domctl_cpuid</a> <a name="Typedef_xen_domctl_cpuid_t"><strong>xen_domctl_cpuid_t</strong></a>; DEFINE_XEN_GUEST_HANDLE(<a href="include,public,domctl.h.html#Struct_xen_domctl_cpuid">xen_domctl_cpuid_t</a>); #endif /* * Arranges that if the domain suspends (specifically, if it shuts * down with code SHUTDOWN_suspend), this event channel will be * notified. * * This is _instead of_ the usual notification to the global * VIRQ_DOM_EXC. (In most systems that pirq is owned by xenstored.) * * Only one subscription per domain is possible. Last subscriber * wins; others are silently displaced. * * NB that contrary to the rather general name, it only applies to * domain shutdown with code suspend. Shutdown for other reasons * (including crash), and domain death, are notified to VIRQ_DOM_EXC * regardless. */ /* XEN_DOMCTL_subscribe */ <a name="Struct_xen_domctl_subscribe"><strong>struct xen_domctl_subscribe</strong></a> { uint32_t port; /* IN */ }; typedef <a href="include,public,domctl.h.html#Struct_xen_domctl_subscribe">struct xen_domctl_subscribe</a> <a name="Typedef_xen_domctl_subscribe_t"><strong>xen_domctl_subscribe_t</strong></a>; DEFINE_XEN_GUEST_HANDLE(<a href="include,public,domctl.h.html#Struct_xen_domctl_subscribe">xen_domctl_subscribe_t</a>); /* * Define the maximum machine address size which should be allocated * to a guest. */ /* XEN_DOMCTL_set_machine_address_size */ /* XEN_DOMCTL_get_machine_address_size */ /* * Do not inject spurious page faults into this domain. */ /* XEN_DOMCTL_suppress_spurious_page_faults */ /* XEN_DOMCTL_debug_op */ #define XEN_DOMCTL_DEBUG_OP_SINGLE_STEP_OFF 0 #define XEN_DOMCTL_DEBUG_OP_SINGLE_STEP_ON 1 <a name="Struct_xen_domctl_debug_op"><strong>struct xen_domctl_debug_op</strong></a> { uint32_t op; /* IN */ uint32_t vcpu; /* IN */ }; typedef <a href="include,public,domctl.h.html#Struct_xen_domctl_debug_op">struct xen_domctl_debug_op</a> <a name="Typedef_xen_domctl_debug_op_t"><strong>xen_domctl_debug_op_t</strong></a>; DEFINE_XEN_GUEST_HANDLE(<a href="include,public,domctl.h.html#Struct_xen_domctl_debug_op">xen_domctl_debug_op_t</a>); /* * Request a particular record from the HVM context */ /* XEN_DOMCTL_gethvmcontext_partial */ typedef struct xen_domctl_hvmcontext_partial { uint32_t type; /* IN: Type of record required */ uint32_t instance; /* IN: Instance of that type */ XEN_GUEST_HANDLE_64(uint8) buffer; /* OUT: buffer to write record into */ } xen_domctl_hvmcontext_partial_t; DEFINE_XEN_GUEST_HANDLE(xen_domctl_hvmcontext_partial_t); /* XEN_DOMCTL_disable_migrate */ typedef struct xen_domctl_disable_migrate { uint32_t disable; /* IN: 1: disable migration and restore */ } xen_domctl_disable_migrate_t; /* XEN_DOMCTL_gettscinfo */ /* XEN_DOMCTL_settscinfo */ <a name="Struct_xen_guest_tsc_info"><strong>struct xen_guest_tsc_info</strong></a> { uint32_t tsc_mode; uint32_t gtsc_khz; uint32_t incarnation; uint32_t pad; uint64_aligned_t elapsed_nsec; }; typedef <a href="include,public,domctl.h.html#Struct_xen_guest_tsc_info">struct xen_guest_tsc_info</a> <a name="Typedef_xen_guest_tsc_info_t"><strong>xen_guest_tsc_info_t</strong></a>; DEFINE_XEN_GUEST_HANDLE(<a href="include,public,domctl.h.html#Struct_xen_guest_tsc_info">xen_guest_tsc_info_t</a>); typedef struct xen_domctl_tsc_info { XEN_GUEST_HANDLE_64(<a href="include,public,domctl.h.html#Struct_xen_guest_tsc_info">xen_guest_tsc_info_t</a>) out_info; /* OUT */ <a href="include,public,domctl.h.html#Struct_xen_guest_tsc_info">xen_guest_tsc_info_t</a> info; /* IN */ } xen_domctl_tsc_info_t; /* XEN_DOMCTL_gdbsx_guestmemio guest mem io */ <a name="Struct_xen_domctl_gdbsx_memio"><strong>struct xen_domctl_gdbsx_memio</strong></a> { /* IN */ uint64_aligned_t pgd3val;/* optional: init_mm.pgd[3] value */ uint64_aligned_t gva; /* guest virtual address */ uint64_aligned_t uva; /* user buffer virtual address */ uint32_t len; /* number of bytes to read/write */ uint8_t gwr; /* 0 = read from guest. 1 = write to guest */ /* OUT */ uint32_t remain; /* bytes remaining to be copied */ }; /* XEN_DOMCTL_gdbsx_pausevcpu */ /* XEN_DOMCTL_gdbsx_unpausevcpu */ <a name="Struct_xen_domctl_gdbsx_pauseunp_vcpu"><strong>struct xen_domctl_gdbsx_pauseunp_vcpu</strong></a> { /* pause/unpause a vcpu */ uint32_t vcpu; /* which vcpu */ }; /* XEN_DOMCTL_gdbsx_domstatus */ <a name="Struct_xen_domctl_gdbsx_domstatus"><strong>struct xen_domctl_gdbsx_domstatus</strong></a> { /* OUT */ uint8_t paused; /* is the domain paused */ uint32_t vcpu_id; /* any vcpu in an event? */ uint32_t vcpu_ev; /* if yes, what event? */ }; /* * Memory event operations */ /* XEN_DOMCTL_mem_event_op */ /* * Domain memory paging * Page memory in and out. * Domctl interface to set up and tear down the * pager<->hypervisor interface. Use XENMEM_paging_op* * to perform per-page operations. * * The XEN_DOMCTL_MEM_EVENT_OP_PAGING_ENABLE domctl returns several * non-standard error codes to indicate why paging could not be enabled: * ENODEV - host lacks HAP support (EPT/NPT) or HAP is disabled in guest * EMLINK - guest has iommu passthrough enabled * EXDEV - guest has PoD enabled * EBUSY - guest has or had paging enabled, ring buffer still active */ #define XEN_DOMCTL_MEM_EVENT_OP_PAGING 1 #define XEN_DOMCTL_MEM_EVENT_OP_PAGING_ENABLE 0 #define XEN_DOMCTL_MEM_EVENT_OP_PAGING_DISABLE 1 /* * Access permissions. * * As with paging, use the domctl for teardown/setup of the * helper<->hypervisor interface. * * There are HVM hypercalls to set the per-page access permissions of every * page in a domain. When one of these permissions--independent, read, * write, and execute--is violated, the VCPU is paused and a memory event * is sent with what happened. (See public/mem_event.h) . * * The memory event handler can then resume the VCPU and redo the access * with a XENMEM_access_op_resume hypercall. * * The XEN_DOMCTL_MEM_EVENT_OP_ACCESS_ENABLE domctl returns several * non-standard error codes to indicate why access could not be enabled: * ENODEV - host lacks HAP support (EPT/NPT) or HAP is disabled in guest * EBUSY - guest has or had access enabled, ring buffer still active */ #define XEN_DOMCTL_MEM_EVENT_OP_ACCESS 2 #define XEN_DOMCTL_MEM_EVENT_OP_ACCESS_ENABLE 0 #define XEN_DOMCTL_MEM_EVENT_OP_ACCESS_DISABLE 1 #define XEN_DOMCTL_MEM_EVENT_OP_ACCESS_ENABLE_INTROSPECTION 2 /* * Sharing ENOMEM helper. * * As with paging, use the domctl for teardown/setup of the * helper<->hypervisor interface. * * If setup, this ring is used to communicate failed allocations * in the unshare path. XENMEM_sharing_op_resume is used to wake up * vcpus that could not unshare. * * Note that shring can be turned on (as per the domctl below) * *without* this ring being setup. */ #define XEN_DOMCTL_MEM_EVENT_OP_SHARING 3 #define XEN_DOMCTL_MEM_EVENT_OP_SHARING_ENABLE 0 #define XEN_DOMCTL_MEM_EVENT_OP_SHARING_DISABLE 1 /* Use for teardown/setup of helper<->hypervisor interface for paging, * access and sharing.*/ <a name="Struct_xen_domctl_mem_event_op"><strong>struct xen_domctl_mem_event_op</strong></a> { uint32_t op; /* XEN_DOMCTL_MEM_EVENT_OP_*_* */ uint32_t mode; /* XEN_DOMCTL_MEM_EVENT_OP_* */ uint32_t port; /* OUT: event channel for ring */ }; typedef <a href="include,public,domctl.h.html#Struct_xen_domctl_mem_event_op">struct xen_domctl_mem_event_op</a> <a name="Typedef_xen_domctl_mem_event_op_t"><strong>xen_domctl_mem_event_op_t</strong></a>; DEFINE_XEN_GUEST_HANDLE(<a href="include,public,domctl.h.html#Struct_xen_domctl_mem_event_op">xen_domctl_mem_event_op_t</a>); /* * Memory sharing operations */ /* XEN_DOMCTL_mem_sharing_op. * The CONTROL sub-domctl is used for bringup/teardown. */ #define XEN_DOMCTL_MEM_SHARING_CONTROL 0 <a name="Struct_xen_domctl_mem_sharing_op"><strong>struct xen_domctl_mem_sharing_op</strong></a> { uint8_t op; /* XEN_DOMCTL_MEM_SHARING_* */ union { uint8_t enable; /* CONTROL */ } u; }; typedef <a href="include,public,domctl.h.html#Struct_xen_domctl_mem_sharing_op">struct xen_domctl_mem_sharing_op</a> <a name="Typedef_xen_domctl_mem_sharing_op_t"><strong>xen_domctl_mem_sharing_op_t</strong></a>; DEFINE_XEN_GUEST_HANDLE(<a href="include,public,domctl.h.html#Struct_xen_domctl_mem_sharing_op">xen_domctl_mem_sharing_op_t</a>); <a name="Struct_xen_domctl_audit_p2m"><strong>struct xen_domctl_audit_p2m</strong></a> { /* OUT error counts */ uint64_t orphans; uint64_t m2p_bad; uint64_t p2m_bad; }; typedef <a href="include,public,domctl.h.html#Struct_xen_domctl_audit_p2m">struct xen_domctl_audit_p2m</a> <a name="Typedef_xen_domctl_audit_p2m_t"><strong>xen_domctl_audit_p2m_t</strong></a>; DEFINE_XEN_GUEST_HANDLE(<a href="include,public,domctl.h.html#Struct_xen_domctl_audit_p2m">xen_domctl_audit_p2m_t</a>); <a name="Struct_xen_domctl_set_virq_handler"><strong>struct xen_domctl_set_virq_handler</strong></a> { uint32_t virq; /* IN */ }; typedef <a href="include,public,domctl.h.html#Struct_xen_domctl_set_virq_handler">struct xen_domctl_set_virq_handler</a> <a name="Typedef_xen_domctl_set_virq_handler_t"><strong>xen_domctl_set_virq_handler_t</strong></a>; DEFINE_XEN_GUEST_HANDLE(<a href="include,public,domctl.h.html#Struct_xen_domctl_set_virq_handler">xen_domctl_set_virq_handler_t</a>); #if defined(__i386__) || defined(__x86_64__) /* XEN_DOMCTL_setvcpuextstate */ /* XEN_DOMCTL_getvcpuextstate */ <a name="Struct_xen_domctl_vcpuextstate"><strong>struct xen_domctl_vcpuextstate</strong></a> { /* IN: VCPU that this call applies to. */ uint32_t vcpu; /* * SET: Ignored. * GET: xfeature support mask of struct (IN/OUT) * xfeature mask is served as identifications of the saving format * so that compatible CPUs can have a check on format to decide * whether it can restore. */ uint64_aligned_t xfeature_mask; /* * SET: Size of struct (IN) * GET: Size of struct (IN/OUT) */ uint64_aligned_t size; XEN_GUEST_HANDLE_64(uint64) buffer; }; typedef <a href="include,public,domctl.h.html#Struct_xen_domctl_vcpuextstate">struct xen_domctl_vcpuextstate</a> <a name="Typedef_xen_domctl_vcpuextstate_t"><strong>xen_domctl_vcpuextstate_t</strong></a>; DEFINE_XEN_GUEST_HANDLE(<a href="include,public,domctl.h.html#Struct_xen_domctl_vcpuextstate">xen_domctl_vcpuextstate_t</a>); #endif /* XEN_DOMCTL_set_access_required: sets whether a memory event listener * must be present to handle page access events: if false, the page * access will revert to full permissions if no one is listening; * */ <a name="Struct_xen_domctl_set_access_required"><strong>struct xen_domctl_set_access_required</strong></a> { uint8_t access_required; }; typedef <a href="include,public,domctl.h.html#Struct_xen_domctl_set_access_required">struct xen_domctl_set_access_required</a> <a name="Typedef_xen_domctl_set_access_required_t"><strong>xen_domctl_set_access_required_t</strong></a>; DEFINE_XEN_GUEST_HANDLE(<a href="include,public,domctl.h.html#Struct_xen_domctl_set_access_required">xen_domctl_set_access_required_t</a>); <a name="Struct_xen_domctl_set_broken_page_p2m"><strong>struct xen_domctl_set_broken_page_p2m</strong></a> { uint64_aligned_t pfn; }; typedef <a href="include,public,domctl.h.html#Struct_xen_domctl_set_broken_page_p2m">struct xen_domctl_set_broken_page_p2m</a> <a name="Typedef_xen_domctl_set_broken_page_p2m_t"><strong>xen_domctl_set_broken_page_p2m_t</strong></a>; DEFINE_XEN_GUEST_HANDLE(<a href="include,public,domctl.h.html#Struct_xen_domctl_set_broken_page_p2m">xen_domctl_set_broken_page_p2m_t</a>); /* * XEN_DOMCTL_set_max_evtchn: sets the maximum event channel port * number the guest may use. Use this limit the amount of resources * (global mapping space, xenheap) a guest may use for event channels. */ <a name="Struct_xen_domctl_set_max_evtchn"><strong>struct xen_domctl_set_max_evtchn</strong></a> { uint32_t max_port; }; typedef <a href="include,public,domctl.h.html#Struct_xen_domctl_set_max_evtchn">struct xen_domctl_set_max_evtchn</a> <a name="Typedef_xen_domctl_set_max_evtchn_t"><strong>xen_domctl_set_max_evtchn_t</strong></a>; DEFINE_XEN_GUEST_HANDLE(<a href="include,public,domctl.h.html#Struct_xen_domctl_set_max_evtchn">xen_domctl_set_max_evtchn_t</a>); /* * ARM: Clean and invalidate caches associated with given region of * guest memory. */ <a name="Struct_xen_domctl_cacheflush"><strong>struct xen_domctl_cacheflush</strong></a> { /* IN: page range to flush. */ xen_pfn_t start_pfn, nr_pfns; }; typedef <a href="include,public,domctl.h.html#Struct_xen_domctl_cacheflush">struct xen_domctl_cacheflush</a> <a name="Typedef_xen_domctl_cacheflush_t"><strong>xen_domctl_cacheflush_t</strong></a>; DEFINE_XEN_GUEST_HANDLE(<a href="include,public,domctl.h.html#Struct_xen_domctl_cacheflush">xen_domctl_cacheflush_t</a>); #if defined(__i386__) || defined(__x86_64__) <a name="Struct_xen_domctl_vcpu_msr"><strong>struct xen_domctl_vcpu_msr</strong></a> { uint32_t index; uint32_t reserved; uint64_aligned_t value; }; typedef <a href="include,public,domctl.h.html#Struct_xen_domctl_vcpu_msr">struct xen_domctl_vcpu_msr</a> <a name="Typedef_xen_domctl_vcpu_msr_t"><strong>xen_domctl_vcpu_msr_t</strong></a>; DEFINE_XEN_GUEST_HANDLE(<a href="include,public,domctl.h.html#Struct_xen_domctl_vcpu_msr">xen_domctl_vcpu_msr_t</a>); /* * XEN_DOMCTL_set_vcpu_msrs / XEN_DOMCTL_get_vcpu_msrs. * * Input: * - A NULL 'msrs' guest handle is a request for the maximum 'msr_count'. * - Otherwise, 'msr_count' is the number of entries in 'msrs'. * * Output for get: * - If 'msr_count' is less than the number Xen needs to write, -ENOBUFS shall * be returned and 'msr_count' updated to reflect the intended number. * - On success, 'msr_count' shall indicate the number of MSRs written, which * may be less than the maximum if some are not currently used by the vcpu. * * Output for set: * - If Xen encounters an error with a specific MSR, -EINVAL shall be returned * and 'msr_count' shall be set to the offending index, to aid debugging. */ <a name="Struct_xen_domctl_vcpu_msrs"><strong>struct xen_domctl_vcpu_msrs</strong></a> { uint32_t vcpu; /* IN */ uint32_t msr_count; /* IN/OUT */ XEN_GUEST_HANDLE_64(<a href="include,public,domctl.h.html#Struct_xen_domctl_vcpu_msr">xen_domctl_vcpu_msr_t</a>) msrs; /* IN/OUT */ }; typedef <a href="include,public,domctl.h.html#Struct_xen_domctl_vcpu_msrs">struct xen_domctl_vcpu_msrs</a> <a name="Typedef_xen_domctl_vcpu_msrs_t"><strong>xen_domctl_vcpu_msrs_t</strong></a>; DEFINE_XEN_GUEST_HANDLE(<a href="include,public,domctl.h.html#Struct_xen_domctl_vcpu_msrs">xen_domctl_vcpu_msrs_t</a>); #endif /* * Use in XEN_DOMCTL_setvnumainfo to set * vNUMA domain topology. */ <a name="Struct_xen_domctl_vnuma"><strong>struct xen_domctl_vnuma</strong></a> { uint32_t nr_vnodes; uint32_t nr_vmemranges; uint32_t nr_vcpus; uint32_t pad; XEN_GUEST_HANDLE_64(uint) vdistance; XEN_GUEST_HANDLE_64(uint) vcpu_to_vnode; /* * vnodes to physical NUMA nodes mask. * This kept on per-domain basis for * interested consumers, such as numa aware ballooning. */ XEN_GUEST_HANDLE_64(uint) vnode_to_pnode; /* * memory rages for each vNUMA node */ XEN_GUEST_HANDLE_64(<a href="include,public,memory.h.html#Struct_xen_vmemrange">xen_vmemrange_t</a>) vmemrange; }; typedef <a href="include,public,domctl.h.html#Struct_xen_domctl_vnuma">struct xen_domctl_vnuma</a> <a name="Typedef_xen_domctl_vnuma_t"><strong>xen_domctl_vnuma_t</strong></a>; DEFINE_XEN_GUEST_HANDLE(<a href="include,public,domctl.h.html#Struct_xen_domctl_vnuma">xen_domctl_vnuma_t</a>); <a name="Struct_xen_domctl_psr_cmt_op"><strong>struct xen_domctl_psr_cmt_op</strong></a> { #define XEN_DOMCTL_PSR_CMT_OP_DETACH 0 #define XEN_DOMCTL_PSR_CMT_OP_ATTACH 1 #define XEN_DOMCTL_PSR_CMT_OP_QUERY_RMID 2 uint32_t cmd; uint32_t data; }; typedef <a href="include,public,domctl.h.html#Struct_xen_domctl_psr_cmt_op">struct xen_domctl_psr_cmt_op</a> <a name="Typedef_xen_domctl_psr_cmt_op_t"><strong>xen_domctl_psr_cmt_op_t</strong></a>; DEFINE_XEN_GUEST_HANDLE(<a href="include,public,domctl.h.html#Struct_xen_domctl_psr_cmt_op">xen_domctl_psr_cmt_op_t</a>); <a name="Struct_xen_domctl"><strong>struct xen_domctl</strong></a> { uint32_t cmd; #define XEN_DOMCTL_createdomain 1 #define XEN_DOMCTL_destroydomain 2 #define XEN_DOMCTL_pausedomain 3 #define XEN_DOMCTL_unpausedomain 4 #define XEN_DOMCTL_getdomaininfo 5 #define XEN_DOMCTL_getmemlist 6 #define XEN_DOMCTL_getpageframeinfo 7 #define XEN_DOMCTL_getpageframeinfo2 8 #define XEN_DOMCTL_setvcpuaffinity 9 #define XEN_DOMCTL_shadow_op 10 #define XEN_DOMCTL_max_mem 11 #define XEN_DOMCTL_setvcpucontext 12 #define XEN_DOMCTL_getvcpucontext 13 #define XEN_DOMCTL_getvcpuinfo 14 #define XEN_DOMCTL_max_vcpus 15 #define XEN_DOMCTL_scheduler_op 16 #define XEN_DOMCTL_setdomainhandle 17 #define XEN_DOMCTL_setdebugging 18 #define XEN_DOMCTL_irq_permission 19 #define XEN_DOMCTL_iomem_permission 20 #define XEN_DOMCTL_ioport_permission 21 #define XEN_DOMCTL_hypercall_init 22 #define XEN_DOMCTL_arch_setup 23 /* Obsolete IA64 only */ #define XEN_DOMCTL_settimeoffset 24 #define XEN_DOMCTL_getvcpuaffinity 25 #define XEN_DOMCTL_real_mode_area 26 /* Obsolete PPC only */ #define XEN_DOMCTL_resumedomain 27 #define XEN_DOMCTL_sendtrigger 28 #define XEN_DOMCTL_subscribe 29 #define XEN_DOMCTL_gethvmcontext 33 #define XEN_DOMCTL_sethvmcontext 34 #define XEN_DOMCTL_set_address_size 35 #define XEN_DOMCTL_get_address_size 36 #define XEN_DOMCTL_assign_device 37 #define XEN_DOMCTL_bind_pt_irq 38 #define XEN_DOMCTL_memory_mapping 39 #define XEN_DOMCTL_ioport_mapping 40 #define XEN_DOMCTL_pin_mem_cacheattr 41 #define XEN_DOMCTL_set_ext_vcpucontext 42 #define XEN_DOMCTL_get_ext_vcpucontext 43 #define XEN_DOMCTL_set_opt_feature 44 /* Obsolete IA64 only */ #define XEN_DOMCTL_test_assign_device 45 #define XEN_DOMCTL_set_target 46 #define XEN_DOMCTL_deassign_device 47 #define XEN_DOMCTL_unbind_pt_irq 48 #define XEN_DOMCTL_set_cpuid 49 #define XEN_DOMCTL_get_device_group 50 #define XEN_DOMCTL_set_machine_address_size 51 #define XEN_DOMCTL_get_machine_address_size 52 #define XEN_DOMCTL_suppress_spurious_page_faults 53 #define XEN_DOMCTL_debug_op 54 #define XEN_DOMCTL_gethvmcontext_partial 55 #define XEN_DOMCTL_mem_event_op 56 #define XEN_DOMCTL_mem_sharing_op 57 #define XEN_DOMCTL_disable_migrate 58 #define XEN_DOMCTL_gettscinfo 59 #define XEN_DOMCTL_settscinfo 60 #define XEN_DOMCTL_getpageframeinfo3 61 #define XEN_DOMCTL_setvcpuextstate 62 #define XEN_DOMCTL_getvcpuextstate 63 #define XEN_DOMCTL_set_access_required 64 #define XEN_DOMCTL_audit_p2m 65 #define XEN_DOMCTL_set_virq_handler 66 #define XEN_DOMCTL_set_broken_page_p2m 67 #define XEN_DOMCTL_setnodeaffinity 68 #define XEN_DOMCTL_getnodeaffinity 69 #define XEN_DOMCTL_set_max_evtchn 70 #define XEN_DOMCTL_cacheflush 71 #define XEN_DOMCTL_get_vcpu_msrs 72 #define XEN_DOMCTL_set_vcpu_msrs 73 #define XEN_DOMCTL_setvnumainfo 74 #define XEN_DOMCTL_psr_cmt_op 75 #define XEN_DOMCTL_arm_configure_domain 76 #define XEN_DOMCTL_gdbsx_guestmemio 1000 #define XEN_DOMCTL_gdbsx_pausevcpu 1001 #define XEN_DOMCTL_gdbsx_unpausevcpu 1002 #define XEN_DOMCTL_gdbsx_domstatus 1003 uint32_t interface_version; /* XEN_DOMCTL_INTERFACE_VERSION */ <a href="include,public,xen.h.html#Typedef_domid_t">domid_t</a> domain; union { <a href="include,public,domctl.h.html#Struct_xen_domctl_createdomain">struct xen_domctl_createdomain</a> createdomain; #if defined(__arm__) || defined(__aarch64__) <a href="include,public,domctl.h.html#Struct_xen_domctl_arm_configuredomain">struct xen_domctl_arm_configuredomain</a> configuredomain; #endif <a href="include,public,domctl.h.html#Struct_xen_domctl_getdomaininfo">struct xen_domctl_getdomaininfo</a> getdomaininfo; <a href="include,public,domctl.h.html#Struct_xen_domctl_getmemlist">struct xen_domctl_getmemlist</a> getmemlist; <a href="include,public,domctl.h.html#Struct_xen_domctl_getpageframeinfo">struct xen_domctl_getpageframeinfo</a> getpageframeinfo; <a href="include,public,domctl.h.html#Struct_xen_domctl_getpageframeinfo2">struct xen_domctl_getpageframeinfo2</a> getpageframeinfo2; <a href="include,public,domctl.h.html#Struct_xen_domctl_getpageframeinfo3">struct xen_domctl_getpageframeinfo3</a> getpageframeinfo3; <a href="include,public,domctl.h.html#Struct_xen_domctl_nodeaffinity">struct xen_domctl_nodeaffinity</a> nodeaffinity; <a href="include,public,domctl.h.html#Struct_xen_domctl_vcpuaffinity">struct xen_domctl_vcpuaffinity</a> vcpuaffinity; <a href="include,public,domctl.h.html#Struct_xen_domctl_shadow_op">struct xen_domctl_shadow_op</a> shadow_op; <a href="include,public,domctl.h.html#Struct_xen_domctl_max_mem">struct xen_domctl_max_mem</a> max_mem; <a href="include,public,domctl.h.html#Struct_xen_domctl_vcpucontext">struct xen_domctl_vcpucontext</a> vcpucontext; <a href="include,public,domctl.h.html#Struct_xen_domctl_getvcpuinfo">struct xen_domctl_getvcpuinfo</a> getvcpuinfo; <a href="include,public,domctl.h.html#Struct_xen_domctl_max_vcpus">struct xen_domctl_max_vcpus</a> max_vcpus; <a href="include,public,domctl.h.html#Struct_xen_domctl_scheduler_op">struct xen_domctl_scheduler_op</a> scheduler_op; <a href="include,public,domctl.h.html#Struct_xen_domctl_setdomainhandle">struct xen_domctl_setdomainhandle</a> setdomainhandle; <a href="include,public,domctl.h.html#Struct_xen_domctl_setdebugging">struct xen_domctl_setdebugging</a> setdebugging; <a href="include,public,domctl.h.html#Struct_xen_domctl_irq_permission">struct xen_domctl_irq_permission</a> irq_permission; <a href="include,public,domctl.h.html#Struct_xen_domctl_iomem_permission">struct xen_domctl_iomem_permission</a> iomem_permission; <a href="include,public,domctl.h.html#Struct_xen_domctl_ioport_permission">struct xen_domctl_ioport_permission</a> ioport_permission; <a href="include,public,domctl.h.html#Struct_xen_domctl_hypercall_init">struct xen_domctl_hypercall_init</a> hypercall_init; <a href="include,public,domctl.h.html#Struct_xen_domctl_settimeoffset">struct xen_domctl_settimeoffset</a> settimeoffset; struct xen_domctl_disable_migrate disable_migrate; struct xen_domctl_tsc_info tsc_info; struct xen_domctl_hvmcontext hvmcontext; struct xen_domctl_hvmcontext_partial hvmcontext_partial; struct xen_domctl_address_size address_size; <a href="include,public,domctl.h.html#Struct_xen_domctl_sendtrigger">struct xen_domctl_sendtrigger</a> sendtrigger; <a href="include,public,domctl.h.html#Struct_xen_domctl_get_device_group">struct xen_domctl_get_device_group</a> get_device_group; <a href="include,public,domctl.h.html#Struct_xen_domctl_assign_device">struct xen_domctl_assign_device</a> assign_device; <a href="include,public,domctl.h.html#Struct_xen_domctl_bind_pt_irq">struct xen_domctl_bind_pt_irq</a> bind_pt_irq; <a href="include,public,domctl.h.html#Struct_xen_domctl_memory_mapping">struct xen_domctl_memory_mapping</a> memory_mapping; <a href="include,public,domctl.h.html#Struct_xen_domctl_ioport_mapping">struct xen_domctl_ioport_mapping</a> ioport_mapping; <a href="include,public,domctl.h.html#Struct_xen_domctl_pin_mem_cacheattr">struct xen_domctl_pin_mem_cacheattr</a> pin_mem_cacheattr; <a href="include,public,domctl.h.html#Struct_xen_domctl_ext_vcpucontext">struct xen_domctl_ext_vcpucontext</a> ext_vcpucontext; <a href="include,public,domctl.h.html#Struct_xen_domctl_set_target">struct xen_domctl_set_target</a> set_target; <a href="include,public,domctl.h.html#Struct_xen_domctl_subscribe">struct xen_domctl_subscribe</a> subscribe; <a href="include,public,domctl.h.html#Struct_xen_domctl_debug_op">struct xen_domctl_debug_op</a> debug_op; <a href="include,public,domctl.h.html#Struct_xen_domctl_mem_event_op">struct xen_domctl_mem_event_op</a> mem_event_op; <a href="include,public,domctl.h.html#Struct_xen_domctl_mem_sharing_op">struct xen_domctl_mem_sharing_op</a> mem_sharing_op; #if defined(__i386__) || defined(__x86_64__) <a href="include,public,domctl.h.html#Struct_xen_domctl_cpuid">struct xen_domctl_cpuid</a> cpuid; <a href="include,public,domctl.h.html#Struct_xen_domctl_vcpuextstate">struct xen_domctl_vcpuextstate</a> vcpuextstate; <a href="include,public,domctl.h.html#Struct_xen_domctl_vcpu_msrs">struct xen_domctl_vcpu_msrs</a> vcpu_msrs; #endif <a href="include,public,domctl.h.html#Struct_xen_domctl_set_access_required">struct xen_domctl_set_access_required</a> access_required; <a href="include,public,domctl.h.html#Struct_xen_domctl_audit_p2m">struct xen_domctl_audit_p2m</a> audit_p2m; <a href="include,public,domctl.h.html#Struct_xen_domctl_set_virq_handler">struct xen_domctl_set_virq_handler</a> set_virq_handler; <a href="include,public,domctl.h.html#Struct_xen_domctl_set_max_evtchn">struct xen_domctl_set_max_evtchn</a> set_max_evtchn; <a href="include,public,domctl.h.html#Struct_xen_domctl_gdbsx_memio">struct xen_domctl_gdbsx_memio</a> gdbsx_guest_memio; <a href="include,public,domctl.h.html#Struct_xen_domctl_set_broken_page_p2m">struct xen_domctl_set_broken_page_p2m</a> set_broken_page_p2m; <a href="include,public,domctl.h.html#Struct_xen_domctl_cacheflush">struct xen_domctl_cacheflush</a> cacheflush; <a href="include,public,domctl.h.html#Struct_xen_domctl_gdbsx_pauseunp_vcpu">struct xen_domctl_gdbsx_pauseunp_vcpu</a> gdbsx_pauseunp_vcpu; <a href="include,public,domctl.h.html#Struct_xen_domctl_gdbsx_domstatus">struct xen_domctl_gdbsx_domstatus</a> gdbsx_domstatus; <a href="include,public,domctl.h.html#Struct_xen_domctl_vnuma">struct xen_domctl_vnuma</a> vnuma; <a href="include,public,domctl.h.html#Struct_xen_domctl_psr_cmt_op">struct xen_domctl_psr_cmt_op</a> psr_cmt_op; uint8_t pad[128]; } u; }; typedef <a href="include,public,domctl.h.html#Struct_xen_domctl">struct xen_domctl</a> <a name="Typedef_xen_domctl_t"><strong>xen_domctl_t</strong></a>; DEFINE_XEN_GUEST_HANDLE(<a href="include,public,domctl.h.html#Struct_xen_domctl">xen_domctl_t</a>); #endif /* __XEN_PUBLIC_DOMCTL_H__ */ /* * Local variables: * mode: C * c-file-style: "BSD" * c-basic-offset: 4 * tab-width: 4 * indent-tabs-mode: nil * End: */ </pre></body></html>