xref: /qemu/include/hw/virtio/vhost.h (revision 72ac97cd)
1 #ifndef VHOST_H
2 #define VHOST_H
3 
4 #include "hw/hw.h"
5 #include "hw/virtio/virtio.h"
6 #include "exec/memory.h"
7 
8 /* Generic structures common for any vhost based device. */
9 struct vhost_virtqueue {
10     int kick;
11     int call;
12     void *desc;
13     void *avail;
14     void *used;
15     int num;
16     unsigned long long used_phys;
17     unsigned used_size;
18     void *ring;
19     unsigned long long ring_phys;
20     unsigned ring_size;
21     EventNotifier masked_notifier;
22 };
23 
24 typedef unsigned long vhost_log_chunk_t;
25 #define VHOST_LOG_PAGE 0x1000
26 #define VHOST_LOG_BITS (8 * sizeof(vhost_log_chunk_t))
27 #define VHOST_LOG_CHUNK (VHOST_LOG_PAGE * VHOST_LOG_BITS)
28 
29 struct vhost_memory;
30 struct vhost_dev {
31     MemoryListener memory_listener;
32     int control;
33     struct vhost_memory *mem;
34     int n_mem_sections;
35     MemoryRegionSection *mem_sections;
36     struct vhost_virtqueue *vqs;
37     int nvqs;
38     /* the first virtuque which would be used by this vhost dev */
39     int vq_index;
40     unsigned long long features;
41     unsigned long long acked_features;
42     unsigned long long backend_features;
43     bool started;
44     bool log_enabled;
45     vhost_log_chunk_t *log;
46     unsigned long long log_size;
47     bool force;
48     bool memory_changed;
49     hwaddr mem_changed_start_addr;
50     hwaddr mem_changed_end_addr;
51 };
52 
53 int vhost_dev_init(struct vhost_dev *hdev, int devfd, const char *devpath,
54                    bool force);
55 void vhost_dev_cleanup(struct vhost_dev *hdev);
56 bool vhost_dev_query(struct vhost_dev *hdev, VirtIODevice *vdev);
57 int vhost_dev_start(struct vhost_dev *hdev, VirtIODevice *vdev);
58 void vhost_dev_stop(struct vhost_dev *hdev, VirtIODevice *vdev);
59 int vhost_dev_enable_notifiers(struct vhost_dev *hdev, VirtIODevice *vdev);
60 void vhost_dev_disable_notifiers(struct vhost_dev *hdev, VirtIODevice *vdev);
61 
62 /* Test and clear masked event pending status.
63  * Should be called after unmask to avoid losing events.
64  */
65 bool vhost_virtqueue_pending(struct vhost_dev *hdev, int n);
66 
67 /* Mask/unmask events from this vq.
68  */
69 void vhost_virtqueue_mask(struct vhost_dev *hdev, VirtIODevice *vdev, int n,
70                           bool mask);
71 #endif
72