2 * Copyright (c) 2011 NetApp, Inc.
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
8 * 1. Redistributions of source code must retain the above copyright
9 * notice, this list of conditions and the following disclaimer.
10 * 2. Redistributions in binary form must reproduce the above copyright
11 * notice, this list of conditions and the following disclaimer in the
12 * documentation and/or other materials provided with the distribution.
14 * THIS SOFTWARE IS PROVIDED BY NETAPP, INC ``AS IS'' AND
15 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17 * ARE DISCLAIMED. IN NO EVENT SHALL NETAPP, INC OR CONTRIBUTORS BE LIABLE
18 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
29 #include <sys/cdefs.h>
30 __FBSDID("$FreeBSD$");
32 #include <sys/param.h>
33 #include <sys/linker_set.h>
34 #include <sys/select.h>
36 #include <sys/ioctl.h>
37 #include <net/ethernet.h>
50 #include <pthread_np.h>
57 #define VTNET_RINGSZ 1024
59 #define VTNET_MAXSEGS 32
62 * Host capabilities. Note that we only offer a few of these.
64 #define VIRTIO_NET_F_CSUM (1 << 0) /* host handles partial cksum */
65 #define VIRTIO_NET_F_GUEST_CSUM (1 << 1) /* guest handles partial cksum */
66 #define VIRTIO_NET_F_MAC (1 << 5) /* host supplies MAC */
67 #define VIRTIO_NET_F_GSO_DEPREC (1 << 6) /* deprecated: host handles GSO */
68 #define VIRTIO_NET_F_GUEST_TSO4 (1 << 7) /* guest can rcv TSOv4 */
69 #define VIRTIO_NET_F_GUEST_TSO6 (1 << 8) /* guest can rcv TSOv6 */
70 #define VIRTIO_NET_F_GUEST_ECN (1 << 9) /* guest can rcv TSO with ECN */
71 #define VIRTIO_NET_F_GUEST_UFO (1 << 10) /* guest can rcv UFO */
72 #define VIRTIO_NET_F_HOST_TSO4 (1 << 11) /* host can rcv TSOv4 */
73 #define VIRTIO_NET_F_HOST_TSO6 (1 << 12) /* host can rcv TSOv6 */
74 #define VIRTIO_NET_F_HOST_ECN (1 << 13) /* host can rcv TSO with ECN */
75 #define VIRTIO_NET_F_HOST_UFO (1 << 14) /* host can rcv UFO */
76 #define VIRTIO_NET_F_MRG_RXBUF (1 << 15) /* host can merge RX buffers */
77 #define VIRTIO_NET_F_STATUS (1 << 16) /* config status field available */
78 #define VIRTIO_NET_F_CTRL_VQ (1 << 17) /* control channel available */
79 #define VIRTIO_NET_F_CTRL_RX (1 << 18) /* control channel RX mode support */
80 #define VIRTIO_NET_F_CTRL_VLAN (1 << 19) /* control channel VLAN filtering */
81 #define VIRTIO_NET_F_GUEST_ANNOUNCE \
82 (1 << 21) /* guest can send gratuitous pkts */
84 #define VTNET_S_HOSTCAPS \
85 ( VIRTIO_NET_F_MAC | VIRTIO_NET_F_MRG_RXBUF | VIRTIO_NET_F_STATUS | \
86 VIRTIO_F_NOTIFY_ON_EMPTY)
89 * PCI config-space "registers"
91 struct virtio_net_config {
101 #define VTNET_CTLQ 2 /* NB: not yet supported */
106 * Fixed network header size
108 struct virtio_net_rxhdr {
110 uint8_t vrh_gso_type;
111 uint16_t vrh_hdr_len;
112 uint16_t vrh_gso_size;
113 uint16_t vrh_csum_start;
114 uint16_t vrh_csum_offset;
121 static int pci_vtnet_debug;
122 #define DPRINTF(params) if (pci_vtnet_debug) printf params
123 #define WPRINTF(params) printf params
128 struct pci_vtnet_softc {
129 struct virtio_softc vsc_vs;
130 struct vqueue_info vsc_queues[VTNET_MAXQ - 1];
131 pthread_mutex_t vsc_mtx;
132 struct mevent *vsc_mevp;
136 volatile int resetting; /* set and checked outside lock */
138 uint64_t vsc_features; /* negotiated features */
140 struct virtio_net_config vsc_config;
142 pthread_mutex_t rx_mtx;
145 int rx_merge; /* merged rx bufs in use */
148 pthread_mutex_t tx_mtx;
149 pthread_cond_t tx_cond;
153 static void pci_vtnet_reset(void *);
154 /* static void pci_vtnet_notify(void *, struct vqueue_info *); */
155 static int pci_vtnet_cfgread(void *, int, int, uint32_t *);
156 static int pci_vtnet_cfgwrite(void *, int, int, uint32_t);
157 static void pci_vtnet_neg_features(void *, uint64_t);
159 static struct virtio_consts vtnet_vi_consts = {
160 "vtnet", /* our name */
161 VTNET_MAXQ - 1, /* we currently support 2 virtqueues */
162 sizeof(struct virtio_net_config), /* config reg size */
163 pci_vtnet_reset, /* reset */
164 NULL, /* device-wide qnotify -- not used */
165 pci_vtnet_cfgread, /* read PCI config */
166 pci_vtnet_cfgwrite, /* write PCI config */
167 pci_vtnet_neg_features, /* apply negotiated features */
168 VTNET_S_HOSTCAPS, /* our capabilities */
172 * If the transmit thread is active then stall until it is done.
175 pci_vtnet_txwait(struct pci_vtnet_softc *sc)
178 pthread_mutex_lock(&sc->tx_mtx);
179 while (sc->tx_in_progress) {
180 pthread_mutex_unlock(&sc->tx_mtx);
182 pthread_mutex_lock(&sc->tx_mtx);
184 pthread_mutex_unlock(&sc->tx_mtx);
188 * If the receive thread is active then stall until it is done.
191 pci_vtnet_rxwait(struct pci_vtnet_softc *sc)
194 pthread_mutex_lock(&sc->rx_mtx);
195 while (sc->rx_in_progress) {
196 pthread_mutex_unlock(&sc->rx_mtx);
198 pthread_mutex_lock(&sc->rx_mtx);
200 pthread_mutex_unlock(&sc->rx_mtx);
204 pci_vtnet_reset(void *vsc)
206 struct pci_vtnet_softc *sc = vsc;
208 DPRINTF(("vtnet: device reset requested !\n"));
213 * Wait for the transmit and receive threads to finish their
216 pci_vtnet_txwait(sc);
217 pci_vtnet_rxwait(sc);
219 sc->vsc_rx_ready = 0;
221 sc->rx_vhdrlen = sizeof(struct virtio_net_rxhdr);
223 /* now reset rings, MSI-X vectors, and negotiated capabilities */
224 vi_reset_dev(&sc->vsc_vs);
230 * Called to send a buffer chain out to the tap device
233 pci_vtnet_tap_tx(struct pci_vtnet_softc *sc, struct iovec *iov, int iovcnt,
236 static char pad[60]; /* all zero bytes */
238 if (sc->vsc_tapfd == -1)
242 * If the length is < 60, pad out to that and add the
243 * extra zero'd segment to the iov. It is guaranteed that
244 * there is always an extra iov available by the caller.
247 iov[iovcnt].iov_base = pad;
248 iov[iovcnt].iov_len = 60 - len;
251 (void) writev(sc->vsc_tapfd, iov, iovcnt);
255 * Called when there is read activity on the tap file descriptor.
256 * Each buffer posted by the guest is assumed to be able to contain
257 * an entire ethernet frame + rx header.
258 * MP note: the dummybuf is only used for discarding frames, so there
259 * is no need for it to be per-vtnet or locked.
261 static uint8_t dummybuf[2048];
263 static __inline struct iovec *
264 rx_iov_trim(struct iovec *iov, int *niov, int tlen)
268 /* XXX short-cut: assume first segment is >= tlen */
269 assert(iov[0].iov_len >= tlen);
271 iov[0].iov_len -= tlen;
272 if (iov[0].iov_len == 0) {
277 iov[0].iov_base = (void *)((uintptr_t)iov[0].iov_base + tlen);
285 pci_vtnet_tap_rx(struct pci_vtnet_softc *sc)
287 struct iovec iov[VTNET_MAXSEGS], *riov;
288 struct vqueue_info *vq;
293 * Should never be called without a valid tap fd
295 assert(sc->vsc_tapfd != -1);
298 * But, will be called when the rx ring hasn't yet
299 * been set up or the guest is resetting the device.
301 if (!sc->vsc_rx_ready || sc->resetting) {
303 * Drop the packet and try later.
305 (void) read(sc->vsc_tapfd, dummybuf, sizeof(dummybuf));
310 * Check for available rx buffers
312 vq = &sc->vsc_queues[VTNET_RXQ];
314 if (!vq_has_descs(vq)) {
316 * Drop the packet and try later. Interrupt on
317 * empty, if that's negotiated.
319 (void) read(sc->vsc_tapfd, dummybuf, sizeof(dummybuf));
326 * Get descriptor chain.
328 n = vq_getchain(vq, iov, VTNET_MAXSEGS, NULL);
329 assert(n >= 1 && n <= VTNET_MAXSEGS);
332 * Get a pointer to the rx header, and use the
333 * data immediately following it for the packet buffer.
335 vrx = iov[0].iov_base;
336 riov = rx_iov_trim(iov, &n, sc->rx_vhdrlen);
338 len = readv(sc->vsc_tapfd, riov, n);
340 if (len < 0 && errno == EWOULDBLOCK) {
342 * No more packets, but still some avail ring
343 * entries. Interrupt if needed/appropriate.
350 * The only valid field in the rx packet header is the
351 * number of buffers if merged rx bufs were negotiated.
353 memset(vrx, 0, sc->rx_vhdrlen);
356 struct virtio_net_rxhdr *vrxh;
363 * Release this chain and handle more chains.
365 vq_relchain(vq, len + sc->rx_vhdrlen);
366 } while (vq_has_descs(vq));
368 /* Interrupt if needed, including for NOTIFY_ON_EMPTY. */
373 pci_vtnet_tap_callback(int fd, enum ev_type type, void *param)
375 struct pci_vtnet_softc *sc = param;
377 pthread_mutex_lock(&sc->rx_mtx);
378 sc->rx_in_progress = 1;
379 pci_vtnet_tap_rx(sc);
380 sc->rx_in_progress = 0;
381 pthread_mutex_unlock(&sc->rx_mtx);
386 pci_vtnet_ping_rxq(void *vsc, struct vqueue_info *vq)
388 struct pci_vtnet_softc *sc = vsc;
391 * A qnotify means that the rx process can now begin
393 if (sc->vsc_rx_ready == 0) {
394 sc->vsc_rx_ready = 1;
399 pci_vtnet_proctx(struct pci_vtnet_softc *sc, struct vqueue_info *vq)
401 struct iovec iov[VTNET_MAXSEGS + 1];
406 * Obtain chain of descriptors. The first one is
407 * really the header descriptor, so we need to sum
408 * up two lengths: packet length and transfer length.
410 n = vq_getchain(vq, iov, VTNET_MAXSEGS, NULL);
411 assert(n >= 1 && n <= VTNET_MAXSEGS);
413 tlen = iov[0].iov_len;
414 for (i = 1; i < n; i++) {
415 plen += iov[i].iov_len;
416 tlen += iov[i].iov_len;
419 DPRINTF(("virtio: packet send, %d bytes, %d segs\n\r", plen, n));
420 pci_vtnet_tap_tx(sc, &iov[1], n - 1, plen);
422 /* chain is processed, release it and set tlen */
423 vq_relchain(vq, tlen);
427 pci_vtnet_ping_txq(void *vsc, struct vqueue_info *vq)
429 struct pci_vtnet_softc *sc = vsc;
432 * Any ring entries to process?
434 if (!vq_has_descs(vq))
437 /* Signal the tx thread for processing */
438 pthread_mutex_lock(&sc->tx_mtx);
439 if (sc->tx_in_progress == 0)
440 pthread_cond_signal(&sc->tx_cond);
441 pthread_mutex_unlock(&sc->tx_mtx);
445 * Thread which will handle processing of TX desc
448 pci_vtnet_tx_thread(void *param)
450 struct pci_vtnet_softc *sc = param;
451 struct vqueue_info *vq;
452 int have_work, error;
454 vq = &sc->vsc_queues[VTNET_TXQ];
457 * Let us wait till the tx queue pointers get initialised &
460 pthread_mutex_lock(&sc->tx_mtx);
461 error = pthread_cond_wait(&sc->tx_cond, &sc->tx_mtx);
465 /* note - tx mutex is locked here */
470 have_work = vq_has_descs(vq);
473 sc->tx_in_progress = 0;
474 error = pthread_cond_wait(&sc->tx_cond,
478 } while (!have_work);
479 sc->tx_in_progress = 1;
480 pthread_mutex_unlock(&sc->tx_mtx);
485 * Run through entries, placing them into
486 * iovecs and sending when an end-of-packet
489 pci_vtnet_proctx(sc, vq);
490 } while (vq_has_descs(vq));
493 * Generate an interrupt if needed.
497 pthread_mutex_lock(&sc->tx_mtx);
503 pci_vtnet_ping_ctlq(void *vsc, struct vqueue_info *vq)
506 DPRINTF(("vtnet: control qnotify!\n\r"));
511 pci_vtnet_parsemac(char *mac_str, uint8_t *mac_addr)
513 struct ether_addr *ea;
515 char zero_addr[ETHER_ADDR_LEN] = { 0, 0, 0, 0, 0, 0 };
517 tmpstr = strsep(&mac_str,"=");
519 if ((mac_str != NULL) && (!strcmp(tmpstr,"mac"))) {
520 ea = ether_aton(mac_str);
522 if (ea == NULL || ETHER_IS_MULTICAST(ea->octet) ||
523 memcmp(ea->octet, zero_addr, ETHER_ADDR_LEN) == 0) {
524 fprintf(stderr, "Invalid MAC %s\n", mac_str);
527 memcpy(mac_addr, ea->octet, ETHER_ADDR_LEN);
535 pci_vtnet_init(struct vmctx *ctx, struct pci_devinst *pi, char *opts)
538 unsigned char digest[16];
540 char tname[MAXCOMLEN + 1];
541 struct pci_vtnet_softc *sc;
546 sc = calloc(1, sizeof(struct pci_vtnet_softc));
548 pthread_mutex_init(&sc->vsc_mtx, NULL);
550 vi_softc_linkup(&sc->vsc_vs, &vtnet_vi_consts, sc, pi, sc->vsc_queues);
551 sc->vsc_vs.vs_mtx = &sc->vsc_mtx;
553 sc->vsc_queues[VTNET_RXQ].vq_qsize = VTNET_RINGSZ;
554 sc->vsc_queues[VTNET_RXQ].vq_notify = pci_vtnet_ping_rxq;
555 sc->vsc_queues[VTNET_TXQ].vq_qsize = VTNET_RINGSZ;
556 sc->vsc_queues[VTNET_TXQ].vq_notify = pci_vtnet_ping_txq;
558 sc->vsc_queues[VTNET_CTLQ].vq_qsize = VTNET_RINGSZ;
559 sc->vsc_queues[VTNET_CTLQ].vq_notify = pci_vtnet_ping_ctlq;
563 * Attempt to open the tap device and read the MAC address
572 devname = vtopts = strdup(opts);
573 (void) strsep(&vtopts, ",");
575 if (vtopts != NULL) {
576 err = pci_vtnet_parsemac(vtopts, sc->vsc_config.mac);
584 strcpy(tbuf, "/dev/");
585 strlcat(tbuf, devname, sizeof(tbuf));
589 sc->vsc_tapfd = open(tbuf, O_RDWR);
590 if (sc->vsc_tapfd == -1) {
591 WPRINTF(("open of tap device %s failed\n", tbuf));
594 * Set non-blocking and register for read
595 * notifications with the event loop
598 if (ioctl(sc->vsc_tapfd, FIONBIO, &opt) < 0) {
599 WPRINTF(("tap device O_NONBLOCK failed\n"));
600 close(sc->vsc_tapfd);
604 sc->vsc_mevp = mevent_add(sc->vsc_tapfd,
606 pci_vtnet_tap_callback,
608 if (sc->vsc_mevp == NULL) {
609 WPRINTF(("Could not register event\n"));
610 close(sc->vsc_tapfd);
617 * The default MAC address is the standard NetApp OUI of 00-a0-98,
618 * followed by an MD5 of the PCI slot/func number and dev name
621 snprintf(nstr, sizeof(nstr), "%d-%d-%s", pi->pi_slot,
622 pi->pi_func, vmname);
625 MD5Update(&mdctx, nstr, strlen(nstr));
626 MD5Final(digest, &mdctx);
628 sc->vsc_config.mac[0] = 0x00;
629 sc->vsc_config.mac[1] = 0xa0;
630 sc->vsc_config.mac[2] = 0x98;
631 sc->vsc_config.mac[3] = digest[0];
632 sc->vsc_config.mac[4] = digest[1];
633 sc->vsc_config.mac[5] = digest[2];
636 /* initialize config space */
637 pci_set_cfgdata16(pi, PCIR_DEVICE, VIRTIO_DEV_NET);
638 pci_set_cfgdata16(pi, PCIR_VENDOR, VIRTIO_VENDOR);
639 pci_set_cfgdata8(pi, PCIR_CLASS, PCIC_NETWORK);
640 pci_set_cfgdata16(pi, PCIR_SUBDEV_0, VIRTIO_TYPE_NET);
642 pci_lintr_request(pi);
645 sc->vsc_config.status = 1;
647 /* use BAR 1 to map MSI-X table and PBA, if we're using MSI-X */
648 if (vi_intr_init(&sc->vsc_vs, 1, fbsdrun_virtio_msix()))
651 /* use BAR 0 to map config regs in IO space */
652 vi_set_io_bar(&sc->vsc_vs, 0);
657 sc->rx_vhdrlen = sizeof(struct virtio_net_rxhdr);
658 sc->rx_in_progress = 0;
659 pthread_mutex_init(&sc->rx_mtx, NULL);
662 * Initialize tx semaphore & spawn TX processing thread.
663 * As of now, only one thread for TX desc processing is
666 sc->tx_in_progress = 0;
667 pthread_mutex_init(&sc->tx_mtx, NULL);
668 pthread_cond_init(&sc->tx_cond, NULL);
669 pthread_create(&sc->tx_tid, NULL, pci_vtnet_tx_thread, (void *)sc);
670 snprintf(tname, sizeof(tname), "vtnet-%d:%d tx", pi->pi_slot,
672 pthread_set_name_np(sc->tx_tid, tname);
678 pci_vtnet_cfgwrite(void *vsc, int offset, int size, uint32_t value)
680 struct pci_vtnet_softc *sc = vsc;
684 assert(offset + size <= 6);
686 * The driver is allowed to change the MAC address
688 ptr = &sc->vsc_config.mac[offset];
689 memcpy(ptr, &value, size);
691 /* silently ignore other writes */
692 DPRINTF(("vtnet: write to readonly reg %d\n\r", offset));
699 pci_vtnet_cfgread(void *vsc, int offset, int size, uint32_t *retval)
701 struct pci_vtnet_softc *sc = vsc;
704 ptr = (uint8_t *)&sc->vsc_config + offset;
705 memcpy(retval, ptr, size);
710 pci_vtnet_neg_features(void *vsc, uint64_t negotiated_features)
712 struct pci_vtnet_softc *sc = vsc;
714 sc->vsc_features = negotiated_features;
716 if (!(sc->vsc_features & VIRTIO_NET_F_MRG_RXBUF)) {
718 /* non-merge rx header is 2 bytes shorter */
723 struct pci_devemu pci_de_vnet = {
724 .pe_emu = "virtio-net",
725 .pe_init = pci_vtnet_init,
726 .pe_barwrite = vi_pci_write,
727 .pe_barread = vi_pci_read
729 PCI_EMUL_SET(pci_de_vnet);