1 // SPDX-License-Identifier: GPL-2.0-or-later
3 * linux/drivers/net/netconsole.c
7 * This file contains the implementation of an IRQ-safe, crash-safe
8 * kernel console implementation that outputs kernel messages to the
11 * Modification history:
13 * 2001-09-17 started by Ingo Molnar.
14 * 2003-08-11 2.6 port by Matt Mackall
18 * 2003-09-07 rewritten with netpoll api
21 /****************************************************************
23 ****************************************************************/
25 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
28 #include <linux/init.h>
29 #include <linux/module.h>
30 #include <linux/slab.h>
31 #include <linux/console.h>
32 #include <linux/moduleparam.h>
33 #include <linux/kernel.h>
34 #include <linux/string.h>
35 #include <linux/netpoll.h>
36 #include <linux/inet.h>
37 #include <linux/configfs.h>
38 #include <linux/etherdevice.h>
39 #include <linux/utsname.h>
40 #include <linux/rtnetlink.h>
43 MODULE_DESCRIPTION("Console driver for network interfaces");
44 MODULE_LICENSE("GPL");
46 #define MAX_PARAM_LENGTH 256
47 #define MAX_USERDATA_ENTRY_LENGTH 256
48 #define MAX_USERDATA_VALUE_LENGTH 200
49 /* The number 3 comes from userdata entry format characters (' ', '=', '\n') */
50 #define MAX_USERDATA_NAME_LENGTH (MAX_USERDATA_ENTRY_LENGTH - \
51 MAX_USERDATA_VALUE_LENGTH - 3)
52 #define MAX_USERDATA_ITEMS 16
53 #define MAX_PRINT_CHUNK 1000
55 static char config[MAX_PARAM_LENGTH];
56 module_param_string(netconsole, config, MAX_PARAM_LENGTH, 0);
57 MODULE_PARM_DESC(netconsole, " netconsole=[src-port]@[src-ip]/[dev],[tgt-port]@<tgt-ip>/[tgt-macaddr]");
59 static bool oops_only;
60 module_param(oops_only, bool, 0600);
61 MODULE_PARM_DESC(oops_only, "Only log oops messages");
63 #define NETCONSOLE_PARAM_TARGET_PREFIX "cmdline"
66 static int __init option_setup(char *opt)
68 strscpy(config, opt, MAX_PARAM_LENGTH);
71 __setup("netconsole=", option_setup);
74 /* Linked list of all configured targets */
75 static LIST_HEAD(target_list);
76 /* target_cleanup_list is used to track targets that need to be cleaned outside
77 * of target_list_lock. It should be cleaned in the same function it is
80 static LIST_HEAD(target_cleanup_list);
82 /* This needs to be a spinlock because write_msg() cannot sleep */
83 static DEFINE_SPINLOCK(target_list_lock);
84 /* This needs to be a mutex because netpoll_cleanup might sleep */
85 static DEFINE_MUTEX(target_cleanup_list_lock);
88 * Console driver for extended netconsoles. Registered on the first use to
89 * avoid unnecessarily enabling ext message formatting.
91 static struct console netconsole_ext;
94 * struct netconsole_target - Represents a configured netconsole target.
95 * @list: Links this target into the target_list.
96 * @group: Links us into the configfs subsystem hierarchy.
97 * @userdata_group: Links to the userdata configfs hierarchy
98 * @userdata_complete: Cached, formatted string of append
99 * @userdata_length: String length of userdata_complete
100 * @enabled: On / off knob to enable / disable target.
101 * Visible from userspace (read-write).
102 * We maintain a strict 1:1 correspondence between this and
103 * whether the corresponding netpoll is active or inactive.
104 * Also, other parameters of a target may be modified at
105 * runtime only when it is disabled (enabled == 0).
106 * @extended: Denotes whether console is extended or not.
107 * @release: Denotes whether kernel release version should be prepended
108 * to the message. Depends on extended console.
109 * @np: The netpoll structure for this target.
110 * Contains the other userspace visible parameters:
111 * dev_name (read-write)
112 * local_port (read-write)
113 * remote_port (read-write)
114 * local_ip (read-write)
115 * remote_ip (read-write)
116 * local_mac (read-only)
117 * remote_mac (read-write)
119 struct netconsole_target {
120 struct list_head list;
121 #ifdef CONFIG_NETCONSOLE_DYNAMIC
122 struct config_group group;
123 struct config_group userdata_group;
124 char userdata_complete[MAX_USERDATA_ENTRY_LENGTH * MAX_USERDATA_ITEMS];
125 size_t userdata_length;
133 #ifdef CONFIG_NETCONSOLE_DYNAMIC
135 static struct configfs_subsystem netconsole_subsys;
136 static DEFINE_MUTEX(dynamic_netconsole_mutex);
138 static int __init dynamic_netconsole_init(void)
140 config_group_init(&netconsole_subsys.su_group);
141 mutex_init(&netconsole_subsys.su_mutex);
142 return configfs_register_subsystem(&netconsole_subsys);
145 static void __exit dynamic_netconsole_exit(void)
147 configfs_unregister_subsystem(&netconsole_subsys);
151 * Targets that were created by parsing the boot/module option string
152 * do not exist in the configfs hierarchy (and have NULL names) and will
153 * never go away, so make these a no-op for them.
155 static void netconsole_target_get(struct netconsole_target *nt)
157 if (config_item_name(&nt->group.cg_item))
158 config_group_get(&nt->group);
161 static void netconsole_target_put(struct netconsole_target *nt)
163 if (config_item_name(&nt->group.cg_item))
164 config_group_put(&nt->group);
167 #else /* !CONFIG_NETCONSOLE_DYNAMIC */
169 static int __init dynamic_netconsole_init(void)
174 static void __exit dynamic_netconsole_exit(void)
179 * No danger of targets going away from under us when dynamic
180 * reconfigurability is off.
182 static void netconsole_target_get(struct netconsole_target *nt)
186 static void netconsole_target_put(struct netconsole_target *nt)
190 static void populate_configfs_item(struct netconsole_target *nt,
194 #endif /* CONFIG_NETCONSOLE_DYNAMIC */
196 /* Allocate and initialize with defaults.
197 * Note that these targets get their config_item fields zeroed-out.
199 static struct netconsole_target *alloc_and_init(void)
201 struct netconsole_target *nt;
203 nt = kzalloc(sizeof(*nt), GFP_KERNEL);
207 if (IS_ENABLED(CONFIG_NETCONSOLE_EXTENDED_LOG))
209 if (IS_ENABLED(CONFIG_NETCONSOLE_PREPEND_RELEASE))
212 nt->np.name = "netconsole";
213 strscpy(nt->np.dev_name, "eth0", IFNAMSIZ);
214 nt->np.local_port = 6665;
215 nt->np.remote_port = 6666;
216 eth_broadcast_addr(nt->np.remote_mac);
221 /* Clean up every target in the cleanup_list and move the clean targets back to
222 * the main target_list.
224 static void netconsole_process_cleanups_core(void)
226 struct netconsole_target *nt, *tmp;
229 /* The cleanup needs RTNL locked */
232 mutex_lock(&target_cleanup_list_lock);
233 list_for_each_entry_safe(nt, tmp, &target_cleanup_list, list) {
234 /* all entries in the cleanup_list needs to be disabled */
235 WARN_ON_ONCE(nt->enabled);
236 do_netpoll_cleanup(&nt->np);
237 /* moved the cleaned target to target_list. Need to hold both
240 spin_lock_irqsave(&target_list_lock, flags);
241 list_move(&nt->list, &target_list);
242 spin_unlock_irqrestore(&target_list_lock, flags);
244 WARN_ON_ONCE(!list_empty(&target_cleanup_list));
245 mutex_unlock(&target_cleanup_list_lock);
248 #ifdef CONFIG_NETCONSOLE_DYNAMIC
251 * Our subsystem hierarchy is:
253 * /sys/kernel/config/netconsole/
273 static struct netconsole_target *to_target(struct config_item *item)
275 struct config_group *cfg_group;
277 cfg_group = to_config_group(item);
280 return container_of(to_config_group(item),
281 struct netconsole_target, group);
284 /* Do the list cleanup with the rtnl lock hold. rtnl lock is necessary because
285 * netdev might be cleaned-up by calling __netpoll_cleanup(),
287 static void netconsole_process_cleanups(void)
289 /* rtnl lock is called here, because it has precedence over
290 * target_cleanup_list_lock mutex and target_cleanup_list
293 netconsole_process_cleanups_core();
297 /* Get rid of possible trailing newline, returning the new length */
298 static void trim_newline(char *s, size_t maxlen)
302 len = strnlen(s, maxlen);
303 if (s[len - 1] == '\n')
308 * Attribute operations for netconsole_target.
311 static ssize_t enabled_show(struct config_item *item, char *buf)
313 return sysfs_emit(buf, "%d\n", to_target(item)->enabled);
316 static ssize_t extended_show(struct config_item *item, char *buf)
318 return sysfs_emit(buf, "%d\n", to_target(item)->extended);
321 static ssize_t release_show(struct config_item *item, char *buf)
323 return sysfs_emit(buf, "%d\n", to_target(item)->release);
326 static ssize_t dev_name_show(struct config_item *item, char *buf)
328 return sysfs_emit(buf, "%s\n", to_target(item)->np.dev_name);
331 static ssize_t local_port_show(struct config_item *item, char *buf)
333 return sysfs_emit(buf, "%d\n", to_target(item)->np.local_port);
336 static ssize_t remote_port_show(struct config_item *item, char *buf)
338 return sysfs_emit(buf, "%d\n", to_target(item)->np.remote_port);
341 static ssize_t local_ip_show(struct config_item *item, char *buf)
343 struct netconsole_target *nt = to_target(item);
346 return sysfs_emit(buf, "%pI6c\n", &nt->np.local_ip.in6);
348 return sysfs_emit(buf, "%pI4\n", &nt->np.local_ip);
351 static ssize_t remote_ip_show(struct config_item *item, char *buf)
353 struct netconsole_target *nt = to_target(item);
356 return sysfs_emit(buf, "%pI6c\n", &nt->np.remote_ip.in6);
358 return sysfs_emit(buf, "%pI4\n", &nt->np.remote_ip);
361 static ssize_t local_mac_show(struct config_item *item, char *buf)
363 struct net_device *dev = to_target(item)->np.dev;
364 static const u8 bcast[ETH_ALEN] = { 0xff, 0xff, 0xff, 0xff, 0xff, 0xff };
366 return sysfs_emit(buf, "%pM\n", dev ? dev->dev_addr : bcast);
369 static ssize_t remote_mac_show(struct config_item *item, char *buf)
371 return sysfs_emit(buf, "%pM\n", to_target(item)->np.remote_mac);
375 * This one is special -- targets created through the configfs interface
376 * are not enabled (and the corresponding netpoll activated) by default.
377 * The user is expected to set the desired parameters first (which
378 * would enable him to dynamically add new netpoll targets for new
379 * network interfaces as and when they come up).
381 static ssize_t enabled_store(struct config_item *item,
382 const char *buf, size_t count)
384 struct netconsole_target *nt = to_target(item);
389 mutex_lock(&dynamic_netconsole_mutex);
390 ret = kstrtobool(buf, &enabled);
395 if (enabled == nt->enabled) {
396 pr_info("network logging has already %s\n",
397 nt->enabled ? "started" : "stopped");
401 if (enabled) { /* true */
402 if (nt->release && !nt->extended) {
403 pr_err("Not enabling netconsole. Release feature requires extended log message");
407 if (nt->extended && !console_is_registered(&netconsole_ext))
408 register_console(&netconsole_ext);
411 * Skip netpoll_parse_options() -- all the attributes are
412 * already configured via configfs. Just print them out.
414 netpoll_print_options(&nt->np);
416 ret = netpoll_setup(&nt->np);
421 pr_info("network logging started\n");
423 /* We need to disable the netconsole before cleaning it up
424 * otherwise we might end up in write_msg() with
425 * nt->np.dev == NULL and nt->enabled == true
427 mutex_lock(&target_cleanup_list_lock);
428 spin_lock_irqsave(&target_list_lock, flags);
430 /* Remove the target from the list, while holding
433 list_move(&nt->list, &target_cleanup_list);
434 spin_unlock_irqrestore(&target_list_lock, flags);
435 mutex_unlock(&target_cleanup_list_lock);
438 ret = strnlen(buf, count);
439 /* Deferred cleanup */
440 netconsole_process_cleanups();
442 mutex_unlock(&dynamic_netconsole_mutex);
446 static ssize_t release_store(struct config_item *item, const char *buf,
449 struct netconsole_target *nt = to_target(item);
453 mutex_lock(&dynamic_netconsole_mutex);
455 pr_err("target (%s) is enabled, disable to update parameters\n",
456 config_item_name(&nt->group.cg_item));
461 ret = kstrtobool(buf, &release);
465 nt->release = release;
467 ret = strnlen(buf, count);
469 mutex_unlock(&dynamic_netconsole_mutex);
473 static ssize_t extended_store(struct config_item *item, const char *buf,
476 struct netconsole_target *nt = to_target(item);
480 mutex_lock(&dynamic_netconsole_mutex);
482 pr_err("target (%s) is enabled, disable to update parameters\n",
483 config_item_name(&nt->group.cg_item));
488 ret = kstrtobool(buf, &extended);
492 nt->extended = extended;
493 ret = strnlen(buf, count);
495 mutex_unlock(&dynamic_netconsole_mutex);
499 static ssize_t dev_name_store(struct config_item *item, const char *buf,
502 struct netconsole_target *nt = to_target(item);
504 mutex_lock(&dynamic_netconsole_mutex);
506 pr_err("target (%s) is enabled, disable to update parameters\n",
507 config_item_name(&nt->group.cg_item));
508 mutex_unlock(&dynamic_netconsole_mutex);
512 strscpy(nt->np.dev_name, buf, IFNAMSIZ);
513 trim_newline(nt->np.dev_name, IFNAMSIZ);
515 mutex_unlock(&dynamic_netconsole_mutex);
516 return strnlen(buf, count);
519 static ssize_t local_port_store(struct config_item *item, const char *buf,
522 struct netconsole_target *nt = to_target(item);
523 ssize_t ret = -EINVAL;
525 mutex_lock(&dynamic_netconsole_mutex);
527 pr_err("target (%s) is enabled, disable to update parameters\n",
528 config_item_name(&nt->group.cg_item));
532 ret = kstrtou16(buf, 10, &nt->np.local_port);
535 ret = strnlen(buf, count);
537 mutex_unlock(&dynamic_netconsole_mutex);
541 static ssize_t remote_port_store(struct config_item *item,
542 const char *buf, size_t count)
544 struct netconsole_target *nt = to_target(item);
545 ssize_t ret = -EINVAL;
547 mutex_lock(&dynamic_netconsole_mutex);
549 pr_err("target (%s) is enabled, disable to update parameters\n",
550 config_item_name(&nt->group.cg_item));
554 ret = kstrtou16(buf, 10, &nt->np.remote_port);
557 ret = strnlen(buf, count);
559 mutex_unlock(&dynamic_netconsole_mutex);
563 static ssize_t local_ip_store(struct config_item *item, const char *buf,
566 struct netconsole_target *nt = to_target(item);
567 ssize_t ret = -EINVAL;
569 mutex_lock(&dynamic_netconsole_mutex);
571 pr_err("target (%s) is enabled, disable to update parameters\n",
572 config_item_name(&nt->group.cg_item));
576 if (strnchr(buf, count, ':')) {
579 if (in6_pton(buf, count, nt->np.local_ip.in6.s6_addr, -1, &end) > 0) {
580 if (*end && *end != '\n') {
581 pr_err("invalid IPv6 address at: <%c>\n", *end);
589 nt->np.local_ip.ip = in_aton(buf);
594 ret = strnlen(buf, count);
596 mutex_unlock(&dynamic_netconsole_mutex);
600 static ssize_t remote_ip_store(struct config_item *item, const char *buf,
603 struct netconsole_target *nt = to_target(item);
604 ssize_t ret = -EINVAL;
606 mutex_lock(&dynamic_netconsole_mutex);
608 pr_err("target (%s) is enabled, disable to update parameters\n",
609 config_item_name(&nt->group.cg_item));
613 if (strnchr(buf, count, ':')) {
616 if (in6_pton(buf, count, nt->np.remote_ip.in6.s6_addr, -1, &end) > 0) {
617 if (*end && *end != '\n') {
618 pr_err("invalid IPv6 address at: <%c>\n", *end);
626 nt->np.remote_ip.ip = in_aton(buf);
631 ret = strnlen(buf, count);
633 mutex_unlock(&dynamic_netconsole_mutex);
637 static ssize_t remote_mac_store(struct config_item *item, const char *buf,
640 struct netconsole_target *nt = to_target(item);
641 u8 remote_mac[ETH_ALEN];
642 ssize_t ret = -EINVAL;
644 mutex_lock(&dynamic_netconsole_mutex);
646 pr_err("target (%s) is enabled, disable to update parameters\n",
647 config_item_name(&nt->group.cg_item));
651 if (!mac_pton(buf, remote_mac))
653 if (buf[3 * ETH_ALEN - 1] && buf[3 * ETH_ALEN - 1] != '\n')
655 memcpy(nt->np.remote_mac, remote_mac, ETH_ALEN);
657 ret = strnlen(buf, count);
659 mutex_unlock(&dynamic_netconsole_mutex);
664 struct config_item item;
665 char value[MAX_USERDATA_VALUE_LENGTH];
668 static struct userdatum *to_userdatum(struct config_item *item)
670 return container_of(item, struct userdatum, item);
674 struct config_group group;
677 static struct userdata *to_userdata(struct config_item *item)
679 return container_of(to_config_group(item), struct userdata, group);
682 static struct netconsole_target *userdata_to_target(struct userdata *ud)
684 struct config_group *netconsole_group;
686 netconsole_group = to_config_group(ud->group.cg_item.ci_parent);
687 return to_target(&netconsole_group->cg_item);
690 static ssize_t userdatum_value_show(struct config_item *item, char *buf)
692 return sysfs_emit(buf, "%s\n", &(to_userdatum(item)->value[0]));
695 static void update_userdata(struct netconsole_target *nt)
697 int complete_idx = 0, child_count = 0;
698 struct list_head *entry;
700 /* Clear the current string in case the last userdatum was deleted */
701 nt->userdata_length = 0;
702 nt->userdata_complete[0] = 0;
704 list_for_each(entry, &nt->userdata_group.cg_children) {
705 struct userdatum *udm_item;
706 struct config_item *item;
708 if (child_count >= MAX_USERDATA_ITEMS)
712 item = container_of(entry, struct config_item, ci_entry);
713 udm_item = to_userdatum(item);
715 /* Skip userdata with no value set */
716 if (strnlen(udm_item->value, MAX_USERDATA_VALUE_LENGTH) == 0)
719 /* This doesn't overflow userdata_complete since it will write
720 * one entry length (1/MAX_USERDATA_ITEMS long), entry count is
721 * checked to not exceed MAX items with child_count above
723 complete_idx += scnprintf(&nt->userdata_complete[complete_idx],
724 MAX_USERDATA_ENTRY_LENGTH, " %s=%s\n",
725 item->ci_name, udm_item->value);
727 nt->userdata_length = strnlen(nt->userdata_complete,
728 sizeof(nt->userdata_complete));
731 static ssize_t userdatum_value_store(struct config_item *item, const char *buf,
734 struct userdatum *udm = to_userdatum(item);
735 struct netconsole_target *nt;
739 if (count > MAX_USERDATA_VALUE_LENGTH)
742 mutex_lock(&dynamic_netconsole_mutex);
744 ret = strscpy(udm->value, buf, sizeof(udm->value));
747 trim_newline(udm->value, sizeof(udm->value));
749 ud = to_userdata(item->ci_parent);
750 nt = userdata_to_target(ud);
754 mutex_unlock(&dynamic_netconsole_mutex);
758 CONFIGFS_ATTR(userdatum_, value);
760 static struct configfs_attribute *userdatum_attrs[] = {
761 &userdatum_attr_value,
765 static void userdatum_release(struct config_item *item)
767 kfree(to_userdatum(item));
770 static struct configfs_item_operations userdatum_ops = {
771 .release = userdatum_release,
774 static const struct config_item_type userdatum_type = {
775 .ct_item_ops = &userdatum_ops,
776 .ct_attrs = userdatum_attrs,
777 .ct_owner = THIS_MODULE,
780 static struct config_item *userdatum_make_item(struct config_group *group,
783 struct netconsole_target *nt;
784 struct userdatum *udm;
788 if (strlen(name) > MAX_USERDATA_NAME_LENGTH)
789 return ERR_PTR(-ENAMETOOLONG);
791 ud = to_userdata(&group->cg_item);
792 nt = userdata_to_target(ud);
793 child_count = list_count_nodes(&nt->userdata_group.cg_children);
794 if (child_count >= MAX_USERDATA_ITEMS)
795 return ERR_PTR(-ENOSPC);
797 udm = kzalloc(sizeof(*udm), GFP_KERNEL);
799 return ERR_PTR(-ENOMEM);
801 config_item_init_type_name(&udm->item, name, &userdatum_type);
805 static void userdatum_drop(struct config_group *group, struct config_item *item)
807 struct netconsole_target *nt;
810 ud = to_userdata(&group->cg_item);
811 nt = userdata_to_target(ud);
813 mutex_lock(&dynamic_netconsole_mutex);
815 config_item_put(item);
816 mutex_unlock(&dynamic_netconsole_mutex);
819 static struct configfs_attribute *userdata_attrs[] = {
823 static struct configfs_group_operations userdata_ops = {
824 .make_item = userdatum_make_item,
825 .drop_item = userdatum_drop,
828 static const struct config_item_type userdata_type = {
829 .ct_item_ops = &userdatum_ops,
830 .ct_group_ops = &userdata_ops,
831 .ct_attrs = userdata_attrs,
832 .ct_owner = THIS_MODULE,
835 CONFIGFS_ATTR(, enabled);
836 CONFIGFS_ATTR(, extended);
837 CONFIGFS_ATTR(, dev_name);
838 CONFIGFS_ATTR(, local_port);
839 CONFIGFS_ATTR(, remote_port);
840 CONFIGFS_ATTR(, local_ip);
841 CONFIGFS_ATTR(, remote_ip);
842 CONFIGFS_ATTR_RO(, local_mac);
843 CONFIGFS_ATTR(, remote_mac);
844 CONFIGFS_ATTR(, release);
846 static struct configfs_attribute *netconsole_target_attrs[] = {
861 * Item operations and type for netconsole_target.
864 static void netconsole_target_release(struct config_item *item)
866 kfree(to_target(item));
869 static struct configfs_item_operations netconsole_target_item_ops = {
870 .release = netconsole_target_release,
873 static const struct config_item_type netconsole_target_type = {
874 .ct_attrs = netconsole_target_attrs,
875 .ct_item_ops = &netconsole_target_item_ops,
876 .ct_owner = THIS_MODULE,
879 static void init_target_config_group(struct netconsole_target *nt,
882 config_group_init_type_name(&nt->group, name, &netconsole_target_type);
883 config_group_init_type_name(&nt->userdata_group, "userdata",
885 configfs_add_default_group(&nt->userdata_group, &nt->group);
888 static struct netconsole_target *find_cmdline_target(const char *name)
890 struct netconsole_target *nt, *ret = NULL;
893 spin_lock_irqsave(&target_list_lock, flags);
894 list_for_each_entry(nt, &target_list, list) {
895 if (!strcmp(nt->group.cg_item.ci_name, name)) {
900 spin_unlock_irqrestore(&target_list_lock, flags);
906 * Group operations and type for netconsole_subsys.
909 static struct config_group *make_netconsole_target(struct config_group *group,
912 struct netconsole_target *nt;
915 /* Checking if a target by this name was created at boot time. If so,
916 * attach a configfs entry to that target. This enables dynamic
919 if (!strncmp(name, NETCONSOLE_PARAM_TARGET_PREFIX,
920 strlen(NETCONSOLE_PARAM_TARGET_PREFIX))) {
921 nt = find_cmdline_target(name);
923 init_target_config_group(nt, name);
928 nt = alloc_and_init();
930 return ERR_PTR(-ENOMEM);
932 /* Initialize the config_group member */
933 init_target_config_group(nt, name);
935 /* Adding, but it is disabled */
936 spin_lock_irqsave(&target_list_lock, flags);
937 list_add(&nt->list, &target_list);
938 spin_unlock_irqrestore(&target_list_lock, flags);
943 static void drop_netconsole_target(struct config_group *group,
944 struct config_item *item)
947 struct netconsole_target *nt = to_target(item);
949 spin_lock_irqsave(&target_list_lock, flags);
951 spin_unlock_irqrestore(&target_list_lock, flags);
954 * The target may have never been enabled, or was manually disabled
955 * before being removed so netpoll may have already been cleaned up.
958 netpoll_cleanup(&nt->np);
960 config_item_put(&nt->group.cg_item);
963 static struct configfs_group_operations netconsole_subsys_group_ops = {
964 .make_group = make_netconsole_target,
965 .drop_item = drop_netconsole_target,
968 static const struct config_item_type netconsole_subsys_type = {
969 .ct_group_ops = &netconsole_subsys_group_ops,
970 .ct_owner = THIS_MODULE,
973 /* The netconsole configfs subsystem */
974 static struct configfs_subsystem netconsole_subsys = {
977 .ci_namebuf = "netconsole",
978 .ci_type = &netconsole_subsys_type,
983 static void populate_configfs_item(struct netconsole_target *nt,
986 char target_name[16];
988 snprintf(target_name, sizeof(target_name), "%s%d",
989 NETCONSOLE_PARAM_TARGET_PREFIX, cmdline_count);
990 init_target_config_group(nt, target_name);
993 #endif /* CONFIG_NETCONSOLE_DYNAMIC */
995 /* Handle network interface device notifications */
996 static int netconsole_netdev_event(struct notifier_block *this,
997 unsigned long event, void *ptr)
1000 struct netconsole_target *nt, *tmp;
1001 struct net_device *dev = netdev_notifier_info_to_dev(ptr);
1002 bool stopped = false;
1004 if (!(event == NETDEV_CHANGENAME || event == NETDEV_UNREGISTER ||
1005 event == NETDEV_RELEASE || event == NETDEV_JOIN))
1008 mutex_lock(&target_cleanup_list_lock);
1009 spin_lock_irqsave(&target_list_lock, flags);
1010 list_for_each_entry_safe(nt, tmp, &target_list, list) {
1011 netconsole_target_get(nt);
1012 if (nt->np.dev == dev) {
1014 case NETDEV_CHANGENAME:
1015 strscpy(nt->np.dev_name, dev->name, IFNAMSIZ);
1017 case NETDEV_RELEASE:
1019 case NETDEV_UNREGISTER:
1020 nt->enabled = false;
1021 list_move(&nt->list, &target_cleanup_list);
1025 netconsole_target_put(nt);
1027 spin_unlock_irqrestore(&target_list_lock, flags);
1028 mutex_unlock(&target_cleanup_list_lock);
1031 const char *msg = "had an event";
1034 case NETDEV_UNREGISTER:
1035 msg = "unregistered";
1037 case NETDEV_RELEASE:
1038 msg = "released slaves";
1041 msg = "is joining a master device";
1044 pr_info("network logging stopped on interface %s as it %s\n",
1048 /* Process target_cleanup_list entries. By the end, target_cleanup_list
1051 netconsole_process_cleanups_core();
1057 static struct notifier_block netconsole_netdev_notifier = {
1058 .notifier_call = netconsole_netdev_event,
1061 static void send_msg_no_fragmentation(struct netconsole_target *nt,
1066 static char buf[MAX_PRINT_CHUNK]; /* protected by target_list_lock */
1067 const char *userdata = NULL;
1068 const char *release;
1070 #ifdef CONFIG_NETCONSOLE_DYNAMIC
1071 userdata = nt->userdata_complete;
1075 release = init_utsname()->release;
1077 scnprintf(buf, MAX_PRINT_CHUNK, "%s,%s", release, msg);
1078 msg_len += release_len;
1080 memcpy(buf, msg, msg_len);
1084 msg_len += scnprintf(&buf[msg_len],
1085 MAX_PRINT_CHUNK - msg_len,
1088 netpoll_send_udp(&nt->np, buf, msg_len);
1091 static void append_release(char *buf)
1093 const char *release;
1095 release = init_utsname()->release;
1096 scnprintf(buf, MAX_PRINT_CHUNK, "%s,", release);
1099 static void send_fragmented_body(struct netconsole_target *nt, char *buf,
1100 const char *msgbody, int header_len,
1103 const char *userdata = NULL;
1104 int body_len, offset = 0;
1105 int userdata_len = 0;
1107 #ifdef CONFIG_NETCONSOLE_DYNAMIC
1108 userdata = nt->userdata_complete;
1109 userdata_len = nt->userdata_length;
1112 /* body_len represents the number of bytes that will be sent. This is
1113 * bigger than MAX_PRINT_CHUNK, thus, it will be split in multiple
1116 body_len = msgbody_len + userdata_len;
1118 /* In each iteration of the while loop below, we send a packet
1119 * containing the header and a portion of the body. The body is
1120 * composed of two parts: msgbody and userdata. We keep track of how
1121 * many bytes have been sent so far using the offset variable, which
1122 * ranges from 0 to the total length of the body.
1124 while (offset < body_len) {
1125 int this_header = header_len;
1126 bool msgbody_written = false;
1127 int this_offset = 0;
1130 this_header += scnprintf(buf + this_header,
1131 MAX_PRINT_CHUNK - this_header,
1132 ",ncfrag=%d/%d;", offset,
1135 /* Not all msgbody data has been written yet */
1136 if (offset < msgbody_len) {
1137 this_chunk = min(msgbody_len - offset,
1138 MAX_PRINT_CHUNK - this_header);
1139 if (WARN_ON_ONCE(this_chunk <= 0))
1141 memcpy(buf + this_header, msgbody + offset, this_chunk);
1142 this_offset += this_chunk;
1145 /* msgbody was finally written, either in the previous
1146 * messages and/or in the current buf. Time to write
1149 msgbody_written |= offset + this_offset >= msgbody_len;
1151 /* Msg body is fully written and there is pending userdata to
1152 * write, append userdata in this chunk
1154 if (msgbody_written && offset + this_offset < body_len) {
1155 /* Track how much user data was already sent. First
1156 * time here, sent_userdata is zero
1158 int sent_userdata = (offset + this_offset) - msgbody_len;
1159 /* offset of bytes used in current buf */
1160 int preceding_bytes = this_chunk + this_header;
1162 if (WARN_ON_ONCE(sent_userdata < 0))
1165 this_chunk = min(userdata_len - sent_userdata,
1166 MAX_PRINT_CHUNK - preceding_bytes);
1167 if (WARN_ON_ONCE(this_chunk < 0))
1168 /* this_chunk could be zero if all the previous
1169 * message used all the buffer. This is not a
1170 * problem, userdata will be sent in the next
1175 memcpy(buf + this_header + this_offset,
1176 userdata + sent_userdata,
1178 this_offset += this_chunk;
1181 netpoll_send_udp(&nt->np, buf, this_header + this_offset);
1182 offset += this_offset;
1186 static void send_msg_fragmented(struct netconsole_target *nt,
1191 static char buf[MAX_PRINT_CHUNK]; /* protected by target_list_lock */
1192 int header_len, msgbody_len;
1193 const char *msgbody;
1195 /* need to insert extra header fields, detect header and msgbody */
1196 msgbody = memchr(msg, ';', msg_len);
1197 if (WARN_ON_ONCE(!msgbody))
1200 header_len = msgbody - msg;
1201 msgbody_len = msg_len - header_len - 1;
1205 * Transfer multiple chunks with the following extra header.
1206 * "ncfrag=<byte-offset>/<total-bytes>"
1209 append_release(buf);
1211 /* Copy the header into the buffer */
1212 memcpy(buf + release_len, msg, header_len);
1213 header_len += release_len;
1215 /* for now on, the header will be persisted, and the msgbody
1218 send_fragmented_body(nt, buf, msgbody, header_len, msgbody_len);
1222 * send_ext_msg_udp - send extended log message to target
1223 * @nt: target to send message to
1224 * @msg: extended log message to send
1225 * @msg_len: length of message
1227 * Transfer extended log @msg to @nt. If @msg is longer than
1228 * MAX_PRINT_CHUNK, it'll be split and transmitted in multiple chunks with
1229 * ncfrag header field added to identify them.
1231 static void send_ext_msg_udp(struct netconsole_target *nt, const char *msg,
1234 int userdata_len = 0;
1235 int release_len = 0;
1237 #ifdef CONFIG_NETCONSOLE_DYNAMIC
1238 userdata_len = nt->userdata_length;
1242 release_len = strlen(init_utsname()->release) + 1;
1244 if (msg_len + release_len + userdata_len <= MAX_PRINT_CHUNK)
1245 return send_msg_no_fragmentation(nt, msg, msg_len, release_len);
1247 return send_msg_fragmented(nt, msg, msg_len, release_len);
1250 static void write_ext_msg(struct console *con, const char *msg,
1253 struct netconsole_target *nt;
1254 unsigned long flags;
1256 if ((oops_only && !oops_in_progress) || list_empty(&target_list))
1259 spin_lock_irqsave(&target_list_lock, flags);
1260 list_for_each_entry(nt, &target_list, list)
1261 if (nt->extended && nt->enabled && netif_running(nt->np.dev))
1262 send_ext_msg_udp(nt, msg, len);
1263 spin_unlock_irqrestore(&target_list_lock, flags);
1266 static void write_msg(struct console *con, const char *msg, unsigned int len)
1269 unsigned long flags;
1270 struct netconsole_target *nt;
1273 if (oops_only && !oops_in_progress)
1275 /* Avoid taking lock and disabling interrupts unnecessarily */
1276 if (list_empty(&target_list))
1279 spin_lock_irqsave(&target_list_lock, flags);
1280 list_for_each_entry(nt, &target_list, list) {
1281 if (!nt->extended && nt->enabled && netif_running(nt->np.dev)) {
1283 * We nest this inside the for-each-target loop above
1284 * so that we're able to get as much logging out to
1285 * at least one target if we die inside here, instead
1286 * of unnecessarily keeping all targets in lock-step.
1289 for (left = len; left;) {
1290 frag = min(left, MAX_PRINT_CHUNK);
1291 netpoll_send_udp(&nt->np, tmp, frag);
1297 spin_unlock_irqrestore(&target_list_lock, flags);
1300 /* Allocate new target (from boot/module param) and setup netpoll for it */
1301 static struct netconsole_target *alloc_param_target(char *target_config,
1304 struct netconsole_target *nt;
1307 nt = alloc_and_init();
1313 if (*target_config == '+') {
1314 nt->extended = true;
1318 if (*target_config == 'r') {
1319 if (!nt->extended) {
1320 pr_err("Netconsole configuration error. Release feature requires extended log message");
1328 /* Parse parameters and setup netpoll */
1329 err = netpoll_parse_options(&nt->np, target_config);
1333 err = netpoll_setup(&nt->np);
1335 pr_err("Not enabling netconsole for %s%d. Netpoll setup failed\n",
1336 NETCONSOLE_PARAM_TARGET_PREFIX, cmdline_count);
1337 if (!IS_ENABLED(CONFIG_NETCONSOLE_DYNAMIC))
1338 /* only fail if dynamic reconfiguration is set,
1339 * otherwise, keep the target in the list, but disabled.
1345 populate_configfs_item(nt, cmdline_count);
1351 return ERR_PTR(err);
1354 /* Cleanup netpoll for given target (from boot/module param) and free it */
1355 static void free_param_target(struct netconsole_target *nt)
1357 netpoll_cleanup(&nt->np);
1361 static struct console netconsole_ext = {
1362 .name = "netcon_ext",
1363 .flags = CON_ENABLED | CON_EXTENDED,
1364 .write = write_ext_msg,
1367 static struct console netconsole = {
1369 .flags = CON_ENABLED,
1373 static int __init init_netconsole(void)
1376 struct netconsole_target *nt, *tmp;
1377 unsigned int count = 0;
1378 bool extended = false;
1379 unsigned long flags;
1380 char *target_config;
1381 char *input = config;
1383 if (strnlen(input, MAX_PARAM_LENGTH)) {
1384 while ((target_config = strsep(&input, ";"))) {
1385 nt = alloc_param_target(target_config, count);
1387 if (IS_ENABLED(CONFIG_NETCONSOLE_DYNAMIC))
1392 /* Dump existing printks when we register */
1395 netconsole_ext.flags |= CON_PRINTBUFFER;
1397 netconsole.flags |= CON_PRINTBUFFER;
1400 spin_lock_irqsave(&target_list_lock, flags);
1401 list_add(&nt->list, &target_list);
1402 spin_unlock_irqrestore(&target_list_lock, flags);
1407 err = register_netdevice_notifier(&netconsole_netdev_notifier);
1411 err = dynamic_netconsole_init();
1416 register_console(&netconsole_ext);
1417 register_console(&netconsole);
1418 pr_info("network logging started\n");
1423 unregister_netdevice_notifier(&netconsole_netdev_notifier);
1426 pr_err("cleaning up\n");
1429 * Remove all targets and destroy them (only targets created
1430 * from the boot/module option exist here). Skipping the list
1431 * lock is safe here, and netpoll_cleanup() will sleep.
1433 list_for_each_entry_safe(nt, tmp, &target_list, list) {
1434 list_del(&nt->list);
1435 free_param_target(nt);
1441 static void __exit cleanup_netconsole(void)
1443 struct netconsole_target *nt, *tmp;
1445 if (console_is_registered(&netconsole_ext))
1446 unregister_console(&netconsole_ext);
1447 unregister_console(&netconsole);
1448 dynamic_netconsole_exit();
1449 unregister_netdevice_notifier(&netconsole_netdev_notifier);
1452 * Targets created via configfs pin references on our module
1453 * and would first be rmdir(2)'ed from userspace. We reach
1454 * here only when they are already destroyed, and only those
1455 * created from the boot/module option are left, so remove and
1456 * destroy them. Skipping the list lock is safe here, and
1457 * netpoll_cleanup() will sleep.
1459 list_for_each_entry_safe(nt, tmp, &target_list, list) {
1460 list_del(&nt->list);
1461 free_param_target(nt);
1466 * Use late_initcall to ensure netconsole is
1467 * initialized after network device driver if built-in.
1469 * late_initcall() and module_init() are identical if built as module.
1471 late_initcall(init_netconsole);
1472 module_exit(cleanup_netconsole);