virtio_config.h 7.9 KB
Newer Older
R
Rusty Russell 已提交
1 2
#ifndef _LINUX_VIRTIO_CONFIG_H
#define _LINUX_VIRTIO_CONFIG_H
3
/* This header, excluding the #ifdef __KERNEL__ part, is BSD licensed so
4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27
 * anyone can use the definitions to implement compatible drivers/servers.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 * 2. Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in the
 *    documentation and/or other materials provided with the distribution.
 * 3. Neither the name of IBM nor the names of its contributors
 *    may be used to endorse or promote products derived from this software
 *    without specific prior written permission.
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS ``AS IS'' AND
 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 * ARE DISCLAIMED.  IN NO EVENT SHALL IBM OR CONTRIBUTORS BE LIABLE
 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 * SUCH DAMAGE. */
28

R
Rusty Russell 已提交
29 30 31 32 33
/* Virtio devices use a standardized configuration space to define their
 * features and pass configuration information, but each implementation can
 * store and access that space differently. */
#include <linux/types.h>

34
/* Status byte for guest to report progress, and synchronize features. */
R
Rusty Russell 已提交
35 36 37 38 39 40 41 42 43
/* We have seen device and processed generic fields (VIRTIO_CONFIG_F_VIRTIO) */
#define VIRTIO_CONFIG_S_ACKNOWLEDGE	1
/* We have found a driver for the device. */
#define VIRTIO_CONFIG_S_DRIVER		2
/* Driver has used its parts of the config, and is happy */
#define VIRTIO_CONFIG_S_DRIVER_OK	4
/* We've given up on this device. */
#define VIRTIO_CONFIG_S_FAILED		0x80

44 45 46 47 48 49
/* Some virtio feature bits (currently bits 28 through 31) are reserved for the
 * transport being used (eg. virtio_ring), the rest are per-device feature
 * bits. */
#define VIRTIO_TRANSPORT_F_START	28
#define VIRTIO_TRANSPORT_F_END		32

R
Rusty Russell 已提交
50 51 52 53
/* Do we get callbacks when the ring is completely used, even if we've
 * suppressed them? */
#define VIRTIO_F_NOTIFY_ON_EMPTY	24

R
Rusty Russell 已提交
54
#ifdef __KERNEL__
55
#include <linux/err.h>
56
#include <linux/bug.h>
57
#include <linux/virtio.h>
R
Rusty Russell 已提交
58 59 60

/**
 * virtio_config_ops - operations for configuring a virtio device
61
 * @get: read the value of a configuration field
R
Rusty Russell 已提交
62
 *	vdev: the virtio_device
63
 *	offset: the offset of the configuration field
R
Rusty Russell 已提交
64
 *	buf: the buffer to write the field value into.
65 66
 *	len: the length of the buffer
 * @set: write the value of a configuration field
R
Rusty Russell 已提交
67
 *	vdev: the virtio_device
68
 *	offset: the offset of the configuration field
R
Rusty Russell 已提交
69
 *	buf: the buffer to read the field value from.
70
 *	len: the length of the buffer
R
Rusty Russell 已提交
71 72 73 74 75 76
 * @get_status: read the status byte
 *	vdev: the virtio_device
 *	Returns the status byte
 * @set_status: write the status byte
 *	vdev: the virtio_device
 *	status: the new status byte
R
Rusty Russell 已提交
77 78 79
 * @reset: reset the device
 *	vdev: the virtio device
 *	After this, status and feature negotiation must be done again
80 81
 *	Device must not be reset from its vq/config callbacks, or in
 *	parallel with being added/removed.
82
 * @find_vqs: find virtqueues and instantiate them.
R
Rusty Russell 已提交
83
 *	vdev: the virtio_device
84 85 86 87 88 89
 *	nvqs: the number of virtqueues to find
 *	vqs: on success, includes new virtqueues
 *	callbacks: array of callbacks, for each virtqueue
 *	names: array of virtqueue names (mainly for debugging)
 *	Returns 0 on success or error status
 * @del_vqs: free virtqueues found by find_vqs().
90 91 92
 * @get_features: get the array of feature bits for this device.
 *	vdev: the virtio_device
 *	Returns the first 32 feature bits (all we currently need).
93
 * @finalize_features: confirm what device features we'll be using.
94
 *	vdev: the virtio_device
95 96
 *	This gives the final feature bits for the device: it can change
 *	the dev->feature bits if it wants.
97 98 99 100
 * @bus_name: return the bus name associated with the device
 *	vdev: the virtio_device
 *      This returns a pointer to the bus name a la pci_name from which
 *      the caller can then copy.
101
 * @set_vq_affinity: set the affinity for a virtqueue.
R
Rusty Russell 已提交
102
 */
103
typedef void vq_callback_t(struct virtqueue *);
104
struct virtio_config_ops {
105
	void (*get)(struct virtio_device *vdev, unsigned offset,
R
Rusty Russell 已提交
106
		    void *buf, unsigned len);
107
	void (*set)(struct virtio_device *vdev, unsigned offset,
R
Rusty Russell 已提交
108 109 110
		    const void *buf, unsigned len);
	u8 (*get_status)(struct virtio_device *vdev);
	void (*set_status)(struct virtio_device *vdev, u8 status);
R
Rusty Russell 已提交
111
	void (*reset)(struct virtio_device *vdev);
112 113 114 115 116
	int (*find_vqs)(struct virtio_device *, unsigned nvqs,
			struct virtqueue *vqs[],
			vq_callback_t *callbacks[],
			const char *names[]);
	void (*del_vqs)(struct virtio_device *);
117
	u32 (*get_features)(struct virtio_device *vdev);
118
	void (*finalize_features)(struct virtio_device *vdev);
119
	const char *(*bus_name)(struct virtio_device *vdev);
120
	int (*set_vq_affinity)(struct virtqueue *vq, int cpu);
R
Rusty Russell 已提交
121 122
};

123 124 125 126 127 128 129 130 131 132 133 134 135
/* If driver didn't advertise the feature, it will never appear. */
void virtio_check_driver_offered_feature(const struct virtio_device *vdev,
					 unsigned int fbit);

/**
 * virtio_has_feature - helper to determine if this device has this feature.
 * @vdev: the device
 * @fbit: the feature bit
 */
static inline bool virtio_has_feature(const struct virtio_device *vdev,
				      unsigned int fbit)
{
	/* Did you forget to fix assumptions on max features? */
R
Rusty Russell 已提交
136 137 138 139
	if (__builtin_constant_p(fbit))
		BUILD_BUG_ON(fbit >= 32);
	else
		BUG_ON(fbit >= 32);
140

141 142 143
	if (fbit < VIRTIO_TRANSPORT_F_START)
		virtio_check_driver_offered_feature(vdev, fbit);

144 145 146
	return test_bit(fbit, vdev->features);
}

R
Rusty Russell 已提交
147
/**
148
 * virtio_config_val - look for a feature and get a virtio config entry.
149 150 151
 * @vdev: the virtio device
 * @fbit: the feature bit
 * @offset: the type to search for.
C
Chen Baozi 已提交
152
 * @v: a pointer to the value to fill in.
R
Rusty Russell 已提交
153
 *
154
 * The return value is -ENOENT if the feature doesn't exist.  Otherwise
155 156
 * the config value is copied into whatever is pointed to by v. */
#define virtio_config_val(vdev, fbit, offset, v) \
157
	virtio_config_buf((vdev), (fbit), (offset), (v), sizeof(*v))
R
Rusty Russell 已提交
158

159 160 161
#define virtio_config_val_len(vdev, fbit, offset, v, len) \
	virtio_config_buf((vdev), (fbit), (offset), (v), (len))

162 163 164 165 166
static inline int virtio_config_buf(struct virtio_device *vdev,
				    unsigned int fbit,
				    unsigned int offset,
				    void *buf, unsigned len)
{
167
	if (!virtio_has_feature(vdev, fbit))
168 169 170 171 172
		return -ENOENT;

	vdev->config->get(vdev, offset, buf, len);
	return 0;
}
173 174 175 176 177 178 179 180 181 182 183 184 185

static inline
struct virtqueue *virtio_find_single_vq(struct virtio_device *vdev,
					vq_callback_t *c, const char *n)
{
	vq_callback_t *callbacks[] = { c };
	const char *names[] = { n };
	struct virtqueue *vq;
	int err = vdev->config->find_vqs(vdev, 1, &vq, callbacks, names);
	if (err < 0)
		return ERR_PTR(err);
	return vq;
}
186 187 188 189 190 191 192 193 194

static inline
const char *virtio_bus_name(struct virtio_device *vdev)
{
	if (!vdev->config->bus_name)
		return "virtio";
	return vdev->config->bus_name(vdev);
}

195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213
/**
 * virtqueue_set_affinity - setting affinity for a virtqueue
 * @vq: the virtqueue
 * @cpu: the cpu no.
 *
 * Pay attention the function are best-effort: the affinity hint may not be set
 * due to config support, irq type and sharing.
 *
 */
static inline
int virtqueue_set_affinity(struct virtqueue *vq, int cpu)
{
	struct virtio_device *vdev = vq->vdev;
	if (vdev->config->set_vq_affinity)
		return vdev->config->set_vq_affinity(vq, cpu);
	return 0;
}


R
Rusty Russell 已提交
214 215
#endif /* __KERNEL__ */
#endif /* _LINUX_VIRTIO_CONFIG_H */