diff options
Diffstat (limited to 'include/linux/virtio.h')
| -rw-r--r-- | include/linux/virtio.h | 75 |
1 files changed, 14 insertions, 61 deletions
diff --git a/include/linux/virtio.h b/include/linux/virtio.h index 4c069d8bd740..d0018d27c281 100644 --- a/include/linux/virtio.h +++ b/include/linux/virtio.h | |||
| @@ -25,70 +25,18 @@ struct virtqueue { | |||
| 25 | void *priv; | 25 | void *priv; |
| 26 | }; | 26 | }; |
| 27 | 27 | ||
| 28 | /** | 28 | int virtqueue_add_buf(struct virtqueue *vq, |
| 29 | * operations for virtqueue | 29 | struct scatterlist sg[], |
| 30 | * virtqueue_add_buf: expose buffer to other end | 30 | unsigned int out_num, |
| 31 | * vq: the struct virtqueue we're talking about. | 31 | unsigned int in_num, |
| 32 | * sg: the description of the buffer(s). | 32 | void *data, |
| 33 | * out_num: the number of sg readable by other side | 33 | gfp_t gfp); |
| 34 | * in_num: the number of sg which are writable (after readable ones) | ||
| 35 | * data: the token identifying the buffer. | ||
| 36 | * gfp: how to do memory allocations (if necessary). | ||
| 37 | * Returns remaining capacity of queue (sg segments) or a negative error. | ||
| 38 | * virtqueue_kick: update after add_buf | ||
| 39 | * vq: the struct virtqueue | ||
| 40 | * After one or more add_buf calls, invoke this to kick the other side. | ||
| 41 | * virtqueue_get_buf: get the next used buffer | ||
| 42 | * vq: the struct virtqueue we're talking about. | ||
| 43 | * len: the length written into the buffer | ||
| 44 | * Returns NULL or the "data" token handed to add_buf. | ||
| 45 | * virtqueue_disable_cb: disable callbacks | ||
| 46 | * vq: the struct virtqueue we're talking about. | ||
| 47 | * Note that this is not necessarily synchronous, hence unreliable and only | ||
| 48 | * useful as an optimization. | ||
| 49 | * virtqueue_enable_cb: restart callbacks after disable_cb. | ||
| 50 | * vq: the struct virtqueue we're talking about. | ||
| 51 | * This re-enables callbacks; it returns "false" if there are pending | ||
| 52 | * buffers in the queue, to detect a possible race between the driver | ||
| 53 | * checking for more work, and enabling callbacks. | ||
| 54 | * virtqueue_enable_cb_delayed: restart callbacks after disable_cb. | ||
| 55 | * vq: the struct virtqueue we're talking about. | ||
| 56 | * This re-enables callbacks but hints to the other side to delay | ||
| 57 | * interrupts until most of the available buffers have been processed; | ||
| 58 | * it returns "false" if there are many pending buffers in the queue, | ||
| 59 | * to detect a possible race between the driver checking for more work, | ||
| 60 | * and enabling callbacks. | ||
| 61 | * virtqueue_detach_unused_buf: detach first unused buffer | ||
| 62 | * vq: the struct virtqueue we're talking about. | ||
| 63 | * Returns NULL or the "data" token handed to add_buf | ||
| 64 | * virtqueue_get_vring_size: return the size of the virtqueue's vring | ||
| 65 | * vq: the struct virtqueue containing the vring of interest. | ||
| 66 | * Returns the size of the vring. | ||
| 67 | * | ||
| 68 | * Locking rules are straightforward: the driver is responsible for | ||
| 69 | * locking. No two operations may be invoked simultaneously, with the exception | ||
| 70 | * of virtqueue_disable_cb. | ||
| 71 | * | ||
| 72 | * All operations can be called in any context. | ||
| 73 | */ | ||
| 74 | 34 | ||
| 75 | int virtqueue_add_buf_gfp(struct virtqueue *vq, | 35 | void virtqueue_kick(struct virtqueue *vq); |
| 76 | struct scatterlist sg[], | ||
| 77 | unsigned int out_num, | ||
| 78 | unsigned int in_num, | ||
| 79 | void *data, | ||
| 80 | gfp_t gfp); | ||
| 81 | 36 | ||
| 82 | static inline int virtqueue_add_buf(struct virtqueue *vq, | 37 | bool virtqueue_kick_prepare(struct virtqueue *vq); |
| 83 | struct scatterlist sg[], | ||
| 84 | unsigned int out_num, | ||
| 85 | unsigned int in_num, | ||
| 86 | void *data) | ||
| 87 | { | ||
| 88 | return virtqueue_add_buf_gfp(vq, sg, out_num, in_num, data, GFP_ATOMIC); | ||
| 89 | } | ||
| 90 | 38 | ||
| 91 | void virtqueue_kick(struct virtqueue *vq); | 39 | void virtqueue_notify(struct virtqueue *vq); |
| 92 | 40 | ||
| 93 | void *virtqueue_get_buf(struct virtqueue *vq, unsigned int *len); | 41 | void *virtqueue_get_buf(struct virtqueue *vq, unsigned int *len); |
| 94 | 42 | ||
| @@ -146,6 +94,11 @@ struct virtio_driver { | |||
| 146 | int (*probe)(struct virtio_device *dev); | 94 | int (*probe)(struct virtio_device *dev); |
| 147 | void (*remove)(struct virtio_device *dev); | 95 | void (*remove)(struct virtio_device *dev); |
| 148 | void (*config_changed)(struct virtio_device *dev); | 96 | void (*config_changed)(struct virtio_device *dev); |
| 97 | #ifdef CONFIG_PM | ||
| 98 | int (*freeze)(struct virtio_device *dev); | ||
| 99 | int (*thaw)(struct virtio_device *dev); | ||
| 100 | int (*restore)(struct virtio_device *dev); | ||
| 101 | #endif | ||
| 149 | }; | 102 | }; |
| 150 | 103 | ||
| 151 | int register_virtio_driver(struct virtio_driver *drv); | 104 | int register_virtio_driver(struct virtio_driver *drv); |
