virtio_config.h 3.8 KB
Newer Older
R
Rusty Russell 已提交
1 2 3 4 5 6 7
#ifndef _LINUX_VIRTIO_CONFIG_H
#define _LINUX_VIRTIO_CONFIG_H
/* 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>

8
/* Status byte for guest to report progress, and synchronize features. */
R
Rusty Russell 已提交
9 10 11 12 13 14 15 16 17 18 19 20 21 22
/* 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

#ifdef __KERNEL__
struct virtio_device;

/**
 * virtio_config_ops - operations for configuring a virtio device
23
 * @feature: search for a feature in this config
R
Rusty Russell 已提交
24
 *	vdev: the virtio_device
25 26 27 28
 *	bit: the feature bit
 *	Returns true if the feature is supported.  Acknowledges the feature
 *	so the host can see it.
 * @get: read the value of a configuration field
R
Rusty Russell 已提交
29
 *	vdev: the virtio_device
30
 *	offset: the offset of the configuration field
R
Rusty Russell 已提交
31
 *	buf: the buffer to write the field value into.
32
 *	len: the length of the buffer
R
Rusty Russell 已提交
33
 *	Note that contents are conventionally little-endian.
34
 * @set: write the value of a configuration field
R
Rusty Russell 已提交
35
 *	vdev: the virtio_device
36
 *	offset: the offset of the configuration field
R
Rusty Russell 已提交
37
 *	buf: the buffer to read the field value from.
38
 *	len: the length of the buffer
R
Rusty Russell 已提交
39 40 41 42 43 44 45
 *	Note that contents are conventionally little-endian.
 * @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
46
 * @find_vq: find a virtqueue and instantiate it.
R
Rusty Russell 已提交
47
 *	vdev: the virtio_device
48
 *	index: the 0-based virtqueue number in case there's more than one.
R
Rusty Russell 已提交
49
 *	callback: the virqtueue callback
50
 *	Returns the new virtqueue or ERR_PTR() (eg. -ENOENT).
R
Rusty Russell 已提交
51 52 53 54
 * @del_vq: free a virtqueue found by find_vq().
 */
struct virtio_config_ops
{
55 56
	bool (*feature)(struct virtio_device *vdev, unsigned bit);
	void (*get)(struct virtio_device *vdev, unsigned offset,
R
Rusty Russell 已提交
57
		    void *buf, unsigned len);
58
	void (*set)(struct virtio_device *vdev, unsigned offset,
R
Rusty Russell 已提交
59 60 61 62
		    const void *buf, unsigned len);
	u8 (*get_status)(struct virtio_device *vdev);
	void (*set_status)(struct virtio_device *vdev, u8 status);
	struct virtqueue *(*find_vq)(struct virtio_device *vdev,
63
				     unsigned index,
R
Rusty Russell 已提交
64 65 66 67 68
				     bool (*callback)(struct virtqueue *));
	void (*del_vq)(struct virtqueue *vq);
};

/**
69 70 71 72
 * virtio_config_val - look for a feature and get a single virtio config.
 * @vdev: the virtio device
 * @fbit: the feature bit
 * @offset: the type to search for.
R
Rusty Russell 已提交
73 74
 * @val: a pointer to the value to fill in.
 *
75 76 77 78 79 80 81 82 83
 * The return value is -ENOENT if the feature doesn't exist.  Otherwise
 * the value is endian-corrected and returned in v. */
#define virtio_config_val(vdev, fbit, offset, v) ({			\
	int _err;							\
	if ((vdev)->config->feature((vdev), (fbit))) {			\
		__virtio_config_val((vdev), (offset), (v));		\
		_err = 0;						\
	} else								\
		_err = -ENOENT;						\
R
Rusty Russell 已提交
84 85 86 87
	_err;								\
})

/**
88 89 90 91
 * __virtio_config_val - get a single virtio config without feature check.
 * @vdev: the virtio device
 * @offset: the type to search for.
 * @val: a pointer to the value to fill in.
R
Rusty Russell 已提交
92
 *
93 94 95 96 97 98 99 100 101 102 103
 * The value is endian-corrected and returned in v. */
#define __virtio_config_val(vdev, offset, v) do {			\
	BUILD_BUG_ON(sizeof(*(v)) != 1 && sizeof(*(v)) != 2		\
		     && sizeof(*(v)) != 4 && sizeof(*(v)) != 8);	\
	(vdev)->config->get((vdev), (offset), (v), sizeof(*(v)));	\
	switch (sizeof(*(v))) {						\
	case 2: le16_to_cpus((__u16 *) v); break;			\
	case 4: le32_to_cpus((__u32 *) v); break;			\
	case 8: le64_to_cpus((__u64 *) v); break;			\
	}								\
} while(0)
R
Rusty Russell 已提交
104 105
#endif /* __KERNEL__ */
#endif /* _LINUX_VIRTIO_CONFIG_H */