root/drivers/xen/xen-pciback/pciback.h

INCLUDED FROM

DEFINITIONS

1. xen_pcibk_add_pci_dev
2. xen_pcibk_release_pci_dev
3. xen_pcibk_get_pci_dev
4. xen_pcibk_get_pcifront_dev
5. xen_pcibk_init_devices
6. xen_pcibk_publish_pci_roots
7. xen_pcibk_release_devices

   1 /* SPDX-License-Identifier: GPL-2.0 */
   2 /*
   3  * PCI Backend Common Data Structures & Function Declarations
   4  *
   5  *   Author: Ryan Wilson <hap9@epoch.ncsc.mil>
   6  */
   7 #ifndef __XEN_PCIBACK_H__
   8 #define __XEN_PCIBACK_H__
   9 
  10 #include <linux/pci.h>
  11 #include <linux/interrupt.h>
  12 #include <xen/xenbus.h>
  13 #include <linux/list.h>
  14 #include <linux/spinlock.h>
  15 #include <linux/workqueue.h>
  16 #include <linux/atomic.h>
  17 #include <xen/interface/io/pciif.h>
  18 
  19 #define DRV_NAME        "xen-pciback"
  20 
  21 struct pci_dev_entry {
  22         struct list_head list;
  23         struct pci_dev *dev;
  24 };
  25 
  26 #define _PDEVF_op_active        (0)
  27 #define PDEVF_op_active         (1<<(_PDEVF_op_active))
  28 #define _PCIB_op_pending        (1)
  29 #define PCIB_op_pending         (1<<(_PCIB_op_pending))
  30 
  31 struct xen_pcibk_device {
  32         void *pci_dev_data;
  33         struct mutex dev_lock;
  34         struct xenbus_device *xdev;
  35         struct xenbus_watch be_watch;
  36         u8 be_watching;
  37         int evtchn_irq;
  38         struct xen_pci_sharedinfo *sh_info;
  39         unsigned long flags;
  40         struct work_struct op_work;
  41         struct xen_pci_op op;
  42 };
  43 
  44 struct xen_pcibk_dev_data {
  45         struct list_head config_fields;
  46         struct pci_saved_state *pci_saved_state;
  47         unsigned int permissive:1;
  48         unsigned int warned_on_write:1;
  49         unsigned int enable_intx:1;
  50         unsigned int isr_on:1; /* Whether the IRQ handler is installed. */
  51         unsigned int ack_intr:1; /* .. and ACK-ing */
  52         unsigned long handled;
  53         unsigned int irq; /* Saved in case device transitions to MSI/MSI-X */
  54         char irq_name[0]; /* xen-pcibk[000:04:00.0] */
  55 };
  56 
  57 /* Used by XenBus and xen_pcibk_ops.c */
  58 extern wait_queue_head_t xen_pcibk_aer_wait_queue;
  59 /* Used by pcistub.c and conf_space_quirks.c */
  60 extern struct list_head xen_pcibk_quirks;
  61 
  62 /* Get/Put PCI Devices that are hidden from the PCI Backend Domain */
  63 struct pci_dev *pcistub_get_pci_dev_by_slot(struct xen_pcibk_device *pdev,
  64                                             int domain, int bus,
  65                                             int slot, int func);
  66 struct pci_dev *pcistub_get_pci_dev(struct xen_pcibk_device *pdev,
  67                                     struct pci_dev *dev);
  68 void pcistub_put_pci_dev(struct pci_dev *dev);
  69 
  70 /* Ensure a device is turned off or reset */
  71 void xen_pcibk_reset_device(struct pci_dev *pdev);
  72 
  73 /* Access a virtual configuration space for a PCI device */
  74 int xen_pcibk_config_init(void);
  75 int xen_pcibk_config_init_dev(struct pci_dev *dev);
  76 void xen_pcibk_config_free_dyn_fields(struct pci_dev *dev);
  77 void xen_pcibk_config_reset_dev(struct pci_dev *dev);
  78 void xen_pcibk_config_free_dev(struct pci_dev *dev);
  79 int xen_pcibk_config_read(struct pci_dev *dev, int offset, int size,
  80                           u32 *ret_val);
  81 int xen_pcibk_config_write(struct pci_dev *dev, int offset, int size,
  82                            u32 value);
  83 
  84 /* Handle requests for specific devices from the frontend */
  85 typedef int (*publish_pci_dev_cb) (struct xen_pcibk_device *pdev,
  86                                    unsigned int domain, unsigned int bus,
  87                                    unsigned int devfn, unsigned int devid);
  88 typedef int (*publish_pci_root_cb) (struct xen_pcibk_device *pdev,
  89                                     unsigned int domain, unsigned int bus);
  90 
  91 /* Backend registration for the two types of BDF representation:
  92  *  vpci - BDFs start at 00
  93  *  passthrough - BDFs are exactly like in the host.
  94  */
  95 struct xen_pcibk_backend {
  96         const char *name;
  97         int (*init)(struct xen_pcibk_device *pdev);
  98         void (*free)(struct xen_pcibk_device *pdev);
  99         int (*find)(struct pci_dev *pcidev, struct xen_pcibk_device *pdev,
 100                     unsigned int *domain, unsigned int *bus,
 101                     unsigned int *devfn);
 102         int (*publish)(struct xen_pcibk_device *pdev, publish_pci_root_cb cb);
 103         void (*release)(struct xen_pcibk_device *pdev, struct pci_dev *dev,
 104                         bool lock);
 105         int (*add)(struct xen_pcibk_device *pdev, struct pci_dev *dev,
 106                    int devid, publish_pci_dev_cb publish_cb);
 107         struct pci_dev *(*get)(struct xen_pcibk_device *pdev,
 108                                unsigned int domain, unsigned int bus,
 109                                unsigned int devfn);
 110 };
 111 
 112 extern const struct xen_pcibk_backend xen_pcibk_vpci_backend;
 113 extern const struct xen_pcibk_backend xen_pcibk_passthrough_backend;
 114 extern const struct xen_pcibk_backend *xen_pcibk_backend;
 115 
 116 static inline int xen_pcibk_add_pci_dev(struct xen_pcibk_device *pdev,
 117                                         struct pci_dev *dev,
 118                                         int devid,
 119                                         publish_pci_dev_cb publish_cb)
 120 {
 121         if (xen_pcibk_backend && xen_pcibk_backend->add)
 122                 return xen_pcibk_backend->add(pdev, dev, devid, publish_cb);
 123         return -1;
 124 }
 125 
 126 static inline void xen_pcibk_release_pci_dev(struct xen_pcibk_device *pdev,
 127                                              struct pci_dev *dev, bool lock)
 128 {
 129         if (xen_pcibk_backend && xen_pcibk_backend->release)
 130                 return xen_pcibk_backend->release(pdev, dev, lock);
 131 }
 132 
 133 static inline struct pci_dev *
 134 xen_pcibk_get_pci_dev(struct xen_pcibk_device *pdev, unsigned int domain,
 135                       unsigned int bus, unsigned int devfn)
 136 {
 137         if (xen_pcibk_backend && xen_pcibk_backend->get)
 138                 return xen_pcibk_backend->get(pdev, domain, bus, devfn);
 139         return NULL;
 140 }
 141 
 142 /**
 143 * Add for domain0 PCIE-AER handling. Get guest domain/bus/devfn in xen_pcibk
 144 * before sending aer request to pcifront, so that guest could identify
 145 * device, coopearte with xen_pcibk to finish aer recovery job if device driver
 146 * has the capability
 147 */
 148 static inline int xen_pcibk_get_pcifront_dev(struct pci_dev *pcidev,
 149                                              struct xen_pcibk_device *pdev,
 150                                              unsigned int *domain,
 151                                              unsigned int *bus,
 152                                              unsigned int *devfn)
 153 {
 154         if (xen_pcibk_backend && xen_pcibk_backend->find)
 155                 return xen_pcibk_backend->find(pcidev, pdev, domain, bus,
 156                                                devfn);
 157         return -1;
 158 }
 159 
 160 static inline int xen_pcibk_init_devices(struct xen_pcibk_device *pdev)
 161 {
 162         if (xen_pcibk_backend && xen_pcibk_backend->init)
 163                 return xen_pcibk_backend->init(pdev);
 164         return -1;
 165 }
 166 
 167 static inline int xen_pcibk_publish_pci_roots(struct xen_pcibk_device *pdev,
 168                                               publish_pci_root_cb cb)
 169 {
 170         if (xen_pcibk_backend && xen_pcibk_backend->publish)
 171                 return xen_pcibk_backend->publish(pdev, cb);
 172         return -1;
 173 }
 174 
 175 static inline void xen_pcibk_release_devices(struct xen_pcibk_device *pdev)
 176 {
 177         if (xen_pcibk_backend && xen_pcibk_backend->free)
 178                 return xen_pcibk_backend->free(pdev);
 179 }
 180 
 181 /* Handles events from front-end */
 182 irqreturn_t xen_pcibk_handle_event(int irq, void *dev_id);
 183 void xen_pcibk_do_op(struct work_struct *data);
 184 
 185 int xen_pcibk_xenbus_register(void);
 186 void xen_pcibk_xenbus_unregister(void);
 187 
 188 extern int verbose_request;
 189 
 190 void xen_pcibk_test_and_schedule_op(struct xen_pcibk_device *pdev);
 191 #endif
 192 
 193 /* Handles shared IRQs that can to device domain and control domain. */
 194 void xen_pcibk_irq_handler(struct pci_dev *dev, int reset);