2 * Common framework for low-level network console, dump, and debugger code
4 * Sep 8 2003 Matt Mackall <mpm@selenic.com>
6 * based on the netconsole code from:
8 * Copyright (C) 2001 Ingo Molnar <mingo@redhat.com>
9 * Copyright (C) 2002 Red Hat, Inc.
12 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
14 #include <linux/moduleparam.h>
15 #include <linux/netdevice.h>
16 #include <linux/etherdevice.h>
17 #include <linux/string.h>
18 #include <linux/if_arp.h>
19 #include <linux/inetdevice.h>
20 #include <linux/inet.h>
21 #include <linux/interrupt.h>
22 #include <linux/netpoll.h>
23 #include <linux/sched.h>
24 #include <linux/delay.h>
25 #include <linux/rcupdate.h>
26 #include <linux/workqueue.h>
27 #include <linux/slab.h>
28 #include <linux/export.h>
31 #include <asm/unaligned.h>
32 #include <trace/events/napi.h>
35 * We maintain a small pool of fully-sized skbs, to make sure the
36 * message gets out even in extreme OOM situations.
39 #define MAX_UDP_CHUNK 1460
42 static struct sk_buff_head skb_pool;
44 static atomic_t trapped;
46 #define USEC_PER_POLL 50
47 #define NETPOLL_RX_ENABLED 1
48 #define NETPOLL_RX_DROP 2
50 #define MAX_SKB_SIZE \
51 (sizeof(struct ethhdr) + \
52 sizeof(struct iphdr) + \
53 sizeof(struct udphdr) + \
56 static void zap_completion_queue(void);
57 static void arp_reply(struct sk_buff *skb);
59 static unsigned int carrier_timeout = 4;
60 module_param(carrier_timeout, uint, 0644);
62 #define np_info(np, fmt, ...) \
63 pr_info("%s: " fmt, np->name, ##__VA_ARGS__)
64 #define np_err(np, fmt, ...) \
65 pr_err("%s: " fmt, np->name, ##__VA_ARGS__)
66 #define np_notice(np, fmt, ...) \
67 pr_notice("%s: " fmt, np->name, ##__VA_ARGS__)
69 static void queue_process(struct work_struct *work)
71 struct netpoll_info *npinfo =
72 container_of(work, struct netpoll_info, tx_work.work);
76 while ((skb = skb_dequeue(&npinfo->txq))) {
77 struct net_device *dev = skb->dev;
78 const struct net_device_ops *ops = dev->netdev_ops;
79 struct netdev_queue *txq;
81 if (!netif_device_present(dev) || !netif_running(dev)) {
86 txq = netdev_get_tx_queue(dev, skb_get_queue_mapping(skb));
88 local_irq_save(flags);
89 __netif_tx_lock(txq, smp_processor_id());
90 if (netif_xmit_frozen_or_stopped(txq) ||
91 ops->ndo_start_xmit(skb, dev) != NETDEV_TX_OK) {
92 skb_queue_head(&npinfo->txq, skb);
93 __netif_tx_unlock(txq);
94 local_irq_restore(flags);
96 schedule_delayed_work(&npinfo->tx_work, HZ/10);
99 __netif_tx_unlock(txq);
100 local_irq_restore(flags);
104 static __sum16 checksum_udp(struct sk_buff *skb, struct udphdr *uh,
105 unsigned short ulen, __be32 saddr, __be32 daddr)
109 if (uh->check == 0 || skb_csum_unnecessary(skb))
112 psum = csum_tcpudp_nofold(saddr, daddr, ulen, IPPROTO_UDP, 0);
114 if (skb->ip_summed == CHECKSUM_COMPLETE &&
115 !csum_fold(csum_add(psum, skb->csum)))
120 return __skb_checksum_complete(skb);
124 * Check whether delayed processing was scheduled for our NIC. If so,
125 * we attempt to grab the poll lock and use ->poll() to pump the card.
126 * If this fails, either we've recursed in ->poll() or it's already
127 * running on another CPU.
129 * Note: we don't mask interrupts with this lock because we're using
130 * trylock here and interrupts are already disabled in the softirq
131 * case. Further, we test the poll_owner to avoid recursion on UP
132 * systems where the lock doesn't exist.
134 * In cases where there is bi-directional communications, reading only
135 * one message at a time can lead to packets being dropped by the
136 * network adapter, forcing superfluous retries and possibly timeouts.
137 * Thus, we set our budget to greater than 1.
139 static int poll_one_napi(struct netpoll_info *npinfo,
140 struct napi_struct *napi, int budget)
144 /* net_rx_action's ->poll() invocations and our's are
145 * synchronized by this test which is only made while
146 * holding the napi->poll_lock.
148 if (!test_bit(NAPI_STATE_SCHED, &napi->state))
151 npinfo->rx_flags |= NETPOLL_RX_DROP;
152 atomic_inc(&trapped);
153 set_bit(NAPI_STATE_NPSVC, &napi->state);
155 work = napi->poll(napi, budget);
156 trace_napi_poll(napi);
158 clear_bit(NAPI_STATE_NPSVC, &napi->state);
159 atomic_dec(&trapped);
160 npinfo->rx_flags &= ~NETPOLL_RX_DROP;
162 return budget - work;
165 static void poll_napi(struct net_device *dev)
167 struct napi_struct *napi;
170 list_for_each_entry(napi, &dev->napi_list, dev_list) {
171 if (napi->poll_owner != smp_processor_id() &&
172 spin_trylock(&napi->poll_lock)) {
173 budget = poll_one_napi(dev->npinfo, napi, budget);
174 spin_unlock(&napi->poll_lock);
182 static void service_arp_queue(struct netpoll_info *npi)
187 while ((skb = skb_dequeue(&npi->arp_tx)))
192 static void netpoll_poll_dev(struct net_device *dev)
194 const struct net_device_ops *ops;
196 if (!dev || !netif_running(dev))
199 ops = dev->netdev_ops;
200 if (!ops->ndo_poll_controller)
203 /* Process pending work on NIC */
204 ops->ndo_poll_controller(dev);
208 if (dev->flags & IFF_SLAVE) {
210 struct net_device *bond_dev = dev->master;
212 while ((skb = skb_dequeue(&dev->npinfo->arp_tx))) {
214 skb_queue_tail(&bond_dev->npinfo->arp_tx, skb);
219 service_arp_queue(dev->npinfo);
221 zap_completion_queue();
224 static void refill_skbs(void)
229 spin_lock_irqsave(&skb_pool.lock, flags);
230 while (skb_pool.qlen < MAX_SKBS) {
231 skb = alloc_skb(MAX_SKB_SIZE, GFP_ATOMIC);
235 __skb_queue_tail(&skb_pool, skb);
237 spin_unlock_irqrestore(&skb_pool.lock, flags);
240 static void zap_completion_queue(void)
243 struct softnet_data *sd = &get_cpu_var(softnet_data);
245 if (sd->completion_queue) {
246 struct sk_buff *clist;
248 local_irq_save(flags);
249 clist = sd->completion_queue;
250 sd->completion_queue = NULL;
251 local_irq_restore(flags);
253 while (clist != NULL) {
254 struct sk_buff *skb = clist;
256 if (skb->destructor) {
257 atomic_inc(&skb->users);
258 dev_kfree_skb_any(skb); /* put this one back */
265 put_cpu_var(softnet_data);
268 static struct sk_buff *find_skb(struct netpoll *np, int len, int reserve)
273 zap_completion_queue();
277 skb = alloc_skb(len, GFP_ATOMIC);
279 skb = skb_dequeue(&skb_pool);
283 netpoll_poll_dev(np->dev);
289 atomic_set(&skb->users, 1);
290 skb_reserve(skb, reserve);
294 static int netpoll_owner_active(struct net_device *dev)
296 struct napi_struct *napi;
298 list_for_each_entry(napi, &dev->napi_list, dev_list) {
299 if (napi->poll_owner == smp_processor_id())
305 void netpoll_send_skb_on_dev(struct netpoll *np, struct sk_buff *skb,
306 struct net_device *dev)
308 int status = NETDEV_TX_BUSY;
310 const struct net_device_ops *ops = dev->netdev_ops;
311 /* It is up to the caller to keep npinfo alive. */
312 struct netpoll_info *npinfo = np->dev->npinfo;
314 if (!npinfo || !netif_running(dev) || !netif_device_present(dev)) {
319 /* don't get messages out of order, and no recursion */
320 if (skb_queue_len(&npinfo->txq) == 0 && !netpoll_owner_active(dev)) {
321 struct netdev_queue *txq;
324 txq = netdev_get_tx_queue(dev, skb_get_queue_mapping(skb));
326 local_irq_save(flags);
327 /* try until next clock tick */
328 for (tries = jiffies_to_usecs(1)/USEC_PER_POLL;
329 tries > 0; --tries) {
330 if (__netif_tx_trylock(txq)) {
331 if (!netif_xmit_stopped(txq)) {
332 status = ops->ndo_start_xmit(skb, dev);
333 if (status == NETDEV_TX_OK)
334 txq_trans_update(txq);
336 __netif_tx_unlock(txq);
338 if (status == NETDEV_TX_OK)
343 /* tickle device maybe there is some cleanup */
344 netpoll_poll_dev(np->dev);
346 udelay(USEC_PER_POLL);
349 WARN_ONCE(!irqs_disabled(),
350 "netpoll_send_skb(): %s enabled interrupts in poll (%pF)\n",
351 dev->name, ops->ndo_start_xmit);
353 local_irq_restore(flags);
356 if (status != NETDEV_TX_OK) {
357 skb_queue_tail(&npinfo->txq, skb);
358 schedule_delayed_work(&npinfo->tx_work,0);
361 EXPORT_SYMBOL(netpoll_send_skb_on_dev);
363 void netpoll_send_udp(struct netpoll *np, const char *msg, int len)
365 int total_len, ip_len, udp_len;
371 udp_len = len + sizeof(*udph);
372 ip_len = udp_len + sizeof(*iph);
373 total_len = ip_len + LL_RESERVED_SPACE(np->dev);
375 skb = find_skb(np, total_len + np->dev->needed_tailroom,
380 skb_copy_to_linear_data(skb, msg, len);
383 skb_push(skb, sizeof(*udph));
384 skb_reset_transport_header(skb);
386 udph->source = htons(np->local_port);
387 udph->dest = htons(np->remote_port);
388 udph->len = htons(udp_len);
390 udph->check = csum_tcpudp_magic(np->local_ip,
392 udp_len, IPPROTO_UDP,
393 csum_partial(udph, udp_len, 0));
394 if (udph->check == 0)
395 udph->check = CSUM_MANGLED_0;
397 skb_push(skb, sizeof(*iph));
398 skb_reset_network_header(skb);
401 /* iph->version = 4; iph->ihl = 5; */
402 put_unaligned(0x45, (unsigned char *)iph);
404 put_unaligned(htons(ip_len), &(iph->tot_len));
408 iph->protocol = IPPROTO_UDP;
410 put_unaligned(np->local_ip, &(iph->saddr));
411 put_unaligned(np->remote_ip, &(iph->daddr));
412 iph->check = ip_fast_csum((unsigned char *)iph, iph->ihl);
414 eth = (struct ethhdr *) skb_push(skb, ETH_HLEN);
415 skb_reset_mac_header(skb);
416 skb->protocol = eth->h_proto = htons(ETH_P_IP);
417 memcpy(eth->h_source, np->dev->dev_addr, ETH_ALEN);
418 memcpy(eth->h_dest, np->remote_mac, ETH_ALEN);
422 netpoll_send_skb(np, skb);
424 EXPORT_SYMBOL(netpoll_send_udp);
426 static void arp_reply(struct sk_buff *skb)
428 struct netpoll_info *npinfo = skb->dev->npinfo;
430 unsigned char *arp_ptr;
431 int size, type = ARPOP_REPLY, ptype = ETH_P_ARP;
434 struct sk_buff *send_skb;
435 struct netpoll *np, *tmp;
440 if (list_empty(&npinfo->rx_np))
443 /* Before checking the packet, we do some early
444 inspection whether this is interesting at all */
445 spin_lock_irqsave(&npinfo->rx_lock, flags);
446 list_for_each_entry_safe(np, tmp, &npinfo->rx_np, rx) {
447 if (np->dev == skb->dev)
450 spin_unlock_irqrestore(&npinfo->rx_lock, flags);
452 /* No netpoll struct is using this dev */
456 /* No arp on this interface */
457 if (skb->dev->flags & IFF_NOARP)
460 if (!pskb_may_pull(skb, arp_hdr_len(skb->dev)))
463 skb_reset_network_header(skb);
464 skb_reset_transport_header(skb);
467 if ((arp->ar_hrd != htons(ARPHRD_ETHER) &&
468 arp->ar_hrd != htons(ARPHRD_IEEE802)) ||
469 arp->ar_pro != htons(ETH_P_IP) ||
470 arp->ar_op != htons(ARPOP_REQUEST))
473 arp_ptr = (unsigned char *)(arp+1);
474 /* save the location of the src hw addr */
476 arp_ptr += skb->dev->addr_len;
477 memcpy(&sip, arp_ptr, 4);
479 /* If we actually cared about dst hw addr,
480 it would get copied here */
481 arp_ptr += skb->dev->addr_len;
482 memcpy(&tip, arp_ptr, 4);
484 /* Should we ignore arp? */
485 if (ipv4_is_loopback(tip) || ipv4_is_multicast(tip))
488 size = arp_hdr_len(skb->dev);
490 spin_lock_irqsave(&npinfo->rx_lock, flags);
491 list_for_each_entry_safe(np, tmp, &npinfo->rx_np, rx) {
492 if (tip != np->local_ip)
495 hlen = LL_RESERVED_SPACE(np->dev);
496 tlen = np->dev->needed_tailroom;
497 send_skb = find_skb(np, size + hlen + tlen, hlen);
501 skb_reset_network_header(send_skb);
502 arp = (struct arphdr *) skb_put(send_skb, size);
503 send_skb->dev = skb->dev;
504 send_skb->protocol = htons(ETH_P_ARP);
506 /* Fill the device header for the ARP frame */
507 if (dev_hard_header(send_skb, skb->dev, ptype,
508 sha, np->dev->dev_addr,
509 send_skb->len) < 0) {
515 * Fill out the arp protocol part.
517 * we only support ethernet device type,
518 * which (according to RFC 1390) should
519 * always equal 1 (Ethernet).
522 arp->ar_hrd = htons(np->dev->type);
523 arp->ar_pro = htons(ETH_P_IP);
524 arp->ar_hln = np->dev->addr_len;
526 arp->ar_op = htons(type);
528 arp_ptr = (unsigned char *)(arp + 1);
529 memcpy(arp_ptr, np->dev->dev_addr, np->dev->addr_len);
530 arp_ptr += np->dev->addr_len;
531 memcpy(arp_ptr, &tip, 4);
533 memcpy(arp_ptr, sha, np->dev->addr_len);
534 arp_ptr += np->dev->addr_len;
535 memcpy(arp_ptr, &sip, 4);
537 netpoll_send_skb(np, send_skb);
539 /* If there are several rx_hooks for the same address,
540 we're fine by sending a single reply */
543 spin_unlock_irqrestore(&npinfo->rx_lock, flags);
546 int __netpoll_rx(struct sk_buff *skb)
548 int proto, len, ulen;
550 const struct iphdr *iph;
552 struct netpoll_info *npinfo = skb->dev->npinfo;
553 struct netpoll *np, *tmp;
555 if (list_empty(&npinfo->rx_np))
558 if (skb->dev->type != ARPHRD_ETHER)
561 /* check if netpoll clients need ARP */
562 if (skb->protocol == htons(ETH_P_ARP) &&
563 atomic_read(&trapped)) {
564 skb_queue_tail(&npinfo->arp_tx, skb);
568 proto = ntohs(eth_hdr(skb)->h_proto);
569 if (proto != ETH_P_IP)
571 if (skb->pkt_type == PACKET_OTHERHOST)
576 if (!pskb_may_pull(skb, sizeof(struct iphdr)))
578 iph = (struct iphdr *)skb->data;
579 if (iph->ihl < 5 || iph->version != 4)
581 if (!pskb_may_pull(skb, iph->ihl*4))
583 iph = (struct iphdr *)skb->data;
584 if (ip_fast_csum((u8 *)iph, iph->ihl) != 0)
587 len = ntohs(iph->tot_len);
588 if (skb->len < len || len < iph->ihl*4)
592 * Our transport medium may have padded the buffer out.
593 * Now We trim to the true length of the frame.
595 if (pskb_trim_rcsum(skb, len))
598 iph = (struct iphdr *)skb->data;
599 if (iph->protocol != IPPROTO_UDP)
603 uh = (struct udphdr *)(((char *)iph) + iph->ihl*4);
604 ulen = ntohs(uh->len);
608 if (checksum_udp(skb, uh, ulen, iph->saddr, iph->daddr))
611 list_for_each_entry_safe(np, tmp, &npinfo->rx_np, rx) {
612 if (np->local_ip && np->local_ip != iph->daddr)
614 if (np->remote_ip && np->remote_ip != iph->saddr)
616 if (np->local_port && np->local_port != ntohs(uh->dest))
619 np->rx_hook(np, ntohs(uh->source),
621 ulen - sizeof(struct udphdr));
632 if (atomic_read(&trapped)) {
640 void netpoll_print_options(struct netpoll *np)
642 np_info(np, "local port %d\n", np->local_port);
643 np_info(np, "local IP %pI4\n", &np->local_ip);
644 np_info(np, "interface '%s'\n", np->dev_name);
645 np_info(np, "remote port %d\n", np->remote_port);
646 np_info(np, "remote IP %pI4\n", &np->remote_ip);
647 np_info(np, "remote ethernet address %pM\n", np->remote_mac);
649 EXPORT_SYMBOL(netpoll_print_options);
651 int netpoll_parse_options(struct netpoll *np, char *opt)
653 char *cur=opt, *delim;
656 if ((delim = strchr(cur, '@')) == NULL)
659 np->local_port = simple_strtol(cur, NULL, 10);
665 if ((delim = strchr(cur, '/')) == NULL)
668 np->local_ip = in_aton(cur);
674 /* parse out dev name */
675 if ((delim = strchr(cur, ',')) == NULL)
678 strlcpy(np->dev_name, cur, sizeof(np->dev_name));
685 if ((delim = strchr(cur, '@')) == NULL)
688 if (*cur == ' ' || *cur == '\t')
689 np_info(np, "warning: whitespace is not allowed\n");
690 np->remote_port = simple_strtol(cur, NULL, 10);
696 if ((delim = strchr(cur, '/')) == NULL)
699 np->remote_ip = in_aton(cur);
704 if (!mac_pton(cur, np->remote_mac))
708 netpoll_print_options(np);
713 np_info(np, "couldn't parse config at '%s'!\n", cur);
716 EXPORT_SYMBOL(netpoll_parse_options);
718 int __netpoll_setup(struct netpoll *np, struct net_device *ndev)
720 struct netpoll_info *npinfo;
721 const struct net_device_ops *ops;
726 strlcpy(np->dev_name, ndev->name, IFNAMSIZ);
728 if ((ndev->priv_flags & IFF_DISABLE_NETPOLL) ||
729 !ndev->netdev_ops->ndo_poll_controller) {
730 np_err(np, "%s doesn't support polling, aborting\n",
737 npinfo = kmalloc(sizeof(*npinfo), GFP_KERNEL);
743 npinfo->rx_flags = 0;
744 INIT_LIST_HEAD(&npinfo->rx_np);
746 spin_lock_init(&npinfo->rx_lock);
747 skb_queue_head_init(&npinfo->arp_tx);
748 skb_queue_head_init(&npinfo->txq);
749 INIT_DELAYED_WORK(&npinfo->tx_work, queue_process);
751 atomic_set(&npinfo->refcnt, 1);
753 ops = np->dev->netdev_ops;
754 if (ops->ndo_netpoll_setup) {
755 err = ops->ndo_netpoll_setup(ndev, npinfo);
760 npinfo = ndev->npinfo;
761 atomic_inc(&npinfo->refcnt);
764 npinfo->netpoll = np;
767 spin_lock_irqsave(&npinfo->rx_lock, flags);
768 npinfo->rx_flags |= NETPOLL_RX_ENABLED;
769 list_add_tail(&np->rx, &npinfo->rx_np);
770 spin_unlock_irqrestore(&npinfo->rx_lock, flags);
773 /* last thing to do is link it to the net device structure */
774 rcu_assign_pointer(ndev->npinfo, npinfo);
783 EXPORT_SYMBOL_GPL(__netpoll_setup);
785 int netpoll_setup(struct netpoll *np)
787 struct net_device *ndev = NULL;
788 struct in_device *in_dev;
792 ndev = dev_get_by_name(&init_net, np->dev_name);
794 np_err(np, "%s doesn't exist, aborting\n", np->dev_name);
799 np_err(np, "%s is a slave device, aborting\n", np->dev_name);
804 if (!netif_running(ndev)) {
805 unsigned long atmost, atleast;
807 np_info(np, "device %s not up yet, forcing it\n", np->dev_name);
810 err = dev_open(ndev);
814 np_err(np, "failed to open %s\n", ndev->name);
818 atleast = jiffies + HZ/10;
819 atmost = jiffies + carrier_timeout * HZ;
820 while (!netif_carrier_ok(ndev)) {
821 if (time_after(jiffies, atmost)) {
822 np_notice(np, "timeout waiting for carrier\n");
828 /* If carrier appears to come up instantly, we don't
829 * trust it and pause so that we don't pump all our
830 * queued console messages into the bitbucket.
833 if (time_before(jiffies, atleast)) {
834 np_notice(np, "carrier detect appears untrustworthy, waiting 4 seconds\n");
841 in_dev = __in_dev_get_rcu(ndev);
843 if (!in_dev || !in_dev->ifa_list) {
845 np_err(np, "no IP address for %s, aborting\n",
851 np->local_ip = in_dev->ifa_list->ifa_local;
853 np_info(np, "local IP %pI4\n", &np->local_ip);
856 /* fill up the skb queue */
860 err = __netpoll_setup(np, ndev);
872 EXPORT_SYMBOL(netpoll_setup);
874 static int __init netpoll_init(void)
876 skb_queue_head_init(&skb_pool);
879 core_initcall(netpoll_init);
881 void __netpoll_cleanup(struct netpoll *np)
883 struct netpoll_info *npinfo;
886 npinfo = np->dev->npinfo;
890 if (!list_empty(&npinfo->rx_np)) {
891 spin_lock_irqsave(&npinfo->rx_lock, flags);
893 if (list_empty(&npinfo->rx_np))
894 npinfo->rx_flags &= ~NETPOLL_RX_ENABLED;
895 spin_unlock_irqrestore(&npinfo->rx_lock, flags);
898 if (atomic_dec_and_test(&npinfo->refcnt)) {
899 const struct net_device_ops *ops;
901 ops = np->dev->netdev_ops;
902 if (ops->ndo_netpoll_cleanup)
903 ops->ndo_netpoll_cleanup(np->dev);
905 RCU_INIT_POINTER(np->dev->npinfo, NULL);
907 /* avoid racing with NAPI reading npinfo */
908 synchronize_rcu_bh();
910 skb_queue_purge(&npinfo->arp_tx);
911 skb_queue_purge(&npinfo->txq);
912 cancel_delayed_work_sync(&npinfo->tx_work);
914 /* clean after last, unfinished work */
915 __skb_queue_purge(&npinfo->txq);
919 EXPORT_SYMBOL_GPL(__netpoll_cleanup);
921 void netpoll_cleanup(struct netpoll *np)
927 __netpoll_cleanup(np);
933 EXPORT_SYMBOL(netpoll_cleanup);
935 int netpoll_trap(void)
937 return atomic_read(&trapped);
939 EXPORT_SYMBOL(netpoll_trap);
941 void netpoll_set_trap(int trap)
944 atomic_inc(&trapped);
946 atomic_dec(&trapped);
948 EXPORT_SYMBOL(netpoll_set_trap);