1 /* A simple network driver using virtio.
3 * Copyright 2007 Rusty Russell <rusty@rustcorp.com.au> IBM Corporation
5 * This program is free software; you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License as published by
7 * the Free Software Foundation; either version 2 of the License, or
8 * (at your option) any later version.
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 * GNU General Public License for more details.
15 * You should have received a copy of the GNU General Public License
16 * along with this program; if not, write to the Free Software
17 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
20 #include <linux/netdevice.h>
21 #include <linux/etherdevice.h>
22 #include <linux/module.h>
23 #include <linux/virtio.h>
24 #include <linux/virtio_net.h>
25 #include <linux/scatterlist.h>
27 static int napi_weight = 128;
28 module_param(napi_weight, int, 0444);
30 static int csum = 1, gso = 1;
31 module_param(csum, bool, 0444);
32 module_param(gso, bool, 0444);
34 /* FIXME: MTU in config. */
35 #define MAX_PACKET_LEN (ETH_HLEN+ETH_DATA_LEN)
39 struct virtio_device *vdev;
40 struct virtqueue *rvq, *svq;
41 struct net_device *dev;
42 struct napi_struct napi;
44 /* The skb we couldn't send because buffers were full. */
45 struct sk_buff *last_xmit_skb;
47 /* If we need to free in a timer, this is it. */
48 struct timer_list xmit_free_timer;
50 /* Number of input buffers, and max we've ever had. */
51 unsigned int num, max;
53 /* For cleaning up after transmission. */
54 struct tasklet_struct tasklet;
57 /* Receive & send queues. */
58 struct sk_buff_head recv;
59 struct sk_buff_head send;
62 static inline struct virtio_net_hdr *skb_vnet_hdr(struct sk_buff *skb)
64 return (struct virtio_net_hdr *)skb->cb;
67 static inline void vnet_hdr_to_sg(struct scatterlist *sg, struct sk_buff *skb)
69 sg_init_one(sg, skb_vnet_hdr(skb), sizeof(struct virtio_net_hdr));
72 static void skb_xmit_done(struct virtqueue *svq)
74 struct virtnet_info *vi = svq->vdev->priv;
76 /* Suppress further interrupts. */
77 svq->vq_ops->disable_cb(svq);
79 /* We were probably waiting for more output buffers. */
80 netif_wake_queue(vi->dev);
82 /* Make sure we re-xmit last_xmit_skb: if there are no more packets
83 * queued, start_xmit won't be called. */
84 tasklet_schedule(&vi->tasklet);
87 static void receive_skb(struct net_device *dev, struct sk_buff *skb,
90 struct virtio_net_hdr *hdr = skb_vnet_hdr(skb);
92 if (unlikely(len < sizeof(struct virtio_net_hdr) + ETH_HLEN)) {
93 pr_debug("%s: short packet %i\n", dev->name, len);
94 dev->stats.rx_length_errors++;
97 len -= sizeof(struct virtio_net_hdr);
98 BUG_ON(len > MAX_PACKET_LEN);
102 dev->stats.rx_bytes += skb->len;
103 dev->stats.rx_packets++;
105 if (hdr->flags & VIRTIO_NET_HDR_F_NEEDS_CSUM) {
106 pr_debug("Needs csum!\n");
107 if (!skb_partial_csum_set(skb,hdr->csum_start,hdr->csum_offset))
111 skb->protocol = eth_type_trans(skb, dev);
112 pr_debug("Receiving skb proto 0x%04x len %i type %i\n",
113 ntohs(skb->protocol), skb->len, skb->pkt_type);
115 if (hdr->gso_type != VIRTIO_NET_HDR_GSO_NONE) {
117 switch (hdr->gso_type & ~VIRTIO_NET_HDR_GSO_ECN) {
118 case VIRTIO_NET_HDR_GSO_TCPV4:
119 skb_shinfo(skb)->gso_type = SKB_GSO_TCPV4;
121 case VIRTIO_NET_HDR_GSO_UDP:
122 skb_shinfo(skb)->gso_type = SKB_GSO_UDP;
124 case VIRTIO_NET_HDR_GSO_TCPV6:
125 skb_shinfo(skb)->gso_type = SKB_GSO_TCPV6;
129 printk(KERN_WARNING "%s: bad gso type %u.\n",
130 dev->name, hdr->gso_type);
134 if (hdr->gso_type & VIRTIO_NET_HDR_GSO_ECN)
135 skb_shinfo(skb)->gso_type |= SKB_GSO_TCP_ECN;
137 skb_shinfo(skb)->gso_size = hdr->gso_size;
138 if (skb_shinfo(skb)->gso_size == 0) {
140 printk(KERN_WARNING "%s: zero gso size.\n",
145 /* Header must be checked, and gso_segs computed. */
146 skb_shinfo(skb)->gso_type |= SKB_GSO_DODGY;
147 skb_shinfo(skb)->gso_segs = 0;
150 netif_receive_skb(skb);
154 dev->stats.rx_frame_errors++;
159 static void try_fill_recv(struct virtnet_info *vi)
162 struct scatterlist sg[2+MAX_SKB_FRAGS];
165 sg_init_table(sg, 2+MAX_SKB_FRAGS);
167 skb = netdev_alloc_skb(vi->dev, MAX_PACKET_LEN);
171 skb_put(skb, MAX_PACKET_LEN);
172 vnet_hdr_to_sg(sg, skb);
173 num = skb_to_sgvec(skb, sg+1, 0, skb->len) + 1;
174 skb_queue_head(&vi->recv, skb);
176 err = vi->rvq->vq_ops->add_buf(vi->rvq, sg, 0, num, skb);
178 skb_unlink(skb, &vi->recv);
184 if (unlikely(vi->num > vi->max))
186 vi->rvq->vq_ops->kick(vi->rvq);
189 static void skb_recv_done(struct virtqueue *rvq)
191 struct virtnet_info *vi = rvq->vdev->priv;
192 /* Schedule NAPI, Suppress further interrupts if successful. */
193 if (netif_rx_schedule_prep(vi->dev, &vi->napi)) {
194 rvq->vq_ops->disable_cb(rvq);
195 __netif_rx_schedule(vi->dev, &vi->napi);
199 static int virtnet_poll(struct napi_struct *napi, int budget)
201 struct virtnet_info *vi = container_of(napi, struct virtnet_info, napi);
202 struct sk_buff *skb = NULL;
203 unsigned int len, received = 0;
206 while (received < budget &&
207 (skb = vi->rvq->vq_ops->get_buf(vi->rvq, &len)) != NULL) {
208 __skb_unlink(skb, &vi->recv);
209 receive_skb(vi->dev, skb, len);
214 /* FIXME: If we oom and completely run out of inbufs, we need
215 * to start a timer trying to fill more. */
216 if (vi->num < vi->max / 2)
219 /* Out of packets? */
220 if (received < budget) {
221 netif_rx_complete(vi->dev, napi);
222 if (unlikely(!vi->rvq->vq_ops->enable_cb(vi->rvq))
223 && napi_schedule_prep(napi)) {
224 vi->rvq->vq_ops->disable_cb(vi->rvq);
225 __netif_rx_schedule(vi->dev, napi);
233 static void free_old_xmit_skbs(struct virtnet_info *vi)
238 while ((skb = vi->svq->vq_ops->get_buf(vi->svq, &len)) != NULL) {
239 pr_debug("Sent skb %p\n", skb);
240 __skb_unlink(skb, &vi->send);
241 vi->dev->stats.tx_bytes += skb->len;
242 vi->dev->stats.tx_packets++;
247 /* If the virtio transport doesn't always notify us when all in-flight packets
248 * are consumed, we fall back to using this function on a timer to free them. */
249 static void xmit_free(unsigned long data)
251 struct virtnet_info *vi = (void *)data;
253 netif_tx_lock(vi->dev);
255 free_old_xmit_skbs(vi);
257 if (!skb_queue_empty(&vi->send))
258 mod_timer(&vi->xmit_free_timer, jiffies + (HZ/10));
260 netif_tx_unlock(vi->dev);
263 static int xmit_skb(struct virtnet_info *vi, struct sk_buff *skb)
266 struct scatterlist sg[2+MAX_SKB_FRAGS];
267 struct virtio_net_hdr *hdr;
268 const unsigned char *dest = ((struct ethhdr *)skb->data)->h_dest;
270 sg_init_table(sg, 2+MAX_SKB_FRAGS);
272 pr_debug("%s: xmit %p " MAC_FMT "\n", vi->dev->name, skb,
273 dest[0], dest[1], dest[2],
274 dest[3], dest[4], dest[5]);
276 /* Encode metadata header at front. */
277 hdr = skb_vnet_hdr(skb);
278 if (skb->ip_summed == CHECKSUM_PARTIAL) {
279 hdr->flags = VIRTIO_NET_HDR_F_NEEDS_CSUM;
280 hdr->csum_start = skb->csum_start - skb_headroom(skb);
281 hdr->csum_offset = skb->csum_offset;
284 hdr->csum_offset = hdr->csum_start = 0;
287 if (skb_is_gso(skb)) {
288 hdr->hdr_len = skb_transport_header(skb) - skb->data;
289 hdr->gso_size = skb_shinfo(skb)->gso_size;
290 if (skb_shinfo(skb)->gso_type & SKB_GSO_TCPV4)
291 hdr->gso_type = VIRTIO_NET_HDR_GSO_TCPV4;
292 else if (skb_shinfo(skb)->gso_type & SKB_GSO_TCPV6)
293 hdr->gso_type = VIRTIO_NET_HDR_GSO_TCPV6;
294 else if (skb_shinfo(skb)->gso_type & SKB_GSO_UDP)
295 hdr->gso_type = VIRTIO_NET_HDR_GSO_UDP;
298 if (skb_shinfo(skb)->gso_type & SKB_GSO_TCP_ECN)
299 hdr->gso_type |= VIRTIO_NET_HDR_GSO_ECN;
301 hdr->gso_type = VIRTIO_NET_HDR_GSO_NONE;
302 hdr->gso_size = hdr->hdr_len = 0;
305 vnet_hdr_to_sg(sg, skb);
306 num = skb_to_sgvec(skb, sg+1, 0, skb->len) + 1;
308 err = vi->svq->vq_ops->add_buf(vi->svq, sg, num, 0, skb);
309 if (!err && !vi->free_in_tasklet)
310 mod_timer(&vi->xmit_free_timer, jiffies + (HZ/10));
315 static void xmit_tasklet(unsigned long data)
317 struct virtnet_info *vi = (void *)data;
319 netif_tx_lock_bh(vi->dev);
320 if (vi->last_xmit_skb && xmit_skb(vi, vi->last_xmit_skb) == 0) {
321 vi->svq->vq_ops->kick(vi->svq);
322 vi->last_xmit_skb = NULL;
324 if (vi->free_in_tasklet)
325 free_old_xmit_skbs(vi);
326 netif_tx_unlock_bh(vi->dev);
329 static int start_xmit(struct sk_buff *skb, struct net_device *dev)
331 struct virtnet_info *vi = netdev_priv(dev);
334 /* Free up any pending old buffers before queueing new ones. */
335 free_old_xmit_skbs(vi);
337 /* If we has a buffer left over from last time, send it now. */
338 if (unlikely(vi->last_xmit_skb)) {
339 if (xmit_skb(vi, vi->last_xmit_skb) != 0) {
340 /* Drop this skb: we only queue one. */
341 vi->dev->stats.tx_dropped++;
346 vi->last_xmit_skb = NULL;
349 /* Put new one in send queue and do transmit */
351 __skb_queue_head(&vi->send, skb);
352 if (xmit_skb(vi, skb) != 0) {
353 vi->last_xmit_skb = skb;
359 vi->svq->vq_ops->kick(vi->svq);
363 pr_debug("%s: virtio not prepared to send\n", dev->name);
364 netif_stop_queue(dev);
366 /* Activate callback for using skbs: if this returns false it
367 * means some were used in the meantime. */
368 if (unlikely(!vi->svq->vq_ops->enable_cb(vi->svq))) {
369 vi->svq->vq_ops->disable_cb(vi->svq);
370 netif_start_queue(dev);
376 #ifdef CONFIG_NET_POLL_CONTROLLER
377 static void virtnet_netpoll(struct net_device *dev)
379 struct virtnet_info *vi = netdev_priv(dev);
381 napi_schedule(&vi->napi);
385 static int virtnet_open(struct net_device *dev)
387 struct virtnet_info *vi = netdev_priv(dev);
389 napi_enable(&vi->napi);
391 /* If all buffers were filled by other side before we napi_enabled, we
392 * won't get another interrupt, so process any outstanding packets
393 * now. virtnet_poll wants re-enable the queue, so we disable here.
394 * We synchronize against interrupts via NAPI_STATE_SCHED */
395 if (netif_rx_schedule_prep(dev, &vi->napi)) {
396 vi->rvq->vq_ops->disable_cb(vi->rvq);
397 __netif_rx_schedule(dev, &vi->napi);
402 static int virtnet_close(struct net_device *dev)
404 struct virtnet_info *vi = netdev_priv(dev);
406 napi_disable(&vi->napi);
411 static int virtnet_probe(struct virtio_device *vdev)
414 struct net_device *dev;
415 struct virtnet_info *vi;
417 /* Allocate ourselves a network device with room for our info */
418 dev = alloc_etherdev(sizeof(struct virtnet_info));
422 /* Set up network device as normal. */
423 dev->open = virtnet_open;
424 dev->stop = virtnet_close;
425 dev->hard_start_xmit = start_xmit;
426 dev->features = NETIF_F_HIGHDMA;
427 #ifdef CONFIG_NET_POLL_CONTROLLER
428 dev->poll_controller = virtnet_netpoll;
430 SET_NETDEV_DEV(dev, &vdev->dev);
432 /* Do we support "hardware" checksums? */
433 if (csum && virtio_has_feature(vdev, VIRTIO_NET_F_CSUM)) {
434 /* This opens up the world of extra features. */
435 dev->features |= NETIF_F_HW_CSUM|NETIF_F_SG|NETIF_F_FRAGLIST;
436 if (gso && virtio_has_feature(vdev, VIRTIO_NET_F_GSO)) {
437 dev->features |= NETIF_F_TSO | NETIF_F_UFO
438 | NETIF_F_TSO_ECN | NETIF_F_TSO6;
440 /* Individual feature bits: what can host handle? */
441 if (gso && virtio_has_feature(vdev, VIRTIO_NET_F_HOST_TSO4))
442 dev->features |= NETIF_F_TSO;
443 if (gso && virtio_has_feature(vdev, VIRTIO_NET_F_HOST_TSO6))
444 dev->features |= NETIF_F_TSO6;
445 if (gso && virtio_has_feature(vdev, VIRTIO_NET_F_HOST_ECN))
446 dev->features |= NETIF_F_TSO_ECN;
447 if (gso && virtio_has_feature(vdev, VIRTIO_NET_F_HOST_UFO))
448 dev->features |= NETIF_F_UFO;
451 /* Configuration may specify what MAC to use. Otherwise random. */
452 if (virtio_has_feature(vdev, VIRTIO_NET_F_MAC)) {
453 vdev->config->get(vdev,
454 offsetof(struct virtio_net_config, mac),
455 dev->dev_addr, dev->addr_len);
457 random_ether_addr(dev->dev_addr);
459 /* Set up our device-specific information */
460 vi = netdev_priv(dev);
461 netif_napi_add(dev, &vi->napi, virtnet_poll, napi_weight);
466 /* If they give us a callback when all buffers are done, we don't need
468 vi->free_in_tasklet = virtio_has_feature(vdev,VIRTIO_F_NOTIFY_ON_EMPTY);
470 /* We expect two virtqueues, receive then send. */
471 vi->rvq = vdev->config->find_vq(vdev, 0, skb_recv_done);
472 if (IS_ERR(vi->rvq)) {
473 err = PTR_ERR(vi->rvq);
477 vi->svq = vdev->config->find_vq(vdev, 1, skb_xmit_done);
478 if (IS_ERR(vi->svq)) {
479 err = PTR_ERR(vi->svq);
483 /* Initialize our empty receive and send queues. */
484 skb_queue_head_init(&vi->recv);
485 skb_queue_head_init(&vi->send);
487 tasklet_init(&vi->tasklet, xmit_tasklet, (unsigned long)vi);
489 if (!vi->free_in_tasklet)
490 setup_timer(&vi->xmit_free_timer, xmit_free, (unsigned long)vi);
492 err = register_netdev(dev);
494 pr_debug("virtio_net: registering device failed\n");
498 /* Last of all, set up some receive buffers. */
501 /* If we didn't even get one input buffer, we're useless. */
507 pr_debug("virtnet: registered device %s\n", dev->name);
511 unregister_netdev(dev);
513 vdev->config->del_vq(vi->svq);
515 vdev->config->del_vq(vi->rvq);
521 static void virtnet_remove(struct virtio_device *vdev)
523 struct virtnet_info *vi = vdev->priv;
526 /* Stop all the virtqueues. */
527 vdev->config->reset(vdev);
529 if (!vi->free_in_tasklet)
530 del_timer_sync(&vi->xmit_free_timer);
532 /* Free our skbs in send and recv queues, if any. */
533 while ((skb = __skb_dequeue(&vi->recv)) != NULL) {
537 __skb_queue_purge(&vi->send);
539 BUG_ON(vi->num != 0);
541 vdev->config->del_vq(vi->svq);
542 vdev->config->del_vq(vi->rvq);
543 unregister_netdev(vi->dev);
544 free_netdev(vi->dev);
547 static struct virtio_device_id id_table[] = {
548 { VIRTIO_ID_NET, VIRTIO_DEV_ANY_ID },
552 static unsigned int features[] = {
553 VIRTIO_NET_F_CSUM, VIRTIO_NET_F_GUEST_CSUM,
554 VIRTIO_NET_F_GSO, VIRTIO_NET_F_MAC,
555 VIRTIO_NET_F_HOST_TSO4, VIRTIO_NET_F_HOST_UFO, VIRTIO_NET_F_HOST_TSO6,
556 VIRTIO_NET_F_HOST_ECN, VIRTIO_F_NOTIFY_ON_EMPTY,
559 static struct virtio_driver virtio_net = {
560 .feature_table = features,
561 .feature_table_size = ARRAY_SIZE(features),
562 .driver.name = KBUILD_MODNAME,
563 .driver.owner = THIS_MODULE,
564 .id_table = id_table,
565 .probe = virtnet_probe,
566 .remove = __devexit_p(virtnet_remove),
569 static int __init init(void)
571 return register_virtio_driver(&virtio_net);
574 static void __exit fini(void)
576 unregister_virtio_driver(&virtio_net);
581 MODULE_DEVICE_TABLE(virtio, id_table);
582 MODULE_DESCRIPTION("Virtio network driver");
583 MODULE_LICENSE("GPL");