xref: /qemu/hw/virtio/vhost.c (revision 603476c2)
1 /*
2  * vhost support
3  *
4  * Copyright Red Hat, Inc. 2010
5  *
6  * Authors:
7  *  Michael S. Tsirkin <mst@redhat.com>
8  *
9  * This work is licensed under the terms of the GNU GPL, version 2.  See
10  * the COPYING file in the top-level directory.
11  *
12  * Contributions after 2012-01-13 are licensed under the terms of the
13  * GNU GPL, version 2 or (at your option) any later version.
14  */
15 
16 #include "qemu/osdep.h"
17 #include "qapi/error.h"
18 #include "hw/virtio/vhost.h"
19 #include "hw/hw.h"
20 #include "qemu/atomic.h"
21 #include "qemu/range.h"
22 #include "qemu/error-report.h"
23 #include "qemu/memfd.h"
24 #include <linux/vhost.h>
25 #include "exec/address-spaces.h"
26 #include "hw/virtio/virtio-bus.h"
27 #include "hw/virtio/virtio-access.h"
28 #include "migration/migration.h"
29 
30 /* enabled until disconnected backend stabilizes */
31 #define _VHOST_DEBUG 1
32 
33 #ifdef _VHOST_DEBUG
34 #define VHOST_OPS_DEBUG(fmt, ...) \
35     do { error_report(fmt ": %s (%d)", ## __VA_ARGS__, \
36                       strerror(errno), errno); } while (0)
37 #else
38 #define VHOST_OPS_DEBUG(fmt, ...) \
39     do { } while (0)
40 #endif
41 
42 static struct vhost_log *vhost_log;
43 static struct vhost_log *vhost_log_shm;
44 
45 static unsigned int used_memslots;
46 static QLIST_HEAD(, vhost_dev) vhost_devices =
47     QLIST_HEAD_INITIALIZER(vhost_devices);
48 
49 bool vhost_has_free_slot(void)
50 {
51     unsigned int slots_limit = ~0U;
52     struct vhost_dev *hdev;
53 
54     QLIST_FOREACH(hdev, &vhost_devices, entry) {
55         unsigned int r = hdev->vhost_ops->vhost_backend_memslots_limit(hdev);
56         slots_limit = MIN(slots_limit, r);
57     }
58     return slots_limit > used_memslots;
59 }
60 
61 static void vhost_dev_sync_region(struct vhost_dev *dev,
62                                   MemoryRegionSection *section,
63                                   uint64_t mfirst, uint64_t mlast,
64                                   uint64_t rfirst, uint64_t rlast)
65 {
66     vhost_log_chunk_t *log = dev->log->log;
67 
68     uint64_t start = MAX(mfirst, rfirst);
69     uint64_t end = MIN(mlast, rlast);
70     vhost_log_chunk_t *from = log + start / VHOST_LOG_CHUNK;
71     vhost_log_chunk_t *to = log + end / VHOST_LOG_CHUNK + 1;
72     uint64_t addr = (start / VHOST_LOG_CHUNK) * VHOST_LOG_CHUNK;
73 
74     if (end < start) {
75         return;
76     }
77     assert(end / VHOST_LOG_CHUNK < dev->log_size);
78     assert(start / VHOST_LOG_CHUNK < dev->log_size);
79 
80     for (;from < to; ++from) {
81         vhost_log_chunk_t log;
82         /* We first check with non-atomic: much cheaper,
83          * and we expect non-dirty to be the common case. */
84         if (!*from) {
85             addr += VHOST_LOG_CHUNK;
86             continue;
87         }
88         /* Data must be read atomically. We don't really need barrier semantics
89          * but it's easier to use atomic_* than roll our own. */
90         log = atomic_xchg(from, 0);
91         while (log) {
92             int bit = ctzl(log);
93             hwaddr page_addr;
94             hwaddr section_offset;
95             hwaddr mr_offset;
96             page_addr = addr + bit * VHOST_LOG_PAGE;
97             section_offset = page_addr - section->offset_within_address_space;
98             mr_offset = section_offset + section->offset_within_region;
99             memory_region_set_dirty(section->mr, mr_offset, VHOST_LOG_PAGE);
100             log &= ~(0x1ull << bit);
101         }
102         addr += VHOST_LOG_CHUNK;
103     }
104 }
105 
106 static int vhost_sync_dirty_bitmap(struct vhost_dev *dev,
107                                    MemoryRegionSection *section,
108                                    hwaddr first,
109                                    hwaddr last)
110 {
111     int i;
112     hwaddr start_addr;
113     hwaddr end_addr;
114 
115     if (!dev->log_enabled || !dev->started) {
116         return 0;
117     }
118     start_addr = section->offset_within_address_space;
119     end_addr = range_get_last(start_addr, int128_get64(section->size));
120     start_addr = MAX(first, start_addr);
121     end_addr = MIN(last, end_addr);
122 
123     for (i = 0; i < dev->mem->nregions; ++i) {
124         struct vhost_memory_region *reg = dev->mem->regions + i;
125         vhost_dev_sync_region(dev, section, start_addr, end_addr,
126                               reg->guest_phys_addr,
127                               range_get_last(reg->guest_phys_addr,
128                                              reg->memory_size));
129     }
130     for (i = 0; i < dev->nvqs; ++i) {
131         struct vhost_virtqueue *vq = dev->vqs + i;
132         vhost_dev_sync_region(dev, section, start_addr, end_addr, vq->used_phys,
133                               range_get_last(vq->used_phys, vq->used_size));
134     }
135     return 0;
136 }
137 
138 static void vhost_log_sync(MemoryListener *listener,
139                           MemoryRegionSection *section)
140 {
141     struct vhost_dev *dev = container_of(listener, struct vhost_dev,
142                                          memory_listener);
143     vhost_sync_dirty_bitmap(dev, section, 0x0, ~0x0ULL);
144 }
145 
146 static void vhost_log_sync_range(struct vhost_dev *dev,
147                                  hwaddr first, hwaddr last)
148 {
149     int i;
150     /* FIXME: this is N^2 in number of sections */
151     for (i = 0; i < dev->n_mem_sections; ++i) {
152         MemoryRegionSection *section = &dev->mem_sections[i];
153         vhost_sync_dirty_bitmap(dev, section, first, last);
154     }
155 }
156 
157 /* Assign/unassign. Keep an unsorted array of non-overlapping
158  * memory regions in dev->mem. */
159 static void vhost_dev_unassign_memory(struct vhost_dev *dev,
160                                       uint64_t start_addr,
161                                       uint64_t size)
162 {
163     int from, to, n = dev->mem->nregions;
164     /* Track overlapping/split regions for sanity checking. */
165     int overlap_start = 0, overlap_end = 0, overlap_middle = 0, split = 0;
166 
167     for (from = 0, to = 0; from < n; ++from, ++to) {
168         struct vhost_memory_region *reg = dev->mem->regions + to;
169         uint64_t reglast;
170         uint64_t memlast;
171         uint64_t change;
172 
173         /* clone old region */
174         if (to != from) {
175             memcpy(reg, dev->mem->regions + from, sizeof *reg);
176         }
177 
178         /* No overlap is simple */
179         if (!ranges_overlap(reg->guest_phys_addr, reg->memory_size,
180                             start_addr, size)) {
181             continue;
182         }
183 
184         /* Split only happens if supplied region
185          * is in the middle of an existing one. Thus it can not
186          * overlap with any other existing region. */
187         assert(!split);
188 
189         reglast = range_get_last(reg->guest_phys_addr, reg->memory_size);
190         memlast = range_get_last(start_addr, size);
191 
192         /* Remove whole region */
193         if (start_addr <= reg->guest_phys_addr && memlast >= reglast) {
194             --dev->mem->nregions;
195             --to;
196             ++overlap_middle;
197             continue;
198         }
199 
200         /* Shrink region */
201         if (memlast >= reglast) {
202             reg->memory_size = start_addr - reg->guest_phys_addr;
203             assert(reg->memory_size);
204             assert(!overlap_end);
205             ++overlap_end;
206             continue;
207         }
208 
209         /* Shift region */
210         if (start_addr <= reg->guest_phys_addr) {
211             change = memlast + 1 - reg->guest_phys_addr;
212             reg->memory_size -= change;
213             reg->guest_phys_addr += change;
214             reg->userspace_addr += change;
215             assert(reg->memory_size);
216             assert(!overlap_start);
217             ++overlap_start;
218             continue;
219         }
220 
221         /* This only happens if supplied region
222          * is in the middle of an existing one. Thus it can not
223          * overlap with any other existing region. */
224         assert(!overlap_start);
225         assert(!overlap_end);
226         assert(!overlap_middle);
227         /* Split region: shrink first part, shift second part. */
228         memcpy(dev->mem->regions + n, reg, sizeof *reg);
229         reg->memory_size = start_addr - reg->guest_phys_addr;
230         assert(reg->memory_size);
231         change = memlast + 1 - reg->guest_phys_addr;
232         reg = dev->mem->regions + n;
233         reg->memory_size -= change;
234         assert(reg->memory_size);
235         reg->guest_phys_addr += change;
236         reg->userspace_addr += change;
237         /* Never add more than 1 region */
238         assert(dev->mem->nregions == n);
239         ++dev->mem->nregions;
240         ++split;
241     }
242 }
243 
244 /* Called after unassign, so no regions overlap the given range. */
245 static void vhost_dev_assign_memory(struct vhost_dev *dev,
246                                     uint64_t start_addr,
247                                     uint64_t size,
248                                     uint64_t uaddr)
249 {
250     int from, to;
251     struct vhost_memory_region *merged = NULL;
252     for (from = 0, to = 0; from < dev->mem->nregions; ++from, ++to) {
253         struct vhost_memory_region *reg = dev->mem->regions + to;
254         uint64_t prlast, urlast;
255         uint64_t pmlast, umlast;
256         uint64_t s, e, u;
257 
258         /* clone old region */
259         if (to != from) {
260             memcpy(reg, dev->mem->regions + from, sizeof *reg);
261         }
262         prlast = range_get_last(reg->guest_phys_addr, reg->memory_size);
263         pmlast = range_get_last(start_addr, size);
264         urlast = range_get_last(reg->userspace_addr, reg->memory_size);
265         umlast = range_get_last(uaddr, size);
266 
267         /* check for overlapping regions: should never happen. */
268         assert(prlast < start_addr || pmlast < reg->guest_phys_addr);
269         /* Not an adjacent or overlapping region - do not merge. */
270         if ((prlast + 1 != start_addr || urlast + 1 != uaddr) &&
271             (pmlast + 1 != reg->guest_phys_addr ||
272              umlast + 1 != reg->userspace_addr)) {
273             continue;
274         }
275 
276         if (dev->vhost_ops->vhost_backend_can_merge &&
277             !dev->vhost_ops->vhost_backend_can_merge(dev, uaddr, size,
278                                                      reg->userspace_addr,
279                                                      reg->memory_size)) {
280             continue;
281         }
282 
283         if (merged) {
284             --to;
285             assert(to >= 0);
286         } else {
287             merged = reg;
288         }
289         u = MIN(uaddr, reg->userspace_addr);
290         s = MIN(start_addr, reg->guest_phys_addr);
291         e = MAX(pmlast, prlast);
292         uaddr = merged->userspace_addr = u;
293         start_addr = merged->guest_phys_addr = s;
294         size = merged->memory_size = e - s + 1;
295         assert(merged->memory_size);
296     }
297 
298     if (!merged) {
299         struct vhost_memory_region *reg = dev->mem->regions + to;
300         memset(reg, 0, sizeof *reg);
301         reg->memory_size = size;
302         assert(reg->memory_size);
303         reg->guest_phys_addr = start_addr;
304         reg->userspace_addr = uaddr;
305         ++to;
306     }
307     assert(to <= dev->mem->nregions + 1);
308     dev->mem->nregions = to;
309 }
310 
311 static uint64_t vhost_get_log_size(struct vhost_dev *dev)
312 {
313     uint64_t log_size = 0;
314     int i;
315     for (i = 0; i < dev->mem->nregions; ++i) {
316         struct vhost_memory_region *reg = dev->mem->regions + i;
317         uint64_t last = range_get_last(reg->guest_phys_addr,
318                                        reg->memory_size);
319         log_size = MAX(log_size, last / VHOST_LOG_CHUNK + 1);
320     }
321     for (i = 0; i < dev->nvqs; ++i) {
322         struct vhost_virtqueue *vq = dev->vqs + i;
323         uint64_t last = vq->used_phys + vq->used_size - 1;
324         log_size = MAX(log_size, last / VHOST_LOG_CHUNK + 1);
325     }
326     return log_size;
327 }
328 
329 static struct vhost_log *vhost_log_alloc(uint64_t size, bool share)
330 {
331     struct vhost_log *log;
332     uint64_t logsize = size * sizeof(*(log->log));
333     int fd = -1;
334 
335     log = g_new0(struct vhost_log, 1);
336     if (share) {
337         log->log = qemu_memfd_alloc("vhost-log", logsize,
338                                     F_SEAL_GROW | F_SEAL_SHRINK | F_SEAL_SEAL,
339                                     &fd);
340         memset(log->log, 0, logsize);
341     } else {
342         log->log = g_malloc0(logsize);
343     }
344 
345     log->size = size;
346     log->refcnt = 1;
347     log->fd = fd;
348 
349     return log;
350 }
351 
352 static struct vhost_log *vhost_log_get(uint64_t size, bool share)
353 {
354     struct vhost_log *log = share ? vhost_log_shm : vhost_log;
355 
356     if (!log || log->size != size) {
357         log = vhost_log_alloc(size, share);
358         if (share) {
359             vhost_log_shm = log;
360         } else {
361             vhost_log = log;
362         }
363     } else {
364         ++log->refcnt;
365     }
366 
367     return log;
368 }
369 
370 static void vhost_log_put(struct vhost_dev *dev, bool sync)
371 {
372     struct vhost_log *log = dev->log;
373 
374     if (!log) {
375         return;
376     }
377     dev->log = NULL;
378     dev->log_size = 0;
379 
380     --log->refcnt;
381     if (log->refcnt == 0) {
382         /* Sync only the range covered by the old log */
383         if (dev->log_size && sync) {
384             vhost_log_sync_range(dev, 0, dev->log_size * VHOST_LOG_CHUNK - 1);
385         }
386 
387         if (vhost_log == log) {
388             g_free(log->log);
389             vhost_log = NULL;
390         } else if (vhost_log_shm == log) {
391             qemu_memfd_free(log->log, log->size * sizeof(*(log->log)),
392                             log->fd);
393             vhost_log_shm = NULL;
394         }
395 
396         g_free(log);
397     }
398 }
399 
400 static bool vhost_dev_log_is_shared(struct vhost_dev *dev)
401 {
402     return dev->vhost_ops->vhost_requires_shm_log &&
403            dev->vhost_ops->vhost_requires_shm_log(dev);
404 }
405 
406 static inline void vhost_dev_log_resize(struct vhost_dev *dev, uint64_t size)
407 {
408     struct vhost_log *log = vhost_log_get(size, vhost_dev_log_is_shared(dev));
409     uint64_t log_base = (uintptr_t)log->log;
410     int r;
411 
412     /* inform backend of log switching, this must be done before
413        releasing the current log, to ensure no logging is lost */
414     r = dev->vhost_ops->vhost_set_log_base(dev, log_base, log);
415     if (r < 0) {
416         VHOST_OPS_DEBUG("vhost_set_log_base failed");
417     }
418 
419     vhost_log_put(dev, true);
420     dev->log = log;
421     dev->log_size = size;
422 }
423 
424 static int vhost_verify_ring_mappings(struct vhost_dev *dev,
425                                       uint64_t start_addr,
426                                       uint64_t size)
427 {
428     int i;
429     int r = 0;
430 
431     for (i = 0; !r && i < dev->nvqs; ++i) {
432         struct vhost_virtqueue *vq = dev->vqs + i;
433         hwaddr l;
434         void *p;
435 
436         if (!ranges_overlap(start_addr, size, vq->ring_phys, vq->ring_size)) {
437             continue;
438         }
439         l = vq->ring_size;
440         p = cpu_physical_memory_map(vq->ring_phys, &l, 1);
441         if (!p || l != vq->ring_size) {
442             error_report("Unable to map ring buffer for ring %d", i);
443             r = -ENOMEM;
444         }
445         if (p != vq->ring) {
446             error_report("Ring buffer relocated for ring %d", i);
447             r = -EBUSY;
448         }
449         cpu_physical_memory_unmap(p, l, 0, 0);
450     }
451     return r;
452 }
453 
454 static struct vhost_memory_region *vhost_dev_find_reg(struct vhost_dev *dev,
455 						      uint64_t start_addr,
456 						      uint64_t size)
457 {
458     int i, n = dev->mem->nregions;
459     for (i = 0; i < n; ++i) {
460         struct vhost_memory_region *reg = dev->mem->regions + i;
461         if (ranges_overlap(reg->guest_phys_addr, reg->memory_size,
462                            start_addr, size)) {
463             return reg;
464         }
465     }
466     return NULL;
467 }
468 
469 static bool vhost_dev_cmp_memory(struct vhost_dev *dev,
470                                  uint64_t start_addr,
471                                  uint64_t size,
472                                  uint64_t uaddr)
473 {
474     struct vhost_memory_region *reg = vhost_dev_find_reg(dev, start_addr, size);
475     uint64_t reglast;
476     uint64_t memlast;
477 
478     if (!reg) {
479         return true;
480     }
481 
482     reglast = range_get_last(reg->guest_phys_addr, reg->memory_size);
483     memlast = range_get_last(start_addr, size);
484 
485     /* Need to extend region? */
486     if (start_addr < reg->guest_phys_addr || memlast > reglast) {
487         return true;
488     }
489     /* userspace_addr changed? */
490     return uaddr != reg->userspace_addr + start_addr - reg->guest_phys_addr;
491 }
492 
493 static void vhost_set_memory(MemoryListener *listener,
494                              MemoryRegionSection *section,
495                              bool add)
496 {
497     struct vhost_dev *dev = container_of(listener, struct vhost_dev,
498                                          memory_listener);
499     hwaddr start_addr = section->offset_within_address_space;
500     ram_addr_t size = int128_get64(section->size);
501     bool log_dirty =
502         memory_region_get_dirty_log_mask(section->mr) & ~(1 << DIRTY_MEMORY_MIGRATION);
503     int s = offsetof(struct vhost_memory, regions) +
504         (dev->mem->nregions + 1) * sizeof dev->mem->regions[0];
505     void *ram;
506 
507     dev->mem = g_realloc(dev->mem, s);
508 
509     if (log_dirty) {
510         add = false;
511     }
512 
513     assert(size);
514 
515     /* Optimize no-change case. At least cirrus_vga does this a lot at this time. */
516     ram = memory_region_get_ram_ptr(section->mr) + section->offset_within_region;
517     if (add) {
518         if (!vhost_dev_cmp_memory(dev, start_addr, size, (uintptr_t)ram)) {
519             /* Region exists with same address. Nothing to do. */
520             return;
521         }
522     } else {
523         if (!vhost_dev_find_reg(dev, start_addr, size)) {
524             /* Removing region that we don't access. Nothing to do. */
525             return;
526         }
527     }
528 
529     vhost_dev_unassign_memory(dev, start_addr, size);
530     if (add) {
531         /* Add given mapping, merging adjacent regions if any */
532         vhost_dev_assign_memory(dev, start_addr, size, (uintptr_t)ram);
533     } else {
534         /* Remove old mapping for this memory, if any. */
535         vhost_dev_unassign_memory(dev, start_addr, size);
536     }
537     dev->mem_changed_start_addr = MIN(dev->mem_changed_start_addr, start_addr);
538     dev->mem_changed_end_addr = MAX(dev->mem_changed_end_addr, start_addr + size - 1);
539     dev->memory_changed = true;
540     used_memslots = dev->mem->nregions;
541 }
542 
543 static bool vhost_section(MemoryRegionSection *section)
544 {
545     return memory_region_is_ram(section->mr);
546 }
547 
548 static void vhost_begin(MemoryListener *listener)
549 {
550     struct vhost_dev *dev = container_of(listener, struct vhost_dev,
551                                          memory_listener);
552     dev->mem_changed_end_addr = 0;
553     dev->mem_changed_start_addr = -1;
554 }
555 
556 static void vhost_commit(MemoryListener *listener)
557 {
558     struct vhost_dev *dev = container_of(listener, struct vhost_dev,
559                                          memory_listener);
560     hwaddr start_addr = 0;
561     ram_addr_t size = 0;
562     uint64_t log_size;
563     int r;
564 
565     if (!dev->memory_changed) {
566         return;
567     }
568     if (!dev->started) {
569         return;
570     }
571     if (dev->mem_changed_start_addr > dev->mem_changed_end_addr) {
572         return;
573     }
574 
575     if (dev->started) {
576         start_addr = dev->mem_changed_start_addr;
577         size = dev->mem_changed_end_addr - dev->mem_changed_start_addr + 1;
578 
579         r = vhost_verify_ring_mappings(dev, start_addr, size);
580         assert(r >= 0);
581     }
582 
583     if (!dev->log_enabled) {
584         r = dev->vhost_ops->vhost_set_mem_table(dev, dev->mem);
585         if (r < 0) {
586             VHOST_OPS_DEBUG("vhost_set_mem_table failed");
587         }
588         dev->memory_changed = false;
589         return;
590     }
591     log_size = vhost_get_log_size(dev);
592     /* We allocate an extra 4K bytes to log,
593      * to reduce the * number of reallocations. */
594 #define VHOST_LOG_BUFFER (0x1000 / sizeof *dev->log)
595     /* To log more, must increase log size before table update. */
596     if (dev->log_size < log_size) {
597         vhost_dev_log_resize(dev, log_size + VHOST_LOG_BUFFER);
598     }
599     r = dev->vhost_ops->vhost_set_mem_table(dev, dev->mem);
600     if (r < 0) {
601         VHOST_OPS_DEBUG("vhost_set_mem_table failed");
602     }
603     /* To log less, can only decrease log size after table update. */
604     if (dev->log_size > log_size + VHOST_LOG_BUFFER) {
605         vhost_dev_log_resize(dev, log_size);
606     }
607     dev->memory_changed = false;
608 }
609 
610 static void vhost_region_add(MemoryListener *listener,
611                              MemoryRegionSection *section)
612 {
613     struct vhost_dev *dev = container_of(listener, struct vhost_dev,
614                                          memory_listener);
615 
616     if (!vhost_section(section)) {
617         return;
618     }
619 
620     ++dev->n_mem_sections;
621     dev->mem_sections = g_renew(MemoryRegionSection, dev->mem_sections,
622                                 dev->n_mem_sections);
623     dev->mem_sections[dev->n_mem_sections - 1] = *section;
624     memory_region_ref(section->mr);
625     vhost_set_memory(listener, section, true);
626 }
627 
628 static void vhost_region_del(MemoryListener *listener,
629                              MemoryRegionSection *section)
630 {
631     struct vhost_dev *dev = container_of(listener, struct vhost_dev,
632                                          memory_listener);
633     int i;
634 
635     if (!vhost_section(section)) {
636         return;
637     }
638 
639     vhost_set_memory(listener, section, false);
640     memory_region_unref(section->mr);
641     for (i = 0; i < dev->n_mem_sections; ++i) {
642         if (dev->mem_sections[i].offset_within_address_space
643             == section->offset_within_address_space) {
644             --dev->n_mem_sections;
645             memmove(&dev->mem_sections[i], &dev->mem_sections[i+1],
646                     (dev->n_mem_sections - i) * sizeof(*dev->mem_sections));
647             break;
648         }
649     }
650 }
651 
652 static void vhost_region_nop(MemoryListener *listener,
653                              MemoryRegionSection *section)
654 {
655 }
656 
657 static int vhost_virtqueue_set_addr(struct vhost_dev *dev,
658                                     struct vhost_virtqueue *vq,
659                                     unsigned idx, bool enable_log)
660 {
661     struct vhost_vring_addr addr = {
662         .index = idx,
663         .desc_user_addr = (uint64_t)(unsigned long)vq->desc,
664         .avail_user_addr = (uint64_t)(unsigned long)vq->avail,
665         .used_user_addr = (uint64_t)(unsigned long)vq->used,
666         .log_guest_addr = vq->used_phys,
667         .flags = enable_log ? (1 << VHOST_VRING_F_LOG) : 0,
668     };
669     int r = dev->vhost_ops->vhost_set_vring_addr(dev, &addr);
670     if (r < 0) {
671         VHOST_OPS_DEBUG("vhost_set_vring_addr failed");
672         return -errno;
673     }
674     return 0;
675 }
676 
677 static int vhost_dev_set_features(struct vhost_dev *dev, bool enable_log)
678 {
679     uint64_t features = dev->acked_features;
680     int r;
681     if (enable_log) {
682         features |= 0x1ULL << VHOST_F_LOG_ALL;
683     }
684     r = dev->vhost_ops->vhost_set_features(dev, features);
685     if (r < 0) {
686         VHOST_OPS_DEBUG("vhost_set_features failed");
687     }
688     return r < 0 ? -errno : 0;
689 }
690 
691 static int vhost_dev_set_log(struct vhost_dev *dev, bool enable_log)
692 {
693     int r, i, idx;
694     r = vhost_dev_set_features(dev, enable_log);
695     if (r < 0) {
696         goto err_features;
697     }
698     for (i = 0; i < dev->nvqs; ++i) {
699         idx = dev->vhost_ops->vhost_get_vq_index(dev, dev->vq_index + i);
700         r = vhost_virtqueue_set_addr(dev, dev->vqs + i, idx,
701                                      enable_log);
702         if (r < 0) {
703             goto err_vq;
704         }
705     }
706     return 0;
707 err_vq:
708     for (; i >= 0; --i) {
709         idx = dev->vhost_ops->vhost_get_vq_index(dev, dev->vq_index + i);
710         vhost_virtqueue_set_addr(dev, dev->vqs + i, idx,
711                                  dev->log_enabled);
712     }
713     vhost_dev_set_features(dev, dev->log_enabled);
714 err_features:
715     return r;
716 }
717 
718 static int vhost_migration_log(MemoryListener *listener, int enable)
719 {
720     struct vhost_dev *dev = container_of(listener, struct vhost_dev,
721                                          memory_listener);
722     int r;
723     if (!!enable == dev->log_enabled) {
724         return 0;
725     }
726     if (!dev->started) {
727         dev->log_enabled = enable;
728         return 0;
729     }
730     if (!enable) {
731         r = vhost_dev_set_log(dev, false);
732         if (r < 0) {
733             return r;
734         }
735         vhost_log_put(dev, false);
736     } else {
737         vhost_dev_log_resize(dev, vhost_get_log_size(dev));
738         r = vhost_dev_set_log(dev, true);
739         if (r < 0) {
740             return r;
741         }
742     }
743     dev->log_enabled = enable;
744     return 0;
745 }
746 
747 static void vhost_log_global_start(MemoryListener *listener)
748 {
749     int r;
750 
751     r = vhost_migration_log(listener, true);
752     if (r < 0) {
753         abort();
754     }
755 }
756 
757 static void vhost_log_global_stop(MemoryListener *listener)
758 {
759     int r;
760 
761     r = vhost_migration_log(listener, false);
762     if (r < 0) {
763         abort();
764     }
765 }
766 
767 static void vhost_log_start(MemoryListener *listener,
768                             MemoryRegionSection *section,
769                             int old, int new)
770 {
771     /* FIXME: implement */
772 }
773 
774 static void vhost_log_stop(MemoryListener *listener,
775                            MemoryRegionSection *section,
776                            int old, int new)
777 {
778     /* FIXME: implement */
779 }
780 
781 /* The vhost driver natively knows how to handle the vrings of non
782  * cross-endian legacy devices and modern devices. Only legacy devices
783  * exposed to a bi-endian guest may require the vhost driver to use a
784  * specific endianness.
785  */
786 static inline bool vhost_needs_vring_endian(VirtIODevice *vdev)
787 {
788     if (virtio_vdev_has_feature(vdev, VIRTIO_F_VERSION_1)) {
789         return false;
790     }
791 #ifdef HOST_WORDS_BIGENDIAN
792     return vdev->device_endian == VIRTIO_DEVICE_ENDIAN_LITTLE;
793 #else
794     return vdev->device_endian == VIRTIO_DEVICE_ENDIAN_BIG;
795 #endif
796 }
797 
798 static int vhost_virtqueue_set_vring_endian_legacy(struct vhost_dev *dev,
799                                                    bool is_big_endian,
800                                                    int vhost_vq_index)
801 {
802     struct vhost_vring_state s = {
803         .index = vhost_vq_index,
804         .num = is_big_endian
805     };
806 
807     if (!dev->vhost_ops->vhost_set_vring_endian(dev, &s)) {
808         return 0;
809     }
810 
811     VHOST_OPS_DEBUG("vhost_set_vring_endian failed");
812     if (errno == ENOTTY) {
813         error_report("vhost does not support cross-endian");
814         return -ENOSYS;
815     }
816 
817     return -errno;
818 }
819 
820 static int vhost_virtqueue_start(struct vhost_dev *dev,
821                                 struct VirtIODevice *vdev,
822                                 struct vhost_virtqueue *vq,
823                                 unsigned idx)
824 {
825     BusState *qbus = BUS(qdev_get_parent_bus(DEVICE(vdev)));
826     VirtioBusState *vbus = VIRTIO_BUS(qbus);
827     VirtioBusClass *k = VIRTIO_BUS_GET_CLASS(vbus);
828     hwaddr s, l, a;
829     int r;
830     int vhost_vq_index = dev->vhost_ops->vhost_get_vq_index(dev, idx);
831     struct vhost_vring_file file = {
832         .index = vhost_vq_index
833     };
834     struct vhost_vring_state state = {
835         .index = vhost_vq_index
836     };
837     struct VirtQueue *vvq = virtio_get_queue(vdev, idx);
838 
839 
840     vq->num = state.num = virtio_queue_get_num(vdev, idx);
841     r = dev->vhost_ops->vhost_set_vring_num(dev, &state);
842     if (r) {
843         VHOST_OPS_DEBUG("vhost_set_vring_num failed");
844         return -errno;
845     }
846 
847     state.num = virtio_queue_get_last_avail_idx(vdev, idx);
848     r = dev->vhost_ops->vhost_set_vring_base(dev, &state);
849     if (r) {
850         VHOST_OPS_DEBUG("vhost_set_vring_base failed");
851         return -errno;
852     }
853 
854     if (vhost_needs_vring_endian(vdev)) {
855         r = vhost_virtqueue_set_vring_endian_legacy(dev,
856                                                     virtio_is_big_endian(vdev),
857                                                     vhost_vq_index);
858         if (r) {
859             return -errno;
860         }
861     }
862 
863     s = l = virtio_queue_get_desc_size(vdev, idx);
864     a = virtio_queue_get_desc_addr(vdev, idx);
865     vq->desc = cpu_physical_memory_map(a, &l, 0);
866     if (!vq->desc || l != s) {
867         r = -ENOMEM;
868         goto fail_alloc_desc;
869     }
870     s = l = virtio_queue_get_avail_size(vdev, idx);
871     a = virtio_queue_get_avail_addr(vdev, idx);
872     vq->avail = cpu_physical_memory_map(a, &l, 0);
873     if (!vq->avail || l != s) {
874         r = -ENOMEM;
875         goto fail_alloc_avail;
876     }
877     vq->used_size = s = l = virtio_queue_get_used_size(vdev, idx);
878     vq->used_phys = a = virtio_queue_get_used_addr(vdev, idx);
879     vq->used = cpu_physical_memory_map(a, &l, 1);
880     if (!vq->used || l != s) {
881         r = -ENOMEM;
882         goto fail_alloc_used;
883     }
884 
885     vq->ring_size = s = l = virtio_queue_get_ring_size(vdev, idx);
886     vq->ring_phys = a = virtio_queue_get_ring_addr(vdev, idx);
887     vq->ring = cpu_physical_memory_map(a, &l, 1);
888     if (!vq->ring || l != s) {
889         r = -ENOMEM;
890         goto fail_alloc_ring;
891     }
892 
893     r = vhost_virtqueue_set_addr(dev, vq, vhost_vq_index, dev->log_enabled);
894     if (r < 0) {
895         r = -errno;
896         goto fail_alloc;
897     }
898 
899     file.fd = event_notifier_get_fd(virtio_queue_get_host_notifier(vvq));
900     r = dev->vhost_ops->vhost_set_vring_kick(dev, &file);
901     if (r) {
902         VHOST_OPS_DEBUG("vhost_set_vring_kick failed");
903         r = -errno;
904         goto fail_kick;
905     }
906 
907     /* Clear and discard previous events if any. */
908     event_notifier_test_and_clear(&vq->masked_notifier);
909 
910     /* Init vring in unmasked state, unless guest_notifier_mask
911      * will do it later.
912      */
913     if (!vdev->use_guest_notifier_mask) {
914         /* TODO: check and handle errors. */
915         vhost_virtqueue_mask(dev, vdev, idx, false);
916     }
917 
918     if (k->query_guest_notifiers &&
919         k->query_guest_notifiers(qbus->parent) &&
920         virtio_queue_vector(vdev, idx) == VIRTIO_NO_VECTOR) {
921         file.fd = -1;
922         r = dev->vhost_ops->vhost_set_vring_call(dev, &file);
923         if (r) {
924             goto fail_vector;
925         }
926     }
927 
928     return 0;
929 
930 fail_vector:
931 fail_kick:
932 fail_alloc:
933     cpu_physical_memory_unmap(vq->ring, virtio_queue_get_ring_size(vdev, idx),
934                               0, 0);
935 fail_alloc_ring:
936     cpu_physical_memory_unmap(vq->used, virtio_queue_get_used_size(vdev, idx),
937                               0, 0);
938 fail_alloc_used:
939     cpu_physical_memory_unmap(vq->avail, virtio_queue_get_avail_size(vdev, idx),
940                               0, 0);
941 fail_alloc_avail:
942     cpu_physical_memory_unmap(vq->desc, virtio_queue_get_desc_size(vdev, idx),
943                               0, 0);
944 fail_alloc_desc:
945     return r;
946 }
947 
948 static void vhost_virtqueue_stop(struct vhost_dev *dev,
949                                     struct VirtIODevice *vdev,
950                                     struct vhost_virtqueue *vq,
951                                     unsigned idx)
952 {
953     int vhost_vq_index = dev->vhost_ops->vhost_get_vq_index(dev, idx);
954     struct vhost_vring_state state = {
955         .index = vhost_vq_index,
956     };
957     int r;
958 
959     r = dev->vhost_ops->vhost_get_vring_base(dev, &state);
960     if (r < 0) {
961         VHOST_OPS_DEBUG("vhost VQ %d ring restore failed: %d", idx, r);
962     } else {
963         virtio_queue_set_last_avail_idx(vdev, idx, state.num);
964     }
965     virtio_queue_invalidate_signalled_used(vdev, idx);
966 
967     /* In the cross-endian case, we need to reset the vring endianness to
968      * native as legacy devices expect so by default.
969      */
970     if (vhost_needs_vring_endian(vdev)) {
971         vhost_virtqueue_set_vring_endian_legacy(dev,
972                                                 !virtio_is_big_endian(vdev),
973                                                 vhost_vq_index);
974     }
975 
976     cpu_physical_memory_unmap(vq->ring, virtio_queue_get_ring_size(vdev, idx),
977                               0, virtio_queue_get_ring_size(vdev, idx));
978     cpu_physical_memory_unmap(vq->used, virtio_queue_get_used_size(vdev, idx),
979                               1, virtio_queue_get_used_size(vdev, idx));
980     cpu_physical_memory_unmap(vq->avail, virtio_queue_get_avail_size(vdev, idx),
981                               0, virtio_queue_get_avail_size(vdev, idx));
982     cpu_physical_memory_unmap(vq->desc, virtio_queue_get_desc_size(vdev, idx),
983                               0, virtio_queue_get_desc_size(vdev, idx));
984 }
985 
986 static void vhost_eventfd_add(MemoryListener *listener,
987                               MemoryRegionSection *section,
988                               bool match_data, uint64_t data, EventNotifier *e)
989 {
990 }
991 
992 static void vhost_eventfd_del(MemoryListener *listener,
993                               MemoryRegionSection *section,
994                               bool match_data, uint64_t data, EventNotifier *e)
995 {
996 }
997 
998 static int vhost_virtqueue_set_busyloop_timeout(struct vhost_dev *dev,
999                                                 int n, uint32_t timeout)
1000 {
1001     int vhost_vq_index = dev->vhost_ops->vhost_get_vq_index(dev, n);
1002     struct vhost_vring_state state = {
1003         .index = vhost_vq_index,
1004         .num = timeout,
1005     };
1006     int r;
1007 
1008     if (!dev->vhost_ops->vhost_set_vring_busyloop_timeout) {
1009         return -EINVAL;
1010     }
1011 
1012     r = dev->vhost_ops->vhost_set_vring_busyloop_timeout(dev, &state);
1013     if (r) {
1014         VHOST_OPS_DEBUG("vhost_set_vring_busyloop_timeout failed");
1015         return r;
1016     }
1017 
1018     return 0;
1019 }
1020 
1021 static int vhost_virtqueue_init(struct vhost_dev *dev,
1022                                 struct vhost_virtqueue *vq, int n)
1023 {
1024     int vhost_vq_index = dev->vhost_ops->vhost_get_vq_index(dev, n);
1025     struct vhost_vring_file file = {
1026         .index = vhost_vq_index,
1027     };
1028     int r = event_notifier_init(&vq->masked_notifier, 0);
1029     if (r < 0) {
1030         return r;
1031     }
1032 
1033     file.fd = event_notifier_get_fd(&vq->masked_notifier);
1034     r = dev->vhost_ops->vhost_set_vring_call(dev, &file);
1035     if (r) {
1036         VHOST_OPS_DEBUG("vhost_set_vring_call failed");
1037         r = -errno;
1038         goto fail_call;
1039     }
1040     return 0;
1041 fail_call:
1042     event_notifier_cleanup(&vq->masked_notifier);
1043     return r;
1044 }
1045 
1046 static void vhost_virtqueue_cleanup(struct vhost_virtqueue *vq)
1047 {
1048     event_notifier_cleanup(&vq->masked_notifier);
1049 }
1050 
1051 int vhost_dev_init(struct vhost_dev *hdev, void *opaque,
1052                    VhostBackendType backend_type, uint32_t busyloop_timeout)
1053 {
1054     uint64_t features;
1055     int i, r, n_initialized_vqs = 0;
1056 
1057     hdev->migration_blocker = NULL;
1058 
1059     r = vhost_set_backend_type(hdev, backend_type);
1060     assert(r >= 0);
1061 
1062     r = hdev->vhost_ops->vhost_backend_init(hdev, opaque);
1063     if (r < 0) {
1064         goto fail;
1065     }
1066 
1067     if (used_memslots > hdev->vhost_ops->vhost_backend_memslots_limit(hdev)) {
1068         error_report("vhost backend memory slots limit is less"
1069                 " than current number of present memory slots");
1070         r = -1;
1071         goto fail;
1072     }
1073 
1074     r = hdev->vhost_ops->vhost_set_owner(hdev);
1075     if (r < 0) {
1076         VHOST_OPS_DEBUG("vhost_set_owner failed");
1077         goto fail;
1078     }
1079 
1080     r = hdev->vhost_ops->vhost_get_features(hdev, &features);
1081     if (r < 0) {
1082         VHOST_OPS_DEBUG("vhost_get_features failed");
1083         goto fail;
1084     }
1085 
1086     for (i = 0; i < hdev->nvqs; ++i, ++n_initialized_vqs) {
1087         r = vhost_virtqueue_init(hdev, hdev->vqs + i, hdev->vq_index + i);
1088         if (r < 0) {
1089             goto fail;
1090         }
1091     }
1092 
1093     if (busyloop_timeout) {
1094         for (i = 0; i < hdev->nvqs; ++i) {
1095             r = vhost_virtqueue_set_busyloop_timeout(hdev, hdev->vq_index + i,
1096                                                      busyloop_timeout);
1097             if (r < 0) {
1098                 goto fail_busyloop;
1099             }
1100         }
1101     }
1102 
1103     hdev->features = features;
1104 
1105     hdev->memory_listener = (MemoryListener) {
1106         .begin = vhost_begin,
1107         .commit = vhost_commit,
1108         .region_add = vhost_region_add,
1109         .region_del = vhost_region_del,
1110         .region_nop = vhost_region_nop,
1111         .log_start = vhost_log_start,
1112         .log_stop = vhost_log_stop,
1113         .log_sync = vhost_log_sync,
1114         .log_global_start = vhost_log_global_start,
1115         .log_global_stop = vhost_log_global_stop,
1116         .eventfd_add = vhost_eventfd_add,
1117         .eventfd_del = vhost_eventfd_del,
1118         .priority = 10
1119     };
1120 
1121     if (hdev->migration_blocker == NULL) {
1122         if (!(hdev->features & (0x1ULL << VHOST_F_LOG_ALL))) {
1123             error_setg(&hdev->migration_blocker,
1124                        "Migration disabled: vhost lacks VHOST_F_LOG_ALL feature.");
1125         } else if (!qemu_memfd_check()) {
1126             error_setg(&hdev->migration_blocker,
1127                        "Migration disabled: failed to allocate shared memory");
1128         }
1129     }
1130 
1131     if (hdev->migration_blocker != NULL) {
1132         migrate_add_blocker(hdev->migration_blocker);
1133     }
1134 
1135     hdev->mem = g_malloc0(offsetof(struct vhost_memory, regions));
1136     hdev->n_mem_sections = 0;
1137     hdev->mem_sections = NULL;
1138     hdev->log = NULL;
1139     hdev->log_size = 0;
1140     hdev->log_enabled = false;
1141     hdev->started = false;
1142     hdev->memory_changed = false;
1143     memory_listener_register(&hdev->memory_listener, &address_space_memory);
1144     QLIST_INSERT_HEAD(&vhost_devices, hdev, entry);
1145     return 0;
1146 
1147 fail_busyloop:
1148     while (--i >= 0) {
1149         vhost_virtqueue_set_busyloop_timeout(hdev, hdev->vq_index + i, 0);
1150     }
1151 fail:
1152     hdev->nvqs = n_initialized_vqs;
1153     vhost_dev_cleanup(hdev);
1154     return r;
1155 }
1156 
1157 void vhost_dev_cleanup(struct vhost_dev *hdev)
1158 {
1159     int i;
1160 
1161     for (i = 0; i < hdev->nvqs; ++i) {
1162         vhost_virtqueue_cleanup(hdev->vqs + i);
1163     }
1164     if (hdev->mem) {
1165         /* those are only safe after successful init */
1166         memory_listener_unregister(&hdev->memory_listener);
1167         QLIST_REMOVE(hdev, entry);
1168     }
1169     if (hdev->migration_blocker) {
1170         migrate_del_blocker(hdev->migration_blocker);
1171         error_free(hdev->migration_blocker);
1172     }
1173     g_free(hdev->mem);
1174     g_free(hdev->mem_sections);
1175     if (hdev->vhost_ops) {
1176         hdev->vhost_ops->vhost_backend_cleanup(hdev);
1177     }
1178     assert(!hdev->log);
1179 
1180     memset(hdev, 0, sizeof(struct vhost_dev));
1181 }
1182 
1183 /* Stop processing guest IO notifications in qemu.
1184  * Start processing them in vhost in kernel.
1185  */
1186 int vhost_dev_enable_notifiers(struct vhost_dev *hdev, VirtIODevice *vdev)
1187 {
1188     BusState *qbus = BUS(qdev_get_parent_bus(DEVICE(vdev)));
1189     VirtioBusState *vbus = VIRTIO_BUS(qbus);
1190     VirtioBusClass *k = VIRTIO_BUS_GET_CLASS(vbus);
1191     int i, r, e;
1192 
1193     if (!k->ioeventfd_started) {
1194         error_report("binding does not support host notifiers");
1195         r = -ENOSYS;
1196         goto fail;
1197     }
1198 
1199     for (i = 0; i < hdev->nvqs; ++i) {
1200         r = virtio_bus_set_host_notifier(VIRTIO_BUS(qbus), hdev->vq_index + i,
1201                                          true);
1202         if (r < 0) {
1203             error_report("vhost VQ %d notifier binding failed: %d", i, -r);
1204             goto fail_vq;
1205         }
1206     }
1207 
1208     return 0;
1209 fail_vq:
1210     while (--i >= 0) {
1211         e = virtio_bus_set_host_notifier(VIRTIO_BUS(qbus), hdev->vq_index + i,
1212                                          false);
1213         if (e < 0) {
1214             error_report("vhost VQ %d notifier cleanup error: %d", i, -r);
1215         }
1216         assert (e >= 0);
1217     }
1218 fail:
1219     return r;
1220 }
1221 
1222 /* Stop processing guest IO notifications in vhost.
1223  * Start processing them in qemu.
1224  * This might actually run the qemu handlers right away,
1225  * so virtio in qemu must be completely setup when this is called.
1226  */
1227 void vhost_dev_disable_notifiers(struct vhost_dev *hdev, VirtIODevice *vdev)
1228 {
1229     BusState *qbus = BUS(qdev_get_parent_bus(DEVICE(vdev)));
1230     int i, r;
1231 
1232     for (i = 0; i < hdev->nvqs; ++i) {
1233         r = virtio_bus_set_host_notifier(VIRTIO_BUS(qbus), hdev->vq_index + i,
1234                                          false);
1235         if (r < 0) {
1236             error_report("vhost VQ %d notifier cleanup failed: %d", i, -r);
1237         }
1238         assert (r >= 0);
1239     }
1240 }
1241 
1242 /* Test and clear event pending status.
1243  * Should be called after unmask to avoid losing events.
1244  */
1245 bool vhost_virtqueue_pending(struct vhost_dev *hdev, int n)
1246 {
1247     struct vhost_virtqueue *vq = hdev->vqs + n - hdev->vq_index;
1248     assert(n >= hdev->vq_index && n < hdev->vq_index + hdev->nvqs);
1249     return event_notifier_test_and_clear(&vq->masked_notifier);
1250 }
1251 
1252 /* Mask/unmask events from this vq. */
1253 void vhost_virtqueue_mask(struct vhost_dev *hdev, VirtIODevice *vdev, int n,
1254                          bool mask)
1255 {
1256     struct VirtQueue *vvq = virtio_get_queue(vdev, n);
1257     int r, index = n - hdev->vq_index;
1258     struct vhost_vring_file file;
1259 
1260     /* should only be called after backend is connected */
1261     assert(hdev->vhost_ops);
1262 
1263     if (mask) {
1264         assert(vdev->use_guest_notifier_mask);
1265         file.fd = event_notifier_get_fd(&hdev->vqs[index].masked_notifier);
1266     } else {
1267         file.fd = event_notifier_get_fd(virtio_queue_get_guest_notifier(vvq));
1268     }
1269 
1270     file.index = hdev->vhost_ops->vhost_get_vq_index(hdev, n);
1271     r = hdev->vhost_ops->vhost_set_vring_call(hdev, &file);
1272     if (r < 0) {
1273         VHOST_OPS_DEBUG("vhost_set_vring_call failed");
1274     }
1275 }
1276 
1277 uint64_t vhost_get_features(struct vhost_dev *hdev, const int *feature_bits,
1278                             uint64_t features)
1279 {
1280     const int *bit = feature_bits;
1281     while (*bit != VHOST_INVALID_FEATURE_BIT) {
1282         uint64_t bit_mask = (1ULL << *bit);
1283         if (!(hdev->features & bit_mask)) {
1284             features &= ~bit_mask;
1285         }
1286         bit++;
1287     }
1288     return features;
1289 }
1290 
1291 void vhost_ack_features(struct vhost_dev *hdev, const int *feature_bits,
1292                         uint64_t features)
1293 {
1294     const int *bit = feature_bits;
1295     while (*bit != VHOST_INVALID_FEATURE_BIT) {
1296         uint64_t bit_mask = (1ULL << *bit);
1297         if (features & bit_mask) {
1298             hdev->acked_features |= bit_mask;
1299         }
1300         bit++;
1301     }
1302 }
1303 
1304 /* Host notifiers must be enabled at this point. */
1305 int vhost_dev_start(struct vhost_dev *hdev, VirtIODevice *vdev)
1306 {
1307     int i, r;
1308 
1309     /* should only be called after backend is connected */
1310     assert(hdev->vhost_ops);
1311 
1312     hdev->started = true;
1313 
1314     r = vhost_dev_set_features(hdev, hdev->log_enabled);
1315     if (r < 0) {
1316         goto fail_features;
1317     }
1318     r = hdev->vhost_ops->vhost_set_mem_table(hdev, hdev->mem);
1319     if (r < 0) {
1320         VHOST_OPS_DEBUG("vhost_set_mem_table failed");
1321         r = -errno;
1322         goto fail_mem;
1323     }
1324     for (i = 0; i < hdev->nvqs; ++i) {
1325         r = vhost_virtqueue_start(hdev,
1326                                   vdev,
1327                                   hdev->vqs + i,
1328                                   hdev->vq_index + i);
1329         if (r < 0) {
1330             goto fail_vq;
1331         }
1332     }
1333 
1334     if (hdev->log_enabled) {
1335         uint64_t log_base;
1336 
1337         hdev->log_size = vhost_get_log_size(hdev);
1338         hdev->log = vhost_log_get(hdev->log_size,
1339                                   vhost_dev_log_is_shared(hdev));
1340         log_base = (uintptr_t)hdev->log->log;
1341         r = hdev->vhost_ops->vhost_set_log_base(hdev,
1342                                                 hdev->log_size ? log_base : 0,
1343                                                 hdev->log);
1344         if (r < 0) {
1345             VHOST_OPS_DEBUG("vhost_set_log_base failed");
1346             r = -errno;
1347             goto fail_log;
1348         }
1349     }
1350 
1351     return 0;
1352 fail_log:
1353     vhost_log_put(hdev, false);
1354 fail_vq:
1355     while (--i >= 0) {
1356         vhost_virtqueue_stop(hdev,
1357                              vdev,
1358                              hdev->vqs + i,
1359                              hdev->vq_index + i);
1360     }
1361     i = hdev->nvqs;
1362 fail_mem:
1363 fail_features:
1364 
1365     hdev->started = false;
1366     return r;
1367 }
1368 
1369 /* Host notifiers must be enabled at this point. */
1370 void vhost_dev_stop(struct vhost_dev *hdev, VirtIODevice *vdev)
1371 {
1372     int i;
1373 
1374     /* should only be called after backend is connected */
1375     assert(hdev->vhost_ops);
1376 
1377     for (i = 0; i < hdev->nvqs; ++i) {
1378         vhost_virtqueue_stop(hdev,
1379                              vdev,
1380                              hdev->vqs + i,
1381                              hdev->vq_index + i);
1382     }
1383 
1384     vhost_log_put(hdev, true);
1385     hdev->started = false;
1386 }
1387 
1388 int vhost_net_set_backend(struct vhost_dev *hdev,
1389                           struct vhost_vring_file *file)
1390 {
1391     if (hdev->vhost_ops->vhost_net_set_backend) {
1392         return hdev->vhost_ops->vhost_net_set_backend(hdev, file);
1393     }
1394 
1395     return -1;
1396 }
1397