29132483780

Committed 10 Jul 2026 08:43PM UTC coverage: 72.912% (+0.2%) from 72.702%

Build # 29132483780

Build Type

push

github

Committed by

bluca

Commit Message

man: run forgotten 'update-man-rules'

Coverage Stats

344600 of 472622 relevant lines covered (72.91%)

1365091.83 hits per line

Source File
Press 'n' to go to next uncovered line, 'b' for previous

68.66

/src/shared/module-util.c

/* SPDX-License-Identifier: LGPL-2.1-or-later */

#include <syslog.h>

#include "log.h"
#include "module-util.h"
#include "proc-cmdline.h"
#include "strv.h"

#if HAVE_KMOD

DLSYM_PROTOTYPE(kmod_list_next) = NULL;
DLSYM_PROTOTYPE(kmod_load_resources) = NULL;
DLSYM_PROTOTYPE(kmod_module_get_initstate) = NULL;
DLSYM_PROTOTYPE(kmod_module_get_module) = NULL;
DLSYM_PROTOTYPE(kmod_module_get_name) = NULL;
DLSYM_PROTOTYPE(kmod_module_new_from_lookup) = NULL;
DLSYM_PROTOTYPE(kmod_module_probe_insert_module) = NULL;
DLSYM_PROTOTYPE(kmod_module_unref) = NULL;
DLSYM_PROTOTYPE(kmod_module_unref_list) = NULL;
DLSYM_PROTOTYPE(kmod_new) = NULL;
DLSYM_PROTOTYPE(kmod_set_log_fn) = NULL;
DLSYM_PROTOTYPE(kmod_unref) = NULL;
DLSYM_PROTOTYPE(kmod_validate_resources) = NULL;

static int parse_proc_cmdline_item(const char *key, const char *value, void *data) {
        char ***denylist = ASSERT_PTR(data);
        int r;

        if (proc_cmdline_key_streq(key, "module_blacklist")) {

                if (proc_cmdline_value_missing(key, value))
                        return 0;

                r = strv_split_and_extend(denylist, value, ",", /* filter_duplicates= */ true);
                if (r < 0)
                        return r;
        }

        return 0;
}

int module_load_and_warn(struct kmod_ctx *ctx, const char *module, bool verbose) {
        _cleanup_(kmod_module_unref_listp) struct kmod_list *modlist = NULL;
        _cleanup_strv_free_ char **denylist = NULL;
        bool denylist_parsed = false;
        struct kmod_list *itr;
        int r;

        assert(ctx);
        assert(module);

        /* verbose==true means we should log at non-debug level if we
         * fail to find or load the module. */

        log_debug("Loading module: %s", module);

        r = sym_kmod_module_new_from_lookup(ctx, module, &modlist);
        if (r < 0)
                return log_full_errno(verbose ? LOG_ERR : LOG_DEBUG, r,
                                      "Failed to look up module alias '%s': %m", module);

        if (!modlist)
                return log_full_errno(verbose ? LOG_ERR : LOG_DEBUG,
                                      SYNTHETIC_ERRNO(ENOENT),
                                      "Failed to find module '%s'", module);

        sym_kmod_list_foreach(itr, modlist) {
                _cleanup_(kmod_module_unrefp) struct kmod_module *mod = NULL;
                int state, err;

                mod = sym_kmod_module_get_module(itr);
                state = sym_kmod_module_get_initstate(mod);

                switch (state) {
                case KMOD_MODULE_BUILTIN:
                        log_full(verbose ? LOG_INFO : LOG_DEBUG,
                                 "Module '%s' is built in", sym_kmod_module_get_name(mod));
                        break;

                case KMOD_MODULE_LIVE:
                        log_debug("Module '%s' is already loaded", sym_kmod_module_get_name(mod));
                        break;

                default:
                        err = sym_kmod_module_probe_insert_module(
                                        mod,
                                        KMOD_PROBE_APPLY_BLACKLIST,
                                        /* extra_options= */ NULL,
                                        /* run_install= */ NULL,
                                        /* data= */ NULL,
                                        /* print_action= */ NULL);
                        if (err == 0)
                                log_full(verbose ? LOG_INFO : LOG_DEBUG,
                                         "Inserted module '%s'", sym_kmod_module_get_name(mod));
                        else if (err == KMOD_PROBE_APPLY_BLACKLIST)
                                log_full(verbose ? LOG_INFO : LOG_DEBUG,
                                         "Module '%s' is deny-listed (by kmod)", sym_kmod_module_get_name(mod));
                        else {
                                assert(err < 0);

                                if (err == -EPERM) {
                                        if (!denylist_parsed) {
                                                r = proc_cmdline_parse(parse_proc_cmdline_item, &denylist, 0);
                                                if (r < 0)
                                                        log_full_errno(!verbose ? LOG_DEBUG : LOG_WARNING,
                                                                       r,
                                                                       "Failed to parse kernel command line, ignoring: %m");

                                                denylist_parsed = true;
                                        }
                                        if (strv_contains(denylist, sym_kmod_module_get_name(mod))) {
                                                log_full(verbose ? LOG_INFO : LOG_DEBUG,
                                                         "Module '%s' is deny-listed (by kernel)", sym_kmod_module_get_name(mod));
                                                continue;
                                        }
                                }

                                log_full_errno(!verbose ? LOG_DEBUG :
                                               err == -ENODEV ? LOG_NOTICE :
                                               err == -ENOENT ? LOG_WARNING :
                                                                LOG_ERR,
                                               err,
                                               "Failed to insert module '%s': %m",
                                               sym_kmod_module_get_name(mod));
                                if (!IN_SET(err, -ENODEV, -ENOENT))
                                        r = err;
                        }
                }
        }

        return r;
}

_printf_(6,0) static void systemd_kmod_log(
                void *data,
                int priority,
                const char *file,
                int line,
                const char *fn,
                const char *format,
                va_list args) {

        log_internalv(priority, 0, file, line, fn, format, args);
}

int module_setup_context(struct kmod_ctx **ret) {
        _cleanup_(kmod_unrefp) struct kmod_ctx *ctx = NULL;
        int r;

        assert(ret);

        r = dlopen_libkmod(LOG_DEBUG);
        if (r < 0)
                return r;

        ctx = sym_kmod_new(NULL, NULL);
        if (!ctx)
                return -ENOMEM;

        (void) sym_kmod_load_resources(ctx);
        sym_kmod_set_log_fn(ctx, systemd_kmod_log, NULL);

        *ret = TAKE_PTR(ctx);
        return 0;
}

#endif

int dlopen_libkmod(int log_level) {
#if HAVE_KMOD
        static void *libkmod_dl = NULL;

        LIBKMOD_NOTE(recommended);

        return dlopen_many_sym_or_warn(
                        &libkmod_dl,
                        "libkmod.so.2",
                        log_level,
                        DLSYM_ARG(kmod_list_next),
                        DLSYM_ARG(kmod_load_resources),
                        DLSYM_ARG(kmod_module_get_initstate),
                        DLSYM_ARG(kmod_module_get_module),
                        DLSYM_ARG(kmod_module_get_name),
                        DLSYM_ARG(kmod_module_new_from_lookup),
                        DLSYM_ARG(kmod_module_probe_insert_module),
                        DLSYM_ARG(kmod_module_unref),
                        DLSYM_ARG(kmod_module_unref_list),
                        DLSYM_ARG(kmod_new),
                        DLSYM_ARG(kmod_set_log_fn),
                        DLSYM_ARG(kmod_unref),
                        DLSYM_ARG(kmod_validate_resources));
#else
        return log_full_errno(log_level, SYNTHETIC_ERRNO(EOPNOTSUPP),
                              "libkmod support is not compiled in.");
#endif
}

1	/* SPDX-License-Identifier: LGPL-2.1-or-later */
2
3	#include <syslog.h>
4
5	#include "log.h"
6	#include "module-util.h"
7	#include "proc-cmdline.h"
8	#include "strv.h"
9
10	#if HAVE_KMOD
11
12	DLSYM_PROTOTYPE(kmod_list_next) = NULL;
13	DLSYM_PROTOTYPE(kmod_load_resources) = NULL;
14	DLSYM_PROTOTYPE(kmod_module_get_initstate) = NULL;
15	DLSYM_PROTOTYPE(kmod_module_get_module) = NULL;
16	DLSYM_PROTOTYPE(kmod_module_get_name) = NULL;
17	DLSYM_PROTOTYPE(kmod_module_new_from_lookup) = NULL;
18	DLSYM_PROTOTYPE(kmod_module_probe_insert_module) = NULL;
19	DLSYM_PROTOTYPE(kmod_module_unref) = NULL;
20	DLSYM_PROTOTYPE(kmod_module_unref_list) = NULL;
21	DLSYM_PROTOTYPE(kmod_new) = NULL;
22	DLSYM_PROTOTYPE(kmod_set_log_fn) = NULL;
23	DLSYM_PROTOTYPE(kmod_unref) = NULL;
24	DLSYM_PROTOTYPE(kmod_validate_resources) = NULL;
25
26	static int parse_proc_cmdline_item(const char key, const char value, void *data) {	×
27	char ***denylist = ASSERT_PTR(data);	×
28	int r;	×
29
30	if (proc_cmdline_key_streq(key, "module_blacklist")) {	×
31
32	if (proc_cmdline_value_missing(key, value))	×
33	return 0;
34
35	r = strv_split_and_extend(denylist, value, ",", /* filter_duplicates= */ true);	×
36	if (r < 0)	×
37	return r;	×
38	}
39
40	return 0;
41	}
42
43	int module_load_and_warn(struct kmod_ctx ctx, const char module, bool verbose) {	4,383✔
44	_cleanup_(kmod_module_unref_listp) struct kmod_list *modlist = NULL;	4,383✔
45	_cleanup_strv_free_ char **denylist = NULL;	4,383✔
46	bool denylist_parsed = false;	4,383✔
47	struct kmod_list *itr;	4,383✔
48	int r;	4,383✔
49
50	assert(ctx);	4,383✔
51	assert(module);	4,383✔
52
53	/* verbose==true means we should log at non-debug level if we
54	* fail to find or load the module. */
55
56	log_debug("Loading module: %s", module);	4,383✔
57
58	r = sym_kmod_module_new_from_lookup(ctx, module, &modlist);	4,383✔
59	if (r < 0)	4,383✔
60	return log_full_errno(verbose ? LOG_ERR : LOG_DEBUG, r,	×
61	"Failed to look up module alias '%s': %m", module);
62
63	if (!modlist)	4,383✔
64	return log_full_errno(verbose ? LOG_ERR : LOG_DEBUG,	1,720✔
65	SYNTHETIC_ERRNO(ENOENT),
66	"Failed to find module '%s'", module);
67
68	sym_kmod_list_foreach(itr, modlist) {	6,152✔
69	_cleanup_(kmod_module_unrefp) struct kmod_module *mod = NULL;	3,489✔
70	int state, err;	3,489✔
71
72	mod = sym_kmod_module_get_module(itr);	3,489✔
73	state = sym_kmod_module_get_initstate(mod);	3,489✔
74
75	switch (state) {	3,489✔
76	case KMOD_MODULE_BUILTIN:
77	log_full(verbose ? LOG_INFO : LOG_DEBUG,	1,626✔
78	"Module '%s' is built in", sym_kmod_module_get_name(mod));
79	break;
80
81	case KMOD_MODULE_LIVE:
82	log_debug("Module '%s' is already loaded", sym_kmod_module_get_name(mod));	678✔
83	break;
84
85	default:	1,185✔
86	err = sym_kmod_module_probe_insert_module(	1,185✔
87	mod,
88	KMOD_PROBE_APPLY_BLACKLIST,
89	/* extra_options= */ NULL,
90	/* run_install= */ NULL,
91	/* data= */ NULL,
92	/* print_action= */ NULL);
93	if (err == 0)	1,185✔
94	log_full(verbose ? LOG_INFO : LOG_DEBUG,	989✔
95	"Inserted module '%s'", sym_kmod_module_get_name(mod));
96	else if (err == KMOD_PROBE_APPLY_BLACKLIST)	196✔
97	log_full(verbose ? LOG_INFO : LOG_DEBUG,	×
98	"Module '%s' is deny-listed (by kmod)", sym_kmod_module_get_name(mod));
99	else {
100	assert(err < 0);	196✔
101
102	if (err == -EPERM) {	196✔
103	if (!denylist_parsed) {	×
104	r = proc_cmdline_parse(parse_proc_cmdline_item, &denylist, 0);	×
105	if (r < 0)	×
106	log_full_errno(!verbose ? LOG_DEBUG : LOG_WARNING,	×
107	r,
108	"Failed to parse kernel command line, ignoring: %m");
109
110	denylist_parsed = true;
111	}
112	if (strv_contains(denylist, sym_kmod_module_get_name(mod))) {	×
113	log_full(verbose ? LOG_INFO : LOG_DEBUG,	×
114	"Module '%s' is deny-listed (by kernel)", sym_kmod_module_get_name(mod));
115	continue;	×
116	}
117	}
118
119	log_full_errno(!verbose ? LOG_DEBUG :	196✔
120	err == -ENODEV ? LOG_NOTICE :
121	err == -ENOENT ? LOG_WARNING :
122	LOG_ERR,
123	err,
124	"Failed to insert module '%s': %m",
125	sym_kmod_module_get_name(mod));
126	if (!IN_SET(err, -ENODEV, -ENOENT))	196✔
127	r = err;	×
128	}
129	}
130	}
131
132	return r;
133	}
134
135	_printf_(6,0) static void systemd_kmod_log(	×
136	void *data,
137	int priority,
138	const char *file,
139	int line,
140	const char *fn,
141	const char *format,
142	va_list args) {
143
144	log_internalv(priority, 0, file, line, fn, format, args);	×
145	}	×
146
147	int module_setup_context(struct kmod_ctx **ret) {	233✔
148	_cleanup_(kmod_unrefp) struct kmod_ctx *ctx = NULL;	233✔
149	int r;	233✔
150
151	assert(ret);	233✔
152
153	r = dlopen_libkmod(LOG_DEBUG);	233✔
154	if (r < 0)	233✔
155	return r;
156
157	ctx = sym_kmod_new(NULL, NULL);	233✔
158	if (!ctx)	233✔
159	return -ENOMEM;
160
161	(void) sym_kmod_load_resources(ctx);	233✔
162	sym_kmod_set_log_fn(ctx, systemd_kmod_log, NULL);	233✔
163
164	*ret = TAKE_PTR(ctx);	233✔
165	return 0;	233✔
166	}
167
168	#endif
169
170	int dlopen_libkmod(int log_level) {	293✔
171	#if HAVE_KMOD
172	static void *libkmod_dl = NULL;	293✔
173
174	LIBKMOD_NOTE(recommended);	293✔
175
176	return dlopen_many_sym_or_warn(	293✔
177	&libkmod_dl,
178	"libkmod.so.2",
179	log_level,
180	DLSYM_ARG(kmod_list_next),
181	DLSYM_ARG(kmod_load_resources),
182	DLSYM_ARG(kmod_module_get_initstate),
183	DLSYM_ARG(kmod_module_get_module),
184	DLSYM_ARG(kmod_module_get_name),
185	DLSYM_ARG(kmod_module_new_from_lookup),
186	DLSYM_ARG(kmod_module_probe_insert_module),
187	DLSYM_ARG(kmod_module_unref),
188	DLSYM_ARG(kmod_module_unref_list),
189	DLSYM_ARG(kmod_new),
190	DLSYM_ARG(kmod_set_log_fn),
191	DLSYM_ARG(kmod_unref),
192	DLSYM_ARG(kmod_validate_resources));
193	#else
194	return log_full_errno(log_level, SYNTHETIC_ERRNO(EOPNOTSUPP),
195	"libkmod support is not compiled in.");
196	#endif
197	}

systemd / systemd / 29132483780

Source File Press 'n' to go to next uncovered line, 'b' for previous

Source File
Press 'n' to go to next uncovered line, 'b' for previous