Commit | Line | Data |
---|---|---|
1da177e4 LT |
1 | #ifndef __LINUX_KMOD_H__ |
2 | #define __LINUX_KMOD_H__ | |
3 | ||
4 | /* | |
5 | * include/linux/kmod.h | |
6 | * | |
7 | * This program is free software; you can redistribute it and/or modify | |
8 | * it under the terms of the GNU General Public License as published by | |
9 | * the Free Software Foundation; either version 2 of the License, or | |
10 | * (at your option) any later version. | |
11 | * | |
12 | * This program is distributed in the hope that it will be useful, | |
13 | * but WITHOUT ANY WARRANTY; without even the implied warranty of | |
14 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
15 | * GNU General Public License for more details. | |
16 | * | |
17 | * You should have received a copy of the GNU General Public License | |
18 | * along with this program; if not, write to the Free Software | |
19 | * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. | |
20 | */ | |
21 | ||
ac331d15 | 22 | #include <linux/gfp.h> |
7888e7ff | 23 | #include <linux/stddef.h> |
1da177e4 LT |
24 | #include <linux/errno.h> |
25 | #include <linux/compiler.h> | |
a06a4dc3 | 26 | #include <linux/workqueue.h> |
1da177e4 LT |
27 | |
28 | #define KMOD_PATH_LEN 256 | |
29 | ||
a1ef5adb | 30 | #ifdef CONFIG_MODULES |
5ed10910 | 31 | extern char modprobe_path[]; /* for sysctl */ |
1da177e4 LT |
32 | /* modprobe exit status on success, -ve on error. Return value |
33 | * usually useless though. */ | |
acae0515 AV |
34 | extern int __request_module(bool wait, const char *name, ...) \ |
35 | __attribute__((format(printf, 2, 3))); | |
36 | #define request_module(mod...) __request_module(true, mod) | |
37 | #define request_module_nowait(mod...) __request_module(false, mod) | |
38 | #define try_then_request_module(x, mod...) \ | |
97c18e2c | 39 | ((x) ?: (__request_module(true, mod), (x))) |
1da177e4 | 40 | #else |
acae0515 AV |
41 | static inline int request_module(const char *name, ...) { return -ENOSYS; } |
42 | static inline int request_module_nowait(const char *name, ...) { return -ENOSYS; } | |
df648c9f | 43 | #define try_then_request_module(x, mod...) (x) |
1da177e4 LT |
44 | #endif |
45 | ||
7888e7ff DH |
46 | |
47 | struct key; | |
0ab4dc92 | 48 | struct file; |
a06a4dc3 NH |
49 | |
50 | enum umh_wait { | |
51 | UMH_NO_WAIT = -1, /* don't wait at all */ | |
52 | UMH_WAIT_EXEC = 0, /* wait for the exec, but not the process */ | |
53 | UMH_WAIT_PROC = 1, /* wait for the process to complete */ | |
54 | }; | |
55 | ||
56 | struct subprocess_info { | |
57 | struct work_struct work; | |
58 | struct completion *complete; | |
59 | struct cred *cred; | |
60 | char *path; | |
61 | char **argv; | |
62 | char **envp; | |
63 | enum umh_wait wait; | |
64 | int retval; | |
a06a4dc3 NH |
65 | int (*init)(struct subprocess_info *info); |
66 | void (*cleanup)(struct subprocess_info *info); | |
67 | void *data; | |
68 | }; | |
0ab4dc92 JF |
69 | |
70 | /* Allocate a subprocess_info structure */ | |
ac331d15 KM |
71 | struct subprocess_info *call_usermodehelper_setup(char *path, char **argv, |
72 | char **envp, gfp_t gfp_mask); | |
0ab4dc92 JF |
73 | |
74 | /* Set various pieces of state into the subprocess_info structure */ | |
a06a4dc3 NH |
75 | void call_usermodehelper_setfns(struct subprocess_info *info, |
76 | int (*init)(struct subprocess_info *info), | |
77 | void (*cleanup)(struct subprocess_info *info), | |
78 | void *data); | |
86313c48 | 79 | |
0ab4dc92 | 80 | /* Actually execute the sub-process */ |
86313c48 | 81 | int call_usermodehelper_exec(struct subprocess_info *info, enum umh_wait wait); |
0ab4dc92 JF |
82 | |
83 | /* Free the subprocess_info. This is only needed if you're not going | |
84 | to call call_usermodehelper_exec */ | |
85 | void call_usermodehelper_freeinfo(struct subprocess_info *info); | |
7888e7ff DH |
86 | |
87 | static inline int | |
a06a4dc3 NH |
88 | call_usermodehelper_fns(char *path, char **argv, char **envp, |
89 | enum umh_wait wait, | |
90 | int (*init)(struct subprocess_info *info), | |
91 | void (*cleanup)(struct subprocess_info *), void *data) | |
7888e7ff | 92 | { |
0ab4dc92 | 93 | struct subprocess_info *info; |
ac331d15 | 94 | gfp_t gfp_mask = (wait == UMH_NO_WAIT) ? GFP_ATOMIC : GFP_KERNEL; |
0ab4dc92 | 95 | |
ac331d15 | 96 | info = call_usermodehelper_setup(path, argv, envp, gfp_mask); |
a06a4dc3 | 97 | |
0ab4dc92 JF |
98 | if (info == NULL) |
99 | return -ENOMEM; | |
a06a4dc3 NH |
100 | |
101 | call_usermodehelper_setfns(info, init, cleanup, data); | |
102 | ||
0ab4dc92 JF |
103 | return call_usermodehelper_exec(info, wait); |
104 | } | |
105 | ||
a06a4dc3 NH |
106 | static inline int |
107 | call_usermodehelper(char *path, char **argv, char **envp, enum umh_wait wait) | |
108 | { | |
109 | return call_usermodehelper_fns(path, argv, envp, wait, | |
110 | NULL, NULL, NULL); | |
111 | } | |
112 | ||
1da177e4 LT |
113 | extern void usermodehelper_init(void); |
114 | ||
1bfcf130 RW |
115 | extern int usermodehelper_disable(void); |
116 | extern void usermodehelper_enable(void); | |
117 | ||
1da177e4 | 118 | #endif /* __LINUX_KMOD_H__ */ |