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. */
  10
  11struct vhost_inflight {
  12    int fd;
  13    void *addr;
  14    uint64_t size;
  15    uint64_t offset;
  16    uint16_t queue_size;
  17};
  18
  19struct vhost_virtqueue {
  20    int kick;
  21    int call;
  22    void *desc;
  23    void *avail;
  24    void *used;
  25    int num;
  26    unsigned long long desc_phys;
  27    unsigned desc_size;
  28    unsigned long long avail_phys;
  29    unsigned avail_size;
  30    unsigned long long used_phys;
  31    unsigned used_size;
  32    EventNotifier masked_notifier;
  33    struct vhost_dev *dev;
  34};
  35
  36typedef unsigned long vhost_log_chunk_t;
  37#define VHOST_LOG_PAGE 0x1000
  38#define VHOST_LOG_BITS (8 * sizeof(vhost_log_chunk_t))
  39#define VHOST_LOG_CHUNK (VHOST_LOG_PAGE * VHOST_LOG_BITS)
  40#define VHOST_INVALID_FEATURE_BIT   (0xff)
  41
  42struct vhost_log {
  43    unsigned long long size;
  44    int refcnt;
  45    int fd;
  46    vhost_log_chunk_t *log;
  47};
  48
  49struct vhost_dev;
  50struct vhost_iommu {
  51    struct vhost_dev *hdev;
  52    MemoryRegion *mr;
  53    hwaddr iommu_offset;
  54    IOMMUNotifier n;
  55    QLIST_ENTRY(vhost_iommu) iommu_next;
  56};
  57
  58typedef struct VhostDevConfigOps {
  59    /* Vhost device config space changed callback
  60     */
  61    int (*vhost_dev_config_notifier)(struct vhost_dev *dev);
  62} VhostDevConfigOps;
  63
  64struct vhost_memory;
  65struct vhost_dev {
  66    VirtIODevice *vdev;
  67    MemoryListener memory_listener;
  68    MemoryListener iommu_listener;
  69    struct vhost_memory *mem;
  70    int n_mem_sections;
  71    MemoryRegionSection *mem_sections;
  72    int n_tmp_sections;
  73    MemoryRegionSection *tmp_sections;
  74    struct vhost_virtqueue *vqs;
  75    int nvqs;
  76    /* the first virtqueue which would be used by this vhost dev */
  77    int vq_index;
  78    uint64_t features;
  79    uint64_t acked_features;
  80    uint64_t backend_features;
  81    uint64_t protocol_features;
  82    uint64_t max_queues;
  83    bool started;
  84    bool log_enabled;
  85    uint64_t log_size;
  86    Error *migration_blocker;
  87    const VhostOps *vhost_ops;
  88    void *opaque;
  89    struct vhost_log *log;
  90    QLIST_ENTRY(vhost_dev) entry;
  91    QLIST_HEAD(, vhost_iommu) iommu_list;
  92    IOMMUNotifier n;
  93    const VhostDevConfigOps *config_ops;
  94};
  95
  96int vhost_dev_init(struct vhost_dev *hdev, void *opaque,
  97                   VhostBackendType backend_type,
  98                   uint32_t busyloop_timeout);
  99void vhost_dev_cleanup(struct vhost_dev *hdev);
 100int vhost_dev_start(struct vhost_dev *hdev, VirtIODevice *vdev);
 101void vhost_dev_stop(struct vhost_dev *hdev, VirtIODevice *vdev);
 102int vhost_dev_enable_notifiers(struct vhost_dev *hdev, VirtIODevice *vdev);
 103void vhost_dev_disable_notifiers(struct vhost_dev *hdev, VirtIODevice *vdev);
 104
 105/* Test and clear masked event pending status.
 106 * Should be called after unmask to avoid losing events.
 107 */
 108bool vhost_virtqueue_pending(struct vhost_dev *hdev, int n);
 109
 110/* Mask/unmask events from this vq.
 111 */
 112void vhost_virtqueue_mask(struct vhost_dev *hdev, VirtIODevice *vdev, int n,
 113                          bool mask);
 114uint64_t vhost_get_features(struct vhost_dev *hdev, const int *feature_bits,
 115                            uint64_t features);
 116void vhost_ack_features(struct vhost_dev *hdev, const int *feature_bits,
 117                        uint64_t features);
 118bool vhost_has_free_slot(void);
 119
 120int vhost_net_set_backend(struct vhost_dev *hdev,
 121                          struct vhost_vring_file *file);
 122
 123int vhost_device_iotlb_miss(struct vhost_dev *dev, uint64_t iova, int write);
 124int vhost_dev_get_config(struct vhost_dev *dev, uint8_t *config,
 125                         uint32_t config_len);
 126int vhost_dev_set_config(struct vhost_dev *dev, const uint8_t *data,
 127                         uint32_t offset, uint32_t size, uint32_t flags);
 128/* notifier callback in case vhost device config space changed
 129 */
 130void vhost_dev_set_config_notifier(struct vhost_dev *dev,
 131                                   const VhostDevConfigOps *ops);
 132
 133void vhost_dev_reset_inflight(struct vhost_inflight *inflight);
 134void vhost_dev_free_inflight(struct vhost_inflight *inflight);
 135void vhost_dev_save_inflight(struct vhost_inflight *inflight, QEMUFile *f);
 136int vhost_dev_load_inflight(struct vhost_inflight *inflight, QEMUFile *f);
 137int vhost_dev_set_inflight(struct vhost_dev *dev,
 138                           struct vhost_inflight *inflight);
 139int vhost_dev_get_inflight(struct vhost_dev *dev, uint16_t queue_size,
 140                           struct vhost_inflight *inflight);
 141#endif
 142