2 * PCI Backend Common Data Structures & Function Declarations
4 * Author: Ryan Wilson <hap9@epoch.ncsc.mil>
6 #ifndef __XEN_PCIBACK_H__
7 #define __XEN_PCIBACK_H__
10 #include <linux/interrupt.h>
11 #include <xen/xenbus.h>
12 #include <linux/list.h>
13 #include <linux/spinlock.h>
14 #include <linux/workqueue.h>
15 #include <linux/atomic.h>
16 #include <xen/interface/io/pciif.h>
18 #define DRV_NAME "xen-pciback"
20 struct pci_dev_entry
{
21 struct list_head list
;
25 #define _PDEVF_op_active (0)
26 #define PDEVF_op_active (1<<(_PDEVF_op_active))
27 #define _PCIB_op_pending (1)
28 #define PCIB_op_pending (1<<(_PCIB_op_pending))
30 struct xen_pcibk_device
{
32 struct mutex dev_lock
;
33 struct xenbus_device
*xdev
;
34 struct xenbus_watch be_watch
;
37 struct xen_pci_sharedinfo
*sh_info
;
39 struct work_struct op_work
;
43 struct xen_pcibk_dev_data
{
44 struct list_head config_fields
;
45 struct pci_saved_state
*pci_saved_state
;
46 unsigned int permissive
:1;
47 unsigned int warned_on_write
:1;
48 unsigned int enable_intx
:1;
49 unsigned int isr_on
:1; /* Whether the IRQ handler is installed. */
50 unsigned int ack_intr
:1; /* .. and ACK-ing */
51 unsigned long handled
;
52 unsigned int irq
; /* Saved in case device transitions to MSI/MSI-X */
53 char irq_name
[0]; /* xen-pcibk[000:04:00.0] */
56 /* Used by XenBus and xen_pcibk_ops.c */
57 extern wait_queue_head_t xen_pcibk_aer_wait_queue
;
58 extern struct workqueue_struct
*xen_pcibk_wq
;
59 /* Used by pcistub.c and conf_space_quirks.c */
60 extern struct list_head xen_pcibk_quirks
;
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
,
66 struct pci_dev
*pcistub_get_pci_dev(struct xen_pcibk_device
*pdev
,
68 void pcistub_put_pci_dev(struct pci_dev
*dev
);
70 /* Ensure a device is turned off or reset */
71 void xen_pcibk_reset_device(struct pci_dev
*pdev
);
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
,
81 int xen_pcibk_config_write(struct pci_dev
*dev
, int offset
, int size
,
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
);
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.
95 struct xen_pcibk_backend
{
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
,
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
,
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
;
116 static inline int xen_pcibk_add_pci_dev(struct xen_pcibk_device
*pdev
,
119 publish_pci_dev_cb publish_cb
)
121 if (xen_pcibk_backend
&& xen_pcibk_backend
->add
)
122 return xen_pcibk_backend
->add(pdev
, dev
, devid
, publish_cb
);
126 static inline void xen_pcibk_release_pci_dev(struct xen_pcibk_device
*pdev
,
127 struct pci_dev
*dev
, bool lock
)
129 if (xen_pcibk_backend
&& xen_pcibk_backend
->release
)
130 return xen_pcibk_backend
->release(pdev
, dev
, lock
);
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
)
137 if (xen_pcibk_backend
&& xen_pcibk_backend
->get
)
138 return xen_pcibk_backend
->get(pdev
, domain
, bus
, devfn
);
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
148 static inline int xen_pcibk_get_pcifront_dev(struct pci_dev
*pcidev
,
149 struct xen_pcibk_device
*pdev
,
150 unsigned int *domain
,
154 if (xen_pcibk_backend
&& xen_pcibk_backend
->find
)
155 return xen_pcibk_backend
->find(pcidev
, pdev
, domain
, bus
,
160 static inline int xen_pcibk_init_devices(struct xen_pcibk_device
*pdev
)
162 if (xen_pcibk_backend
&& xen_pcibk_backend
->init
)
163 return xen_pcibk_backend
->init(pdev
);
167 static inline int xen_pcibk_publish_pci_roots(struct xen_pcibk_device
*pdev
,
168 publish_pci_root_cb cb
)
170 if (xen_pcibk_backend
&& xen_pcibk_backend
->publish
)
171 return xen_pcibk_backend
->publish(pdev
, cb
);
175 static inline void xen_pcibk_release_devices(struct xen_pcibk_device
*pdev
)
177 if (xen_pcibk_backend
&& xen_pcibk_backend
->free
)
178 return xen_pcibk_backend
->free(pdev
);
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
);
185 int xen_pcibk_xenbus_register(void);
186 void xen_pcibk_xenbus_unregister(void);
188 extern int verbose_request
;
190 void xen_pcibk_test_and_schedule_op(struct xen_pcibk_device
*pdev
);
193 /* Handles shared IRQs that can to device domain and control domain. */
194 void xen_pcibk_irq_handler(struct pci_dev
*dev
, int reset
);