Commit | Line | Data |
---|---|---|
ec3d41c4 RR |
1 | #ifndef _LINUX_VIRTIO_H |
2 | #define _LINUX_VIRTIO_H | |
3 | /* Everything a virtio driver needs to work with any particular virtio | |
4 | * implementation. */ | |
5 | #include <linux/types.h> | |
6 | #include <linux/scatterlist.h> | |
7 | #include <linux/spinlock.h> | |
8 | #include <linux/device.h> | |
9 | #include <linux/mod_devicetable.h> | |
10 | ||
11 | /** | |
12 | * virtqueue - a queue to register buffers for sending or receiving. | |
13 | * @callback: the function to call when buffers are consumed (can be NULL). | |
ec3d41c4 RR |
14 | * @vdev: the virtio device this queue was created for. |
15 | * @vq_ops: the operations for this virtqueue (see below). | |
16 | * @priv: a pointer for the virtqueue implementation to use. | |
17 | */ | |
18 | struct virtqueue | |
19 | { | |
18445c4d | 20 | void (*callback)(struct virtqueue *vq); |
ec3d41c4 RR |
21 | struct virtio_device *vdev; |
22 | struct virtqueue_ops *vq_ops; | |
23 | void *priv; | |
24 | }; | |
25 | ||
26 | /** | |
27 | * virtqueue_ops - operations for virtqueue abstraction layer | |
28 | * @add_buf: expose buffer to other end | |
29 | * vq: the struct virtqueue we're talking about. | |
30 | * sg: the description of the buffer(s). | |
31 | * out_num: the number of sg readable by other side | |
32 | * in_num: the number of sg which are writable (after readable ones) | |
33 | * data: the token identifying the buffer. | |
34 | * Returns 0 or an error. | |
35 | * @kick: update after add_buf | |
36 | * vq: the struct virtqueue | |
37 | * After one or more add_buf calls, invoke this to kick the other side. | |
38 | * @get_buf: get the next used buffer | |
39 | * vq: the struct virtqueue we're talking about. | |
40 | * len: the length written into the buffer | |
41 | * Returns NULL or the "data" token handed to add_buf. | |
18445c4d RR |
42 | * @disable_cb: disable callbacks |
43 | * vq: the struct virtqueue we're talking about. | |
44 | * @enable_cb: restart callbacks after disable_cb. | |
ec3d41c4 RR |
45 | * vq: the struct virtqueue we're talking about. |
46 | * This returns "false" (and doesn't re-enable) if there are pending | |
47 | * buffers in the queue, to avoid a race. | |
ec3d41c4 RR |
48 | * |
49 | * Locking rules are straightforward: the driver is responsible for | |
50 | * locking. No two operations may be invoked simultaneously. | |
51 | * | |
52 | * All operations can be called in any context. | |
53 | */ | |
54 | struct virtqueue_ops { | |
55 | int (*add_buf)(struct virtqueue *vq, | |
56 | struct scatterlist sg[], | |
57 | unsigned int out_num, | |
58 | unsigned int in_num, | |
59 | void *data); | |
60 | ||
61 | void (*kick)(struct virtqueue *vq); | |
62 | ||
63 | void *(*get_buf)(struct virtqueue *vq, unsigned int *len); | |
64 | ||
18445c4d RR |
65 | void (*disable_cb)(struct virtqueue *vq); |
66 | bool (*enable_cb)(struct virtqueue *vq); | |
ec3d41c4 RR |
67 | }; |
68 | ||
69 | /** | |
70 | * virtio_device - representation of a device using virtio | |
71 | * @index: unique position on the virtio bus | |
72 | * @dev: underlying device. | |
73 | * @id: the device type identification (used to match it with a driver). | |
74 | * @config: the configuration ops for this device. | |
75 | * @priv: private pointer for the driver's use. | |
76 | */ | |
77 | struct virtio_device | |
78 | { | |
79 | int index; | |
80 | struct device dev; | |
81 | struct virtio_device_id id; | |
82 | struct virtio_config_ops *config; | |
83 | void *priv; | |
84 | }; | |
85 | ||
86 | int register_virtio_device(struct virtio_device *dev); | |
87 | void unregister_virtio_device(struct virtio_device *dev); | |
88 | ||
89 | /** | |
90 | * virtio_driver - operations for a virtio I/O driver | |
91 | * @driver: underlying device driver (populate name and owner). | |
92 | * @id_table: the ids serviced by this driver. | |
93 | * @probe: the function to call when a device is found. Returns a token for | |
94 | * remove, or PTR_ERR(). | |
95 | * @remove: the function when a device is removed. | |
f957d1f0 RR |
96 | * @config_changed: optional function to call when the device configuration |
97 | * changes; may be called in interrupt context. | |
ec3d41c4 RR |
98 | */ |
99 | struct virtio_driver { | |
100 | struct device_driver driver; | |
101 | const struct virtio_device_id *id_table; | |
102 | int (*probe)(struct virtio_device *dev); | |
103 | void (*remove)(struct virtio_device *dev); | |
f957d1f0 | 104 | void (*config_changed)(struct virtio_device *dev); |
ec3d41c4 RR |
105 | }; |
106 | ||
107 | int register_virtio_driver(struct virtio_driver *drv); | |
108 | void unregister_virtio_driver(struct virtio_driver *drv); | |
109 | #endif /* _LINUX_VIRTIO_H */ |