xref: /qemu/include/hw/virtio/vhost.h (revision 20daa90a)
1 #ifndef VHOST_H
2 #define VHOST_H
3 
4 #include "hw/hw.h"
5 #include "hw/virtio/vhost-backend.h"
6 #include "hw/virtio/virtio.h"
7 #include "exec/memory.h"
8 
9 /* Generic structures common for any vhost based device. */
10 struct vhost_virtqueue {
11     int kick;
12     int call;
13     void *desc;
14     void *avail;
15     void *used;
16     int num;
17     unsigned long long desc_phys;
18     unsigned desc_size;
19     unsigned long long avail_phys;
20     unsigned avail_size;
21     unsigned long long used_phys;
22     unsigned used_size;
23     EventNotifier masked_notifier;
24     struct vhost_dev *dev;
25 };
26 
27 typedef unsigned long vhost_log_chunk_t;
28 #define VHOST_LOG_PAGE 0x1000
29 #define VHOST_LOG_BITS (8 * sizeof(vhost_log_chunk_t))
30 #define VHOST_LOG_CHUNK (VHOST_LOG_PAGE * VHOST_LOG_BITS)
31 #define VHOST_INVALID_FEATURE_BIT   (0xff)
32 
33 struct vhost_log {
34     unsigned long long size;
35     int refcnt;
36     int fd;
37     vhost_log_chunk_t *log;
38 };
39 
40 struct vhost_memory;
41 struct vhost_dev {
42     VirtIODevice *vdev;
43     MemoryListener memory_listener;
44     struct vhost_memory *mem;
45     int n_mem_sections;
46     MemoryRegionSection *mem_sections;
47     struct vhost_virtqueue *vqs;
48     int nvqs;
49     /* the first virtqueue which would be used by this vhost dev */
50     int vq_index;
51     uint64_t features;
52     uint64_t acked_features;
53     uint64_t backend_features;
54     uint64_t protocol_features;
55     uint64_t max_queues;
56     bool started;
57     bool log_enabled;
58     uint64_t log_size;
59     Error *migration_blocker;
60     bool memory_changed;
61     hwaddr mem_changed_start_addr;
62     hwaddr mem_changed_end_addr;
63     const VhostOps *vhost_ops;
64     void *opaque;
65     struct vhost_log *log;
66     QLIST_ENTRY(vhost_dev) entry;
67     IOMMUNotifier n;
68 };
69 
70 int vhost_dev_init(struct vhost_dev *hdev, void *opaque,
71                    VhostBackendType backend_type,
72                    uint32_t busyloop_timeout);
73 void vhost_dev_cleanup(struct vhost_dev *hdev);
74 int vhost_dev_start(struct vhost_dev *hdev, VirtIODevice *vdev);
75 void vhost_dev_stop(struct vhost_dev *hdev, VirtIODevice *vdev);
76 int vhost_dev_enable_notifiers(struct vhost_dev *hdev, VirtIODevice *vdev);
77 void vhost_dev_disable_notifiers(struct vhost_dev *hdev, VirtIODevice *vdev);
78 
79 /* Test and clear masked event pending status.
80  * Should be called after unmask to avoid losing events.
81  */
82 bool vhost_virtqueue_pending(struct vhost_dev *hdev, int n);
83 
84 /* Mask/unmask events from this vq.
85  */
86 void vhost_virtqueue_mask(struct vhost_dev *hdev, VirtIODevice *vdev, int n,
87                           bool mask);
88 uint64_t vhost_get_features(struct vhost_dev *hdev, const int *feature_bits,
89                             uint64_t features);
90 void vhost_ack_features(struct vhost_dev *hdev, const int *feature_bits,
91                         uint64_t features);
92 bool vhost_has_free_slot(void);
93 
94 int vhost_net_set_backend(struct vhost_dev *hdev,
95                           struct vhost_vring_file *file);
96 
97 void vhost_device_iotlb_miss(struct vhost_dev *dev, uint64_t iova, int write);
98 #endif
99