qemu/include/hw/virtio/vhost.h
<<
>>
Prefs
   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. */
  10struct 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
  27typedef 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
  33struct vhost_log {
  34    unsigned long long size;
  35    int refcnt;
  36    int fd;
  37    vhost_log_chunk_t *log;
  38};
  39
  40struct vhost_dev;
  41struct vhost_iommu {
  42    struct vhost_dev *hdev;
  43    MemoryRegion *mr;
  44    hwaddr iommu_offset;
  45    IOMMUNotifier n;
  46    QLIST_ENTRY(vhost_iommu) iommu_next;
  47};
  48
  49typedef struct VhostDevConfigOps {
  50    /* Vhost device config space changed callback
  51     */
  52    int (*vhost_dev_config_notifier)(struct vhost_dev *dev);
  53} VhostDevConfigOps;
  54
  55struct vhost_memory;
  56struct vhost_dev {
  57    VirtIODevice *vdev;
  58    MemoryListener memory_listener;
  59    MemoryListener iommu_listener;
  60    struct vhost_memory *mem;
  61    int n_mem_sections;
  62    MemoryRegionSection *mem_sections;
  63    int n_tmp_sections;
  64    MemoryRegionSection *tmp_sections;
  65    struct vhost_virtqueue *vqs;
  66    int nvqs;
  67    /* the first virtqueue which would be used by this vhost dev */
  68    int vq_index;
  69    uint64_t features;
  70    uint64_t acked_features;
  71    uint64_t backend_features;
  72    uint64_t protocol_features;
  73    uint64_t max_queues;
  74    bool started;
  75    bool log_enabled;
  76    uint64_t log_size;
  77    Error *migration_blocker;
  78    const VhostOps *vhost_ops;
  79    void *opaque;
  80    struct vhost_log *log;
  81    QLIST_ENTRY(vhost_dev) entry;
  82    QLIST_HEAD(, vhost_iommu) iommu_list;
  83    IOMMUNotifier n;
  84    const VhostDevConfigOps *config_ops;
  85};
  86
  87int vhost_dev_init(struct vhost_dev *hdev, void *opaque,
  88                   VhostBackendType backend_type,
  89                   uint32_t busyloop_timeout);
  90void vhost_dev_cleanup(struct vhost_dev *hdev);
  91int vhost_dev_start(struct vhost_dev *hdev, VirtIODevice *vdev);
  92void vhost_dev_stop(struct vhost_dev *hdev, VirtIODevice *vdev);
  93int vhost_dev_enable_notifiers(struct vhost_dev *hdev, VirtIODevice *vdev);
  94void vhost_dev_disable_notifiers(struct vhost_dev *hdev, VirtIODevice *vdev);
  95
  96/* Test and clear masked event pending status.
  97 * Should be called after unmask to avoid losing events.
  98 */
  99bool vhost_virtqueue_pending(struct vhost_dev *hdev, int n);
 100
 101/* Mask/unmask events from this vq.
 102 */
 103void vhost_virtqueue_mask(struct vhost_dev *hdev, VirtIODevice *vdev, int n,
 104                          bool mask);
 105uint64_t vhost_get_features(struct vhost_dev *hdev, const int *feature_bits,
 106                            uint64_t features);
 107void vhost_ack_features(struct vhost_dev *hdev, const int *feature_bits,
 108                        uint64_t features);
 109bool vhost_has_free_slot(void);
 110
 111int vhost_net_set_backend(struct vhost_dev *hdev,
 112                          struct vhost_vring_file *file);
 113
 114int vhost_device_iotlb_miss(struct vhost_dev *dev, uint64_t iova, int write);
 115int vhost_dev_get_config(struct vhost_dev *dev, uint8_t *config,
 116                         uint32_t config_len);
 117int vhost_dev_set_config(struct vhost_dev *dev, const uint8_t *data,
 118                         uint32_t offset, uint32_t size, uint32_t flags);
 119/* notifier callback in case vhost device config space changed
 120 */
 121void vhost_dev_set_config_notifier(struct vhost_dev *dev,
 122                                   const VhostDevConfigOps *ops);
 123#endif
 124