The Design and Implementation of the FreeBSD Operating System, Second Edition
Now available: The Design and Implementation of the FreeBSD Operating System (Second Edition)


[ source navigation ] [ diff markup ] [ identifier search ] [ freetext search ] [ file search ] [ list types ] [ track identifier ]

FreeBSD/Linux Kernel Cross Reference
sys/xen/interface/domctl.h

Version: -  FREEBSD  -  FREEBSD-13-STABLE  -  FREEBSD-13-0  -  FREEBSD-12-STABLE  -  FREEBSD-12-0  -  FREEBSD-11-STABLE  -  FREEBSD-11-0  -  FREEBSD-10-STABLE  -  FREEBSD-10-0  -  FREEBSD-9-STABLE  -  FREEBSD-9-0  -  FREEBSD-8-STABLE  -  FREEBSD-8-0  -  FREEBSD-7-STABLE  -  FREEBSD-7-0  -  FREEBSD-6-STABLE  -  FREEBSD-6-0  -  FREEBSD-5-STABLE  -  FREEBSD-5-0  -  FREEBSD-4-STABLE  -  FREEBSD-3-STABLE  -  FREEBSD22  -  l41  -  OPENBSD  -  linux-2.6  -  MK84  -  PLAN9  -  xnu-8792 
SearchContext: -  none  -  3  -  10 

    1 /******************************************************************************
    2  * domctl.h
    3  * 
    4  * Domain management operations. For use by node control stack.
    5  * 
    6  * Permission is hereby granted, free of charge, to any person obtaining a copy
    7  * of this software and associated documentation files (the "Software"), to
    8  * deal in the Software without restriction, including without limitation the
    9  * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
   10  * sell copies of the Software, and to permit persons to whom the Software is
   11  * furnished to do so, subject to the following conditions:
   12  *
   13  * The above copyright notice and this permission notice shall be included in
   14  * all copies or substantial portions of the Software.
   15  *
   16  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
   17  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
   18  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
   19  * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
   20  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
   21  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
   22  * DEALINGS IN THE SOFTWARE.
   23  *
   24  * Copyright (c) 2002-2003, B Dragovic
   25  * Copyright (c) 2002-2006, K Fraser
   26  */
   27 
   28 #ifndef __XEN_PUBLIC_DOMCTL_H__
   29 #define __XEN_PUBLIC_DOMCTL_H__
   30 
   31 #if !defined(__XEN__) && !defined(__XEN_TOOLS__)
   32 #error "domctl operations are intended for use by node control tools only"
   33 #endif
   34 
   35 #include "xen.h"
   36 
   37 #define XEN_DOMCTL_INTERFACE_VERSION 0x00000005
   38 
   39 struct xenctl_cpumap {
   40     XEN_GUEST_HANDLE_64(uint8_t) bitmap;
   41     uint32_t nr_cpus;
   42 };
   43 
   44 /*
   45  * NB. xen_domctl.domain is an IN/OUT parameter for this operation.
   46  * If it is specified as zero, an id is auto-allocated and returned.
   47  */
   48 #define XEN_DOMCTL_createdomain       1
   49 struct xen_domctl_createdomain {
   50     /* IN parameters */
   51     uint32_t ssidref;
   52     xen_domain_handle_t handle;
   53  /* Is this an HVM guest (as opposed to a PV guest)? */
   54 #define _XEN_DOMCTL_CDF_hvm_guest 0
   55 #define XEN_DOMCTL_CDF_hvm_guest  (1U<<_XEN_DOMCTL_CDF_hvm_guest)
   56  /* Use hardware-assisted paging if available? */
   57 #define _XEN_DOMCTL_CDF_hap       1
   58 #define XEN_DOMCTL_CDF_hap        (1U<<_XEN_DOMCTL_CDF_hap)
   59     uint32_t flags;
   60 };
   61 typedef struct xen_domctl_createdomain xen_domctl_createdomain_t;
   62 DEFINE_XEN_GUEST_HANDLE(xen_domctl_createdomain_t);
   63 
   64 #define XEN_DOMCTL_destroydomain      2
   65 #define XEN_DOMCTL_pausedomain        3
   66 #define XEN_DOMCTL_unpausedomain      4
   67 #define XEN_DOMCTL_resumedomain      27
   68 
   69 #define XEN_DOMCTL_getdomaininfo      5
   70 struct xen_domctl_getdomaininfo {
   71     /* OUT variables. */
   72     domid_t  domain;              /* Also echoed in domctl.domain */
   73  /* Domain is scheduled to die. */
   74 #define _XEN_DOMINF_dying     0
   75 #define XEN_DOMINF_dying      (1U<<_XEN_DOMINF_dying)
   76  /* Domain is an HVM guest (as opposed to a PV guest). */
   77 #define _XEN_DOMINF_hvm_guest 1
   78 #define XEN_DOMINF_hvm_guest  (1U<<_XEN_DOMINF_hvm_guest)
   79  /* The guest OS has shut down. */
   80 #define _XEN_DOMINF_shutdown  2
   81 #define XEN_DOMINF_shutdown   (1U<<_XEN_DOMINF_shutdown)
   82  /* Currently paused by control software. */
   83 #define _XEN_DOMINF_paused    3
   84 #define XEN_DOMINF_paused     (1U<<_XEN_DOMINF_paused)
   85  /* Currently blocked pending an event.     */
   86 #define _XEN_DOMINF_blocked   4
   87 #define XEN_DOMINF_blocked    (1U<<_XEN_DOMINF_blocked)
   88  /* Domain is currently running.            */
   89 #define _XEN_DOMINF_running   5
   90 #define XEN_DOMINF_running    (1U<<_XEN_DOMINF_running)
   91  /* Being debugged.  */
   92 #define _XEN_DOMINF_debugged  6
   93 #define XEN_DOMINF_debugged   (1U<<_XEN_DOMINF_debugged)
   94  /* CPU to which this domain is bound.      */
   95 #define XEN_DOMINF_cpumask      255
   96 #define XEN_DOMINF_cpushift       8
   97  /* XEN_DOMINF_shutdown guest-supplied code.  */
   98 #define XEN_DOMINF_shutdownmask 255
   99 #define XEN_DOMINF_shutdownshift 16
  100     uint32_t flags;              /* XEN_DOMINF_* */
  101     uint64_aligned_t tot_pages;
  102     uint64_aligned_t max_pages;
  103     uint64_aligned_t shared_info_frame; /* GMFN of shared_info struct */
  104     uint64_aligned_t cpu_time;
  105     uint32_t nr_online_vcpus;    /* Number of VCPUs currently online. */
  106     uint32_t max_vcpu_id;        /* Maximum VCPUID in use by this domain. */
  107     uint32_t ssidref;
  108     xen_domain_handle_t handle;
  109 };
  110 typedef struct xen_domctl_getdomaininfo xen_domctl_getdomaininfo_t;
  111 DEFINE_XEN_GUEST_HANDLE(xen_domctl_getdomaininfo_t);
  112 
  113 
  114 #define XEN_DOMCTL_getmemlist         6
  115 struct xen_domctl_getmemlist {
  116     /* IN variables. */
  117     /* Max entries to write to output buffer. */
  118     uint64_aligned_t max_pfns;
  119     /* Start index in guest's page list. */
  120     uint64_aligned_t start_pfn;
  121     XEN_GUEST_HANDLE_64(uint64_t) buffer;
  122     /* OUT variables. */
  123     uint64_aligned_t num_pfns;
  124 };
  125 typedef struct xen_domctl_getmemlist xen_domctl_getmemlist_t;
  126 DEFINE_XEN_GUEST_HANDLE(xen_domctl_getmemlist_t);
  127 
  128 
  129 #define XEN_DOMCTL_getpageframeinfo   7
  130 
  131 #define XEN_DOMCTL_PFINFO_LTAB_SHIFT 28
  132 #define XEN_DOMCTL_PFINFO_NOTAB   (0x0U<<28)
  133 #define XEN_DOMCTL_PFINFO_L1TAB   (0x1U<<28)
  134 #define XEN_DOMCTL_PFINFO_L2TAB   (0x2U<<28)
  135 #define XEN_DOMCTL_PFINFO_L3TAB   (0x3U<<28)
  136 #define XEN_DOMCTL_PFINFO_L4TAB   (0x4U<<28)
  137 #define XEN_DOMCTL_PFINFO_LTABTYPE_MASK (0x7U<<28)
  138 #define XEN_DOMCTL_PFINFO_LPINTAB (0x1U<<31)
  139 #define XEN_DOMCTL_PFINFO_XTAB    (0xfU<<28) /* invalid page */
  140 #define XEN_DOMCTL_PFINFO_LTAB_MASK (0xfU<<28)
  141 
  142 struct xen_domctl_getpageframeinfo {
  143     /* IN variables. */
  144     uint64_aligned_t gmfn; /* GMFN to query */
  145     /* OUT variables. */
  146     /* Is the page PINNED to a type? */
  147     uint32_t type;         /* see above type defs */
  148 };
  149 typedef struct xen_domctl_getpageframeinfo xen_domctl_getpageframeinfo_t;
  150 DEFINE_XEN_GUEST_HANDLE(xen_domctl_getpageframeinfo_t);
  151 
  152 
  153 #define XEN_DOMCTL_getpageframeinfo2  8
  154 struct xen_domctl_getpageframeinfo2 {
  155     /* IN variables. */
  156     uint64_aligned_t num;
  157     /* IN/OUT variables. */
  158     XEN_GUEST_HANDLE_64(uint32_t) array;
  159 };
  160 typedef struct xen_domctl_getpageframeinfo2 xen_domctl_getpageframeinfo2_t;
  161 DEFINE_XEN_GUEST_HANDLE(xen_domctl_getpageframeinfo2_t);
  162 
  163 
  164 /*
  165  * Control shadow pagetables operation
  166  */
  167 #define XEN_DOMCTL_shadow_op         10
  168 
  169 /* Disable shadow mode. */
  170 #define XEN_DOMCTL_SHADOW_OP_OFF         0
  171 
  172 /* Enable shadow mode (mode contains ORed XEN_DOMCTL_SHADOW_ENABLE_* flags). */
  173 #define XEN_DOMCTL_SHADOW_OP_ENABLE      32
  174 
  175 /* Log-dirty bitmap operations. */
  176  /* Return the bitmap and clean internal copy for next round. */
  177 #define XEN_DOMCTL_SHADOW_OP_CLEAN       11
  178  /* Return the bitmap but do not modify internal copy. */
  179 #define XEN_DOMCTL_SHADOW_OP_PEEK        12
  180 
  181 /* Memory allocation accessors. */
  182 #define XEN_DOMCTL_SHADOW_OP_GET_ALLOCATION   30
  183 #define XEN_DOMCTL_SHADOW_OP_SET_ALLOCATION   31
  184 
  185 /* Legacy enable operations. */
  186  /* Equiv. to ENABLE with no mode flags. */
  187 #define XEN_DOMCTL_SHADOW_OP_ENABLE_TEST       1
  188  /* Equiv. to ENABLE with mode flag ENABLE_LOG_DIRTY. */
  189 #define XEN_DOMCTL_SHADOW_OP_ENABLE_LOGDIRTY   2
  190  /* Equiv. to ENABLE with mode flags ENABLE_REFCOUNT and ENABLE_TRANSLATE. */
  191 #define XEN_DOMCTL_SHADOW_OP_ENABLE_TRANSLATE  3
  192 
  193 /* Mode flags for XEN_DOMCTL_SHADOW_OP_ENABLE. */
  194  /*
  195   * Shadow pagetables are refcounted: guest does not use explicit mmu
  196   * operations nor write-protect its pagetables.
  197   */
  198 #define XEN_DOMCTL_SHADOW_ENABLE_REFCOUNT  (1 << 1)
  199  /*
  200   * Log pages in a bitmap as they are dirtied.
  201   * Used for live relocation to determine which pages must be re-sent.
  202   */
  203 #define XEN_DOMCTL_SHADOW_ENABLE_LOG_DIRTY (1 << 2)
  204  /*
  205   * Automatically translate GPFNs into MFNs.
  206   */
  207 #define XEN_DOMCTL_SHADOW_ENABLE_TRANSLATE (1 << 3)
  208  /*
  209   * Xen does not steal virtual address space from the guest.
  210   * Requires HVM support.
  211   */
  212 #define XEN_DOMCTL_SHADOW_ENABLE_EXTERNAL  (1 << 4)
  213 
  214 struct xen_domctl_shadow_op_stats {
  215     uint32_t fault_count;
  216     uint32_t dirty_count;
  217 };
  218 typedef struct xen_domctl_shadow_op_stats xen_domctl_shadow_op_stats_t;
  219 DEFINE_XEN_GUEST_HANDLE(xen_domctl_shadow_op_stats_t);
  220 
  221 struct xen_domctl_shadow_op {
  222     /* IN variables. */
  223     uint32_t       op;       /* XEN_DOMCTL_SHADOW_OP_* */
  224 
  225     /* OP_ENABLE */
  226     uint32_t       mode;     /* XEN_DOMCTL_SHADOW_ENABLE_* */
  227 
  228     /* OP_GET_ALLOCATION / OP_SET_ALLOCATION */
  229     uint32_t       mb;       /* Shadow memory allocation in MB */
  230 
  231     /* OP_PEEK / OP_CLEAN */
  232     XEN_GUEST_HANDLE_64(uint8_t) dirty_bitmap;
  233     uint64_aligned_t pages; /* Size of buffer. Updated with actual size. */
  234     struct xen_domctl_shadow_op_stats stats;
  235 };
  236 typedef struct xen_domctl_shadow_op xen_domctl_shadow_op_t;
  237 DEFINE_XEN_GUEST_HANDLE(xen_domctl_shadow_op_t);
  238 
  239 
  240 #define XEN_DOMCTL_max_mem           11
  241 struct xen_domctl_max_mem {
  242     /* IN variables. */
  243     uint64_aligned_t max_memkb;
  244 };
  245 typedef struct xen_domctl_max_mem xen_domctl_max_mem_t;
  246 DEFINE_XEN_GUEST_HANDLE(xen_domctl_max_mem_t);
  247 
  248 
  249 #define XEN_DOMCTL_setvcpucontext    12
  250 #define XEN_DOMCTL_getvcpucontext    13
  251 struct xen_domctl_vcpucontext {
  252     uint32_t              vcpu;                  /* IN */
  253     XEN_GUEST_HANDLE_64(vcpu_guest_context_t) ctxt; /* IN/OUT */
  254 };
  255 typedef struct xen_domctl_vcpucontext xen_domctl_vcpucontext_t;
  256 DEFINE_XEN_GUEST_HANDLE(xen_domctl_vcpucontext_t);
  257 
  258 
  259 #define XEN_DOMCTL_getvcpuinfo       14
  260 struct xen_domctl_getvcpuinfo {
  261     /* IN variables. */
  262     uint32_t vcpu;
  263     /* OUT variables. */
  264     uint8_t  online;                  /* currently online (not hotplugged)? */
  265     uint8_t  blocked;                 /* blocked waiting for an event? */
  266     uint8_t  running;                 /* currently scheduled on its CPU? */
  267     uint64_aligned_t cpu_time;        /* total cpu time consumed (ns) */
  268     uint32_t cpu;                     /* current mapping   */
  269 };
  270 typedef struct xen_domctl_getvcpuinfo xen_domctl_getvcpuinfo_t;
  271 DEFINE_XEN_GUEST_HANDLE(xen_domctl_getvcpuinfo_t);
  272 
  273 
  274 /* Get/set which physical cpus a vcpu can execute on. */
  275 #define XEN_DOMCTL_setvcpuaffinity    9
  276 #define XEN_DOMCTL_getvcpuaffinity   25
  277 struct xen_domctl_vcpuaffinity {
  278     uint32_t  vcpu;              /* IN */
  279     struct xenctl_cpumap cpumap; /* IN/OUT */
  280 };
  281 typedef struct xen_domctl_vcpuaffinity xen_domctl_vcpuaffinity_t;
  282 DEFINE_XEN_GUEST_HANDLE(xen_domctl_vcpuaffinity_t);
  283 
  284 
  285 #define XEN_DOMCTL_max_vcpus         15
  286 struct xen_domctl_max_vcpus {
  287     uint32_t max;           /* maximum number of vcpus */
  288 };
  289 typedef struct xen_domctl_max_vcpus xen_domctl_max_vcpus_t;
  290 DEFINE_XEN_GUEST_HANDLE(xen_domctl_max_vcpus_t);
  291 
  292 
  293 #define XEN_DOMCTL_scheduler_op      16
  294 /* Scheduler types. */
  295 #define XEN_SCHEDULER_SEDF     4
  296 #define XEN_SCHEDULER_CREDIT   5
  297 /* Set or get info? */
  298 #define XEN_DOMCTL_SCHEDOP_putinfo 0
  299 #define XEN_DOMCTL_SCHEDOP_getinfo 1
  300 struct xen_domctl_scheduler_op {
  301     uint32_t sched_id;  /* XEN_SCHEDULER_* */
  302     uint32_t cmd;       /* XEN_DOMCTL_SCHEDOP_* */
  303     union {
  304         struct xen_domctl_sched_sedf {
  305             uint64_aligned_t period;
  306             uint64_aligned_t slice;
  307             uint64_aligned_t latency;
  308             uint32_t extratime;
  309             uint32_t weight;
  310         } sedf;
  311         struct xen_domctl_sched_credit {
  312             uint16_t weight;
  313             uint16_t cap;
  314         } credit;
  315     } u;
  316 };
  317 typedef struct xen_domctl_scheduler_op xen_domctl_scheduler_op_t;
  318 DEFINE_XEN_GUEST_HANDLE(xen_domctl_scheduler_op_t);
  319 
  320 
  321 #define XEN_DOMCTL_setdomainhandle   17
  322 struct xen_domctl_setdomainhandle {
  323     xen_domain_handle_t handle;
  324 };
  325 typedef struct xen_domctl_setdomainhandle xen_domctl_setdomainhandle_t;
  326 DEFINE_XEN_GUEST_HANDLE(xen_domctl_setdomainhandle_t);
  327 
  328 
  329 #define XEN_DOMCTL_setdebugging      18
  330 struct xen_domctl_setdebugging {
  331     uint8_t enable;
  332 };
  333 typedef struct xen_domctl_setdebugging xen_domctl_setdebugging_t;
  334 DEFINE_XEN_GUEST_HANDLE(xen_domctl_setdebugging_t);
  335 
  336 
  337 #define XEN_DOMCTL_irq_permission    19
  338 struct xen_domctl_irq_permission {
  339     uint8_t pirq;
  340     uint8_t allow_access;    /* flag to specify enable/disable of IRQ access */
  341 };
  342 typedef struct xen_domctl_irq_permission xen_domctl_irq_permission_t;
  343 DEFINE_XEN_GUEST_HANDLE(xen_domctl_irq_permission_t);
  344 
  345 
  346 #define XEN_DOMCTL_iomem_permission  20
  347 struct xen_domctl_iomem_permission {
  348     uint64_aligned_t first_mfn;/* first page (physical page number) in range */
  349     uint64_aligned_t nr_mfns;  /* number of pages in range (>0) */
  350     uint8_t  allow_access;     /* allow (!0) or deny (0) access to range? */
  351 };
  352 typedef struct xen_domctl_iomem_permission xen_domctl_iomem_permission_t;
  353 DEFINE_XEN_GUEST_HANDLE(xen_domctl_iomem_permission_t);
  354 
  355 
  356 #define XEN_DOMCTL_ioport_permission 21
  357 struct xen_domctl_ioport_permission {
  358     uint32_t first_port;              /* first port int range */
  359     uint32_t nr_ports;                /* size of port range */
  360     uint8_t  allow_access;            /* allow or deny access to range? */
  361 };
  362 typedef struct xen_domctl_ioport_permission xen_domctl_ioport_permission_t;
  363 DEFINE_XEN_GUEST_HANDLE(xen_domctl_ioport_permission_t);
  364 
  365 
  366 #define XEN_DOMCTL_hypercall_init    22
  367 struct xen_domctl_hypercall_init {
  368     uint64_aligned_t  gmfn;           /* GMFN to be initialised */
  369 };
  370 typedef struct xen_domctl_hypercall_init xen_domctl_hypercall_init_t;
  371 DEFINE_XEN_GUEST_HANDLE(xen_domctl_hypercall_init_t);
  372 
  373 
  374 #define XEN_DOMCTL_arch_setup        23
  375 #define _XEN_DOMAINSETUP_hvm_guest 0
  376 #define XEN_DOMAINSETUP_hvm_guest  (1UL<<_XEN_DOMAINSETUP_hvm_guest)
  377 #define _XEN_DOMAINSETUP_query 1 /* Get parameters (for save)  */
  378 #define XEN_DOMAINSETUP_query  (1UL<<_XEN_DOMAINSETUP_query)
  379 #define _XEN_DOMAINSETUP_sioemu_guest 2
  380 #define XEN_DOMAINSETUP_sioemu_guest  (1UL<<_XEN_DOMAINSETUP_sioemu_guest)
  381 typedef struct xen_domctl_arch_setup {
  382     uint64_aligned_t flags;  /* XEN_DOMAINSETUP_* */
  383 #ifdef __ia64__
  384     uint64_aligned_t bp;     /* mpaddr of boot param area */
  385     uint64_aligned_t maxmem; /* Highest memory address for MDT.  */
  386     uint64_aligned_t xsi_va; /* Xen shared_info area virtual address.  */
  387     uint32_t hypercall_imm;  /* Break imm for Xen hypercalls.  */
  388     int8_t vhpt_size_log2;   /* Log2 of VHPT size. */
  389 #endif
  390 } xen_domctl_arch_setup_t;
  391 DEFINE_XEN_GUEST_HANDLE(xen_domctl_arch_setup_t);
  392 
  393 
  394 #define XEN_DOMCTL_settimeoffset     24
  395 struct xen_domctl_settimeoffset {
  396     int32_t  time_offset_seconds; /* applied to domain wallclock time */
  397 };
  398 typedef struct xen_domctl_settimeoffset xen_domctl_settimeoffset_t;
  399 DEFINE_XEN_GUEST_HANDLE(xen_domctl_settimeoffset_t);
  400 
  401  
  402 #define XEN_DOMCTL_gethvmcontext     33
  403 #define XEN_DOMCTL_sethvmcontext     34
  404 typedef struct xen_domctl_hvmcontext {
  405     uint32_t size; /* IN/OUT: size of buffer / bytes filled */
  406     XEN_GUEST_HANDLE_64(uint8_t) buffer; /* IN/OUT: data, or call
  407                                           * gethvmcontext with NULL
  408                                           * buffer to get size
  409                                           * req'd */
  410 } xen_domctl_hvmcontext_t;
  411 DEFINE_XEN_GUEST_HANDLE(xen_domctl_hvmcontext_t);
  412 
  413 
  414 #define XEN_DOMCTL_set_address_size  35
  415 #define XEN_DOMCTL_get_address_size  36
  416 typedef struct xen_domctl_address_size {
  417     uint32_t size;
  418 } xen_domctl_address_size_t;
  419 DEFINE_XEN_GUEST_HANDLE(xen_domctl_address_size_t);
  420 
  421 
  422 #define XEN_DOMCTL_real_mode_area    26
  423 struct xen_domctl_real_mode_area {
  424     uint32_t log; /* log2 of Real Mode Area size */
  425 };
  426 typedef struct xen_domctl_real_mode_area xen_domctl_real_mode_area_t;
  427 DEFINE_XEN_GUEST_HANDLE(xen_domctl_real_mode_area_t);
  428 
  429 
  430 #define XEN_DOMCTL_sendtrigger       28
  431 #define XEN_DOMCTL_SENDTRIGGER_NMI    0
  432 #define XEN_DOMCTL_SENDTRIGGER_RESET  1
  433 #define XEN_DOMCTL_SENDTRIGGER_INIT   2
  434 struct xen_domctl_sendtrigger {
  435     uint32_t  trigger;  /* IN */
  436     uint32_t  vcpu;     /* IN */
  437 };
  438 typedef struct xen_domctl_sendtrigger xen_domctl_sendtrigger_t;
  439 DEFINE_XEN_GUEST_HANDLE(xen_domctl_sendtrigger_t);
  440 
  441 
  442 /* Assign PCI device to HVM guest. Sets up IOMMU structures. */
  443 #define XEN_DOMCTL_assign_device      37
  444 #define XEN_DOMCTL_test_assign_device 45
  445 #define XEN_DOMCTL_deassign_device 47
  446 struct xen_domctl_assign_device {
  447     uint32_t  machine_bdf;   /* machine PCI ID of assigned device */
  448 };
  449 typedef struct xen_domctl_assign_device xen_domctl_assign_device_t;
  450 DEFINE_XEN_GUEST_HANDLE(xen_domctl_assign_device_t);
  451 
  452 /* Retrieve sibling devices infomation of machine_bdf */
  453 #define XEN_DOMCTL_get_device_group 50
  454 struct xen_domctl_get_device_group {
  455     uint32_t  machine_bdf;      /* IN */
  456     uint32_t  max_sdevs;        /* IN */
  457     uint32_t  num_sdevs;        /* OUT */
  458     XEN_GUEST_HANDLE_64(uint32)  sdev_array;   /* OUT */
  459 };
  460 typedef struct xen_domctl_get_device_group xen_domctl_get_device_group_t;
  461 DEFINE_XEN_GUEST_HANDLE(xen_domctl_get_device_group_t);
  462 
  463 /* Pass-through interrupts: bind real irq -> hvm devfn. */
  464 #define XEN_DOMCTL_bind_pt_irq       38
  465 #define XEN_DOMCTL_unbind_pt_irq     48
  466 typedef enum pt_irq_type_e {
  467     PT_IRQ_TYPE_PCI,
  468     PT_IRQ_TYPE_ISA,
  469     PT_IRQ_TYPE_MSI,
  470 } pt_irq_type_t;
  471 struct xen_domctl_bind_pt_irq {
  472     uint32_t machine_irq;
  473     pt_irq_type_t irq_type;
  474     uint32_t hvm_domid;
  475 
  476     union {
  477         struct {
  478             uint8_t isa_irq;
  479         } isa;
  480         struct {
  481             uint8_t bus;
  482             uint8_t device;
  483             uint8_t intx;
  484         } pci;
  485         struct {
  486             uint8_t gvec;
  487             uint32_t gflags;
  488         } msi;
  489     } u;
  490 };
  491 typedef struct xen_domctl_bind_pt_irq xen_domctl_bind_pt_irq_t;
  492 DEFINE_XEN_GUEST_HANDLE(xen_domctl_bind_pt_irq_t);
  493 
  494 
  495 /* Bind machine I/O address range -> HVM address range. */
  496 #define XEN_DOMCTL_memory_mapping    39
  497 #define DPCI_ADD_MAPPING         1
  498 #define DPCI_REMOVE_MAPPING      0
  499 struct xen_domctl_memory_mapping {
  500     uint64_aligned_t first_gfn; /* first page (hvm guest phys page) in range */
  501     uint64_aligned_t first_mfn; /* first page (machine page) in range */
  502     uint64_aligned_t nr_mfns;   /* number of pages in range (>0) */
  503     uint32_t add_mapping;       /* add or remove mapping */
  504     uint32_t padding;           /* padding for 64-bit aligned structure */
  505 };
  506 typedef struct xen_domctl_memory_mapping xen_domctl_memory_mapping_t;
  507 DEFINE_XEN_GUEST_HANDLE(xen_domctl_memory_mapping_t);
  508 
  509 
  510 /* Bind machine I/O port range -> HVM I/O port range. */
  511 #define XEN_DOMCTL_ioport_mapping    40
  512 struct xen_domctl_ioport_mapping {
  513     uint32_t first_gport;     /* first guest IO port*/
  514     uint32_t first_mport;     /* first machine IO port */
  515     uint32_t nr_ports;        /* size of port range */
  516     uint32_t add_mapping;     /* add or remove mapping */
  517 };
  518 typedef struct xen_domctl_ioport_mapping xen_domctl_ioport_mapping_t;
  519 DEFINE_XEN_GUEST_HANDLE(xen_domctl_ioport_mapping_t);
  520 
  521 
  522 /*
  523  * Pin caching type of RAM space for x86 HVM domU.
  524  */
  525 #define XEN_DOMCTL_pin_mem_cacheattr 41
  526 /* Caching types: these happen to be the same as x86 MTRR/PAT type codes. */
  527 #define XEN_DOMCTL_MEM_CACHEATTR_UC  0
  528 #define XEN_DOMCTL_MEM_CACHEATTR_WC  1
  529 #define XEN_DOMCTL_MEM_CACHEATTR_WT  4
  530 #define XEN_DOMCTL_MEM_CACHEATTR_WP  5
  531 #define XEN_DOMCTL_MEM_CACHEATTR_WB  6
  532 #define XEN_DOMCTL_MEM_CACHEATTR_UCM 7
  533 struct xen_domctl_pin_mem_cacheattr {
  534     uint64_aligned_t start, end;
  535     unsigned int type; /* XEN_DOMCTL_MEM_CACHEATTR_* */
  536 };
  537 typedef struct xen_domctl_pin_mem_cacheattr xen_domctl_pin_mem_cacheattr_t;
  538 DEFINE_XEN_GUEST_HANDLE(xen_domctl_pin_mem_cacheattr_t);
  539 
  540 
  541 #define XEN_DOMCTL_set_ext_vcpucontext 42
  542 #define XEN_DOMCTL_get_ext_vcpucontext 43
  543 struct xen_domctl_ext_vcpucontext {
  544     /* IN: VCPU that this call applies to. */
  545     uint32_t         vcpu;
  546     /*
  547      * SET: Size of struct (IN)
  548      * GET: Size of struct (OUT)
  549      */
  550     uint32_t         size;
  551 #if defined(__i386__) || defined(__x86_64__)
  552     /* SYSCALL from 32-bit mode and SYSENTER callback information. */
  553     /* NB. SYSCALL from 64-bit mode is contained in vcpu_guest_context_t */
  554     uint64_aligned_t syscall32_callback_eip;
  555     uint64_aligned_t sysenter_callback_eip;
  556     uint16_t         syscall32_callback_cs;
  557     uint16_t         sysenter_callback_cs;
  558     uint8_t          syscall32_disables_events;
  559     uint8_t          sysenter_disables_events;
  560 #endif
  561 };
  562 typedef struct xen_domctl_ext_vcpucontext xen_domctl_ext_vcpucontext_t;
  563 DEFINE_XEN_GUEST_HANDLE(xen_domctl_ext_vcpucontext_t);
  564 
  565 /*
  566  * Set optimizaton features for a domain
  567  */
  568 #define XEN_DOMCTL_set_opt_feature    44
  569 struct xen_domctl_set_opt_feature {
  570 #if defined(__ia64__)
  571     struct xen_ia64_opt_feature optf;
  572 #else
  573     /* Make struct non-empty: do not depend on this field name! */
  574     uint64_t dummy;
  575 #endif
  576 };
  577 typedef struct xen_domctl_set_opt_feature xen_domctl_set_opt_feature_t;
  578 DEFINE_XEN_GUEST_HANDLE(xen_domctl_set_opt_feature_t);
  579 
  580 /*
  581  * Set the target domain for a domain
  582  */
  583 #define XEN_DOMCTL_set_target    46
  584 struct xen_domctl_set_target {
  585     domid_t target;
  586 };
  587 typedef struct xen_domctl_set_target xen_domctl_set_target_t;
  588 DEFINE_XEN_GUEST_HANDLE(xen_domctl_set_target_t);
  589 
  590 #if defined(__i386__) || defined(__x86_64__)
  591 # define XEN_CPUID_INPUT_UNUSED  0xFFFFFFFF
  592 # define XEN_DOMCTL_set_cpuid 49
  593 struct xen_domctl_cpuid {
  594   unsigned int  input[2];
  595   unsigned int  eax;
  596   unsigned int  ebx;
  597   unsigned int  ecx;
  598   unsigned int  edx;
  599 };
  600 typedef struct xen_domctl_cpuid xen_domctl_cpuid_t;
  601 DEFINE_XEN_GUEST_HANDLE(xen_domctl_cpuid_t);
  602 #endif
  603 
  604 #define XEN_DOMCTL_subscribe          29
  605 struct xen_domctl_subscribe {
  606     uint32_t port; /* IN */
  607 };
  608 typedef struct xen_domctl_subscribe xen_domctl_subscribe_t;
  609 DEFINE_XEN_GUEST_HANDLE(xen_domctl_subscribe_t);
  610 
  611 /*
  612  * Define the maximum machine address size which should be allocated
  613  * to a guest.
  614  */
  615 #define XEN_DOMCTL_set_machine_address_size  51
  616 #define XEN_DOMCTL_get_machine_address_size  52
  617 
  618 
  619 struct xen_domctl {
  620     uint32_t cmd;
  621     uint32_t interface_version; /* XEN_DOMCTL_INTERFACE_VERSION */
  622     domid_t  domain;
  623     union {
  624         struct xen_domctl_createdomain      createdomain;
  625         struct xen_domctl_getdomaininfo     getdomaininfo;
  626         struct xen_domctl_getmemlist        getmemlist;
  627         struct xen_domctl_getpageframeinfo  getpageframeinfo;
  628         struct xen_domctl_getpageframeinfo2 getpageframeinfo2;
  629         struct xen_domctl_vcpuaffinity      vcpuaffinity;
  630         struct xen_domctl_shadow_op         shadow_op;
  631         struct xen_domctl_max_mem           max_mem;
  632         struct xen_domctl_vcpucontext       vcpucontext;
  633         struct xen_domctl_getvcpuinfo       getvcpuinfo;
  634         struct xen_domctl_max_vcpus         max_vcpus;
  635         struct xen_domctl_scheduler_op      scheduler_op;
  636         struct xen_domctl_setdomainhandle   setdomainhandle;
  637         struct xen_domctl_setdebugging      setdebugging;
  638         struct xen_domctl_irq_permission    irq_permission;
  639         struct xen_domctl_iomem_permission  iomem_permission;
  640         struct xen_domctl_ioport_permission ioport_permission;
  641         struct xen_domctl_hypercall_init    hypercall_init;
  642         struct xen_domctl_arch_setup        arch_setup;
  643         struct xen_domctl_settimeoffset     settimeoffset;
  644         struct xen_domctl_real_mode_area    real_mode_area;
  645         struct xen_domctl_hvmcontext        hvmcontext;
  646         struct xen_domctl_address_size      address_size;
  647         struct xen_domctl_sendtrigger       sendtrigger;
  648         struct xen_domctl_get_device_group  get_device_group;
  649         struct xen_domctl_assign_device     assign_device;
  650         struct xen_domctl_bind_pt_irq       bind_pt_irq;
  651         struct xen_domctl_memory_mapping    memory_mapping;
  652         struct xen_domctl_ioport_mapping    ioport_mapping;
  653         struct xen_domctl_pin_mem_cacheattr pin_mem_cacheattr;
  654         struct xen_domctl_ext_vcpucontext   ext_vcpucontext;
  655         struct xen_domctl_set_opt_feature   set_opt_feature;
  656         struct xen_domctl_set_target        set_target;
  657         struct xen_domctl_subscribe         subscribe;
  658 #if defined(__i386__) || defined(__x86_64__)
  659         struct xen_domctl_cpuid             cpuid;
  660 #endif
  661         uint8_t                             pad[128];
  662     } u;
  663 };
  664 typedef struct xen_domctl xen_domctl_t;
  665 DEFINE_XEN_GUEST_HANDLE(xen_domctl_t);
  666 
  667 #endif /* __XEN_PUBLIC_DOMCTL_H__ */
  668 
  669 /*
  670  * Local variables:
  671  * mode: C
  672  * c-set-style: "BSD"
  673  * c-basic-offset: 4
  674  * tab-width: 4
  675  * indent-tabs-mode: nil
  676  * End:
  677  */

Cache object: b8d3cf4aa6e693827f6cf9d1712988c0


[ source navigation ] [ diff markup ] [ identifier search ] [ freetext search ] [ file search ] [ list types ] [ track identifier ]


This page is part of the FreeBSD/Linux Linux Kernel Cross-Reference, and was automatically generated using a modified version of the LXR engine.