<html><head><title>include/public/domctl.h - arch-arm - 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 "event_channel.h"
#include "grant_table.h"
#include "hvm/save.h"
#include "memory.h"
#define XEN_DOMCTL_INTERFACE_VERSION 0x00000011
/*
* 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 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 xenstore domain? */
#define _XEN_DOMCTL_CDF_xs_domain 4
#define XEN_DOMCTL_CDF_xs_domain (1U<<_XEN_DOMCTL_CDF_xs_domain)
uint32_t flags;
/*
* Various domain limits, which impact the quantity of resources (global
* mapping space, xenheap, etc) a guest may consume.
*/
uint32_t max_vcpus;
uint32_t max_evtchn_port;
uint32_t max_grant_frames;
uint32_t max_maptrack_frames;
<a href="include,public,arch-arm.h.html#Struct_xen_arch_domainconfig">struct xen_arch_domainconfig</a> arch;
};
/* 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 a xenstore domain */
#define _XEN_DOMINF_xs_domain 7
#define XEN_DOMINF_xs_domain (1U<<_XEN_DOMINF_xs_domain)
/* domain has hardware assisted paging */
#define _XEN_DOMINF_hap 8
#define XEN_DOMINF_hap (1U<<_XEN_DOMINF_hap)
/* 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;
<a href="include,public,arch-arm.h.html#Struct_xen_arch_domainconfig">struct xen_arch_domainconfig</a> arch_config;
};
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_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)
/* 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(<a href="include,public,arch-arm.h.html#Typedef_xen_pfn_t">xen_pfn_t</a>) 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
/*
* No longer supported, was 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)
/* Mode flags for XEN_DOMCTL_SHADOW_OP_{CLEAN,PEEK}. */
/*
* This is the final iteration: Requesting to include pages mapped
* writably by the hypervisor in the dirty bitmap.
*/
#define XEN_DOMCTL_SHADOW_LOGDIRTY_FINAL (1 << 0)
<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;
};
<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: XEN_DOMCTL_SHADOW_ENABLE_* */
/* OP_PEAK / OP_CLEAN: XEN_DOMCTL_SHADOW_LOGDIRTY_* */
uint32_t mode;
/* 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;
};
/* 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;
};
/* 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-arm.h.html#Struct_vcpu_guest_context">vcpu_guest_context_t</a>) ctxt; /* IN/OUT */
};
/* 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 */
};
/* 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 */
};
/* 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)
/* Undo SCHEDOP_pin_override */
#define _XEN_VCPUAFFINITY_FORCE 2
#define XEN_VCPUAFFINITY_FORCE (1U<<_XEN_VCPUAFFINITY_FORCE)
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;
};
/*
* XEN_DOMCTL_max_vcpus:
*
* The parameter passed to XEN_DOMCTL_max_vcpus must match the value passed to
* XEN_DOMCTL_createdomain. This hypercall is in the process of being removed
* (once the failure paths in domain_create() have been improved), but is
* still required in the short term to allocate the vcpus themselves.
*/
<a name="Struct_xen_domctl_max_vcpus"><strong>struct xen_domctl_max_vcpus</strong></a> {
uint32_t max; /* maximum number of vcpus */
};
/* XEN_DOMCTL_scheduler_op */
/* Scheduler types. */
/* #define XEN_SCHEDULER_SEDF 4 (Removed) */
#define XEN_SCHEDULER_CREDIT 5
#define XEN_SCHEDULER_CREDIT2 6
#define XEN_SCHEDULER_ARINC653 7
#define XEN_SCHEDULER_RTDS 8
#define XEN_SCHEDULER_NULL 9
<a name="Struct_xen_domctl_sched_credit"><strong>struct xen_domctl_sched_credit</strong></a> {
uint16_t weight;
uint16_t cap;
};
<a name="Struct_xen_domctl_sched_credit2"><strong>struct xen_domctl_sched_credit2</strong></a> {
uint16_t weight;
uint16_t cap;
};
<a name="Struct_xen_domctl_sched_rtds"><strong>struct xen_domctl_sched_rtds</strong></a> {
uint32_t period;
uint32_t budget;
/* Can this vCPU execute beyond its reserved amount of time? */
#define _XEN_DOMCTL_SCHEDRT_extra 0
#define XEN_DOMCTL_SCHEDRT_extra (1U<<_XEN_DOMCTL_SCHEDRT_extra)
uint32_t flags;
};
typedef struct xen_domctl_schedparam_vcpu {
union {
<a href="include,public,domctl.h.html#Struct_xen_domctl_sched_credit">struct xen_domctl_sched_credit</a> credit;
<a href="include,public,domctl.h.html#Struct_xen_domctl_sched_credit2">struct xen_domctl_sched_credit2</a> credit2;
<a href="include,public,domctl.h.html#Struct_xen_domctl_sched_rtds">struct xen_domctl_sched_rtds</a> rtds;
} u;
uint32_t vcpuid;
} xen_domctl_schedparam_vcpu_t;
DEFINE_XEN_GUEST_HANDLE(xen_domctl_schedparam_vcpu_t);
/*
* Set or get info?
* For schedulers supporting per-vcpu settings (e.g., RTDS):
* XEN_DOMCTL_SCHEDOP_putinfo sets params for all vcpus;
* XEN_DOMCTL_SCHEDOP_getinfo gets default params;
* XEN_DOMCTL_SCHEDOP_put(get)vcpuinfo sets (gets) params of vcpus;
*
* For schedulers not supporting per-vcpu settings:
* XEN_DOMCTL_SCHEDOP_putinfo sets params for all vcpus;
* XEN_DOMCTL_SCHEDOP_getinfo gets domain-wise params;
* XEN_DOMCTL_SCHEDOP_put(get)vcpuinfo returns error;
*/
#define XEN_DOMCTL_SCHEDOP_putinfo 0
#define XEN_DOMCTL_SCHEDOP_getinfo 1
#define XEN_DOMCTL_SCHEDOP_putvcpuinfo 2
#define XEN_DOMCTL_SCHEDOP_getvcpuinfo 3
<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_* */
/* IN/OUT */
union {
<a href="include,public,domctl.h.html#Struct_xen_domctl_sched_credit">struct xen_domctl_sched_credit</a> credit;
<a href="include,public,domctl.h.html#Struct_xen_domctl_sched_credit2">struct xen_domctl_sched_credit2</a> credit2;
<a href="include,public,domctl.h.html#Struct_xen_domctl_sched_rtds">struct xen_domctl_sched_rtds</a> rtds;
struct {
XEN_GUEST_HANDLE_64(xen_domctl_schedparam_vcpu_t) vcpus;
/*
* IN: Number of elements in vcpus array.
* OUT: Number of processed elements of vcpus array.
*/
uint32_t nr_vcpus;
uint32_t padding;
} v;
} u;
};
/* XEN_DOMCTL_setdomainhandle */
<a name="Struct_xen_domctl_setdomainhandle"><strong>struct xen_domctl_setdomainhandle</strong></a> {
xen_domain_handle_t handle;
};
/* XEN_DOMCTL_setdebugging */
<a name="Struct_xen_domctl_setdebugging"><strong>struct xen_domctl_setdebugging</strong></a> {
uint8_t enable;
};
/* 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 */
};
/* 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? */
};
/* 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? */
};
/* 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 */
};
/* XEN_DOMCTL_settimeoffset */
<a name="Struct_xen_domctl_settimeoffset"><strong>struct xen_domctl_settimeoffset</strong></a> {
int64_aligned_t time_offset_seconds; /* applied to domain wallclock time */
};
/* XEN_DOMCTL_gethvmcontext */
/* XEN_DOMCTL_sethvmcontext */
<a name="Struct_xen_domctl_hvmcontext"><strong>struct xen_domctl_hvmcontext</strong></a> {
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_set_address_size */
/* XEN_DOMCTL_get_address_size */
<a name="Struct_xen_domctl_address_size"><strong>struct xen_domctl_address_size</strong></a> {
uint32_t size;
};
/* 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 */
};
/* Assign a device to a guest. Sets up IOMMU structures. */
/* XEN_DOMCTL_assign_device */
/*
* XEN_DOMCTL_test_assign_device: Pass DOMID_INVALID to find out whether the
* given device is assigned to any DomU at all. Pass a specific domain ID to
* find out whether the given device can be assigned to that domain.
*/
/*
* XEN_DOMCTL_deassign_device: The behavior of this DOMCTL differs
* between the different type of device:
* - PCI device (XEN_DOMCTL_DEV_PCI) will be reassigned to DOM0
* - DT device (XEN_DOMCTL_DEV_DT) will left unassigned. DOM0
* will have to call XEN_DOMCTL_assign_device in order to use the
* device.
*/
#define XEN_DOMCTL_DEV_PCI 0
#define XEN_DOMCTL_DEV_DT 1
<a name="Struct_xen_domctl_assign_device"><strong>struct xen_domctl_assign_device</strong></a> {
/* IN */
uint32_t dev; /* XEN_DOMCTL_DEV_* */
uint32_t flags;
#define XEN_DOMCTL_DEV_RDM_RELAXED 1 /* assign only */
union {
struct {
uint32_t machine_sbdf; /* machine PCI ID of assigned device */
} pci;
struct {
uint32_t size; /* Length of the path */
XEN_GUEST_HANDLE_64(char) path; /* path to the device tree node */
} dt;
} u;
};
/* Retrieve sibling devices information 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 */
};
/* Pass-through interrupts: bind real irq -> hvm devfn. */
/* XEN_DOMCTL_bind_pt_irq */
/* XEN_DOMCTL_unbind_pt_irq */
<a name="Enum_pt_irq_type"><strong>enum pt_irq_type</strong></a> {
PT_IRQ_TYPE_PCI,
PT_IRQ_TYPE_ISA,
PT_IRQ_TYPE_MSI,
PT_IRQ_TYPE_MSI_TRANSLATE,
PT_IRQ_TYPE_SPI, /* ARM: valid range 32-1019 */
};
<a name="Struct_xen_domctl_bind_pt_irq"><strong>struct xen_domctl_bind_pt_irq</strong></a> {
uint32_t machine_irq;
uint32_t irq_type; /* <a href="include,public,domctl.h.html#Enum_pt_irq_type">enum pt_irq_type</a> */
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;
#define XEN_DOMCTL_VMSI_X86_DEST_ID_MASK 0x0000ff
#define XEN_DOMCTL_VMSI_X86_RH_MASK 0x000100
#define XEN_DOMCTL_VMSI_X86_DM_MASK 0x000200
#define XEN_DOMCTL_VMSI_X86_DELIV_MASK 0x007000
#define XEN_DOMCTL_VMSI_X86_TRIG_MASK 0x008000
#define XEN_DOMCTL_VMSI_X86_UNMASKED 0x010000
uint64_aligned_t gtable;
} msi;
struct {
uint16_t spi;
} spi;
} u;
};
/* Bind machine I/O address range -> HVM address range. */
/* XEN_DOMCTL_memory_mapping */
/* Returns
- zero success, everything done
- -E2BIG passed in nr_mfns value too large for the implementation
- positive partial success for the first <result> page frames (with
<result> less than nr_mfns), requiring re-invocation by the
caller after updating inputs
- negative error; other than -E2BIG
*/
#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 */
};
/* 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 */
};
/*
* 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)
/* 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-arm.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;
struct hvm_vmce_vcpu vmce;
};
#else
struct hvm_vmce_vcpu vmce;
#endif
#endif
};
/*
* 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;
};
#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;
};
/*
* XEN_DOMCTL_get_cpu_policy (x86 specific)
*
* Query the CPUID and MSR policies for a specific domain.
*/
<a name="Struct_xen_domctl_cpu_policy"><strong>struct xen_domctl_cpu_policy</strong></a> {
uint32_t nr_leaves; /* IN/OUT: Number of leaves in/written to
* 'cpuid_policy'. */
uint32_t nr_msrs; /* IN/OUT: Number of MSRs in/written to
* 'msr_domain_policy' */
XEN_GUEST_HANDLE_64(xen_cpuid_leaf_t) cpuid_policy; /* OUT */
XEN_GUEST_HANDLE_64(xen_msr_entry_t) msr_policy; /* OUT */
};
typedef <a href="include,public,domctl.h.html#Struct_xen_domctl_cpu_policy">struct xen_domctl_cpu_policy</a> <a name="Typedef_xen_domctl_cpu_policy_t"><strong>xen_domctl_cpu_policy_t</strong></a>;
DEFINE_XEN_GUEST_HANDLE(<a href="include,public,domctl.h.html#Struct_xen_domctl_cpu_policy">xen_domctl_cpu_policy_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 */
};
/*
* 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 */
};
/*
* Request a particular record from the HVM context
*/
/* XEN_DOMCTL_gethvmcontext_partial */
<a name="Struct_xen_domctl_hvmcontext_partial"><strong>struct xen_domctl_hvmcontext_partial</strong></a> {
uint32_t type; /* IN: Type of record required */
uint32_t instance; /* IN: Instance of that type */
uint64_aligned_t bufsz; /* IN: size of buffer */
XEN_GUEST_HANDLE_64(uint8) buffer; /* OUT: buffer to write record into */
};
/* XEN_DOMCTL_disable_migrate */
<a name="Struct_xen_domctl_disable_migrate"><strong>struct xen_domctl_disable_migrate</strong></a> {
uint32_t disable; /* IN: 1: disable migration and restore */
};
/* XEN_DOMCTL_gettscinfo */
/* XEN_DOMCTL_settscinfo */
<a name="Struct_xen_domctl_tsc_info"><strong>struct xen_domctl_tsc_info</strong></a> {
/* IN/OUT */
uint32_t tsc_mode;
uint32_t gtsc_khz;
uint32_t incarnation;
uint32_t pad;
uint64_aligned_t elapsed_nsec;
};
/* 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? */
};
/*
* VM event operations
*/
/* XEN_DOMCTL_vm_event_op */
/*
* There are currently three rings available for VM events:
* sharing, monitor and paging. This hypercall allows one to
* control these rings (enable/disable), as well as to signal
* to the hypervisor to pull responses (resume) from the given
* ring.
*/
#define XEN_VM_EVENT_ENABLE 0
#define XEN_VM_EVENT_DISABLE 1
#define XEN_VM_EVENT_RESUME 2
/*
* 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_VM_EVENT_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_VM_EVENT_OP_PAGING 1
/*
* Monitor helper.
*
* As with paging, use the domctl for teardown/setup of the
* helper<->hypervisor interface.
*
* The monitor interface can be used to register for various VM events. For
* example, 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. The memory event handler can then resume the
* VCPU and redo the access with a XEN_VM_EVENT_RESUME option.
*
* See public/vm_event.h for the list of available events that can be
* subscribed to via the monitor interface.
*
* The XEN_VM_EVENT_MONITOR_* domctls returns
* 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_VM_EVENT_OP_MONITOR 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_VM_EVENT_OP_SHARING 3
/* Use for teardown/setup of helper<->hypervisor interface for paging,
* access and sharing.*/
<a name="Struct_xen_domctl_vm_event_op"><strong>struct xen_domctl_vm_event_op</strong></a> {
uint32_t op; /* XEN_VM_EVENT_* */
uint32_t mode; /* XEN_DOMCTL_VM_EVENT_OP_* */
uint32_t port; /* OUT: event channel for ring */
};
/*
* 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;
};
<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;
};
<a name="Struct_xen_domctl_set_virq_handler"><strong>struct xen_domctl_set_virq_handler</strong></a> {
uint32_t virq; /* IN */
};
#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;
};
#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;
};
<a name="Struct_xen_domctl_set_broken_page_p2m"><strong>struct xen_domctl_set_broken_page_p2m</strong></a> {
uint64_aligned_t pfn;
};
/*
* 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. */
<a href="include,public,arch-arm.h.html#Typedef_xen_pfn_t">xen_pfn_t</a> start_pfn, nr_pfns;
};
#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 */
};
#endif
/* XEN_DOMCTL_setvnumainfo: specifies a virtual NUMA topology for the guest */
<a name="Struct_xen_domctl_vnuma"><strong>struct xen_domctl_vnuma</strong></a> {
/* IN: number of vNUMA nodes to setup. Shall be greater than 0 */
uint32_t nr_vnodes;
/* IN: number of memory ranges to setup */
uint32_t nr_vmemranges;
/*
* IN: number of vCPUs of the domain (used as size of the vcpu_to_vnode
* array declared below). Shall be equal to the domain's max_vcpus.
*/
uint32_t nr_vcpus;
uint32_t pad; /* must be zero */
/*
* IN: array for specifying the distances of the vNUMA nodes
* between each others. Shall have nr_vnodes*nr_vnodes elements.
*/
XEN_GUEST_HANDLE_64(uint) vdistance;
/*
* IN: array for specifying to what vNUMA node each vCPU belongs.
* Shall have nr_vcpus elements.
*/
XEN_GUEST_HANDLE_64(uint) vcpu_to_vnode;
/*
* IN: array for specifying on what physical NUMA node each vNUMA
* node is placed. Shall have nr_vnodes elements.
*/
XEN_GUEST_HANDLE_64(uint) vnode_to_pnode;
/*
* IN: array for specifying the memory ranges. Shall have
* nr_vmemranges elements.
*/
XEN_GUEST_HANDLE_64(<a href="include,public,memory.h.html#Struct_xen_vmemrange">xen_vmemrange_t</a>) vmemrange;
};
<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;
};
/* XEN_DOMCTL_MONITOR_*
*
* Enable/disable monitoring various VM events.
* This domctl configures what events will be reported to helper apps
* via the ring buffer "MONITOR". The ring has to be first enabled
* with the domctl XEN_DOMCTL_VM_EVENT_OP_MONITOR.
*
* GET_CAPABILITIES can be used to determine which of these features is
* available on a given platform.
*
* NOTICE: mem_access events are also delivered via the "MONITOR" ring buffer;
* however, enabling/disabling those events is performed with the use of
* memory_op hypercalls!
*/
#define XEN_DOMCTL_MONITOR_OP_ENABLE 0
#define XEN_DOMCTL_MONITOR_OP_DISABLE 1
#define XEN_DOMCTL_MONITOR_OP_GET_CAPABILITIES 2
#define XEN_DOMCTL_MONITOR_OP_EMULATE_EACH_REP 3
#define XEN_DOMCTL_MONITOR_EVENT_WRITE_CTRLREG 0
#define XEN_DOMCTL_MONITOR_EVENT_MOV_TO_MSR 1
#define XEN_DOMCTL_MONITOR_EVENT_SINGLESTEP 2
#define XEN_DOMCTL_MONITOR_EVENT_SOFTWARE_BREAKPOINT 3
#define XEN_DOMCTL_MONITOR_EVENT_GUEST_REQUEST 4
#define XEN_DOMCTL_MONITOR_EVENT_DEBUG_EXCEPTION 5
#define XEN_DOMCTL_MONITOR_EVENT_CPUID 6
#define XEN_DOMCTL_MONITOR_EVENT_PRIVILEGED_CALL 7
#define XEN_DOMCTL_MONITOR_EVENT_INTERRUPT 8
#define XEN_DOMCTL_MONITOR_EVENT_DESC_ACCESS 9
#define XEN_DOMCTL_MONITOR_EVENT_EMUL_UNIMPLEMENTED 10
/* Enabled by default */
#define XEN_DOMCTL_MONITOR_EVENT_INGUEST_PAGEFAULT 11
<a name="Struct_xen_domctl_monitor_op"><strong>struct xen_domctl_monitor_op</strong></a> {
uint32_t op; /* XEN_DOMCTL_MONITOR_OP_* */
/*
* When used with ENABLE/DISABLE this has to be set to
* the requested XEN_DOMCTL_MONITOR_EVENT_* value.
* With GET_CAPABILITIES this field returns a bitmap of
* events supported by the platform, in the format
* (1 << XEN_DOMCTL_MONITOR_EVENT_*).
*/
uint32_t event;
/*
* Further options when issuing XEN_DOMCTL_MONITOR_OP_ENABLE.
*/
union {
struct {
/* Which control register */
uint8_t index;
/* Pause vCPU until response */
uint8_t sync;
/* Send event only on a change of value */
uint8_t onchangeonly;
/* Allignment padding */
uint8_t pad1;
uint32_t pad2;
/*
* Send event only if the changed bit in the control register
* is not masked.
*/
uint64_aligned_t bitmask;
} mov_to_cr;
struct {
uint32_t msr;
/* Send event only on a change of value */
uint8_t onchangeonly;
} mov_to_msr;
struct {
/* Pause vCPU until response */
uint8_t sync;
uint8_t allow_userspace;
} guest_request;
struct {
/* Pause vCPU until response */
uint8_t sync;
} debug_exception;
} u;
};
<a name="Struct_xen_domctl_psr_alloc"><strong>struct xen_domctl_psr_alloc</strong></a> {
#define XEN_DOMCTL_PSR_SET_L3_CBM 0
#define XEN_DOMCTL_PSR_GET_L3_CBM 1
#define XEN_DOMCTL_PSR_SET_L3_CODE 2
#define XEN_DOMCTL_PSR_SET_L3_DATA 3
#define XEN_DOMCTL_PSR_GET_L3_CODE 4
#define XEN_DOMCTL_PSR_GET_L3_DATA 5
#define XEN_DOMCTL_PSR_SET_L2_CBM 6
#define XEN_DOMCTL_PSR_GET_L2_CBM 7
#define XEN_DOMCTL_PSR_SET_MBA_THRTL 8
#define XEN_DOMCTL_PSR_GET_MBA_THRTL 9
uint32_t cmd; /* IN: XEN_DOMCTL_PSR_* */
uint32_t target; /* IN */
uint64_t data; /* IN/OUT */
};
/* XEN_DOMCTL_vuart_op */
<a name="Struct_xen_domctl_vuart_op"><strong>struct xen_domctl_vuart_op</strong></a> {
#define XEN_DOMCTL_VUART_OP_INIT 0
uint32_t cmd; /* XEN_DOMCTL_VUART_OP_* */
#define XEN_DOMCTL_VUART_TYPE_VPL011 0
uint32_t type; /* IN - type of vuart.
* Currently only vpl011 supported.
*/
uint64_aligned_t gfn; /* IN - guest gfn to be used as a
* ring buffer.
*/
<a href="include,public,xen.h.html#Typedef_domid_t">domid_t</a> console_domid; /* IN - domid of domain running the
* backend console.
*/
uint8_t pad[2];
<a href="include,public,event_channel.h.html#Typedef_evtchn_port_t">evtchn_port_t</a> evtchn; /* OUT - remote port of the event
* channel used for sending
* ring buffer events.
*/
};
<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 Removed */
/* #define XEN_DOMCTL_getpageframeinfo 7 Obsolete - use getpageframeinfo3 */
/* #define XEN_DOMCTL_getpageframeinfo2 8 Obsolete - use getpageframeinfo3 */
#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 Removed - use dmop */
#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_vm_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 - Moved into XEN_DOMCTL_createdomain */
#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_monitor_op 77
#define XEN_DOMCTL_psr_alloc 78
#define XEN_DOMCTL_soft_reset 79
/* #define XEN_DOMCTL_set_gnttab_limits 80 - Moved into XEN_DOMCTL_createdomain */
#define XEN_DOMCTL_vuart_op 81
#define XEN_DOMCTL_get_cpu_policy 82
#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;
<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_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;
<a href="include,public,domctl.h.html#Struct_xen_domctl_disable_migrate">struct xen_domctl_disable_migrate</a> disable_migrate;
<a href="include,public,domctl.h.html#Struct_xen_domctl_tsc_info">struct xen_domctl_tsc_info</a> tsc_info;
<a href="include,public,domctl.h.html#Struct_xen_domctl_hvmcontext">struct xen_domctl_hvmcontext</a> hvmcontext;
<a href="include,public,domctl.h.html#Struct_xen_domctl_hvmcontext_partial">struct xen_domctl_hvmcontext_partial</a> hvmcontext_partial;
<a href="include,public,domctl.h.html#Struct_xen_domctl_address_size">struct xen_domctl_address_size</a> 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_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_vm_event_op">struct xen_domctl_vm_event_op</a> vm_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_cpu_policy">struct xen_domctl_cpu_policy</a> cpu_policy;
<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_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;
<a href="include,public,domctl.h.html#Struct_xen_domctl_monitor_op">struct xen_domctl_monitor_op</a> monitor_op;
<a href="include,public,domctl.h.html#Struct_xen_domctl_psr_alloc">struct xen_domctl_psr_alloc</a> psr_alloc;
<a href="include,public,domctl.h.html#Struct_xen_domctl_vuart_op">struct xen_domctl_vuart_op</a> vuart_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>
