1 // SPDX-License-Identifier: GPL-2.0-only
3 * Common framework for low-level network console, dump, and debugger code
7 * based on the netconsole code from:
10 * Copyright (C) 2002 Red Hat, Inc.
13 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
15 #include <linux/moduleparam.h>
16 #include <linux/kernel.h>
17 #include <linux/netdevice.h>
18 #include <linux/etherdevice.h>
19 #include <linux/string.h>
20 #include <linux/if_arp.h>
21 #include <linux/inetdevice.h>
22 #include <linux/inet.h>
23 #include <linux/interrupt.h>
24 #include <linux/netpoll.h>
25 #include <linux/sched.h>
26 #include <linux/delay.h>
27 #include <linux/rcupdate.h>
28 #include <linux/workqueue.h>
29 #include <linux/slab.h>
30 #include <linux/export.h>
31 #include <linux/if_vlan.h>
34 #include <net/addrconf.h>
35 #include <net/ndisc.h>
36 #include <net/ip6_checksum.h>
37 #include <linux/unaligned.h>
38 #include <trace/events/napi.h>
39 #include <linux/kconfig.h>
42 * We maintain a small pool of fully-sized skbs, to make sure the
43 * message gets out even in extreme OOM situations.
46 #define MAX_UDP_CHUNK 1460
48 #define USEC_PER_POLL 50
50 #define MAX_SKB_SIZE \
51 (sizeof(struct ethhdr) + \
52 sizeof(struct iphdr) + \
53 sizeof(struct udphdr) + \
56 static void zap_completion_queue(void);
58 static unsigned int carrier_timeout = 4;
59 module_param(carrier_timeout, uint, 0644);
61 #define np_info(np, fmt, ...) \
62 pr_info("%s: " fmt, np->name, ##__VA_ARGS__)
63 #define np_err(np, fmt, ...) \
64 pr_err("%s: " fmt, np->name, ##__VA_ARGS__)
65 #define np_notice(np, fmt, ...) \
66 pr_notice("%s: " fmt, np->name, ##__VA_ARGS__)
68 static netdev_tx_t netpoll_start_xmit(struct sk_buff *skb,
69 struct net_device *dev,
70 struct netdev_queue *txq)
72 netdev_tx_t status = NETDEV_TX_OK;
73 netdev_features_t features;
75 features = netif_skb_features(skb);
77 if (skb_vlan_tag_present(skb) &&
78 !vlan_hw_offload_capable(features, skb->vlan_proto)) {
79 skb = __vlan_hwaccel_push_inside(skb);
81 /* This is actually a packet drop, but we
82 * don't want the code that calls this
83 * function to try and operate on a NULL skb.
89 status = netdev_start_xmit(skb, dev, txq, false);
95 static void queue_process(struct work_struct *work)
97 struct netpoll_info *npinfo =
98 container_of(work, struct netpoll_info, tx_work.work);
102 while ((skb = skb_dequeue(&npinfo->txq))) {
103 struct net_device *dev = skb->dev;
104 struct netdev_queue *txq;
105 unsigned int q_index;
107 if (!netif_device_present(dev) || !netif_running(dev)) {
112 local_irq_save(flags);
113 /* check if skb->queue_mapping is still valid */
114 q_index = skb_get_queue_mapping(skb);
115 if (unlikely(q_index >= dev->real_num_tx_queues)) {
116 q_index = q_index % dev->real_num_tx_queues;
117 skb_set_queue_mapping(skb, q_index);
119 txq = netdev_get_tx_queue(dev, q_index);
120 HARD_TX_LOCK(dev, txq, smp_processor_id());
121 if (netif_xmit_frozen_or_stopped(txq) ||
122 !dev_xmit_complete(netpoll_start_xmit(skb, dev, txq))) {
123 skb_queue_head(&npinfo->txq, skb);
124 HARD_TX_UNLOCK(dev, txq);
125 local_irq_restore(flags);
127 schedule_delayed_work(&npinfo->tx_work, HZ/10);
130 HARD_TX_UNLOCK(dev, txq);
131 local_irq_restore(flags);
135 static int netif_local_xmit_active(struct net_device *dev)
139 for (i = 0; i < dev->num_tx_queues; i++) {
140 struct netdev_queue *txq = netdev_get_tx_queue(dev, i);
142 if (READ_ONCE(txq->xmit_lock_owner) == smp_processor_id())
149 static void poll_one_napi(struct napi_struct *napi)
153 /* If we set this bit but see that it has already been set,
154 * that indicates that napi has been disabled and we need
155 * to abort this operation
157 if (test_and_set_bit(NAPI_STATE_NPSVC, &napi->state))
160 /* We explicitly pass the polling call a budget of 0 to
161 * indicate that we are clearing the Tx path only.
163 work = napi->poll(napi, 0);
164 WARN_ONCE(work, "%pS exceeded budget in poll\n", napi->poll);
165 trace_napi_poll(napi, work, 0);
167 clear_bit(NAPI_STATE_NPSVC, &napi->state);
170 static void poll_napi(struct net_device *dev)
172 struct napi_struct *napi;
173 int cpu = smp_processor_id();
175 list_for_each_entry_rcu(napi, &dev->napi_list, dev_list) {
176 if (cmpxchg(&napi->poll_owner, -1, cpu) == -1) {
178 smp_store_release(&napi->poll_owner, -1);
183 void netpoll_poll_dev(struct net_device *dev)
185 struct netpoll_info *ni = rcu_dereference_bh(dev->npinfo);
186 const struct net_device_ops *ops;
188 /* Don't do any rx activity if the dev_lock mutex is held
189 * the dev_open/close paths use this to block netpoll activity
190 * while changing device state
192 if (!ni || down_trylock(&ni->dev_lock))
195 /* Some drivers will take the same locks in poll and xmit,
196 * we can't poll if local CPU is already in xmit.
198 if (!netif_running(dev) || netif_local_xmit_active(dev)) {
203 ops = dev->netdev_ops;
204 if (ops->ndo_poll_controller)
205 ops->ndo_poll_controller(dev);
211 zap_completion_queue();
213 EXPORT_SYMBOL(netpoll_poll_dev);
215 void netpoll_poll_disable(struct net_device *dev)
217 struct netpoll_info *ni;
220 ni = rtnl_dereference(dev->npinfo);
225 void netpoll_poll_enable(struct net_device *dev)
227 struct netpoll_info *ni;
229 ni = rtnl_dereference(dev->npinfo);
234 static void refill_skbs(struct netpoll *np)
236 struct sk_buff_head *skb_pool;
240 skb_pool = &np->skb_pool;
242 spin_lock_irqsave(&skb_pool->lock, flags);
243 while (skb_pool->qlen < MAX_SKBS) {
244 skb = alloc_skb(MAX_SKB_SIZE, GFP_ATOMIC);
248 __skb_queue_tail(skb_pool, skb);
250 spin_unlock_irqrestore(&skb_pool->lock, flags);
253 static void zap_completion_queue(void)
256 struct softnet_data *sd = &get_cpu_var(softnet_data);
258 if (sd->completion_queue) {
259 struct sk_buff *clist;
261 local_irq_save(flags);
262 clist = sd->completion_queue;
263 sd->completion_queue = NULL;
264 local_irq_restore(flags);
266 while (clist != NULL) {
267 struct sk_buff *skb = clist;
269 if (!skb_irq_freeable(skb)) {
270 refcount_set(&skb->users, 1);
271 dev_kfree_skb_any(skb); /* put this one back */
278 put_cpu_var(softnet_data);
281 static struct sk_buff *find_skb(struct netpoll *np, int len, int reserve)
286 zap_completion_queue();
290 skb = alloc_skb(len, GFP_ATOMIC);
292 skb = skb_dequeue(&np->skb_pool);
296 netpoll_poll_dev(np->dev);
302 refcount_set(&skb->users, 1);
303 skb_reserve(skb, reserve);
307 static int netpoll_owner_active(struct net_device *dev)
309 struct napi_struct *napi;
311 list_for_each_entry_rcu(napi, &dev->napi_list, dev_list) {
312 if (READ_ONCE(napi->poll_owner) == smp_processor_id())
318 /* call with IRQ disabled */
319 static netdev_tx_t __netpoll_send_skb(struct netpoll *np, struct sk_buff *skb)
321 netdev_tx_t status = NETDEV_TX_BUSY;
322 struct net_device *dev;
324 /* It is up to the caller to keep npinfo alive. */
325 struct netpoll_info *npinfo;
327 lockdep_assert_irqs_disabled();
330 npinfo = rcu_dereference_bh(dev->npinfo);
332 if (!npinfo || !netif_running(dev) || !netif_device_present(dev)) {
333 dev_kfree_skb_irq(skb);
334 return NET_XMIT_DROP;
337 /* don't get messages out of order, and no recursion */
338 if (skb_queue_len(&npinfo->txq) == 0 && !netpoll_owner_active(dev)) {
339 struct netdev_queue *txq;
341 txq = netdev_core_pick_tx(dev, skb, NULL);
343 /* try until next clock tick */
344 for (tries = jiffies_to_usecs(1)/USEC_PER_POLL;
345 tries > 0; --tries) {
346 if (HARD_TX_TRYLOCK(dev, txq)) {
347 if (!netif_xmit_stopped(txq))
348 status = netpoll_start_xmit(skb, dev, txq);
350 HARD_TX_UNLOCK(dev, txq);
352 if (dev_xmit_complete(status))
357 /* tickle device maybe there is some cleanup */
358 netpoll_poll_dev(np->dev);
360 udelay(USEC_PER_POLL);
363 WARN_ONCE(!irqs_disabled(),
364 "netpoll_send_skb_on_dev(): %s enabled interrupts in poll (%pS)\n",
365 dev->name, dev->netdev_ops->ndo_start_xmit);
369 if (!dev_xmit_complete(status)) {
370 skb_queue_tail(&npinfo->txq, skb);
371 schedule_delayed_work(&npinfo->tx_work,0);
376 netdev_tx_t netpoll_send_skb(struct netpoll *np, struct sk_buff *skb)
382 dev_kfree_skb_irq(skb);
385 local_irq_save(flags);
386 ret = __netpoll_send_skb(np, skb);
387 local_irq_restore(flags);
391 EXPORT_SYMBOL(netpoll_send_skb);
393 void netpoll_send_udp(struct netpoll *np, const char *msg, int len)
395 int total_len, ip_len, udp_len;
400 static atomic_t ip_ident;
401 struct ipv6hdr *ip6h;
403 if (!IS_ENABLED(CONFIG_PREEMPT_RT))
404 WARN_ON_ONCE(!irqs_disabled());
406 udp_len = len + sizeof(*udph);
408 ip_len = udp_len + sizeof(*ip6h);
410 ip_len = udp_len + sizeof(*iph);
412 total_len = ip_len + LL_RESERVED_SPACE(np->dev);
414 skb = find_skb(np, total_len + np->dev->needed_tailroom,
419 skb_copy_to_linear_data(skb, msg, len);
422 skb_push(skb, sizeof(*udph));
423 skb_reset_transport_header(skb);
425 udph->source = htons(np->local_port);
426 udph->dest = htons(np->remote_port);
427 udph->len = htons(udp_len);
431 udph->check = csum_ipv6_magic(&np->local_ip.in6,
433 udp_len, IPPROTO_UDP,
434 csum_partial(udph, udp_len, 0));
435 if (udph->check == 0)
436 udph->check = CSUM_MANGLED_0;
438 skb_push(skb, sizeof(*ip6h));
439 skb_reset_network_header(skb);
440 ip6h = ipv6_hdr(skb);
442 /* ip6h->version = 6; ip6h->priority = 0; */
443 *(unsigned char *)ip6h = 0x60;
444 ip6h->flow_lbl[0] = 0;
445 ip6h->flow_lbl[1] = 0;
446 ip6h->flow_lbl[2] = 0;
448 ip6h->payload_len = htons(sizeof(struct udphdr) + len);
449 ip6h->nexthdr = IPPROTO_UDP;
450 ip6h->hop_limit = 32;
451 ip6h->saddr = np->local_ip.in6;
452 ip6h->daddr = np->remote_ip.in6;
454 eth = skb_push(skb, ETH_HLEN);
455 skb_reset_mac_header(skb);
456 skb->protocol = eth->h_proto = htons(ETH_P_IPV6);
459 udph->check = csum_tcpudp_magic(np->local_ip.ip,
461 udp_len, IPPROTO_UDP,
462 csum_partial(udph, udp_len, 0));
463 if (udph->check == 0)
464 udph->check = CSUM_MANGLED_0;
466 skb_push(skb, sizeof(*iph));
467 skb_reset_network_header(skb);
470 /* iph->version = 4; iph->ihl = 5; */
471 *(unsigned char *)iph = 0x45;
473 put_unaligned(htons(ip_len), &(iph->tot_len));
474 iph->id = htons(atomic_inc_return(&ip_ident));
477 iph->protocol = IPPROTO_UDP;
479 put_unaligned(np->local_ip.ip, &(iph->saddr));
480 put_unaligned(np->remote_ip.ip, &(iph->daddr));
481 iph->check = ip_fast_csum((unsigned char *)iph, iph->ihl);
483 eth = skb_push(skb, ETH_HLEN);
484 skb_reset_mac_header(skb);
485 skb->protocol = eth->h_proto = htons(ETH_P_IP);
488 ether_addr_copy(eth->h_source, np->dev->dev_addr);
489 ether_addr_copy(eth->h_dest, np->remote_mac);
493 netpoll_send_skb(np, skb);
495 EXPORT_SYMBOL(netpoll_send_udp);
497 void netpoll_print_options(struct netpoll *np)
499 np_info(np, "local port %d\n", np->local_port);
501 np_info(np, "local IPv6 address %pI6c\n", &np->local_ip.in6);
503 np_info(np, "local IPv4 address %pI4\n", &np->local_ip.ip);
504 np_info(np, "interface '%s'\n", np->dev_name);
505 np_info(np, "remote port %d\n", np->remote_port);
507 np_info(np, "remote IPv6 address %pI6c\n", &np->remote_ip.in6);
509 np_info(np, "remote IPv4 address %pI4\n", &np->remote_ip.ip);
510 np_info(np, "remote ethernet address %pM\n", np->remote_mac);
512 EXPORT_SYMBOL(netpoll_print_options);
514 static int netpoll_parse_ip_addr(const char *str, union inet_addr *addr)
518 if (!strchr(str, ':') &&
519 in4_pton(str, -1, (void *)addr, -1, &end) > 0) {
523 if (in6_pton(str, -1, addr->in6.s6_addr, -1, &end) > 0) {
524 #if IS_ENABLED(CONFIG_IPV6)
534 static void skb_pool_flush(struct netpoll *np)
536 struct sk_buff_head *skb_pool;
538 skb_pool = &np->skb_pool;
539 skb_queue_purge_reason(skb_pool, SKB_CONSUMED);
542 int netpoll_parse_options(struct netpoll *np, char *opt)
544 char *cur=opt, *delim;
546 bool ipversion_set = false;
549 if ((delim = strchr(cur, '@')) == NULL)
552 if (kstrtou16(cur, 10, &np->local_port))
559 ipversion_set = true;
560 if ((delim = strchr(cur, '/')) == NULL)
563 ipv6 = netpoll_parse_ip_addr(cur, &np->local_ip);
567 np->ipv6 = (bool)ipv6;
573 /* parse out dev name */
574 if ((delim = strchr(cur, ',')) == NULL)
577 strscpy(np->dev_name, cur, sizeof(np->dev_name));
584 if ((delim = strchr(cur, '@')) == NULL)
587 if (*cur == ' ' || *cur == '\t')
588 np_info(np, "warning: whitespace is not allowed\n");
589 if (kstrtou16(cur, 10, &np->remote_port))
596 if ((delim = strchr(cur, '/')) == NULL)
599 ipv6 = netpoll_parse_ip_addr(cur, &np->remote_ip);
602 else if (ipversion_set && np->ipv6 != (bool)ipv6)
605 np->ipv6 = (bool)ipv6;
610 if (!mac_pton(cur, np->remote_mac))
614 netpoll_print_options(np);
619 np_info(np, "couldn't parse config at '%s'!\n", cur);
622 EXPORT_SYMBOL(netpoll_parse_options);
624 int __netpoll_setup(struct netpoll *np, struct net_device *ndev)
626 struct netpoll_info *npinfo;
627 const struct net_device_ops *ops;
630 if (ndev->priv_flags & IFF_DISABLE_NETPOLL) {
631 np_err(np, "%s doesn't support polling, aborting\n",
637 if (!rcu_access_pointer(ndev->npinfo)) {
638 npinfo = kmalloc(sizeof(*npinfo), GFP_KERNEL);
644 sema_init(&npinfo->dev_lock, 1);
645 skb_queue_head_init(&npinfo->txq);
646 INIT_DELAYED_WORK(&npinfo->tx_work, queue_process);
648 refcount_set(&npinfo->refcnt, 1);
650 ops = ndev->netdev_ops;
651 if (ops->ndo_netpoll_setup) {
652 err = ops->ndo_netpoll_setup(ndev);
657 npinfo = rtnl_dereference(ndev->npinfo);
658 refcount_inc(&npinfo->refcnt);
662 strscpy(np->dev_name, ndev->name, IFNAMSIZ);
663 npinfo->netpoll = np;
665 /* last thing to do is link it to the net device structure */
666 rcu_assign_pointer(ndev->npinfo, npinfo);
675 EXPORT_SYMBOL_GPL(__netpoll_setup);
677 int netpoll_setup(struct netpoll *np)
679 struct net_device *ndev = NULL;
680 bool ip_overwritten = false;
681 struct in_device *in_dev;
684 skb_queue_head_init(&np->skb_pool);
687 if (np->dev_name[0]) {
688 struct net *net = current->nsproxy->net_ns;
689 ndev = __dev_get_by_name(net, np->dev_name);
692 np_err(np, "%s doesn't exist, aborting\n", np->dev_name);
696 netdev_hold(ndev, &np->dev_tracker, GFP_KERNEL);
698 if (netdev_master_upper_dev_get(ndev)) {
699 np_err(np, "%s is a slave device, aborting\n", np->dev_name);
704 if (!netif_running(ndev)) {
705 unsigned long atmost;
707 np_info(np, "device %s not up yet, forcing it\n", np->dev_name);
709 err = dev_open(ndev, NULL);
712 np_err(np, "failed to open %s\n", ndev->name);
717 atmost = jiffies + carrier_timeout * HZ;
718 while (!netif_carrier_ok(ndev)) {
719 if (time_after(jiffies, atmost)) {
720 np_notice(np, "timeout waiting for carrier\n");
729 if (!np->local_ip.ip) {
731 const struct in_ifaddr *ifa;
733 in_dev = __in_dev_get_rtnl(ndev);
737 ifa = rtnl_dereference(in_dev->ifa_list);
740 np_err(np, "no IP address for %s, aborting\n",
746 np->local_ip.ip = ifa->ifa_local;
747 ip_overwritten = true;
748 np_info(np, "local IP %pI4\n", &np->local_ip.ip);
750 #if IS_ENABLED(CONFIG_IPV6)
751 struct inet6_dev *idev;
754 idev = __in6_dev_get(ndev);
756 struct inet6_ifaddr *ifp;
758 read_lock_bh(&idev->lock);
759 list_for_each_entry(ifp, &idev->addr_list, if_list) {
760 if (!!(ipv6_addr_type(&ifp->addr) & IPV6_ADDR_LINKLOCAL) !=
761 !!(ipv6_addr_type(&np->remote_ip.in6) & IPV6_ADDR_LINKLOCAL))
763 np->local_ip.in6 = ifp->addr;
764 ip_overwritten = true;
768 read_unlock_bh(&idev->lock);
771 np_err(np, "no IPv6 address for %s, aborting\n",
775 np_info(np, "local IPv6 %pI6c\n", &np->local_ip.in6);
777 np_err(np, "IPv6 is not supported %s, aborting\n",
785 /* fill up the skb queue */
788 err = __netpoll_setup(np, ndev);
797 DEBUG_NET_WARN_ON_ONCE(np->dev);
799 memset(&np->local_ip, 0, sizeof(np->local_ip));
800 netdev_put(ndev, &np->dev_tracker);
805 EXPORT_SYMBOL(netpoll_setup);
807 static void rcu_cleanup_netpoll_info(struct rcu_head *rcu_head)
809 struct netpoll_info *npinfo =
810 container_of(rcu_head, struct netpoll_info, rcu);
812 skb_queue_purge(&npinfo->txq);
814 /* we can't call cancel_delayed_work_sync here, as we are in softirq */
815 cancel_delayed_work(&npinfo->tx_work);
817 /* clean after last, unfinished work */
818 __skb_queue_purge(&npinfo->txq);
819 /* now cancel it again */
820 cancel_delayed_work(&npinfo->tx_work);
824 void __netpoll_cleanup(struct netpoll *np)
826 struct netpoll_info *npinfo;
828 npinfo = rtnl_dereference(np->dev->npinfo);
832 if (refcount_dec_and_test(&npinfo->refcnt)) {
833 const struct net_device_ops *ops;
835 ops = np->dev->netdev_ops;
836 if (ops->ndo_netpoll_cleanup)
837 ops->ndo_netpoll_cleanup(np->dev);
839 RCU_INIT_POINTER(np->dev->npinfo, NULL);
840 call_rcu(&npinfo->rcu, rcu_cleanup_netpoll_info);
842 RCU_INIT_POINTER(np->dev->npinfo, NULL);
846 EXPORT_SYMBOL_GPL(__netpoll_cleanup);
848 void __netpoll_free(struct netpoll *np)
852 /* Wait for transmitting packets to finish before freeing. */
854 __netpoll_cleanup(np);
857 EXPORT_SYMBOL_GPL(__netpoll_free);
859 void do_netpoll_cleanup(struct netpoll *np)
861 __netpoll_cleanup(np);
862 netdev_put(np->dev, &np->dev_tracker);
865 EXPORT_SYMBOL(do_netpoll_cleanup);
867 void netpoll_cleanup(struct netpoll *np)
872 do_netpoll_cleanup(np);
876 EXPORT_SYMBOL(netpoll_cleanup);