virtio-ring.c File Reference

#include "etherboot.h"
#include "ipxe/io.h"
#include "ipxe/virtio-pci.h"
#include "ipxe/virtio-ring.h"

Go to the source code of this file.

Macros
#define	BUG()
#define	BUG_ON(condition)

Functions
	FILE_LICENCE (GPL2_OR_LATER)
void	vring_detach (struct vring_virtqueue *vq, unsigned int head)
void *	vring_get_buf (struct vring_virtqueue *vq, unsigned int *len)
void	vring_add_buf (struct vring_virtqueue *vq, struct vring_list list[], unsigned int out, unsigned int in, void *opaque, int num_added)
void	vring_kick (struct virtio_pci_modern_device *vdev, unsigned int ioaddr, struct vring_virtqueue *vq, int num_added)

Macro Definition Documentation

BUG

#define BUG

(

)

Value:

   do { \
   printf("BUG: failure at %s:%d/%s()!\n", \
          __FILE__, __LINE__, __FUNCTION__); \
   while(1); \
} while (0)

Definition at line 24 of file virtio-ring.c.

#define BUG() do { \
   printf("BUG: failure at %s:%d/%s()!\n", \
          __FILE__, __LINE__, __FUNCTION__); \
   while(1); \
} while (0)

BUG_ON

#define BUG_ON

(

condition

)

Value:

do { if (condition) BUG(); } while (0)

Definition at line 29 of file virtio-ring.c.

Referenced by vring_add_buf(), and vring_get_buf().

Function Documentation

FILE_LICENCE()

FILE_LICENCE

(

GPL2_OR_LATER

)

vring_detach()

void vring_detach	(	struct vring_virtqueue *	vq,
		unsigned int	head )

Definition at line 37 of file virtio-ring.c.

{
   struct vring *vr = &vq->vring;
   unsigned int i;
 
   /* find end of given descriptor */
 
   i = head;
   while (vr->desc[i].flags & VRING_DESC_F_NEXT)
           i = vr->desc[i].next;
 
   /* link it with free list and point to it */
 
   vr->desc[i].next = vq->free_head;
   wmb();
   vq->free_head = head;
}

References vring::desc, vring_desc::flags, vring_virtqueue::free_head, head, vring_desc::next, vring_virtqueue::vring, VRING_DESC_F_NEXT, and wmb.

Referenced by vring_get_buf().

vring_get_buf()

void * vring_get_buf	(	struct vring_virtqueue *	vq,
		unsigned int *	len )

Definition at line 62 of file virtio-ring.c.

{
   struct vring *vr = &vq->vring;
   struct vring_used_elem *elem;
   u32 id;
   void *opaque;
 
   BUG_ON(!vring_more_used(vq));
 
   elem = &vr->used->ring[vq->last_used_idx % vr->num];
   wmb();
   id = elem->id;
   if (len != NULL)
           *len = elem->len;
 
   opaque = vq->vdata[id];
 
   vring_detach(vq, id);
 
   vq->last_used_idx++;
 
   return opaque;
}

References BUG_ON, id, vring_used_elem::id, vring_virtqueue::last_used_idx, len, vring_used_elem::len, NULL, vring::num, vring_used::ring, u32, vring::used, vring_virtqueue::vdata, vring_virtqueue::vring, vring_detach(), vring_more_used(), and wmb.

Referenced by virtnet_process_rx_packets(), and virtnet_process_tx_packets().

vring_add_buf()

void vring_add_buf	(	struct vring_virtqueue *	vq,
		struct vring_list	list[],
		unsigned int	out,
		unsigned int	in,
		void *	opaque,
		int	num_added )

Definition at line 86 of file virtio-ring.c.

{
   struct vring *vr = &vq->vring;
   int i, avail, head, prev;
 
   BUG_ON(out + in == 0);
 
   prev = 0;
   head = vq->free_head;
   for (i = head; out; i = vr->desc[i].next, out--) {
 
           vr->desc[i].flags = VRING_DESC_F_NEXT;
           vr->desc[i].addr = list->addr;
           vr->desc[i].len = list->length;
           prev = i;
           list++;
   }
   for ( ; in; i = vr->desc[i].next, in--) {
 
           vr->desc[i].flags = VRING_DESC_F_NEXT|VRING_DESC_F_WRITE;
           vr->desc[i].addr = list->addr;
           vr->desc[i].len = list->length;
           prev = i;
           list++;
   }
   vr->desc[prev].flags &= ~VRING_DESC_F_NEXT;
 
   vq->free_head = i;
 
   vq->vdata[head] = opaque;
 
   avail = (vr->avail->idx + num_added) % vr->num;
   vr->avail->ring[avail] = head;
   wmb();
}

References vring_desc::addr, vring_list::addr, vring::avail, BUG_ON, vring::desc, vring_desc::flags, vring_virtqueue::free_head, head, vring_avail::idx, in, vring_desc::len, vring_list::length, vring_desc::next, vring::num, out, vring_avail::ring, vring_virtqueue::vdata, vring_virtqueue::vring, VRING_DESC_F_NEXT, VRING_DESC_F_WRITE, and wmb.

Referenced by virtnet_enqueue_iob().

vring_kick()

void vring_kick	(	struct virtio_pci_modern_device *	vdev,
		unsigned int	ioaddr,
		struct vring_virtqueue *	vq,
		int	num_added )

Definition at line 125 of file virtio-ring.c.

{
   struct vring *vr = &vq->vring;
 
   wmb();
   vr->avail->idx += num_added;
 
   mb();
   if (!(vr->used->flags & VRING_USED_F_NO_NOTIFY)) {
           if (vdev) {
                   /* virtio 1.0 */
                   vpm_notify(vdev, vq);
           } else {
                   /* legacy virtio */
                   vp_notify(ioaddr, vq->queue_index);
           }
   }
}

References vring::avail, vring_used::flags, vring_avail::idx, ioaddr, mb(), vring_virtqueue::queue_index, vring::used, vp_notify(), vpm_notify(), vring_virtqueue::vring, VRING_USED_F_NO_NOTIFY, and wmb.

Referenced by virtnet_enqueue_iob().