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