xref: /qemu/include/qemu/module.h (revision 922d42bb)
1 /*
2  * QEMU Module Infrastructure
3  *
4  * Copyright IBM, Corp. 2009
5  *
6  * Authors:
7  *  Anthony Liguori   <aliguori@us.ibm.com>
8  *
9  * This work is licensed under the terms of the GNU GPL, version 2.  See
10  * the COPYING file in the top-level directory.
11  *
12  */
13 
14 #ifndef QEMU_MODULE_H
15 #define QEMU_MODULE_H
16 
17 
18 #define DSO_STAMP_FUN         glue(qemu_stamp, CONFIG_STAMP)
19 #define DSO_STAMP_FUN_STR     stringify(DSO_STAMP_FUN)
20 
21 #ifdef BUILD_DSO
22 void DSO_STAMP_FUN(void);
23 /* This is a dummy symbol to identify a loaded DSO as a QEMU module, so we can
24  * distinguish "version mismatch" from "not a QEMU module", when the stamp
25  * check fails during module loading */
26 void qemu_module_dummy(void);
27 
28 #define module_init(function, type)                                         \
29 static void __attribute__((constructor)) do_qemu_init_ ## function(void)    \
30 {                                                                           \
31     register_dso_module_init(function, type);                               \
32 }
33 #else
34 /* This should not be used directly.  Use block_init etc. instead.  */
35 #define module_init(function, type)                                         \
36 static void __attribute__((constructor)) do_qemu_init_ ## function(void)    \
37 {                                                                           \
38     register_module_init(function, type);                                   \
39 }
40 #endif
41 
42 typedef enum {
43     MODULE_INIT_MIGRATION,
44     MODULE_INIT_BLOCK,
45     MODULE_INIT_OPTS,
46     MODULE_INIT_QOM,
47     MODULE_INIT_TRACE,
48     MODULE_INIT_XEN_BACKEND,
49     MODULE_INIT_LIBQOS,
50     MODULE_INIT_FUZZ_TARGET,
51     MODULE_INIT_MAX
52 } module_init_type;
53 
54 #define block_init(function) module_init(function, MODULE_INIT_BLOCK)
55 #define opts_init(function) module_init(function, MODULE_INIT_OPTS)
56 #define type_init(function) module_init(function, MODULE_INIT_QOM)
57 #define trace_init(function) module_init(function, MODULE_INIT_TRACE)
58 #define xen_backend_init(function) module_init(function, \
59                                                MODULE_INIT_XEN_BACKEND)
60 #define libqos_init(function) module_init(function, MODULE_INIT_LIBQOS)
61 #define fuzz_target_init(function) module_init(function, \
62                                                MODULE_INIT_FUZZ_TARGET)
63 #define migration_init(function) module_init(function, MODULE_INIT_MIGRATION)
64 #define block_module_load_one(lib) module_load_one("block-", lib, false)
65 #define ui_module_load_one(lib) module_load_one("ui-", lib, false)
66 #define audio_module_load_one(lib) module_load_one("audio-", lib, false)
67 
68 void register_module_init(void (*fn)(void), module_init_type type);
69 void register_dso_module_init(void (*fn)(void), module_init_type type);
70 
71 void module_call_init(module_init_type type);
72 bool module_load_one(const char *prefix, const char *lib_name, bool mayfail);
73 void module_load_qom_one(const char *type);
74 void module_load_qom_all(void);
75 
76 #endif
77