]>
Commit | Line | Data |
---|---|---|
e8fd8fec | 1 | #pragma once |
586fc304 LDM |
2 | |
3 | #include <stdbool.h> | |
4462c4ac | 4 | #include <stdio.h> |
586fc304 | 5 | #include <syslog.h> |
d917f274 | 6 | #include <limits.h> |
586fc304 | 7 | |
576dd439 | 8 | #include <shared/macro.h> |
8b7189bc | 9 | #include <shared/missing.h> |
576dd439 | 10 | |
586fc304 LDM |
11 | #include "libkmod.h" |
12 | ||
a70c1e77 | 13 | static _always_inline_ _printf_format_(2, 3) void |
95ed3e75 | 14 | kmod_log_null(const struct kmod_ctx *ctx, const char *format, ...) {} |
586fc304 LDM |
15 | |
16 | #define kmod_log_cond(ctx, prio, arg...) \ | |
17 | do { \ | |
18 | if (kmod_get_log_priority(ctx) >= prio) \ | |
87beacc9 | 19 | kmod_log(ctx, prio, __FILE__, __LINE__, __func__, ## arg);\ |
586fc304 LDM |
20 | } while (0) |
21 | ||
22 | #ifdef ENABLE_LOGGING | |
23 | # ifdef ENABLE_DEBUG | |
ae6df84a | 24 | # define DBG(ctx, arg...) kmod_log_cond(ctx, LOG_DEBUG, ## arg) |
586fc304 | 25 | # else |
ae6df84a | 26 | # define DBG(ctx, arg...) kmod_log_null(ctx, ## arg) |
586fc304 | 27 | # endif |
43bdf97c | 28 | # define NOTICE(ctx, arg...) kmod_log_cond(ctx, LOG_NOTICE, ## arg) |
ae6df84a LDM |
29 | # define INFO(ctx, arg...) kmod_log_cond(ctx, LOG_INFO, ## arg) |
30 | # define ERR(ctx, arg...) kmod_log_cond(ctx, LOG_ERR, ## arg) | |
586fc304 | 31 | #else |
ae6df84a | 32 | # define DBG(ctx, arg...) kmod_log_null(ctx, ## arg) |
43bdf97c | 33 | # define NOTICE(ctx, arg...) kmod_log_null(ctx, ## arg) |
ae6df84a LDM |
34 | # define INFO(ctx, arg...) kmod_log_null(ctx, ## arg) |
35 | # define ERR(ctx, arg...) kmod_log_null(ctx, ## arg) | |
586fc304 LDM |
36 | #endif |
37 | ||
38 | #define KMOD_EXPORT __attribute__ ((visibility("default"))) | |
39 | ||
1684e440 LDM |
40 | #define KCMD_LINE_SIZE 4096 |
41 | ||
41a51c2a CR |
42 | #ifndef HAVE_SECURE_GETENV |
43 | # ifdef HAVE___SECURE_GETENV | |
44 | # define secure_getenv __secure_getenv | |
45 | # else | |
46 | # warning neither secure_getenv nor __secure_getenv is available | |
47 | # define secure_getenv getenv | |
48 | # endif | |
49 | #endif | |
50 | ||
1bdd951e | 51 | void kmod_log(const struct kmod_ctx *ctx, |
586fc304 | 52 | int priority, const char *file, int line, const char *fn, |
12d9419d | 53 | const char *format, ...) __attribute__((format(printf, 6, 7))) __attribute__((nonnull(1, 3, 5))); |
586fc304 | 54 | |
6924e47a LDM |
55 | struct list_node { |
56 | struct list_node *next, *prev; | |
57 | }; | |
58 | ||
59 | struct kmod_list { | |
60 | struct list_node node; | |
61 | void *data; | |
62 | }; | |
63 | ||
a70c1e77 LDM |
64 | struct kmod_list *kmod_list_append(struct kmod_list *list, const void *data) _must_check_ __attribute__((nonnull(2))); |
65 | struct kmod_list *kmod_list_prepend(struct kmod_list *list, const void *data) _must_check_ __attribute__((nonnull(2))); | |
66 | struct kmod_list *kmod_list_remove(struct kmod_list *list) _must_check_; | |
6924e47a | 67 | struct kmod_list *kmod_list_remove_data(struct kmod_list *list, |
a70c1e77 | 68 | const void *data) _must_check_ __attribute__((nonnull(2))); |
62be7995 | 69 | struct kmod_list *kmod_list_remove_n_latest(struct kmod_list *list, |
a70c1e77 | 70 | unsigned int n) _must_check_; |
86e87885 | 71 | struct kmod_list *kmod_list_insert_after(struct kmod_list *list, const void *data) __attribute__((nonnull(2))); |
b91a1c6d | 72 | struct kmod_list *kmod_list_insert_before(struct kmod_list *list, const void *data) __attribute__((nonnull(2))); |
a70c1e77 | 73 | struct kmod_list *kmod_list_append_list(struct kmod_list *list1, struct kmod_list *list2) _must_check_; |
86e87885 | 74 | |
cf91579b LDM |
75 | #undef kmod_list_foreach |
76 | #define kmod_list_foreach(list_entry, first_entry) \ | |
d2d648df | 77 | for (list_entry = ((first_entry) == NULL) ? NULL : (first_entry); \ |
cf91579b | 78 | list_entry != NULL; \ |
d2d648df | 79 | list_entry = (list_entry->node.next == &((first_entry)->node)) ? NULL : \ |
cf91579b | 80 | container_of(list_entry->node.next, struct kmod_list, node)) |
60aa4d8b | 81 | |
d6b55b7d GSB |
82 | #undef kmod_list_foreach_reverse |
83 | #define kmod_list_foreach_reverse(list_entry, first_entry) \ | |
84 | for (list_entry = (((first_entry) == NULL) ? NULL : container_of(first_entry->node.prev, struct kmod_list, node)); \ | |
85 | list_entry != NULL; \ | |
86 | list_entry = ((list_entry == first_entry) ? NULL : \ | |
87 | container_of(list_entry->node.prev, struct kmod_list, node))) | |
88 | ||
60aa4d8b | 89 | /* libkmod.c */ |
12d9419d GSB |
90 | int kmod_lookup_alias_from_config(struct kmod_ctx *ctx, const char *name, struct kmod_list **list) __attribute__((nonnull(1, 2, 3))); |
91 | int kmod_lookup_alias_from_symbols_file(struct kmod_ctx *ctx, const char *name, struct kmod_list **list) __attribute__((nonnull(1, 2, 3))); | |
92 | int kmod_lookup_alias_from_aliases_file(struct kmod_ctx *ctx, const char *name, struct kmod_list **list) __attribute__((nonnull(1, 2, 3))); | |
93 | int kmod_lookup_alias_from_moddep_file(struct kmod_ctx *ctx, const char *name, struct kmod_list **list) __attribute__((nonnull(1, 2, 3))); | |
b866b216 | 94 | int kmod_lookup_alias_from_kernel_builtin_file(struct kmod_ctx *ctx, const char *name, struct kmod_list **list) __attribute__((nonnull(1, 2, 3))); |
3805274b | 95 | int kmod_lookup_alias_from_builtin_file(struct kmod_ctx *ctx, const char *name, struct kmod_list **list) __attribute__((nonnull(1, 2, 3))); |
fd44a98a | 96 | bool kmod_lookup_alias_is_builtin(struct kmod_ctx *ctx, const char *name) __attribute__((nonnull(1, 2))); |
f4fc5523 | 97 | int kmod_lookup_alias_from_commands(struct kmod_ctx *ctx, const char *name, struct kmod_list **list) __attribute__((nonnull(1, 2, 3))); |
ece09aac | 98 | void kmod_set_modules_visited(struct kmod_ctx *ctx, bool visited) __attribute__((nonnull((1)))); |
450bd1b4 | 99 | void kmod_set_modules_required(struct kmod_ctx *ctx, bool required) __attribute__((nonnull((1)))); |
fd186ae9 | 100 | |
671d4894 | 101 | char *kmod_search_moddep(struct kmod_ctx *ctx, const char *name) __attribute__((nonnull(1,2))); |
221631d5 | 102 | |
8bdeca11 | 103 | struct kmod_module *kmod_pool_get_module(struct kmod_ctx *ctx, const char *key) __attribute__((nonnull(1,2))); |
1114e781 LDM |
104 | void kmod_pool_add_module(struct kmod_ctx *ctx, struct kmod_module *mod, const char *key) __attribute__((nonnull(1, 2, 3))); |
105 | void kmod_pool_del_module(struct kmod_ctx *ctx, struct kmod_module *mod, const char *key) __attribute__((nonnull(1, 2, 3))); | |
fd186ae9 | 106 | |
e7fc2c86 | 107 | const struct kmod_config *kmod_get_config(const struct kmod_ctx *ctx) __attribute__((nonnull(1))); |
fd186ae9 | 108 | |
60aa4d8b | 109 | /* libkmod-config.c */ |
b6a4dfb1 LDM |
110 | struct kmod_config_path { |
111 | unsigned long long stamp; | |
112 | char path[]; | |
113 | }; | |
114 | ||
7c2ab358 | 115 | struct kmod_config { |
d13e606f | 116 | struct kmod_ctx *ctx; |
7c2ab358 | 117 | struct kmod_list *aliases; |
81cf2060 | 118 | struct kmod_list *blacklists; |
615c42be | 119 | struct kmod_list *options; |
a5cce6d6 LDM |
120 | struct kmod_list *remove_commands; |
121 | struct kmod_list *install_commands; | |
1c522600 | 122 | struct kmod_list *softdeps; |
b6a4dfb1 LDM |
123 | |
124 | struct kmod_list *paths; | |
7c2ab358 | 125 | }; |
b6a4dfb1 | 126 | |
cb8d4d3e | 127 | int kmod_config_new(struct kmod_ctx *ctx, struct kmod_config **config, const char * const *config_paths) __attribute__((nonnull(1, 2,3))); |
d13e606f | 128 | void kmod_config_free(struct kmod_config *config) __attribute__((nonnull(1))); |
c1c9c446 | 129 | const char *kmod_blacklist_get_modname(const struct kmod_list *l) __attribute__((nonnull(1))); |
12d9419d GSB |
130 | const char *kmod_alias_get_name(const struct kmod_list *l) __attribute__((nonnull(1))); |
131 | const char *kmod_alias_get_modname(const struct kmod_list *l) __attribute__((nonnull(1))); | |
bd3f5535 GSB |
132 | const char *kmod_option_get_options(const struct kmod_list *l) __attribute__((nonnull(1))); |
133 | const char *kmod_option_get_modname(const struct kmod_list *l) __attribute__((nonnull(1))); | |
134 | const char *kmod_command_get_command(const struct kmod_list *l) __attribute__((nonnull(1))); | |
135 | const char *kmod_command_get_modname(const struct kmod_list *l) __attribute__((nonnull(1))); | |
136 | ||
1c522600 GSB |
137 | const char *kmod_softdep_get_name(const struct kmod_list *l) __attribute__((nonnull(1))); |
138 | const char * const *kmod_softdep_get_pre(const struct kmod_list *l, unsigned int *count) __attribute__((nonnull(1, 2))); | |
139 | const char * const *kmod_softdep_get_post(const struct kmod_list *l, unsigned int *count); | |
140 | ||
7c2ab358 | 141 | |
7636e72b | 142 | /* libkmod-module.c */ |
6ad5f263 | 143 | int kmod_module_new_from_alias(struct kmod_ctx *ctx, const char *alias, const char *name, struct kmod_module **mod); |
671d4894 | 144 | int kmod_module_parse_depline(struct kmod_module *mod, char *line) __attribute__((nonnull(1, 2))); |
f4fc5523 LDM |
145 | void kmod_module_set_install_commands(struct kmod_module *mod, const char *cmd) __attribute__((nonnull(1))); |
146 | void kmod_module_set_remove_commands(struct kmod_module *mod, const char *cmd) __attribute__((nonnull(1))); | |
ece09aac | 147 | void kmod_module_set_visited(struct kmod_module *mod, bool visited) __attribute__((nonnull(1))); |
3805274b | 148 | void kmod_module_set_builtin(struct kmod_module *mod, bool builtin) __attribute__((nonnull((1)))); |
450bd1b4 | 149 | void kmod_module_set_required(struct kmod_module *mod, bool required) __attribute__((nonnull(1))); |
fd44a98a | 150 | bool kmod_module_is_builtin(struct kmod_module *mod) __attribute__((nonnull(1))); |
7db08652 | 151 | |
3d8226ed | 152 | /* libkmod-file.c */ |
a70c1e77 | 153 | struct kmod_file *kmod_file_open(const struct kmod_ctx *ctx, const char *filename) _must_check_ __attribute__((nonnull(1,2))); |
1eff942e | 154 | struct kmod_elf *kmod_file_get_elf(struct kmod_file *file) __attribute__((nonnull(1))); |
7a86f129 | 155 | void kmod_file_load_contents(struct kmod_file *file) __attribute__((nonnull(1))); |
a70c1e77 LDM |
156 | void *kmod_file_get_contents(const struct kmod_file *file) _must_check_ __attribute__((nonnull(1))); |
157 | off_t kmod_file_get_size(const struct kmod_file *file) _must_check_ __attribute__((nonnull(1))); | |
144d1826 KC |
158 | bool kmod_file_get_direct(const struct kmod_file *file) _must_check_ __attribute__((nonnull(1))); |
159 | int kmod_file_get_fd(const struct kmod_file *file) _must_check_ __attribute__((nonnull(1))); | |
3d8226ed GSB |
160 | void kmod_file_unref(struct kmod_file *file) __attribute__((nonnull(1))); |
161 | ||
708624a4 GSB |
162 | /* libkmod-elf.c */ |
163 | struct kmod_elf; | |
164 | struct kmod_modversion { | |
165 | uint64_t crc; | |
674f8590 | 166 | enum kmod_symbol_bind bind; |
708624a4 GSB |
167 | char *symbol; |
168 | }; | |
169 | ||
7a86f129 | 170 | struct kmod_elf *kmod_elf_new(const void *memory, off_t size) _must_check_; |
708624a4 | 171 | void kmod_elf_unref(struct kmod_elf *elf) __attribute__((nonnull(1))); |
a70c1e77 LDM |
172 | const void *kmod_elf_get_memory(const struct kmod_elf *elf) _must_check_ __attribute__((nonnull(1))); |
173 | int kmod_elf_get_strings(const struct kmod_elf *elf, const char *section, char ***array) _must_check_ __attribute__((nonnull(1,2,3))); | |
174 | int kmod_elf_get_modversions(const struct kmod_elf *elf, struct kmod_modversion **array) _must_check_ __attribute__((nonnull(1,2))); | |
175 | int kmod_elf_get_symbols(const struct kmod_elf *elf, struct kmod_modversion **array) _must_check_ __attribute__((nonnull(1,2))); | |
176 | int kmod_elf_get_dependency_symbols(const struct kmod_elf *elf, struct kmod_modversion **array) _must_check_ __attribute__((nonnull(1,2))); | |
177 | int kmod_elf_strip_section(struct kmod_elf *elf, const char *section) _must_check_ __attribute__((nonnull(1,2))); | |
178 | int kmod_elf_strip_vermagic(struct kmod_elf *elf) _must_check_ __attribute__((nonnull(1))); | |
7db08652 | 179 | |
ea17e2b0 LDM |
180 | /* |
181 | * Debug mock lib need to find section ".gnu.linkonce.this_module" in order to | |
182 | * get modname | |
183 | */ | |
a70c1e77 | 184 | int kmod_elf_get_section(const struct kmod_elf *elf, const char *section, const void **buf, uint64_t *buf_size) _must_check_ __attribute__((nonnull(1,2,3,4))); |
ea17e2b0 | 185 | |
8fe1681c MM |
186 | /* libkmod-signature.c */ |
187 | struct kmod_signature_info { | |
188 | const char *signer; | |
189 | size_t signer_len; | |
190 | const char *key_id; | |
191 | size_t key_id_len; | |
192 | const char *algo, *hash_algo, *id_type; | |
e5b6a658 YK |
193 | const char *sig; |
194 | size_t sig_len; | |
391b4714 YK |
195 | void (*free)(void *); |
196 | void *private; | |
8fe1681c MM |
197 | }; |
198 | bool kmod_module_signature_info(const struct kmod_file *file, struct kmod_signature_info *sig_info) _must_check_ __attribute__((nonnull(1, 2))); | |
391b4714 | 199 | void kmod_module_signature_info_free(struct kmod_signature_info *sig_info) __attribute__((nonnull)); |
60084cf1 AG |
200 | |
201 | /* libkmod-builtin.c */ | |
60084cf1 | 202 | ssize_t kmod_builtin_get_modinfo(struct kmod_ctx *ctx, const char *modname, char ***modinfo) __attribute__((nonnull(1, 2, 3))); |