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/physdev.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  * Permission is hereby granted, free of charge, to any person obtaining a copy
    3  * of this software and associated documentation files (the "Software"), to
    4  * deal in the Software without restriction, including without limitation the
    5  * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
    6  * sell copies of the Software, and to permit persons to whom the Software is
    7  * furnished to do so, subject to the following conditions:
    8  *
    9  * The above copyright notice and this permission notice shall be included in
   10  * all copies or substantial portions of the Software.
   11  *
   12  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
   13  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
   14  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
   15  * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
   16  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
   17  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
   18  * DEALINGS IN THE SOFTWARE.
   19  */
   20 
   21 #ifndef __XEN_PUBLIC_PHYSDEV_H__
   22 #define __XEN_PUBLIC_PHYSDEV_H__
   23 
   24 #include "xen.h"
   25 
   26 /*
   27  * Prototype for this hypercall is:
   28  *  int physdev_op(int cmd, void *args)
   29  * @cmd  == PHYSDEVOP_??? (physdev operation).
   30  * @args == Operation-specific extra arguments (NULL if none).
   31  */
   32 
   33 /*
   34  * Notify end-of-interrupt (EOI) for the specified IRQ.
   35  * @arg == pointer to physdev_eoi structure.
   36  */
   37 #define PHYSDEVOP_eoi                   12
   38 struct physdev_eoi {
   39     /* IN */
   40     uint32_t irq;
   41 };
   42 typedef struct physdev_eoi physdev_eoi_t;
   43 DEFINE_XEN_GUEST_HANDLE(physdev_eoi_t);
   44 
   45 /*
   46  * Register a shared page for the hypervisor to indicate whether the guest
   47  * must issue PHYSDEVOP_eoi. The semantics of PHYSDEVOP_eoi change slightly
   48  * once the guest used this function in that the associated event channel
   49  * will automatically get unmasked. The page registered is used as a bit
   50  * array indexed by Xen's PIRQ value.
   51  */
   52 #define PHYSDEVOP_pirq_eoi_gmfn_v1       17
   53 /*
   54  * Register a shared page for the hypervisor to indicate whether the
   55  * guest must issue PHYSDEVOP_eoi. This hypercall is very similar to
   56  * PHYSDEVOP_pirq_eoi_gmfn_v1 but it doesn't change the semantics of
   57  * PHYSDEVOP_eoi. The page registered is used as a bit array indexed by
   58  * Xen's PIRQ value.
   59  */
   60 #define PHYSDEVOP_pirq_eoi_gmfn_v2       28
   61 struct physdev_pirq_eoi_gmfn {
   62     /* IN */
   63     xen_pfn_t gmfn;
   64 };
   65 typedef struct physdev_pirq_eoi_gmfn physdev_pirq_eoi_gmfn_t;
   66 DEFINE_XEN_GUEST_HANDLE(physdev_pirq_eoi_gmfn_t);
   67 
   68 /*
   69  * Query the status of an IRQ line.
   70  * @arg == pointer to physdev_irq_status_query structure.
   71  */
   72 #define PHYSDEVOP_irq_status_query       5
   73 struct physdev_irq_status_query {
   74     /* IN */
   75     uint32_t irq;
   76     /* OUT */
   77     uint32_t flags; /* XENIRQSTAT_* */
   78 };
   79 typedef struct physdev_irq_status_query physdev_irq_status_query_t;
   80 DEFINE_XEN_GUEST_HANDLE(physdev_irq_status_query_t);
   81 
   82 /* Need to call PHYSDEVOP_eoi when the IRQ has been serviced? */
   83 #define _XENIRQSTAT_needs_eoi   (0)
   84 #define  XENIRQSTAT_needs_eoi   (1U<<_XENIRQSTAT_needs_eoi)
   85 
   86 /* IRQ shared by multiple guests? */
   87 #define _XENIRQSTAT_shared      (1)
   88 #define  XENIRQSTAT_shared      (1U<<_XENIRQSTAT_shared)
   89 
   90 /*
   91  * Set the current VCPU's I/O privilege level.
   92  * @arg == pointer to physdev_set_iopl structure.
   93  */
   94 #define PHYSDEVOP_set_iopl               6
   95 struct physdev_set_iopl {
   96     /* IN */
   97     uint32_t iopl;
   98 };
   99 typedef struct physdev_set_iopl physdev_set_iopl_t;
  100 DEFINE_XEN_GUEST_HANDLE(physdev_set_iopl_t);
  101 
  102 /*
  103  * Set the current VCPU's I/O-port permissions bitmap.
  104  * @arg == pointer to physdev_set_iobitmap structure.
  105  */
  106 #define PHYSDEVOP_set_iobitmap           7
  107 struct physdev_set_iobitmap {
  108     /* IN */
  109 #if __XEN_INTERFACE_VERSION__ >= 0x00030205
  110     XEN_GUEST_HANDLE(uint8) bitmap;
  111 #else
  112     uint8_t *bitmap;
  113 #endif
  114     uint32_t nr_ports;
  115 };
  116 typedef struct physdev_set_iobitmap physdev_set_iobitmap_t;
  117 DEFINE_XEN_GUEST_HANDLE(physdev_set_iobitmap_t);
  118 
  119 /*
  120  * Read or write an IO-APIC register.
  121  * @arg == pointer to physdev_apic structure.
  122  */
  123 #define PHYSDEVOP_apic_read              8
  124 #define PHYSDEVOP_apic_write             9
  125 struct physdev_apic {
  126     /* IN */
  127     unsigned long apic_physbase;
  128     uint32_t reg;
  129     /* IN or OUT */
  130     uint32_t value;
  131 };
  132 typedef struct physdev_apic physdev_apic_t;
  133 DEFINE_XEN_GUEST_HANDLE(physdev_apic_t);
  134 
  135 /*
  136  * Allocate or free a physical upcall vector for the specified IRQ line.
  137  * @arg == pointer to physdev_irq structure.
  138  */
  139 #define PHYSDEVOP_alloc_irq_vector      10
  140 #define PHYSDEVOP_free_irq_vector       11
  141 struct physdev_irq {
  142     /* IN */
  143     uint32_t irq;
  144     /* IN or OUT */
  145     uint32_t vector;
  146 };
  147 typedef struct physdev_irq physdev_irq_t;
  148 DEFINE_XEN_GUEST_HANDLE(physdev_irq_t);
  149  
  150 #define MAP_PIRQ_TYPE_MSI               0x0
  151 #define MAP_PIRQ_TYPE_GSI               0x1
  152 #define MAP_PIRQ_TYPE_UNKNOWN           0x2
  153 #define MAP_PIRQ_TYPE_MSI_SEG           0x3
  154 
  155 #define PHYSDEVOP_map_pirq               13
  156 struct physdev_map_pirq {
  157     domid_t domid;
  158     /* IN */
  159     int type;
  160     /* IN */
  161     int index;
  162     /* IN or OUT */
  163     int pirq;
  164     /* IN - high 16 bits hold segment for MAP_PIRQ_TYPE_MSI_SEG */
  165     int bus;
  166     /* IN */
  167     int devfn;
  168     /* IN */
  169     int entry_nr;
  170     /* IN */
  171     uint64_t table_base;
  172 };
  173 typedef struct physdev_map_pirq physdev_map_pirq_t;
  174 DEFINE_XEN_GUEST_HANDLE(physdev_map_pirq_t);
  175 
  176 #define PHYSDEVOP_unmap_pirq             14
  177 struct physdev_unmap_pirq {
  178     domid_t domid;
  179     /* IN */
  180     int pirq;
  181 };
  182 
  183 typedef struct physdev_unmap_pirq physdev_unmap_pirq_t;
  184 DEFINE_XEN_GUEST_HANDLE(physdev_unmap_pirq_t);
  185 
  186 #define PHYSDEVOP_manage_pci_add         15
  187 #define PHYSDEVOP_manage_pci_remove      16
  188 struct physdev_manage_pci {
  189     /* IN */
  190     uint8_t bus;
  191     uint8_t devfn;
  192 }; 
  193 
  194 typedef struct physdev_manage_pci physdev_manage_pci_t;
  195 DEFINE_XEN_GUEST_HANDLE(physdev_manage_pci_t);
  196 
  197 #define PHYSDEVOP_restore_msi            19
  198 struct physdev_restore_msi {
  199     /* IN */
  200     uint8_t bus;
  201     uint8_t devfn;
  202 };
  203 typedef struct physdev_restore_msi physdev_restore_msi_t;
  204 DEFINE_XEN_GUEST_HANDLE(physdev_restore_msi_t);
  205 
  206 #define PHYSDEVOP_manage_pci_add_ext     20
  207 struct physdev_manage_pci_ext {
  208     /* IN */
  209     uint8_t bus;
  210     uint8_t devfn;
  211     unsigned is_extfn;
  212     unsigned is_virtfn;
  213     struct {
  214         uint8_t bus;
  215         uint8_t devfn;
  216     } physfn;
  217 };
  218 
  219 typedef struct physdev_manage_pci_ext physdev_manage_pci_ext_t;
  220 DEFINE_XEN_GUEST_HANDLE(physdev_manage_pci_ext_t);
  221 
  222 /*
  223  * Argument to physdev_op_compat() hypercall. Superceded by new physdev_op()
  224  * hypercall since 0x00030202.
  225  */
  226 struct physdev_op {
  227     uint32_t cmd;
  228     union {
  229         struct physdev_irq_status_query      irq_status_query;
  230         struct physdev_set_iopl              set_iopl;
  231         struct physdev_set_iobitmap          set_iobitmap;
  232         struct physdev_apic                  apic_op;
  233         struct physdev_irq                   irq_op;
  234     } u;
  235 };
  236 typedef struct physdev_op physdev_op_t;
  237 DEFINE_XEN_GUEST_HANDLE(physdev_op_t);
  238 
  239 #define PHYSDEVOP_setup_gsi    21
  240 struct physdev_setup_gsi {
  241     int gsi;
  242     /* IN */
  243     uint8_t triggering;
  244     /* IN */
  245     uint8_t polarity;
  246     /* IN */
  247 };
  248 
  249 typedef struct physdev_setup_gsi physdev_setup_gsi_t;
  250 DEFINE_XEN_GUEST_HANDLE(physdev_setup_gsi_t);
  251 
  252 /* leave PHYSDEVOP 22 free */
  253 
  254 /* type is MAP_PIRQ_TYPE_GSI or MAP_PIRQ_TYPE_MSI
  255  * the hypercall returns a free pirq */
  256 #define PHYSDEVOP_get_free_pirq    23
  257 struct physdev_get_free_pirq {
  258     /* IN */ 
  259     int type;
  260     /* OUT */
  261     uint32_t pirq;
  262 };
  263 
  264 typedef struct physdev_get_free_pirq physdev_get_free_pirq_t;
  265 DEFINE_XEN_GUEST_HANDLE(physdev_get_free_pirq_t);
  266 
  267 #define XEN_PCI_MMCFG_RESERVED         0x1
  268 
  269 #define PHYSDEVOP_pci_mmcfg_reserved    24
  270 struct physdev_pci_mmcfg_reserved {
  271     uint64_t address;
  272     uint16_t segment;
  273     uint8_t start_bus;
  274     uint8_t end_bus;
  275     uint32_t flags;
  276 };
  277 typedef struct physdev_pci_mmcfg_reserved physdev_pci_mmcfg_reserved_t;
  278 DEFINE_XEN_GUEST_HANDLE(physdev_pci_mmcfg_reserved_t);
  279 
  280 #define XEN_PCI_DEV_EXTFN              0x1
  281 #define XEN_PCI_DEV_VIRTFN             0x2
  282 #define XEN_PCI_DEV_PXM                0x4
  283 
  284 #define PHYSDEVOP_pci_device_add        25
  285 struct physdev_pci_device_add {
  286     /* IN */
  287     uint16_t seg;
  288     uint8_t bus;
  289     uint8_t devfn;
  290     uint32_t flags;
  291     struct {
  292         uint8_t bus;
  293         uint8_t devfn;
  294     } physfn;
  295 #if defined(__STDC_VERSION__) && __STDC_VERSION__ >= 199901L
  296     uint32_t optarr[];
  297 #elif defined(__GNUC__)
  298     uint32_t optarr[0];
  299 #endif
  300 };
  301 typedef struct physdev_pci_device_add physdev_pci_device_add_t;
  302 DEFINE_XEN_GUEST_HANDLE(physdev_pci_device_add_t);
  303 
  304 #define PHYSDEVOP_pci_device_remove     26
  305 #define PHYSDEVOP_restore_msi_ext       27
  306 struct physdev_pci_device {
  307     /* IN */
  308     uint16_t seg;
  309     uint8_t bus;
  310     uint8_t devfn;
  311 };
  312 typedef struct physdev_pci_device physdev_pci_device_t;
  313 DEFINE_XEN_GUEST_HANDLE(physdev_pci_device_t);
  314 
  315 /*
  316  * Notify that some PIRQ-bound event channels have been unmasked.
  317  * ** This command is obsolete since interface version 0x00030202 and is **
  318  * ** unsupported by newer versions of Xen.                              **
  319  */
  320 #define PHYSDEVOP_IRQ_UNMASK_NOTIFY      4
  321 
  322 /*
  323  * These all-capitals physdev operation names are superceded by the new names
  324  * (defined above) since interface version 0x00030202.
  325  */
  326 #define PHYSDEVOP_IRQ_STATUS_QUERY       PHYSDEVOP_irq_status_query
  327 #define PHYSDEVOP_SET_IOPL               PHYSDEVOP_set_iopl
  328 #define PHYSDEVOP_SET_IOBITMAP           PHYSDEVOP_set_iobitmap
  329 #define PHYSDEVOP_APIC_READ              PHYSDEVOP_apic_read
  330 #define PHYSDEVOP_APIC_WRITE             PHYSDEVOP_apic_write
  331 #define PHYSDEVOP_ASSIGN_VECTOR          PHYSDEVOP_alloc_irq_vector
  332 #define PHYSDEVOP_FREE_VECTOR            PHYSDEVOP_free_irq_vector
  333 #define PHYSDEVOP_IRQ_NEEDS_UNMASK_NOTIFY XENIRQSTAT_needs_eoi
  334 #define PHYSDEVOP_IRQ_SHARED             XENIRQSTAT_shared
  335 
  336 #if __XEN_INTERFACE_VERSION__ < 0x00040200
  337 #define PHYSDEVOP_pirq_eoi_gmfn PHYSDEVOP_pirq_eoi_gmfn_v1
  338 #else
  339 #define PHYSDEVOP_pirq_eoi_gmfn PHYSDEVOP_pirq_eoi_gmfn_v2
  340 #endif
  341 
  342 #endif /* __XEN_PUBLIC_PHYSDEV_H__ */
  343 
  344 /*
  345  * Local variables:
  346  * mode: C
  347  * c-set-style: "BSD"
  348  * c-basic-offset: 4
  349  * tab-width: 4
  350  * indent-tabs-mode: nil
  351  * End:
  352  */

Cache object: 73d18560352e07f65cac07c82c6d55d1


[ 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.