2 * Network-device interface management.
4 * Copyright (c) 2004-2005, Keir Fraser
6 * This program is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU General Public License version 2
8 * as published by the Free Software Foundation; or, when distributed
9 * separately from the Linux kernel or incorporated into other
10 * software packages, subject to the following license:
12 * Permission is hereby granted, free of charge, to any person obtaining a copy
13 * of this source file (the "Software"), to deal in the Software without
14 * restriction, including without limitation the rights to use, copy, modify,
15 * merge, publish, distribute, sublicense, and/or sell copies of the Software,
16 * and to permit persons to whom the Software is furnished to do so, subject to
17 * the following conditions:
19 * The above copyright notice and this permission notice shall be included in
20 * all copies or substantial portions of the Software.
22 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
23 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
24 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
25 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
26 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
27 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
33 #include <linux/kthread.h>
34 #include <linux/ethtool.h>
35 #include <linux/rtnetlink.h>
36 #include <linux/if_vlan.h>
38 #include <xen/events.h>
39 #include <asm/xen/hypercall.h>
40 #include <xen/balloon.h>
42 #define XENVIF_QUEUE_LENGTH 32
43 #define XENVIF_NAPI_WEIGHT 64
45 static inline void xenvif_stop_queue(struct xenvif_queue *queue)
47 struct net_device *dev = queue->vif->dev;
49 if (!queue->vif->can_queue)
52 netif_tx_stop_queue(netdev_get_tx_queue(dev, queue->id));
55 int xenvif_schedulable(struct xenvif *vif)
57 return netif_running(vif->dev) && netif_carrier_ok(vif->dev);
60 static irqreturn_t xenvif_tx_interrupt(int irq, void *dev_id)
62 struct xenvif_queue *queue = dev_id;
64 if (RING_HAS_UNCONSUMED_REQUESTS(&queue->tx))
65 napi_schedule(&queue->napi);
70 int xenvif_poll(struct napi_struct *napi, int budget)
72 struct xenvif_queue *queue =
73 container_of(napi, struct xenvif_queue, napi);
76 /* This vif is rogue, we pretend we've there is nothing to do
77 * for this vif to deschedule it from NAPI. But this interface
78 * will be turned off in thread context later.
80 if (unlikely(queue->vif->disabled)) {
85 work_done = xenvif_tx_action(queue, budget);
87 if (work_done < budget) {
89 xenvif_napi_schedule_or_enable_events(queue);
95 static irqreturn_t xenvif_rx_interrupt(int irq, void *dev_id)
97 struct xenvif_queue *queue = dev_id;
99 xenvif_kick_thread(queue);
104 static irqreturn_t xenvif_interrupt(int irq, void *dev_id)
106 xenvif_tx_interrupt(irq, dev_id);
107 xenvif_rx_interrupt(irq, dev_id);
112 int xenvif_queue_stopped(struct xenvif_queue *queue)
114 struct net_device *dev = queue->vif->dev;
115 unsigned int id = queue->id;
116 return netif_tx_queue_stopped(netdev_get_tx_queue(dev, id));
119 void xenvif_wake_queue(struct xenvif_queue *queue)
121 struct net_device *dev = queue->vif->dev;
122 unsigned int id = queue->id;
123 netif_tx_wake_queue(netdev_get_tx_queue(dev, id));
126 /* Callback to wake the queue and drain it on timeout */
127 static void xenvif_wake_queue_callback(unsigned long data)
129 struct xenvif_queue *queue = (struct xenvif_queue *)data;
131 if (xenvif_queue_stopped(queue)) {
132 netdev_err(queue->vif->dev, "draining TX queue\n");
133 queue->rx_queue_purge = true;
134 xenvif_kick_thread(queue);
135 xenvif_wake_queue(queue);
139 static u16 xenvif_select_queue(struct net_device *dev, struct sk_buff *skb,
140 void *accel_priv, select_queue_fallback_t fallback)
142 struct xenvif *vif = netdev_priv(dev);
143 unsigned int num_queues = dev->real_num_tx_queues;
147 /* First, check if there is only one queue to optimise the
148 * single-queue or old frontend scenario.
150 if (num_queues == 1) {
153 /* Use skb_get_hash to obtain an L4 hash if available */
154 hash = skb_get_hash(skb);
155 queue_index = hash % num_queues;
161 static int xenvif_start_xmit(struct sk_buff *skb, struct net_device *dev)
163 struct xenvif *vif = netdev_priv(dev);
164 struct xenvif_queue *queue = NULL;
165 unsigned int num_queues = dev->real_num_tx_queues;
167 int min_slots_needed;
169 BUG_ON(skb->dev != dev);
171 /* Drop the packet if queues are not set up */
175 /* Obtain the queue to be used to transmit this packet */
176 index = skb_get_queue_mapping(skb);
177 if (index >= num_queues) {
178 pr_warn_ratelimited("Invalid queue %hu for packet on interface %s\n.",
179 index, vif->dev->name);
182 queue = &vif->queues[index];
184 /* Drop the packet if queue is not ready */
185 if (queue->task == NULL ||
186 queue->dealloc_task == NULL ||
187 !xenvif_schedulable(vif))
190 /* At best we'll need one slot for the header and one for each
193 min_slots_needed = 1 + skb_shinfo(skb)->nr_frags;
195 /* If the skb is GSO then we'll also need an extra slot for the
201 /* If the skb can't possibly fit in the remaining slots
202 * then turn off the queue to give the ring a chance to
205 if (!xenvif_rx_ring_slots_available(queue, min_slots_needed)) {
206 queue->wake_queue.function = xenvif_wake_queue_callback;
207 queue->wake_queue.data = (unsigned long)queue;
208 xenvif_stop_queue(queue);
209 mod_timer(&queue->wake_queue,
210 jiffies + rx_drain_timeout_jiffies);
213 skb_queue_tail(&queue->rx_queue, skb);
214 xenvif_kick_thread(queue);
219 vif->dev->stats.tx_dropped++;
224 static struct net_device_stats *xenvif_get_stats(struct net_device *dev)
226 struct xenvif *vif = netdev_priv(dev);
227 struct xenvif_queue *queue = NULL;
228 unsigned int num_queues = dev->real_num_tx_queues;
229 unsigned long rx_bytes = 0;
230 unsigned long rx_packets = 0;
231 unsigned long tx_bytes = 0;
232 unsigned long tx_packets = 0;
235 if (vif->queues == NULL)
238 /* Aggregate tx and rx stats from each queue */
239 for (index = 0; index < num_queues; ++index) {
240 queue = &vif->queues[index];
241 rx_bytes += queue->stats.rx_bytes;
242 rx_packets += queue->stats.rx_packets;
243 tx_bytes += queue->stats.tx_bytes;
244 tx_packets += queue->stats.tx_packets;
248 vif->dev->stats.rx_bytes = rx_bytes;
249 vif->dev->stats.rx_packets = rx_packets;
250 vif->dev->stats.tx_bytes = tx_bytes;
251 vif->dev->stats.tx_packets = tx_packets;
253 return &vif->dev->stats;
256 static void xenvif_up(struct xenvif *vif)
258 struct xenvif_queue *queue = NULL;
259 unsigned int num_queues = vif->dev->real_num_tx_queues;
260 unsigned int queue_index;
262 for (queue_index = 0; queue_index < num_queues; ++queue_index) {
263 queue = &vif->queues[queue_index];
264 napi_enable(&queue->napi);
265 enable_irq(queue->tx_irq);
266 if (queue->tx_irq != queue->rx_irq)
267 enable_irq(queue->rx_irq);
268 xenvif_napi_schedule_or_enable_events(queue);
272 static void xenvif_down(struct xenvif *vif)
274 struct xenvif_queue *queue = NULL;
275 unsigned int num_queues = vif->dev->real_num_tx_queues;
276 unsigned int queue_index;
278 for (queue_index = 0; queue_index < num_queues; ++queue_index) {
279 queue = &vif->queues[queue_index];
280 napi_disable(&queue->napi);
281 disable_irq(queue->tx_irq);
282 if (queue->tx_irq != queue->rx_irq)
283 disable_irq(queue->rx_irq);
284 del_timer_sync(&queue->credit_timeout);
288 static int xenvif_open(struct net_device *dev)
290 struct xenvif *vif = netdev_priv(dev);
291 if (netif_carrier_ok(dev))
293 netif_tx_start_all_queues(dev);
297 static int xenvif_close(struct net_device *dev)
299 struct xenvif *vif = netdev_priv(dev);
300 if (netif_carrier_ok(dev))
302 netif_tx_stop_all_queues(dev);
306 static int xenvif_change_mtu(struct net_device *dev, int mtu)
308 struct xenvif *vif = netdev_priv(dev);
309 int max = vif->can_sg ? 65535 - VLAN_ETH_HLEN : ETH_DATA_LEN;
317 static netdev_features_t xenvif_fix_features(struct net_device *dev,
318 netdev_features_t features)
320 struct xenvif *vif = netdev_priv(dev);
323 features &= ~NETIF_F_SG;
324 if (~(vif->gso_mask | vif->gso_prefix_mask) & GSO_BIT(TCPV4))
325 features &= ~NETIF_F_TSO;
326 if (~(vif->gso_mask | vif->gso_prefix_mask) & GSO_BIT(TCPV6))
327 features &= ~NETIF_F_TSO6;
329 features &= ~NETIF_F_IP_CSUM;
331 features &= ~NETIF_F_IPV6_CSUM;
336 static const struct xenvif_stat {
337 char name[ETH_GSTRING_LEN];
341 "rx_gso_checksum_fixup",
342 offsetof(struct xenvif_stats, rx_gso_checksum_fixup)
344 /* If (sent != success + fail), there are probably packets never
349 offsetof(struct xenvif_stats, tx_zerocopy_sent),
352 "tx_zerocopy_success",
353 offsetof(struct xenvif_stats, tx_zerocopy_success),
357 offsetof(struct xenvif_stats, tx_zerocopy_fail)
359 /* Number of packets exceeding MAX_SKB_FRAG slots. You should use
360 * a guest with the same MAX_SKB_FRAG
364 offsetof(struct xenvif_stats, tx_frag_overflow)
368 static int xenvif_get_sset_count(struct net_device *dev, int string_set)
370 switch (string_set) {
372 return ARRAY_SIZE(xenvif_stats);
378 static void xenvif_get_ethtool_stats(struct net_device *dev,
379 struct ethtool_stats *stats, u64 * data)
381 struct xenvif *vif = netdev_priv(dev);
382 unsigned int num_queues = dev->real_num_tx_queues;
384 unsigned int queue_index;
385 struct xenvif_stats *vif_stats;
387 for (i = 0; i < ARRAY_SIZE(xenvif_stats); i++) {
388 unsigned long accum = 0;
389 for (queue_index = 0; queue_index < num_queues; ++queue_index) {
390 vif_stats = &vif->queues[queue_index].stats;
391 accum += *(unsigned long *)(vif_stats + xenvif_stats[i].offset);
397 static void xenvif_get_strings(struct net_device *dev, u32 stringset, u8 * data)
403 for (i = 0; i < ARRAY_SIZE(xenvif_stats); i++)
404 memcpy(data + i * ETH_GSTRING_LEN,
405 xenvif_stats[i].name, ETH_GSTRING_LEN);
410 static const struct ethtool_ops xenvif_ethtool_ops = {
411 .get_link = ethtool_op_get_link,
413 .get_sset_count = xenvif_get_sset_count,
414 .get_ethtool_stats = xenvif_get_ethtool_stats,
415 .get_strings = xenvif_get_strings,
418 static const struct net_device_ops xenvif_netdev_ops = {
419 .ndo_start_xmit = xenvif_start_xmit,
420 .ndo_get_stats = xenvif_get_stats,
421 .ndo_open = xenvif_open,
422 .ndo_stop = xenvif_close,
423 .ndo_change_mtu = xenvif_change_mtu,
424 .ndo_fix_features = xenvif_fix_features,
425 .ndo_set_mac_address = eth_mac_addr,
426 .ndo_validate_addr = eth_validate_addr,
427 .ndo_select_queue = xenvif_select_queue,
430 struct xenvif *xenvif_alloc(struct device *parent, domid_t domid,
434 struct net_device *dev;
436 char name[IFNAMSIZ] = {};
438 snprintf(name, IFNAMSIZ - 1, "vif%u.%u", domid, handle);
439 dev = alloc_netdev_mq(sizeof(struct xenvif), name, ether_setup, 1);
441 pr_warn("Could not allocate netdev for %s\n", name);
442 return ERR_PTR(-ENOMEM);
445 SET_NETDEV_DEV(dev, parent);
447 vif = netdev_priv(dev);
450 vif->handle = handle;
454 vif->disabled = false;
456 /* Start out with no queues. The call below does not require
457 * rtnl_lock() as it happens before register_netdev().
460 netif_set_real_num_tx_queues(dev, 0);
462 dev->netdev_ops = &xenvif_netdev_ops;
463 dev->hw_features = NETIF_F_SG |
464 NETIF_F_IP_CSUM | NETIF_F_IPV6_CSUM |
465 NETIF_F_TSO | NETIF_F_TSO6;
466 dev->features = dev->hw_features | NETIF_F_RXCSUM;
467 dev->ethtool_ops = &xenvif_ethtool_ops;
469 dev->tx_queue_len = XENVIF_QUEUE_LENGTH;
472 * Initialise a dummy MAC address. We choose the numerically
473 * largest non-broadcast address to prevent the address getting
474 * stolen by an Ethernet bridge for STP purposes.
475 * (FE:FF:FF:FF:FF:FF)
477 memset(dev->dev_addr, 0xFF, ETH_ALEN);
478 dev->dev_addr[0] &= ~0x01;
480 netif_carrier_off(dev);
482 err = register_netdev(dev);
484 netdev_warn(dev, "Could not register device: err=%d\n", err);
489 netdev_dbg(dev, "Successfully created xenvif\n");
491 __module_get(THIS_MODULE);
496 int xenvif_init_queue(struct xenvif_queue *queue)
500 queue->credit_bytes = queue->remaining_credit = ~0UL;
501 queue->credit_usec = 0UL;
502 init_timer(&queue->credit_timeout);
503 queue->credit_window_start = get_jiffies_64();
505 skb_queue_head_init(&queue->rx_queue);
506 skb_queue_head_init(&queue->tx_queue);
508 queue->pending_cons = 0;
509 queue->pending_prod = MAX_PENDING_REQS;
510 for (i = 0; i < MAX_PENDING_REQS; ++i)
511 queue->pending_ring[i] = i;
513 spin_lock_init(&queue->callback_lock);
514 spin_lock_init(&queue->response_lock);
516 /* If ballooning is disabled, this will consume real memory, so you
517 * better enable it. The long term solution would be to use just a
518 * bunch of valid page descriptors, without dependency on ballooning
520 err = alloc_xenballooned_pages(MAX_PENDING_REQS,
524 netdev_err(queue->vif->dev, "Could not reserve mmap_pages\n");
528 for (i = 0; i < MAX_PENDING_REQS; i++) {
529 queue->pending_tx_info[i].callback_struct = (struct ubuf_info)
530 { .callback = xenvif_zerocopy_callback,
533 queue->grant_tx_handle[i] = NETBACK_INVALID_HANDLE;
536 init_timer(&queue->wake_queue);
538 netif_napi_add(queue->vif->dev, &queue->napi, xenvif_poll,
544 void xenvif_carrier_on(struct xenvif *vif)
547 if (!vif->can_sg && vif->dev->mtu > ETH_DATA_LEN)
548 dev_set_mtu(vif->dev, ETH_DATA_LEN);
549 netdev_update_features(vif->dev);
550 netif_carrier_on(vif->dev);
551 if (netif_running(vif->dev))
556 int xenvif_connect(struct xenvif_queue *queue, unsigned long tx_ring_ref,
557 unsigned long rx_ring_ref, unsigned int tx_evtchn,
558 unsigned int rx_evtchn)
560 struct task_struct *task;
563 BUG_ON(queue->tx_irq);
565 BUG_ON(queue->dealloc_task);
567 err = xenvif_map_frontend_rings(queue, tx_ring_ref, rx_ring_ref);
571 init_waitqueue_head(&queue->wq);
572 init_waitqueue_head(&queue->dealloc_wq);
574 if (tx_evtchn == rx_evtchn) {
575 /* feature-split-event-channels == 0 */
576 err = bind_interdomain_evtchn_to_irqhandler(
577 queue->vif->domid, tx_evtchn, xenvif_interrupt, 0,
581 queue->tx_irq = queue->rx_irq = err;
582 disable_irq(queue->tx_irq);
584 /* feature-split-event-channels == 1 */
585 snprintf(queue->tx_irq_name, sizeof(queue->tx_irq_name),
586 "%s-tx", queue->name);
587 err = bind_interdomain_evtchn_to_irqhandler(
588 queue->vif->domid, tx_evtchn, xenvif_tx_interrupt, 0,
589 queue->tx_irq_name, queue);
593 disable_irq(queue->tx_irq);
595 snprintf(queue->rx_irq_name, sizeof(queue->rx_irq_name),
596 "%s-rx", queue->name);
597 err = bind_interdomain_evtchn_to_irqhandler(
598 queue->vif->domid, rx_evtchn, xenvif_rx_interrupt, 0,
599 queue->rx_irq_name, queue);
603 disable_irq(queue->rx_irq);
606 task = kthread_create(xenvif_kthread_guest_rx,
607 (void *)queue, "%s-guest-rx", queue->name);
609 pr_warn("Could not allocate kthread for %s\n", queue->name);
615 task = kthread_create(xenvif_dealloc_kthread,
616 (void *)queue, "%s-dealloc", queue->name);
618 pr_warn("Could not allocate kthread for %s\n", queue->name);
622 queue->dealloc_task = task;
624 wake_up_process(queue->task);
625 wake_up_process(queue->dealloc_task);
630 unbind_from_irqhandler(queue->rx_irq, queue);
633 unbind_from_irqhandler(queue->tx_irq, queue);
636 xenvif_unmap_frontend_rings(queue);
638 module_put(THIS_MODULE);
642 void xenvif_carrier_off(struct xenvif *vif)
644 struct net_device *dev = vif->dev;
647 netif_carrier_off(dev); /* discard queued packets */
648 if (netif_running(dev))
653 static void xenvif_wait_unmap_timeout(struct xenvif_queue *queue,
654 unsigned int worst_case_skb_lifetime)
656 int i, unmap_timeout = 0;
658 for (i = 0; i < MAX_PENDING_REQS; ++i) {
659 if (queue->grant_tx_handle[i] != NETBACK_INVALID_HANDLE) {
661 schedule_timeout(msecs_to_jiffies(1000));
662 if (unmap_timeout > worst_case_skb_lifetime &&
664 netdev_err(queue->vif->dev,
665 "Page still granted! Index: %x\n",
672 void xenvif_disconnect(struct xenvif *vif)
674 struct xenvif_queue *queue = NULL;
675 unsigned int num_queues = vif->dev->real_num_tx_queues;
676 unsigned int queue_index;
678 if (netif_carrier_ok(vif->dev))
679 xenvif_carrier_off(vif);
681 for (queue_index = 0; queue_index < num_queues; ++queue_index) {
682 queue = &vif->queues[queue_index];
685 del_timer_sync(&queue->wake_queue);
686 kthread_stop(queue->task);
690 if (queue->dealloc_task) {
691 kthread_stop(queue->dealloc_task);
692 queue->dealloc_task = NULL;
696 if (queue->tx_irq == queue->rx_irq)
697 unbind_from_irqhandler(queue->tx_irq, queue);
699 unbind_from_irqhandler(queue->tx_irq, queue);
700 unbind_from_irqhandler(queue->rx_irq, queue);
705 xenvif_unmap_frontend_rings(queue);
709 void xenvif_free(struct xenvif *vif)
711 struct xenvif_queue *queue = NULL;
712 unsigned int num_queues = vif->dev->real_num_tx_queues;
713 unsigned int queue_index;
714 /* Here we want to avoid timeout messages if an skb can be legitimately
715 * stuck somewhere else. Realistically this could be an another vif's
716 * internal or QDisc queue. That another vif also has this
717 * rx_drain_timeout_msecs timeout, but the timer only ditches the
718 * internal queue. After that, the QDisc queue can put in worst case
719 * XEN_NETIF_RX_RING_SIZE / MAX_SKB_FRAGS skbs into that another vif's
720 * internal queue, so we need several rounds of such timeouts until we
721 * can be sure that no another vif should have skb's from us. We are
722 * not sending more skb's, so newly stuck packets are not interesting
725 unsigned int worst_case_skb_lifetime = (rx_drain_timeout_msecs/1000) *
726 DIV_ROUND_UP(XENVIF_QUEUE_LENGTH, (XEN_NETIF_RX_RING_SIZE / MAX_SKB_FRAGS));
728 unregister_netdev(vif->dev);
730 for (queue_index = 0; queue_index < num_queues; ++queue_index) {
731 queue = &vif->queues[queue_index];
733 xenvif_wait_unmap_timeout(queue, worst_case_skb_lifetime);
734 free_xenballooned_pages(MAX_PENDING_REQS, queue->mmap_pages);
736 netif_napi_del(&queue->napi);
739 /* Free the array of queues. The call below does not require
740 * rtnl_lock() because it happens after unregister_netdev().
742 netif_set_real_num_tx_queues(vif->dev, 0);
746 free_netdev(vif->dev);
748 module_put(THIS_MODULE);