git: fbe0c4f4c7f4 - main - virtio: Add modern (v1) virtqueue support
Jessica Clarke
jrtc27 at freebsd.org
Tue Jan 19 05:12:10 UTC 2021
Hi Bryan,
Neither of my review comments from 2.5 weeks ago were addressed.
Jess
On 19 Jan 2021, at 05:08, Bryan Venteicher <bryanv at freebsd.org> wrote:
>
> The branch main has been updated by bryanv:
>
> URL: https://cgit.FreeBSD.org/src/commit/?id=fbe0c4f4c7f4474def7b041c29c1e2facf2af08b
>
> commit fbe0c4f4c7f4474def7b041c29c1e2facf2af08b
> Author: Bryan Venteicher <bryanv at FreeBSD.org>
> AuthorDate: 2021-01-19 04:55:23 +0000
> Commit: Bryan Venteicher <bryanv at FreeBSD.org>
> CommitDate: 2021-01-19 04:55:23 +0000
>
> virtio: Add modern (v1) virtqueue support
>
> This only supports the legacy virtqueue format that is now called
> "Split Virtqueues". Support for the new "Packed Virtqueues" described
> in v1.1 is left for a later date.
>
> Reviewed by: grehan (mentor)
> Differential Revision: https://reviews.freebsd.org/D27857
> ---
> sys/dev/virtio/virtqueue.c | 141 ++++++++++++++++++++++++---------------------
> sys/dev/virtio/virtqueue.h | 2 -
> 2 files changed, 75 insertions(+), 68 deletions(-)
>
> diff --git a/sys/dev/virtio/virtqueue.c b/sys/dev/virtio/virtqueue.c
> index da6e7bf89fd5..14c2088b70a8 100644
> --- a/sys/dev/virtio/virtqueue.c
> +++ b/sys/dev/virtio/virtqueue.c
> @@ -57,19 +57,15 @@ __FBSDID("$FreeBSD$");
>
> struct virtqueue {
> device_t vq_dev;
> - char vq_name[VIRTQUEUE_MAX_NAME_SZ];
> uint16_t vq_queue_index;
> uint16_t vq_nentries;
> uint32_t vq_flags;
> -#define VIRTQUEUE_FLAG_INDIRECT 0x0001
> -#define VIRTQUEUE_FLAG_EVENT_IDX 0x0002
> +#define VIRTQUEUE_FLAG_MODERN 0x0001
> +#define VIRTQUEUE_FLAG_INDIRECT 0x0002
> +#define VIRTQUEUE_FLAG_EVENT_IDX 0x0004
>
> - bus_size_t vq_notify_offset;
> - int vq_alignment;
> - int vq_ring_size;
> - void *vq_ring_mem;
> int vq_max_indirect_size;
> - int vq_indirect_mem_size;
> + bus_size_t vq_notify_offset;
> virtqueue_intr_t *vq_intrhand;
> void *vq_intrhand_arg;
>
> @@ -88,6 +84,12 @@ struct virtqueue {
> */
> uint16_t vq_used_cons_idx;
>
> + void *vq_ring_mem;
> + int vq_indirect_mem_size;
> + int vq_alignment;
> + int vq_ring_size;
> + char vq_name[VIRTQUEUE_MAX_NAME_SZ];
> +
> struct vq_desc_extra {
> void *cookie;
> struct vring_desc *indirect;
> @@ -135,17 +137,13 @@ static int vq_ring_must_notify_host(struct virtqueue *);
> static void vq_ring_notify_host(struct virtqueue *);
> static void vq_ring_free_chain(struct virtqueue *, uint16_t);
>
> -uint64_t
> -virtqueue_filter_features(uint64_t features)
> -{
> - uint64_t mask;
> -
> - mask = (1 << VIRTIO_TRANSPORT_F_START) - 1;
> - mask |= VIRTIO_RING_F_INDIRECT_DESC;
> - mask |= VIRTIO_RING_F_EVENT_IDX;
> -
> - return (features & mask);
> -}
> +#define vq_modern(_vq) (((_vq)->vq_flags & VIRTQUEUE_FLAG_MODERN) != 0)
> +#define vq_htog16(_vq, _val) virtio_htog16(vq_modern(_vq), _val)
> +#define vq_htog32(_vq, _val) virtio_htog32(vq_modern(_vq), _val)
> +#define vq_htog64(_vq, _val) virtio_htog64(vq_modern(_vq), _val)
> +#define vq_gtoh16(_vq, _val) virtio_gtoh16(vq_modern(_vq), _val)
> +#define vq_gtoh32(_vq, _val) virtio_gtoh32(vq_modern(_vq), _val)
> +#define vq_gtoh64(_vq, _val) virtio_gtoh64(vq_modern(_vq), _val)
>
> int
> virtqueue_alloc(device_t dev, uint16_t queue, uint16_t size,
> @@ -193,6 +191,8 @@ virtqueue_alloc(device_t dev, uint16_t queue, uint16_t size,
> vq->vq_intrhand = info->vqai_intr;
> vq->vq_intrhand_arg = info->vqai_intr_arg;
>
> + if (VIRTIO_BUS_WITH_FEATURE(dev, VIRTIO_F_VERSION_1) != 0)
> + vq->vq_flags |= VIRTQUEUE_FLAG_MODERN;
> if (VIRTIO_BUS_WITH_FEATURE(dev, VIRTIO_RING_F_EVENT_IDX) != 0)
> vq->vq_flags |= VIRTQUEUE_FLAG_EVENT_IDX;
>
> @@ -297,8 +297,8 @@ virtqueue_init_indirect_list(struct virtqueue *vq,
> bzero(indirect, vq->vq_indirect_mem_size);
>
> for (i = 0; i < vq->vq_max_indirect_size - 1; i++)
> - indirect[i].next = i + 1;
> - indirect[i].next = VQ_RING_DESC_CHAIN_END;
> + indirect[i].next = vq_gtoh16(vq, i + 1);
> + indirect[i].next = vq_gtoh16(vq, VQ_RING_DESC_CHAIN_END);
> }
>
> int
> @@ -396,6 +396,7 @@ virtqueue_used_paddr(struct virtqueue *vq)
> uint16_t
> virtqueue_index(struct virtqueue *vq)
> {
> +
> return (vq->vq_queue_index);
> }
>
> @@ -444,7 +445,7 @@ virtqueue_nused(struct virtqueue *vq)
> {
> uint16_t used_idx, nused;
>
> - used_idx = vq->vq_ring.used->idx;
> + used_idx = vq_htog16(vq, vq->vq_ring.used->idx);
>
> nused = (uint16_t)(used_idx - vq->vq_used_cons_idx);
> VQASSERT(vq, nused <= vq->vq_nentries, "used more than available");
> @@ -456,7 +457,7 @@ int
> virtqueue_intr_filter(struct virtqueue *vq)
> {
>
> - if (vq->vq_used_cons_idx == vq->vq_ring.used->idx)
> + if (vq->vq_used_cons_idx == vq_htog16(vq, vq->vq_ring.used->idx))
> return (0);
>
> virtqueue_disable_intr(vq);
> @@ -483,7 +484,7 @@ virtqueue_postpone_intr(struct virtqueue *vq, vq_postpone_t hint)
> {
> uint16_t ndesc, avail_idx;
>
> - avail_idx = vq->vq_ring.avail->idx;
> + avail_idx = vq_htog16(vq, vq->vq_ring.avail->idx);
> ndesc = (uint16_t)(avail_idx - vq->vq_used_cons_idx);
>
> switch (hint) {
> @@ -508,10 +509,12 @@ virtqueue_disable_intr(struct virtqueue *vq)
> {
>
> if (vq->vq_flags & VIRTQUEUE_FLAG_EVENT_IDX) {
> - vring_used_event(&vq->vq_ring) = vq->vq_used_cons_idx -
> - vq->vq_nentries - 1;
> - } else
> - vq->vq_ring.avail->flags |= VRING_AVAIL_F_NO_INTERRUPT;
> + vring_used_event(&vq->vq_ring) = vq_gtoh16(vq,
> + vq->vq_used_cons_idx - vq->vq_nentries - 1);
> + return;
> + }
> +
> + vq->vq_ring.avail->flags |= vq_gtoh16(vq, VRING_AVAIL_F_NO_INTERRUPT);
> }
>
> int
> @@ -574,16 +577,16 @@ virtqueue_dequeue(struct virtqueue *vq, uint32_t *len)
> void *cookie;
> uint16_t used_idx, desc_idx;
>
> - if (vq->vq_used_cons_idx == vq->vq_ring.used->idx)
> + if (vq->vq_used_cons_idx == vq_htog16(vq, vq->vq_ring.used->idx))
> return (NULL);
>
> used_idx = vq->vq_used_cons_idx++ & (vq->vq_nentries - 1);
> uep = &vq->vq_ring.used->ring[used_idx];
>
> rmb();
> - desc_idx = (uint16_t) uep->id;
> + desc_idx = (uint16_t) vq_htog32(vq, uep->id);
> if (len != NULL)
> - *len = uep->len;
> + *len = vq_htog32(vq, uep->len);
>
> vq_ring_free_chain(vq, desc_idx);
>
> @@ -641,13 +644,13 @@ virtqueue_dump(struct virtqueue *vq)
> printf("VQ: %s - size=%d; free=%d; used=%d; queued=%d; "
> "desc_head_idx=%d; avail.idx=%d; used_cons_idx=%d; "
> "used.idx=%d; used_event_idx=%d; avail.flags=0x%x; used.flags=0x%x\n",
> - vq->vq_name, vq->vq_nentries, vq->vq_free_cnt,
> - virtqueue_nused(vq), vq->vq_queued_cnt, vq->vq_desc_head_idx,
> - vq->vq_ring.avail->idx, vq->vq_used_cons_idx,
> - vq->vq_ring.used->idx,
> - vring_used_event(&vq->vq_ring),
> - vq->vq_ring.avail->flags,
> - vq->vq_ring.used->flags);
> + vq->vq_name, vq->vq_nentries, vq->vq_free_cnt, virtqueue_nused(vq),
> + vq->vq_queued_cnt, vq->vq_desc_head_idx,
> + vq_htog16(vq, vq->vq_ring.avail->idx), vq->vq_used_cons_idx,
> + vq_htog16(vq, vq->vq_ring.used->idx),
> + vq_htog16(vq, vring_used_event(&vq->vq_ring)),
> + vq_htog16(vq, vq->vq_ring.avail->flags),
> + vq_htog16(vq, vq->vq_ring.used->flags));
> }
>
> static void
> @@ -664,14 +667,14 @@ vq_ring_init(struct virtqueue *vq)
> vring_init(vr, size, ring_mem, vq->vq_alignment);
>
> for (i = 0; i < size - 1; i++)
> - vr->desc[i].next = i + 1;
> - vr->desc[i].next = VQ_RING_DESC_CHAIN_END;
> + vr->desc[i].next = vq_gtoh16(vq, i + 1);
> + vr->desc[i].next = vq_gtoh16(vq, VQ_RING_DESC_CHAIN_END);
> }
>
> static void
> vq_ring_update_avail(struct virtqueue *vq, uint16_t desc_idx)
> {
> - uint16_t avail_idx;
> + uint16_t avail_idx, avail_ring_idx;
>
> /*
> * Place the head of the descriptor chain into the next slot and make
> @@ -680,11 +683,12 @@ vq_ring_update_avail(struct virtqueue *vq, uint16_t desc_idx)
> * currently running on another CPU, we can keep it processing the new
> * descriptor.
> */
> - avail_idx = vq->vq_ring.avail->idx & (vq->vq_nentries - 1);
> - vq->vq_ring.avail->ring[avail_idx] = desc_idx;
> + avail_idx = vq_htog16(vq, vq->vq_ring.avail->idx);
> + avail_ring_idx = avail_idx & (vq->vq_nentries - 1);
> + vq->vq_ring.avail->ring[avail_ring_idx] = vq_gtoh16(vq, desc_idx);
>
> wmb();
> - vq->vq_ring.avail->idx++;
> + vq->vq_ring.avail->idx = vq_gtoh16(vq, avail_idx + 1);
>
> /* Keep pending count until virtqueue_notify(). */
> vq->vq_queued_cnt++;
> @@ -703,19 +707,19 @@ vq_ring_enqueue_segments(struct virtqueue *vq, struct vring_desc *desc,
>
> for (i = 0, idx = head_idx, seg = sg->sg_segs;
> i < needed;
> - i++, idx = dp->next, seg++) {
> + i++, idx = vq_htog16(vq, dp->next), seg++) {
> VQASSERT(vq, idx != VQ_RING_DESC_CHAIN_END,
> "premature end of free desc chain");
>
> dp = &desc[idx];
> - dp->addr = seg->ss_paddr;
> - dp->len = seg->ss_len;
> + dp->addr = vq_gtoh64(vq, seg->ss_paddr);
> + dp->len = vq_gtoh32(vq, seg->ss_len);
> dp->flags = 0;
>
> if (i < needed - 1)
> - dp->flags |= VRING_DESC_F_NEXT;
> + dp->flags |= vq_gtoh16(vq, VRING_DESC_F_NEXT);
> if (i >= readable)
> - dp->flags |= VRING_DESC_F_WRITE;
> + dp->flags |= vq_gtoh16(vq, VRING_DESC_F_WRITE);
> }
>
> return (idx);
> @@ -760,14 +764,14 @@ vq_ring_enqueue_indirect(struct virtqueue *vq, void *cookie,
> dxp->cookie = cookie;
> dxp->ndescs = 1;
>
> - dp->addr = dxp->indirect_paddr;
> - dp->len = needed * sizeof(struct vring_desc);
> - dp->flags = VRING_DESC_F_INDIRECT;
> + dp->addr = vq_gtoh64(vq, dxp->indirect_paddr);
> + dp->len = vq_gtoh32(vq, needed * sizeof(struct vring_desc));
> + dp->flags = vq_gtoh16(vq, VRING_DESC_F_INDIRECT);
>
> vq_ring_enqueue_segments(vq, dxp->indirect, 0,
> sg, readable, writable);
>
> - vq->vq_desc_head_idx = dp->next;
> + vq->vq_desc_head_idx = vq_htog16(vq, dp->next);
> vq->vq_free_cnt--;
> if (vq->vq_free_cnt == 0)
> VQ_RING_ASSERT_CHAIN_TERM(vq);
> @@ -785,10 +789,13 @@ vq_ring_enable_interrupt(struct virtqueue *vq, uint16_t ndesc)
> * Enable interrupts, making sure we get the latest index of
> * what's already been consumed.
> */
> - if (vq->vq_flags & VIRTQUEUE_FLAG_EVENT_IDX)
> - vring_used_event(&vq->vq_ring) = vq->vq_used_cons_idx + ndesc;
> - else
> - vq->vq_ring.avail->flags &= ~VRING_AVAIL_F_NO_INTERRUPT;
> + if (vq->vq_flags & VIRTQUEUE_FLAG_EVENT_IDX) {
> + vring_used_event(&vq->vq_ring) =
> + vq_gtoh16(vq, vq->vq_used_cons_idx + ndesc);
> + } else {
> + vq->vq_ring.avail->flags &=
> + vq_gtoh16(vq, ~VRING_AVAIL_F_NO_INTERRUPT);
> + }
>
> mb();
>
> @@ -806,17 +813,18 @@ vq_ring_enable_interrupt(struct virtqueue *vq, uint16_t ndesc)
> static int
> vq_ring_must_notify_host(struct virtqueue *vq)
> {
> - uint16_t new_idx, prev_idx, event_idx;
> + uint16_t new_idx, prev_idx, event_idx, flags;
>
> if (vq->vq_flags & VIRTQUEUE_FLAG_EVENT_IDX) {
> - new_idx = vq->vq_ring.avail->idx;
> + new_idx = vq_htog16(vq, vq->vq_ring.avail->idx);
> prev_idx = new_idx - vq->vq_queued_cnt;
> - event_idx = vring_avail_event(&vq->vq_ring);
> + event_idx = vq_htog16(vq, vring_avail_event(&vq->vq_ring));
>
> return (vring_need_event(event_idx, new_idx, prev_idx) != 0);
> }
>
> - return ((vq->vq_ring.used->flags & VRING_USED_F_NO_NOTIFY) == 0);
> + flags = vq->vq_ring.used->flags;
> + return ((flags & vq_gtoh16(vq, VRING_USED_F_NO_NOTIFY)) == 0);
> }
>
> static void
> @@ -843,10 +851,11 @@ vq_ring_free_chain(struct virtqueue *vq, uint16_t desc_idx)
> vq->vq_free_cnt += dxp->ndescs;
> dxp->ndescs--;
>
> - if ((dp->flags & VRING_DESC_F_INDIRECT) == 0) {
> - while (dp->flags & VRING_DESC_F_NEXT) {
> - VQ_RING_ASSERT_VALID_IDX(vq, dp->next);
> - dp = &vq->vq_ring.desc[dp->next];
> + if ((dp->flags & vq_gtoh16(vq, VRING_DESC_F_INDIRECT)) == 0) {
> + while (dp->flags & vq_gtoh16(vq, VRING_DESC_F_NEXT)) {
> + uint16_t next_idx = vq_htog16(vq, dp->next);
> + VQ_RING_ASSERT_VALID_IDX(vq, next_idx);
> + dp = &vq->vq_ring.desc[next_idx];
> dxp->ndescs--;
> }
> }
> @@ -859,6 +868,6 @@ vq_ring_free_chain(struct virtqueue *vq, uint16_t desc_idx)
> * newly freed chain. If the virtqueue was completely used, then
> * head would be VQ_RING_DESC_CHAIN_END (ASSERTed above).
> */
> - dp->next = vq->vq_desc_head_idx;
> + dp->next = vq_gtoh16(vq, vq->vq_desc_head_idx);
> vq->vq_desc_head_idx = desc_idx;
> }
> diff --git a/sys/dev/virtio/virtqueue.h b/sys/dev/virtio/virtqueue.h
> index 6ac5899cf0c3..4bde4e32edc6 100644
> --- a/sys/dev/virtio/virtqueue.h
> +++ b/sys/dev/virtio/virtqueue.h
> @@ -67,8 +67,6 @@ struct vq_alloc_info {
> (_i)->vqai_vq = (_vqp); \
> } while (0)
>
> -uint64_t virtqueue_filter_features(uint64_t features);
> -
> int virtqueue_alloc(device_t dev, uint16_t queue, uint16_t size,
> bus_size_t notify_offset, int align, vm_paddr_t highaddr,
> struct vq_alloc_info *info, struct virtqueue **vqp);
Jess
More information about the dev-commits-src-main
mailing list